0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 41 70 72 69 6c /*.** 2004 April
0010: 20 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 6.**.** The aut
0020: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f hor disclaims co
0030: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 pyright to this
0040: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e source code. In
0050: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c place of.** a l
0060: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 egal notice, her
0070: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a e is a blessing:
0080: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f .**.** May yo
0090: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f u do good and no
00a0: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 t evil..** Ma
00b0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 y you find forgi
00c0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 veness for yours
00d0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 elf and forgive
00e0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 others..** Ma
00f0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 y you share free
0100: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 ly, never taking
0110: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 more than you g
0120: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a ive..**.********
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 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 69 *.** This file i
0180: 6d 70 6c 65 6d 65 6e 74 73 20 61 20 65 78 74 65 mplements a exte
0190: 72 6e 61 6c 20 28 64 69 73 6b 2d 62 61 73 65 64 rnal (disk-based
01a0: 29 20 64 61 74 61 62 61 73 65 20 75 73 69 6e 67 ) database using
01b0: 20 42 54 72 65 65 73 2e 0a 2a 2a 20 53 65 65 20 BTrees..** See
01c0: 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 the header comme
01d0: 6e 74 20 6f 6e 20 22 62 74 72 65 65 49 6e 74 2e nt on "btreeInt.
01e0: 68 22 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 h" for additiona
01f0: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a l information..*
0200: 2a 20 49 6e 63 6c 75 64 69 6e 67 20 61 20 64 65 * Including a de
0210: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 66 69 6c scription of fil
0220: 65 20 66 6f 72 6d 61 74 20 61 6e 64 20 61 6e 20 e format and an
0230: 6f 76 65 72 76 69 65 77 20 6f 66 20 6f 70 65 72 overview of oper
0240: 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 ation..*/.#inclu
0250: 64 65 20 22 62 74 72 65 65 49 6e 74 2e 68 22 0a de "btreeInt.h".
0260: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 65 ./*.** The heade
0270: 72 20 73 74 72 69 6e 67 20 74 68 61 74 20 61 70 r string that ap
0280: 70 65 61 72 73 20 61 74 20 74 68 65 20 62 65 67 pears at the beg
0290: 69 6e 6e 69 6e 67 20 6f 66 20 65 76 65 72 79 0a inning of every.
02a0: 2a 2a 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 ** SQLite databa
02b0: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f se..*/.static co
02c0: 6e 73 74 20 63 68 61 72 20 7a 4d 61 67 69 63 48 nst char zMagicH
02d0: 65 61 64 65 72 5b 5d 20 3d 20 53 51 4c 49 54 45 eader[] = SQLITE
02e0: 5f 46 49 4c 45 5f 48 45 41 44 45 52 3b 0a 0a 2f _FILE_HEADER;../
02f0: 2a 0a 2a 2a 20 53 65 74 20 74 68 69 73 20 67 6c *.** Set this gl
0300: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 74 6f obal variable to
0310: 20 31 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 61 1 to enable tra
0320: 63 69 6e 67 20 75 73 69 6e 67 20 74 68 65 20 54 cing using the T
0330: 52 41 43 45 0a 2a 2a 20 6d 61 63 72 6f 2e 0a 2a RACE.** macro..*
0340: 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 71 6c 69 /.#if 0.int sqli
0350: 74 65 33 42 74 72 65 65 54 72 61 63 65 3d 31 3b te3BtreeTrace=1;
0360: 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 /* True to ena
0370: 62 6c 65 20 74 72 61 63 69 6e 67 20 2a 2f 0a 23 ble tracing */.#
0380: 20 64 65 66 69 6e 65 20 54 52 41 43 45 28 58 29 define TRACE(X)
0390: 20 20 69 66 28 73 71 6c 69 74 65 33 42 74 72 65 if(sqlite3Btre
03a0: 65 54 72 61 63 65 29 7b 70 72 69 6e 74 66 20 58 eTrace){printf X
03b0: 3b 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 3b ;fflush(stdout);
03c0: 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 }.#else.# define
03d0: 20 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 66 TRACE(X).#endif
03e0: 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 20 ../*.** Extract
03f0: 61 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 a 2-byte big-end
0400: 69 61 6e 20 69 6e 74 65 67 65 72 20 66 72 6f 6d ian integer from
0410: 20 61 6e 20 61 72 72 61 79 20 6f 66 20 75 6e 73 an array of uns
0420: 69 67 6e 65 64 20 62 79 74 65 73 2e 0a 2a 2a 20 igned bytes..**
0430: 42 75 74 20 69 66 20 74 68 65 20 76 61 6c 75 65 But if the value
0440: 20 69 73 20 7a 65 72 6f 2c 20 6d 61 6b 65 20 69 is zero, make i
0450: 74 20 36 35 35 33 36 2e 0a 2a 2a 0a 2a 2a 20 54 t 65536..**.** T
0460: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 his routine is u
0470: 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 74 sed to extract t
0480: 68 65 20 22 6f 66 66 73 65 74 20 74 6f 20 63 65 he "offset to ce
0490: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 22 ll content area"
04a0: 20 76 61 6c 75 65 0a 2a 2a 20 66 72 6f 6d 20 74 value.** from t
04b0: 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 62 he header of a b
04c0: 74 72 65 65 20 70 61 67 65 2e 20 20 49 66 20 74 tree page. If t
04d0: 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 20 he page size is
04e0: 36 35 35 33 36 20 61 6e 64 20 74 68 65 20 70 61 65536 and the pa
04f0: 67 65 0a 2a 2a 20 69 73 20 65 6d 70 74 79 2c 20 ge.** is empty,
0500: 74 68 65 20 6f 66 66 73 65 74 20 73 68 6f 75 6c the offset shoul
0510: 64 20 62 65 20 36 35 35 33 36 2c 20 62 75 74 20 d be 65536, but
0520: 74 68 65 20 32 2d 62 79 74 65 20 76 61 6c 75 65 the 2-byte value
0530: 20 73 74 6f 72 65 73 20 7a 65 72 6f 2e 0a 2a 2a stores zero..**
0540: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 This routine ma
0550: 6b 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 72 kes the necessar
0560: 79 20 61 64 6a 75 73 74 6d 65 6e 74 20 74 6f 20 y adjustment to
0570: 36 35 35 33 36 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65536..*/.#defin
0580: 65 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 e get2byteNotZer
0590: 6f 28 58 29 20 20 28 28 28 28 28 69 6e 74 29 67 o(X) (((((int)g
05a0: 65 74 32 62 79 74 65 28 58 29 29 2d 31 29 26 30 et2byte(X))-1)&0
05b0: 78 66 66 66 66 29 2b 31 29 0a 0a 2f 2a 0a 2a 2a xffff)+1)../*.**
05c0: 20 56 61 6c 75 65 73 20 70 61 73 73 65 64 20 61 Values passed a
05d0: 73 20 74 68 65 20 35 74 68 20 61 72 67 75 6d 65 s the 5th argume
05e0: 6e 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 42 74 nt to allocateBt
05f0: 72 65 65 50 61 67 65 28 29 0a 2a 2f 0a 23 64 65 reePage().*/.#de
0600: 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 fine BTALLOC_ANY
0610: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 2f 0 /
0620: 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 79 20 70 * Allocate any p
0630: 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 42 age */.#define B
0640: 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 31 20 20 TALLOC_EXACT 1
0650: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f /* Allo
0660: 63 61 74 65 20 65 78 61 63 74 20 70 61 67 65 20 cate exact page
0670: 69 66 20 70 6f 73 73 69 62 6c 65 20 2a 2f 0a 23 if possible */.#
0680: 64 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f 4c define BTALLOC_L
0690: 45 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 E 2
06a0: 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 79 /* Allocate any
06b0: 20 70 61 67 65 20 3c 3d 20 74 68 65 20 70 61 72 page <= the par
06c0: 61 6d 65 74 65 72 20 2a 2f 0a 0a 2f 2a 0a 2a 2a ameter */../*.**
06d0: 20 4d 61 63 72 6f 20 49 66 4e 6f 74 4f 6d 69 74 Macro IfNotOmit
06e0: 41 56 28 78 29 20 72 65 74 75 72 6e 73 20 28 78 AV(x) returns (x
06f0: 29 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ) if SQLITE_OMIT
0700: 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 6e _AUTOVACUUM is n
0710: 6f 74 20 0a 2a 2a 20 64 65 66 69 6e 65 64 2c 20 ot .** defined,
0720: 6f 72 20 30 20 69 66 20 69 74 20 69 73 2e 20 46 or 0 if it is. F
0730: 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a or example:.**.*
0740: 2a 20 20 20 62 49 6e 63 72 56 61 63 75 75 6d 20 * bIncrVacuum
0750: 3d 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 42 = IfNotOmitAV(pB
0760: 74 53 68 61 72 65 64 2d 3e 69 6e 63 72 56 61 63 tShared->incrVac
0770: 75 75 6d 29 3b 0a 2a 2f 0a 23 69 66 6e 64 65 66 uum);.*/.#ifndef
0780: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
0790: 4f 56 41 43 55 55 4d 0a 23 64 65 66 69 6e 65 20 OVACUUM.#define
07a0: 49 66 4e 6f 74 4f 6d 69 74 41 56 28 65 78 70 72 IfNotOmitAV(expr
07b0: 29 20 28 65 78 70 72 29 0a 23 65 6c 73 65 0a 23 ) (expr).#else.#
07c0: 64 65 66 69 6e 65 20 49 66 4e 6f 74 4f 6d 69 74 define IfNotOmit
07d0: 41 56 28 65 78 70 72 29 20 30 0a 23 65 6e 64 69 AV(expr) 0.#endi
07e0: 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 f..#ifndef SQLIT
07f0: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
0800: 43 48 45 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 74 CHE./*.** A list
0810: 20 6f 66 20 42 74 53 68 61 72 65 64 20 6f 62 6a of BtShared obj
0820: 65 63 74 73 20 74 68 61 74 20 61 72 65 20 65 6c ects that are el
0830: 69 67 69 62 6c 65 20 66 6f 72 20 70 61 72 74 69 igible for parti
0840: 63 69 70 61 74 69 6f 6e 0a 2a 2a 20 69 6e 20 73 cipation.** in s
0850: 68 61 72 65 64 20 63 61 63 68 65 2e 20 20 54 68 hared cache. Th
0860: 69 73 20 76 61 72 69 61 62 6c 65 20 68 61 73 20 is variable has
0870: 66 69 6c 65 20 73 63 6f 70 65 20 64 75 72 69 6e file scope durin
0880: 67 20 6e 6f 72 6d 61 6c 20 62 75 69 6c 64 73 2c g normal builds,
0890: 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 65 73 74 .** but the test
08a0: 20 68 61 72 6e 65 73 73 20 6e 65 65 64 73 20 74 harness needs t
08b0: 6f 20 61 63 63 65 73 73 20 69 74 20 73 6f 20 77 o access it so w
08c0: 65 20 6d 61 6b 65 20 69 74 20 67 6c 6f 62 61 6c e make it global
08d0: 20 66 6f 72 20 0a 2a 2a 20 74 65 73 74 20 62 75 for .** test bu
08e0: 69 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 41 63 63 65 ilds..**.** Acce
08f0: 73 73 20 74 6f 20 74 68 69 73 20 76 61 72 69 61 ss to this varia
0900: 62 6c 65 20 69 73 20 70 72 6f 74 65 63 74 65 64 ble is protected
0910: 20 62 79 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 by SQLITE_MUTEX
0920: 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 2e 0a _STATIC_MASTER..
0930: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
0940: 5f 54 45 53 54 0a 42 74 53 68 61 72 65 64 20 2a _TEST.BtShared *
0950: 53 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 74 SQLITE_WSD sqlit
0960: 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
0970: 74 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 73 74 61 t = 0;.#else.sta
0980: 74 69 63 20 42 74 53 68 61 72 65 64 20 2a 53 51 tic BtShared *SQ
0990: 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 74 65 33 LITE_WSD sqlite3
09a0: 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 20 SharedCacheList
09b0: 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 = 0;.#endif.#end
09c0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
09d0: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 2a T_SHARED_CACHE *
09e0: 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 /..#ifndef SQLIT
09f0: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
0a00: 43 48 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 CHE./*.** Enable
0a10: 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 65 20 or disable the
0a20: 73 68 61 72 65 64 20 70 61 67 65 72 20 61 6e 64 shared pager and
0a30: 20 73 63 68 65 6d 61 20 66 65 61 74 75 72 65 73 schema features
0a40: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
0a50: 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 65 tine has no effe
0a60: 63 74 20 6f 6e 20 65 78 69 73 74 69 6e 67 20 64 ct on existing d
0a70: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
0a80: 6f 6e 73 2e 0a 2a 2a 20 54 68 65 20 73 68 61 72 ons..** The shar
0a90: 65 64 20 63 61 63 68 65 20 73 65 74 74 69 6e 67 ed cache setting
0aa0: 20 65 66 66 65 63 74 73 20 6f 6e 6c 79 20 66 75 effects only fu
0ab0: 74 75 72 65 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a ture calls to.**
0ac0: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2c sqlite3_open(),
0ad0: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 sqlite3_open16(
0ae0: 29 2c 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 ), or sqlite3_op
0af0: 65 6e 5f 76 32 28 29 2e 0a 2a 2f 0a 69 6e 74 20 en_v2()..*/.int
0b00: 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 73 sqlite3_enable_s
0b10: 68 61 72 65 64 5f 63 61 63 68 65 28 69 6e 74 20 hared_cache(int
0b20: 65 6e 61 62 6c 65 29 7b 0a 20 20 73 71 6c 69 74 enable){. sqlit
0b30: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 e3GlobalConfig.s
0b40: 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c 65 haredCacheEnable
0b50: 64 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 72 65 d = enable;. re
0b60: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
0b70: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 0a 23 69 66 64 }.#endif....#ifd
0b80: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
0b90: 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 2f 2a HARED_CACHE. /*
0ba0: 0a 20 20 2a 2a 20 54 68 65 20 66 75 6e 63 74 69 . ** The functi
0bb0: 6f 6e 73 20 71 75 65 72 79 53 68 61 72 65 64 43 ons querySharedC
0bc0: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 2c acheTableLock(),
0bd0: 20 73 65 74 53 68 61 72 65 64 43 61 63 68 65 54 setSharedCacheT
0be0: 61 62 6c 65 4c 6f 63 6b 28 29 2c 0a 20 20 2a 2a ableLock(),. **
0bf0: 20 61 6e 64 20 63 6c 65 61 72 41 6c 6c 53 68 61 and clearAllSha
0c00: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
0c10: 6b 73 28 29 0a 20 20 2a 2a 20 6d 61 6e 69 70 75 ks(). ** manipu
0c20: 6c 61 74 65 20 65 6e 74 72 69 65 73 20 69 6e 20 late entries in
0c30: 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 4c 6f the BtShared.pLo
0c40: 63 6b 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 75 ck linked list u
0c50: 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 20 20 2a sed to store. *
0c60: 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 74 * shared-cache t
0c70: 61 62 6c 65 20 6c 65 76 65 6c 20 6c 6f 63 6b 73 able level locks
0c80: 2e 20 49 66 20 74 68 65 20 6c 69 62 72 61 72 79 . If the library
0c90: 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 is compiled wit
0ca0: 68 20 74 68 65 0a 20 20 2a 2a 20 73 68 61 72 65 h the. ** share
0cb0: 64 2d 63 61 63 68 65 20 66 65 61 74 75 72 65 20 d-cache feature
0cc0: 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 disabled, then t
0cd0: 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 65 76 65 here is only eve
0ce0: 72 20 6f 6e 65 20 75 73 65 72 0a 20 20 2a 2a 20 r one user. **
0cf0: 6f 66 20 65 61 63 68 20 42 74 53 68 61 72 65 64 of each BtShared
0d00: 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 73 structure and s
0d10: 6f 20 74 68 69 73 20 6c 6f 63 6b 69 6e 67 20 69 o this locking i
0d20: 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 2e s not necessary.
0d30: 20 0a 20 20 2a 2a 20 53 6f 20 64 65 66 69 6e 65 . ** So define
0d40: 20 74 68 65 20 6c 6f 63 6b 20 72 65 6c 61 74 65 the lock relate
0d50: 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 6e d functions as n
0d60: 6f 2d 6f 70 73 2e 0a 20 20 2a 2f 0a 20 20 23 64 o-ops.. */. #d
0d70: 65 66 69 6e 65 20 71 75 65 72 79 53 68 61 72 65 efine queryShare
0d80: 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 dCacheTableLock(
0d90: 61 2c 62 2c 63 29 20 53 51 4c 49 54 45 5f 4f 4b a,b,c) SQLITE_OK
0da0: 0a 20 20 23 64 65 66 69 6e 65 20 73 65 74 53 68 . #define setSh
0db0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0dc0: 63 6b 28 61 2c 62 2c 63 29 20 53 51 4c 49 54 45 ck(a,b,c) SQLITE
0dd0: 5f 4f 4b 0a 20 20 23 64 65 66 69 6e 65 20 63 6c _OK. #define cl
0de0: 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 earAllSharedCach
0df0: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a 20 eTableLocks(a).
0e00: 20 23 64 65 66 69 6e 65 20 64 6f 77 6e 67 72 61 #define downgra
0e10: 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 deAllSharedCache
0e20: 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a 20 20 TableLocks(a).
0e30: 23 64 65 66 69 6e 65 20 68 61 73 53 68 61 72 65 #define hasShare
0e40: 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 dCacheTableLock(
0e50: 61 2c 62 2c 63 2c 64 29 20 31 0a 20 20 23 64 65 a,b,c,d) 1. #de
0e60: 66 69 6e 65 20 68 61 73 52 65 61 64 43 6f 6e 66 fine hasReadConf
0e70: 6c 69 63 74 73 28 61 2c 20 62 29 20 30 0a 23 65 licts(a, b) 0.#e
0e80: 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 ndif..#ifndef SQ
0e90: 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
0ea0: 5f 43 41 43 48 45 0a 0a 23 69 66 64 65 66 20 53 _CACHE..#ifdef S
0eb0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a QLITE_DEBUG./*.*
0ec0: 2a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f *** This functio
0ed0: 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 61 n is only used a
0ee0: 73 20 70 61 72 74 20 6f 66 20 61 6e 20 61 73 73 s part of an ass
0ef0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 2e ert() statement.
0f00: 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 43 68 65 63 6b ***.**.** Check
0f10: 20 74 6f 20 73 65 65 20 69 66 20 70 42 74 72 65 to see if pBtre
0f20: 65 20 68 6f 6c 64 73 20 74 68 65 20 72 65 71 75 e holds the requ
0f30: 69 72 65 64 20 6c 6f 63 6b 73 20 74 6f 20 72 65 ired locks to re
0f40: 61 64 20 6f 72 20 77 72 69 74 65 20 74 6f 20 74 ad or write to t
0f50: 68 65 20 0a 2a 2a 20 74 61 62 6c 65 20 77 69 74 he .** table wit
0f60: 68 20 72 6f 6f 74 20 70 61 67 65 20 69 52 6f 6f h root page iRoo
0f70: 74 2e 20 20 20 52 65 74 75 72 6e 20 31 20 69 66 t. Return 1 if
0f80: 20 69 74 20 64 6f 65 73 20 61 6e 64 20 30 20 69 it does and 0 i
0f90: 66 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 f not..**.** For
0fa0: 20 65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 77 example, when w
0fb0: 72 69 74 69 6e 67 20 74 6f 20 61 20 74 61 62 6c riting to a tabl
0fc0: 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 e with root-page
0fd0: 20 69 52 6f 6f 74 20 76 69 61 20 0a 2a 2a 20 42 iRoot via .** B
0fe0: 74 72 65 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 tree connection
0ff0: 70 42 74 72 65 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 pBtree:.**.**
1000: 20 61 73 73 65 72 74 28 20 68 61 73 53 68 61 72 assert( hasShar
1010: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
1020: 28 70 42 74 72 65 65 2c 20 69 52 6f 6f 74 2c 20 (pBtree, iRoot,
1030: 30 2c 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 29 0, WRITE_LOCK) )
1040: 3b 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 77 72 69 ;.**.** When wri
1050: 74 69 6e 67 20 74 6f 20 61 6e 20 69 6e 64 65 78 ting to an index
1060: 20 74 68 61 74 20 72 65 73 69 64 65 73 20 69 6e that resides in
1070: 20 61 20 73 68 61 72 61 62 6c 65 20 64 61 74 61 a sharable data
1080: 62 61 73 65 2c 20 74 68 65 20 0a 2a 2a 20 63 61 base, the .** ca
1090: 6c 6c 65 72 20 73 68 6f 75 6c 64 20 68 61 76 65 ller should have
10a0: 20 66 69 72 73 74 20 6f 62 74 61 69 6e 65 64 20 first obtained
10b0: 61 20 6c 6f 63 6b 20 73 70 65 63 69 66 79 69 6e a lock specifyin
10c0: 67 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 g the root page
10d0: 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 73 of.** the corres
10e0: 70 6f 6e 64 69 6e 67 20 74 61 62 6c 65 2e 20 54 ponding table. T
10f0: 68 69 73 20 6d 61 6b 65 73 20 74 68 69 6e 67 73 his makes things
1100: 20 61 20 62 69 74 20 6d 6f 72 65 20 63 6f 6d 70 a bit more comp
1110: 6c 69 63 61 74 65 64 2c 0a 2a 2a 20 61 73 20 74 licated,.** as t
1120: 68 69 73 20 6d 6f 64 75 6c 65 20 74 72 65 61 74 his module treat
1130: 73 20 65 61 63 68 20 74 61 62 6c 65 20 61 73 20 s each table as
1140: 61 20 73 65 70 61 72 61 74 65 20 73 74 72 75 63 a separate struc
1150: 74 75 72 65 2e 20 54 6f 20 64 65 74 65 72 6d 69 ture. To determi
1160: 6e 65 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 ne.** the table
1170: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
1180: 20 74 68 65 20 69 6e 64 65 78 20 62 65 69 6e 67 the index being
1190: 20 77 72 69 74 74 65 6e 2c 20 74 68 69 73 0a 2a written, this.*
11a0: 2a 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 74 * function has t
11b0: 6f 20 73 65 61 72 63 68 20 74 68 72 6f 75 67 68 o search through
11c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 the database sc
11d0: 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 49 6e 73 74 hema..**.** Inst
11e0: 65 61 64 20 6f 66 20 61 20 6c 6f 63 6b 20 6f 6e ead of a lock on
11f0: 20 74 68 65 20 74 61 62 6c 65 2f 69 6e 64 65 78 the table/index
1200: 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 rooted at page
1210: 69 52 6f 6f 74 2c 20 74 68 65 20 63 61 6c 6c 65 iRoot, the calle
1220: 72 20 6d 61 79 0a 2a 2a 20 68 6f 6c 64 20 61 20 r may.** hold a
1230: 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 write-lock on th
1240: 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 20 28 e schema table (
1250: 72 6f 6f 74 20 70 61 67 65 20 31 29 2e 20 54 68 root page 1). Th
1260: 69 73 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 61 63 is is also.** ac
1270: 63 65 70 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 ceptable..*/.sta
1280: 74 69 63 20 69 6e 74 20 68 61 73 53 68 61 72 65 tic int hasShare
1290: 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 dCacheTableLock(
12a0: 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 65 . Btree *pBtree
12b0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 6e , /* Han
12c0: 64 6c 65 20 74 68 61 74 20 6d 75 73 74 20 68 6f dle that must ho
12d0: 6c 64 20 6c 6f 63 6b 20 2a 2f 0a 20 20 50 67 6e ld lock */. Pgn
12e0: 6f 20 69 52 6f 6f 74 2c 20 20 20 20 20 20 20 20 o iRoot,
12f0: 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 /* Root page
1300: 20 6f 66 20 62 2d 74 72 65 65 20 2a 2f 0a 20 20 of b-tree */.
1310: 69 6e 74 20 69 73 49 6e 64 65 78 2c 20 20 20 20 int isIndex,
1320: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
1330: 66 20 69 52 6f 6f 74 20 69 73 20 74 68 65 20 72 f iRoot is the r
1340: 6f 6f 74 20 6f 66 20 61 6e 20 69 6e 64 65 78 20 oot of an index
1350: 62 2d 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 b-tree */. int
1360: 65 4c 6f 63 6b 54 79 70 65 20 20 20 20 20 20 20 eLockType
1370: 20 20 20 2f 2a 20 52 65 71 75 69 72 65 64 20 6c /* Required l
1380: 6f 63 6b 20 74 79 70 65 20 28 52 45 41 44 5f 4c ock type (READ_L
1390: 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f 4c 4f 43 OCK or WRITE_LOC
13a0: 4b 29 20 2a 2f 0a 29 7b 0a 20 20 53 63 68 65 6d K) */.){. Schem
13b0: 61 20 2a 70 53 63 68 65 6d 61 20 3d 20 28 53 63 a *pSchema = (Sc
13c0: 68 65 6d 61 20 2a 29 70 42 74 72 65 65 2d 3e 70 hema *)pBtree->p
13d0: 42 74 2d 3e 70 53 63 68 65 6d 61 3b 0a 20 20 50 Bt->pSchema;. P
13e0: 67 6e 6f 20 69 54 61 62 20 3d 20 30 3b 0a 20 20 gno iTab = 0;.
13f0: 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a 0a BtLock *pLock;..
1400: 20 20 2f 2a 20 49 66 20 74 68 69 73 20 64 61 74 /* If this dat
1410: 61 62 61 73 65 20 69 73 20 6e 6f 74 20 73 68 61 abase is not sha
1420: 72 65 61 62 6c 65 2c 20 6f 72 20 69 66 20 74 68 reable, or if th
1430: 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 64 e client is read
1440: 69 6e 67 0a 20 20 2a 2a 20 61 6e 64 20 68 61 73 ing. ** and has
1450: 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d 6d the read-uncomm
1460: 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 2c 20 itted flag set,
1470: 74 68 65 6e 20 6e 6f 20 6c 6f 63 6b 20 69 73 20 then no lock is
1480: 72 65 71 75 69 72 65 64 2e 20 0a 20 20 2a 2a 20 required. . **
1490: 52 65 74 75 72 6e 20 74 72 75 65 20 69 6d 6d 65 Return true imme
14a0: 64 69 61 74 65 6c 79 2e 0a 20 20 2a 2f 0a 20 20 diately.. */.
14b0: 69 66 28 20 28 70 42 74 72 65 65 2d 3e 73 68 61 if( (pBtree->sha
14c0: 72 61 62 6c 65 3d 3d 30 29 0a 20 20 20 7c 7c 20 rable==0). ||
14d0: 28 65 4c 6f 63 6b 54 79 70 65 3d 3d 52 45 41 44 (eLockType==READ
14e0: 5f 4c 4f 43 4b 20 26 26 20 28 70 42 74 72 65 65 _LOCK && (pBtree
14f0: 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 ->db->flags & SQ
1500: 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 LITE_ReadUncommi
1510: 74 74 65 64 29 29 0a 20 20 29 7b 0a 20 20 20 20 tted)). ){.
1520: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 return 1;. }..
1530: 20 2f 2a 20 49 66 20 74 68 65 20 63 6c 69 65 6e /* If the clien
1540: 74 20 69 73 20 72 65 61 64 69 6e 67 20 20 6f 72 t is reading or
1550: 20 77 72 69 74 69 6e 67 20 61 6e 20 69 6e 64 65 writing an inde
1560: 78 20 61 6e 64 20 74 68 65 20 73 63 68 65 6d 61 x and the schema
1570: 20 69 73 0a 20 20 2a 2a 20 6e 6f 74 20 6c 6f 61 is. ** not loa
1580: 64 65 64 2c 20 74 68 65 6e 20 69 74 20 69 73 20 ded, then it is
1590: 74 6f 6f 20 64 69 66 66 69 63 75 6c 74 20 74 6f too difficult to
15a0: 20 61 63 74 75 61 6c 6c 79 20 63 68 65 63 6b 20 actually check
15b0: 74 6f 20 73 65 65 20 69 66 0a 20 20 2a 2a 20 74 to see if. ** t
15c0: 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 6b 73 he correct locks
15d0: 20 61 72 65 20 68 65 6c 64 2e 20 20 53 6f 20 64 are held. So d
15e0: 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 2d 20 6a o not bother - j
15f0: 75 73 74 20 72 65 74 75 72 6e 20 74 72 75 65 2e ust return true.
1600: 0a 20 20 2a 2a 20 54 68 69 73 20 63 61 73 65 20 . ** This case
1610: 64 6f 65 73 20 6e 6f 74 20 63 6f 6d 65 20 75 70 does not come up
1620: 20 76 65 72 79 20 6f 66 74 65 6e 20 61 6e 79 68 very often anyh
1630: 6f 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 ow.. */. if( i
1640: 73 49 6e 64 65 78 20 26 26 20 28 21 70 53 63 68 sIndex && (!pSch
1650: 65 6d 61 20 7c 7c 20 28 70 53 63 68 65 6d 61 2d ema || (pSchema-
1660: 3e 66 6c 61 67 73 26 44 42 5f 53 63 68 65 6d 61 >flags&DB_Schema
1670: 4c 6f 61 64 65 64 29 3d 3d 30 29 20 29 7b 0a 20 Loaded)==0) ){.
1680: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d return 1;. }
1690: 0a 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 .. /* Figure ou
16a0: 74 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 20 t the root-page
16b0: 74 68 61 74 20 74 68 65 20 6c 6f 63 6b 20 73 68 that the lock sh
16c0: 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 6f 6e 2e ould be held on.
16d0: 20 46 6f 72 20 74 61 62 6c 65 0a 20 20 2a 2a 20 For table. **
16e0: 62 2d 74 72 65 65 73 2c 20 74 68 69 73 20 69 73 b-trees, this is
16f0: 20 6a 75 73 74 20 74 68 65 20 72 6f 6f 74 20 70 just the root p
1700: 61 67 65 20 6f 66 20 74 68 65 20 62 2d 74 72 65 age of the b-tre
1710: 65 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 0a e being read or.
1720: 20 20 2a 2a 20 77 72 69 74 74 65 6e 2e 20 46 6f ** written. Fo
1730: 72 20 69 6e 64 65 78 20 62 2d 74 72 65 65 73 2c r index b-trees,
1740: 20 69 74 20 69 73 20 74 68 65 20 72 6f 6f 74 20 it is the root
1750: 70 61 67 65 20 6f 66 20 74 68 65 20 61 73 73 6f page of the asso
1760: 63 69 61 74 65 64 0a 20 20 2a 2a 20 74 61 62 6c ciated. ** tabl
1770: 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 69 73 49 e. */. if( isI
1780: 6e 64 65 78 20 29 7b 0a 20 20 20 20 48 61 73 68 ndex ){. Hash
1790: 45 6c 65 6d 20 2a 70 3b 0a 20 20 20 20 66 6f 72 Elem *p;. for
17a0: 28 70 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 (p=sqliteHashFir
17b0: 73 74 28 26 70 53 63 68 65 6d 61 2d 3e 69 64 78 st(&pSchema->idx
17c0: 48 61 73 68 29 3b 20 70 3b 20 70 3d 73 71 6c 69 Hash); p; p=sqli
17d0: 74 65 48 61 73 68 4e 65 78 74 28 70 29 29 7b 0a teHashNext(p)){.
17e0: 20 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 Index *pId
17f0: 78 20 3d 20 28 49 6e 64 65 78 20 2a 29 73 71 6c x = (Index *)sql
1800: 69 74 65 48 61 73 68 44 61 74 61 28 70 29 3b 0a iteHashData(p);.
1810: 20 20 20 20 20 20 69 66 28 20 70 49 64 78 2d 3e if( pIdx->
1820: 74 6e 75 6d 3d 3d 28 69 6e 74 29 69 52 6f 6f 74 tnum==(int)iRoot
1830: 20 29 7b 0a 20 20 20 20 20 20 20 20 69 54 61 62 ){. iTab
1840: 20 3d 20 70 49 64 78 2d 3e 70 54 61 62 6c 65 2d = pIdx->pTable-
1850: 3e 74 6e 75 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 >tnum;. }.
1860: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
1870: 20 20 69 54 61 62 20 3d 20 69 52 6f 6f 74 3b 0a iTab = iRoot;.
1880: 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 61 72 63 68 }.. /* Search
1890: 20 66 6f 72 20 74 68 65 20 72 65 71 75 69 72 65 for the require
18a0: 64 20 6c 6f 63 6b 2e 20 45 69 74 68 65 72 20 61 d lock. Either a
18b0: 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 72 write-lock on r
18c0: 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 2c 20 61 oot-page iTab, a
18d0: 20 0a 20 20 2a 2a 20 77 72 69 74 65 2d 6c 6f 63 . ** write-loc
18e0: 6b 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 20 k on the schema
18f0: 74 61 62 6c 65 2c 20 6f 72 20 28 69 66 20 74 68 table, or (if th
1900: 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 64 e client is read
1910: 69 6e 67 29 20 61 0a 20 20 2a 2a 20 72 65 61 64 ing) a. ** read
1920: 2d 6c 6f 63 6b 20 6f 6e 20 69 54 61 62 20 77 69 -lock on iTab wi
1930: 6c 6c 20 73 75 66 66 69 63 65 2e 20 52 65 74 75 ll suffice. Retu
1940: 72 6e 20 31 20 69 66 20 61 6e 79 20 6f 66 20 74 rn 1 if any of t
1950: 68 65 73 65 20 61 72 65 20 66 6f 75 6e 64 2e 20 hese are found.
1960: 20 2a 2f 0a 20 20 66 6f 72 28 70 4c 6f 63 6b 3d */. for(pLock=
1970: 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 4c 6f pBtree->pBt->pLo
1980: 63 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b ck; pLock; pLock
1990: 3d 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a =pLock->pNext){.
19a0: 20 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 70 if( pLock->p
19b0: 42 74 72 65 65 3d 3d 70 42 74 72 65 65 20 0a 20 Btree==pBtree .
19c0: 20 20 20 20 26 26 20 28 70 4c 6f 63 6b 2d 3e 69 && (pLock->i
19d0: 54 61 62 6c 65 3d 3d 69 54 61 62 20 7c 7c 20 28 Table==iTab || (
19e0: 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 pLock->eLock==WR
19f0: 49 54 45 5f 4c 4f 43 4b 20 26 26 20 70 4c 6f 63 ITE_LOCK && pLoc
1a00: 6b 2d 3e 69 54 61 62 6c 65 3d 3d 31 29 29 0a 20 k->iTable==1)).
1a10: 20 20 20 20 26 26 20 70 4c 6f 63 6b 2d 3e 65 4c && pLock->eL
1a20: 6f 63 6b 3e 3d 65 4c 6f 63 6b 54 79 70 65 20 0a ock>=eLockType .
1a30: 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 ){. ret
1a40: 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d urn 1;. }. }
1a50: 0a 0a 20 20 2f 2a 20 46 61 69 6c 65 64 20 74 6f .. /* Failed to
1a60: 20 66 69 6e 64 20 74 68 65 20 72 65 71 75 69 72 find the requir
1a70: 65 64 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 72 65 ed lock. */. re
1a80: 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 turn 0;.}.#endif
1a90: 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47 /* SQLITE_DEBUG
1aa0: 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 */..#ifdef SQLI
1ab0: 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a TE_DEBUG./*.****
1ac0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d This function m
1ad0: 61 79 20 62 65 20 75 73 65 64 20 61 73 20 70 61 ay be used as pa
1ae0: 72 74 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 rt of assert() s
1af0: 74 61 74 65 6d 65 6e 74 73 20 6f 6e 6c 79 2e 20 tatements only.
1b00: 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 ****.**.** Retur
1b10: 6e 20 74 72 75 65 20 69 66 20 69 74 20 77 6f 75 n true if it wou
1b20: 6c 64 20 62 65 20 69 6c 6c 65 67 61 6c 20 66 6f ld be illegal fo
1b30: 72 20 70 42 74 72 65 65 20 74 6f 20 77 72 69 74 r pBtree to writ
1b40: 65 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 74 61 e into the.** ta
1b50: 62 6c 65 20 6f 72 20 69 6e 64 65 78 20 72 6f 6f ble or index roo
1b60: 74 65 64 20 61 74 20 69 52 6f 6f 74 20 62 65 63 ted at iRoot bec
1b70: 61 75 73 65 20 6f 74 68 65 72 20 73 68 61 72 65 ause other share
1b80: 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 72 d connections ar
1b90: 65 0a 2a 2a 20 73 69 6d 75 6c 74 61 6e 65 6f 75 e.** simultaneou
1ba0: 73 6c 79 20 72 65 61 64 69 6e 67 20 74 68 61 74 sly reading that
1bb0: 20 73 61 6d 65 20 74 61 62 6c 65 20 6f 72 20 69 same table or i
1bc0: 6e 64 65 78 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 ndex..**.** It i
1bd0: 73 20 69 6c 6c 65 67 61 6c 20 66 6f 72 20 70 42 s illegal for pB
1be0: 74 72 65 65 20 74 6f 20 77 72 69 74 65 20 69 66 tree to write if
1bf0: 20 73 6f 6d 65 20 6f 74 68 65 72 20 42 74 72 65 some other Btre
1c00: 65 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a 2a e object that.**
1c10: 20 73 68 61 72 65 73 20 74 68 65 20 73 61 6d 65 shares the same
1c20: 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 BtShared object
1c30: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 72 65 is currently re
1c40: 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 ading or writing
1c50: 0a 2a 2a 20 74 68 65 20 69 52 6f 6f 74 20 74 61 .** the iRoot ta
1c60: 62 6c 65 2e 20 20 45 78 63 65 70 74 2c 20 69 66 ble. Except, if
1c70: 20 74 68 65 20 6f 74 68 65 72 20 42 74 72 65 65 the other Btree
1c80: 20 6f 62 6a 65 63 74 20 68 61 73 20 74 68 65 0a object has the.
1c90: 2a 2a 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 ** read-uncommit
1ca0: 74 65 64 20 66 6c 61 67 20 73 65 74 2c 20 74 68 ted flag set, th
1cb0: 65 6e 20 69 74 20 69 73 20 4f 4b 20 66 6f 72 20 en it is OK for
1cc0: 74 68 65 20 6f 74 68 65 72 20 6f 62 6a 65 63 74 the other object
1cd0: 20 74 6f 0a 2a 2a 20 68 61 76 65 20 61 20 72 65 to.** have a re
1ce0: 61 64 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a ad cursor..**.**
1cf0: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 62 65 For example, be
1d00: 66 6f 72 65 20 77 72 69 74 69 6e 67 20 74 6f 20 fore writing to
1d10: 61 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 any part of the
1d20: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a 2a table or index.*
1d30: 2a 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 * rooted at page
1d40: 20 69 52 6f 6f 74 2c 20 6f 6e 65 20 73 68 6f 75 iRoot, one shou
1d50: 6c 64 20 63 61 6c 6c 3a 0a 2a 2a 0a 2a 2a 20 20 ld call:.**.**
1d60: 20 20 61 73 73 65 72 74 28 20 21 68 61 73 52 65 assert( !hasRe
1d70: 61 64 43 6f 6e 66 6c 69 63 74 73 28 70 42 74 72 adConflicts(pBtr
1d80: 65 65 2c 20 69 52 6f 6f 74 29 20 29 3b 0a 2a 2f ee, iRoot) );.*/
1d90: 0a 73 74 61 74 69 63 20 69 6e 74 20 68 61 73 52 .static int hasR
1da0: 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 42 74 72 eadConflicts(Btr
1db0: 65 65 20 2a 70 42 74 72 65 65 2c 20 50 67 6e 6f ee *pBtree, Pgno
1dc0: 20 69 52 6f 6f 74 29 7b 0a 20 20 42 74 43 75 72 iRoot){. BtCur
1dd0: 73 6f 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d sor *p;. for(p=
1de0: 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 pBtree->pBt->pCu
1df0: 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e rsor; p; p=p->pN
1e00: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 2d ext){. if( p-
1e10: 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 >pgnoRoot==iRoot
1e20: 20 0a 20 20 20 20 20 26 26 20 70 2d 3e 70 42 74 . && p->pBt
1e30: 72 65 65 21 3d 70 42 74 72 65 65 0a 20 20 20 20 ree!=pBtree.
1e40: 20 26 26 20 30 3d 3d 28 70 2d 3e 70 42 74 72 65 && 0==(p->pBtre
1e50: 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 e->db->flags & S
1e60: 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d QLITE_ReadUncomm
1e70: 69 74 74 65 64 29 0a 20 20 20 20 29 7b 0a 20 20 itted). ){.
1e80: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 return 1;.
1e90: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
1ea0: 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 20 20 20 0;.}.#endif
1eb0: 2f 2a 20 23 69 66 64 65 66 20 53 51 4c 49 54 45 /* #ifdef SQLITE
1ec0: 5f 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a _DEBUG */../*.**
1ed0: 20 51 75 65 72 79 20 74 6f 20 73 65 65 20 69 66 Query to see if
1ee0: 20 42 74 72 65 65 20 68 61 6e 64 6c 65 20 70 20 Btree handle p
1ef0: 6d 61 79 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 may obtain a loc
1f00: 6b 20 6f 66 20 74 79 70 65 20 65 4c 6f 63 6b 20 k of type eLock
1f10: 0a 2a 2a 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f .** (READ_LOCK o
1f20: 72 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 6f 6e r WRITE_LOCK) on
1f30: 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 the table with
1f40: 72 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 2e 20 root-page iTab.
1f50: 52 65 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 Return.** SQLITE
1f60: 5f 4f 4b 20 69 66 20 74 68 65 20 6c 6f 63 6b 20 _OK if the lock
1f70: 6d 61 79 20 62 65 20 6f 62 74 61 69 6e 65 64 20 may be obtained
1f80: 28 62 79 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 73 (by calling.** s
1f90: 65 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 etSharedCacheTab
1fa0: 6c 65 4c 6f 63 6b 28 29 29 2c 20 6f 72 20 53 51 leLock()), or SQ
1fb0: 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 69 66 20 6e LITE_LOCKED if n
1fc0: 6f 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ot..*/.static in
1fd0: 74 20 71 75 65 72 79 53 68 61 72 65 64 43 61 63 t querySharedCac
1fe0: 68 65 54 61 62 6c 65 4c 6f 63 6b 28 42 74 72 65 heTableLock(Btre
1ff0: 65 20 2a 70 2c 20 50 67 6e 6f 20 69 54 61 62 2c e *p, Pgno iTab,
2000: 20 75 38 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 u8 eLock){. Bt
2010: 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
2020: 3e 70 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a >pBt;. BtLock *
2030: 70 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 pIter;.. assert
2040: 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f ( sqlite3BtreeHo
2050: 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 ldsMutex(p) );.
2060: 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d assert( eLock==
2070: 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f READ_LOCK || eLo
2080: 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 ck==WRITE_LOCK )
2090: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64 ;. assert( p->d
20a0: 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 b!=0 );. assert
20b0: 28 20 21 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 ( !(p->db->flags
20c0: 26 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f &SQLITE_ReadUnco
20d0: 6d 6d 69 74 74 65 64 29 7c 7c 65 4c 6f 63 6b 3d mmitted)||eLock=
20e0: 3d 57 52 49 54 45 5f 4c 4f 43 4b 7c 7c 69 54 61 =WRITE_LOCK||iTa
20f0: 62 3d 3d 31 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 b==1 );. . /*
2100: 49 66 20 72 65 71 75 65 73 74 69 6e 67 20 61 20 If requesting a
2110: 77 72 69 74 65 2d 6c 6f 63 6b 2c 20 74 68 65 6e write-lock, then
2120: 20 74 68 65 20 42 74 72 65 65 20 6d 75 73 74 20 the Btree must
2130: 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 have an open wri
2140: 74 65 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 te. ** transact
2150: 69 6f 6e 20 6f 6e 20 74 68 69 73 20 66 69 6c 65 ion on this file
2160: 2e 20 41 6e 64 2c 20 6f 62 76 69 6f 75 73 6c 79 . And, obviously
2170: 2c 20 66 6f 72 20 74 68 69 73 20 74 6f 20 62 65 , for this to be
2180: 20 73 6f 20 74 68 65 72 65 20 0a 20 20 2a 2a 20 so there . **
2190: 6d 75 73 74 20 62 65 20 61 6e 20 6f 70 65 6e 20 must be an open
21a0: 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
21b0: 6e 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 74 n on the file it
21c0: 73 65 6c 66 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 self.. */. ass
21d0: 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 ert( eLock==READ
21e0: 5f 4c 4f 43 4b 20 7c 7c 20 28 70 3d 3d 70 42 74 _LOCK || (p==pBt
21f0: 2d 3e 70 57 72 69 74 65 72 20 26 26 20 70 2d 3e ->pWriter && p->
2200: 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 inTrans==TRANS_W
2210: 52 49 54 45 29 20 29 3b 0a 20 20 61 73 73 65 72 RITE) );. asser
2220: 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c t( eLock==READ_L
2230: 4f 43 4b 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 OCK || pBt->inTr
2240: 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
2250: 5f 57 52 49 54 45 20 29 3b 0a 20 20 0a 20 20 2f _WRITE );. . /
2260: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 * This routine i
2270: 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 s a no-op if the
2280: 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 69 73 shared-cache is
2290: 20 6e 6f 74 20 65 6e 61 62 6c 65 64 20 2a 2f 0a not enabled */.
22a0: 20 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 if( !p->sharab
22b0: 6c 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e le ){. return
22c0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
22d0: 0a 20 20 2f 2a 20 49 66 20 73 6f 6d 65 20 6f 74 . /* If some ot
22e0: 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 her connection i
22f0: 73 20 68 6f 6c 64 69 6e 67 20 61 6e 20 65 78 63 s holding an exc
2300: 6c 75 73 69 76 65 20 6c 6f 63 6b 2c 20 74 68 65 lusive lock, the
2310: 0a 20 20 2a 2a 20 72 65 71 75 65 73 74 65 64 20 . ** requested
2320: 6c 6f 63 6b 20 6d 61 79 20 6e 6f 74 20 62 65 20 lock may not be
2330: 6f 62 74 61 69 6e 65 64 2e 0a 20 20 2a 2f 0a 20 obtained.. */.
2340: 20 69 66 28 20 70 42 74 2d 3e 70 57 72 69 74 65 if( pBt->pWrite
2350: 72 21 3d 70 20 26 26 20 28 70 42 74 2d 3e 62 74 r!=p && (pBt->bt
2360: 73 46 6c 61 67 73 20 26 20 42 54 53 5f 45 58 43 sFlags & BTS_EXC
2370: 4c 55 53 49 56 45 29 21 3d 30 20 29 7b 0a 20 20 LUSIVE)!=0 ){.
2380: 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 sqlite3Connect
2390: 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 ionBlocked(p->db
23a0: 2c 20 70 42 74 2d 3e 70 57 72 69 74 65 72 2d 3e , pBt->pWriter->
23b0: 64 62 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 db);. return
23c0: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 SQLITE_LOCKED_SH
23d0: 41 52 45 44 43 41 43 48 45 3b 0a 20 20 7d 0a 0a AREDCACHE;. }..
23e0: 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 2d for(pIter=pBt-
23f0: 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 70 >pLock; pIter; p
2400: 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 78 Iter=pIter->pNex
2410: 74 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 t){. /* The c
2420: 6f 6e 64 69 74 69 6f 6e 20 28 70 49 74 65 72 2d ondition (pIter-
2430: 3e 65 4c 6f 63 6b 21 3d 65 4c 6f 63 6b 29 20 69 >eLock!=eLock) i
2440: 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
2450: 69 66 28 2e 2e 2e 29 20 0a 20 20 20 20 2a 2a 20 if(...) . **
2460: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 61 20 73 statement is a s
2470: 69 6d 70 6c 69 66 69 63 61 74 69 6f 6e 20 6f 66 implification of
2480: 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 :. **. **
2490: 20 20 28 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f (eLock==WRITE_
24a0: 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 65 LOCK || pIter->e
24b0: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
24c0: 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 ). **. **
24d0: 73 69 6e 63 65 20 77 65 20 6b 6e 6f 77 20 74 68 since we know th
24e0: 61 74 20 69 66 20 65 4c 6f 63 6b 3d 3d 57 52 49 at if eLock==WRI
24f0: 54 45 5f 4c 4f 43 4b 2c 20 74 68 65 6e 20 6e 6f TE_LOCK, then no
2500: 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f other connectio
2510: 6e 0a 20 20 20 20 2a 2a 20 6d 61 79 20 68 6f 6c n. ** may hol
2520: 64 20 61 20 57 52 49 54 45 5f 4c 4f 43 4b 20 6f d a WRITE_LOCK o
2530: 6e 20 61 6e 79 20 74 61 62 6c 65 20 69 6e 20 74 n any table in t
2540: 68 69 73 20 66 69 6c 65 20 28 73 69 6e 63 65 20 his file (since
2550: 74 68 65 72 65 20 63 61 6e 0a 20 20 20 20 2a 2a there can. **
2560: 20 6f 6e 6c 79 20 62 65 20 61 20 73 69 6e 67 6c only be a singl
2570: 65 20 77 72 69 74 65 72 29 2e 0a 20 20 20 20 2a e writer).. *
2580: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 /. assert( pI
2590: 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 ter->eLock==READ
25a0: 5f 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e _LOCK || pIter->
25b0: 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 eLock==WRITE_LOC
25c0: 4b 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 K );. assert(
25d0: 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 eLock==READ_LOC
25e0: 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 70 42 74 72 K || pIter->pBtr
25f0: 65 65 3d 3d 70 20 7c 7c 20 70 49 74 65 72 2d 3e ee==p || pIter->
2600: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
2610: 29 3b 0a 20 20 20 20 69 66 28 20 70 49 74 65 72 );. if( pIter
2620: 2d 3e 70 42 74 72 65 65 21 3d 70 20 26 26 20 70 ->pBtree!=p && p
2630: 49 74 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 Iter->iTable==iT
2640: 61 62 20 26 26 20 70 49 74 65 72 2d 3e 65 4c 6f ab && pIter->eLo
2650: 63 6b 21 3d 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 ck!=eLock ){.
2660: 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 sqlite3Connec
2670: 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 tionBlocked(p->d
2680: 62 2c 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 b, pIter->pBtree
2690: 2d 3e 64 62 29 3b 0a 20 20 20 20 20 20 69 66 28 ->db);. if(
26a0: 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f eLock==WRITE_LO
26b0: 43 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 CK ){. as
26c0: 73 65 72 74 28 20 70 3d 3d 70 42 74 2d 3e 70 57 sert( p==pBt->pW
26d0: 72 69 74 65 72 20 29 3b 0a 20 20 20 20 20 20 20 riter );.
26e0: 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c pBt->btsFlags |
26f0: 3d 20 42 54 53 5f 50 45 4e 44 49 4e 47 3b 0a 20 = BTS_PENDING;.
2700: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 }. ret
2710: 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 urn SQLITE_LOCKE
2720: 44 5f 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 D_SHAREDCACHE;.
2730: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
2740: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
2750: 65 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 endif /* !SQLITE
2760: 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
2770: 48 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 HE */..#ifndef S
2780: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
2790: 44 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 64 D_CACHE./*.** Ad
27a0: 64 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 d a lock on the
27b0: 74 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d table with root-
27c0: 70 61 67 65 20 69 54 61 62 6c 65 20 74 6f 20 74 page iTable to t
27d0: 68 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 he shared-btree
27e0: 75 73 65 64 0a 2a 2a 20 62 79 20 42 74 72 65 65 used.** by Btree
27f0: 20 68 61 6e 64 6c 65 20 70 2e 20 50 61 72 61 6d handle p. Param
2800: 65 74 65 72 20 65 4c 6f 63 6b 20 6d 75 73 74 20 eter eLock must
2810: 62 65 20 65 69 74 68 65 72 20 52 45 41 44 5f 4c be either READ_L
2820: 4f 43 4b 20 6f 72 20 0a 2a 2a 20 57 52 49 54 45 OCK or .** WRITE
2830: 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 _LOCK..**.** Thi
2840: 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d s function assum
2850: 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 es the following
2860: 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 61 29 20 54 68 :.**.** (a) Th
2870: 65 20 73 70 65 63 69 66 69 65 64 20 42 74 72 65 e specified Btre
2880: 65 20 6f 62 6a 65 63 74 20 70 20 69 73 20 63 6f e object p is co
2890: 6e 6e 65 63 74 65 64 20 74 6f 20 61 20 73 68 61 nnected to a sha
28a0: 72 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 64 rable.** d
28b0: 61 74 61 62 61 73 65 20 28 6f 6e 65 20 77 69 74 atabase (one wit
28c0: 68 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 73 h the BtShared.s
28d0: 68 61 72 61 62 6c 65 20 66 6c 61 67 20 73 65 74 harable flag set
28e0: 29 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 28 ), and.**.** (
28f0: 62 29 20 4e 6f 20 6f 74 68 65 72 20 42 74 72 65 b) No other Btre
2900: 65 20 6f 62 6a 65 63 74 73 20 68 6f 6c 64 20 61 e objects hold a
2910: 20 6c 6f 63 6b 20 74 68 61 74 20 63 6f 6e 66 6c lock that confl
2920: 69 63 74 73 0a 2a 2a 20 20 20 20 20 20 20 77 69 icts.** wi
2930: 74 68 20 74 68 65 20 72 65 71 75 65 73 74 65 64 th the requested
2940: 20 6c 6f 63 6b 20 28 69 2e 65 2e 20 71 75 65 72 lock (i.e. quer
2950: 79 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c ySharedCacheTabl
2960: 65 4c 6f 63 6b 28 29 20 68 61 73 0a 2a 2a 20 20 eLock() has.**
2970: 20 20 20 20 20 61 6c 72 65 61 64 79 20 62 65 65 already bee
2980: 6e 20 63 61 6c 6c 65 64 20 61 6e 64 20 72 65 74 n called and ret
2990: 75 72 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4b 29 urned SQLITE_OK)
29a0: 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f ..**.** SQLITE_O
29b0: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 K is returned if
29c0: 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 61 64 64 the lock is add
29d0: 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e ed successfully.
29e0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 0a 2a SQLITE_NOMEM .*
29f0: 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 * is returned if
2a00: 20 61 20 6d 61 6c 6c 6f 63 20 61 74 74 65 6d 70 a malloc attemp
2a10: 74 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 61 74 t fails..*/.stat
2a20: 69 63 20 69 6e 74 20 73 65 74 53 68 61 72 65 64 ic int setShared
2a30: 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 42 CacheTableLock(B
2a40: 74 72 65 65 20 2a 70 2c 20 50 67 6e 6f 20 69 54 tree *p, Pgno iT
2a50: 61 62 6c 65 2c 20 75 38 20 65 4c 6f 63 6b 29 7b able, u8 eLock){
2a60: 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
2a70: 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 4c = p->pBt;. BtL
2a80: 6f 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 30 3b 0a ock *pLock = 0;.
2a90: 20 20 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b BtLock *pIter;
2aa0: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
2ab0: 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 te3BtreeHoldsMut
2ac0: 65 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 ex(p) );. asser
2ad0: 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c t( eLock==READ_L
2ae0: 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 OCK || eLock==WR
2af0: 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 ITE_LOCK );. as
2b00: 73 65 72 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 sert( p->db!=0 )
2b10: 3b 0a 0a 20 20 2f 2a 20 41 20 63 6f 6e 6e 65 63 ;.. /* A connec
2b20: 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 72 65 tion with the re
2b30: 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 ad-uncommitted f
2b40: 6c 61 67 20 73 65 74 20 77 69 6c 6c 20 6e 65 76 lag set will nev
2b50: 65 72 20 74 72 79 20 74 6f 0a 20 20 2a 2a 20 6f er try to. ** o
2b60: 62 74 61 69 6e 20 61 20 72 65 61 64 2d 6c 6f 63 btain a read-loc
2b70: 6b 20 75 73 69 6e 67 20 74 68 69 73 20 66 75 6e k using this fun
2b80: 63 74 69 6f 6e 2e 20 54 68 65 20 6f 6e 6c 79 20 ction. The only
2b90: 72 65 61 64 2d 6c 6f 63 6b 20 6f 62 74 61 69 6e read-lock obtain
2ba0: 65 64 0a 20 20 2a 2a 20 62 79 20 61 20 63 6f 6e ed. ** by a con
2bb0: 6e 65 63 74 69 6f 6e 20 69 6e 20 72 65 61 64 2d nection in read-
2bc0: 75 6e 63 6f 6d 6d 69 74 74 65 64 20 6d 6f 64 65 uncommitted mode
2bd0: 20 69 73 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 is on the sqlit
2be0: 65 5f 6d 61 73 74 65 72 20 0a 20 20 2a 2a 20 74 e_master . ** t
2bf0: 61 62 6c 65 2c 20 61 6e 64 20 74 68 61 74 20 6c able, and that l
2c00: 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 ock is obtained
2c10: 69 6e 20 42 74 72 65 65 42 65 67 69 6e 54 72 61 in BtreeBeginTra
2c20: 6e 73 28 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 ns(). */. asse
2c30: 72 74 28 20 30 3d 3d 28 70 2d 3e 64 62 2d 3e 66 rt( 0==(p->db->f
2c40: 6c 61 67 73 26 53 51 4c 49 54 45 5f 52 65 61 64 lags&SQLITE_Read
2c50: 55 6e 63 6f 6d 6d 69 74 74 65 64 29 20 7c 7c 20 Uncommitted) ||
2c60: 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 eLock==WRITE_LOC
2c70: 4b 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 K );.. /* This
2c80: 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 function should
2c90: 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 6f only be called o
2ca0: 6e 20 61 20 73 68 61 72 61 62 6c 65 20 62 2d 74 n a sharable b-t
2cb0: 72 65 65 20 61 66 74 65 72 20 69 74 20 0a 20 20 ree after it .
2cc0: 2a 2a 20 68 61 73 20 62 65 65 6e 20 64 65 74 65 ** has been dete
2cd0: 72 6d 69 6e 65 64 20 74 68 61 74 20 6e 6f 20 6f rmined that no o
2ce0: 74 68 65 72 20 62 2d 74 72 65 65 20 68 6f 6c 64 ther b-tree hold
2cf0: 73 20 61 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 s a conflicting
2d00: 6c 6f 63 6b 2e 20 20 2a 2f 0a 20 20 61 73 73 65 lock. */. asse
2d10: 72 74 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 rt( p->sharable
2d20: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c );. assert( SQL
2d30: 49 54 45 5f 4f 4b 3d 3d 71 75 65 72 79 53 68 61 ITE_OK==querySha
2d40: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
2d50: 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 65 4c 6f k(p, iTable, eLo
2d60: 63 6b 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 72 ck) );.. /* Fir
2d70: 73 74 20 73 65 61 72 63 68 20 74 68 65 20 6c 69 st search the li
2d80: 73 74 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 st for an existi
2d90: 6e 67 20 6c 6f 63 6b 20 6f 6e 20 74 68 69 73 20 ng lock on this
2da0: 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 66 6f 72 28 table. */. for(
2db0: 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b pIter=pBt->pLock
2dc0: 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 ; pIter; pIter=p
2dd0: 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 Iter->pNext){.
2de0: 20 20 69 66 28 20 70 49 74 65 72 2d 3e 69 54 61 if( pIter->iTa
2df0: 62 6c 65 3d 3d 69 54 61 62 6c 65 20 26 26 20 70 ble==iTable && p
2e00: 49 74 65 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 Iter->pBtree==p
2e10: 29 7b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 20 3d ){. pLock =
2e20: 20 70 49 74 65 72 3b 0a 20 20 20 20 20 20 62 72 pIter;. br
2e30: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a eak;. }. }..
2e40: 20 20 2f 2a 20 49 66 20 74 68 65 20 61 62 6f 76 /* If the abov
2e50: 65 20 73 65 61 72 63 68 20 64 69 64 20 6e 6f 74 e search did not
2e60: 20 66 69 6e 64 20 61 20 42 74 4c 6f 63 6b 20 73 find a BtLock s
2e70: 74 72 75 63 74 20 61 73 73 6f 63 69 61 74 69 6e truct associatin
2e80: 67 20 42 74 72 65 65 20 70 0a 20 20 2a 2a 20 77 g Btree p. ** w
2e90: 69 74 68 20 74 61 62 6c 65 20 69 54 61 62 6c 65 ith table iTable
2ea0: 2c 20 61 6c 6c 6f 63 61 74 65 20 6f 6e 65 20 61 , allocate one a
2eb0: 6e 64 20 6c 69 6e 6b 20 69 74 20 69 6e 74 6f 20 nd link it into
2ec0: 74 68 65 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 the list.. */.
2ed0: 20 69 66 28 20 21 70 4c 6f 63 6b 20 29 7b 0a 20 if( !pLock ){.
2ee0: 20 20 20 70 4c 6f 63 6b 20 3d 20 28 42 74 4c 6f pLock = (BtLo
2ef0: 63 6b 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c ck *)sqlite3Mall
2f00: 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 42 74 ocZero(sizeof(Bt
2f10: 4c 6f 63 6b 29 29 3b 0a 20 20 20 20 69 66 28 20 Lock));. if(
2f20: 21 70 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 !pLock ){.
2f30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
2f40: 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 MEM;. }. p
2f50: 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 20 3d 20 69 Lock->iTable = i
2f60: 54 61 62 6c 65 3b 0a 20 20 20 20 70 4c 6f 63 6b Table;. pLock
2f70: 2d 3e 70 42 74 72 65 65 20 3d 20 70 3b 0a 20 20 ->pBtree = p;.
2f80: 20 20 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 20 3d pLock->pNext =
2f90: 20 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 pBt->pLock;.
2fa0: 20 70 42 74 2d 3e 70 4c 6f 63 6b 20 3d 20 70 4c pBt->pLock = pL
2fb0: 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 ock;. }.. /* S
2fc0: 65 74 20 74 68 65 20 42 74 4c 6f 63 6b 2e 65 4c et the BtLock.eL
2fd0: 6f 63 6b 20 76 61 72 69 61 62 6c 65 20 74 6f 20 ock variable to
2fe0: 74 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 20 74 the maximum of t
2ff0: 68 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 6b 0a he current lock.
3000: 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 72 65 71 ** and the req
3010: 75 65 73 74 65 64 20 6c 6f 63 6b 2e 20 54 68 69 uested lock. Thi
3020: 73 20 6d 65 61 6e 73 20 69 66 20 61 20 77 72 69 s means if a wri
3030: 74 65 2d 6c 6f 63 6b 20 77 61 73 20 61 6c 72 65 te-lock was alre
3040: 61 64 79 20 68 65 6c 64 0a 20 20 2a 2a 20 61 6e ady held. ** an
3050: 64 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 72 65 d a read-lock re
3060: 71 75 65 73 74 65 64 2c 20 77 65 20 64 6f 6e 27 quested, we don'
3070: 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 20 64 6f t incorrectly do
3080: 77 6e 67 72 61 64 65 20 74 68 65 20 6c 6f 63 6b wngrade the lock
3090: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 .. */. assert(
30a0: 20 57 52 49 54 45 5f 4c 4f 43 4b 3e 52 45 41 44 WRITE_LOCK>READ
30b0: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 65 _LOCK );. if( e
30c0: 4c 6f 63 6b 3e 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 Lock>pLock->eLoc
30d0: 6b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e k ){. pLock->
30e0: 65 4c 6f 63 6b 20 3d 20 65 4c 6f 63 6b 3b 0a 20 eLock = eLock;.
30f0: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }.. return SQL
3100: 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 ITE_OK;.}.#endif
3110: 20 2f 2a 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 /* !SQLITE_OMIT
3120: 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 2a 2f _SHARED_CACHE */
3130: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
3140: 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
3150: 48 45 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 HE./*.** Release
3160: 20 61 6c 6c 20 74 68 65 20 74 61 62 6c 65 20 6c all the table l
3170: 6f 63 6b 73 20 28 6c 6f 63 6b 73 20 6f 62 74 61 ocks (locks obta
3180: 69 6e 65 64 20 76 69 61 20 63 61 6c 6c 73 20 74 ined via calls t
3190: 6f 0a 2a 2a 20 74 68 65 20 73 65 74 53 68 61 72 o.** the setShar
31a0: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
31b0: 28 29 20 70 72 6f 63 65 64 75 72 65 29 20 68 65 () procedure) he
31c0: 6c 64 20 62 79 20 42 74 72 65 65 20 6f 62 6a 65 ld by Btree obje
31d0: 63 74 20 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ct p..**.** This
31e0: 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 function assume
31f0: 73 20 74 68 61 74 20 42 74 72 65 65 20 70 20 68 s that Btree p h
3200: 61 73 20 61 6e 20 6f 70 65 6e 20 72 65 61 64 20 as an open read
3210: 6f 72 20 77 72 69 74 65 20 0a 2a 2a 20 74 72 61 or write .** tra
3220: 6e 73 61 63 74 69 6f 6e 2e 20 49 66 20 69 74 20 nsaction. If it
3230: 64 6f 65 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 does not, then t
3240: 68 65 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 66 he BTS_PENDING f
3250: 6c 61 67 0a 2a 2a 20 6d 61 79 20 62 65 20 69 6e lag.** may be in
3260: 63 6f 72 72 65 63 74 6c 79 20 63 6c 65 61 72 65 correctly cleare
3270: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 d..*/.static voi
3280: 64 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 d clearAllShared
3290: 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 CacheTableLocks(
32a0: 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 Btree *p){. BtS
32b0: 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
32c0: 70 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 2a pBt;. BtLock **
32d0: 70 70 49 74 65 72 20 3d 20 26 70 42 74 2d 3e 70 ppIter = &pBt->p
32e0: 4c 6f 63 6b 3b 0a 0a 20 20 61 73 73 65 72 74 28 Lock;.. assert(
32f0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
3300: 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 dsMutex(p) );.
3310: 61 73 73 65 72 74 28 20 70 2d 3e 73 68 61 72 61 assert( p->shara
3320: 62 6c 65 20 7c 7c 20 30 3d 3d 2a 70 70 49 74 65 ble || 0==*ppIte
3330: 72 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 r );. assert( p
3340: 2d 3e 69 6e 54 72 61 6e 73 3e 30 20 29 3b 0a 0a ->inTrans>0 );..
3350: 20 20 77 68 69 6c 65 28 20 2a 70 70 49 74 65 72 while( *ppIter
3360: 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 2a ){. BtLock *
3370: 70 4c 6f 63 6b 20 3d 20 2a 70 70 49 74 65 72 3b pLock = *ppIter;
3380: 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 42 . assert( (pB
3390: 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
33a0: 53 5f 45 58 43 4c 55 53 49 56 45 29 3d 3d 30 20 S_EXCLUSIVE)==0
33b0: 7c 7c 20 70 42 74 2d 3e 70 57 72 69 74 65 72 3d || pBt->pWriter=
33c0: 3d 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 20 29 =pLock->pBtree )
33d0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c ;. assert( pL
33e0: 6f 63 6b 2d 3e 70 42 74 72 65 65 2d 3e 69 6e 54 ock->pBtree->inT
33f0: 72 61 6e 73 3e 3d 70 4c 6f 63 6b 2d 3e 65 4c 6f rans>=pLock->eLo
3400: 63 6b 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4c ck );. if( pL
3410: 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 ock->pBtree==p )
3420: 7b 0a 20 20 20 20 20 20 2a 70 70 49 74 65 72 20 {. *ppIter
3430: 3d 20 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a = pLock->pNext;.
3440: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 4c assert( pL
3450: 6f 63 6b 2d 3e 69 54 61 62 6c 65 21 3d 31 20 7c ock->iTable!=1 |
3460: 7c 20 70 4c 6f 63 6b 3d 3d 26 70 2d 3e 6c 6f 63 | pLock==&p->loc
3470: 6b 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 k );. if( p
3480: 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 21 3d 31 20 Lock->iTable!=1
3490: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
34a0: 65 33 5f 66 72 65 65 28 70 4c 6f 63 6b 29 3b 0a e3_free(pLock);.
34b0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 }. }els
34c0: 65 7b 0a 20 20 20 20 20 20 70 70 49 74 65 72 20 e{. ppIter
34d0: 3d 20 26 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b = &pLock->pNext;
34e0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 . }. }.. as
34f0: 73 65 72 74 28 20 28 70 42 74 2d 3e 62 74 73 46 sert( (pBt->btsF
3500: 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e 44 49 lags & BTS_PENDI
3510: 4e 47 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 NG)==0 || pBt->p
3520: 57 72 69 74 65 72 20 29 3b 0a 20 20 69 66 28 20 Writer );. if(
3530: 70 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 20 pBt->pWriter==p
3540: 29 7b 0a 20 20 20 20 70 42 74 2d 3e 70 57 72 69 ){. pBt->pWri
3550: 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 ter = 0;. pBt
3560: 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 28 ->btsFlags &= ~(
3570: 42 54 53 5f 45 58 43 4c 55 53 49 56 45 7c 42 54 BTS_EXCLUSIVE|BT
3580: 53 5f 50 45 4e 44 49 4e 47 29 3b 0a 20 20 7d 65 S_PENDING);. }e
3590: 6c 73 65 20 69 66 28 20 70 42 74 2d 3e 6e 54 72 lse if( pBt->nTr
35a0: 61 6e 73 61 63 74 69 6f 6e 3d 3d 32 20 29 7b 0a ansaction==2 ){.
35b0: 20 20 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 /* This func
35c0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 tion is called w
35d0: 68 65 6e 20 42 74 72 65 65 20 70 20 69 73 20 63 hen Btree p is c
35e0: 6f 6e 63 6c 75 64 69 6e 67 20 69 74 73 20 0a 20 oncluding its .
35f0: 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f ** transactio
3600: 6e 2e 20 49 66 20 74 68 65 72 65 20 63 75 72 72 n. If there curr
3610: 65 6e 74 6c 79 20 65 78 69 73 74 73 20 61 20 77 ently exists a w
3620: 72 69 74 65 72 2c 20 61 6e 64 20 70 20 69 73 20 riter, and p is
3630: 6e 6f 74 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 not. ** that
3640: 77 72 69 74 65 72 2c 20 74 68 65 6e 20 74 68 65 writer, then the
3650: 20 6e 75 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 number of locks
3660: 20 68 65 6c 64 20 62 79 20 63 6f 6e 6e 65 63 74 held by connect
3670: 69 6f 6e 73 20 6f 74 68 65 72 0a 20 20 20 20 2a ions other. *
3680: 2a 20 74 68 61 6e 20 74 68 65 20 77 72 69 74 65 * than the write
3690: 72 20 6d 75 73 74 20 62 65 20 61 62 6f 75 74 20 r must be about
36a0: 74 6f 20 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2e to drop to zero.
36b0: 20 49 6e 20 74 68 69 73 20 63 61 73 65 0a 20 20 In this case.
36c0: 20 20 2a 2a 20 73 65 74 20 74 68 65 20 42 54 53 ** set the BTS
36d0: 5f 50 45 4e 44 49 4e 47 20 66 6c 61 67 20 74 6f _PENDING flag to
36e0: 20 30 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 0.. **. *
36f0: 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f * If there is no
3700: 74 20 63 75 72 72 65 6e 74 6c 79 20 61 20 77 72 t currently a wr
3710: 69 74 65 72 2c 20 74 68 65 6e 20 42 54 53 5f 50 iter, then BTS_P
3720: 45 4e 44 49 4e 47 20 6d 75 73 74 0a 20 20 20 20 ENDING must.
3730: 2a 2a 20 62 65 20 7a 65 72 6f 20 61 6c 72 65 61 ** be zero alrea
3740: 64 79 2e 20 53 6f 20 74 68 69 73 20 6e 65 78 74 dy. So this next
3750: 20 6c 69 6e 65 20 69 73 20 68 61 72 6d 6c 65 73 line is harmles
3760: 73 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e 0a s in that case..
3770: 20 20 20 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e */. pBt->
3780: 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 btsFlags &= ~BTS
3790: 5f 50 45 4e 44 49 4e 47 3b 0a 20 20 7d 0a 7d 0a _PENDING;. }.}.
37a0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
37b0: 74 69 6f 6e 20 63 68 61 6e 67 65 73 20 61 6c 6c tion changes all
37c0: 20 77 72 69 74 65 2d 6c 6f 63 6b 73 20 68 65 6c write-locks hel
37d0: 64 20 62 79 20 42 74 72 65 65 20 70 20 69 6e 74 d by Btree p int
37e0: 6f 20 72 65 61 64 2d 6c 6f 63 6b 73 2e 0a 2a 2f o read-locks..*/
37f0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 64 6f 77 .static void dow
3800: 6e 67 72 61 64 65 41 6c 6c 53 68 61 72 65 64 43 ngradeAllSharedC
3810: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 acheTableLocks(B
3820: 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 tree *p){. BtSh
3830: 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
3840: 42 74 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 Bt;. if( pBt->p
3850: 57 72 69 74 65 72 3d 3d 70 20 29 7b 0a 20 20 20 Writer==p ){.
3860: 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a BtLock *pLock;.
3870: 20 20 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 pBt->pWriter
3880: 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d 3e 62 = 0;. pBt->b
3890: 74 73 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 53 tsFlags &= ~(BTS
38a0: 5f 45 58 43 4c 55 53 49 56 45 7c 42 54 53 5f 50 _EXCLUSIVE|BTS_P
38b0: 45 4e 44 49 4e 47 29 3b 0a 20 20 20 20 66 6f 72 ENDING);. for
38c0: 28 70 4c 6f 63 6b 3d 70 42 74 2d 3e 70 4c 6f 63 (pLock=pBt->pLoc
38d0: 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d k; pLock; pLock=
38e0: 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 pLock->pNext){.
38f0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f assert( pLo
3900: 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f ck->eLock==READ_
3910: 4c 4f 43 4b 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 70 LOCK || pLock->p
3920: 42 74 72 65 65 3d 3d 70 20 29 3b 0a 20 20 20 20 Btree==p );.
3930: 20 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d pLock->eLock =
3940: 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 READ_LOCK;.
3950: 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 }. }.}..#endif
3960: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 /* SQLITE_OMIT_S
3970: 48 41 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a HARED_CACHE */..
3980: 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 static void rele
3990: 61 73 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 asePage(MemPage
39a0: 2a 70 50 61 67 65 29 3b 20 20 2f 2a 20 46 6f 72 *pPage); /* For
39b0: 77 61 72 64 20 72 65 66 65 72 65 6e 63 65 20 2a ward reference *
39c0: 2f 0a 0a 2f 2a 0a 2a 2a 2a 2a 2a 20 54 68 69 73 /../*.***** This
39d0: 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 routine is used
39e0: 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 65 72 inside of asser
39f0: 74 28 29 20 6f 6e 6c 79 20 2a 2a 2a 2a 0a 2a 2a t() only ****.**
3a00: 0a 2a 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 .** Verify that
3a10: 74 68 65 20 63 75 72 73 6f 72 20 68 6f 6c 64 73 the cursor holds
3a20: 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 69 74 the mutex on it
3a30: 73 20 42 74 53 68 61 72 65 64 0a 2a 2f 0a 23 69 s BtShared.*/.#i
3a40: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
3a50: 47 0a 73 74 61 74 69 63 20 69 6e 74 20 63 75 72 G.static int cur
3a60: 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 42 74 sorHoldsMutex(Bt
3a70: 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 72 65 Cursor *p){. re
3a80: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d 75 74 turn sqlite3_mut
3a90: 65 78 5f 68 65 6c 64 28 70 2d 3e 70 42 74 2d 3e ex_held(p->pBt->
3aa0: 6d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 mutex);.}.#endif
3ab0: 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ...#ifndef SQLIT
3ac0: 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a E_OMIT_INCRBLOB.
3ad0: 2f 2a 0a 2a 2a 20 49 6e 76 61 6c 69 64 61 74 65 /*.** Invalidate
3ae0: 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
3af0: 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 66 6f ge-list cache fo
3b00: 72 20 63 75 72 73 6f 72 20 70 43 75 72 2c 20 69 r cursor pCur, i
3b10: 66 20 61 6e 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 f any..*/.static
3b20: 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 74 65 void invalidate
3b30: 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 42 74 OverflowCache(Bt
3b40: 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
3b50: 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
3b60: 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
3b70: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 );. sqlite3_fre
3b80: 65 28 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f e(pCur->aOverflo
3b90: 77 29 3b 0a 20 20 70 43 75 72 2d 3e 61 4f 76 65 w);. pCur->aOve
3ba0: 72 66 6c 6f 77 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a rflow = 0;.}../*
3bb0: 0a 2a 2a 20 49 6e 76 61 6c 69 64 61 74 65 20 74 .** Invalidate t
3bc0: 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
3bd0: 2d 6c 69 73 74 20 63 61 63 68 65 20 66 6f 72 20 -list cache for
3be0: 61 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e all cursors open
3bf0: 65 64 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 ed.** on the sha
3c00: 72 65 64 20 62 74 72 65 65 20 73 74 72 75 63 74 red btree struct
3c10: 75 72 65 20 70 42 74 2e 0a 2a 2f 0a 73 74 61 74 ure pBt..*/.stat
3c20: 69 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 ic void invalida
3c30: 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 teAllOverflowCac
3c40: 68 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 he(BtShared *pBt
3c50: 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 ){. BtCursor *p
3c60: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
3c70: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
3c80: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
3c90: 66 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 for(p=pBt->pCurs
3ca0: 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 or; p; p=p->pNex
3cb0: 74 29 7b 0a 20 20 20 20 69 6e 76 61 6c 69 64 61 t){. invalida
3cc0: 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 teOverflowCache(
3cd0: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a p);. }.}../*.**
3ce0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
3cf0: 73 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 s called before
3d00: 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 63 6f modifying the co
3d10: 6e 74 65 6e 74 73 20 6f 66 20 61 20 74 61 62 6c ntents of a tabl
3d20: 65 0a 2a 2a 20 74 6f 20 69 6e 76 61 6c 69 64 61 e.** to invalida
3d30: 74 65 20 61 6e 79 20 69 6e 63 72 62 6c 6f 62 20 te any incrblob
3d40: 63 75 72 73 6f 72 73 20 74 68 61 74 20 61 72 65 cursors that are
3d50: 20 6f 70 65 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 open on the.**
3d60: 72 6f 77 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 row or one of th
3d70: 65 20 72 6f 77 73 20 62 65 69 6e 67 20 6d 6f 64 e rows being mod
3d80: 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ified..**.** If
3d90: 61 72 67 75 6d 65 6e 74 20 69 73 43 6c 65 61 72 argument isClear
3da0: 54 61 62 6c 65 20 69 73 20 74 72 75 65 2c 20 74 Table is true, t
3db0: 68 65 6e 20 74 68 65 20 65 6e 74 69 72 65 20 63 hen the entire c
3dc0: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 0a 2a ontents of the.*
3dd0: 2a 20 74 61 62 6c 65 20 69 73 20 61 62 6f 75 74 * table is about
3de0: 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 2e 20 to be deleted.
3df0: 49 6e 20 74 68 69 73 20 63 61 73 65 20 69 6e 76 In this case inv
3e00: 61 6c 69 64 61 74 65 20 61 6c 6c 20 69 6e 63 72 alidate all incr
3e10: 62 6c 6f 62 0a 2a 2a 20 63 75 72 73 6f 72 73 20 blob.** cursors
3e20: 6f 70 65 6e 20 6f 6e 20 61 6e 79 20 72 6f 77 20 open on any row
3e30: 77 69 74 68 69 6e 20 74 68 65 20 74 61 62 6c 65 within the table
3e40: 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 with root-page
3e50: 70 67 6e 6f 52 6f 6f 74 2e 0a 2a 2a 0a 2a 2a 20 pgnoRoot..**.**
3e60: 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 61 72 Otherwise, if ar
3e70: 67 75 6d 65 6e 74 20 69 73 43 6c 65 61 72 54 61 gument isClearTa
3e80: 62 6c 65 20 69 73 20 66 61 6c 73 65 2c 20 74 68 ble is false, th
3e90: 65 6e 20 74 68 65 20 72 6f 77 20 77 69 74 68 0a en the row with.
3ea0: 2a 2a 20 72 6f 77 69 64 20 69 52 6f 77 20 69 73 ** rowid iRow is
3eb0: 20 62 65 69 6e 67 20 72 65 70 6c 61 63 65 64 20 being replaced
3ec0: 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 6e 20 74 or deleted. In t
3ed0: 68 69 73 20 63 61 73 65 20 69 6e 76 61 6c 69 64 his case invalid
3ee0: 61 74 65 0a 2a 2a 20 6f 6e 6c 79 20 74 68 6f 73 ate.** only thos
3ef0: 65 20 69 6e 63 72 62 6c 6f 62 20 63 75 72 73 6f e incrblob curso
3f00: 72 73 20 6f 70 65 6e 20 6f 6e 20 74 68 61 74 20 rs open on that
3f10: 73 70 65 63 69 66 69 63 20 72 6f 77 2e 0a 2a 2f specific row..*/
3f20: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 6e 76 .static void inv
3f30: 61 6c 69 64 61 74 65 49 6e 63 72 62 6c 6f 62 43 alidateIncrblobC
3f40: 75 72 73 6f 72 73 28 0a 20 20 42 74 72 65 65 20 ursors(. Btree
3f50: 2a 70 42 74 72 65 65 2c 20 20 20 20 20 20 20 20 *pBtree,
3f60: 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 /* The databas
3f70: 65 20 66 69 6c 65 20 74 6f 20 63 68 65 63 6b 20 e file to check
3f80: 2a 2f 0a 20 20 69 36 34 20 69 52 6f 77 2c 20 20 */. i64 iRow,
3f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
3fa0: 54 68 65 20 72 6f 77 69 64 20 74 68 61 74 20 6d The rowid that m
3fb0: 69 67 68 74 20 62 65 20 63 68 61 6e 67 69 6e 67 ight be changing
3fc0: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6c 65 61 */. int isClea
3fd0: 72 54 61 62 6c 65 20 20 20 20 20 20 20 20 2f 2a rTable /*
3fe0: 20 54 72 75 65 20 69 66 20 61 6c 6c 20 72 6f 77 True if all row
3ff0: 73 20 61 72 65 20 62 65 69 6e 67 20 64 65 6c 65 s are being dele
4000: 74 65 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 43 75 ted */.){. BtCu
4010: 72 73 6f 72 20 2a 70 3b 0a 20 20 42 74 53 68 61 rsor *p;. BtSha
4020: 72 65 64 20 2a 70 42 74 20 3d 20 70 42 74 72 65 red *pBt = pBtre
4030: 65 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 e->pBt;. assert
4040: 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f ( sqlite3BtreeHo
4050: 6c 64 73 4d 75 74 65 78 28 70 42 74 72 65 65 29 ldsMutex(pBtree)
4060: 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 2d );. for(p=pBt-
4070: 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 >pCursor; p; p=p
4080: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 ->pNext){. if
4090: 28 20 70 2d 3e 69 73 49 6e 63 72 62 6c 6f 62 48 ( p->isIncrblobH
40a0: 61 6e 64 6c 65 20 26 26 20 28 69 73 43 6c 65 61 andle && (isClea
40b0: 72 54 61 62 6c 65 20 7c 7c 20 70 2d 3e 69 6e 66 rTable || p->inf
40c0: 6f 2e 6e 4b 65 79 3d 3d 69 52 6f 77 29 20 29 7b o.nKey==iRow) ){
40d0: 0a 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 . p->eState
40e0: 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 = CURSOR_INVALI
40f0: 44 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a D;. }. }.}..
4100: 23 65 6c 73 65 0a 20 20 2f 2a 20 53 74 75 62 20 #else. /* Stub
4110: 66 75 6e 63 74 69 6f 6e 73 20 77 68 65 6e 20 49 functions when I
4120: 4e 43 52 42 4c 4f 42 20 69 73 20 6f 6d 69 74 74 NCRBLOB is omitt
4130: 65 64 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 ed */. #define
4140: 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c invalidateOverfl
4150: 6f 77 43 61 63 68 65 28 78 29 0a 20 20 23 64 65 owCache(x). #de
4160: 66 69 6e 65 20 69 6e 76 61 6c 69 64 61 74 65 41 fine invalidateA
4170: 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 llOverflowCache(
4180: 78 29 0a 20 20 23 64 65 66 69 6e 65 20 69 6e 76 x). #define inv
4190: 61 6c 69 64 61 74 65 49 6e 63 72 62 6c 6f 62 43 alidateIncrblobC
41a0: 75 72 73 6f 72 73 28 78 2c 79 2c 7a 29 0a 23 65 ursors(x,y,z).#e
41b0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
41c0: 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a MIT_INCRBLOB */.
41d0: 0a 2f 2a 0a 2a 2a 20 53 65 74 20 62 69 74 20 70 ./*.** Set bit p
41e0: 67 6e 6f 20 6f 66 20 74 68 65 20 42 74 53 68 61 gno of the BtSha
41f0: 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 red.pHasContent
4200: 62 69 74 76 65 63 2e 20 54 68 69 73 20 69 73 20 bitvec. This is
4210: 63 61 6c 6c 65 64 20 0a 2a 2a 20 77 68 65 6e 20 called .** when
4220: 61 20 70 61 67 65 20 74 68 61 74 20 70 72 65 76 a page that prev
4230: 69 6f 75 73 6c 79 20 63 6f 6e 74 61 69 6e 65 64 iously contained
4240: 20 64 61 74 61 20 62 65 63 6f 6d 65 73 20 61 20 data becomes a
4250: 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 0a free-list leaf .
4260: 2a 2a 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 ** page..**.** T
4270: 68 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 he BtShared.pHas
4280: 43 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 20 65 Content bitvec e
4290: 78 69 73 74 73 20 74 6f 20 77 6f 72 6b 20 61 72 xists to work ar
42a0: 6f 75 6e 64 20 61 6e 20 6f 62 73 63 75 72 65 0a ound an obscure.
42b0: 2a 2a 20 62 75 67 20 63 61 75 73 65 64 20 62 79 ** bug caused by
42c0: 20 74 68 65 20 69 6e 74 65 72 61 63 74 69 6f 6e the interaction
42d0: 20 6f 66 20 74 77 6f 20 75 73 65 66 75 6c 20 49 of two useful I
42e0: 4f 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 O optimizations
42f0: 73 75 72 72 6f 75 6e 64 69 6e 67 0a 2a 2a 20 66 surrounding.** f
4300: 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 ree-list leaf pa
4310: 67 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 ges:.**.** 1)
4320: 57 68 65 6e 20 61 6c 6c 20 64 61 74 61 20 69 73 When all data is
4330: 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 61 20 deleted from a
4340: 70 61 67 65 20 61 6e 64 20 74 68 65 20 70 61 67 page and the pag
4350: 65 20 62 65 63 6f 6d 65 73 0a 2a 2a 20 20 20 20 e becomes.**
4360: 20 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 a free-list le
4370: 61 66 20 70 61 67 65 2c 20 74 68 65 20 70 61 67 af page, the pag
4380: 65 20 69 73 20 6e 6f 74 20 77 72 69 74 74 65 6e e is not written
4390: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
43a0: 0a 2a 2a 20 20 20 20 20 20 28 61 73 20 66 72 65 .** (as fre
43b0: 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 e-list leaf page
43c0: 73 20 63 6f 6e 74 61 69 6e 20 6e 6f 20 6d 65 61 s contain no mea
43d0: 6e 69 6e 67 66 75 6c 20 64 61 74 61 29 2e 20 53 ningful data). S
43e0: 6f 6d 65 74 69 6d 65 73 0a 2a 2a 20 20 20 20 20 ometimes.**
43f0: 20 73 75 63 68 20 61 20 70 61 67 65 20 69 73 20 such a page is
4400: 6e 6f 74 20 65 76 65 6e 20 6a 6f 75 72 6e 61 6c not even journal
4410: 6c 65 64 20 28 61 73 20 69 74 20 77 69 6c 6c 20 led (as it will
4420: 6e 6f 74 20 62 65 20 6d 6f 64 69 66 69 65 64 2c not be modified,
4430: 0a 2a 2a 20 20 20 20 20 20 77 68 79 20 62 6f 74 .** why bot
4440: 68 65 72 20 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 her journalling
4450: 69 74 3f 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 29 it?)..**.** 2)
4460: 20 57 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 When a free-lis
4470: 74 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 t leaf page is r
4480: 65 75 73 65 64 2c 20 69 74 73 20 63 6f 6e 74 65 eused, its conte
4490: 6e 74 20 69 73 20 6e 6f 74 20 72 65 61 64 0a 2a nt is not read.*
44a0: 2a 20 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 * from the
44b0: 64 61 74 61 62 61 73 65 20 6f 72 20 77 72 69 74 database or writ
44c0: 74 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e ten to the journ
44d0: 61 6c 20 66 69 6c 65 20 28 77 68 79 20 73 68 6f al file (why sho
44e0: 75 6c 64 20 69 74 0a 2a 2a 20 20 20 20 20 20 62 uld it.** b
44f0: 65 2c 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 e, if it is not
4500: 61 74 20 61 6c 6c 20 6d 65 61 6e 69 6e 67 66 75 at all meaningfu
4510: 6c 3f 29 2e 0a 2a 2a 0a 2a 2a 20 42 79 20 74 68 l?)..**.** By th
4520: 65 6d 73 65 6c 76 65 73 2c 20 74 68 65 73 65 20 emselves, these
4530: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 77 6f optimizations wo
4540: 72 6b 20 66 69 6e 65 20 61 6e 64 20 70 72 6f 76 rk fine and prov
4550: 69 64 65 20 61 20 68 61 6e 64 79 0a 2a 2a 20 70 ide a handy.** p
4560: 65 72 66 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74 erformance boost
4570: 20 74 6f 20 62 75 6c 6b 20 64 65 6c 65 74 65 20 to bulk delete
4580: 6f 72 20 69 6e 73 65 72 74 20 6f 70 65 72 61 74 or insert operat
4590: 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69 ions. However, i
45a0: 66 0a 2a 2a 20 61 20 70 61 67 65 20 69 73 20 6d f.** a page is m
45b0: 6f 76 65 64 20 74 6f 20 74 68 65 20 66 72 65 65 oved to the free
45c0: 2d 6c 69 73 74 20 61 6e 64 20 74 68 65 6e 20 72 -list and then r
45d0: 65 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 eused within the
45e0: 20 73 61 6d 65 0a 2a 2a 20 74 72 61 6e 73 61 63 same.** transac
45f0: 74 69 6f 6e 2c 20 61 20 70 72 6f 62 6c 65 6d 20 tion, a problem
4600: 63 6f 6d 65 73 20 75 70 2e 20 49 66 20 74 68 65 comes up. If the
4610: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 6a 6f 75 page is not jou
4620: 72 6e 61 6c 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 rnalled when.**
4630: 69 74 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 74 it is moved to t
4640: 68 65 20 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 he free-list and
4650: 20 69 74 20 69 73 20 61 6c 73 6f 20 6e 6f 74 20 it is also not
4660: 6a 6f 75 72 6e 61 6c 6c 65 64 20 77 68 65 6e 20 journalled when
4670: 69 74 0a 2a 2a 20 69 73 20 65 78 74 72 61 63 74 it.** is extract
4680: 65 64 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 ed from the free
4690: 2d 6c 69 73 74 20 61 6e 64 20 72 65 75 73 65 64 -list and reused
46a0: 2c 20 74 68 65 6e 20 74 68 65 20 6f 72 69 67 69 , then the origi
46b0: 6e 61 6c 20 64 61 74 61 0a 2a 2a 20 6d 61 79 20 nal data.** may
46c0: 62 65 20 6c 6f 73 74 2e 20 49 6e 20 74 68 65 20 be lost. In the
46d0: 65 76 65 6e 74 20 6f 66 20 61 20 72 6f 6c 6c 62 event of a rollb
46e0: 61 63 6b 2c 20 69 74 20 6d 61 79 20 6e 6f 74 20 ack, it may not
46f0: 62 65 20 70 6f 73 73 69 62 6c 65 0a 2a 2a 20 74 be possible.** t
4700: 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 o restore the da
4710: 74 61 62 61 73 65 20 74 6f 20 69 74 73 20 6f 72 tabase to its or
4720: 69 67 69 6e 61 6c 20 63 6f 6e 66 69 67 75 72 61 iginal configura
4730: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 tion..**.** The
4740: 73 6f 6c 75 74 69 6f 6e 20 69 73 20 74 68 65 20 solution is the
4750: 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e BtShared.pHasCon
4760: 74 65 6e 74 20 62 69 74 76 65 63 2e 20 57 68 65 tent bitvec. Whe
4770: 6e 65 76 65 72 20 61 20 70 61 67 65 20 69 73 20 never a page is
4780: 0a 2a 2a 20 6d 6f 76 65 64 20 74 6f 20 62 65 63 .** moved to bec
4790: 6f 6d 65 20 61 20 66 72 65 65 2d 6c 69 73 74 20 ome a free-list
47a0: 6c 65 61 66 20 70 61 67 65 2c 20 74 68 65 20 63 leaf page, the c
47b0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 orresponding bit
47c0: 20 69 73 0a 2a 2a 20 73 65 74 20 69 6e 20 74 68 is.** set in th
47d0: 65 20 62 69 74 76 65 63 2e 20 57 68 65 6e 65 76 e bitvec. Whenev
47e0: 65 72 20 61 20 6c 65 61 66 20 70 61 67 65 20 69 er a leaf page i
47f0: 73 20 65 78 74 72 61 63 74 65 64 20 66 72 6f 6d s extracted from
4800: 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 0a the free-list,.
4810: 2a 2a 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 ** optimization
4820: 32 20 61 62 6f 76 65 20 69 73 20 6f 6d 69 74 74 2 above is omitt
4830: 65 64 20 69 66 20 74 68 65 20 63 6f 72 72 65 73 ed if the corres
4840: 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 73 20 61 ponding bit is a
4850: 6c 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 69 6e lready.** set in
4860: 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f BtShared.pHasCo
4870: 6e 74 65 6e 74 2e 20 54 68 65 20 63 6f 6e 74 65 ntent. The conte
4880: 6e 74 73 20 6f 66 20 74 68 65 20 62 69 74 76 65 nts of the bitve
4890: 63 20 61 72 65 20 63 6c 65 61 72 65 64 0a 2a 2a c are cleared.**
48a0: 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 at the end of e
48b0: 76 65 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e very transaction
48c0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
48d0: 62 74 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 btreeSetHasConte
48e0: 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 nt(BtShared *pBt
48f0: 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 , Pgno pgno){.
4900: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
4910: 4f 4b 3b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e OK;. if( !pBt->
4920: 70 48 61 73 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 pHasContent ){.
4930: 20 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f 3c assert( pgno<
4940: 3d 70 42 74 2d 3e 6e 50 61 67 65 20 29 3b 0a 20 =pBt->nPage );.
4950: 20 20 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 pBt->pHasCont
4960: 65 6e 74 20 3d 20 73 71 6c 69 74 65 33 42 69 74 ent = sqlite3Bit
4970: 76 65 63 43 72 65 61 74 65 28 70 42 74 2d 3e 6e vecCreate(pBt->n
4980: 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 21 Page);. if( !
4990: 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 pBt->pHasContent
49a0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
49b0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 QLITE_NOMEM;.
49c0: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d }. }. if( rc=
49d0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 67 =SQLITE_OK && pg
49e0: 6e 6f 3c 3d 73 71 6c 69 74 65 33 42 69 74 76 65 no<=sqlite3Bitve
49f0: 63 53 69 7a 65 28 70 42 74 2d 3e 70 48 61 73 43 cSize(pBt->pHasC
4a00: 6f 6e 74 65 6e 74 29 20 29 7b 0a 20 20 20 20 72 ontent) ){. r
4a10: 63 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 c = sqlite3Bitve
4a20: 63 53 65 74 28 70 42 74 2d 3e 70 48 61 73 43 6f cSet(pBt->pHasCo
4a30: 6e 74 65 6e 74 2c 20 70 67 6e 6f 29 3b 0a 20 20 ntent, pgno);.
4a40: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
4a50: 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 68 ../*.** Query th
4a60: 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 e BtShared.pHasC
4a70: 6f 6e 74 65 6e 74 20 76 65 63 74 6f 72 2e 0a 2a ontent vector..*
4a80: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
4a90: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 on is called whe
4aa0: 6e 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 n a free-list le
4ab0: 61 66 20 70 61 67 65 20 69 73 20 72 65 6d 6f 76 af page is remov
4ac0: 65 64 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 66 ed from the.** f
4ad0: 72 65 65 2d 6c 69 73 74 20 66 6f 72 20 72 65 75 ree-list for reu
4ae0: 73 65 2e 20 49 74 20 72 65 74 75 72 6e 73 20 66 se. It returns f
4af0: 61 6c 73 65 20 69 66 20 69 74 20 69 73 20 73 61 alse if it is sa
4b00: 66 65 20 74 6f 20 72 65 74 72 69 65 76 65 20 74 fe to retrieve t
4b10: 68 65 0a 2a 2a 20 70 61 67 65 20 66 72 6f 6d 20 he.** page from
4b20: 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 20 the pager layer
4b30: 77 69 74 68 20 74 68 65 20 27 6e 6f 2d 63 6f 6e with the 'no-con
4b40: 74 65 6e 74 27 20 66 6c 61 67 20 73 65 74 2e 20 tent' flag set.
4b50: 54 72 75 65 20 6f 74 68 65 72 77 69 73 65 2e 0a True otherwise..
4b60: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
4b70: 72 65 65 47 65 74 48 61 73 43 6f 6e 74 65 6e 74 reeGetHasContent
4b80: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
4b90: 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 42 69 Pgno pgno){. Bi
4ba0: 74 76 65 63 20 2a 70 20 3d 20 70 42 74 2d 3e 70 tvec *p = pBt->p
4bb0: 48 61 73 43 6f 6e 74 65 6e 74 3b 0a 20 20 72 65 HasContent;. re
4bc0: 74 75 72 6e 20 28 70 20 26 26 20 28 70 67 6e 6f turn (p && (pgno
4bd0: 3e 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 69 >sqlite3BitvecSi
4be0: 7a 65 28 70 29 20 7c 7c 20 73 71 6c 69 74 65 33 ze(p) || sqlite3
4bf0: 42 69 74 76 65 63 54 65 73 74 28 70 2c 20 70 67 BitvecTest(p, pg
4c00: 6e 6f 29 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 no)));.}../*.**
4c10: 43 6c 65 61 72 20 28 64 65 73 74 72 6f 79 29 20 Clear (destroy)
4c20: 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 the BtShared.pHa
4c30: 73 43 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 2e sContent bitvec.
4c40: 20 54 68 69 73 20 73 68 6f 75 6c 64 20 62 65 0a This should be.
4c50: 2a 2a 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 ** invoked at th
4c60: 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 e conclusion of
4c70: 65 61 63 68 20 77 72 69 74 65 2d 74 72 61 6e 73 each write-trans
4c80: 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 action..*/.stati
4c90: 63 20 76 6f 69 64 20 62 74 72 65 65 43 6c 65 61 c void btreeClea
4ca0: 72 48 61 73 43 6f 6e 74 65 6e 74 28 42 74 53 68 rHasContent(BtSh
4cb0: 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 73 71 ared *pBt){. sq
4cc0: 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
4cd0: 6f 79 28 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 oy(pBt->pHasCont
4ce0: 65 6e 74 29 3b 0a 20 20 70 42 74 2d 3e 70 48 61 ent);. pBt->pHa
4cf0: 73 43 6f 6e 74 65 6e 74 20 3d 20 30 3b 0a 7d 0a sContent = 0;.}.
4d00: 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 ./*.** Release a
4d10: 6c 6c 20 6f 66 20 74 68 65 20 61 70 50 61 67 65 ll of the apPage
4d20: 5b 5d 20 70 61 67 65 73 20 66 6f 72 20 61 20 63 [] pages for a c
4d30: 75 72 73 6f 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 ursor..*/.static
4d40: 20 76 6f 69 64 20 62 74 72 65 65 52 65 6c 65 61 void btreeRelea
4d50: 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 65 73 seAllCursorPages
4d60: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
4d70: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 {. int i;. for
4d80: 28 69 3d 30 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 (i=0; i<=pCur->i
4d90: 50 61 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 Page; i++){.
4da0: 72 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 releasePage(pCur
4db0: 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 ->apPage[i]);.
4dc0: 20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 pCur->apPage[i
4dd0: 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 43 75 ] = 0;. }. pCu
4de0: 72 2d 3e 69 50 61 67 65 20 3d 20 2d 31 3b 0a 7d r->iPage = -1;.}
4df0: 0a 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 .../*.** Save th
4e00: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
4e10: 20 70 6f 73 69 74 69 6f 6e 20 69 6e 20 74 68 65 position in the
4e20: 20 76 61 72 69 61 62 6c 65 73 20 42 74 43 75 72 variables BtCur
4e30: 73 6f 72 2e 6e 4b 65 79 20 0a 2a 2a 20 61 6e 64 sor.nKey .** and
4e40: 20 42 74 43 75 72 73 6f 72 2e 70 4b 65 79 2e 20 BtCursor.pKey.
4e50: 54 68 65 20 63 75 72 73 6f 72 27 73 20 73 74 61 The cursor's sta
4e60: 74 65 20 69 73 20 73 65 74 20 74 6f 20 43 55 52 te is set to CUR
4e70: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 2e SOR_REQUIRESEEK.
4e80: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 .**.** The calle
4e90: 72 20 6d 75 73 74 20 65 6e 73 75 72 65 20 74 68 r must ensure th
4ea0: 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 at the cursor is
4eb0: 20 76 61 6c 69 64 20 28 68 61 73 20 65 53 74 61 valid (has eSta
4ec0: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
4ed0: 29 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 63 61 ).** prior to ca
4ee0: 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 lling this routi
4ef0: 6e 65 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 20 ne. .*/.static
4f00: 69 6e 74 20 73 61 76 65 43 75 72 73 6f 72 50 6f int saveCursorPo
4f10: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
4f20: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
4f30: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 43 55 52 ;.. assert( CUR
4f40: 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 2d SOR_VALID==pCur-
4f50: 3e 65 53 74 61 74 65 20 29 3b 0a 20 20 61 73 73 >eState );. ass
4f60: 65 72 74 28 20 30 3d 3d 70 43 75 72 2d 3e 70 4b ert( 0==pCur->pK
4f70: 65 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ey );. assert(
4f80: 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
4f90: 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 72 63 20 (pCur) );.. rc
4fa0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 = sqlite3BtreeKe
4fb0: 79 53 69 7a 65 28 70 43 75 72 2c 20 26 70 43 75 ySize(pCur, &pCu
4fc0: 72 2d 3e 6e 4b 65 79 29 3b 0a 20 20 61 73 73 65 r->nKey);. asse
4fd0: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f rt( rc==SQLITE_O
4fe0: 4b 20 29 3b 20 20 2f 2a 20 4b 65 79 53 69 7a 65 K ); /* KeySize
4ff0: 28 29 20 63 61 6e 6e 6f 74 20 66 61 69 6c 20 2a () cannot fail *
5000: 2f 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 /.. /* If this
5010: 69 73 20 61 6e 20 69 6e 74 4b 65 79 20 74 61 62 is an intKey tab
5020: 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 61 62 6f le, then the abo
5030: 76 65 20 63 61 6c 6c 20 74 6f 20 42 74 72 65 65 ve call to Btree
5040: 4b 65 79 53 69 7a 65 28 29 0a 20 20 2a 2a 20 73 KeySize(). ** s
5050: 74 6f 72 65 73 20 74 68 65 20 69 6e 74 65 67 65 tores the intege
5060: 72 20 6b 65 79 20 69 6e 20 70 43 75 72 2d 3e 6e r key in pCur->n
5070: 4b 65 79 2e 20 49 6e 20 74 68 69 73 20 63 61 73 Key. In this cas
5080: 65 20 74 68 69 73 20 76 61 6c 75 65 20 69 73 0a e this value is.
5090: 20 20 2a 2a 20 61 6c 6c 20 74 68 61 74 20 69 73 ** all that is
50a0: 20 72 65 71 75 69 72 65 64 2e 20 4f 74 68 65 72 required. Other
50b0: 77 69 73 65 2c 20 69 66 20 70 43 75 72 20 69 73 wise, if pCur is
50c0: 20 6e 6f 74 20 6f 70 65 6e 20 6f 6e 20 61 6e 20 not open on an
50d0: 69 6e 74 4b 65 79 0a 20 20 2a 2a 20 74 61 62 6c intKey. ** tabl
50e0: 65 2c 20 74 68 65 6e 20 6d 61 6c 6c 6f 63 20 73 e, then malloc s
50f0: 70 61 63 65 20 66 6f 72 20 61 6e 64 20 73 74 6f pace for and sto
5100: 72 65 20 74 68 65 20 70 43 75 72 2d 3e 6e 4b 65 re the pCur->nKe
5110: 79 20 62 79 74 65 73 20 6f 66 20 6b 65 79 20 0a y bytes of key .
5120: 20 20 2a 2a 20 64 61 74 61 2e 0a 20 20 2a 2f 0a ** data.. */.
5130: 20 20 69 66 28 20 30 3d 3d 70 43 75 72 2d 3e 61 if( 0==pCur->a
5140: 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 pPage[0]->intKey
5150: 20 29 7b 0a 20 20 20 20 76 6f 69 64 20 2a 70 4b ){. void *pK
5160: 65 79 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c ey = sqlite3Mall
5170: 6f 63 28 20 28 69 6e 74 29 70 43 75 72 2d 3e 6e oc( (int)pCur->n
5180: 4b 65 79 20 29 3b 0a 20 20 20 20 69 66 28 20 70 Key );. if( p
5190: 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 72 63 20 Key ){. rc
51a0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 = sqlite3BtreeKe
51b0: 79 28 70 43 75 72 2c 20 30 2c 20 28 69 6e 74 29 y(pCur, 0, (int)
51c0: 70 43 75 72 2d 3e 6e 4b 65 79 2c 20 70 4b 65 79 pCur->nKey, pKey
51d0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
51e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
51f0: 20 20 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 pCur->pKey
5200: 20 3d 20 70 4b 65 79 3b 0a 20 20 20 20 20 20 7d = pKey;. }
5210: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71 else{. sq
5220: 6c 69 74 65 33 5f 66 72 65 65 28 70 4b 65 79 29 lite3_free(pKey)
5230: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 ;. }. }e
5240: 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 lse{. rc =
5250: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
5260: 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 }. }. assert
5270: 28 20 21 70 43 75 72 2d 3e 61 70 50 61 67 65 5b ( !pCur->apPage[
5280: 30 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 21 70 0]->intKey || !p
5290: 43 75 72 2d 3e 70 4b 65 79 20 29 3b 0a 0a 20 20 Cur->pKey );..
52a0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
52b0: 4b 20 29 7b 0a 20 20 20 20 62 74 72 65 65 52 65 K ){. btreeRe
52c0: 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 leaseAllCursorPa
52d0: 67 65 73 28 70 43 75 72 29 3b 0a 20 20 20 20 70 ges(pCur);. p
52e0: 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
52f0: 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
5300: 3b 0a 20 20 7d 0a 0a 20 20 69 6e 76 61 6c 69 64 ;. }.. invalid
5310: 61 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 ateOverflowCache
5320: 28 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 6e (pCur);. return
5330: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 61 rc;.}../*.** Sa
5340: 76 65 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 73 ve the positions
5350: 20 6f 66 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 of all cursors
5360: 28 65 78 63 65 70 74 20 70 45 78 63 65 70 74 29 (except pExcept)
5370: 20 74 68 61 74 20 61 72 65 20 6f 70 65 6e 20 6f that are open o
5380: 6e 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 20 n.** the table
5390: 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 with root-page i
53a0: 52 6f 6f 74 2e 20 55 73 75 61 6c 6c 79 2c 20 74 Root. Usually, t
53b0: 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 6a 75 his is called ju
53c0: 73 74 20 62 65 66 6f 72 65 20 63 75 72 73 6f 72 st before cursor
53d0: 0a 2a 2a 20 70 45 78 63 65 70 74 20 69 73 20 75 .** pExcept is u
53e0: 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 sed to modify th
53f0: 65 20 74 61 62 6c 65 20 28 42 74 72 65 65 44 65 e table (BtreeDe
5400: 6c 65 74 65 28 29 20 6f 72 20 42 74 72 65 65 49 lete() or BtreeI
5410: 6e 73 65 72 74 28 29 29 2e 0a 2a 2f 0a 73 74 61 nsert())..*/.sta
5420: 74 69 63 20 69 6e 74 20 73 61 76 65 41 6c 6c 43 tic int saveAllC
5430: 75 72 73 6f 72 73 28 42 74 53 68 61 72 65 64 20 ursors(BtShared
5440: 2a 70 42 74 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 *pBt, Pgno iRoot
5450: 2c 20 42 74 43 75 72 73 6f 72 20 2a 70 45 78 63 , BtCursor *pExc
5460: 65 70 74 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 ept){. BtCursor
5470: 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73 *p;. assert( s
5480: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
5490: 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
54a0: 0a 20 20 61 73 73 65 72 74 28 20 70 45 78 63 65 . assert( pExce
54b0: 70 74 3d 3d 30 20 7c 7c 20 70 45 78 63 65 70 74 pt==0 || pExcept
54c0: 2d 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 20 20 ->pBt==pBt );.
54d0: 66 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 for(p=pBt->pCurs
54e0: 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 or; p; p=p->pNex
54f0: 74 29 7b 0a 20 20 20 20 69 66 28 20 70 21 3d 70 t){. if( p!=p
5500: 45 78 63 65 70 74 20 26 26 20 28 30 3d 3d 69 52 Except && (0==iR
5510: 6f 6f 74 20 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f oot || p->pgnoRo
5520: 6f 74 3d 3d 69 52 6f 6f 74 29 20 29 7b 0a 20 20 ot==iRoot) ){.
5530: 20 20 20 20 69 66 28 20 70 2d 3e 65 53 74 61 74 if( p->eStat
5540: 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
5550: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 72 ){. int r
5560: 63 20 3d 20 73 61 76 65 43 75 72 73 6f 72 50 6f c = saveCursorPo
5570: 73 69 74 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 sition(p);.
5580: 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b if( SQLITE_OK
5590: 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 !=rc ){.
55a0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
55b0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c }. }el
55c0: 73 65 7b 0a 20 20 20 20 20 20 20 20 74 65 73 74 se{. test
55d0: 63 61 73 65 28 20 70 2d 3e 69 50 61 67 65 3e 30 case( p->iPage>0
55e0: 20 29 3b 0a 20 20 20 20 20 20 20 20 62 74 72 65 );. btre
55f0: 65 52 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f eReleaseAllCurso
5600: 72 50 61 67 65 73 28 70 29 3b 0a 20 20 20 20 20 rPages(p);.
5610: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 }. }. }. r
5620: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
5630: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 .}../*.** Clear
5640: 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 the current curs
5650: 6f 72 20 70 6f 73 69 74 69 6f 6e 2e 0a 2a 2f 0a or position..*/.
5660: 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 void sqlite3Btre
5670: 65 43 6c 65 61 72 43 75 72 73 6f 72 28 42 74 43 eClearCursor(BtC
5680: 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
5690: 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
56a0: 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
56b0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 ;. sqlite3_free
56c0: 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 20 (pCur->pKey);.
56d0: 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 30 3b 0a pCur->pKey = 0;.
56e0: 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
56f0: 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
5700: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 20 74 68 69 .}../*.** In thi
5710: 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 42 74 72 s version of Btr
5720: 65 65 4d 6f 76 65 74 6f 2c 20 70 4b 65 79 20 69 eeMoveto, pKey i
5730: 73 20 61 20 70 61 63 6b 65 64 20 69 6e 64 65 78 s a packed index
5740: 20 72 65 63 6f 72 64 0a 2a 2a 20 73 75 63 68 20 record.** such
5750: 61 73 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 as is generated
5760: 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 by the OP_MakeRe
5770: 63 6f 72 64 20 6f 70 63 6f 64 65 2e 20 20 55 6e cord opcode. Un
5780: 70 61 63 6b 20 74 68 65 0a 2a 2a 20 72 65 63 6f pack the.** reco
5790: 72 64 20 61 6e 64 20 74 68 65 6e 20 63 61 6c 6c rd and then call
57a0: 20 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 61 BtreeMovetoUnpa
57b0: 63 6b 65 64 28 29 20 74 6f 20 64 6f 20 74 68 65 cked() to do the
57c0: 20 77 6f 72 6b 2e 0a 2a 2f 0a 73 74 61 74 69 63 work..*/.static
57d0: 20 69 6e 74 20 62 74 72 65 65 4d 6f 76 65 74 6f int btreeMoveto
57e0: 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 (. BtCursor *pC
57f0: 75 72 2c 20 20 20 20 20 2f 2a 20 43 75 72 73 6f ur, /* Curso
5800: 72 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 62 74 r open on the bt
5810: 72 65 65 20 74 6f 20 62 65 20 73 65 61 72 63 68 ree to be search
5820: 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f ed */. const vo
5830: 69 64 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 50 id *pKey, /* P
5840: 61 63 6b 65 64 20 6b 65 79 20 69 66 20 74 68 65 acked key if the
5850: 20 62 74 72 65 65 20 69 73 20 61 6e 20 69 6e 64 btree is an ind
5860: 65 78 20 2a 2f 0a 20 20 69 36 34 20 6e 4b 65 79 ex */. i64 nKey
5870: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 , /* I
5880: 6e 74 65 67 65 72 20 6b 65 79 20 66 6f 72 20 74 nteger key for t
5890: 61 62 6c 65 73 2e 20 20 53 69 7a 65 20 6f 66 20 ables. Size of
58a0: 70 4b 65 79 20 66 6f 72 20 69 6e 64 69 63 65 73 pKey for indices
58b0: 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 2c 20 */. int bias,
58c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 69 61 /* Bia
58d0: 73 20 73 65 61 72 63 68 20 74 6f 20 74 68 65 20 s search to the
58e0: 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 6e high end */. in
58f0: 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20 20 t *pRes
5900: 20 20 2f 2a 20 57 72 69 74 65 20 73 65 61 72 63 /* Write searc
5910: 68 20 72 65 73 75 6c 74 73 20 68 65 72 65 20 2a h results here *
5920: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 /.){. int rc;
5930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5940: 20 20 2f 2a 20 53 74 61 74 75 73 20 63 6f 64 65 /* Status code
5950: 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 */. UnpackedRe
5960: 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 3b 20 20 cord *pIdxKey;
5970: 20 2f 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e 64 /* Unpacked ind
5980: 65 78 20 6b 65 79 20 2a 2f 0a 20 20 63 68 61 72 ex key */. char
5990: 20 61 53 70 61 63 65 5b 31 35 30 5d 3b 20 20 20 aSpace[150];
59a0: 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 73 /* Temp s
59b0: 70 61 63 65 20 66 6f 72 20 70 49 64 78 4b 65 79 pace for pIdxKey
59c0: 20 2d 20 74 6f 20 61 76 6f 69 64 20 61 20 6d 61 - to avoid a ma
59d0: 6c 6c 6f 63 20 2a 2f 0a 20 20 63 68 61 72 20 2a lloc */. char *
59e0: 70 46 72 65 65 20 3d 20 30 3b 0a 0a 20 20 69 66 pFree = 0;.. if
59f0: 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 61 73 ( pKey ){. as
5a00: 73 65 72 74 28 20 6e 4b 65 79 3d 3d 28 69 36 34 sert( nKey==(i64
5a10: 29 28 69 6e 74 29 6e 4b 65 79 20 29 3b 0a 20 20 )(int)nKey );.
5a20: 20 20 70 49 64 78 4b 65 79 20 3d 20 73 71 6c 69 pIdxKey = sqli
5a30: 74 65 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 61 te3VdbeAllocUnpa
5a40: 63 6b 65 64 52 65 63 6f 72 64 28 0a 20 20 20 20 ckedRecord(.
5a50: 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 6e pCur->pKeyIn
5a60: 66 6f 2c 20 61 53 70 61 63 65 2c 20 73 69 7a 65 fo, aSpace, size
5a70: 6f 66 28 61 53 70 61 63 65 29 2c 20 26 70 46 72 of(aSpace), &pFr
5a80: 65 65 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66 ee. );. if
5a90: 28 20 70 49 64 78 4b 65 79 3d 3d 30 20 29 20 72 ( pIdxKey==0 ) r
5aa0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
5ab0: 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 EM;. sqlite3V
5ac0: 64 62 65 52 65 63 6f 72 64 55 6e 70 61 63 6b 28 dbeRecordUnpack(
5ad0: 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 pCur->pKeyInfo,
5ae0: 28 69 6e 74 29 6e 4b 65 79 2c 20 70 4b 65 79 2c (int)nKey, pKey,
5af0: 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 7d 65 6c pIdxKey);. }el
5b00: 73 65 7b 0a 20 20 20 20 70 49 64 78 4b 65 79 20 se{. pIdxKey
5b10: 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 = 0;. }. rc =
5b20: 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 sqlite3BtreeMove
5b30: 74 6f 55 6e 70 61 63 6b 65 64 28 70 43 75 72 2c toUnpacked(pCur,
5b40: 20 70 49 64 78 4b 65 79 2c 20 6e 4b 65 79 2c 20 pIdxKey, nKey,
5b50: 62 69 61 73 2c 20 70 52 65 73 29 3b 0a 20 20 69 bias, pRes);. i
5b60: 66 28 20 70 46 72 65 65 20 29 7b 0a 20 20 20 20 f( pFree ){.
5b70: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 70 43 sqlite3DbFree(pC
5b80: 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2d 3e 64 62 ur->pKeyInfo->db
5b90: 2c 20 70 46 72 65 65 29 3b 0a 20 20 7d 0a 20 20 , pFree);. }.
5ba0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
5bb0: 0a 2a 2a 20 52 65 73 74 6f 72 65 20 74 68 65 20 .** Restore the
5bc0: 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 70 6f cursor to the po
5bd0: 73 69 74 69 6f 6e 20 69 74 20 77 61 73 20 69 6e sition it was in
5be0: 20 28 6f 72 20 61 73 20 63 6c 6f 73 65 20 74 6f (or as close to
5bf0: 20 61 73 20 70 6f 73 73 69 62 6c 65 29 0a 2a 2a as possible).**
5c00: 20 77 68 65 6e 20 73 61 76 65 43 75 72 73 6f 72 when saveCursor
5c10: 50 6f 73 69 74 69 6f 6e 28 29 20 77 61 73 20 63 Position() was c
5c20: 61 6c 6c 65 64 2e 20 4e 6f 74 65 20 74 68 61 74 alled. Note that
5c30: 20 74 68 69 73 20 63 61 6c 6c 20 64 65 6c 65 74 this call delet
5c40: 65 73 20 74 68 65 20 0a 2a 2a 20 73 61 76 65 64 es the .** saved
5c50: 20 70 6f 73 69 74 69 6f 6e 20 69 6e 66 6f 20 73 position info s
5c60: 74 6f 72 65 64 20 62 79 20 73 61 76 65 43 75 72 tored by saveCur
5c70: 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2c 20 73 sorPosition(), s
5c80: 6f 20 74 68 65 72 65 20 63 61 6e 20 62 65 0a 2a o there can be.*
5c90: 2a 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 65 66 * at most one ef
5ca0: 66 65 63 74 69 76 65 20 72 65 73 74 6f 72 65 43 fective restoreC
5cb0: 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 20 ursorPosition()
5cc0: 63 61 6c 6c 20 61 66 74 65 72 20 65 61 63 68 20 call after each
5cd0: 0a 2a 2a 20 73 61 76 65 43 75 72 73 6f 72 50 6f .** saveCursorPo
5ce0: 73 69 74 69 6f 6e 28 29 2e 0a 2a 2f 0a 73 74 61 sition()..*/.sta
5cf0: 74 69 63 20 69 6e 74 20 62 74 72 65 65 52 65 73 tic int btreeRes
5d00: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
5d10: 6f 6e 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 on(BtCursor *pCu
5d20: 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 r){. int rc;.
5d30: 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
5d40: 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
5d50: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
5d60: 2d 3e 65 53 74 61 74 65 3e 3d 43 55 52 53 4f 52 ->eState>=CURSOR
5d70: 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a _REQUIRESEEK );.
5d80: 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
5d90: 74 65 3d 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 te==CURSOR_FAULT
5da0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 ){. return p
5db0: 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 Cur->skipNext;.
5dc0: 20 7d 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 74 }. pCur->eStat
5dd0: 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c e = CURSOR_INVAL
5de0: 49 44 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 ID;. rc = btree
5df0: 4d 6f 76 65 74 6f 28 70 43 75 72 2c 20 70 43 75 Moveto(pCur, pCu
5e00: 72 2d 3e 70 4b 65 79 2c 20 70 43 75 72 2d 3e 6e r->pKey, pCur->n
5e10: 4b 65 79 2c 20 30 2c 20 26 70 43 75 72 2d 3e 73 Key, 0, &pCur->s
5e20: 6b 69 70 4e 65 78 74 29 3b 0a 20 20 69 66 28 20 kipNext);. if(
5e30: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
5e40: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
5e50: 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 e(pCur->pKey);.
5e60: 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 pCur->pKey =
5e70: 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 0;. assert( p
5e80: 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
5e90: 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 SOR_VALID || pCu
5ea0: 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
5eb0: 52 5f 49 4e 56 41 4c 49 44 20 29 3b 0a 20 20 20 R_INVALID );.
5ec0: 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e if( pCur->skipN
5ed0: 65 78 74 20 26 26 20 70 43 75 72 2d 3e 65 53 74 ext && pCur->eSt
5ee0: 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
5ef0: 44 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d D ){. pCur-
5f00: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
5f10: 5f 53 4b 49 50 4e 45 58 54 3b 0a 20 20 20 20 7d _SKIPNEXT;. }
5f20: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
5f30: 3b 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 72 65 73 ;.}..#define res
5f40: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
5f50: 6f 6e 28 70 29 20 5c 0a 20 20 28 70 2d 3e 65 53 on(p) \. (p->eS
5f60: 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
5f70: 55 49 52 45 53 45 45 4b 20 3f 20 5c 0a 20 20 20 UIRESEEK ? \.
5f80: 20 20 20 20 20 20 62 74 72 65 65 52 65 73 74 6f btreeResto
5f90: 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e reCursorPosition
5fa0: 28 70 29 20 3a 20 5c 0a 20 20 20 20 20 20 20 20 (p) : \.
5fb0: 20 53 51 4c 49 54 45 5f 4f 4b 29 0a 0a 2f 2a 0a SQLITE_OK)../*.
5fc0: 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 ** Determine whe
5fd0: 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 63 75 ther or not a cu
5fe0: 72 73 6f 72 20 68 61 73 20 6d 6f 76 65 64 20 66 rsor has moved f
5ff0: 72 6f 6d 20 74 68 65 20 70 6f 73 69 74 69 6f 6e rom the position
6000: 20 69 74 0a 2a 2a 20 77 61 73 20 6c 61 73 74 20 it.** was last
6010: 70 6c 61 63 65 64 20 61 74 2e 20 20 43 75 72 73 placed at. Curs
6020: 6f 72 73 20 63 61 6e 20 6d 6f 76 65 20 77 68 65 ors can move whe
6030: 6e 20 74 68 65 20 72 6f 77 20 74 68 65 79 20 61 n the row they a
6040: 72 65 20 70 6f 69 6e 74 69 6e 67 0a 2a 2a 20 61 re pointing.** a
6050: 74 20 69 73 20 64 65 6c 65 74 65 64 20 6f 75 74 t is deleted out
6060: 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 6d from under them
6070: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
6080: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 61 6e 20 tine returns an
6090: 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 73 6f error code if so
60a0: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
60b0: 6e 67 2e 20 20 54 68 65 0a 2a 2a 20 69 6e 74 65 ng. The.** inte
60c0: 67 65 72 20 2a 70 48 61 73 4d 6f 76 65 64 20 69 ger *pHasMoved i
60d0: 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 69 66 20 s set to one if
60e0: 74 68 65 20 63 75 72 73 6f 72 20 68 61 73 20 6d the cursor has m
60f0: 6f 76 65 64 20 61 6e 64 20 30 20 69 66 20 6e 6f oved and 0 if no
6100: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
6110: 33 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 3BtreeCursorHasM
6120: 6f 76 65 64 28 42 74 43 75 72 73 6f 72 20 2a 70 oved(BtCursor *p
6130: 43 75 72 2c 20 69 6e 74 20 2a 70 48 61 73 4d 6f Cur, int *pHasMo
6140: 76 65 64 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a ved){. int rc;.
6150: 0a 20 20 72 63 20 3d 20 72 65 73 74 6f 72 65 43 . rc = restoreC
6160: 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 ursorPosition(pC
6170: 75 72 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b ur);. if( rc ){
6180: 0a 20 20 20 20 2a 70 48 61 73 4d 6f 76 65 64 20 . *pHasMoved
6190: 3d 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 = 1;. return
61a0: 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 rc;. }. if( pC
61b0: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
61c0: 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 4e 45 56 45 OR_VALID || NEVE
61d0: 52 28 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 R(pCur->skipNext
61e0: 21 3d 30 29 20 29 7b 0a 20 20 20 20 2a 70 48 61 !=0) ){. *pHa
61f0: 73 4d 6f 76 65 64 20 3d 20 31 3b 0a 20 20 7d 65 sMoved = 1;. }e
6200: 6c 73 65 7b 0a 20 20 20 20 2a 70 48 61 73 4d 6f lse{. *pHasMo
6210: 76 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 ved = 0;. }. r
6220: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6230: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
6240: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
6250: 55 4d 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 UM./*.** Given a
6260: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
6270: 61 20 72 65 67 75 6c 61 72 20 64 61 74 61 62 61 a regular databa
6280: 73 65 20 70 61 67 65 2c 20 72 65 74 75 72 6e 20 se page, return
6290: 74 68 65 20 70 61 67 65 0a 2a 2a 20 6e 75 6d 62 the page.** numb
62a0: 65 72 20 66 6f 72 20 74 68 65 20 70 6f 69 6e 74 er for the point
62b0: 65 72 2d 6d 61 70 20 70 61 67 65 20 74 68 61 74 er-map page that
62c0: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 65 6e contains the en
62d0: 74 72 79 20 66 6f 72 20 74 68 65 0a 2a 2a 20 69 try for the.** i
62e0: 6e 70 75 74 20 70 61 67 65 20 6e 75 6d 62 65 72 nput page number
62f0: 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 30 ..**.** Return 0
6300: 20 28 6e 6f 74 20 61 20 76 61 6c 69 64 20 70 61 (not a valid pa
6310: 67 65 29 20 66 6f 72 20 70 67 6e 6f 3d 3d 31 20 ge) for pgno==1
6320: 73 69 6e 63 65 20 74 68 65 72 65 20 69 73 0a 2a since there is.*
6330: 2a 20 6e 6f 20 70 6f 69 6e 74 65 72 20 6d 61 70 * no pointer map
6340: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
6350: 20 70 61 67 65 20 31 2e 20 20 54 68 65 20 69 6e page 1. The in
6360: 74 65 67 72 69 74 79 5f 63 68 65 63 6b 20 6c 6f tegrity_check lo
6370: 67 69 63 0a 2a 2a 20 72 65 71 75 69 72 65 73 20 gic.** requires
6380: 74 68 61 74 20 70 74 72 6d 61 70 50 61 67 65 6e that ptrmapPagen
6390: 6f 28 2a 2c 31 29 21 3d 31 2e 0a 2a 2f 0a 73 74 o(*,1)!=1..*/.st
63a0: 61 74 69 63 20 50 67 6e 6f 20 70 74 72 6d 61 70 atic Pgno ptrmap
63b0: 50 61 67 65 6e 6f 28 42 74 53 68 61 72 65 64 20 Pageno(BtShared
63c0: 2a 70 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 *pBt, Pgno pgno)
63d0: 7b 0a 20 20 69 6e 74 20 6e 50 61 67 65 73 50 65 {. int nPagesPe
63e0: 72 4d 61 70 50 61 67 65 3b 0a 20 20 50 67 6e 6f rMapPage;. Pgno
63f0: 20 69 50 74 72 4d 61 70 2c 20 72 65 74 3b 0a 20 iPtrMap, ret;.
6400: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
6410: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
6420: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
6430: 20 70 67 6e 6f 3c 32 20 29 20 72 65 74 75 72 6e pgno<2 ) return
6440: 20 30 3b 0a 20 20 6e 50 61 67 65 73 50 65 72 4d 0;. nPagesPerM
6450: 61 70 50 61 67 65 20 3d 20 28 70 42 74 2d 3e 75 apPage = (pBt->u
6460: 73 61 62 6c 65 53 69 7a 65 2f 35 29 2b 31 3b 0a sableSize/5)+1;.
6470: 20 20 69 50 74 72 4d 61 70 20 3d 20 28 70 67 6e iPtrMap = (pgn
6480: 6f 2d 32 29 2f 6e 50 61 67 65 73 50 65 72 4d 61 o-2)/nPagesPerMa
6490: 70 50 61 67 65 3b 0a 20 20 72 65 74 20 3d 20 28 pPage;. ret = (
64a0: 69 50 74 72 4d 61 70 2a 6e 50 61 67 65 73 50 65 iPtrMap*nPagesPe
64b0: 72 4d 61 70 50 61 67 65 29 20 2b 20 32 3b 20 0a rMapPage) + 2; .
64c0: 20 20 69 66 28 20 72 65 74 3d 3d 50 45 4e 44 49 if( ret==PENDI
64d0: 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
64e0: 29 20 29 7b 0a 20 20 20 20 72 65 74 2b 2b 3b 0a ) ){. ret++;.
64f0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 65 74 }. return ret
6500: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 ;.}../*.** Write
6510: 20 61 6e 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 an entry into t
6520: 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 2e 0a he pointer map..
6530: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
6540: 6e 65 20 75 70 64 61 74 65 73 20 74 68 65 20 70 ne updates the p
6550: 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 ointer map entry
6560: 20 66 6f 72 20 70 61 67 65 20 6e 75 6d 62 65 72 for page number
6570: 20 27 6b 65 79 27 0a 2a 2a 20 73 6f 20 74 68 61 'key'.** so tha
6580: 74 20 69 74 20 6d 61 70 73 20 74 6f 20 74 79 70 t it maps to typ
6590: 65 20 27 65 54 79 70 65 27 20 61 6e 64 20 70 61 e 'eType' and pa
65a0: 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 72 rent page number
65b0: 20 27 70 67 6e 6f 27 2e 0a 2a 2a 0a 2a 2a 20 49 'pgno'..**.** I
65c0: 66 20 2a 70 52 43 20 69 73 20 69 6e 69 74 69 61 f *pRC is initia
65d0: 6c 6c 79 20 6e 6f 6e 2d 7a 65 72 6f 20 28 6e 6f lly non-zero (no
65e0: 6e 2d 53 51 4c 49 54 45 5f 4f 4b 29 20 74 68 65 n-SQLITE_OK) the
65f0: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 n this routine i
6600: 73 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 2e 20 20 49 s.** a no-op. I
6610: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
6620: 73 2c 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 s, the appropria
6630: 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 te error code is
6640: 20 77 72 69 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f written.** into
6650: 20 2a 70 52 43 2e 0a 2a 2f 0a 73 74 61 74 69 63 *pRC..*/.static
6660: 20 76 6f 69 64 20 70 74 72 6d 61 70 50 75 74 28 void ptrmapPut(
6670: 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
6680: 67 6e 6f 20 6b 65 79 2c 20 75 38 20 65 54 79 70 gno key, u8 eTyp
6690: 65 2c 20 50 67 6e 6f 20 70 61 72 65 6e 74 2c 20 e, Pgno parent,
66a0: 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 44 62 50 int *pRC){. DbP
66b0: 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 2f age *pDbPage; /
66c0: 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 * The pointer ma
66d0: 70 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a p page */. u8 *
66e0: 70 50 74 72 6d 61 70 3b 20 20 20 20 20 20 2f 2a pPtrmap; /*
66f0: 20 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 The pointer map
6700: 20 64 61 74 61 20 2a 2f 0a 20 20 50 67 6e 6f 20 data */. Pgno
6710: 69 50 74 72 6d 61 70 3b 20 20 20 20 20 2f 2a 20 iPtrmap; /*
6720: 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 The pointer map
6730: 70 61 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 page number */.
6740: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
6750: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 /* Offset in
6760: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
6770: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 */. int rc;
6780: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
6790: 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 75 62 66 n code from subf
67a0: 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 0a 20 20 69 unctions */.. i
67b0: 66 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e f( *pRC ) return
67c0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
67d0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
67e0: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
67f0: 20 2f 2a 20 54 68 65 20 6d 61 73 74 65 72 2d 6a /* The master-j
6800: 6f 75 72 6e 61 6c 20 70 61 67 65 20 6e 75 6d 62 ournal page numb
6810: 65 72 20 6d 75 73 74 20 6e 65 76 65 72 20 62 65 er must never be
6820: 20 75 73 65 64 20 61 73 20 61 20 70 6f 69 6e 74 used as a point
6830: 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 er map page */.
6840: 20 61 73 73 65 72 74 28 20 30 3d 3d 50 54 52 4d assert( 0==PTRM
6850: 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 50 AP_ISPAGE(pBt, P
6860: 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
6870: 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 61 73 73 (pBt)) );.. ass
6880: 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 ert( pBt->autoVa
6890: 63 75 75 6d 20 29 3b 0a 20 20 69 66 28 20 6b 65 cuum );. if( ke
68a0: 79 3d 3d 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 y==0 ){. *pRC
68b0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
68c0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 T_BKPT;. retu
68d0: 72 6e 3b 0a 20 20 7d 0a 20 20 69 50 74 72 6d 61 rn;. }. iPtrma
68e0: 70 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 4e p = PTRMAP_PAGEN
68f0: 4f 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 72 O(pBt, key);. r
6900: 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
6910: 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c Get(pBt->pPager,
6920: 20 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 61 iPtrmap, &pDbPa
6930: 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 ge);. if( rc!=S
6940: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
6950: 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 *pRC = rc;. r
6960: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 6f 66 66 eturn;. }. off
6970: 73 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 set = PTRMAP_PTR
6980: 4f 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 OFFSET(iPtrmap,
6990: 6b 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 key);. if( offs
69a0: 65 74 3c 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 et<0 ){. *pRC
69b0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
69c0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f T_BKPT;. goto
69d0: 20 70 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 20 ptrmap_exit;.
69e0: 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 }. assert( offs
69f0: 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e et <= (int)pBt->
6a00: 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a usableSize-5 );.
6a10: 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 pPtrmap = (u8
6a20: 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 *)sqlite3PagerGe
6a30: 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a tData(pDbPage);.
6a40: 0a 20 20 69 66 28 20 65 54 79 70 65 21 3d 70 50 . if( eType!=pP
6a50: 74 72 6d 61 70 5b 6f 66 66 73 65 74 5d 20 7c 7c trmap[offset] ||
6a60: 20 67 65 74 34 62 79 74 65 28 26 70 50 74 72 6d get4byte(&pPtrm
6a70: 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 21 3d 70 ap[offset+1])!=p
6a80: 61 72 65 6e 74 20 29 7b 0a 20 20 20 20 54 52 41 arent ){. TRA
6a90: 43 45 28 28 22 50 54 52 4d 41 50 5f 55 50 44 41 CE(("PTRMAP_UPDA
6aa0: 54 45 3a 20 25 64 2d 3e 28 25 64 2c 25 64 29 5c TE: %d->(%d,%d)\
6ab0: 6e 22 2c 20 6b 65 79 2c 20 65 54 79 70 65 2c 20 n", key, eType,
6ac0: 70 61 72 65 6e 74 29 29 3b 0a 20 20 20 20 2a 70 parent));. *p
6ad0: 52 43 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33 RC= rc = sqlite3
6ae0: 50 61 67 65 72 57 72 69 74 65 28 70 44 62 50 61 PagerWrite(pDbPa
6af0: 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d ge);. if( rc=
6b00: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
6b10: 20 20 20 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 pPtrmap[offs
6b20: 65 74 5d 20 3d 20 65 54 79 70 65 3b 0a 20 20 20 et] = eType;.
6b30: 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 74 put4byte(&pPt
6b40: 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 2c 20 rmap[offset+1],
6b50: 70 61 72 65 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 parent);. }.
6b60: 20 7d 0a 0a 70 74 72 6d 61 70 5f 65 78 69 74 3a }..ptrmap_exit:
6b70: 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 . sqlite3PagerU
6b80: 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 7d nref(pDbPage);.}
6b90: 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 6e 20 ../*.** Read an
6ba0: 65 6e 74 72 79 20 66 72 6f 6d 20 74 68 65 20 70 entry from the p
6bb0: 6f 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a ointer map..**.*
6bc0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 * This routine r
6bd0: 65 74 72 69 65 76 65 73 20 74 68 65 20 70 6f 69 etrieves the poi
6be0: 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 nter map entry f
6bf0: 6f 72 20 70 61 67 65 20 27 6b 65 79 27 2c 20 77 or page 'key', w
6c00: 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 74 79 riting.** the ty
6c10: 70 65 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 pe and parent pa
6c20: 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 2a 70 45 ge number to *pE
6c30: 54 79 70 65 20 61 6e 64 20 2a 70 50 67 6e 6f 20 Type and *pPgno
6c40: 72 65 73 70 65 63 74 69 76 65 6c 79 2e 0a 2a 2a respectively..**
6c50: 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 An error code i
6c60: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 73 6f s returned if so
6c70: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
6c80: 6e 67 2c 20 6f 74 68 65 72 77 69 73 65 20 53 51 ng, otherwise SQ
6c90: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 LITE_OK..*/.stat
6ca0: 69 63 20 69 6e 74 20 70 74 72 6d 61 70 47 65 74 ic int ptrmapGet
6cb0: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
6cc0: 50 67 6e 6f 20 6b 65 79 2c 20 75 38 20 2a 70 45 Pgno key, u8 *pE
6cd0: 54 79 70 65 2c 20 50 67 6e 6f 20 2a 70 50 67 6e Type, Pgno *pPgn
6ce0: 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 o){. DbPage *pD
6cf0: 62 50 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 bPage; /* The
6d00: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
6d10: 20 2a 2f 0a 20 20 69 6e 74 20 69 50 74 72 6d 61 */. int iPtrma
6d20: 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e p; /* Poin
6d30: 74 65 72 20 6d 61 70 20 70 61 67 65 20 69 6e 64 ter map page ind
6d40: 65 78 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 ex */. u8 *pPtr
6d50: 6d 61 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f map; /* Po
6d60: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 64 inter map page d
6d70: 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 ata */. int off
6d80: 73 65 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f set; /* O
6d90: 66 66 73 65 74 20 6f 66 20 65 6e 74 72 79 20 69 ffset of entry i
6da0: 6e 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 2a 2f n pointer map */
6db0: 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
6dc0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
6dd0: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
6de0: 74 65 78 29 20 29 3b 0a 0a 20 20 69 50 74 72 6d tex) );.. iPtrm
6df0: 61 70 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 ap = PTRMAP_PAGE
6e00: 4e 4f 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 NO(pBt, key);.
6e10: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
6e20: 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
6e30: 2c 20 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 , iPtrmap, &pDbP
6e40: 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d age);. if( rc!=
6e50: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
6e60: 72 63 3b 0a 20 20 7d 0a 20 20 70 50 74 72 6d 61 rc;. }. pPtrma
6e70: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
6e80: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
6e90: 62 50 61 67 65 29 3b 0a 0a 20 20 6f 66 66 73 65 bPage);.. offse
6ea0: 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f 46 t = PTRMAP_PTROF
6eb0: 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b 65 FSET(iPtrmap, ke
6ec0: 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 74 y);. if( offset
6ed0: 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 <0 ){. sqlite
6ee0: 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 50 3PagerUnref(pDbP
6ef0: 61 67 65 29 3b 0a 20 20 20 20 72 65 74 75 72 6e age);. return
6f00: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
6f10: 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 65 BKPT;. }. asse
6f20: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
6f30: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
6f40: 7a 65 2d 35 20 29 3b 0a 20 20 61 73 73 65 72 74 ze-5 );. assert
6f50: 28 20 70 45 54 79 70 65 21 3d 30 20 29 3b 0a 20 ( pEType!=0 );.
6f60: 20 2a 70 45 54 79 70 65 20 3d 20 70 50 74 72 6d *pEType = pPtrm
6f70: 61 70 5b 6f 66 66 73 65 74 5d 3b 0a 20 20 69 66 ap[offset];. if
6f80: 28 20 70 50 67 6e 6f 20 29 20 2a 70 50 67 6e 6f ( pPgno ) *pPgno
6f90: 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 74 = get4byte(&pPt
6fa0: 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 3b rmap[offset+1]);
6fb0: 0a 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 .. sqlite3Pager
6fc0: 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a Unref(pDbPage);.
6fd0: 20 20 69 66 28 20 2a 70 45 54 79 70 65 3c 31 20 if( *pEType<1
6fe0: 7c 7c 20 2a 70 45 54 79 70 65 3e 35 20 29 20 72 || *pEType>5 ) r
6ff0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
7000: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 72 65 74 RUPT_BKPT;. ret
7010: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
7020: 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 64 65 ..#else /* if de
7030: 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4d 49 fined SQLITE_OMI
7040: 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f 0a T_AUTOVACUUM */.
7050: 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 #define ptrmap
7060: 50 75 74 28 77 2c 78 2c 79 2c 7a 2c 72 63 29 0a Put(w,x,y,z,rc).
7070: 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 #define ptrmap
7080: 47 65 74 28 77 2c 78 2c 79 2c 7a 29 20 53 51 4c Get(w,x,y,z) SQL
7090: 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 69 6e 65 ITE_OK. #define
70a0: 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 ptrmapPutOvflPt
70b0: 72 28 78 2c 20 79 2c 20 72 63 29 0a 23 65 6e 64 r(x, y, rc).#end
70c0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 if../*.** Given
70d0: 61 20 62 74 72 65 65 20 70 61 67 65 20 61 6e 64 a btree page and
70e0: 20 61 20 63 65 6c 6c 20 69 6e 64 65 78 20 28 30 a cell index (0
70f0: 20 6d 65 61 6e 73 20 74 68 65 20 66 69 72 73 74 means the first
7100: 20 63 65 6c 6c 20 6f 6e 0a 2a 2a 20 74 68 65 20 cell on.** the
7110: 70 61 67 65 2c 20 31 20 6d 65 61 6e 73 20 74 68 page, 1 means th
7120: 65 20 73 65 63 6f 6e 64 20 63 65 6c 6c 2c 20 61 e second cell, a
7130: 6e 64 20 73 6f 20 66 6f 72 74 68 29 20 72 65 74 nd so forth) ret
7140: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 0a 2a 2a urn a pointer.**
7150: 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e to the cell con
7160: 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 tent..**.** This
7170: 20 72 6f 75 74 69 6e 65 20 77 6f 72 6b 73 20 6f routine works o
7180: 6e 6c 79 20 66 6f 72 20 70 61 67 65 73 20 74 68 nly for pages th
7190: 61 74 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 at do not contai
71a0: 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 n overflow cells
71b0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66 69 6e ..*/.#define fin
71c0: 64 43 65 6c 6c 28 50 2c 49 29 20 5c 0a 20 20 28 dCell(P,I) \. (
71d0: 28 50 29 2d 3e 61 44 61 74 61 20 2b 20 28 28 50 (P)->aData + ((P
71e0: 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 20 67 65 )->maskPage & ge
71f0: 74 32 62 79 74 65 28 26 28 50 29 2d 3e 61 43 65 t2byte(&(P)->aCe
7200: 6c 6c 49 64 78 5b 32 2a 28 49 29 5d 29 29 29 0a llIdx[2*(I)]))).
7210: 23 64 65 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c #define findCell
7220: 76 32 28 44 2c 4d 2c 4f 2c 49 29 20 28 44 2b 28 v2(D,M,O,I) (D+(
7230: 4d 26 67 65 74 32 62 79 74 65 28 44 2b 28 4f 2b M&get2byte(D+(O+
7240: 32 2a 28 49 29 29 29 29 29 0a 0a 0a 2f 2a 0a 2a 2*(I))))).../*.*
7250: 2a 20 54 68 69 73 20 61 20 6d 6f 72 65 20 63 6f * This a more co
7260: 6d 70 6c 65 78 20 76 65 72 73 69 6f 6e 20 6f 66 mplex version of
7270: 20 66 69 6e 64 43 65 6c 6c 28 29 20 74 68 61 74 findCell() that
7280: 20 77 6f 72 6b 73 20 66 6f 72 0a 2a 2a 20 70 61 works for.** pa
7290: 67 65 73 20 74 68 61 74 20 64 6f 20 63 6f 6e 74 ges that do cont
72a0: 61 69 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c ain overflow cel
72b0: 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 38 ls..*/.static u8
72c0: 20 2a 66 69 6e 64 4f 76 65 72 66 6c 6f 77 43 65 *findOverflowCe
72d0: 6c 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ll(MemPage *pPag
72e0: 65 2c 20 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 e, int iCell){.
72f0: 20 69 6e 74 20 69 3b 0a 20 20 61 73 73 65 72 74 int i;. assert
7300: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
7310: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
7320: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72 >mutex) );. for
7330: 28 69 3d 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 (i=pPage->nOverf
7340: 6c 6f 77 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d low-1; i>=0; i--
7350: 29 7b 0a 20 20 20 20 69 6e 74 20 6b 3b 0a 20 20 ){. int k;.
7360: 20 20 6b 20 3d 20 70 50 61 67 65 2d 3e 61 69 4f k = pPage->aiO
7370: 76 66 6c 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 vfl[i];. if(
7380: 6b 3c 3d 69 43 65 6c 6c 20 29 7b 0a 20 20 20 20 k<=iCell ){.
7390: 20 20 69 66 28 20 6b 3d 3d 69 43 65 6c 6c 20 29 if( k==iCell )
73a0: 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e {. return
73b0: 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 69 pPage->apOvfl[i
73c0: 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 ];. }.
73d0: 20 69 43 65 6c 6c 2d 2d 3b 0a 20 20 20 20 7d 0a iCell--;. }.
73e0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 66 69 6e }. return fin
73f0: 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 dCell(pPage, iCe
7400: 6c 6c 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 ll);.}../*.** Pa
7410: 72 73 65 20 61 20 63 65 6c 6c 20 63 6f 6e 74 65 rse a cell conte
7420: 6e 74 20 62 6c 6f 63 6b 20 61 6e 64 20 66 69 6c nt block and fil
7430: 6c 20 69 6e 20 74 68 65 20 43 65 6c 6c 49 6e 66 l in the CellInf
7440: 6f 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 o structure. Th
7450: 65 72 65 0a 2a 2a 20 61 72 65 20 74 77 6f 20 76 ere.** are two v
7460: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 ersions of this
7470: 66 75 6e 63 74 69 6f 6e 2e 20 20 62 74 72 65 65 function. btree
7480: 50 61 72 73 65 43 65 6c 6c 28 29 20 74 61 6b 65 ParseCell() take
7490: 73 20 61 20 0a 2a 2a 20 63 65 6c 6c 20 69 6e 64 s a .** cell ind
74a0: 65 78 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ex as the second
74b0: 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 62 74 argument and bt
74c0: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 reeParseCellPtr(
74d0: 29 20 0a 2a 2a 20 74 61 6b 65 73 20 61 20 70 6f ) .** takes a po
74e0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 62 6f 64 inter to the bod
74f0: 79 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 61 73 y of the cell as
7500: 20 69 74 73 20 73 65 63 6f 6e 64 20 61 72 67 75 its second argu
7510: 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 ment..**.** With
7520: 69 6e 20 74 68 69 73 20 66 69 6c 65 2c 20 74 68 in this file, th
7530: 65 20 70 61 72 73 65 43 65 6c 6c 28 29 20 6d 61 e parseCell() ma
7540: 63 72 6f 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 cro can be calle
7550: 64 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20 d instead of.**
7560: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 btreeParseCellPt
7570: 72 28 29 2e 20 55 73 69 6e 67 20 73 6f 6d 65 20 r(). Using some
7580: 63 6f 6d 70 69 6c 65 72 73 2c 20 74 68 69 73 20 compilers, this
7590: 77 69 6c 6c 20 62 65 20 66 61 73 74 65 72 2e 0a will be faster..
75a0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 */.static void b
75b0: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
75c0: 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
75d0: 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 ge, /* P
75e0: 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 age containing t
75f0: 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 he cell */. u8
7600: 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 *pCell,
7610: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
7620: 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 to the cell text
7630: 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 . */. CellInfo
7640: 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f *pInfo /
7650: 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 * Fill in this s
7660: 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 tructure */.){.
7670: 20 75 31 36 20 6e 3b 20 20 20 20 20 20 20 20 20 u16 n;
7680: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
7690: 65 72 20 62 79 74 65 73 20 69 6e 20 63 65 6c 6c er bytes in cell
76a0: 20 63 6f 6e 74 65 6e 74 20 68 65 61 64 65 72 20 content header
76b0: 2a 2f 0a 20 20 75 33 32 20 6e 50 61 79 6c 6f 61 */. u32 nPayloa
76c0: 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 d; /*
76d0: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
76e0: 6f 66 20 63 65 6c 6c 20 70 61 79 6c 6f 61 64 20 of cell payload
76f0: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 */.. assert( sq
7700: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
7710: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
7720: 65 78 29 20 29 3b 0a 0a 20 20 70 49 6e 66 6f 2d ex) );.. pInfo-
7730: 3e 70 43 65 6c 6c 20 3d 20 70 43 65 6c 6c 3b 0a >pCell = pCell;.
7740: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
7750: 3e 6c 65 61 66 3d 3d 30 20 7c 7c 20 70 50 61 67 >leaf==0 || pPag
7760: 65 2d 3e 6c 65 61 66 3d 3d 31 20 29 3b 0a 20 20 e->leaf==1 );.
7770: 6e 20 3d 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 n = pPage->child
7780: 50 74 72 53 69 7a 65 3b 0a 20 20 61 73 73 65 72 PtrSize;. asser
7790: 74 28 20 6e 3d 3d 34 2d 34 2a 70 50 61 67 65 2d t( n==4-4*pPage-
77a0: 3e 6c 65 61 66 20 29 3b 0a 20 20 69 66 28 20 70 >leaf );. if( p
77b0: 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a Page->intKey ){.
77c0: 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 68 if( pPage->h
77d0: 61 73 44 61 74 61 20 29 7b 0a 20 20 20 20 20 20 asData ){.
77e0: 61 73 73 65 72 74 28 20 6e 3d 3d 30 20 29 3b 0a assert( n==0 );.
77f0: 20 20 20 20 20 20 6e 20 3d 20 67 65 74 56 61 72 n = getVar
7800: 69 6e 74 33 32 28 70 43 65 6c 6c 2c 20 6e 50 61 int32(pCell, nPa
7810: 79 6c 6f 61 64 29 3b 0a 20 20 20 20 7d 65 6c 73 yload);. }els
7820: 65 7b 0a 20 20 20 20 20 20 6e 50 61 79 6c 6f 61 e{. nPayloa
7830: 64 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 d = 0;. }.
7840: 20 6e 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 28 n += getVarint(
7850: 26 70 43 65 6c 6c 5b 6e 5d 2c 20 28 75 36 34 2a &pCell[n], (u64*
7860: 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a )&pInfo->nKey);.
7870: 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 44 61 74 61 pInfo->nData
7880: 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 7d = nPayload;. }
7890: 65 6c 73 65 7b 0a 20 20 20 20 70 49 6e 66 6f 2d else{. pInfo-
78a0: 3e 6e 44 61 74 61 20 3d 20 30 3b 0a 20 20 20 20 >nData = 0;.
78b0: 6e 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 32 n += getVarint32
78c0: 28 26 70 43 65 6c 6c 5b 6e 5d 2c 20 6e 50 61 79 (&pCell[n], nPay
78d0: 6c 6f 61 64 29 3b 0a 20 20 20 20 70 49 6e 66 6f load);. pInfo
78e0: 2d 3e 6e 4b 65 79 20 3d 20 6e 50 61 79 6c 6f 61 ->nKey = nPayloa
78f0: 64 3b 0a 20 20 7d 0a 20 20 70 49 6e 66 6f 2d 3e d;. }. pInfo->
7900: 6e 50 61 79 6c 6f 61 64 20 3d 20 6e 50 61 79 6c nPayload = nPayl
7910: 6f 61 64 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 48 oad;. pInfo->nH
7920: 65 61 64 65 72 20 3d 20 6e 3b 0a 20 20 74 65 73 eader = n;. tes
7930: 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 3d tcase( nPayload=
7940: 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
7950: 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 );. testcase(
7960: 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d nPayload==pPage-
7970: 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 >maxLocal+1 );.
7980: 20 69 66 28 20 6c 69 6b 65 6c 79 28 6e 50 61 79 if( likely(nPay
7990: 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 load<=pPage->max
79a0: 4c 6f 63 61 6c 29 20 29 7b 0a 20 20 20 20 2f 2a Local) ){. /*
79b0: 20 54 68 69 73 20 69 73 20 74 68 65 20 28 65 61 This is the (ea
79c0: 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 sy) common case
79d0: 77 68 65 72 65 20 74 68 65 20 65 6e 74 69 72 65 where the entire
79e0: 20 70 61 79 6c 6f 61 64 20 66 69 74 73 0a 20 20 payload fits.
79f0: 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 61 ** on the loca
7a00: 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f 76 65 72 l page. No over
7a10: 66 6c 6f 77 20 69 73 20 72 65 71 75 69 72 65 64 flow is required
7a20: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
7a30: 20 28 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d (pInfo->nSize =
7a40: 20 28 75 31 36 29 28 6e 2b 6e 50 61 79 6c 6f 61 (u16)(n+nPayloa
7a50: 64 29 29 3c 34 20 29 20 70 49 6e 66 6f 2d 3e 6e d))<4 ) pInfo->n
7a60: 53 69 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 49 Size = 4;. pI
7a70: 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 nfo->nLocal = (u
7a80: 31 36 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 16)nPayload;.
7a90: 20 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f pInfo->iOverflo
7aa0: 77 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a w = 0;. }else{.
7ab0: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 /* If the pa
7ac0: 79 6c 6f 61 64 20 77 69 6c 6c 20 6e 6f 74 20 66 yload will not f
7ad0: 69 74 20 63 6f 6d 70 6c 65 74 65 6c 79 20 6f 6e it completely on
7ae0: 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2c the local page,
7af0: 20 77 65 20 68 61 76 65 0a 20 20 20 20 2a 2a 20 we have. **
7b00: 74 6f 20 64 65 63 69 64 65 20 68 6f 77 20 6d 75 to decide how mu
7b10: 63 68 20 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 ch to store loca
7b20: 6c 6c 79 20 61 6e 64 20 68 6f 77 20 6d 75 63 68 lly and how much
7b30: 20 74 6f 20 73 70 69 6c 6c 20 6f 6e 74 6f 0a 20 to spill onto.
7b40: 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 ** overflow p
7b50: 61 67 65 73 2e 20 20 54 68 65 20 73 74 72 61 74 ages. The strat
7b60: 65 67 79 20 69 73 20 74 6f 20 6d 69 6e 69 6d 69 egy is to minimi
7b70: 7a 65 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 ze the amount of
7b80: 20 75 6e 75 73 65 64 0a 20 20 20 20 2a 2a 20 73 unused. ** s
7b90: 70 61 63 65 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 pace on overflow
7ba0: 20 70 61 67 65 73 20 77 68 69 6c 65 20 6b 65 65 pages while kee
7bb0: 70 69 6e 67 20 74 68 65 20 61 6d 6f 75 6e 74 20 ping the amount
7bc0: 6f 66 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 of local storage
7bd0: 0a 20 20 20 20 2a 2a 20 69 6e 20 62 65 74 77 65 . ** in betwe
7be0: 65 6e 20 6d 69 6e 4c 6f 63 61 6c 20 61 6e 64 20 en minLocal and
7bf0: 6d 61 78 4c 6f 63 61 6c 2e 0a 20 20 20 20 2a 2a maxLocal.. **
7c00: 0a 20 20 20 20 2a 2a 20 57 61 72 6e 69 6e 67 3a . ** Warning:
7c10: 20 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 77 changing the w
7c20: 61 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 79 6c ay overflow payl
7c30: 6f 61 64 20 69 73 20 64 69 73 74 72 69 62 75 74 oad is distribut
7c40: 65 64 20 69 6e 20 61 6e 79 0a 20 20 20 20 2a 2a ed in any. **
7c50: 20 77 61 79 20 77 69 6c 6c 20 72 65 73 75 6c 74 way will result
7c60: 20 69 6e 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 in an incompati
7c70: 62 6c 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e ble file format.
7c80: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 . */. int
7c90: 6d 69 6e 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d 69 minLocal; /* Mi
7ca0: 6e 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 nimum amount of
7cb0: 70 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f 63 payload held loc
7cc0: 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ally */. int
7cd0: 6d 61 78 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d 61 maxLocal; /* Ma
7ce0: 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 ximum amount of
7cf0: 70 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f 63 payload held loc
7d00: 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ally */. int
7d10: 73 75 72 70 6c 75 73 3b 20 20 20 2f 2a 20 4f 76 surplus; /* Ov
7d20: 65 72 66 6c 6f 77 20 70 61 79 6c 6f 61 64 20 61 erflow payload a
7d30: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 6c 6f 63 vailable for loc
7d40: 61 6c 20 73 74 6f 72 61 67 65 20 2a 2f 0a 0a 20 al storage */..
7d50: 20 20 20 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 minLocal = pP
7d60: 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 age->minLocal;.
7d70: 20 20 20 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 50 maxLocal = pP
7d80: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 age->maxLocal;.
7d90: 20 20 20 73 75 72 70 6c 75 73 20 3d 20 6d 69 6e surplus = min
7da0: 4c 6f 63 61 6c 20 2b 20 28 6e 50 61 79 6c 6f 61 Local + (nPayloa
7db0: 64 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 25 28 70 d - minLocal)%(p
7dc0: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
7dd0: 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 eSize - 4);.
7de0: 74 65 73 74 63 61 73 65 28 20 73 75 72 70 6c 75 testcase( surplu
7df0: 73 3d 3d 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 s==maxLocal );.
7e00: 20 20 20 74 65 73 74 63 61 73 65 28 20 73 75 72 testcase( sur
7e10: 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 2b 31 plus==maxLocal+1
7e20: 20 29 3b 0a 20 20 20 20 69 66 28 20 73 75 72 70 );. if( surp
7e30: 6c 75 73 20 3c 3d 20 6d 61 78 4c 6f 63 61 6c 20 lus <= maxLocal
7e40: 29 7b 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d 3e ){. pInfo->
7e50: 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 73 75 nLocal = (u16)su
7e60: 72 70 6c 75 73 3b 0a 20 20 20 20 7d 65 6c 73 65 rplus;. }else
7e70: 7b 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d 3e 6e {. pInfo->n
7e80: 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 6d 69 6e Local = (u16)min
7e90: 4c 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 Local;. }.
7ea0: 20 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f pInfo->iOverflo
7eb0: 77 20 3d 20 28 75 31 36 29 28 70 49 6e 66 6f 2d w = (u16)(pInfo-
7ec0: 3e 6e 4c 6f 63 61 6c 20 2b 20 6e 29 3b 0a 20 20 >nLocal + n);.
7ed0: 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d pInfo->nSize =
7ee0: 20 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f pInfo->iOverflo
7ef0: 77 20 2b 20 34 3b 0a 20 20 7d 0a 7d 0a 23 64 65 w + 4;. }.}.#de
7f00: 66 69 6e 65 20 70 61 72 73 65 43 65 6c 6c 28 70 fine parseCell(p
7f10: 50 61 67 65 2c 20 69 43 65 6c 6c 2c 20 70 49 6e Page, iCell, pIn
7f20: 66 6f 29 20 5c 0a 20 20 62 74 72 65 65 50 61 72 fo) \. btreePar
7f30: 73 65 43 65 6c 6c 50 74 72 28 28 70 50 61 67 65 seCellPtr((pPage
7f40: 29 2c 20 66 69 6e 64 43 65 6c 6c 28 28 70 50 61 ), findCell((pPa
7f50: 67 65 29 2c 20 28 69 43 65 6c 6c 29 29 2c 20 28 ge), (iCell)), (
7f60: 70 49 6e 66 6f 29 29 0a 73 74 61 74 69 63 20 76 pInfo)).static v
7f70: 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 65 oid btreeParseCe
7f80: 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 ll(. MemPage *p
7f90: 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a Page, /*
7fa0: 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 Page containing
7fb0: 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 the cell */. i
7fc0: 6e 74 20 69 43 65 6c 6c 2c 20 20 20 20 20 20 20 nt iCell,
7fd0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 65 /* The ce
7fe0: 6c 6c 20 69 6e 64 65 78 2e 20 20 46 69 72 73 74 ll index. First
7ff0: 20 63 65 6c 6c 20 69 73 20 30 20 2a 2f 0a 20 20 cell is 0 */.
8000: 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 CellInfo *pInfo
8010: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 /* Fill
8020: 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 72 in this structur
8030: 65 20 2a 2f 0a 29 7b 0a 20 20 70 61 72 73 65 43 e */.){. parseC
8040: 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 6c 6c ell(pPage, iCell
8050: 2c 20 70 49 6e 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a , pInfo);.}../*.
8060: 2a 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 74 ** Compute the t
8070: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 otal number of b
8080: 79 74 65 73 20 74 68 61 74 20 61 20 43 65 6c 6c ytes that a Cell
8090: 20 6e 65 65 64 73 20 69 6e 20 74 68 65 20 63 65 needs in the ce
80a0: 6c 6c 0a 2a 2a 20 64 61 74 61 20 61 72 65 61 20 ll.** data area
80b0: 6f 66 20 74 68 65 20 62 74 72 65 65 2d 70 61 67 of the btree-pag
80c0: 65 2e 20 20 54 68 65 20 72 65 74 75 72 6e 20 6e e. The return n
80d0: 75 6d 62 65 72 20 69 6e 63 6c 75 64 65 73 20 74 umber includes t
80e0: 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 74 61 20 he cell.** data
80f0: 68 65 61 64 65 72 20 61 6e 64 20 74 68 65 20 6c header and the l
8100: 6f 63 61 6c 20 70 61 79 6c 6f 61 64 2c 20 62 75 ocal payload, bu
8110: 74 20 6e 6f 74 20 61 6e 79 20 6f 76 65 72 66 6c t not any overfl
8120: 6f 77 20 70 61 67 65 20 6f 72 0a 2a 2a 20 74 68 ow page or.** th
8130: 65 20 73 70 61 63 65 20 75 73 65 64 20 62 79 20 e space used by
8140: 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 the cell pointer
8150: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 ..*/.static u16
8160: 63 65 6c 6c 53 69 7a 65 50 74 72 28 4d 65 6d 50 cellSizePtr(MemP
8170: 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 20 2a age *pPage, u8 *
8180: 70 43 65 6c 6c 29 7b 0a 20 20 75 38 20 2a 70 49 pCell){. u8 *pI
8190: 74 65 72 20 3d 20 26 70 43 65 6c 6c 5b 70 50 61 ter = &pCell[pPa
81a0: 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 ge->childPtrSize
81b0: 5d 3b 0a 20 20 75 33 32 20 6e 53 69 7a 65 3b 0a ];. u32 nSize;.
81c0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
81d0: 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 61 EBUG. /* The va
81e0: 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 lue returned by
81f0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 this function sh
8200: 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 74 ould always be t
8210: 68 65 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a 20 he same as. **
8220: 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e 53 the (CellInfo.nS
8230: 69 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 6e 64 ize) value found
8240: 20 62 79 20 64 6f 69 6e 67 20 61 20 66 75 6c 6c by doing a full
8250: 20 70 61 72 73 65 20 6f 66 20 74 68 65 0a 20 20 parse of the.
8260: 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c 49 ** cell. If SQLI
8270: 54 45 5f 44 45 42 55 47 20 69 73 20 64 65 66 69 TE_DEBUG is defi
8280: 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 29 ned, an assert()
8290: 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f at the bottom o
82a0: 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 f. ** this func
82b0: 74 69 6f 6e 20 76 65 72 69 66 69 65 73 20 74 68 tion verifies th
82c0: 61 74 20 74 68 69 73 20 69 6e 76 61 72 69 61 6e at this invarian
82d0: 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 65 t is not violate
82e0: 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f d. */. CellInfo
82f0: 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 62 74 debuginfo;. bt
8300: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 reeParseCellPtr(
8310: 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 64 pPage, pCell, &d
8320: 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6e 64 69 ebuginfo);.#endi
8330: 66 0a 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e f.. if( pPage->
8340: 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 75 38 intKey ){. u8
8350: 20 2a 70 45 6e 64 3b 0a 20 20 20 20 69 66 28 20 *pEnd;. if(
8360: 70 50 61 67 65 2d 3e 68 61 73 44 61 74 61 20 29 pPage->hasData )
8370: 7b 0a 20 20 20 20 20 20 70 49 74 65 72 20 2b 3d {. pIter +=
8380: 20 67 65 74 56 61 72 69 6e 74 33 32 28 70 49 74 getVarint32(pIt
8390: 65 72 2c 20 6e 53 69 7a 65 29 3b 0a 20 20 20 20 er, nSize);.
83a0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6e 53 69 }else{. nSi
83b0: 7a 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 ze = 0;. }..
83c0: 20 20 20 2f 2a 20 70 49 74 65 72 20 6e 6f 77 20 /* pIter now
83d0: 70 6f 69 6e 74 73 20 61 74 20 74 68 65 20 36 34 points at the 64
83e0: 2d 62 69 74 20 69 6e 74 65 67 65 72 20 6b 65 79 -bit integer key
83f0: 20 76 61 6c 75 65 2c 20 61 20 76 61 72 69 61 62 value, a variab
8400: 6c 65 20 6c 65 6e 67 74 68 20 0a 20 20 20 20 2a le length . *
8410: 2a 20 69 6e 74 65 67 65 72 2e 20 54 68 65 20 66 * integer. The f
8420: 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6d ollowing block m
8430: 6f 76 65 73 20 70 49 74 65 72 20 74 6f 20 70 6f oves pIter to po
8440: 69 6e 74 20 61 74 20 74 68 65 20 66 69 72 73 74 int at the first
8450: 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 70 61 73 byte. ** pas
8460: 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
8470: 20 6b 65 79 20 76 61 6c 75 65 2e 20 2a 2f 0a 20 key value. */.
8480: 20 20 20 70 45 6e 64 20 3d 20 26 70 49 74 65 72 pEnd = &pIter
8490: 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 [9];. while(
84a0: 28 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 30 20 (*pIter++)&0x80
84b0: 26 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b && pIter<pEnd );
84c0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 . }else{. pI
84d0: 74 65 72 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 ter += getVarint
84e0: 33 32 28 70 49 74 65 72 2c 20 6e 53 69 7a 65 29 32(pIter, nSize)
84f0: 3b 0a 20 20 7d 0a 0a 20 20 74 65 73 74 63 61 73 ;. }.. testcas
8500: 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d e( nSize==pPage-
8510: 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 >maxLocal );. t
8520: 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d estcase( nSize==
8530: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b pPage->maxLocal+
8540: 31 20 29 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 1 );. if( nSize
8550: 3e 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c >pPage->maxLocal
8560: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6d 69 6e 4c ){. int minL
8570: 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 69 ocal = pPage->mi
8580: 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 6e 53 69 7a nLocal;. nSiz
8590: 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 e = minLocal + (
85a0: 6e 53 69 7a 65 20 2d 20 6d 69 6e 4c 6f 63 61 6c nSize - minLocal
85b0: 29 20 25 20 28 70 50 61 67 65 2d 3e 70 42 74 2d ) % (pPage->pBt-
85c0: 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 29 >usableSize - 4)
85d0: 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
85e0: 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 nSize==pPage->ma
85f0: 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 20 20 74 65 xLocal );. te
8600: 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 stcase( nSize==p
8610: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 Page->maxLocal+1
8620: 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 53 69 7a );. if( nSiz
8630: 65 3e 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 e>pPage->maxLoca
8640: 6c 20 29 7b 0a 20 20 20 20 20 20 6e 53 69 7a 65 l ){. nSize
8650: 20 3d 20 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 = minLocal;.
8660: 20 7d 0a 20 20 20 20 6e 53 69 7a 65 20 2b 3d 20 }. nSize +=
8670: 34 3b 0a 20 20 7d 0a 20 20 6e 53 69 7a 65 20 2b 4;. }. nSize +
8680: 3d 20 28 75 33 32 29 28 70 49 74 65 72 20 2d 20 = (u32)(pIter -
8690: 70 43 65 6c 6c 29 3b 0a 0a 20 20 2f 2a 20 54 68 pCell);.. /* Th
86a0: 65 20 6d 69 6e 69 6d 75 6d 20 73 69 7a 65 20 6f e minimum size o
86b0: 66 20 61 6e 79 20 63 65 6c 6c 20 69 73 20 34 20 f any cell is 4
86c0: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 69 66 28 20 bytes. */. if(
86d0: 6e 53 69 7a 65 3c 34 20 29 7b 0a 20 20 20 20 6e nSize<4 ){. n
86e0: 53 69 7a 65 20 3d 20 34 3b 0a 20 20 7d 0a 0a 20 Size = 4;. }..
86f0: 20 61 73 73 65 72 74 28 20 6e 53 69 7a 65 3d 3d assert( nSize==
8700: 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 7a 65 20 debuginfo.nSize
8710: 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 75 31 36 );. return (u16
8720: 29 6e 53 69 7a 65 3b 0a 7d 0a 0a 23 69 66 64 65 )nSize;.}..#ifde
8730: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f f SQLITE_DEBUG./
8740: 2a 20 54 68 69 73 20 76 61 72 69 61 74 69 6f 6e * This variation
8750: 20 6f 6e 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 on cellSizePtr(
8760: 29 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 ) is used inside
8770: 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 61 of assert() sta
8780: 74 65 6d 65 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 2e tements.** only.
8790: 20 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 63 */.static u16 c
87a0: 65 6c 6c 53 69 7a 65 28 4d 65 6d 50 61 67 65 20 ellSize(MemPage
87b0: 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 43 65 6c *pPage, int iCel
87c0: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 65 6c l){. return cel
87d0: 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 lSizePtr(pPage,
87e0: 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
87f0: 69 43 65 6c 6c 29 29 3b 0a 7d 0a 23 65 6e 64 69 iCell));.}.#endi
8800: 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 f..#ifndef SQLIT
8810: 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
8820: 4d 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 M./*.** If the c
8830: 65 6c 6c 20 70 43 65 6c 6c 2c 20 70 61 72 74 20 ell pCell, part
8840: 6f 66 20 70 61 67 65 20 70 50 61 67 65 20 63 6f of page pPage co
8850: 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 ntains a pointer
8860: 0a 2a 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c .** to an overfl
8870: 6f 77 20 70 61 67 65 2c 20 69 6e 73 65 72 74 20 ow page, insert
8880: 61 6e 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 68 an entry into th
8890: 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 2a 2a e pointer-map.**
88a0: 20 66 6f 72 20 74 68 65 20 6f 76 65 72 66 6c 6f for the overflo
88b0: 77 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 w page..*/.stati
88c0: 63 20 76 6f 69 64 20 70 74 72 6d 61 70 50 75 74 c void ptrmapPut
88d0: 4f 76 66 6c 50 74 72 28 4d 65 6d 50 61 67 65 20 OvflPtr(MemPage
88e0: 2a 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 6c *pPage, u8 *pCel
88f0: 6c 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 l, int *pRC){.
8900: 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 CellInfo info;.
8910: 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 74 75 if( *pRC ) retu
8920: 72 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 rn;. assert( pC
8930: 65 6c 6c 21 3d 30 20 29 3b 0a 20 20 62 74 72 65 ell!=0 );. btre
8940: 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 eParseCellPtr(pP
8950: 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 age, pCell, &inf
8960: 6f 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 69 o);. assert( (i
8970: 6e 66 6f 2e 6e 44 61 74 61 2b 28 70 50 61 67 65 nfo.nData+(pPage
8980: 2d 3e 69 6e 74 4b 65 79 3f 30 3a 69 6e 66 6f 2e ->intKey?0:info.
8990: 6e 4b 65 79 29 29 3d 3d 69 6e 66 6f 2e 6e 50 61 nKey))==info.nPa
89a0: 79 6c 6f 61 64 20 29 3b 0a 20 20 69 66 28 20 69 yload );. if( i
89b0: 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 20 29 7b nfo.iOverflow ){
89c0: 0a 20 20 20 20 50 67 6e 6f 20 6f 76 66 6c 20 3d . Pgno ovfl =
89d0: 20 67 65 74 34 62 79 74 65 28 26 70 43 65 6c 6c get4byte(&pCell
89e0: 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d [info.iOverflow]
89f0: 29 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 );. ptrmapPut
8a00: 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 6f 76 66 (pPage->pBt, ovf
8a10: 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c l, PTRMAP_OVERFL
8a20: 4f 57 31 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f OW1, pPage->pgno
8a30: 2c 20 70 52 43 29 3b 0a 20 20 7d 0a 7d 0a 23 65 , pRC);. }.}.#e
8a40: 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 ndif.../*.** Def
8a50: 72 61 67 6d 65 6e 74 20 74 68 65 20 70 61 67 65 ragment the page
8a60: 20 67 69 76 65 6e 2e 20 20 41 6c 6c 20 43 65 6c given. All Cel
8a70: 6c 73 20 61 72 65 20 6d 6f 76 65 64 20 74 6f 20 ls are moved to
8a80: 74 68 65 0a 2a 2a 20 65 6e 64 20 6f 66 20 74 68 the.** end of th
8a90: 65 20 70 61 67 65 20 61 6e 64 20 61 6c 6c 20 66 e page and all f
8aa0: 72 65 65 20 73 70 61 63 65 20 69 73 20 63 6f 6c ree space is col
8ab0: 6c 65 63 74 65 64 20 69 6e 74 6f 20 6f 6e 65 0a lected into one.
8ac0: 2a 2a 20 62 69 67 20 46 72 65 65 42 6c 6b 20 74 ** big FreeBlk t
8ad0: 68 61 74 20 6f 63 63 75 72 73 20 69 6e 20 62 65 hat occurs in be
8ae0: 74 77 65 65 6e 20 74 68 65 20 68 65 61 64 65 72 tween the header
8af0: 20 61 6e 64 20 63 65 6c 6c 0a 2a 2a 20 70 6f 69 and cell.** poi
8b00: 6e 74 65 72 20 61 72 72 61 79 20 61 6e 64 20 74 nter array and t
8b10: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
8b20: 61 72 65 61 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 area..*/.static
8b30: 69 6e 74 20 64 65 66 72 61 67 6d 65 6e 74 50 61 int defragmentPa
8b40: 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ge(MemPage *pPag
8b50: 65 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 e){. int i;
8b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b70: 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 /* Loop counter
8b80: 20 2a 2f 0a 20 20 69 6e 74 20 70 63 3b 20 20 20 */. int pc;
8b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8ba0: 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 61 /* Address of a
8bb0: 20 69 2d 74 68 20 63 65 6c 6c 20 2a 2f 0a 20 20 i-th cell */.
8bc0: 69 6e 74 20 68 64 72 3b 20 20 20 20 20 20 20 20 int hdr;
8bd0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 /* Of
8be0: 66 73 65 74 20 74 6f 20 74 68 65 20 70 61 67 65 fset to the page
8bf0: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74 header */. int
8c00: 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 size;
8c10: 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
8c20: 6f 66 20 61 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 of a cell */. i
8c30: 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b 20 20 nt usableSize;
8c40: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
8c50: 62 65 72 20 6f 66 20 75 73 61 62 6c 65 20 62 79 ber of usable by
8c60: 74 65 73 20 6f 6e 20 61 20 70 61 67 65 20 2a 2f tes on a page */
8c70: 0a 20 20 69 6e 74 20 63 65 6c 6c 4f 66 66 73 65 . int cellOffse
8c80: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t; /*
8c90: 20 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 Offset to the c
8ca0: 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 ell pointer arra
8cb0: 79 20 2a 2f 0a 20 20 69 6e 74 20 63 62 72 6b 3b y */. int cbrk;
8cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8cd0: 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 /* Offset to t
8ce0: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
8cf0: 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 area */. int nC
8d00: 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
8d10: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
8d20: 66 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 f cells on the p
8d30: 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 age */. unsigne
8d40: 64 20 63 68 61 72 20 2a 64 61 74 61 3b 20 20 20 d char *data;
8d50: 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 /* The page
8d60: 64 61 74 61 20 2a 2f 0a 20 20 75 6e 73 69 67 6e data */. unsign
8d70: 65 64 20 63 68 61 72 20 2a 74 65 6d 70 3b 20 20 ed char *temp;
8d80: 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 61 72 65 /* Temp are
8d90: 61 20 66 6f 72 20 63 65 6c 6c 20 63 6f 6e 74 65 a for cell conte
8da0: 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c nt */. int iCel
8db0: 6c 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20 lFirst;
8dc0: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f /* First allo
8dd0: 77 61 62 6c 65 20 63 65 6c 6c 20 69 6e 64 65 78 wable cell index
8de0: 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c 4c */. int iCellL
8df0: 61 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ast;
8e00: 20 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 6c /* Last possibl
8e10: 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a e cell index */.
8e20: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
8e30: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
8e40: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
8e50: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
8e60: 20 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 pPage->pBt!=0 )
8e70: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
8e80: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
8e90: 7a 65 20 3c 3d 20 53 51 4c 49 54 45 5f 4d 41 58 ze <= SQLITE_MAX
8ea0: 5f 50 41 47 45 5f 53 49 5a 45 20 29 3b 0a 20 20 _PAGE_SIZE );.
8eb0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e assert( pPage->n
8ec0: 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 Overflow==0 );.
8ed0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
8ee0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
8ef0: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
8f00: 3b 0a 20 20 74 65 6d 70 20 3d 20 73 71 6c 69 74 ;. temp = sqlit
8f10: 65 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 e3PagerTempSpace
8f20: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 50 61 (pPage->pBt->pPa
8f30: 67 65 72 29 3b 0a 20 20 64 61 74 61 20 3d 20 70 ger);. data = p
8f40: 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 20 68 Page->aData;. h
8f50: 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f dr = pPage->hdrO
8f60: 66 66 73 65 74 3b 0a 20 20 63 65 6c 6c 4f 66 66 ffset;. cellOff
8f70: 73 65 74 20 3d 20 70 50 61 67 65 2d 3e 63 65 6c set = pPage->cel
8f80: 6c 4f 66 66 73 65 74 3b 0a 20 20 6e 43 65 6c 6c lOffset;. nCell
8f90: 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b = pPage->nCell;
8fa0: 0a 20 20 61 73 73 65 72 74 28 20 6e 43 65 6c 6c . assert( nCell
8fb0: 3d 3d 67 65 74 32 62 79 74 65 28 26 64 61 74 61 ==get2byte(&data
8fc0: 5b 68 64 72 2b 33 5d 29 20 29 3b 0a 20 20 75 73 [hdr+3]) );. us
8fd0: 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 61 67 65 ableSize = pPage
8fe0: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
8ff0: 65 3b 0a 20 20 63 62 72 6b 20 3d 20 67 65 74 32 e;. cbrk = get2
9000: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
9010: 5d 29 3b 0a 20 20 6d 65 6d 63 70 79 28 26 74 65 ]);. memcpy(&te
9020: 6d 70 5b 63 62 72 6b 5d 2c 20 26 64 61 74 61 5b mp[cbrk], &data[
9030: 63 62 72 6b 5d 2c 20 75 73 61 62 6c 65 53 69 7a cbrk], usableSiz
9040: 65 20 2d 20 63 62 72 6b 29 3b 0a 20 20 63 62 72 e - cbrk);. cbr
9050: 6b 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a k = usableSize;.
9060: 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d 20 63 iCellFirst = c
9070: 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 6e 43 ellOffset + 2*nC
9080: 65 6c 6c 3b 0a 20 20 69 43 65 6c 6c 4c 61 73 74 ell;. iCellLast
9090: 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 = usableSize -
90a0: 34 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 4;. for(i=0; i<
90b0: 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 nCell; i++){.
90c0: 20 75 38 20 2a 70 41 64 64 72 3b 20 20 20 20 20 u8 *pAddr;
90d0: 2f 2a 20 54 68 65 20 69 2d 74 68 20 63 65 6c 6c /* The i-th cell
90e0: 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 20 pointer */.
90f0: 70 41 64 64 72 20 3d 20 26 64 61 74 61 5b 63 65 pAddr = &data[ce
9100: 6c 6c 4f 66 66 73 65 74 20 2b 20 69 2a 32 5d 3b llOffset + i*2];
9110: 0a 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 79 . pc = get2by
9120: 74 65 28 70 41 64 64 72 29 3b 0a 20 20 20 20 74 te(pAddr);. t
9130: 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 estcase( pc==iCe
9140: 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 20 20 74 llFirst );. t
9150: 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 estcase( pc==iCe
9160: 6c 6c 4c 61 73 74 20 29 3b 0a 23 69 66 20 21 64 llLast );.#if !d
9170: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e efined(SQLITE_EN
9180: 41 42 4c 45 5f 4f 56 45 52 53 49 5a 45 5f 43 45 ABLE_OVERSIZE_CE
9190: 4c 4c 5f 43 48 45 43 4b 29 0a 20 20 20 20 2f 2a LL_CHECK). /*
91a0: 20 54 68 65 73 65 20 63 6f 6e 64 69 74 69 6f 6e These condition
91b0: 73 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 s have already b
91c0: 65 65 6e 20 76 65 72 69 66 69 65 64 20 69 6e 20 een verified in
91d0: 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 0a btreeInitPage().
91e0: 20 20 20 20 2a 2a 20 69 66 20 53 51 4c 49 54 45 ** if SQLITE
91f0: 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 5a 45 _ENABLE_OVERSIZE
9200: 5f 43 45 4c 4c 5f 43 48 45 43 4b 20 69 73 20 64 _CELL_CHECK is d
9210: 65 66 69 6e 65 64 20 0a 20 20 20 20 2a 2f 0a 20 efined . */.
9220: 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 if( pc<iCellF
9230: 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c irst || pc>iCell
9240: 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 72 65 Last ){. re
9250: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
9260: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a UPT_BKPT;. }.
9270: 23 65 6e 64 69 66 0a 20 20 20 20 61 73 73 65 72 #endif. asser
9280: 74 28 20 70 63 3e 3d 69 43 65 6c 6c 46 69 72 73 t( pc>=iCellFirs
9290: 74 20 26 26 20 70 63 3c 3d 69 43 65 6c 6c 4c 61 t && pc<=iCellLa
92a0: 73 74 20 29 3b 0a 20 20 20 20 73 69 7a 65 20 3d st );. size =
92b0: 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 cellSizePtr(pPa
92c0: 67 65 2c 20 26 74 65 6d 70 5b 70 63 5d 29 3b 0a ge, &temp[pc]);.
92d0: 20 20 20 20 63 62 72 6b 20 2d 3d 20 73 69 7a 65 cbrk -= size
92e0: 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 ;.#if defined(SQ
92f0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 LITE_ENABLE_OVER
9300: 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 SIZE_CELL_CHECK)
9310: 0a 20 20 20 20 69 66 28 20 63 62 72 6b 3c 69 43 . if( cbrk<iC
9320: 65 6c 6c 46 69 72 73 74 20 29 7b 0a 20 20 20 20 ellFirst ){.
9330: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
9340: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
9350: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 69 66 }.#else. if
9360: 28 20 63 62 72 6b 3c 69 43 65 6c 6c 46 69 72 73 ( cbrk<iCellFirs
9370: 74 20 7c 7c 20 70 63 2b 73 69 7a 65 3e 75 73 61 t || pc+size>usa
9380: 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 bleSize ){.
9390: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
93a0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
93b0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 61 73 }.#endif. as
93c0: 73 65 72 74 28 20 63 62 72 6b 2b 73 69 7a 65 3c sert( cbrk+size<
93d0: 3d 75 73 61 62 6c 65 53 69 7a 65 20 26 26 20 63 =usableSize && c
93e0: 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 brk>=iCellFirst
93f0: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
9400: 20 63 62 72 6b 2b 73 69 7a 65 3d 3d 75 73 61 62 cbrk+size==usab
9410: 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 74 65 leSize );. te
9420: 73 74 63 61 73 65 28 20 70 63 2b 73 69 7a 65 3d stcase( pc+size=
9430: 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 =usableSize );.
9440: 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b memcpy(&data[
9450: 63 62 72 6b 5d 2c 20 26 74 65 6d 70 5b 70 63 5d cbrk], &temp[pc]
9460: 2c 20 73 69 7a 65 29 3b 0a 20 20 20 20 70 75 74 , size);. put
9470: 32 62 79 74 65 28 70 41 64 64 72 2c 20 63 62 72 2byte(pAddr, cbr
9480: 6b 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 k);. }. assert
9490: 28 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 72 ( cbrk>=iCellFir
94a0: 73 74 20 29 3b 0a 20 20 70 75 74 32 62 79 74 65 st );. put2byte
94b0: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 63 (&data[hdr+5], c
94c0: 62 72 6b 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 brk);. data[hdr
94d0: 2b 31 5d 20 3d 20 30 3b 0a 20 20 64 61 74 61 5b +1] = 0;. data[
94e0: 68 64 72 2b 32 5d 20 3d 20 30 3b 0a 20 20 64 61 hdr+2] = 0;. da
94f0: 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b 0a 20 ta[hdr+7] = 0;.
9500: 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 69 43 memset(&data[iC
9510: 65 6c 6c 46 69 72 73 74 5d 2c 20 30 2c 20 63 62 ellFirst], 0, cb
9520: 72 6b 2d 69 43 65 6c 6c 46 69 72 73 74 29 3b 0a rk-iCellFirst);.
9530: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
9540: 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
9550: 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
9560: 29 20 29 3b 0a 20 20 69 66 28 20 63 62 72 6b 2d ) );. if( cbrk-
9570: 69 43 65 6c 6c 46 69 72 73 74 21 3d 70 50 61 67 iCellFirst!=pPag
9580: 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 20 e->nFree ){.
9590: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
95a0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a RRUPT_BKPT;. }.
95b0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
95c0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c OK;.}../*.** All
95d0: 6f 63 61 74 65 20 6e 42 79 74 65 20 62 79 74 65 ocate nByte byte
95e0: 73 20 6f 66 20 73 70 61 63 65 20 66 72 6f 6d 20 s of space from
95f0: 77 69 74 68 69 6e 20 74 68 65 20 42 2d 54 72 65 within the B-Tre
9600: 65 20 70 61 67 65 20 70 61 73 73 65 64 0a 2a 2a e page passed.**
9610: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72 as the first ar
9620: 67 75 6d 65 6e 74 2e 20 57 72 69 74 65 20 69 6e gument. Write in
9630: 74 6f 20 2a 70 49 64 78 20 74 68 65 20 69 6e 64 to *pIdx the ind
9640: 65 78 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e 61 ex into pPage->a
9650: 44 61 74 61 5b 5d 0a 2a 2a 20 6f 66 20 74 68 65 Data[].** of the
9660: 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 61 first byte of a
9670: 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 2e 20 llocated space.
9680: 52 65 74 75 72 6e 20 65 69 74 68 65 72 20 53 51 Return either SQ
9690: 4c 49 54 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 61 6e LITE_OK or.** an
96a0: 20 65 72 72 6f 72 20 63 6f 64 65 20 28 75 73 75 error code (usu
96b0: 61 6c 6c 79 20 53 51 4c 49 54 45 5f 43 4f 52 52 ally SQLITE_CORR
96c0: 55 50 54 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 UPT)..**.** The
96d0: 63 61 6c 6c 65 72 20 67 75 61 72 61 6e 74 65 65 caller guarantee
96e0: 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 s that there is
96f0: 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 sufficient space
9700: 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a 2a 20 to make the.**
9710: 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 54 68 69 allocation. Thi
9720: 73 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 74 20 s routine might
9730: 6e 65 65 64 20 74 6f 20 64 65 66 72 61 67 6d 65 need to defragme
9740: 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 nt in order to b
9750: 72 69 6e 67 0a 2a 2a 20 61 6c 6c 20 74 68 65 20 ring.** all the
9760: 73 70 61 63 65 20 74 6f 67 65 74 68 65 72 2c 20 space together,
9770: 68 6f 77 65 76 65 72 2e 20 20 54 68 69 73 20 72 however. This r
9780: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 76 6f 69 outine will avoi
9790: 64 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 66 d using.** the f
97a0: 69 72 73 74 20 74 77 6f 20 62 79 74 65 73 20 70 irst two bytes p
97b0: 61 73 74 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 ast the cell poi
97c0: 6e 74 65 72 20 61 72 65 61 20 73 69 6e 63 65 20 nter area since
97d0: 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69 73 0a presumably this.
97e0: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 ** allocation is
97f0: 20 62 65 69 6e 67 20 6d 61 64 65 20 69 6e 20 6f being made in o
9800: 72 64 65 72 20 74 6f 20 69 6e 73 65 72 74 20 61 rder to insert a
9810: 20 6e 65 77 20 63 65 6c 6c 2c 20 73 6f 20 77 65 new cell, so we
9820: 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 65 6e will.** also en
9830: 64 20 75 70 20 6e 65 65 64 69 6e 67 20 61 20 6e d up needing a n
9840: 65 77 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 2e ew cell pointer.
9850: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
9860: 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 4d 65 6d llocateSpace(Mem
9870: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
9880: 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 49 64 nByte, int *pId
9890: 78 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 x){. const int
98a0: 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 hdr = pPage->hdr
98b0: 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4c 6f Offset; /* Lo
98c0: 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 50 61 cal cache of pPa
98d0: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 2a 2f ge->hdrOffset */
98e0: 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 64 61 . u8 * const da
98f0: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
9900: 61 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 6c a; /* Local
9910: 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 65 2d cache of pPage-
9920: 3e 61 44 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 >aData */. int
9930: 6e 46 72 61 67 3b 20 20 20 20 20 20 20 20 20 20 nFrag;
9940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9950: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 66 72 /* Number of fr
9960: 61 67 6d 65 6e 74 65 64 20 62 79 74 65 73 20 6f agmented bytes o
9970: 6e 20 70 50 61 67 65 20 2a 2f 0a 20 20 69 6e 74 n pPage */. int
9980: 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 top;
9990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
99a0: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
99b0: 6f 66 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 of cell content
99c0: 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 67 61 area */. int ga
99d0: 70 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 p; /* Fir
99e0: 73 74 20 62 79 74 65 20 6f 66 20 67 61 70 20 62 st byte of gap b
99f0: 65 74 77 65 65 6e 20 63 65 6c 6c 20 70 6f 69 6e etween cell poin
9a00: 74 65 72 73 20 61 6e 64 20 63 65 6c 6c 20 63 6f ters and cell co
9a10: 6e 74 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 72 ntent */. int r
9a20: 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e c; /* In
9a30: 74 65 67 65 72 20 72 65 74 75 72 6e 20 63 6f 64 teger return cod
9a40: 65 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 62 6c e */. int usabl
9a50: 65 53 69 7a 65 3b 20 2f 2a 20 55 73 61 62 6c 65 eSize; /* Usable
9a60: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 size of the pag
9a70: 65 20 2a 2f 0a 20 20 0a 20 20 61 73 73 65 72 74 e */. . assert
9a80: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
9a90: 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
9aa0: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
9ab0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 ssert( pPage->pB
9ac0: 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 t );. assert( s
9ad0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
9ae0: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
9af0: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
9b00: 28 20 6e 42 79 74 65 3e 3d 30 20 29 3b 20 20 2f ( nByte>=0 ); /
9b10: 2a 20 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 73 * Minimum cell s
9b20: 69 7a 65 20 69 73 20 34 20 2a 2f 0a 20 20 61 73 ize is 4 */. as
9b30: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 46 72 sert( pPage->nFr
9b40: 65 65 3e 3d 6e 42 79 74 65 20 29 3b 0a 20 20 61 ee>=nByte );. a
9b50: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f ssert( pPage->nO
9b60: 76 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 verflow==0 );.
9b70: 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 61 usableSize = pPa
9b80: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
9b90: 69 7a 65 3b 0a 20 20 61 73 73 65 72 74 28 20 6e ize;. assert( n
9ba0: 42 79 74 65 20 3c 20 75 73 61 62 6c 65 53 69 7a Byte < usableSiz
9bb0: 65 2d 38 20 29 3b 0a 0a 20 20 6e 46 72 61 67 20 e-8 );.. nFrag
9bc0: 3d 20 64 61 74 61 5b 68 64 72 2b 37 5d 3b 0a 20 = data[hdr+7];.
9bd0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
9be0: 63 65 6c 6c 4f 66 66 73 65 74 20 3d 3d 20 68 64 cellOffset == hd
9bf0: 72 20 2b 20 31 32 20 2d 20 34 2a 70 50 61 67 65 r + 12 - 4*pPage
9c00: 2d 3e 6c 65 61 66 20 29 3b 0a 20 20 67 61 70 20 ->leaf );. gap
9c10: 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 = pPage->cellOff
9c20: 73 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e set + 2*pPage->n
9c30: 43 65 6c 6c 3b 0a 20 20 74 6f 70 20 3d 20 67 65 Cell;. top = ge
9c40: 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 64 t2byteNotZero(&d
9c50: 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 ata[hdr+5]);. i
9c60: 66 28 20 67 61 70 3e 74 6f 70 20 29 20 72 65 74 f( gap>top ) ret
9c70: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
9c80: 50 54 5f 42 4b 50 54 3b 0a 20 20 74 65 73 74 63 PT_BKPT;. testc
9c90: 61 73 65 28 20 67 61 70 2b 32 3d 3d 74 6f 70 20 ase( gap+2==top
9ca0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 );. testcase( g
9cb0: 61 70 2b 31 3d 3d 74 6f 70 20 29 3b 0a 20 20 74 ap+1==top );. t
9cc0: 65 73 74 63 61 73 65 28 20 67 61 70 3d 3d 74 6f estcase( gap==to
9cd0: 70 20 29 3b 0a 0a 20 20 69 66 28 20 6e 46 72 61 p );.. if( nFra
9ce0: 67 3e 3d 36 30 20 29 7b 0a 20 20 20 20 2f 2a 20 g>=60 ){. /*
9cf0: 41 6c 77 61 79 73 20 64 65 66 72 61 67 6d 65 6e Always defragmen
9d00: 74 20 68 69 67 68 6c 79 20 66 72 61 67 6d 65 6e t highly fragmen
9d10: 74 65 64 20 70 61 67 65 73 20 2a 2f 0a 20 20 20 ted pages */.
9d20: 20 72 63 20 3d 20 64 65 66 72 61 67 6d 65 6e 74 rc = defragment
9d30: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 Page(pPage);.
9d40: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
9d50: 20 72 63 3b 0a 20 20 20 20 74 6f 70 20 3d 20 67 rc;. top = g
9d60: 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 et2byteNotZero(&
9d70: 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 data[hdr+5]);.
9d80: 7d 65 6c 73 65 20 69 66 28 20 67 61 70 2b 32 3c }else if( gap+2<
9d90: 3d 74 6f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 53 =top ){. /* S
9da0: 65 61 72 63 68 20 74 68 65 20 66 72 65 65 6c 69 earch the freeli
9db0: 73 74 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 st looking for a
9dc0: 20 66 72 65 65 20 73 6c 6f 74 20 62 69 67 20 65 free slot big e
9dd0: 6e 6f 75 67 68 20 74 6f 20 73 61 74 69 73 66 79 nough to satisfy
9de0: 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 72 65 71 . ** the req
9df0: 75 65 73 74 2e 20 54 68 65 20 61 6c 6c 6f 63 61 uest. The alloca
9e00: 74 69 6f 6e 20 69 73 20 6d 61 64 65 20 66 72 6f tion is made fro
9e10: 6d 20 74 68 65 20 66 69 72 73 74 20 66 72 65 65 m the first free
9e20: 20 73 6c 6f 74 20 69 6e 20 0a 20 20 20 20 2a 2a slot in . **
9e30: 20 74 68 65 20 6c 69 73 74 20 74 68 61 74 20 69 the list that i
9e40: 73 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 74 s large enough t
9e50: 6f 20 61 63 63 6f 6d 6d 6f 64 61 74 65 20 69 74 o accommodate it
9e60: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 .. */. int
9e70: 20 70 63 2c 20 61 64 64 72 3b 0a 20 20 20 20 66 pc, addr;. f
9e80: 6f 72 28 61 64 64 72 3d 68 64 72 2b 31 3b 20 28 or(addr=hdr+1; (
9e90: 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 pc = get2byte(&d
9ea0: 61 74 61 5b 61 64 64 72 5d 29 29 3e 30 3b 20 61 ata[addr]))>0; a
9eb0: 64 64 72 3d 70 63 29 7b 0a 20 20 20 20 20 20 69 ddr=pc){. i
9ec0: 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 nt size;
9ed0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
9ee0: 68 65 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a he free slot */.
9ef0: 20 20 20 20 20 20 69 66 28 20 70 63 3e 75 73 61 if( pc>usa
9f00: 62 6c 65 53 69 7a 65 2d 34 20 7c 7c 20 70 63 3c bleSize-4 || pc<
9f10: 61 64 64 72 2b 34 20 29 7b 0a 20 20 20 20 20 20 addr+4 ){.
9f20: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
9f30: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
9f40: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 69 7a 65 }. size
9f50: 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 = get2byte(&dat
9f60: 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 20 20 20 a[pc+2]);.
9f70: 69 66 28 20 73 69 7a 65 3e 3d 6e 42 79 74 65 20 if( size>=nByte
9f80: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 78 ){. int x
9f90: 20 3d 20 73 69 7a 65 20 2d 20 6e 42 79 74 65 3b = size - nByte;
9fa0: 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 . testcas
9fb0: 65 28 20 78 3d 3d 34 20 29 3b 0a 20 20 20 20 20 e( x==4 );.
9fc0: 20 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d testcase( x==
9fd0: 33 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 3 );. if(
9fe0: 20 78 3c 34 20 29 7b 0a 20 20 20 20 20 20 20 20 x<4 ){.
9ff0: 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 /* Remove the
a000: 73 6c 6f 74 20 66 72 6f 6d 20 74 68 65 20 66 72 slot from the fr
a010: 65 65 2d 6c 69 73 74 2e 20 55 70 64 61 74 65 20 ee-list. Update
a020: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 the number of.
a030: 20 20 20 20 20 20 20 20 2a 2a 20 66 72 61 67 6d ** fragm
a040: 65 6e 74 65 64 20 62 79 74 65 73 20 77 69 74 68 ented bytes with
a050: 69 6e 20 74 68 65 20 70 61 67 65 2e 20 2a 2f 0a in the page. */.
a060: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
a070: 28 26 64 61 74 61 5b 61 64 64 72 5d 2c 20 26 64 (&data[addr], &d
a080: 61 74 61 5b 70 63 5d 2c 20 32 29 3b 0a 20 20 20 ata[pc], 2);.
a090: 20 20 20 20 20 20 20 64 61 74 61 5b 68 64 72 2b data[hdr+
a0a0: 37 5d 20 3d 20 28 75 38 29 28 6e 46 72 61 67 20 7] = (u8)(nFrag
a0b0: 2b 20 78 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 + x);. }e
a0c0: 6c 73 65 20 69 66 28 20 73 69 7a 65 2b 70 63 20 lse if( size+pc
a0d0: 3e 20 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a > usableSize ){.
a0e0: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
a0f0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
a100: 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 65 BKPT;. }e
a110: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f lse{. /
a120: 2a 20 54 68 65 20 73 6c 6f 74 20 72 65 6d 61 69 * The slot remai
a130: 6e 73 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c ns on the free-l
a140: 69 73 74 2e 20 52 65 64 75 63 65 20 69 74 73 20 ist. Reduce its
a150: 73 69 7a 65 20 74 6f 20 61 63 63 6f 75 6e 74 0a size to account.
a160: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 66 6f 72 ** for
a170: 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 75 73 65 the portion use
a180: 64 20 62 79 20 74 68 65 20 6e 65 77 20 61 6c 6c d by the new all
a190: 6f 63 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20 20 ocation. */.
a1a0: 20 20 20 20 20 20 70 75 74 32 62 79 74 65 28 26 put2byte(&
a1b0: 64 61 74 61 5b 70 63 2b 32 5d 2c 20 78 29 3b 0a data[pc+2], x);.
a1c0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
a1d0: 20 20 2a 70 49 64 78 20 3d 20 70 63 20 2b 20 78 *pIdx = pc + x
a1e0: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
a1f0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
a200: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 }. }. }..
a210: 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20 6d 61 6b /* Check to mak
a220: 65 20 73 75 72 65 20 74 68 65 72 65 20 69 73 20 e sure there is
a230: 65 6e 6f 75 67 68 20 73 70 61 63 65 20 69 6e 20 enough space in
a240: 74 68 65 20 67 61 70 20 74 6f 20 73 61 74 69 73 the gap to satis
a250: 66 79 0a 20 20 2a 2a 20 74 68 65 20 61 6c 6c 6f fy. ** the allo
a260: 63 61 74 69 6f 6e 2e 20 20 49 66 20 6e 6f 74 2c cation. If not,
a270: 20 64 65 66 72 61 67 6d 65 6e 74 2e 0a 20 20 2a defragment.. *
a280: 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 /. testcase( ga
a290: 70 2b 32 2b 6e 42 79 74 65 3d 3d 74 6f 70 20 29 p+2+nByte==top )
a2a0: 3b 0a 20 20 69 66 28 20 67 61 70 2b 32 2b 6e 42 ;. if( gap+2+nB
a2b0: 79 74 65 3e 74 6f 70 20 29 7b 0a 20 20 20 20 72 yte>top ){. r
a2c0: 63 20 3d 20 64 65 66 72 61 67 6d 65 6e 74 50 61 c = defragmentPa
a2d0: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 69 ge(pPage);. i
a2e0: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
a2f0: 63 3b 0a 20 20 20 20 74 6f 70 20 3d 20 67 65 74 c;. top = get
a300: 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 2byteNotZero(&da
a310: 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 20 20 ta[hdr+5]);.
a320: 61 73 73 65 72 74 28 20 67 61 70 2b 6e 42 79 74 assert( gap+nByt
a330: 65 3c 3d 74 6f 70 20 29 3b 0a 20 20 7d 0a 0a 0a e<=top );. }...
a340: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 /* Allocate me
a350: 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65 20 67 61 mory from the ga
a360: 70 20 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65 p in between the
a370: 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 cell pointer ar
a380: 72 61 79 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 ray. ** and the
a390: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 cell content ar
a3a0: 65 61 2e 20 20 54 68 65 20 62 74 72 65 65 49 6e ea. The btreeIn
a3b0: 69 74 50 61 67 65 28 29 20 63 61 6c 6c 20 68 61 itPage() call ha
a3c0: 73 20 61 6c 72 65 61 64 79 0a 20 20 2a 2a 20 76 s already. ** v
a3d0: 61 6c 69 64 61 74 65 64 20 74 68 65 20 66 72 65 alidated the fre
a3e0: 65 6c 69 73 74 2e 20 20 47 69 76 65 6e 20 74 68 elist. Given th
a3f0: 61 74 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 at the freelist
a400: 69 73 20 76 61 6c 69 64 2c 20 74 68 65 72 65 0a is valid, there.
a410: 20 20 2a 2a 20 69 73 20 6e 6f 20 77 61 79 20 74 ** is no way t
a420: 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 hat the allocati
a430: 6f 6e 20 63 61 6e 20 65 78 74 65 6e 64 20 6f 66 on can extend of
a440: 66 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 f the end of the
a450: 20 70 61 67 65 2e 0a 20 20 2a 2a 20 54 68 65 20 page.. ** The
a460: 61 73 73 65 72 74 28 29 20 62 65 6c 6f 77 20 76 assert() below v
a470: 65 72 69 66 69 65 73 20 74 68 65 20 70 72 65 76 erifies the prev
a480: 69 6f 75 73 20 73 65 6e 74 65 6e 63 65 2e 0a 20 ious sentence..
a490: 20 2a 2f 0a 20 20 74 6f 70 20 2d 3d 20 6e 42 79 */. top -= nBy
a4a0: 74 65 3b 0a 20 20 70 75 74 32 62 79 74 65 28 26 te;. put2byte(&
a4b0: 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 74 6f 70 data[hdr+5], top
a4c0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 74 6f 70 );. assert( top
a4d0: 2b 6e 42 79 74 65 20 3c 3d 20 28 69 6e 74 29 70 +nByte <= (int)p
a4e0: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
a4f0: 65 53 69 7a 65 20 29 3b 0a 20 20 2a 70 49 64 78 eSize );. *pIdx
a500: 20 3d 20 74 6f 70 3b 0a 20 20 72 65 74 75 72 6e = top;. return
a510: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
a520: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 65 *.** Return a se
a530: 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 50 61 ction of the pPa
a540: 67 65 2d 3e 61 44 61 74 61 20 74 6f 20 74 68 65 ge->aData to the
a550: 20 66 72 65 65 6c 69 73 74 2e 0a 2a 2a 20 54 68 freelist..** Th
a560: 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
a570: 74 68 65 20 6e 65 77 20 66 72 65 65 20 62 6c 6f the new free blo
a580: 63 6b 20 69 73 20 70 50 61 67 65 2d 3e 61 44 69 ck is pPage->aDi
a590: 73 6b 5b 73 74 61 72 74 5d 0a 2a 2a 20 61 6e 64 sk[start].** and
a5a0: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
a5b0: 20 62 6c 6f 63 6b 20 69 73 20 22 73 69 7a 65 22 block is "size"
a5c0: 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 4d 6f bytes..**.** Mo
a5d0: 73 74 20 6f 66 20 74 68 65 20 65 66 66 6f 72 74 st of the effort
a5e0: 20 68 65 72 65 20 69 73 20 69 6e 76 6f 6c 76 65 here is involve
a5f0: 64 20 69 6e 20 63 6f 61 6c 65 73 69 6e 67 20 61 d in coalesing a
a600: 64 6a 61 63 65 6e 74 0a 2a 2a 20 66 72 65 65 20 djacent.** free
a610: 62 6c 6f 63 6b 73 20 69 6e 74 6f 20 61 20 73 69 blocks into a si
a620: 6e 67 6c 65 20 62 69 67 20 66 72 65 65 20 62 6c ngle big free bl
a630: 6f 63 6b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ock..*/.static i
a640: 6e 74 20 66 72 65 65 53 70 61 63 65 28 4d 65 6d nt freeSpace(Mem
a650: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
a660: 20 73 74 61 72 74 2c 20 69 6e 74 20 73 69 7a 65 start, int size
a670: 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 2c 20 70 ){. int addr, p
a680: 62 65 67 69 6e 2c 20 68 64 72 3b 0a 20 20 69 6e begin, hdr;. in
a690: 74 20 69 4c 61 73 74 3b 20 20 20 20 20 20 20 20 t iLast;
a6a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a6b0: 2f 2a 20 4c 61 72 67 65 73 74 20 70 6f 73 73 69 /* Largest possi
a6c0: 62 6c 65 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 ble freeblock of
a6d0: 66 73 65 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e fset */. unsign
a6e0: 65 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d 20 ed char *data =
a6f0: 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 0a 20 pPage->aData;..
a700: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
a710: 70 42 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 pBt!=0 );. asse
a720: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
a730: 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
a740: 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
a750: 20 61 73 73 65 72 74 28 20 73 74 61 72 74 3e 3d assert( start>=
a760: 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
a770: 2b 36 2b 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 +6+pPage->childP
a780: 74 72 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 trSize );. asse
a790: 72 74 28 20 28 73 74 61 72 74 20 2b 20 73 69 7a rt( (start + siz
a7a0: 65 29 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 e) <= (int)pPage
a7b0: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
a7c0: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 e );. assert( s
a7d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
a7e0: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
a7f0: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
a800: 28 20 73 69 7a 65 3e 3d 30 20 29 3b 20 20 20 2f ( size>=0 ); /
a810: 2a 20 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 73 * Minimum cell s
a820: 69 7a 65 20 69 73 20 34 20 2a 2f 0a 0a 20 20 69 ize is 4 */.. i
a830: 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 62 f( pPage->pBt->b
a840: 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 tsFlags & BTS_SE
a850: 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 CURE_DELETE ){.
a860: 20 20 20 2f 2a 20 4f 76 65 72 77 72 69 74 65 20 /* Overwrite
a870: 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 6d 61 74 deleted informat
a880: 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 20 77 ion with zeros w
a890: 68 65 6e 20 74 68 65 20 73 65 63 75 72 65 5f 64 hen the secure_d
a8a0: 65 6c 65 74 65 0a 20 20 20 20 2a 2a 20 6f 70 74 elete. ** opt
a8b0: 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 20 2a ion is enabled *
a8c0: 2f 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 64 61 /. memset(&da
a8d0: 74 61 5b 73 74 61 72 74 5d 2c 20 30 2c 20 73 69 ta[start], 0, si
a8e0: 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 ze);. }.. /* A
a8f0: 64 64 20 74 68 65 20 73 70 61 63 65 20 62 61 63 dd the space bac
a900: 6b 20 69 6e 74 6f 20 74 68 65 20 6c 69 6e 6b 65 k into the linke
a910: 64 20 6c 69 73 74 20 6f 66 20 66 72 65 65 62 6c d list of freebl
a920: 6f 63 6b 73 2e 20 20 4e 6f 74 65 20 74 68 61 74 ocks. Note that
a930: 0a 20 20 2a 2a 20 65 76 65 6e 20 74 68 6f 75 67 . ** even thoug
a940: 68 20 74 68 65 20 66 72 65 65 62 6c 6f 63 6b 20 h the freeblock
a950: 6c 69 73 74 20 77 61 73 20 63 68 65 63 6b 65 64 list was checked
a960: 20 62 79 20 62 74 72 65 65 49 6e 69 74 50 61 67 by btreeInitPag
a970: 65 28 29 2c 0a 20 20 2a 2a 20 62 74 72 65 65 49 e(),. ** btreeI
a980: 6e 69 74 50 61 67 65 28 29 20 64 69 64 20 6e 6f nitPage() did no
a990: 74 20 64 65 74 65 63 74 20 6f 76 65 72 6c 61 70 t detect overlap
a9a0: 70 69 6e 67 20 63 65 6c 6c 73 20 6f 72 0a 20 20 ping cells or.
a9b0: 2a 2a 20 66 72 65 65 62 6c 6f 63 6b 73 20 74 68 ** freeblocks th
a9c0: 61 74 20 6f 76 65 72 6c 61 70 70 65 64 20 63 65 at overlapped ce
a9d0: 6c 6c 73 2e 20 20 20 4e 6f 72 20 64 6f 65 73 20 lls. Nor does
a9e0: 69 74 20 64 65 74 65 63 74 20 77 68 65 6e 20 74 it detect when t
a9f0: 68 65 0a 20 20 2a 2a 20 63 65 6c 6c 20 63 6f 6e he. ** cell con
aa00: 74 65 6e 74 20 61 72 65 61 20 65 78 63 65 65 64 tent area exceed
aa10: 73 20 74 68 65 20 76 61 6c 75 65 20 69 6e 20 74 s the value in t
aa20: 68 65 20 70 61 67 65 20 68 65 61 64 65 72 2e 20 he page header.
aa30: 20 49 66 20 74 68 65 73 65 0a 20 20 2a 2a 20 73 If these. ** s
aa40: 69 74 75 61 74 69 6f 6e 73 20 61 72 69 73 65 2c ituations arise,
aa50: 20 74 68 65 6e 20 73 75 62 73 65 71 75 65 6e 74 then subsequent
aa60: 20 69 6e 73 65 72 74 20 6f 70 65 72 61 74 69 6f insert operatio
aa70: 6e 73 20 6d 69 67 68 74 20 63 6f 72 72 75 70 74 ns might corrupt
aa80: 0a 20 20 2a 2a 20 74 68 65 20 66 72 65 65 6c 69 . ** the freeli
aa90: 73 74 2e 20 20 53 6f 20 77 65 20 64 6f 20 6e 65 st. So we do ne
aaa0: 65 64 20 74 6f 20 63 68 65 63 6b 20 66 6f 72 20 ed to check for
aab0: 63 6f 72 72 75 70 74 69 6f 6e 20 77 68 69 6c 65 corruption while
aac0: 20 73 63 61 6e 6e 69 6e 67 0a 20 20 2a 2a 20 74 scanning. ** t
aad0: 68 65 20 66 72 65 65 6c 69 73 74 2e 0a 20 20 2a he freelist.. *
aae0: 2f 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d /. hdr = pPage-
aaf0: 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 61 64 >hdrOffset;. ad
ab00: 64 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 dr = hdr + 1;.
ab10: 69 4c 61 73 74 20 3d 20 70 50 61 67 65 2d 3e 70 iLast = pPage->p
ab20: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
ab30: 20 34 3b 0a 20 20 61 73 73 65 72 74 28 20 73 74 4;. assert( st
ab40: 61 72 74 3c 3d 69 4c 61 73 74 20 29 3b 0a 20 20 art<=iLast );.
ab50: 77 68 69 6c 65 28 20 28 70 62 65 67 69 6e 20 3d while( (pbegin =
ab60: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
ab70: 61 64 64 72 5d 29 29 3c 73 74 61 72 74 20 26 26 addr]))<start &&
ab80: 20 70 62 65 67 69 6e 3e 30 20 29 7b 0a 20 20 20 pbegin>0 ){.
ab90: 20 69 66 28 20 70 62 65 67 69 6e 3c 61 64 64 72 if( pbegin<addr
aba0: 2b 34 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 +4 ){. retu
abb0: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
abc0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 T_BKPT;. }.
abd0: 20 20 61 64 64 72 20 3d 20 70 62 65 67 69 6e 3b addr = pbegin;
abe0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 62 65 67 69 . }. if( pbegi
abf0: 6e 3e 69 4c 61 73 74 20 29 7b 0a 20 20 20 20 72 n>iLast ){. r
ac00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
ac10: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 RUPT_BKPT;. }.
ac20: 20 61 73 73 65 72 74 28 20 70 62 65 67 69 6e 3e assert( pbegin>
ac30: 61 64 64 72 20 7c 7c 20 70 62 65 67 69 6e 3d 3d addr || pbegin==
ac40: 30 20 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 0 );. put2byte(
ac50: 26 64 61 74 61 5b 61 64 64 72 5d 2c 20 73 74 61 &data[addr], sta
ac60: 72 74 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 rt);. put2byte(
ac70: 26 64 61 74 61 5b 73 74 61 72 74 5d 2c 20 70 62 &data[start], pb
ac80: 65 67 69 6e 29 3b 0a 20 20 70 75 74 32 62 79 74 egin);. put2byt
ac90: 65 28 26 64 61 74 61 5b 73 74 61 72 74 2b 32 5d e(&data[start+2]
aca0: 2c 20 73 69 7a 65 29 3b 0a 20 20 70 50 61 67 65 , size);. pPage
acb0: 2d 3e 6e 46 72 65 65 20 3d 20 70 50 61 67 65 2d ->nFree = pPage-
acc0: 3e 6e 46 72 65 65 20 2b 20 28 75 31 36 29 73 69 >nFree + (u16)si
acd0: 7a 65 3b 0a 0a 20 20 2f 2a 20 43 6f 61 6c 65 73 ze;.. /* Coales
ace0: 63 65 20 61 64 6a 61 63 65 6e 74 20 66 72 65 65 ce adjacent free
acf0: 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 61 64 64 blocks */. add
ad00: 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 77 r = hdr + 1;. w
ad10: 68 69 6c 65 28 20 28 70 62 65 67 69 6e 20 3d 20 hile( (pbegin =
ad20: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 61 get2byte(&data[a
ad30: 64 64 72 5d 29 29 3e 30 20 29 7b 0a 20 20 20 20 ddr]))>0 ){.
ad40: 69 6e 74 20 70 6e 65 78 74 2c 20 70 73 69 7a 65 int pnext, psize
ad50: 2c 20 78 3b 0a 20 20 20 20 61 73 73 65 72 74 28 , x;. assert(
ad60: 20 70 62 65 67 69 6e 3e 61 64 64 72 20 29 3b 0a pbegin>addr );.
ad70: 20 20 20 20 61 73 73 65 72 74 28 20 70 62 65 67 assert( pbeg
ad80: 69 6e 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 in <= (int)pPage
ad90: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
ada0: 65 2d 34 20 29 3b 0a 20 20 20 20 70 6e 65 78 74 e-4 );. pnext
adb0: 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 = get2byte(&dat
adc0: 61 5b 70 62 65 67 69 6e 5d 29 3b 0a 20 20 20 20 a[pbegin]);.
add0: 70 73 69 7a 65 20 3d 20 67 65 74 32 62 79 74 65 psize = get2byte
ade0: 28 26 64 61 74 61 5b 70 62 65 67 69 6e 2b 32 5d (&data[pbegin+2]
adf0: 29 3b 0a 20 20 20 20 69 66 28 20 70 62 65 67 69 );. if( pbegi
ae00: 6e 20 2b 20 70 73 69 7a 65 20 2b 20 33 20 3e 3d n + psize + 3 >=
ae10: 20 70 6e 65 78 74 20 26 26 20 70 6e 65 78 74 3e pnext && pnext>
ae20: 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 66 0 ){. int f
ae30: 72 61 67 20 3d 20 70 6e 65 78 74 20 2d 20 28 70 rag = pnext - (p
ae40: 62 65 67 69 6e 2b 70 73 69 7a 65 29 3b 0a 20 20 begin+psize);.
ae50: 20 20 20 20 69 66 28 20 28 66 72 61 67 3c 30 29 if( (frag<0)
ae60: 20 7c 7c 20 28 66 72 61 67 3e 28 69 6e 74 29 64 || (frag>(int)d
ae70: 61 74 61 5b 68 64 72 2b 37 5d 29 20 29 7b 0a 20 ata[hdr+7]) ){.
ae80: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
ae90: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
aea0: 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 T;. }.
aeb0: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2d 3d 20 data[hdr+7] -=
aec0: 28 75 38 29 66 72 61 67 3b 0a 20 20 20 20 20 20 (u8)frag;.
aed0: 78 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 x = get2byte(&da
aee0: 74 61 5b 70 6e 65 78 74 5d 29 3b 0a 20 20 20 20 ta[pnext]);.
aef0: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
af00: 5b 70 62 65 67 69 6e 5d 2c 20 78 29 3b 0a 20 20 [pbegin], x);.
af10: 20 20 20 20 78 20 3d 20 70 6e 65 78 74 20 2b 20 x = pnext +
af20: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 get2byte(&data[p
af30: 6e 65 78 74 2b 32 5d 29 20 2d 20 70 62 65 67 69 next+2]) - pbegi
af40: 6e 3b 0a 20 20 20 20 20 20 70 75 74 32 62 79 74 n;. put2byt
af50: 65 28 26 64 61 74 61 5b 70 62 65 67 69 6e 2b 32 e(&data[pbegin+2
af60: 5d 2c 20 78 29 3b 0a 20 20 20 20 7d 65 6c 73 65 ], x);. }else
af70: 7b 0a 20 20 20 20 20 20 61 64 64 72 20 3d 20 70 {. addr = p
af80: 62 65 67 69 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d begin;. }. }
af90: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 63 65 .. /* If the ce
afa0: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 ll content area
afb0: 62 65 67 69 6e 73 20 77 69 74 68 20 61 20 66 72 begins with a fr
afc0: 65 65 62 6c 6f 63 6b 2c 20 72 65 6d 6f 76 65 20 eeblock, remove
afd0: 69 74 2e 20 2a 2f 0a 20 20 69 66 28 20 64 61 74 it. */. if( dat
afe0: 61 5b 68 64 72 2b 31 5d 3d 3d 64 61 74 61 5b 68 a[hdr+1]==data[h
aff0: 64 72 2b 35 5d 20 26 26 20 64 61 74 61 5b 68 64 dr+5] && data[hd
b000: 72 2b 32 5d 3d 3d 64 61 74 61 5b 68 64 72 2b 36 r+2]==data[hdr+6
b010: 5d 20 29 7b 0a 20 20 20 20 69 6e 74 20 74 6f 70 ] ){. int top
b020: 3b 0a 20 20 20 20 70 62 65 67 69 6e 20 3d 20 67 ;. pbegin = g
b030: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
b040: 72 2b 31 5d 29 3b 0a 20 20 20 20 6d 65 6d 63 70 r+1]);. memcp
b050: 79 28 26 64 61 74 61 5b 68 64 72 2b 31 5d 2c 20 y(&data[hdr+1],
b060: 26 64 61 74 61 5b 70 62 65 67 69 6e 5d 2c 20 32 &data[pbegin], 2
b070: 29 3b 0a 20 20 20 20 74 6f 70 20 3d 20 67 65 74 );. top = get
b080: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
b090: 35 5d 29 20 2b 20 67 65 74 32 62 79 74 65 28 26 5]) + get2byte(&
b0a0: 64 61 74 61 5b 70 62 65 67 69 6e 2b 32 5d 29 3b data[pbegin+2]);
b0b0: 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 64 . put2byte(&d
b0c0: 61 74 61 5b 68 64 72 2b 35 5d 2c 20 74 6f 70 29 ata[hdr+5], top)
b0d0: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
b0e0: 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
b0f0: 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
b100: 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 65 74 DbPage) );. ret
b110: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
b120: 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6f 64 65 20 74 ../*.** Decode t
b130: 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 28 74 he flags byte (t
b140: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
b150: 20 74 68 65 20 68 65 61 64 65 72 29 20 66 6f 72 the header) for
b160: 20 61 20 70 61 67 65 0a 2a 2a 20 61 6e 64 20 69 a page.** and i
b170: 6e 69 74 69 61 6c 69 7a 65 20 66 69 65 6c 64 73 nitialize fields
b180: 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 20 of the MemPage
b190: 73 74 72 75 63 74 75 72 65 20 61 63 63 6f 72 64 structure accord
b1a0: 69 6e 67 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c ingly..**.** Onl
b1b0: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
b1c0: 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 61 72 65 combinations are
b1d0: 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 supported. Any
b1e0: 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e 74 0a thing different.
b1f0: 2a 2a 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 ** indicates a c
b200: 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 orrupt database
b210: 66 69 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 files:.**.**
b220: 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 PTF_ZERODAT
b230: 41 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 A.** PTF
b240: 5f 5a 45 52 4f 44 41 54 41 20 7c 20 50 54 46 5f _ZERODATA | PTF_
b250: 4c 45 41 46 0a 2a 2a 20 20 20 20 20 20 20 20 20 LEAF.**
b260: 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 PTF_LEAFDATA | P
b270: 54 46 5f 49 4e 54 4b 45 59 0a 2a 2a 20 20 20 20 TF_INTKEY.**
b280: 20 20 20 20 20 50 54 46 5f 4c 45 41 46 44 41 54 PTF_LEAFDAT
b290: 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 20 7c A | PTF_INTKEY |
b2a0: 20 50 54 46 5f 4c 45 41 46 0a 2a 2f 0a 73 74 61 PTF_LEAF.*/.sta
b2b0: 74 69 63 20 69 6e 74 20 64 65 63 6f 64 65 46 6c tic int decodeFl
b2c0: 61 67 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ags(MemPage *pPa
b2d0: 67 65 2c 20 69 6e 74 20 66 6c 61 67 42 79 74 65 ge, int flagByte
b2e0: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
b2f0: 42 74 3b 20 20 20 20 20 2f 2a 20 41 20 63 6f 70 Bt; /* A cop
b300: 79 20 6f 66 20 70 50 61 67 65 2d 3e 70 42 74 20 y of pPage->pBt
b310: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
b320: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d age->hdrOffset==
b330: 28 70 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 (pPage->pgno==1
b340: 3f 20 31 30 30 20 3a 20 30 29 20 29 3b 0a 20 20 ? 100 : 0) );.
b350: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
b360: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
b370: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
b380: 0a 20 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 3d . pPage->leaf =
b390: 20 28 75 38 29 28 66 6c 61 67 42 79 74 65 3e 3e (u8)(flagByte>>
b3a0: 33 29 3b 20 20 61 73 73 65 72 74 28 20 50 54 46 3); assert( PTF
b3b0: 5f 4c 45 41 46 20 3d 3d 20 31 3c 3c 33 20 29 3b _LEAF == 1<<3 );
b3c0: 0a 20 20 66 6c 61 67 42 79 74 65 20 26 3d 20 7e . flagByte &= ~
b3d0: 50 54 46 5f 4c 45 41 46 3b 0a 20 20 70 50 61 67 PTF_LEAF;. pPag
b3e0: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 e->childPtrSize
b3f0: 3d 20 34 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 = 4-4*pPage->lea
b400: 66 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 67 65 f;. pBt = pPage
b410: 2d 3e 70 42 74 3b 0a 20 20 69 66 28 20 66 6c 61 ->pBt;. if( fla
b420: 67 42 79 74 65 3d 3d 28 50 54 46 5f 4c 45 41 46 gByte==(PTF_LEAF
b430: 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 DATA | PTF_INTKE
b440: 59 29 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d Y) ){. pPage-
b450: 3e 69 6e 74 4b 65 79 20 3d 20 31 3b 0a 20 20 20 >intKey = 1;.
b460: 20 70 50 61 67 65 2d 3e 68 61 73 44 61 74 61 20 pPage->hasData
b470: 3d 20 70 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 = pPage->leaf;.
b480: 20 20 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 pPage->maxLoc
b490: 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 78 4c 65 61 al = pBt->maxLea
b4a0: 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 f;. pPage->mi
b4b0: 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 nLocal = pBt->mi
b4c0: 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c 73 65 20 69 nLeaf;. }else i
b4d0: 66 28 20 66 6c 61 67 42 79 74 65 3d 3d 50 54 46 f( flagByte==PTF
b4e0: 5f 5a 45 52 4f 44 41 54 41 20 29 7b 0a 20 20 20 _ZERODATA ){.
b4f0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d pPage->intKey =
b500: 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 68 0;. pPage->h
b510: 61 73 44 61 74 61 20 3d 20 30 3b 0a 20 20 20 20 asData = 0;.
b520: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
b530: 3d 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b = pBt->maxLocal;
b540: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c . pPage->minL
b550: 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c ocal = pBt->minL
b560: 6f 63 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 ocal;. }else{.
b570: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
b580: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
b590: 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6d 61 78 31 }. pPage->max1
b5a0: 62 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 70 42 bytePayload = pB
b5b0: 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f t->max1bytePaylo
b5c0: 61 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ad;. return SQL
b5d0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
b5e0: 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 Initialize the
b5f0: 61 75 78 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d auxiliary inform
b600: 61 74 69 6f 6e 20 66 6f 72 20 61 20 64 69 73 6b ation for a disk
b610: 20 62 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 52 65 block..**.** Re
b620: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f turn SQLITE_OK o
b630: 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 77 n success. If w
b640: 65 20 73 65 65 20 74 68 61 74 20 74 68 65 20 70 e see that the p
b650: 61 67 65 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 age does.** not
b660: 63 6f 6e 74 61 69 6e 20 61 20 77 65 6c 6c 2d 66 contain a well-f
b670: 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 ormed database p
b680: 61 67 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e age, then return
b690: 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 .** SQLITE_CORR
b6a0: 55 50 54 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 UPT. Note that
b6b0: 61 20 72 65 74 75 72 6e 20 6f 66 20 53 51 4c 49 a return of SQLI
b6c0: 54 45 5f 4f 4b 20 64 6f 65 73 20 6e 6f 74 0a 2a TE_OK does not.*
b6d0: 2a 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 * guarantee that
b6e0: 20 74 68 65 20 70 61 67 65 20 69 73 20 77 65 6c the page is wel
b6f0: 6c 2d 66 6f 72 6d 65 64 2e 20 20 49 74 20 6f 6e l-formed. It on
b700: 6c 79 20 73 68 6f 77 73 20 74 68 61 74 0a 2a 2a ly shows that.**
b710: 20 77 65 20 66 61 69 6c 65 64 20 74 6f 20 64 65 we failed to de
b720: 74 65 63 74 20 61 6e 79 20 63 6f 72 72 75 70 74 tect any corrupt
b730: 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ion..*/.static i
b740: 6e 74 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 nt btreeInitPage
b750: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
b760: 7b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 {.. assert( pPa
b770: 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 ge->pBt!=0 );.
b780: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
b790: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
b7a0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
b7b0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
b7c0: 2d 3e 70 67 6e 6f 3d 3d 73 71 6c 69 74 65 33 50 ->pgno==sqlite3P
b7d0: 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 agerPagenumber(p
b7e0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
b7f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
b800: 65 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 65 e == sqlite3Page
b810: 72 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d rGetExtra(pPage-
b820: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
b830: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
b840: 61 74 61 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 ata == sqlite3Pa
b850: 67 65 72 47 65 74 44 61 74 61 28 70 50 61 67 65 gerGetData(pPage
b860: 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 ->pDbPage) );..
b870: 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73 49 if( !pPage->isI
b880: 6e 69 74 20 29 7b 0a 20 20 20 20 75 31 36 20 70 nit ){. u16 p
b890: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a c; /*
b8a0: 20 41 64 64 72 65 73 73 20 6f 66 20 61 20 66 72 Address of a fr
b8b0: 65 65 62 6c 6f 63 6b 20 77 69 74 68 69 6e 20 70 eeblock within p
b8c0: 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d 20 2a 2f Page->aData[] */
b8d0: 0a 20 20 20 20 75 38 20 68 64 72 3b 20 20 20 20 . u8 hdr;
b8e0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
b8f0: 74 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 6f t to beginning o
b900: 66 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f f page header */
b910: 0a 20 20 20 20 75 38 20 2a 64 61 74 61 3b 20 20 . u8 *data;
b920: 20 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c /* Equal
b930: 20 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 to pPage->aData
b940: 20 2a 2f 0a 20 20 20 20 42 74 53 68 61 72 65 64 */. BtShared
b950: 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 2f 2a *pBt; /*
b960: 20 54 68 65 20 6d 61 69 6e 20 62 74 72 65 65 20 The main btree
b970: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 structure */.
b980: 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b int usableSize;
b990: 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 /* Amount of
b9a0: 20 75 73 61 62 6c 65 20 73 70 61 63 65 20 6f 6e usable space on
b9b0: 20 65 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 each page */.
b9c0: 20 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 u16 cellOffset
b9d0: 3b 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 66 ; /* Offset f
b9e0: 72 6f 6d 20 73 74 61 72 74 20 6f 66 20 70 61 67 rom start of pag
b9f0: 65 20 74 6f 20 66 69 72 73 74 20 63 65 6c 6c 20 e to first cell
ba00: 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 pointer */. i
ba10: 6e 74 20 6e 46 72 65 65 3b 20 20 20 20 20 20 20 nt nFree;
ba20: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
ba30: 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 74 nused bytes on t
ba40: 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 69 he page */. i
ba50: 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 nt top;
ba60: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
ba70: 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 of the cell cont
ba80: 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 20 20 ent area */.
ba90: 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 int iCellFirst;
baa0: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f /* First allo
bab0: 77 61 62 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 wable cell or fr
bac0: 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a eeblock offset *
bad0: 2f 0a 20 20 20 20 69 6e 74 20 69 43 65 6c 6c 4c /. int iCellL
bae0: 61 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 74 ast; /* Last
baf0: 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 6f possible cell o
bb00: 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 r freeblock offs
bb10: 65 74 20 2a 2f 0a 0a 20 20 20 20 70 42 74 20 3d et */.. pBt =
bb20: 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 0a 20 20 pPage->pBt;..
bb30: 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 hdr = pPage->h
bb40: 64 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 64 61 drOffset;. da
bb50: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
bb60: 61 3b 0a 20 20 20 20 69 66 28 20 64 65 63 6f 64 a;. if( decod
bb70: 65 46 6c 61 67 73 28 70 50 61 67 65 2c 20 64 61 eFlags(pPage, da
bb80: 74 61 5b 68 64 72 5d 29 20 29 20 72 65 74 75 72 ta[hdr]) ) retur
bb90: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
bba0: 5f 42 4b 50 54 3b 0a 20 20 20 20 61 73 73 65 72 _BKPT;. asser
bbb0: 74 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 t( pBt->pageSize
bbc0: 3e 3d 35 31 32 20 26 26 20 70 42 74 2d 3e 70 61 >=512 && pBt->pa
bbd0: 67 65 53 69 7a 65 3c 3d 36 35 35 33 36 20 29 3b geSize<=65536 );
bbe0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 73 6b . pPage->mask
bbf0: 50 61 67 65 20 3d 20 28 75 31 36 29 28 70 42 74 Page = (u16)(pBt
bc00: 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 31 29 3b ->pageSize - 1);
bc10: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 4f 76 65 . pPage->nOve
bc20: 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 20 20 75 rflow = 0;. u
bc30: 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d sableSize = pBt-
bc40: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 20 >usableSize;.
bc50: 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
bc60: 65 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 et = cellOffset
bc70: 3d 20 68 64 72 20 2b 20 31 32 20 2d 20 34 2a 70 = hdr + 12 - 4*p
bc80: 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 20 20 Page->leaf;.
bc90: 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
bca0: 3d 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 69 = &data[usableSi
bcb0: 7a 65 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e ze];. pPage->
bcc0: 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 aCellIdx = &data
bcd0: 5b 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 [cellOffset];.
bce0: 20 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 top = get2byte
bcf0: 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 NotZero(&data[hd
bd00: 72 2b 35 5d 29 3b 0a 20 20 20 20 70 50 61 67 65 r+5]);. pPage
bd10: 2d 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 ->nCell = get2by
bd20: 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 te(&data[hdr+3])
bd30: 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d ;. if( pPage-
bd40: 3e 6e 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 >nCell>MX_CELL(p
bd50: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 Bt) ){. /*
bd60: 54 6f 20 6d 61 6e 79 20 63 65 6c 6c 73 20 66 6f To many cells fo
bd70: 72 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 2e r a single page.
bd80: 20 20 54 68 65 20 70 61 67 65 20 6d 75 73 74 20 The page must
bd90: 62 65 20 63 6f 72 72 75 70 74 20 2a 2f 0a 20 20 be corrupt */.
bda0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
bdb0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
bdc0: 20 20 20 20 7d 0a 20 20 20 20 74 65 73 74 63 61 }. testca
bdd0: 73 65 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c se( pPage->nCell
bde0: 3d 3d 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 ==MX_CELL(pBt) )
bdf0: 3b 0a 0a 20 20 20 20 2f 2a 20 41 20 6d 61 6c 66 ;.. /* A malf
be00: 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 ormed database p
be10: 61 67 65 20 6d 69 67 68 74 20 63 61 75 73 65 20 age might cause
be20: 75 73 20 74 6f 20 72 65 61 64 20 70 61 73 74 20 us to read past
be30: 74 68 65 20 65 6e 64 0a 20 20 20 20 2a 2a 20 6f the end. ** o
be40: 66 20 70 61 67 65 20 77 68 65 6e 20 70 61 72 73 f page when pars
be50: 69 6e 67 20 61 20 63 65 6c 6c 2e 20 20 0a 20 20 ing a cell. .
be60: 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 **. ** The
be70: 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 following block
be80: 6f 66 20 63 6f 64 65 20 63 68 65 63 6b 73 20 65 of code checks e
be90: 61 72 6c 79 20 74 6f 20 73 65 65 20 69 66 20 61 arly to see if a
bea0: 20 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a 20 20 cell extends.
beb0: 20 20 2a 2a 20 70 61 73 74 20 74 68 65 20 65 6e ** past the en
bec0: 64 20 6f 66 20 61 20 70 61 67 65 20 62 6f 75 6e d of a page boun
bed0: 64 61 72 79 20 61 6e 64 20 63 61 75 73 65 73 20 dary and causes
bee0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 74 SQLITE_CORRUPT t
bef0: 6f 20 62 65 20 0a 20 20 20 20 2a 2a 20 72 65 74 o be . ** ret
bf00: 75 72 6e 65 64 20 69 66 20 69 74 20 64 6f 65 73 urned if it does
bf10: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 43 65 .. */. iCe
bf20: 6c 6c 46 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 llFirst = cellOf
bf30: 66 73 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e fset + 2*pPage->
bf40: 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 43 65 6c 6c nCell;. iCell
bf50: 4c 61 73 74 20 3d 20 75 73 61 62 6c 65 53 69 7a Last = usableSiz
bf60: 65 20 2d 20 34 3b 0a 23 69 66 20 64 65 66 69 6e e - 4;.#if defin
bf70: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
bf80: 5f 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 _OVERSIZE_CELL_C
bf90: 48 45 43 4b 29 0a 20 20 20 20 7b 0a 20 20 20 20 HECK). {.
bfa0: 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 int i;
bfb0: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 6e 74 /* Index int
bfc0: 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 o the cell point
bfd0: 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 20 20 er array */.
bfe0: 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 int sz;
bff0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 /* Size of a
c000: 20 63 65 6c 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 cell */..
c010: 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 if( !pPage->leaf
c020: 20 29 20 69 43 65 6c 6c 4c 61 73 74 2d 2d 3b 0a ) iCellLast--;.
c030: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 for(i=0; i
c040: 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 20 69 <pPage->nCell; i
c050: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 63 20 ++){. pc
c060: 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
c070: 5b 63 65 6c 6c 4f 66 66 73 65 74 2b 69 2a 32 5d [cellOffset+i*2]
c080: 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 );. testc
c090: 61 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 ase( pc==iCellFi
c0a0: 72 73 74 20 29 3b 0a 20 20 20 20 20 20 20 20 74 rst );. t
c0b0: 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 estcase( pc==iCe
c0c0: 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 20 20 llLast );.
c0d0: 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 69 if( pc<iCellFi
c0e0: 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c 4c rst || pc>iCellL
c0f0: 61 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ast ){.
c100: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
c110: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
c120: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 }. s
c130: 7a 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 z = cellSizePtr(
c140: 70 50 61 67 65 2c 20 26 64 61 74 61 5b 70 63 5d pPage, &data[pc]
c150: 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 );. testc
c160: 61 73 65 28 20 70 63 2b 73 7a 3d 3d 75 73 61 62 ase( pc+sz==usab
c170: 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 leSize );.
c180: 20 20 69 66 28 20 70 63 2b 73 7a 3e 75 73 61 62 if( pc+sz>usab
c190: 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 leSize ){.
c1a0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
c1b0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
c1c0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
c1d0: 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 61 }. if( !pPa
c1e0: 67 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c ge->leaf ) iCell
c1f0: 4c 61 73 74 2b 2b 3b 0a 20 20 20 20 7d 20 20 0a Last++;. } .
c200: 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 43 #endif.. /* C
c210: 6f 6d 70 75 74 65 20 74 68 65 20 74 6f 74 61 6c ompute the total
c220: 20 66 72 65 65 20 73 70 61 63 65 20 6f 6e 20 74 free space on t
c230: 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 70 he page */. p
c240: 63 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 c = get2byte(&da
c250: 74 61 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 20 ta[hdr+1]);.
c260: 6e 46 72 65 65 20 3d 20 64 61 74 61 5b 68 64 72 nFree = data[hdr
c270: 2b 37 5d 20 2b 20 74 6f 70 3b 0a 20 20 20 20 77 +7] + top;. w
c280: 68 69 6c 65 28 20 70 63 3e 30 20 29 7b 0a 20 20 hile( pc>0 ){.
c290: 20 20 20 20 75 31 36 20 6e 65 78 74 2c 20 73 69 u16 next, si
c2a0: 7a 65 3b 0a 20 20 20 20 20 20 69 66 28 20 70 63 ze;. if( pc
c2b0: 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 <iCellFirst || p
c2c0: 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 c>iCellLast ){.
c2d0: 20 20 20 20 20 20 20 2f 2a 20 53 74 61 72 74 20 /* Start
c2e0: 6f 66 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 73 of free block is
c2f0: 20 6f 66 66 20 74 68 65 20 70 61 67 65 20 2a 2f off the page */
c300: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
c310: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
c320: 4b 50 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 KPT; . }.
c330: 20 20 20 20 6e 65 78 74 20 3d 20 67 65 74 32 62 next = get2b
c340: 79 74 65 28 26 64 61 74 61 5b 70 63 5d 29 3b 0a yte(&data[pc]);.
c350: 20 20 20 20 20 20 73 69 7a 65 20 3d 20 67 65 74 size = get
c360: 32 62 79 74 65 28 26 64 61 74 61 5b 70 63 2b 32 2byte(&data[pc+2
c370: 5d 29 3b 0a 20 20 20 20 20 20 69 66 28 20 28 6e ]);. if( (n
c380: 65 78 74 3e 30 20 26 26 20 6e 65 78 74 3c 3d 70 ext>0 && next<=p
c390: 63 2b 73 69 7a 65 2b 33 29 20 7c 7c 20 70 63 2b c+size+3) || pc+
c3a0: 73 69 7a 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 size>usableSize
c3b0: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 72 ){. /* Fr
c3c0: 65 65 20 62 6c 6f 63 6b 73 20 6d 75 73 74 20 62 ee blocks must b
c3d0: 65 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f e in ascending o
c3e0: 72 64 65 72 2e 20 41 6e 64 20 74 68 65 20 6c 61 rder. And the la
c3f0: 73 74 20 62 79 74 65 20 6f 66 0a 20 20 20 20 20 st byte of.
c400: 20 20 20 2a 2a 20 74 68 65 20 66 72 65 65 2d 62 ** the free-b
c410: 6c 6f 63 6b 20 6d 75 73 74 20 6c 69 65 20 6f 6e lock must lie on
c420: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 70 61 the database pa
c430: 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 ge. */.
c440: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
c450: 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 RRUPT_BKPT; .
c460: 20 20 20 7d 0a 20 20 20 20 20 20 6e 46 72 65 65 }. nFree
c470: 20 3d 20 6e 46 72 65 65 20 2b 20 73 69 7a 65 3b = nFree + size;
c480: 0a 20 20 20 20 20 20 70 63 20 3d 20 6e 65 78 74 . pc = next
c490: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
c4a0: 41 74 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 6e At this point, n
c4b0: 46 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 Free contains th
c4c0: 65 20 73 75 6d 20 6f 66 20 74 68 65 20 6f 66 66 e sum of the off
c4d0: 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 set to the start
c4e0: 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 63 . ** of the c
c4f0: 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell-content area
c500: 20 70 6c 75 73 20 74 68 65 20 6e 75 6d 62 65 72 plus the number
c510: 20 6f 66 20 66 72 65 65 20 62 79 74 65 73 20 77 of free bytes w
c520: 69 74 68 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 ithin. ** the
c530: 20 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 cell-content ar
c540: 65 61 2e 20 49 66 20 74 68 69 73 20 69 73 20 67 ea. If this is g
c550: 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 reater than the
c560: 75 73 61 62 6c 65 2d 73 69 7a 65 0a 20 20 20 20 usable-size.
c570: 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 2c 20 ** of the page,
c580: 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 6d 75 then the page mu
c590: 73 74 20 62 65 20 63 6f 72 72 75 70 74 65 64 2e st be corrupted.
c5a0: 20 54 68 69 73 20 63 68 65 63 6b 20 61 6c 73 6f This check also
c5b0: 0a 20 20 20 20 2a 2a 20 73 65 72 76 65 73 20 74 . ** serves t
c5c0: 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 o verify that th
c5d0: 65 20 6f 66 66 73 65 74 20 74 6f 20 74 68 65 20 e offset to the
c5e0: 73 74 61 72 74 20 6f 66 20 74 68 65 20 63 65 6c start of the cel
c5f0: 6c 2d 63 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a l-content. **
c600: 20 61 72 65 61 2c 20 61 63 63 6f 72 64 69 6e 67 area, according
c610: 20 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 61 to the page hea
c620: 64 65 72 2c 20 6c 69 65 73 20 77 69 74 68 69 6e der, lies within
c630: 20 74 68 65 20 70 61 67 65 2e 0a 20 20 20 20 2a the page.. *
c640: 2f 0a 20 20 20 20 69 66 28 20 6e 46 72 65 65 3e /. if( nFree>
c650: 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 usableSize ){.
c660: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
c670: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 E_CORRUPT_BKPT;
c680: 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 . }. pPage
c690: 2d 3e 6e 46 72 65 65 20 3d 20 28 75 31 36 29 28 ->nFree = (u16)(
c6a0: 6e 46 72 65 65 20 2d 20 69 43 65 6c 6c 46 69 72 nFree - iCellFir
c6b0: 73 74 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e st);. pPage->
c6c0: 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 7d 0a isInit = 1;. }.
c6d0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
c6e0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 OK;.}../*.** Set
c6f0: 20 75 70 20 61 20 72 61 77 20 70 61 67 65 20 73 up a raw page s
c700: 6f 20 74 68 61 74 20 69 74 20 6c 6f 6f 6b 73 20 o that it looks
c710: 6c 69 6b 65 20 61 20 64 61 74 61 62 61 73 65 20 like a database
c720: 70 61 67 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 page holding.**
c730: 6e 6f 20 65 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 no entries..*/.s
c740: 74 61 74 69 63 20 76 6f 69 64 20 7a 65 72 6f 50 tatic void zeroP
c750: 61 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 age(MemPage *pPa
c760: 67 65 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a ge, int flags){.
c770: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
c780: 2a 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 *data = pPage->a
c790: 44 61 74 61 3b 0a 20 20 42 74 53 68 61 72 65 64 Data;. BtShared
c7a0: 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 *pBt = pPage->p
c7b0: 42 74 3b 0a 20 20 75 38 20 68 64 72 20 3d 20 70 Bt;. u8 hdr = p
c7c0: 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b Page->hdrOffset;
c7d0: 0a 20 20 75 31 36 20 66 69 72 73 74 3b 0a 0a 20 . u16 first;..
c7e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
c7f0: 50 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 PagerPagenumber(
c800: 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d pPage->pDbPage)=
c810: 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a =pPage->pgno );.
c820: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
c830: 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 3PagerGetExtra(p
c840: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d Page->pDbPage) =
c850: 3d 20 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 = (void*)pPage )
c860: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
c870: 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 te3PagerGetData(
c880: 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
c890: 3d 3d 20 64 61 74 61 20 29 3b 0a 20 20 61 73 73 == data );. ass
c8a0: 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
c8b0: 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
c8c0: 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
c8d0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
c8e0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
c8f0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 ->mutex) );. if
c900: 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ( pBt->btsFlags
c910: 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c & BTS_SECURE_DEL
c920: 45 54 45 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 ETE ){. memse
c930: 74 28 26 64 61 74 61 5b 68 64 72 5d 2c 20 30 2c t(&data[hdr], 0,
c940: 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
c950: 20 2d 20 68 64 72 29 3b 0a 20 20 7d 0a 20 20 64 - hdr);. }. d
c960: 61 74 61 5b 68 64 72 5d 20 3d 20 28 63 68 61 72 ata[hdr] = (char
c970: 29 66 6c 61 67 73 3b 0a 20 20 66 69 72 73 74 20 )flags;. first
c980: 3d 20 68 64 72 20 2b 20 38 20 2b 20 34 2a 28 28 = hdr + 8 + 4*((
c990: 66 6c 61 67 73 26 50 54 46 5f 4c 45 41 46 29 3d flags&PTF_LEAF)=
c9a0: 3d 30 20 3f 31 3a 30 29 3b 0a 20 20 6d 65 6d 73 =0 ?1:0);. mems
c9b0: 65 74 28 26 64 61 74 61 5b 68 64 72 2b 31 5d 2c et(&data[hdr+1],
c9c0: 20 30 2c 20 34 29 3b 0a 20 20 64 61 74 61 5b 68 0, 4);. data[h
c9d0: 64 72 2b 37 5d 20 3d 20 30 3b 0a 20 20 70 75 74 dr+7] = 0;. put
c9e0: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
c9f0: 35 5d 2c 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 5], pBt->usableS
ca00: 69 7a 65 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e ize);. pPage->n
ca10: 46 72 65 65 20 3d 20 28 75 31 36 29 28 70 42 74 Free = (u16)(pBt
ca20: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 66 ->usableSize - f
ca30: 69 72 73 74 29 3b 0a 20 20 64 65 63 6f 64 65 46 irst);. decodeF
ca40: 6c 61 67 73 28 70 50 61 67 65 2c 20 66 6c 61 67 lags(pPage, flag
ca50: 73 29 3b 0a 20 20 70 50 61 67 65 2d 3e 68 64 72 s);. pPage->hdr
ca60: 4f 66 66 73 65 74 20 3d 20 68 64 72 3b 0a 20 20 Offset = hdr;.
ca70: 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
ca80: 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 61 t = first;. pPa
ca90: 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 26 ge->aDataEnd = &
caa0: 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 data[pBt->usable
cab0: 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e Size];. pPage->
cac0: 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 aCellIdx = &data
cad0: 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 65 [first];. pPage
cae0: 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b ->nOverflow = 0;
caf0: 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
cb00: 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 pageSize>=512 &&
cb10: 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d pBt->pageSize<=
cb20: 36 35 35 33 36 20 29 3b 0a 20 20 70 50 61 67 65 65536 );. pPage
cb30: 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 31 ->maskPage = (u1
cb40: 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 6)(pBt->pageSize
cb50: 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 65 2d 3e - 1);. pPage->
cb60: 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 50 61 nCell = 0;. pPa
cb70: 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 3b 0a ge->isInit = 1;.
cb80: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 }.../*.** Conver
cb90: 74 20 61 20 44 62 50 61 67 65 20 6f 62 74 61 69 t a DbPage obtai
cba0: 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 70 61 67 ned from the pag
cbb0: 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d 50 61 67 er into a MemPag
cbc0: 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 74 68 65 e used by.** the
cbd0: 20 62 74 72 65 65 20 6c 61 79 65 72 2e 0a 2a 2f btree layer..*/
cbe0: 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 .static MemPage
cbf0: 2a 62 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 *btreePageFromDb
cc00: 50 61 67 65 28 44 62 50 61 67 65 20 2a 70 44 62 Page(DbPage *pDb
cc10: 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 6e 6f 2c Page, Pgno pgno,
cc20: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b BtShared *pBt){
cc30: 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
cc40: 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 73 71 e = (MemPage*)sq
cc50: 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
cc60: 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 70 ra(pDbPage);. p
cc70: 50 61 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 Page->aData = sq
cc80: 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 lite3PagerGetDat
cc90: 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 70 50 a(pDbPage);. pP
cca0: 61 67 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 70 age->pDbPage = p
ccb0: 44 62 50 61 67 65 3b 0a 20 20 70 50 61 67 65 2d DbPage;. pPage-
ccc0: 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 70 50 >pBt = pBt;. pP
ccd0: 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f age->pgno = pgno
cce0: 3b 0a 20 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 ;. pPage->hdrOf
ccf0: 66 73 65 74 20 3d 20 70 50 61 67 65 2d 3e 70 67 fset = pPage->pg
cd00: 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b no==1 ? 100 : 0;
cd10: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b . return pPage;
cd20: 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 .}../*.** Get a
cd30: 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 page from the p
cd40: 61 67 65 72 2e 20 20 49 6e 69 74 69 61 6c 69 7a ager. Initializ
cd50: 65 20 74 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 e the MemPage.pB
cd60: 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 t and.** MemPage
cd70: 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 .aData elements
cd80: 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2a 0a 2a 2a if needed..**.**
cd90: 20 49 66 20 74 68 65 20 6e 6f 43 6f 6e 74 65 6e If the noConten
cda0: 74 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 69 t flag is set, i
cdb0: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 77 65 20 t means that we
cdc0: 64 6f 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 do not care abou
cdd0: 74 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 t.** the content
cde0: 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 74 20 of the page at
cdf0: 74 68 69 73 20 74 69 6d 65 2e 20 20 53 6f 20 64 this time. So d
ce00: 6f 20 6e 6f 74 20 67 6f 20 74 6f 20 74 68 65 20 o not go to the
ce10: 64 69 73 6b 0a 2a 2a 20 74 6f 20 66 65 74 63 68 disk.** to fetch
ce20: 20 74 68 65 20 63 6f 6e 74 65 6e 74 2e 20 20 4a the content. J
ce30: 75 73 74 20 66 69 6c 6c 20 69 6e 20 74 68 65 20 ust fill in the
ce40: 63 6f 6e 74 65 6e 74 20 77 69 74 68 20 7a 65 72 content with zer
ce50: 6f 73 20 66 6f 72 20 6e 6f 77 2e 0a 2a 2a 20 49 os for now..** I
ce60: 66 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 20 f in the future
ce70: 77 65 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 we call sqlite3P
ce80: 61 67 65 72 57 72 69 74 65 28 29 20 6f 6e 20 74 agerWrite() on t
ce90: 68 69 73 20 70 61 67 65 2c 20 74 68 61 74 0a 2a his page, that.*
cea0: 2a 20 6d 65 61 6e 73 20 77 65 20 68 61 76 65 20 * means we have
ceb0: 73 74 61 72 74 65 64 20 74 6f 20 62 65 20 63 6f started to be co
cec0: 6e 63 65 72 6e 65 64 20 61 62 6f 75 74 20 63 6f ncerned about co
ced0: 6e 74 65 6e 74 20 61 6e 64 20 74 68 65 20 64 69 ntent and the di
cee0: 73 6b 0a 2a 2a 20 72 65 61 64 20 73 68 6f 75 6c sk.** read shoul
cef0: 64 20 6f 63 63 75 72 20 61 74 20 74 68 61 74 20 d occur at that
cf00: 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 point..*/.static
cf10: 20 69 6e 74 20 62 74 72 65 65 47 65 74 50 61 67 int btreeGetPag
cf20: 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 e(. BtShared *p
cf30: 42 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 Bt, /* The
cf40: 20 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f btree */. Pgno
cf50: 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pgno,
cf60: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 /* Number of th
cf70: 65 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 e page to fetch
cf80: 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 */. MemPage **p
cf90: 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 pPage, /* Ret
cfa0: 75 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 urn the page in
cfb0: 74 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a this parameter *
cfc0: 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e /. int noConten
cfd0: 74 2c 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e t, /* Do n
cfe0: 6f 74 20 6c 6f 61 64 20 70 61 67 65 20 63 6f 6e ot load page con
cff0: 74 65 6e 74 20 69 66 20 74 72 75 65 20 2a 2f 0a tent if true */.
d000: 20 20 69 6e 74 20 62 52 65 61 64 6f 6e 6c 79 20 int bReadonly
d010: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
d020: 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 28 6d f a read-only (m
d030: 6d 61 70 29 20 70 61 67 65 20 69 73 20 6f 6b 20 map) page is ok
d040: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a */.){. int rc;.
d050: 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 DbPage *pDbPag
d060: 65 3b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d e;. int flags =
d070: 20 28 6e 6f 43 6f 6e 74 65 6e 74 20 3f 20 50 41 (noContent ? PA
d080: 47 45 52 5f 41 43 51 55 49 52 45 5f 4e 4f 43 4f GER_ACQUIRE_NOCO
d090: 4e 54 45 4e 54 20 3a 20 30 29 20 0a 20 20 20 20 NTENT : 0) .
d0a0: 20 20 20 20 20 20 20 20 7c 20 28 62 52 65 61 64 | (bRead
d0b0: 6f 6e 6c 79 20 3f 20 50 41 47 45 52 5f 41 43 51 only ? PAGER_ACQ
d0c0: 55 49 52 45 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 UIRE_READONLY :
d0d0: 30 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 6e 0);.. assert( n
d0e0: 6f 43 6f 6e 74 65 6e 74 3d 3d 30 20 7c 7c 20 62 oContent==0 || b
d0f0: 52 65 61 64 6f 6e 6c 79 3d 3d 30 20 29 3b 0a 20 Readonly==0 );.
d100: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
d110: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
d120: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 >mutex) );. rc
d130: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 41 63 = sqlite3PagerAc
d140: 71 75 69 72 65 28 70 42 74 2d 3e 70 50 61 67 65 quire(pBt->pPage
d150: 72 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 r, pgno, (DbPage
d160: 2a 2a 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 **)&pDbPage, fla
d170: 67 73 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 gs);. if( rc )
d180: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 return rc;. *pp
d190: 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 Page = btreePage
d1a0: 46 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 FromDbPage(pDbPa
d1b0: 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a ge, pgno, pBt);.
d1c0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d1d0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 OK;.}../*.** Ret
d1e0: 72 69 65 76 65 20 61 20 70 61 67 65 20 66 72 6f rieve a page fro
d1f0: 6d 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 m the pager cach
d200: 65 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 e. If the reques
d210: 74 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a ted page is not.
d220: 2a 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 ** already in th
d230: 65 20 70 61 67 65 72 20 63 61 63 68 65 20 72 65 e pager cache re
d240: 74 75 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 turn NULL. Initi
d250: 61 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 alize the MemPag
d260: 65 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d e.pBt and.** Mem
d270: 50 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 Page.aData eleme
d280: 6e 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a nts if needed..*
d290: 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 /.static MemPage
d2a0: 20 2a 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 *btreePageLooku
d2b0: 70 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c p(BtShared *pBt,
d2c0: 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 Pgno pgno){. D
d2d0: 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a bPage *pDbPage;.
d2e0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
d2f0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
d300: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 ->mutex) );. pD
d310: 62 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 bPage = sqlite3P
d320: 61 67 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e agerLookup(pBt->
d330: 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 pPager, pgno);.
d340: 20 69 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a if( pDbPage ){.
d350: 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 return btree
d360: 50 61 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 PageFromDbPage(p
d370: 44 62 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 DbPage, pgno, pB
d380: 74 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e t);. }. return
d390: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 0;.}../*.** Ret
d3a0: 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 urn the size of
d3b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
d3c0: 65 20 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 e in pages. If t
d3d0: 68 65 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 here is any kind
d3e0: 20 6f 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 of.** error, re
d3f0: 74 75 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 turn ((unsigned
d400: 69 6e 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 int)-1)..*/.stat
d410: 69 63 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 ic Pgno btreePag
d420: 65 63 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 ecount(BtShared
d430: 2a 70 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 *pBt){. return
d440: 70 42 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 pBt->nPage;.}.u3
d450: 32 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 2 sqlite3BtreeLa
d460: 73 74 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 stPage(Btree *p)
d470: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 {. assert( sqli
d480: 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 te3BtreeHoldsMut
d490: 65 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 ex(p) );. asser
d4a0: 74 28 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 t( ((p->pBt->nPa
d4b0: 67 65 29 26 30 78 38 30 30 30 30 30 30 29 3d 3d ge)&0x8000000)==
d4c0: 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 69 0 );. return (i
d4d0: 6e 74 29 62 74 72 65 65 50 61 67 65 63 6f 75 6e nt)btreePagecoun
d4e0: 74 28 70 2d 3e 70 42 74 29 3b 0a 7d 0a 0a 2f 2a t(p->pBt);.}../*
d4f0: 0a 2a 2a 20 47 65 74 20 61 20 70 61 67 65 20 66 .** Get a page f
d500: 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 61 6e rom the pager an
d510: 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 69 74 2e d initialize it.
d520: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 This routine i
d530: 73 20 6a 75 73 74 20 61 0a 2a 2a 20 63 6f 6e 76 s just a.** conv
d540: 65 6e 69 65 6e 63 65 20 77 72 61 70 70 65 72 20 enience wrapper
d550: 61 72 6f 75 6e 64 20 73 65 70 61 72 61 74 65 20 around separate
d560: 63 61 6c 6c 73 20 74 6f 20 62 74 72 65 65 47 65 calls to btreeGe
d570: 74 50 61 67 65 28 29 20 61 6e 64 20 0a 2a 2a 20 tPage() and .**
d580: 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 2e btreeInitPage().
d590: 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 .**.** If an err
d5a0: 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 or occurs, then
d5b0: 74 68 65 20 76 61 6c 75 65 20 2a 70 70 50 61 67 the value *ppPag
d5c0: 65 20 69 73 20 73 65 74 20 74 6f 20 69 73 20 75 e is set to is u
d5d0: 6e 64 65 66 69 6e 65 64 2e 20 49 74 0a 2a 2a 20 ndefined. It.**
d5e0: 6d 61 79 20 72 65 6d 61 69 6e 20 75 6e 63 68 61 may remain uncha
d5f0: 6e 67 65 64 2c 20 6f 72 20 69 74 20 6d 61 79 20 nged, or it may
d600: 62 65 20 73 65 74 20 74 6f 20 61 6e 20 69 6e 76 be set to an inv
d610: 61 6c 69 64 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 alid value..*/.s
d620: 74 61 74 69 63 20 69 6e 74 20 67 65 74 41 6e 64 tatic int getAnd
d630: 49 6e 69 74 50 61 67 65 28 0a 20 20 42 74 53 68 InitPage(. BtSh
d640: 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
d650: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
d660: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
d670: 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c */. Pgno pgno,
d680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d690: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
d6a0: 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f 20 67 of the page to g
d6b0: 65 74 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 et */. MemPage
d6c0: 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 20 **ppPage,
d6d0: 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 /* Write
d6e0: 20 74 68 65 20 70 61 67 65 20 70 6f 69 6e 74 65 the page pointe
d6f0: 72 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 r here */. int
d700: 62 52 65 61 64 6f 6e 6c 79 20 20 20 20 20 20 20 bReadonly
d710: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
d720: 72 75 65 20 69 66 20 61 20 72 65 61 64 2d 6f 6e rue if a read-on
d730: 6c 79 20 28 6d 6d 61 70 29 20 70 61 67 65 20 69 ly (mmap) page i
d740: 73 20 6f 6b 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 s ok */.){. int
d750: 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 73 rc;. assert( s
d760: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
d770: 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
d780: 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 74 72 .. if( pgno>btr
d790: 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 eePagecount(pBt)
d7a0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
d7b0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
d7c0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 ;. }else{. r
d7d0: 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
d7e0: 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 50 61 (pBt, pgno, ppPa
d7f0: 67 65 2c 20 30 2c 20 62 52 65 61 64 6f 6e 6c 79 ge, 0, bReadonly
d800: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
d810: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
d820: 20 20 72 63 20 3d 20 62 74 72 65 65 49 6e 69 74 rc = btreeInit
d830: 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 Page(*ppPage);.
d840: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
d850: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
d860: 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 releasePage(*p
d870: 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a pPage);. }.
d880: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 74 65 73 }. }.. tes
d890: 74 63 61 73 65 28 20 70 67 6e 6f 3d 3d 30 20 29 tcase( pgno==0 )
d8a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f ;. assert( pgno
d8b0: 21 3d 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 !=0 || rc==SQLIT
d8c0: 45 5f 43 4f 52 52 55 50 54 20 29 3b 0a 20 20 72 E_CORRUPT );. r
d8d0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
d8e0: 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 4d 65 6d ** Release a Mem
d8f0: 50 61 67 65 2e 20 20 54 68 69 73 20 73 68 6f 75 Page. This shou
d900: 6c 64 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e 63 ld be called onc
d910: 65 20 66 6f 72 20 65 61 63 68 20 70 72 69 6f 72 e for each prior
d920: 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 .** call to btre
d930: 65 47 65 74 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 eGetPage..*/.sta
d940: 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 tic void release
d950: 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 Page(MemPage *pP
d960: 61 67 65 29 7b 0a 20 20 69 66 28 20 70 50 61 67 age){. if( pPag
d970: 65 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 e ){. assert(
d980: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b pPage->aData );
d990: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
d9a0: 67 65 2d 3e 70 42 74 20 29 3b 0a 20 20 20 20 61 ge->pBt );. a
d9b0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
d9c0: 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 67 gerGetExtra(pPag
d9d0: 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 28 e->pDbPage) == (
d9e0: 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a 20 void*)pPage );.
d9f0: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
da00: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
da10: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d Page->pDbPage)==
da20: 70 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a pPage->aData );.
da30: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
da40: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
da50: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
da60: 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) );. sqlite3
da70: 50 61 67 65 72 55 6e 72 65 66 28 70 50 61 67 65 PagerUnref(pPage
da80: 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 7d 0a ->pDbPage);. }.
da90: 7d 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 }../*.** During
daa0: 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e a rollback, when
dab0: 20 74 68 65 20 70 61 67 65 72 20 72 65 6c 6f 61 the pager reloa
dac0: 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 ds information i
dad0: 6e 74 6f 20 74 68 65 20 63 61 63 68 65 0a 2a 2a nto the cache.**
dae0: 20 73 6f 20 74 68 61 74 20 74 68 65 20 63 61 63 so that the cac
daf0: 68 65 20 69 73 20 72 65 73 74 6f 72 65 64 20 74 he is restored t
db00: 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 o its original s
db10: 74 61 74 65 20 61 74 20 74 68 65 20 73 74 61 72 tate at the star
db20: 74 20 6f 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e t of.** the tran
db30: 73 61 63 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 saction, for eac
db40: 68 20 70 61 67 65 20 72 65 73 74 6f 72 65 64 20 h page restored
db50: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
db60: 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 called..**.** Th
db70: 69 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 is routine needs
db80: 20 74 6f 20 72 65 73 65 74 20 74 68 65 20 65 78 to reset the ex
db90: 74 72 61 20 64 61 74 61 20 73 65 63 74 69 6f 6e tra data section
dba0: 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 at the end of t
dbb0: 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 he.** page to ag
dbc0: 72 65 65 20 77 69 74 68 20 74 68 65 20 72 65 73 ree with the res
dbd0: 74 6f 72 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 tored data..*/.s
dbe0: 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 52 tatic void pageR
dbf0: 65 69 6e 69 74 28 44 62 50 61 67 65 20 2a 70 44 einit(DbPage *pD
dc00: 61 74 61 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 ata){. MemPage
dc10: 2a 70 50 61 67 65 3b 0a 20 20 70 50 61 67 65 20 *pPage;. pPage
dc20: 3d 20 28 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c = (MemPage *)sql
dc30: 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 ite3PagerGetExtr
dc40: 61 28 70 44 61 74 61 29 3b 0a 20 20 61 73 73 65 a(pData);. asse
dc50: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
dc60: 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 PageRefcount(pDa
dc70: 74 61 29 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 ta)>0 );. if( p
dc80: 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a Page->isInit ){.
dc90: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
dca0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
dcb0: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
dcc0: 29 20 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e ) );. pPage->
dcd0: 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 isInit = 0;.
dce0: 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 if( sqlite3Pager
dcf0: 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 PageRefcount(pDa
dd00: 74 61 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f ta)>1 ){. /
dd10: 2a 20 70 50 61 67 65 20 6d 69 67 68 74 20 6e 6f * pPage might no
dd20: 74 20 62 65 20 61 20 62 74 72 65 65 20 70 61 67 t be a btree pag
dd30: 65 3b 20 20 69 74 20 6d 69 67 68 74 20 62 65 20 e; it might be
dd40: 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
dd50: 0a 20 20 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 . ** or ptr
dd60: 6d 61 70 20 70 61 67 65 20 6f 72 20 61 20 66 72 map page or a fr
dd70: 65 65 20 70 61 67 65 2e 20 20 49 6e 20 74 68 6f ee page. In tho
dd80: 73 65 20 63 61 73 65 73 2c 20 74 68 65 20 66 6f se cases, the fo
dd90: 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a llowing. **
dda0: 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e call to btreeIn
ddb0: 69 74 50 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 itPage() will li
ddc0: 6b 65 6c 79 20 72 65 74 75 72 6e 20 53 51 4c 49 kely return SQLI
ddd0: 54 45 5f 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 TE_CORRUPT..
dde0: 20 20 2a 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d ** But no harm
ddf0: 20 69 73 20 64 6f 6e 65 20 62 79 20 74 68 69 73 is done by this
de00: 2e 20 20 41 6e 64 20 69 74 20 69 73 20 76 65 72 . And it is ver
de10: 79 20 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 y important that
de20: 0a 20 20 20 20 20 20 2a 2a 20 62 74 72 65 65 49 . ** btreeI
de30: 6e 69 74 50 61 67 65 28 29 20 62 65 20 63 61 6c nitPage() be cal
de40: 6c 65 64 20 6f 6e 20 65 76 65 72 79 20 62 74 72 led on every btr
de50: 65 65 20 70 61 67 65 20 73 6f 20 77 65 20 6d 61 ee page so we ma
de60: 6b 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 ke. ** the
de70: 63 61 6c 6c 20 66 6f 72 20 65 76 65 72 79 20 70 call for every p
de80: 61 67 65 20 74 68 61 74 20 63 6f 6d 65 73 20 69 age that comes i
de90: 6e 20 66 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 n for re-initing
dea0: 2e 20 2a 2f 0a 20 20 20 20 20 20 62 74 72 65 65 . */. btree
deb0: 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 3b InitPage(pPage);
dec0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a . }. }.}../*
ded0: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 .** Invoke the b
dee0: 75 73 79 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 usy handler for
def0: 61 20 62 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 a btree..*/.stat
df00: 69 63 20 69 6e 74 20 62 74 72 65 65 49 6e 76 6f ic int btreeInvo
df10: 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 76 6f keBusyHandler(vo
df20: 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 id *pArg){. BtS
df30: 68 61 72 65 64 20 2a 70 42 74 20 3d 20 28 42 74 hared *pBt = (Bt
df40: 53 68 61 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 Shared*)pArg;.
df50: 61 73 73 65 72 74 28 20 70 42 74 2d 3e 64 62 20 assert( pBt->db
df60: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
df70: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
df80: 70 42 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 pBt->db->mutex)
df90: 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 );. return sqli
dfa0: 74 65 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e te3InvokeBusyHan
dfb0: 64 6c 65 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 dler(&pBt->db->b
dfc0: 75 73 79 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a usyHandler);.}..
dfd0: 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 /*.** Open a dat
dfe0: 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a abase file..** .
dff0: 2a 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 ** zFilename is
e000: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
e010: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
e020: 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 If zFilename is
e030: 4e 55 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 NULL.** then an
e040: 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 ephemeral databa
e050: 73 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 se is created.
e060: 54 68 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 The ephemeral da
e070: 74 61 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 tabase might.**
e080: 62 65 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 be exclusively i
e090: 6e 20 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 n memory, or it
e0a0: 6d 69 67 68 74 20 75 73 65 20 61 20 64 69 73 6b might use a disk
e0b0: 2d 62 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 -based memory ca
e0c0: 63 68 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 che..** Either w
e0d0: 61 79 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 ay, the ephemera
e0e0: 6c 20 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 l database will
e0f0: 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 be automatically
e100: 20 64 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 deleted .** whe
e110: 6e 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c n sqlite3BtreeCl
e120: 6f 73 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e ose() is called.
e130: 0a 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e .**.** If zFilen
e140: 61 6d 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a ame is ":memory:
e150: 22 20 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d " then an in-mem
e160: 6f 72 79 20 64 61 74 61 62 61 73 65 20 69 73 20 ory database is
e170: 63 72 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 created.** that
e180: 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 is automatically
e190: 20 64 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 destroyed when
e1a0: 69 74 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a it is closed..**
e1b0: 0a 2a 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 .** The "flags"
e1c0: 70 61 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 parameter is a b
e1d0: 69 74 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 itmask that migh
e1e0: 74 20 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c t contain bits l
e1f0: 69 6b 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 ike.** BTREE_OMI
e200: 54 5f 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 T_JOURNAL and/or
e210: 20 42 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a BTREE_MEMORY..*
e220: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 *.** If the data
e230: 62 61 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 base is already
e240: 6f 70 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 opened in the sa
e250: 6d 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e me database conn
e260: 65 63 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 ection.** and we
e270: 20 61 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 are in shared c
e280: 61 63 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 ache mode, then
e290: 74 68 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 the open will fa
e2a0: 69 6c 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 il with an.** SQ
e2b0: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 LITE_CONSTRAINT
e2c0: 65 72 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f error. We canno
e2d0: 74 20 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d t allow two or m
e2e0: 6f 72 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 ore BtShared.**
e2f0: 6f 62 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 objects in the s
e300: 61 6d 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e ame database con
e310: 6e 65 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f nection since do
e320: 69 6e 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 ing so will lead
e330: 0a 2a 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 .** to problems
e340: 77 69 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f with locking..*/
e350: 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
e360: 65 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 eOpen(. sqlite3
e370: 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 _vfs *pVfs,
e380: 20 2f 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 /* VFS to use f
e390: 6f 72 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a or this b-tree *
e3a0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
e3b0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e zFilename, /* N
e3c0: 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 ame of the file
e3d0: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 containing the B
e3e0: 54 72 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f Tree database */
e3f0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
e400: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 /* As
e410: 73 6f 63 69 61 74 65 64 20 64 61 74 61 62 61 73 sociated databas
e420: 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 e handle */. Bt
e430: 72 65 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 ree **ppBtree,
e440: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
e450: 20 74 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 to new Btree ob
e460: 6a 65 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 ject written her
e470: 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 e */. int flags
e480: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
e490: 2a 20 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 * Options */. i
e4a0: 6e 74 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 nt vfsFlags
e4b0: 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 /* Flags
e4c0: 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 passed through t
e4d0: 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f o sqlite3_vfs.xO
e4e0: 70 65 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 pen() */.){. Bt
e4f0: 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b Shared *pBt = 0;
e500: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
e510: 53 68 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 Shared part of b
e520: 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 2a tree structure *
e530: 2f 0a 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 /. Btree *p;
e540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e550: 20 20 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 /* Handle to
e560: 72 65 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 return */. sqli
e570: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
e580: 4f 70 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 Open = 0; /* Pr
e590: 65 76 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f events a race co
e5a0: 6e 64 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 ndition. Ticket
e5b0: 23 33 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 #3537 */. int r
e5c0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
e5d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 /* Res
e5e0: 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 ult code from th
e5f0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 is function */.
e600: 20 75 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 u8 nReserve;
e610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e620: 2f 2a 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 /* Byte of unuse
e630: 64 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 d space on each
e640: 70 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e page */. unsign
e650: 65 64 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 ed char zDbHeade
e660: 72 5b 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 r[100]; /* Data
e670: 62 61 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 base header cont
e680: 65 6e 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 ent */.. /* Tru
e690: 65 20 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 e if opening an
e6a0: 65 70 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f ephemeral, tempo
e6b0: 72 61 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f rary database */
e6c0: 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 . const int isT
e6d0: 65 6d 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d empDb = zFilenam
e6e0: 65 3d 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d e==0 || zFilenam
e6f0: 65 5b 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 e[0]==0;.. /* S
e700: 65 74 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 et the variable
e710: 69 73 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 isMemdb to true
e720: 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 for an in-memory
e730: 20 64 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 database, or .
e740: 20 2a 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 ** false for a
e750: 66 69 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 file-based datab
e760: 61 73 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 ase.. */.#ifdef
e770: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d SQLITE_OMIT_MEM
e780: 4f 52 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e ORYDB. const in
e790: 74 20 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 t isMemdb = 0;.#
e7a0: 65 6c 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 else. const int
e7b0: 20 69 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c isMemdb = (zFil
e7c0: 65 6e 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 ename && strcmp(
e7d0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d zFilename, ":mem
e7e0: 6f 72 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 ory:")==0).
e7f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e800: 20 20 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 || (isTempDb &
e810: 26 20 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d & sqlite3TempInM
e820: 65 6d 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 emory(db)).
e830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e840: 20 20 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 || (vfsFlags &
e850: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d SQLITE_OPEN_MEM
e860: 4f 52 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a ORY)!=0;.#endif.
e870: 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 . assert( db!=0
e880: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 );. assert( pV
e890: 66 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 fs!=0 );. asser
e8a0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
e8b0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 _held(db->mutex)
e8c0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 );. assert( (f
e8d0: 6c 61 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 lags&0xff)==flag
e8e0: 73 20 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 s ); /* flags
e8f0: 66 69 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f fit in 8 bits */
e900: 0a 0a 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 .. /* Only a BT
e910: 52 45 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 REE_SINGLE datab
e920: 61 73 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 ase can be BTREE
e930: 5f 55 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 _UNORDERED */.
e940: 61 73 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 assert( (flags &
e950: 20 42 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 BTREE_UNORDERED
e960: 29 3d 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 )==0 || (flags &
e970: 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d BTREE_SINGLE)!=
e980: 30 20 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 0 );.. /* A BTR
e990: 45 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 EE_SINGLE databa
e9a0: 73 65 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 se is always a t
e9b0: 65 6d 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 emporary and/or
e9c0: 65 70 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 ephemeral */. a
e9d0: 73 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 ssert( (flags &
e9e0: 42 54 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 BTREE_SINGLE)==0
e9f0: 20 7c 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a || isTempDb );.
ea00: 0a 20 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 . if( isMemdb )
ea10: 7b 0a 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 {. flags |= B
ea20: 54 52 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d TREE_MEMORY;. }
ea30: 0a 20 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 . if( (vfsFlags
ea40: 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d & SQLITE_OPEN_M
ea50: 41 49 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 AIN_DB)!=0 && (i
ea60: 73 4d 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 sMemdb || isTemp
ea70: 44 62 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c Db) ){. vfsFl
ea80: 61 67 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 ags = (vfsFlags
ea90: 26 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d & ~SQLITE_OPEN_M
eaa0: 41 49 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 AIN_DB) | SQLITE
eab0: 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 _OPEN_TEMP_DB;.
eac0: 20 7d 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 }. p = sqlite3
ead0: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f MallocZero(sizeo
eae0: 66 28 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 f(Btree));. if(
eaf0: 20 21 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 !p ){. retur
eb00: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a n SQLITE_NOMEM;.
eb10: 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 61 6e 73 }. p->inTrans
eb20: 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 = TRANS_NONE;.
eb30: 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a 23 69 66 p->db = db;.#if
eb40: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
eb50: 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 _SHARED_CACHE.
eb60: 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 20 3d p->lock.pBtree =
eb70: 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 69 54 p;. p->lock.iT
eb80: 61 62 6c 65 20 3d 20 31 3b 0a 23 65 6e 64 69 66 able = 1;.#endif
eb90: 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 ..#if !defined(S
eba0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
ebb0: 44 5f 43 41 43 48 45 29 20 26 26 20 21 64 65 66 D_CACHE) && !def
ebc0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
ebd0: 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 0a 20 20 _DISKIO). /*.
ebe0: 2a 2a 20 49 66 20 74 68 69 73 20 42 74 72 65 65 ** If this Btree
ebf0: 20 69 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 is a candidate
ec00: 66 6f 72 20 73 68 61 72 65 64 20 63 61 63 68 65 for shared cache
ec10: 2c 20 74 72 79 20 74 6f 20 66 69 6e 64 20 61 6e , try to find an
ec20: 0a 20 20 2a 2a 20 65 78 69 73 74 69 6e 67 20 42 . ** existing B
ec30: 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 20 74 tShared object t
ec40: 68 61 74 20 77 65 20 63 61 6e 20 73 68 61 72 65 hat we can share
ec50: 20 77 69 74 68 0a 20 20 2a 2f 0a 20 20 69 66 28 with. */. if(
ec60: 20 69 73 54 65 6d 70 44 62 3d 3d 30 20 26 26 20 isTempDb==0 &&
ec70: 28 69 73 4d 65 6d 64 62 3d 3d 30 20 7c 7c 20 28 (isMemdb==0 || (
ec80: 76 66 73 46 6c 61 67 73 26 53 51 4c 49 54 45 5f vfsFlags&SQLITE_
ec90: 4f 50 45 4e 5f 55 52 49 29 21 3d 30 29 20 29 7b OPEN_URI)!=0) ){
eca0: 0a 20 20 20 20 69 66 28 20 76 66 73 46 6c 61 67 . if( vfsFlag
ecb0: 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
ecc0: 53 48 41 52 45 44 43 41 43 48 45 20 29 7b 0a 20 SHAREDCACHE ){.
ecd0: 20 20 20 20 20 69 6e 74 20 6e 46 75 6c 6c 50 61 int nFullPa
ece0: 74 68 6e 61 6d 65 20 3d 20 70 56 66 73 2d 3e 6d thname = pVfs->m
ecf0: 78 50 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 20 xPathname+1;.
ed00: 20 20 20 63 68 61 72 20 2a 7a 46 75 6c 6c 50 61 char *zFullPa
ed10: 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 thname = sqlite3
ed20: 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c 50 61 74 68 Malloc(nFullPath
ed30: 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 4d 55 54 name);. MUT
ed40: 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 EX_LOGIC( sqlite
ed50: 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 3_mutex *mutexSh
ed60: 61 72 65 64 3b 20 29 0a 20 20 20 20 20 20 70 2d ared; ). p-
ed70: 3e 73 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 >sharable = 1;.
ed80: 20 20 20 20 20 69 66 28 20 21 7a 46 75 6c 6c 50 if( !zFullP
ed90: 61 74 68 6e 61 6d 65 20 29 7b 0a 20 20 20 20 20 athname ){.
eda0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
edb0: 70 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 p);. retu
edc0: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
edd0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
ede0: 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 f( isMemdb ){.
edf0: 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a 46 75 memcpy(zFu
ee00: 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 7a 46 69 6c llPathname, zFil
ee10: 65 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33 53 74 ename, sqlite3St
ee20: 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 rlen30(zFilename
ee30: 29 2b 31 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 )+1);. }els
ee40: 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 e{. rc =
ee50: 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 sqlite3OsFullPat
ee60: 68 6e 61 6d 65 28 70 56 66 73 2c 20 7a 46 69 6c hname(pVfs, zFil
ee70: 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 ename,.
ee80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ee90: 20 20 20 20 20 20 20 20 20 20 6e 46 75 6c 6c 50 nFullP
eea0: 61 74 68 6e 61 6d 65 2c 20 7a 46 75 6c 6c 50 61 athname, zFullPa
eeb0: 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 thname);.
eec0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 if( rc ){.
eed0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
eee0: 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 e(zFullPathname)
eef0: 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 ;. sqli
ef00: 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 te3_free(p);.
ef10: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
ef20: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
ef30: 20 20 7d 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 }.#if SQLITE_T
ef40: 48 52 45 41 44 53 41 46 45 0a 20 20 20 20 20 20 HREADSAFE.
ef50: 6d 75 74 65 78 4f 70 65 6e 20 3d 20 73 71 6c 69 mutexOpen = sqli
ef60: 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
ef70: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
ef80: 43 5f 4f 50 45 4e 29 3b 0a 20 20 20 20 20 20 73 C_OPEN);. s
ef90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
efa0: 65 72 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 er(mutexOpen);.
efb0: 20 20 20 20 20 6d 75 74 65 78 53 68 61 72 65 64 mutexShared
efc0: 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 = sqlite3MutexA
efd0: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
efe0: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 X_STATIC_MASTER)
eff0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
f000: 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
f010: 78 53 68 61 72 65 64 29 3b 0a 23 65 6e 64 69 66 xShared);.#endif
f020: 0a 20 20 20 20 20 20 66 6f 72 28 70 42 74 3d 47 . for(pBt=G
f030: 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c LOBAL(BtShared*,
f040: 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 sqlite3SharedCac
f050: 68 65 4c 69 73 74 29 3b 20 70 42 74 3b 20 70 42 heList); pBt; pB
f060: 74 3d 70 42 74 2d 3e 70 4e 65 78 74 29 7b 0a 20 t=pBt->pNext){.
f070: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 assert( p
f080: 42 74 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20 Bt->nRef>0 );.
f090: 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 74 72 if( 0==str
f0a0: 63 6d 70 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d cmp(zFullPathnam
f0b0: 65 2c 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 e, sqlite3PagerF
f0c0: 69 6c 65 6e 61 6d 65 28 70 42 74 2d 3e 70 50 61 ilename(pBt->pPa
f0d0: 67 65 72 2c 20 30 29 29 0a 20 20 20 20 20 20 20 ger, 0)).
f0e0: 20 20 20 20 20 20 20 20 20 20 26 26 20 73 71 6c && sql
f0f0: 69 74 65 33 50 61 67 65 72 56 66 73 28 70 42 74 ite3PagerVfs(pBt
f100: 2d 3e 70 50 61 67 65 72 29 3d 3d 70 56 66 73 20 ->pPager)==pVfs
f110: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 ){. int
f120: 20 69 44 62 3b 0a 20 20 20 20 20 20 20 20 20 20 iDb;.
f130: 66 6f 72 28 69 44 62 3d 64 62 2d 3e 6e 44 62 2d for(iDb=db->nDb-
f140: 31 3b 20 69 44 62 3e 3d 30 3b 20 69 44 62 2d 2d 1; iDb>=0; iDb--
f150: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 42 ){. B
f160: 74 72 65 65 20 2a 70 45 78 69 73 74 69 6e 67 20 tree *pExisting
f170: 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 = db->aDb[iDb].p
f180: 42 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 Bt;.
f190: 69 66 28 20 70 45 78 69 73 74 69 6e 67 20 26 26 if( pExisting &&
f1a0: 20 70 45 78 69 73 74 69 6e 67 2d 3e 70 42 74 3d pExisting->pBt=
f1b0: 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 =pBt ){.
f1c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
f1d0: 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 tex_leave(mutexS
f1e0: 68 61 72 65 64 29 3b 0a 20 20 20 20 20 20 20 20 hared);.
f1f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
f200: 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 4f tex_leave(mutexO
f210: 70 65 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20 pen);.
f220: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
f230: 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b (zFullPathname);
f240: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
f250: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
f260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
f270: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 turn SQLITE_CONS
f280: 54 52 41 49 4e 54 3b 0a 20 20 20 20 20 20 20 20 TRAINT;.
f290: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
f2a0: 7d 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 }. p->p
f2b0: 42 74 20 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 Bt = pBt;.
f2c0: 20 20 20 20 70 42 74 2d 3e 6e 52 65 66 2b 2b 3b pBt->nRef++;
f2d0: 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b . break
f2e0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
f2f0: 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 }. sqlite
f300: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 3_mutex_leave(mu
f310: 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 texShared);.
f320: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a sqlite3_free(z
f330: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 FullPathname);.
f340: 20 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 }.#ifdef SQLI
f350: 54 45 5f 44 45 42 55 47 0a 20 20 20 20 65 6c 73 TE_DEBUG. els
f360: 65 7b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 20 64 e{. /* In d
f370: 65 62 75 67 20 6d 6f 64 65 2c 20 77 65 20 6d 61 ebug mode, we ma
f380: 72 6b 20 61 6c 6c 20 70 65 72 73 69 73 74 65 6e rk all persisten
f390: 74 20 64 61 74 61 62 61 73 65 73 20 61 73 20 73 t databases as s
f3a0: 68 61 72 61 62 6c 65 0a 20 20 20 20 20 20 2a 2a harable. **
f3b0: 20 65 76 65 6e 20 77 68 65 6e 20 74 68 65 79 20 even when they
f3c0: 61 72 65 20 6e 6f 74 2e 20 20 54 68 69 73 20 65 are not. This e
f3d0: 78 65 72 63 69 73 65 73 20 74 68 65 20 6c 6f 63 xercises the loc
f3e0: 6b 69 6e 67 20 63 6f 64 65 20 61 6e 64 0a 20 20 king code and.
f3f0: 20 20 20 20 2a 2a 20 67 69 76 65 73 20 6d 6f 72 ** gives mor
f400: 65 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 66 6f e opportunity fo
f410: 72 20 61 73 73 65 72 74 73 28 73 71 6c 69 74 65 r asserts(sqlite
f420: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 29 29 0a 3_mutex_held()).
f430: 20 20 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 ** stateme
f440: 6e 74 73 20 74 6f 20 66 69 6e 64 20 6c 6f 63 6b nts to find lock
f450: 69 6e 67 20 70 72 6f 62 6c 65 6d 73 2e 0a 20 20 ing problems..
f460: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 70 2d 3e */. p->
f470: 73 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 20 sharable = 1;.
f480: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 23 }.#endif. }.#
f490: 65 6e 64 69 66 0a 20 20 69 66 28 20 70 42 74 3d endif. if( pBt=
f4a0: 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 0a 20 20 20 =0 ){. /*.
f4b0: 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e ** The followin
f4c0: 67 20 61 73 73 65 72 74 73 20 6d 61 6b 65 20 73 g asserts make s
f4d0: 75 72 65 20 74 68 61 74 20 73 74 72 75 63 74 75 ure that structu
f4e0: 72 65 73 20 75 73 65 64 20 62 79 20 74 68 65 20 res used by the
f4f0: 62 74 72 65 65 20 61 72 65 0a 20 20 20 20 2a 2a btree are. **
f500: 20 74 68 65 20 72 69 67 68 74 20 73 69 7a 65 2e the right size.
f510: 20 20 54 68 69 73 20 69 73 20 74 6f 20 67 75 61 This is to gua
f520: 72 64 20 61 67 61 69 6e 73 74 20 73 69 7a 65 20 rd against size
f530: 63 68 61 6e 67 65 73 20 74 68 61 74 20 72 65 73 changes that res
f540: 75 6c 74 0a 20 20 20 20 2a 2a 20 77 68 65 6e 20 ult. ** when
f550: 63 6f 6d 70 69 6c 69 6e 67 20 6f 6e 20 61 20 64 compiling on a d
f560: 69 66 66 65 72 65 6e 74 20 61 72 63 68 69 74 65 ifferent archite
f570: 63 74 75 72 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 cture.. */.
f580: 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
f590: 28 69 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 (i64)==8 || size
f5a0: 6f 66 28 69 36 34 29 3d 3d 34 20 29 3b 0a 20 20 of(i64)==4 );.
f5b0: 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
f5c0: 28 75 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 (u64)==8 || size
f5d0: 6f 66 28 75 36 34 29 3d 3d 34 20 29 3b 0a 20 20 of(u64)==4 );.
f5e0: 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
f5f0: 28 75 33 32 29 3d 3d 34 20 29 3b 0a 20 20 20 20 (u32)==4 );.
f600: 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 assert( sizeof(u
f610: 31 36 29 3d 3d 32 20 29 3b 0a 20 20 20 20 61 73 16)==2 );. as
f620: 73 65 72 74 28 20 73 69 7a 65 6f 66 28 50 67 6e sert( sizeof(Pgn
f630: 6f 29 3d 3d 34 20 29 3b 0a 20 20 0a 20 20 20 20 o)==4 );. .
f640: 70 42 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c pBt = sqlite3Mal
f650: 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 locZero( sizeof(
f660: 2a 70 42 74 29 20 29 3b 0a 20 20 20 20 69 66 28 *pBt) );. if(
f670: 20 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 pBt==0 ){.
f680: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
f690: 45 4d 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 EM;. goto b
f6a0: 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 tree_open_out;.
f6b0: 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 }. rc = sq
f6c0: 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e 28 70 lite3PagerOpen(p
f6d0: 56 66 73 2c 20 26 70 42 74 2d 3e 70 50 61 67 65 Vfs, &pBt->pPage
f6e0: 72 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 r, zFilename,.
f6f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f700: 20 20 20 20 20 20 20 20 45 58 54 52 41 5f 53 49 EXTRA_SI
f710: 5a 45 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c ZE, flags, vfsFl
f720: 61 67 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 ags, pageReinit)
f730: 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
f740: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
f750: 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 sqlite3PagerSet
f760: 4d 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 MmapLimit(pBt->p
f770: 50 61 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 Pager, db->szMma
f780: 70 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 p);. rc = s
f790: 71 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 qlite3PagerReadF
f7a0: 69 6c 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 ileheader(pBt->p
f7b0: 50 61 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 Pager,sizeof(zDb
f7c0: 48 65 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 Header),zDbHeade
f7d0: 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 r);. }. if
f7e0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
f7f0: 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 ){. goto bt
f800: 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 ree_open_out;.
f810: 20 20 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 }. pBt->ope
f820: 6e 46 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 nFlags = (u8)fla
f830: 67 73 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 gs;. pBt->db
f840: 3d 20 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 = db;. sqlite
f850: 33 50 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 3PagerSetBusyhan
f860: 64 6c 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 dler(pBt->pPager
f870: 2c 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 , btreeInvokeBus
f880: 79 48 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a yHandler, pBt);.
f890: 20 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 p->pBt = pBt
f8a0: 3b 0a 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 ;. . pBt->pC
f8b0: 75 72 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 ursor = 0;. p
f8c0: 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a Bt->pPage1 = 0;.
f8d0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 if( sqlite3P
f8e0: 61 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 agerIsreadonly(p
f8f0: 42 74 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 Bt->pPager) ) pB
f900: 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
f910: 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 TS_READ_ONLY;.#i
f920: 66 64 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 fdef SQLITE_SECU
f930: 52 45 5f 44 45 4c 45 54 45 0a 20 20 20 20 70 42 RE_DELETE. pB
f940: 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
f950: 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 TS_SECURE_DELETE
f960: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 42 74 ;.#endif. pBt
f970: 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 7a 44 ->pageSize = (zD
f980: 62 48 65 61 64 65 72 5b 31 36 5d 3c 3c 38 29 20 bHeader[16]<<8)
f990: 7c 20 28 7a 44 62 48 65 61 64 65 72 5b 31 37 5d | (zDbHeader[17]
f9a0: 3c 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 20 70 <<16);. if( p
f9b0: 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 35 31 32 Bt->pageSize<512
f9c0: 20 7c 7c 20 70 42 74 2d 3e 70 61 67 65 53 69 7a || pBt->pageSiz
f9d0: 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 e>SQLITE_MAX_PAG
f9e0: 45 5f 53 49 5a 45 0a 20 20 20 20 20 20 20 20 20 E_SIZE.
f9f0: 7c 7c 20 28 28 70 42 74 2d 3e 70 61 67 65 53 69 || ((pBt->pageSi
fa00: 7a 65 2d 31 29 26 70 42 74 2d 3e 70 61 67 65 53 ze-1)&pBt->pageS
fa10: 69 7a 65 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 ize)!=0 ){.
fa20: 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d pBt->pageSize =
fa30: 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 0;.#ifndef SQLI
fa40: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
fa50: 55 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 UM. /* If t
fa60: 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a he magic name ":
fa70: 6d 65 6d 6f 72 79 3a 22 20 77 69 6c 6c 20 63 72 memory:" will cr
fa80: 65 61 74 65 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 eate an in-memor
fa90: 79 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e y database, then
faa0: 0a 20 20 20 20 20 20 2a 2a 20 6c 65 61 76 65 20 . ** leave
fab0: 74 68 65 20 61 75 74 6f 56 61 63 75 75 6d 20 6d the autoVacuum m
fac0: 6f 64 65 20 61 74 20 30 20 28 64 6f 20 6e 6f 74 ode at 0 (do not
fad0: 20 61 75 74 6f 2d 76 61 63 75 75 6d 29 2c 20 65 auto-vacuum), e
fae0: 76 65 6e 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 ven if. **
faf0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 SQLITE_DEFAULT_A
fb00: 55 54 4f 56 41 43 55 55 4d 20 69 73 20 74 72 75 UTOVACUUM is tru
fb10: 65 2e 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 e. On the other
fb20: 68 61 6e 64 2c 20 69 66 0a 20 20 20 20 20 20 2a hand, if. *
fb30: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 * SQLITE_OMIT_ME
fb40: 4d 4f 52 59 44 42 20 68 61 73 20 62 65 65 6e 20 MORYDB has been
fb50: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 22 3a defined, then ":
fb60: 6d 65 6d 6f 72 79 3a 22 20 69 73 20 6a 75 73 74 memory:" is just
fb70: 20 61 0a 20 20 20 20 20 20 2a 2a 20 72 65 67 75 a. ** regu
fb80: 6c 61 72 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 49 lar file-name. I
fb90: 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 n this case the
fba0: 61 75 74 6f 2d 76 61 63 75 75 6d 20 61 70 70 6c auto-vacuum appl
fbb0: 69 65 73 20 61 73 20 70 65 72 20 6e 6f 72 6d 61 ies as per norma
fbc0: 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 l.. */.
fbd0: 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 if( zFilename
fbe0: 26 26 20 21 69 73 4d 65 6d 64 62 20 29 7b 0a 20 && !isMemdb ){.
fbf0: 20 20 20 20 20 20 20 70 42 74 2d 3e 61 75 74 6f pBt->auto
fc00: 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 Vacuum = (SQLITE
fc10: 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 _DEFAULT_AUTOVAC
fc20: 55 55 4d 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 UUM ? 1 : 0);.
fc30: 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 pBt->incrV
fc40: 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f acuum = (SQLITE_
fc50: 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 DEFAULT_AUTOVACU
fc60: 55 4d 3d 3d 32 20 3f 20 31 20 3a 20 30 29 3b 0a UM==2 ? 1 : 0);.
fc70: 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }.#endif.
fc80: 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d 20 nReserve =
fc90: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 0;. }else{.
fca0: 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d 20 7a nReserve = z
fcb0: 44 62 48 65 61 64 65 72 5b 32 30 5d 3b 0a 20 20 DbHeader[20];.
fcc0: 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
fcd0: 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a s |= BTS_PAGESIZ
fce0: 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 E_FIXED;.#ifndef
fcf0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
fd00: 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 70 42 OVACUUM. pB
fd10: 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 t->autoVacuum =
fd20: 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 (get4byte(&zDbHe
fd30: 61 64 65 72 5b 33 36 20 2b 20 34 2a 34 5d 29 3f ader[36 + 4*4])?
fd40: 31 3a 30 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 1:0);. pBt-
fd50: 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 >incrVacuum = (g
fd60: 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 61 64 et4byte(&zDbHead
fd70: 65 72 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 3a er[36 + 7*4])?1:
fd80: 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0);.#endif. }
fd90: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
fda0: 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
fdb0: 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 e(pBt->pPager, &
fdc0: 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e pBt->pageSize, n
fdd0: 52 65 73 65 72 76 65 29 3b 0a 20 20 20 20 69 66 Reserve);. if
fde0: 28 20 72 63 20 29 20 67 6f 74 6f 20 62 74 72 65 ( rc ) goto btre
fdf0: 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 e_open_out;.
fe00: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
fe10: 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 = pBt->pageSize
fe20: 2d 20 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 - nReserve;.
fe30: 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e 70 61 assert( (pBt->pa
fe40: 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 geSize & 7)==0 )
fe50: 3b 20 20 2f 2a 20 38 2d 62 79 74 65 20 61 6c 69 ; /* 8-byte ali
fe60: 67 6e 6d 65 6e 74 20 6f 66 20 70 61 67 65 53 69 gnment of pageSi
fe70: 7a 65 20 2a 2f 0a 20 20 20 0a 23 69 66 20 21 64 ze */. .#if !d
fe80: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
fe90: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 29 IT_SHARED_CACHE)
fea0: 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c && !defined(SQL
feb0: 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 ITE_OMIT_DISKIO)
fec0: 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 . /* Add the
fed0: 6e 65 77 20 42 74 53 68 61 72 65 64 20 6f 62 6a new BtShared obj
fee0: 65 63 74 20 74 6f 20 74 68 65 20 6c 69 6e 6b 65 ect to the linke
fef0: 64 20 6c 69 73 74 20 73 68 61 72 61 62 6c 65 20 d list sharable
ff00: 42 74 53 68 61 72 65 64 73 2e 0a 20 20 20 20 2a BtShareds.. *
ff10: 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 73 68 61 /. if( p->sha
ff20: 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 4d rable ){. M
ff30: 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 UTEX_LOGIC( sqli
ff40: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
ff50: 53 68 61 72 65 64 3b 20 29 0a 20 20 20 20 20 20 Shared; ).
ff60: 70 42 74 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 pBt->nRef = 1;.
ff70: 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 MUTEX_LOGIC
ff80: 28 20 6d 75 74 65 78 53 68 61 72 65 64 20 3d 20 ( mutexShared =
ff90: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
ffa0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
ffb0: 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 29 0a TATIC_MASTER);).
ffc0: 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 if( SQLITE
ffd0: 5f 54 48 52 45 41 44 53 41 46 45 20 26 26 20 73 _THREADSAFE && s
ffe0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
fff0: 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b ig.bCoreMutex ){
10000 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 6d 75 . pBt->mu
10010 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 tex = sqlite3Mut
10020 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
10030 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 UTEX_FAST);.
10040 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6d 75 74 if( pBt->mut
10050 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ex==0 ){.
10060 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
10070 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 OMEM;.
10080 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
10090 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
100a0 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f goto btree_open_
100b0 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 out;. }.
100c0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
100d0 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
100e0 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 (mutexShared);.
100f0 20 20 20 20 20 70 42 74 2d 3e 70 4e 65 78 74 20 pBt->pNext
10100 3d 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 = GLOBAL(BtShare
10110 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 d*,sqlite3Shared
10120 43 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 CacheList);.
10130 20 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 GLOBAL(BtShare
10140 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 d*,sqlite3Shared
10150 43 61 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 CacheList) = pBt
10160 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
10170 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 mutex_leave(mute
10180 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 7d 0a xShared);. }.
10190 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 23 69 66 20 #endif. }..#if
101a0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
101b0 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
101c0 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 E) && !defined(S
101d0 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 QLITE_OMIT_DISKI
101e0 4f 29 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 6e O). /* If the n
101f0 65 77 20 42 74 72 65 65 20 75 73 65 73 20 61 20 ew Btree uses a
10200 73 68 61 72 61 62 6c 65 20 70 42 74 53 68 61 72 sharable pBtShar
10210 65 64 2c 20 74 68 65 6e 20 6c 69 6e 6b 20 74 68 ed, then link th
10220 65 20 6e 65 77 0a 20 20 2a 2a 20 42 74 72 65 65 e new. ** Btree
10230 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 20 6f into the list o
10240 66 20 61 6c 6c 20 73 68 61 72 61 62 6c 65 20 42 f all sharable B
10250 74 72 65 65 73 20 66 6f 72 20 74 68 65 20 73 61 trees for the sa
10260 6d 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 20 me connection..
10270 20 2a 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 ** The list is
10280 6b 65 70 74 20 69 6e 20 61 73 63 65 6e 64 69 6e kept in ascendin
10290 67 20 6f 72 64 65 72 20 62 79 20 70 42 74 20 61 g order by pBt a
102a0 64 64 72 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 69 ddress.. */. i
102b0 66 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 f( p->sharable )
102c0 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 {. int i;.
102d0 20 42 74 72 65 65 20 2a 70 53 69 62 3b 0a 20 20 Btree *pSib;.
102e0 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d for(i=0; i<db-
102f0 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 >nDb; i++){.
10300 20 20 69 66 28 20 28 70 53 69 62 20 3d 20 64 62 if( (pSib = db
10310 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 21 3d 30 ->aDb[i].pBt)!=0
10320 20 26 26 20 70 53 69 62 2d 3e 73 68 61 72 61 62 && pSib->sharab
10330 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 77 68 le ){. wh
10340 69 6c 65 28 20 70 53 69 62 2d 3e 70 50 72 65 76 ile( pSib->pPrev
10350 20 29 7b 20 70 53 69 62 20 3d 20 70 53 69 62 2d ){ pSib = pSib-
10360 3e 70 50 72 65 76 3b 20 7d 0a 20 20 20 20 20 20 >pPrev; }.
10370 20 20 69 66 28 20 70 2d 3e 70 42 74 3c 70 53 69 if( p->pBt<pSi
10380 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 b->pBt ){.
10390 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 p->pNext = p
103a0 53 69 62 3b 0a 20 20 20 20 20 20 20 20 20 20 70 Sib;. p
103b0 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 ->pPrev = 0;.
103c0 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 50 72 pSib->pPr
103d0 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 ev = p;.
103e0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
103f0 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 4e while( pSib->pN
10400 65 78 74 20 26 26 20 70 53 69 62 2d 3e 70 4e 65 ext && pSib->pNe
10410 78 74 2d 3e 70 42 74 3c 70 2d 3e 70 42 74 20 29 xt->pBt<p->pBt )
10420 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 53 {. pS
10430 69 62 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 ib = pSib->pNext
10440 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
10450 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
10460 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a = pSib->pNext;.
10470 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 50 72 p->pPr
10480 65 76 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 ev = pSib;.
10490 20 20 20 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 if( p->pNex
104a0 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
104b0 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 p->pNext->pPrev
104c0 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 20 20 = p;.
104d0 7d 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 }. pSib
104e0 2d 3e 70 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 ->pNext = p;.
104f0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 62 }. b
10500 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
10510 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
10520 20 2a 70 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a *ppBtree = p;..
10530 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a btree_open_out:.
10540 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
10550 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
10560 42 74 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 Bt && pBt->pPage
10570 72 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 r ){. sqlit
10580 65 33 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 e3PagerClose(pBt
10590 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 7d ->pPager);. }
105a0 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
105b0 65 28 70 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 e(pBt);. sqli
105c0 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 te3_free(p);.
105d0 20 2a 70 70 42 74 72 65 65 20 3d 20 30 3b 0a 20 *ppBtree = 0;.
105e0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 }else{. /* I
105f0 66 20 74 68 65 20 42 2d 54 72 65 65 20 77 61 73 f the B-Tree was
10600 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 successfully op
10610 65 6e 65 64 2c 20 73 65 74 20 74 68 65 20 70 61 ened, set the pa
10620 67 65 72 2d 63 61 63 68 65 20 73 69 7a 65 20 74 ger-cache size t
10630 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 65 66 o the. ** def
10640 61 75 6c 74 20 76 61 6c 75 65 2e 20 45 78 63 65 ault value. Exce
10650 70 74 2c 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 pt, when opening
10660 20 6f 6e 20 61 6e 20 65 78 69 73 74 69 6e 67 20 on an existing
10670 73 68 61 72 65 64 20 70 61 67 65 72 2d 63 61 63 shared pager-cac
10680 68 65 2c 0a 20 20 20 20 2a 2a 20 64 6f 20 6e 6f he,. ** do no
10690 74 20 63 68 61 6e 67 65 20 74 68 65 20 70 61 67 t change the pag
106a0 65 72 2d 63 61 63 68 65 20 73 69 7a 65 2e 0a 20 er-cache size..
106b0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 */. if( sq
106c0 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 6d 61 lite3BtreeSchema
106d0 28 70 2c 20 30 2c 20 30 29 3d 3d 30 20 29 7b 0a (p, 0, 0)==0 ){.
106e0 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
106f0 65 72 53 65 74 43 61 63 68 65 73 69 7a 65 28 70 erSetCachesize(p
10700 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 ->pBt->pPager, S
10710 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 QLITE_DEFAULT_CA
10720 43 48 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d CHE_SIZE);. }
10730 0a 20 20 7d 0a 20 20 69 66 28 20 6d 75 74 65 78 . }. if( mutex
10740 4f 70 65 6e 20 29 7b 0a 20 20 20 20 61 73 73 65 Open ){. asse
10750 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
10760 78 5f 68 65 6c 64 28 6d 75 74 65 78 4f 70 65 6e x_held(mutexOpen
10770 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) );. sqlite3
10780 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 _mutex_leave(mut
10790 65 78 4f 70 65 6e 29 3b 0a 20 20 7d 0a 20 20 72 exOpen);. }. r
107a0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
107b0 2a 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 ** Decrement the
107c0 20 42 74 53 68 61 72 65 64 2e 6e 52 65 66 20 63 BtShared.nRef c
107d0 6f 75 6e 74 65 72 2e 20 20 57 68 65 6e 20 69 74 ounter. When it
107e0 20 72 65 61 63 68 65 73 20 7a 65 72 6f 2c 0a 2a reaches zero,.*
107f0 2a 20 72 65 6d 6f 76 65 20 74 68 65 20 42 74 53 * remove the BtS
10800 68 61 72 65 64 20 73 74 72 75 63 74 75 72 65 20 hared structure
10810 66 72 6f 6d 20 74 68 65 20 73 68 61 72 69 6e 67 from the sharing
10820 20 6c 69 73 74 2e 20 20 52 65 74 75 72 6e 0a 2a list. Return.*
10830 2a 20 74 72 75 65 20 69 66 20 74 68 65 20 42 74 * true if the Bt
10840 53 68 61 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e Shared.nRef coun
10850 74 65 72 20 72 65 61 63 68 65 73 20 7a 65 72 6f ter reaches zero
10860 20 61 6e 64 20 72 65 74 75 72 6e 0a 2a 2a 20 66 and return.** f
10870 61 6c 73 65 20 69 66 20 69 74 20 69 73 20 73 74 alse if it is st
10880 69 6c 6c 20 70 6f 73 69 74 69 76 65 2e 0a 2a 2f ill positive..*/
10890 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 6d 6f .static int remo
108a0 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c 69 73 veFromSharingLis
108b0 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 t(BtShared *pBt)
108c0 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
108d0 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
108e0 48 45 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 HE. MUTEX_LOGIC
108f0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 ( sqlite3_mutex
10900 2a 70 4d 61 73 74 65 72 3b 20 29 0a 20 20 42 74 *pMaster; ). Bt
10910 53 68 61 72 65 64 20 2a 70 4c 69 73 74 3b 0a 20 Shared *pList;.
10920 20 69 6e 74 20 72 65 6d 6f 76 65 64 20 3d 20 30 int removed = 0
10930 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
10940 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 ite3_mutex_nothe
10950 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
10960 3b 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 ;. MUTEX_LOGIC(
10970 20 70 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 74 pMaster = sqlit
10980 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c e3MutexAlloc(SQL
10990 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 ITE_MUTEX_STATIC
109a0 5f 4d 41 53 54 45 52 29 3b 20 29 0a 20 20 73 71 _MASTER); ). sq
109b0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
109c0 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 70 42 r(pMaster);. pB
109d0 74 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 t->nRef--;. if(
109e0 20 70 42 74 2d 3e 6e 52 65 66 3c 3d 30 20 29 7b pBt->nRef<=0 ){
109f0 0a 20 20 20 20 69 66 28 20 47 4c 4f 42 41 4c 28 . if( GLOBAL(
10a00 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 BtShared*,sqlite
10a10 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 3SharedCacheList
10a20 29 3d 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 20 )==pBt ){.
10a30 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a GLOBAL(BtShared*
10a40 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 ,sqlite3SharedCa
10a50 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 2d 3e cheList) = pBt->
10a60 70 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c 73 65 pNext;. }else
10a70 7b 0a 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 {. pList =
10a80 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a GLOBAL(BtShared*
10a90 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 ,sqlite3SharedCa
10aa0 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 cheList);.
10ab0 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 70 4c while( ALWAYS(pL
10ac0 69 73 74 29 20 26 26 20 70 4c 69 73 74 2d 3e 70 ist) && pList->p
10ad0 4e 65 78 74 21 3d 70 42 74 20 29 7b 0a 20 20 20 Next!=pBt ){.
10ae0 20 20 20 20 20 70 4c 69 73 74 3d 70 4c 69 73 74 pList=pList
10af0 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d ->pNext;. }
10b00 0a 20 20 20 20 20 20 69 66 28 20 41 4c 57 41 59 . if( ALWAY
10b10 53 28 70 4c 69 73 74 29 20 29 7b 0a 20 20 20 20 S(pList) ){.
10b20 20 20 20 20 70 4c 69 73 74 2d 3e 70 4e 65 78 74 pList->pNext
10b30 20 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 = pBt->pNext;.
10b40 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
10b50 20 69 66 28 20 53 51 4c 49 54 45 5f 54 48 52 45 if( SQLITE_THRE
10b60 41 44 53 41 46 45 20 29 7b 0a 20 20 20 20 20 20 ADSAFE ){.
10b70 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 sqlite3_mutex_fr
10b80 65 65 28 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a ee(pBt->mutex);.
10b90 20 20 20 20 7d 0a 20 20 20 20 72 65 6d 6f 76 65 }. remove
10ba0 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71 6c d = 1;. }. sql
10bb0 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
10bc0 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72 65 74 (pMaster);. ret
10bd0 75 72 6e 20 72 65 6d 6f 76 65 64 3b 0a 23 65 6c urn removed;.#el
10be0 73 65 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 se. return 1;.#
10bf0 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d endif.}../*.** M
10c00 61 6b 65 20 73 75 72 65 20 70 42 74 2d 3e 70 54 ake sure pBt->pT
10c10 6d 70 53 70 61 63 65 20 70 6f 69 6e 74 73 20 74 mpSpace points t
10c20 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 o an allocation
10c30 6f 66 20 0a 2a 2a 20 4d 58 5f 43 45 4c 4c 5f 53 of .** MX_CELL_S
10c40 49 5a 45 28 70 42 74 29 20 62 79 74 65 73 2e 0a IZE(pBt) bytes..
10c50 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61 */.static void a
10c60 6c 6c 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 llocateTempSpace
10c70 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
10c80 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 70 54 6d . if( !pBt->pTm
10c90 70 53 70 61 63 65 20 29 7b 0a 20 20 20 20 70 42 pSpace ){. pB
10ca0 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 73 t->pTmpSpace = s
10cb0 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 qlite3PageMalloc
10cc0 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 ( pBt->pageSize
10cd0 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 );. }.}../*.**
10ce0 46 72 65 65 20 74 68 65 20 70 42 74 2d 3e 70 54 Free the pBt->pT
10cf0 6d 70 53 70 61 63 65 20 61 6c 6c 6f 63 61 74 69 mpSpace allocati
10d00 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 on.*/.static voi
10d10 64 20 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 d freeTempSpace(
10d20 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
10d30 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 sqlite3PageFre
10d40 65 28 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 e( pBt->pTmpSpac
10d50 65 29 3b 0a 20 20 70 42 74 2d 3e 70 54 6d 70 53 e);. pBt->pTmpS
10d60 70 61 63 65 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a pace = 0;.}../*.
10d70 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 6f 70 65 6e ** Close an open
10d80 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 69 6e database and in
10d90 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 63 75 72 validate all cur
10da0 73 6f 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c sors..*/.int sql
10db0 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 42 ite3BtreeClose(B
10dc0 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 tree *p){. BtSh
10dd0 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
10de0 42 74 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a Bt;. BtCursor *
10df0 70 43 75 72 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 pCur;.. /* Clos
10e00 65 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 e all cursors op
10e10 65 6e 65 64 20 76 69 61 20 74 68 69 73 20 68 61 ened via this ha
10e20 6e 64 6c 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 ndle. */. asse
10e30 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
10e40 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 x_held(p->db->mu
10e50 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
10e60 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
10e70 20 20 70 43 75 72 20 3d 20 70 42 74 2d 3e 70 43 pCur = pBt->pC
10e80 75 72 73 6f 72 3b 0a 20 20 77 68 69 6c 65 28 20 ursor;. while(
10e90 70 43 75 72 20 29 7b 0a 20 20 20 20 42 74 43 75 pCur ){. BtCu
10ea0 72 73 6f 72 20 2a 70 54 6d 70 20 3d 20 70 43 75 rsor *pTmp = pCu
10eb0 72 3b 0a 20 20 20 20 70 43 75 72 20 3d 20 70 43 r;. pCur = pC
10ec0 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 ur->pNext;. i
10ed0 66 28 20 70 54 6d 70 2d 3e 70 42 74 72 65 65 3d f( pTmp->pBtree=
10ee0 3d 70 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 =p ){. sqli
10ef0 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 te3BtreeCloseCur
10f00 73 6f 72 28 70 54 6d 70 29 3b 0a 20 20 20 20 7d sor(pTmp);. }
10f10 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 . }.. /* Rollb
10f20 61 63 6b 20 61 6e 79 20 61 63 74 69 76 65 20 74 ack any active t
10f30 72 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 66 ransaction and f
10f40 72 65 65 20 74 68 65 20 68 61 6e 64 6c 65 20 73 ree the handle s
10f50 74 72 75 63 74 75 72 65 2e 0a 20 20 2a 2a 20 54 tructure.. ** T
10f60 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 he call to sqlit
10f70 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 e3BtreeRollback(
10f80 29 20 64 72 6f 70 73 20 61 6e 79 20 74 61 62 6c ) drops any tabl
10f90 65 2d 6c 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a e-locks held by.
10fa0 20 20 2a 2a 20 74 68 69 73 20 68 61 6e 64 6c 65 ** this handle
10fb0 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
10fc0 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c BtreeRollback(p,
10fd0 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 73 SQLITE_OK);. s
10fe0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
10ff0 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 (p);.. /* If th
11000 65 72 65 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 ere are still ot
11010 68 65 72 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 her outstanding
11020 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 references to th
11030 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 0a 20 e shared-btree.
11040 20 2a 2a 20 73 74 72 75 63 74 75 72 65 2c 20 72 ** structure, r
11050 65 74 75 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 eturn now. The r
11060 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 69 73 emainder of this
11070 20 70 72 6f 63 65 64 75 72 65 20 63 6c 65 61 6e procedure clean
11080 73 20 0a 20 20 2a 2a 20 75 70 20 74 68 65 20 73 s . ** up the s
11090 68 61 72 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a hared-btree.. *
110a0 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 /. assert( p->w
110b0 61 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 antToLock==0 &&
110c0 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a p->locked==0 );.
110d0 20 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 if( !p->sharab
110e0 6c 65 20 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d le || removeFrom
110f0 53 68 61 72 69 6e 67 4c 69 73 74 28 70 42 74 29 SharingList(pBt)
11100 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 ){. /* The p
11110 42 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 Bt is no longer
11120 6f 6e 20 74 68 65 20 73 68 61 72 69 6e 67 20 6c on the sharing l
11130 69 73 74 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 ist, so we can a
11140 63 63 65 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 ccess. ** it
11150 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 without having t
11160 6f 20 68 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 o hold the mutex
11170 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
11180 43 6c 65 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 Clean out and de
11190 6c 65 74 65 20 74 68 65 20 42 74 53 68 61 72 65 lete the BtShare
111a0 64 20 6f 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f d object.. */
111b0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 42 . assert( !pB
111c0 74 2d 3e 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 t->pCursor );.
111d0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c sqlite3PagerCl
111e0 6f 73 65 28 70 42 74 2d 3e 70 50 61 67 65 72 29 ose(pBt->pPager)
111f0 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 78 ;. if( pBt->x
11200 46 72 65 65 53 63 68 65 6d 61 20 26 26 20 70 42 FreeSchema && pB
11210 74 2d 3e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 t->pSchema ){.
11220 20 20 20 20 70 42 74 2d 3e 78 46 72 65 65 53 63 pBt->xFreeSc
11230 68 65 6d 61 28 70 42 74 2d 3e 70 53 63 68 65 6d hema(pBt->pSchem
11240 61 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 a);. }. sq
11250 6c 69 74 65 33 44 62 46 72 65 65 28 30 2c 20 70 lite3DbFree(0, p
11260 42 74 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 Bt->pSchema);.
11270 20 20 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 freeTempSpace(
11280 70 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 pBt);. sqlite
11290 33 5f 66 72 65 65 28 70 42 74 29 3b 0a 20 20 7d 3_free(pBt);. }
112a0 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
112b0 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
112c0 48 45 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e HE. assert( p->
112d0 77 61 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 20 29 3b wantToLock==0 );
112e0 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f . assert( p->lo
112f0 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 cked==0 );. if(
11300 20 70 2d 3e 70 50 72 65 76 20 29 20 70 2d 3e 70 p->pPrev ) p->p
11310 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d Prev->pNext = p-
11320 3e 70 4e 65 78 74 3b 0a 20 20 69 66 28 20 70 2d >pNext;. if( p-
11330 3e 70 4e 65 78 74 20 29 20 70 2d 3e 70 4e 65 78 >pNext ) p->pNex
11340 74 2d 3e 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 t->pPrev = p->pP
11350 72 65 76 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 rev;.#endif.. s
11360 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
11370 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
11380 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 OK;.}../*.** Cha
11390 6e 67 65 20 74 68 65 20 6c 69 6d 69 74 20 6f 6e nge the limit on
113a0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 the number of p
113b0 61 67 65 73 20 61 6c 6c 6f 77 65 64 20 69 6e 20 ages allowed in
113c0 74 68 65 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a the cache..**.**
113d0 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d The maximum num
113e0 62 65 72 20 6f 66 20 63 61 63 68 65 20 70 61 67 ber of cache pag
113f0 65 73 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 es is set to the
11400 20 61 62 73 6f 6c 75 74 65 0a 2a 2a 20 76 61 6c absolute.** val
11410 75 65 20 6f 66 20 6d 78 50 61 67 65 2e 20 20 49 ue of mxPage. I
11420 66 20 6d 78 50 61 67 65 20 69 73 20 6e 65 67 61 f mxPage is nega
11430 74 69 76 65 2c 20 74 68 65 20 70 61 67 65 72 20 tive, the pager
11440 77 69 6c 6c 0a 2a 2a 20 6f 70 65 72 61 74 65 20 will.** operate
11450 61 73 79 6e 63 68 72 6f 6e 6f 75 73 6c 79 20 2d asynchronously -
11460 20 69 74 20 77 69 6c 6c 20 6e 6f 74 20 73 74 6f it will not sto
11470 70 20 74 6f 20 64 6f 20 66 73 79 6e 63 28 29 73 p to do fsync()s
11480 0a 2a 2a 20 74 6f 20 69 6e 73 75 72 65 20 64 61 .** to insure da
11490 74 61 20 69 73 20 77 72 69 74 74 65 6e 20 74 6f ta is written to
114a0 20 74 68 65 20 64 69 73 6b 20 73 75 72 66 61 63 the disk surfac
114b0 65 20 62 65 66 6f 72 65 0a 2a 2a 20 63 6f 6e 74 e before.** cont
114c0 69 6e 75 69 6e 67 2e 20 20 54 72 61 6e 73 61 63 inuing. Transac
114d0 74 69 6f 6e 73 20 73 74 69 6c 6c 20 77 6f 72 6b tions still work
114e0 20 69 66 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 if synchronous
114f0 69 73 20 6f 66 66 2c 0a 2a 2a 20 61 6e 64 20 74 is off,.** and t
11500 68 65 20 64 61 74 61 62 61 73 65 20 63 61 6e 6e he database cann
11510 6f 74 20 62 65 20 63 6f 72 72 75 70 74 65 64 20 ot be corrupted
11520 69 66 20 74 68 69 73 20 70 72 6f 67 72 61 6d 0a if this program.
11530 2a 2a 20 63 72 61 73 68 65 73 2e 20 20 42 75 74 ** crashes. But
11540 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69 6e if the operatin
11550 67 20 73 79 73 74 65 6d 20 63 72 61 73 68 65 73 g system crashes
11560 20 6f 72 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 or there is.**
11570 61 6e 20 61 62 72 75 70 74 20 70 6f 77 65 72 20 an abrupt power
11580 66 61 69 6c 75 72 65 20 77 68 65 6e 20 73 79 6e failure when syn
11590 63 68 72 6f 6e 6f 75 73 20 69 73 20 6f 66 66 2c chronous is off,
115a0 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a the database.**
115b0 20 63 6f 75 6c 64 20 62 65 20 6c 65 66 74 20 69 could be left i
115c0 6e 20 61 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e n an inconsisten
115d0 74 20 61 6e 64 20 75 6e 72 65 63 6f 76 65 72 61 t and unrecovera
115e0 62 6c 65 20 73 74 61 74 65 2e 0a 2a 2a 20 53 79 ble state..** Sy
115f0 6e 63 68 72 6f 6e 6f 75 73 20 69 73 20 6f 6e 20 nchronous is on
11600 62 79 20 64 65 66 61 75 6c 74 20 73 6f 20 64 61 by default so da
11610 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
11620 6e 20 69 73 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d n is not.** norm
11630 61 6c 6c 79 20 61 20 77 6f 72 72 79 2e 0a 2a 2f ally a worry..*/
11640 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
11650 65 53 65 74 43 61 63 68 65 53 69 7a 65 28 42 74 eSetCacheSize(Bt
11660 72 65 65 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 ree *p, int mxPa
11670 67 65 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 ge){. BtShared
11680 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
11690 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
116a0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 _mutex_held(p->d
116b0 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
116c0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
116d0 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 (p);. sqlite3Pa
116e0 67 65 72 53 65 74 43 61 63 68 65 73 69 7a 65 28 gerSetCachesize(
116f0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 pBt->pPager, mxP
11700 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 age);. sqlite3B
11710 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
11720 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
11730 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
11740 65 20 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 e the limit on t
11750 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 68 65 he amount of the
11760 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
11770 68 61 74 20 6d 61 79 20 62 65 0a 2a 2a 20 6d 65 hat may be.** me
11780 6d 6f 72 79 20 6d 61 70 70 65 64 2e 0a 2a 2f 0a mory mapped..*/.
11790 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
117a0 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 42 74 72 SetMmapLimit(Btr
117b0 65 65 20 2a 70 2c 20 73 71 6c 69 74 65 33 5f 69 ee *p, sqlite3_i
117c0 6e 74 36 34 20 73 7a 4d 6d 61 70 29 7b 0a 20 20 nt64 szMmap){.
117d0 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
117e0 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 p->pBt;. assert
117f0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
11800 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 held(p->db->mute
11810 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 x) );. sqlite3B
11820 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
11830 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d sqlite3PagerSetM
11840 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 mapLimit(pBt->pP
11850 61 67 65 72 2c 20 73 7a 4d 6d 61 70 29 3b 0a 20 ager, szMmap);.
11860 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
11870 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
11880 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
11890 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 77 .** Change the w
118a0 61 79 20 64 61 74 61 20 69 73 20 73 79 6e 63 65 ay data is synce
118b0 64 20 74 6f 20 64 69 73 6b 20 69 6e 20 6f 72 64 d to disk in ord
118c0 65 72 20 74 6f 20 69 6e 63 72 65 61 73 65 20 6f er to increase o
118d0 72 20 64 65 63 72 65 61 73 65 0a 2a 2a 20 68 6f r decrease.** ho
118e0 77 20 77 65 6c 6c 20 74 68 65 20 64 61 74 61 62 w well the datab
118f0 61 73 65 20 72 65 73 69 73 74 73 20 64 61 6d 61 ase resists dama
11900 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72 61 ge due to OS cra
11910 73 68 65 73 20 61 6e 64 20 70 6f 77 65 72 0a 2a shes and power.*
11920 2a 20 66 61 69 6c 75 72 65 73 2e 20 20 4c 65 76 * failures. Lev
11930 65 6c 20 31 20 69 73 20 74 68 65 20 73 61 6d 65 el 1 is the same
11940 20 61 73 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 as asynchronous
11950 20 28 6e 6f 20 73 79 6e 63 73 28 29 20 6f 63 63 (no syncs() occ
11960 75 72 20 61 6e 64 0a 2a 2a 20 74 68 65 72 65 20 ur and.** there
11970 69 73 20 61 20 68 69 67 68 20 70 72 6f 62 61 62 is a high probab
11980 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 65 29 ility of damage)
11990 20 20 4c 65 76 65 6c 20 32 20 69 73 20 74 68 65 Level 2 is the
119a0 20 64 65 66 61 75 6c 74 2e 20 20 54 68 65 72 65 default. There
119b0 0a 2a 2a 20 69 73 20 61 20 76 65 72 79 20 6c 6f .** is a very lo
119c0 77 20 62 75 74 20 6e 6f 6e 2d 7a 65 72 6f 20 70 w but non-zero p
119d0 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 robability of da
119e0 6d 61 67 65 2e 20 20 4c 65 76 65 6c 20 33 20 72 mage. Level 3 r
119f0 65 64 75 63 65 73 20 74 68 65 0a 2a 2a 20 70 72 educes the.** pr
11a00 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d obability of dam
11a10 61 67 65 20 74 6f 20 6e 65 61 72 20 7a 65 72 6f age to near zero
11a20 20 62 75 74 20 77 69 74 68 20 61 20 77 72 69 74 but with a writ
11a30 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 72 65 e performance re
11a40 64 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e duction..*/.#ifn
11a50 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
11a60 50 41 47 45 52 5f 50 52 41 47 4d 41 53 0a 69 6e PAGER_PRAGMAS.in
11a70 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
11a80 74 50 61 67 65 72 46 6c 61 67 73 28 0a 20 20 42 tPagerFlags(. B
11a90 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 tree *p,
11aa0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 /* The btr
11ab0 65 65 20 74 6f 20 73 65 74 20 74 68 65 20 73 61 ee to set the sa
11ac0 66 65 74 79 20 6c 65 76 65 6c 20 6f 6e 20 2a 2f fety level on */
11ad0 0a 20 20 75 6e 73 69 67 6e 65 64 20 70 67 46 6c . unsigned pgFl
11ae0 61 67 73 20 20 20 20 20 20 20 2f 2a 20 56 61 72 ags /* Var
11af0 69 6f 75 73 20 50 41 47 45 52 5f 2a 20 66 6c 61 ious PAGER_* fla
11b00 67 73 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 gs */.){. BtSha
11b10 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
11b20 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c t;. assert( sql
11b30 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
11b40 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b p->db->mutex) );
11b50 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
11b60 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 nter(p);. sqlit
11b70 65 33 50 61 67 65 72 53 65 74 46 6c 61 67 73 28 e3PagerSetFlags(
11b80 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 46 pBt->pPager, pgF
11b90 6c 61 67 73 29 3b 0a 20 20 73 71 6c 69 74 65 33 lags);. sqlite3
11ba0 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
11bb0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
11bc0 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a K;.}.#endif../*.
11bd0 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 ** Return TRUE i
11be0 66 20 74 68 65 20 67 69 76 65 6e 20 62 74 72 65 f the given btre
11bf0 65 20 69 73 20 73 65 74 20 74 6f 20 73 61 66 65 e is set to safe
11c00 74 79 20 6c 65 76 65 6c 20 31 2e 20 20 49 6e 20 ty level 1. In
11c10 6f 74 68 65 72 0a 2a 2a 20 77 6f 72 64 73 2c 20 other.** words,
11c20 72 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 6e return TRUE if n
11c30 6f 20 73 79 6e 63 28 29 20 6f 63 63 75 72 73 20 o sync() occurs
11c40 6f 6e 20 74 68 65 20 64 69 73 6b 20 66 69 6c 65 on the disk file
11c50 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
11c60 33 42 74 72 65 65 53 79 6e 63 44 69 73 61 62 6c 3BtreeSyncDisabl
11c70 65 64 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ed(Btree *p){.
11c80 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
11c90 70 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 20 72 63 p->pBt;. int rc
11ca0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
11cb0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
11cc0 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 20 ->db->mutex) );
11cd0 20 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 . sqlite3Btree
11ce0 45 6e 74 65 72 28 70 29 3b 0a 20 20 61 73 73 65 Enter(p);. asse
11cf0 72 74 28 20 70 42 74 20 26 26 20 70 42 74 2d 3e rt( pBt && pBt->
11d00 70 50 61 67 65 72 20 29 3b 0a 20 20 72 63 20 3d pPager );. rc =
11d10 20 73 71 6c 69 74 65 33 50 61 67 65 72 4e 6f 73 sqlite3PagerNos
11d20 79 6e 63 28 70 42 74 2d 3e 70 50 61 67 65 72 29 ync(pBt->pPager)
11d30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
11d40 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
11d50 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
11d60 43 68 61 6e 67 65 20 74 68 65 20 64 65 66 61 75 Change the defau
11d70 6c 74 20 70 61 67 65 73 20 73 69 7a 65 20 61 6e lt pages size an
11d80 64 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 d the number of
11d90 72 65 73 65 72 76 65 64 20 62 79 74 65 73 20 70 reserved bytes p
11da0 65 72 20 70 61 67 65 2e 0a 2a 2a 20 4f 72 2c 20 er page..** Or,
11db0 69 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 if the page size
11dc0 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 has already bee
11dd0 6e 20 66 69 78 65 64 2c 20 72 65 74 75 72 6e 20 n fixed, return
11de0 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 SQLITE_READONLY
11df0 0a 2a 2a 20 77 69 74 68 6f 75 74 20 63 68 61 6e .** without chan
11e00 67 69 6e 67 20 61 6e 79 74 68 69 6e 67 2e 0a 2a ging anything..*
11e10 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 73 69 *.** The page si
11e20 7a 65 20 6d 75 73 74 20 62 65 20 61 20 70 6f 77 ze must be a pow
11e30 65 72 20 6f 66 20 32 20 62 65 74 77 65 65 6e 20 er of 2 between
11e40 35 31 32 20 61 6e 64 20 36 35 35 33 36 2e 20 20 512 and 65536.
11e50 49 66 20 74 68 65 20 70 61 67 65 0a 2a 2a 20 73 If the page.** s
11e60 69 7a 65 20 73 75 70 70 6c 69 65 64 20 64 6f 65 ize supplied doe
11e70 73 20 6e 6f 74 20 6d 65 65 74 20 74 68 69 73 20 s not meet this
11e80 63 6f 6e 73 74 72 61 69 6e 74 20 74 68 65 6e 20 constraint then
11e90 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 the page size is
11ea0 20 6e 6f 74 0a 2a 2a 20 63 68 61 6e 67 65 64 2e not.** changed.
11eb0 0a 2a 2a 0a 2a 2a 20 50 61 67 65 20 73 69 7a 65 .**.** Page size
11ec0 73 20 61 72 65 20 63 6f 6e 73 74 72 61 69 6e 65 s are constraine
11ed0 64 20 74 6f 20 62 65 20 61 20 70 6f 77 65 72 20 d to be a power
11ee0 6f 66 20 74 77 6f 20 73 6f 20 74 68 61 74 20 74 of two so that t
11ef0 68 65 20 72 65 67 69 6f 6e 0a 2a 2a 20 6f 66 20 he region.** of
11f00 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
11f10 65 20 75 73 65 64 20 66 6f 72 20 6c 6f 63 6b 69 e used for locki
11f20 6e 67 20 28 62 65 67 69 6e 6e 69 6e 67 20 61 74 ng (beginning at
11f30 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 0a 2a PENDING_BYTE,.*
11f40 2a 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 * the first byte
11f50 20 70 61 73 74 20 74 68 65 20 31 47 42 20 62 6f past the 1GB bo
11f60 75 6e 64 61 72 79 2c 20 30 78 34 30 30 30 30 30 undary, 0x400000
11f70 30 30 29 20 6e 65 65 64 73 20 74 6f 20 6f 63 63 00) needs to occ
11f80 75 72 0a 2a 2a 20 61 74 20 74 68 65 20 62 65 67 ur.** at the beg
11f90 69 6e 6e 69 6e 67 20 6f 66 20 61 20 70 61 67 65 inning of a page
11fa0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 72 61 6d ..**.** If param
11fb0 65 74 65 72 20 6e 52 65 73 65 72 76 65 20 69 73 eter nReserve is
11fc0 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f 2c less than zero,
11fd0 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 then the number
11fe0 20 6f 66 20 72 65 73 65 72 76 65 64 0a 2a 2a 20 of reserved.**
11ff0 62 79 74 65 73 20 70 65 72 20 70 61 67 65 20 69 bytes per page i
12000 73 20 6c 65 66 74 20 75 6e 63 68 61 6e 67 65 64 s left unchanged
12010 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 ..**.** If the i
12020 46 69 78 21 3d 30 20 74 68 65 6e 20 74 68 65 20 Fix!=0 then the
12030 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 BTS_PAGESIZE_FIX
12040 45 44 20 66 6c 61 67 20 69 73 20 73 65 74 20 73 ED flag is set s
12050 6f 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 o that the page
12060 73 69 7a 65 0a 2a 2a 20 61 6e 64 20 61 75 74 6f size.** and auto
12070 76 61 63 75 75 6d 20 6d 6f 64 65 20 63 61 6e 20 vacuum mode can
12080 6e 6f 20 6c 6f 6e 67 65 72 20 62 65 20 63 68 61 no longer be cha
12090 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c nged..*/.int sql
120a0 69 74 65 33 42 74 72 65 65 53 65 74 50 61 67 65 ite3BtreeSetPage
120b0 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 69 Size(Btree *p, i
120c0 6e 74 20 70 61 67 65 53 69 7a 65 2c 20 69 6e 74 nt pageSize, int
120d0 20 6e 52 65 73 65 72 76 65 2c 20 69 6e 74 20 69 nReserve, int i
120e0 46 69 78 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d Fix){. int rc =
120f0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 42 74 SQLITE_OK;. Bt
12100 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
12110 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 >pBt;. assert(
12120 6e 52 65 73 65 72 76 65 3e 3d 2d 31 20 26 26 20 nReserve>=-1 &&
12130 6e 52 65 73 65 72 76 65 3c 3d 32 35 35 20 29 3b nReserve<=255 );
12140 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
12150 6e 74 65 72 28 70 29 3b 0a 20 20 69 66 28 20 70 nter(p);. if( p
12160 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
12170 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 TS_PAGESIZE_FIXE
12180 44 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 D ){. sqlite3
12190 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
121a0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
121b0 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 7d 0a 20 _READONLY;. }.
121c0 20 69 66 28 20 6e 52 65 73 65 72 76 65 3c 30 20 if( nReserve<0
121d0 29 7b 0a 20 20 20 20 6e 52 65 73 65 72 76 65 20 ){. nReserve
121e0 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 = pBt->pageSize
121f0 2d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a - pBt->usableSiz
12200 65 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 e;. }. assert(
12210 20 6e 52 65 73 65 72 76 65 3e 3d 30 20 26 26 20 nReserve>=0 &&
12220 6e 52 65 73 65 72 76 65 3c 3d 32 35 35 20 29 3b nReserve<=255 );
12230 0a 20 20 69 66 28 20 70 61 67 65 53 69 7a 65 3e . if( pageSize>
12240 3d 35 31 32 20 26 26 20 70 61 67 65 53 69 7a 65 =512 && pageSize
12250 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 <=SQLITE_MAX_PAG
12260 45 5f 53 49 5a 45 20 26 26 0a 20 20 20 20 20 20 E_SIZE &&.
12270 20 20 28 28 70 61 67 65 53 69 7a 65 2d 31 29 26 ((pageSize-1)&
12280 70 61 67 65 53 69 7a 65 29 3d 3d 30 20 29 7b 0a pageSize)==0 ){.
12290 20 20 20 20 61 73 73 65 72 74 28 20 28 70 61 67 assert( (pag
122a0 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b eSize & 7)==0 );
122b0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 42 . assert( !pB
122c0 74 2d 3e 70 50 61 67 65 31 20 26 26 20 21 70 42 t->pPage1 && !pB
122d0 74 2d 3e 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 t->pCursor );.
122e0 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 pBt->pageSize
122f0 3d 20 28 75 33 32 29 70 61 67 65 53 69 7a 65 3b = (u32)pageSize;
12300 0a 20 20 20 20 66 72 65 65 54 65 6d 70 53 70 61 . freeTempSpa
12310 63 65 28 70 42 74 29 3b 0a 20 20 7d 0a 20 20 72 ce(pBt);. }. r
12320 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
12330 53 65 74 50 61 67 65 73 69 7a 65 28 70 42 74 2d SetPagesize(pBt-
12340 3e 70 50 61 67 65 72 2c 20 26 70 42 74 2d 3e 70 >pPager, &pBt->p
12350 61 67 65 53 69 7a 65 2c 20 6e 52 65 73 65 72 76 ageSize, nReserv
12360 65 29 3b 0a 20 20 70 42 74 2d 3e 75 73 61 62 6c e);. pBt->usabl
12370 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 70 61 67 eSize = pBt->pag
12380 65 53 69 7a 65 20 2d 20 28 75 31 36 29 6e 52 65 eSize - (u16)nRe
12390 73 65 72 76 65 3b 0a 20 20 69 66 28 20 69 46 69 serve;. if( iFi
123a0 78 20 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 x ) pBt->btsFlag
123b0 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a s |= BTS_PAGESIZ
123c0 45 5f 46 49 58 45 44 3b 0a 20 20 73 71 6c 69 74 E_FIXED;. sqlit
123d0 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
123e0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
123f0 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
12400 65 20 63 75 72 72 65 6e 74 6c 79 20 64 65 66 69 e currently defi
12410 6e 65 64 20 70 61 67 65 20 73 69 7a 65 0a 2a 2f ned page size.*/
12420 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
12430 65 47 65 74 50 61 67 65 53 69 7a 65 28 42 74 72 eGetPageSize(Btr
12440 65 65 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e ee *p){. return
12450 20 70 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a p->pBt->pageSiz
12460 65 3b 0a 7d 0a 0a 23 69 66 20 64 65 66 69 6e 65 e;.}..#if define
12470 64 28 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 d(SQLITE_HAS_COD
12480 45 43 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 EC) || defined(S
12490 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f 2a 0a QLITE_DEBUG)./*.
124a0 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
124b0 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 73 is similar to s
124c0 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 52 65 qlite3BtreeGetRe
124d0 73 65 72 76 65 28 29 2c 20 65 78 63 65 70 74 20 serve(), except
124e0 74 68 61 74 20 69 74 0a 2a 2a 20 6d 61 79 20 6f that it.** may o
124f0 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 69 66 nly be called if
12500 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 it is guarantee
12510 64 20 74 68 61 74 20 74 68 65 20 62 2d 74 72 65 d that the b-tre
12520 65 20 6d 75 74 65 78 20 69 73 20 61 6c 72 65 61 e mutex is alrea
12530 64 79 0a 2a 2a 20 68 65 6c 64 2e 0a 2a 2a 0a 2a dy.** held..**.*
12540 2a 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c * This is useful
12550 20 69 6e 20 6f 6e 65 20 73 70 65 63 69 61 6c 20 in one special
12560 63 61 73 65 20 69 6e 20 74 68 65 20 62 61 63 6b case in the back
12570 75 70 20 41 50 49 20 63 6f 64 65 20 77 68 65 72 up API code wher
12580 65 20 69 74 20 69 73 0a 2a 2a 20 6b 6e 6f 77 6e e it is.** known
12590 20 74 68 61 74 20 74 68 65 20 73 68 61 72 65 64 that the shared
125a0 20 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 73 b-tree mutex is
125b0 20 68 65 6c 64 2c 20 62 75 74 20 74 68 65 20 6d held, but the m
125c0 75 74 65 78 20 6f 6e 20 74 68 65 20 0a 2a 2a 20 utex on the .**
125d0 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
125e0 74 68 61 74 20 6f 77 6e 73 20 2a 70 20 69 73 20 that owns *p is
125f0 6e 6f 74 2e 20 49 6e 20 74 68 69 73 20 63 61 73 not. In this cas
12600 65 20 69 66 20 73 71 6c 69 74 65 33 42 74 72 65 e if sqlite3Btre
12610 65 45 6e 74 65 72 28 29 0a 2a 2a 20 77 65 72 65 eEnter().** were
12620 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 2c 20 69 to be called, i
12630 74 20 6d 69 67 68 74 20 63 6f 6c 6c 69 64 65 20 t might collide
12640 77 69 74 68 20 73 6f 6d 65 20 6f 74 68 65 72 20 with some other
12650 6f 70 65 72 61 74 69 6f 6e 20 6f 6e 20 74 68 65 operation on the
12660 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e .** database han
12670 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a 70 dle that owns *p
12680 2c 20 63 61 75 73 69 6e 67 20 75 6e 64 65 66 69 , causing undefi
12690 6e 65 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2f ned behavior..*/
126a0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
126b0 65 47 65 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 eGetReserveNoMut
126c0 65 78 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ex(Btree *p){.
126d0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
126e0 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 42 mutex_held(p->pB
126f0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 t->mutex) );. r
12700 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e 70 61 eturn p->pBt->pa
12710 67 65 53 69 7a 65 20 2d 20 70 2d 3e 70 42 74 2d geSize - p->pBt-
12720 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 7d 0a 23 >usableSize;.}.#
12730 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
12740 48 41 53 5f 43 4f 44 45 43 20 7c 7c 20 53 51 4c HAS_CODEC || SQL
12750 49 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 23 69 ITE_DEBUG */..#i
12760 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
12770 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 E_OMIT_PAGER_PRA
12780 47 4d 41 53 29 20 7c 7c 20 21 64 65 66 69 6e 65 GMAS) || !define
12790 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 d(SQLITE_OMIT_VA
127a0 43 55 55 4d 29 0a 2f 2a 0a 2a 2a 20 52 65 74 75 CUUM)./*.** Retu
127b0 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
127c0 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 bytes of space
127d0 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 at the end of ev
127e0 65 72 79 20 70 61 67 65 20 74 68 61 74 0a 2a 2a ery page that.**
127f0 20 61 72 65 20 69 6e 74 65 6e 74 75 61 6c 6c 79 are intentually
12800 20 6c 65 66 74 20 75 6e 75 73 65 64 2e 20 20 54 left unused. T
12810 68 69 73 20 69 73 20 74 68 65 20 22 72 65 73 65 his is the "rese
12820 72 76 65 64 22 20 73 70 61 63 65 20 74 68 61 74 rved" space that
12830 20 69 73 0a 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 is.** sometimes
12840 20 75 73 65 64 20 62 79 20 65 78 74 65 6e 73 69 used by extensi
12850 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ons..*/.int sqli
12860 74 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 te3BtreeGetReser
12870 76 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ve(Btree *p){.
12880 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 int n;. sqlite3
12890 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
128a0 20 6e 20 3d 20 70 2d 3e 70 42 74 2d 3e 70 61 67 n = p->pBt->pag
128b0 65 53 69 7a 65 20 2d 20 70 2d 3e 70 42 74 2d 3e eSize - p->pBt->
128c0 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 73 71 usableSize;. sq
128d0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
128e0 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a p);. return n;.
128f0 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 }../*.** Set the
12900 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 6f maximum page co
12910 75 6e 74 20 66 6f 72 20 61 20 64 61 74 61 62 61 unt for a databa
12920 73 65 20 69 66 20 6d 78 50 61 67 65 20 69 73 20 se if mxPage is
12930 70 6f 73 69 74 69 76 65 2e 0a 2a 2a 20 4e 6f 20 positive..** No
12940 63 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64 65 changes are made
12950 20 69 66 20 6d 78 50 61 67 65 20 69 73 20 30 20 if mxPage is 0
12960 6f 72 20 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 or negative..**
12970 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 Regardless of th
12980 65 20 76 61 6c 75 65 20 6f 66 20 6d 78 50 61 67 e value of mxPag
12990 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 6d 61 e, return the ma
129a0 78 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 ximum page count
129b0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
129c0 42 74 72 65 65 4d 61 78 50 61 67 65 43 6f 75 6e BtreeMaxPageCoun
129d0 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 t(Btree *p, int
129e0 6d 78 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 6e mxPage){. int n
129f0 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
12a00 45 6e 74 65 72 28 70 29 3b 0a 20 20 6e 20 3d 20 Enter(p);. n =
12a10 73 71 6c 69 74 65 33 50 61 67 65 72 4d 61 78 50 sqlite3PagerMaxP
12a20 61 67 65 43 6f 75 6e 74 28 70 2d 3e 70 42 74 2d ageCount(p->pBt-
12a30 3e 70 50 61 67 65 72 2c 20 6d 78 50 61 67 65 29 >pPager, mxPage)
12a40 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
12a50 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
12a60 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 rn n;.}../*.** S
12a70 65 74 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 et the BTS_SECUR
12a80 45 5f 44 45 4c 45 54 45 20 66 6c 61 67 20 69 66 E_DELETE flag if
12a90 20 6e 65 77 46 6c 61 67 20 69 73 20 30 20 6f 72 newFlag is 0 or
12aa0 20 31 2e 20 20 49 66 20 6e 65 77 46 6c 61 67 20 1. If newFlag
12ab0 69 73 20 2d 31 2c 0a 2a 2a 20 74 68 65 6e 20 6d is -1,.** then m
12ac0 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 2e 20 ake no changes.
12ad0 20 41 6c 77 61 79 73 20 72 65 74 75 72 6e 20 74 Always return t
12ae0 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 he value of the
12af0 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 BTS_SECURE_DELET
12b00 45 0a 2a 2a 20 73 65 74 74 69 6e 67 20 61 66 74 E.** setting aft
12b10 65 72 20 74 68 65 20 63 68 61 6e 67 65 2e 0a 2a er the change..*
12b20 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
12b30 65 65 53 65 63 75 72 65 44 65 6c 65 74 65 28 42 eeSecureDelete(B
12b40 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6e 65 77 tree *p, int new
12b50 46 6c 61 67 29 7b 0a 20 20 69 6e 74 20 62 3b 0a Flag){. int b;.
12b60 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 if( p==0 ) ret
12b70 75 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 urn 0;. sqlite3
12b80 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
12b90 20 69 66 28 20 6e 65 77 46 6c 61 67 3e 3d 30 20 if( newFlag>=0
12ba0 29 7b 0a 20 20 20 20 70 2d 3e 70 42 74 2d 3e 62 ){. p->pBt->b
12bb0 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f tsFlags &= ~BTS_
12bc0 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 SECURE_DELETE;.
12bd0 20 20 20 69 66 28 20 6e 65 77 46 6c 61 67 20 29 if( newFlag )
12be0 20 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 p->pBt->btsFlag
12bf0 73 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 45 5f s |= BTS_SECURE_
12c00 44 45 4c 45 54 45 3b 0a 20 20 7d 20 0a 20 20 62 DELETE;. } . b
12c10 20 3d 20 28 70 2d 3e 70 42 74 2d 3e 62 74 73 46 = (p->pBt->btsF
12c20 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 55 52 lags & BTS_SECUR
12c30 45 5f 44 45 4c 45 54 45 29 21 3d 30 3b 0a 20 20 E_DELETE)!=0;.
12c40 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
12c50 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 e(p);. return b
12c60 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 21 64 ;.}.#endif /* !d
12c70 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
12c80 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 IT_PAGER_PRAGMAS
12c90 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 53 51 ) || !defined(SQ
12ca0 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55 55 4d LITE_OMIT_VACUUM
12cb0 29 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e ) */../*.** Chan
12cc0 67 65 20 74 68 65 20 27 61 75 74 6f 2d 76 61 63 ge the 'auto-vac
12cd0 75 75 6d 27 20 70 72 6f 70 65 72 74 79 20 6f 66 uum' property of
12ce0 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 49 the database. I
12cf0 66 20 74 68 65 20 27 61 75 74 6f 56 61 63 75 75 f the 'autoVacuu
12d00 6d 27 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 m'.** parameter
12d10 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 is non-zero, the
12d20 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 6d 6f n auto-vacuum mo
12d30 64 65 20 69 73 20 65 6e 61 62 6c 65 64 2e 20 49 de is enabled. I
12d40 66 20 7a 65 72 6f 2c 20 69 74 0a 2a 2a 20 69 73 f zero, it.** is
12d50 20 64 69 73 61 62 6c 65 64 2e 20 54 68 65 20 64 disabled. The d
12d60 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 efault value for
12d70 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d the auto-vacuum
12d80 20 70 72 6f 70 65 72 74 79 20 69 73 20 0a 2a 2a property is .**
12d90 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 determined by t
12da0 68 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c he SQLITE_DEFAUL
12db0 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 6d 61 63 T_AUTOVACUUM mac
12dc0 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ro..*/.int sqlit
12dd0 65 33 42 74 72 65 65 53 65 74 41 75 74 6f 56 61 e3BtreeSetAutoVa
12de0 63 75 75 6d 28 42 74 72 65 65 20 2a 70 2c 20 69 cuum(Btree *p, i
12df0 6e 74 20 61 75 74 6f 56 61 63 75 75 6d 29 7b 0a nt autoVacuum){.
12e00 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
12e10 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
12e20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 return SQLITE_RE
12e30 41 44 4f 4e 4c 59 3b 0a 23 65 6c 73 65 0a 20 20 ADONLY;.#else.
12e40 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
12e50 70 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 20 72 63 p->pBt;. int rc
12e60 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
12e70 75 38 20 61 76 20 3d 20 28 75 38 29 61 75 74 6f u8 av = (u8)auto
12e80 56 61 63 75 75 6d 3b 0a 0a 20 20 73 71 6c 69 74 Vacuum;.. sqlit
12e90 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
12ea0 0a 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 . if( (pBt->bts
12eb0 46 6c 61 67 73 20 26 20 42 54 53 5f 50 41 47 45 Flags & BTS_PAGE
12ec0 53 49 5a 45 5f 46 49 58 45 44 29 21 3d 30 20 26 SIZE_FIXED)!=0 &
12ed0 26 20 28 61 76 20 3f 31 3a 30 29 21 3d 70 42 74 & (av ?1:0)!=pBt
12ee0 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a ->autoVacuum ){.
12ef0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
12f00 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 7d 65 6c 73 READONLY;. }els
12f10 65 7b 0a 20 20 20 20 70 42 74 2d 3e 61 75 74 6f e{. pBt->auto
12f20 56 61 63 75 75 6d 20 3d 20 61 76 20 3f 31 3a 30 Vacuum = av ?1:0
12f30 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 ;. pBt->incrV
12f40 61 63 75 75 6d 20 3d 20 61 76 3d 3d 32 20 3f 31 acuum = av==2 ?1
12f50 3a 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 :0;. }. sqlite
12f60 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
12f70 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e return rc;.#en
12f80 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 dif.}../*.** Ret
12f90 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 urn the value of
12fa0 20 74 68 65 20 27 61 75 74 6f 2d 76 61 63 75 75 the 'auto-vacuu
12fb0 6d 27 20 70 72 6f 70 65 72 74 79 2e 20 49 66 20 m' property. If
12fc0 61 75 74 6f 2d 76 61 63 75 75 6d 20 69 73 20 0a auto-vacuum is .
12fd0 2a 2a 20 65 6e 61 62 6c 65 64 20 31 20 69 73 20 ** enabled 1 is
12fe0 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 returned. Otherw
12ff0 69 73 65 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ise 0..*/.int sq
13000 6c 69 74 65 33 42 74 72 65 65 47 65 74 41 75 74 lite3BtreeGetAut
13010 6f 56 61 63 75 75 6d 28 42 74 72 65 65 20 2a 70 oVacuum(Btree *p
13020 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
13030 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
13040 0a 20 20 72 65 74 75 72 6e 20 42 54 52 45 45 5f . return BTREE_
13050 41 55 54 4f 56 41 43 55 55 4d 5f 4e 4f 4e 45 3b AUTOVACUUM_NONE;
13060 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 72 63 3b .#else. int rc;
13070 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
13080 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 20 3d 20 nter(p);. rc =
13090 28 0a 20 20 20 20 28 21 70 2d 3e 70 42 74 2d 3e (. (!p->pBt->
130a0 61 75 74 6f 56 61 63 75 75 6d 29 3f 42 54 52 45 autoVacuum)?BTRE
130b0 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 4e 4f 4e E_AUTOVACUUM_NON
130c0 45 3a 0a 20 20 20 20 28 21 70 2d 3e 70 42 74 2d E:. (!p->pBt-
130d0 3e 69 6e 63 72 56 61 63 75 75 6d 29 3f 42 54 52 >incrVacuum)?BTR
130e0 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 46 55 EE_AUTOVACUUM_FU
130f0 4c 4c 3a 0a 20 20 20 20 42 54 52 45 45 5f 41 55 LL:. BTREE_AU
13100 54 4f 56 41 43 55 55 4d 5f 49 4e 43 52 0a 20 20 TOVACUUM_INCR.
13110 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
13120 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
13130 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a 7d urn rc;.#endif.}
13140 0a 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 72 .../*.** Get a r
13150 65 66 65 72 65 6e 63 65 20 74 6f 20 70 50 61 67 eference to pPag
13160 65 31 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 e1 of the databa
13170 73 65 20 66 69 6c 65 2e 20 20 54 68 69 73 20 77 se file. This w
13180 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 61 63 71 75 ill.** also acqu
13190 69 72 65 20 61 20 72 65 61 64 6c 6f 63 6b 20 6f ire a readlock o
131a0 6e 20 74 68 61 74 20 66 69 6c 65 2e 0a 2a 2a 0a n that file..**.
131b0 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 ** SQLITE_OK is
131c0 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 returned on succ
131d0 65 73 73 2e 20 20 49 66 20 74 68 65 20 66 69 6c ess. If the fil
131e0 65 20 69 73 20 6e 6f 74 20 61 0a 2a 2a 20 77 65 e is not a.** we
131f0 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 ll-formed databa
13200 73 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 53 51 se file, then SQ
13210 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69 73 20 LITE_CORRUPT is
13220 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 20 53 51 4c returned..** SQL
13230 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 ITE_BUSY is retu
13240 72 6e 65 64 20 69 66 20 74 68 65 20 64 61 74 61 rned if the data
13250 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 2e 20 base is locked.
13260 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a SQLITE_NOMEM.**
13270 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
13280 77 65 20 72 75 6e 20 6f 75 74 20 6f 66 20 6d 65 we run out of me
13290 6d 6f 72 79 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 mory. .*/.static
132a0 20 69 6e 74 20 6c 6f 63 6b 42 74 72 65 65 28 42 int lockBtree(B
132b0 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
132c0 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
132d0 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
132e0 63 6f 64 65 20 66 72 6f 6d 20 73 75 62 66 75 6e code from subfun
132f0 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 4d 65 6d 50 ctions */. MemP
13300 61 67 65 20 2a 70 50 61 67 65 31 3b 20 20 20 20 age *pPage1;
13310 20 2f 2a 20 50 61 67 65 20 31 20 6f 66 20 74 68 /* Page 1 of th
13320 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
13330 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 3b 20 */. int nPage;
13340 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
13350 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 ber of pages in
13360 74 68 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a the database */.
13370 20 20 69 6e 74 20 6e 50 61 67 65 46 69 6c 65 20 int nPageFile
13380 3d 20 30 3b 20 20 20 2f 2a 20 4e 75 6d 62 65 72 = 0; /* Number
13390 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 of pages in the
133a0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
133b0 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 48 65 61 /. int nPageHea
133c0 64 65 72 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 der; /* Numb
133d0 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 er of pages in t
133e0 68 65 20 64 61 74 61 62 61 73 65 20 61 63 63 6f he database acco
133f0 72 64 69 6e 67 20 74 6f 20 68 64 72 20 2a 2f 0a rding to hdr */.
13400 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
13410 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
13420 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
13430 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 ssert( pBt->pPag
13440 65 31 3d 3d 30 20 29 3b 0a 20 20 72 63 20 3d 20 e1==0 );. rc =
13450 73 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 sqlite3PagerShar
13460 65 64 4c 6f 63 6b 28 70 42 74 2d 3e 70 50 61 67 edLock(pBt->pPag
13470 65 72 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 er);. if( rc!=S
13480 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 QLITE_OK ) retur
13490 6e 20 72 63 3b 0a 20 20 72 63 20 3d 20 62 74 72 n rc;. rc = btr
134a0 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 31 eeGetPage(pBt, 1
134b0 2c 20 26 70 50 61 67 65 31 2c 20 30 2c 20 30 29 , &pPage1, 0, 0)
134c0 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
134d0 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
134e0 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 73 6f 6d 65 c;.. /* Do some
134f0 20 63 68 65 63 6b 69 6e 67 20 74 6f 20 68 65 6c checking to hel
13500 70 20 69 6e 73 75 72 65 20 74 68 65 20 66 69 6c p insure the fil
13510 65 20 77 65 20 6f 70 65 6e 65 64 20 72 65 61 6c e we opened real
13520 6c 79 20 69 73 0a 20 20 2a 2a 20 61 20 76 61 6c ly is. ** a val
13530 69 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 id database file
13540 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 61 67 65 20 . . */. nPage
13550 3d 20 6e 50 61 67 65 48 65 61 64 65 72 20 3d 20 = nPageHeader =
13560 67 65 74 34 62 79 74 65 28 32 38 2b 28 75 38 2a get4byte(28+(u8*
13570 29 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b )pPage1->aData);
13580 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 . sqlite3PagerP
13590 61 67 65 63 6f 75 6e 74 28 70 42 74 2d 3e 70 50 agecount(pBt->pP
135a0 61 67 65 72 2c 20 26 6e 50 61 67 65 46 69 6c 65 ager, &nPageFile
135b0 29 3b 0a 20 20 69 66 28 20 6e 50 61 67 65 3d 3d );. if( nPage==
135c0 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 32 34 2b 28 0 || memcmp(24+(
135d0 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 u8*)pPage1->aDat
135e0 61 2c 20 39 32 2b 28 75 38 2a 29 70 50 61 67 65 a, 92+(u8*)pPage
135f0 31 2d 3e 61 44 61 74 61 2c 34 29 21 3d 30 20 29 1->aData,4)!=0 )
13600 7b 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 6e 50 {. nPage = nP
13610 61 67 65 46 69 6c 65 3b 0a 20 20 7d 0a 20 20 69 ageFile;. }. i
13620 66 28 20 6e 50 61 67 65 3e 30 20 29 7b 0a 20 20 f( nPage>0 ){.
13630 20 20 75 33 32 20 70 61 67 65 53 69 7a 65 3b 0a u32 pageSize;.
13640 20 20 20 20 75 33 32 20 75 73 61 62 6c 65 53 69 u32 usableSi
13650 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 61 67 65 ze;. u8 *page
13660 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 44 61 74 1 = pPage1->aDat
13670 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 a;. rc = SQLI
13680 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 69 TE_NOTADB;. i
13690 66 28 20 6d 65 6d 63 6d 70 28 70 61 67 65 31 2c f( memcmp(page1,
136a0 20 7a 4d 61 67 69 63 48 65 61 64 65 72 2c 20 31 zMagicHeader, 1
136b0 36 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 6)!=0 ){. g
136c0 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 oto page1_init_f
136d0 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 23 69 ailed;. }..#i
136e0 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
136f0 5f 57 41 4c 0a 20 20 20 20 69 66 28 20 70 61 67 _WAL. if( pag
13700 65 31 5b 31 38 5d 3e 31 20 29 7b 0a 20 20 20 20 e1[18]>1 ){.
13710 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
13720 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 |= BTS_READ_ONLY
13730 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
13740 70 61 67 65 31 5b 31 39 5d 3e 31 20 29 7b 0a 20 page1[19]>1 ){.
13750 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f goto page1_
13760 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 init_failed;.
13770 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 69 66 28 }.#else. if(
13780 20 70 61 67 65 31 5b 31 38 5d 3e 32 20 29 7b 0a page1[18]>2 ){.
13790 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c pBt->btsFl
137a0 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f ags |= BTS_READ_
137b0 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ONLY;. }.
137c0 69 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 32 20 if( page1[19]>2
137d0 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 ){. goto pa
137e0 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
137f0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 . }.. /* I
13800 66 20 74 68 65 20 77 72 69 74 65 20 76 65 72 73 f the write vers
13810 69 6f 6e 20 69 73 20 73 65 74 20 74 6f 20 32 2c ion is set to 2,
13820 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 73 this database s
13830 68 6f 75 6c 64 20 62 65 20 61 63 63 65 73 73 65 hould be accesse
13840 64 0a 20 20 20 20 2a 2a 20 69 6e 20 57 41 4c 20 d. ** in WAL
13850 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 6c 6f 67 mode. If the log
13860 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
13870 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 74 20 6e 6f open, open it no
13880 77 2e 20 54 68 65 6e 20 0a 20 20 20 20 2a 2a 20 w. Then . **
13890 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
138a0 20 61 6e 64 20 72 65 74 75 72 6e 20 77 69 74 68 and return with
138b0 6f 75 74 20 70 6f 70 75 6c 61 74 69 6e 67 20 42 out populating B
138c0 74 53 68 61 72 65 64 2e 70 50 61 67 65 31 2e 0a tShared.pPage1..
138d0 20 20 20 20 2a 2a 20 54 68 65 20 63 61 6c 6c 65 ** The calle
138e0 72 20 64 65 74 65 63 74 73 20 74 68 69 73 20 61 r detects this a
138f0 6e 64 20 63 61 6c 6c 73 20 74 68 69 73 20 66 75 nd calls this fu
13900 6e 63 74 69 6f 6e 20 61 67 61 69 6e 2e 20 54 68 nction again. Th
13910 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 72 65 71 is is. ** req
13920 75 69 72 65 64 20 61 73 20 74 68 65 20 76 65 72 uired as the ver
13930 73 69 6f 6e 20 6f 66 20 70 61 67 65 20 31 20 63 sion of page 1 c
13940 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 68 65 20 urrently in the
13950 70 61 67 65 31 20 62 75 66 66 65 72 0a 20 20 20 page1 buffer.
13960 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 62 65 20 74 ** may not be t
13970 68 65 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f he latest versio
13980 6e 20 2d 20 74 68 65 72 65 20 6d 61 79 20 62 65 n - there may be
13990 20 61 20 6e 65 77 65 72 20 6f 6e 65 20 69 6e 20 a newer one in
139a0 74 68 65 20 6c 6f 67 0a 20 20 20 20 2a 2a 20 66 the log. ** f
139b0 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ile.. */.
139c0 69 66 28 20 70 61 67 65 31 5b 31 39 5d 3d 3d 32 if( page1[19]==2
139d0 20 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 && (pBt->btsFla
139e0 67 73 20 26 20 42 54 53 5f 4e 4f 5f 57 41 4c 29 gs & BTS_NO_WAL)
139f0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 ==0 ){. int
13a00 20 69 73 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 isOpen = 0;.
13a10 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
13a20 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 42 74 2d agerOpenWal(pBt-
13a30 3e 70 50 61 67 65 72 2c 20 26 69 73 4f 70 65 6e >pPager, &isOpen
13a40 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
13a50 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
13a60 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 goto page1
13a70 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 _init_failed;.
13a80 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69 73 }else if( is
13a90 4f 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Open==0 ){.
13aa0 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
13ab0 50 61 67 65 31 29 3b 0a 20 20 20 20 20 20 20 20 Page1);.
13ac0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
13ad0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
13ae0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 41 rc = SQLITE_NOTA
13af0 44 42 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 DB;. }.#endif
13b00 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 78 .. /* The max
13b10 69 6d 75 6d 20 65 6d 62 65 64 64 65 64 20 66 72 imum embedded fr
13b20 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 action must be e
13b30 78 61 63 74 6c 79 20 32 35 25 2e 20 20 41 6e 64 xactly 25%. And
13b40 20 74 68 65 20 6d 69 6e 69 6d 75 6d 0a 20 20 20 the minimum.
13b50 20 2a 2a 20 65 6d 62 65 64 64 65 64 20 66 72 61 ** embedded fra
13b60 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 31 32 ction must be 12
13b70 2e 35 25 20 66 6f 72 20 62 6f 74 68 20 6c 65 61 .5% for both lea
13b80 66 2d 64 61 74 61 20 61 6e 64 20 6e 6f 6e 2d 6c f-data and non-l
13b90 65 61 66 2d 64 61 74 61 2e 0a 20 20 20 20 2a 2a eaf-data.. **
13ba0 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 65 The original de
13bb0 73 69 67 6e 20 61 6c 6c 6f 77 65 64 20 74 68 65 sign allowed the
13bc0 73 65 20 61 6d 6f 75 6e 74 73 20 74 6f 20 76 61 se amounts to va
13bd0 72 79 2c 20 62 75 74 20 61 73 20 6f 66 0a 20 20 ry, but as of.
13be0 20 20 2a 2a 20 76 65 72 73 69 6f 6e 20 33 2e 36 ** version 3.6
13bf0 2e 30 2c 20 77 65 20 72 65 71 75 69 72 65 20 74 .0, we require t
13c00 68 65 6d 20 74 6f 20 62 65 20 66 69 78 65 64 2e hem to be fixed.
13c10 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
13c20 6d 65 6d 63 6d 70 28 26 70 61 67 65 31 5b 32 31 memcmp(&page1[21
13c30 5d 2c 20 22 5c 31 30 30 5c 30 34 30 5c 30 34 30 ], "\100\040\040
13c40 22 2c 33 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 ",3)!=0 ){.
13c50 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
13c60 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
13c70 20 20 20 70 61 67 65 53 69 7a 65 20 3d 20 28 70 pageSize = (p
13c80 61 67 65 31 5b 31 36 5d 3c 3c 38 29 20 7c 20 28 age1[16]<<8) | (
13c90 70 61 67 65 31 5b 31 37 5d 3c 3c 31 36 29 3b 0a page1[17]<<16);.
13ca0 20 20 20 20 69 66 28 20 28 28 70 61 67 65 53 69 if( ((pageSi
13cb0 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 21 ze-1)&pageSize)!
13cc0 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 67 65 53 =0. || pageS
13cd0 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 ize>SQLITE_MAX_P
13ce0 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 20 20 7c AGE_SIZE . |
13cf0 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 35 36 20 | pageSize<=256
13d00 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f . ){. go
13d10 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 to page1_init_fa
13d20 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 iled;. }.
13d30 61 73 73 65 72 74 28 20 28 70 61 67 65 53 69 7a assert( (pageSiz
13d40 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 e & 7)==0 );.
13d50 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 61 usableSize = pa
13d60 67 65 53 69 7a 65 20 2d 20 70 61 67 65 31 5b 32 geSize - page1[2
13d70 30 5d 3b 0a 20 20 20 20 69 66 28 20 28 75 33 32 0];. if( (u32
13d80 29 70 61 67 65 53 69 7a 65 21 3d 70 42 74 2d 3e )pageSize!=pBt->
13d90 70 61 67 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 pageSize ){.
13da0 20 20 2f 2a 20 41 66 74 65 72 20 72 65 61 64 69 /* After readi
13db0 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 61 67 ng the first pag
13dc0 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
13dd0 65 20 61 73 73 75 6d 69 6e 67 20 61 20 70 61 67 e assuming a pag
13de0 65 20 73 69 7a 65 0a 20 20 20 20 20 20 2a 2a 20 e size. **
13df0 6f 66 20 42 74 53 68 61 72 65 64 2e 70 61 67 65 of BtShared.page
13e00 53 69 7a 65 2c 20 77 65 20 68 61 76 65 20 64 69 Size, we have di
13e10 73 63 6f 76 65 72 65 64 20 74 68 61 74 20 74 68 scovered that th
13e20 65 20 70 61 67 65 2d 73 69 7a 65 20 69 73 0a 20 e page-size is.
13e30 20 20 20 20 20 2a 2a 20 61 63 74 75 61 6c 6c 79 ** actually
13e40 20 70 61 67 65 53 69 7a 65 2e 20 55 6e 6c 6f 63 pageSize. Unloc
13e50 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 k the database,
13e60 6c 65 61 76 65 20 70 42 74 2d 3e 70 50 61 67 65 leave pBt->pPage
13e70 31 20 61 74 0a 20 20 20 20 20 20 2a 2a 20 7a 65 1 at. ** ze
13e80 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 ro and return SQ
13e90 4c 49 54 45 5f 4f 4b 2e 20 54 68 65 20 63 61 6c LITE_OK. The cal
13ea0 6c 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 74 68 ler will call th
13eb0 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 is function.
13ec0 20 20 2a 2a 20 61 67 61 69 6e 20 77 69 74 68 20 ** again with
13ed0 74 68 65 20 63 6f 72 72 65 63 74 20 70 61 67 65 the correct page
13ee0 2d 73 69 7a 65 2e 0a 20 20 20 20 20 20 2a 2f 0a -size.. */.
13ef0 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
13f00 65 28 70 50 61 67 65 31 29 3b 0a 20 20 20 20 20 e(pPage1);.
13f10 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
13f20 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 = usableSize;.
13f30 20 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 pBt->pageSi
13f40 7a 65 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 ze = pageSize;.
13f50 20 20 20 20 20 66 72 65 65 54 65 6d 70 53 70 61 freeTempSpa
13f60 63 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 72 ce(pBt);. r
13f70 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
13f80 53 65 74 50 61 67 65 73 69 7a 65 28 70 42 74 2d SetPagesize(pBt-
13f90 3e 70 50 61 67 65 72 2c 20 26 70 42 74 2d 3e 70 >pPager, &pBt->p
13fa0 61 67 65 53 69 7a 65 2c 0a 20 20 20 20 20 20 20 ageSize,.
13fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13fc0 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 page
13fd0 53 69 7a 65 2d 75 73 61 62 6c 65 53 69 7a 65 29 Size-usableSize)
13fe0 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 ;. return r
13ff0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
14000 20 28 70 42 74 2d 3e 64 62 2d 3e 66 6c 61 67 73 (pBt->db->flags
14010 20 26 20 53 51 4c 49 54 45 5f 52 65 63 6f 76 65 & SQLITE_Recove
14020 72 79 4d 6f 64 65 29 3d 3d 30 20 26 26 20 6e 50 ryMode)==0 && nP
14030 61 67 65 3e 6e 50 61 67 65 46 69 6c 65 20 29 7b age>nPageFile ){
14040 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
14050 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
14060 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
14070 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 1_init_failed;.
14080 20 20 20 7d 0a 20 20 20 20 69 66 28 20 75 73 61 }. if( usa
14090 62 6c 65 53 69 7a 65 3c 34 38 30 20 29 7b 0a 20 bleSize<480 ){.
140a0 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f goto page1_
140b0 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 init_failed;.
140c0 20 7d 0a 20 20 20 20 70 42 74 2d 3e 70 61 67 65 }. pBt->page
140d0 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a 65 3b Size = pageSize;
140e0 0a 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 . pBt->usable
140f0 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 7a Size = usableSiz
14100 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 e;.#ifndef SQLIT
14110 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
14120 4d 0a 20 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 M. pBt->autoV
14130 61 63 75 75 6d 20 3d 20 28 67 65 74 34 62 79 74 acuum = (get4byt
14140 65 28 26 70 61 67 65 31 5b 33 36 20 2b 20 34 2a e(&page1[36 + 4*
14150 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 20 70 42 4])?1:0);. pB
14160 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 t->incrVacuum =
14170 28 67 65 74 34 62 79 74 65 28 26 70 61 67 65 31 (get4byte(&page1
14180 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 [36 + 7*4])?1:0)
14190 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 ;.#endif. }..
141a0 2f 2a 20 6d 61 78 4c 6f 63 61 6c 20 69 73 20 74 /* maxLocal is t
141b0 68 65 20 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e he maximum amoun
141c0 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 74 6f 20 t of payload to
141d0 73 74 6f 72 65 20 6c 6f 63 61 6c 6c 79 20 66 6f store locally fo
141e0 72 0a 20 20 2a 2a 20 61 20 63 65 6c 6c 2e 20 20 r. ** a cell.
141f0 4d 61 6b 65 20 73 75 72 65 20 69 74 20 69 73 20 Make sure it is
14200 73 6d 61 6c 6c 20 65 6e 6f 75 67 68 20 73 6f 20 small enough so
14210 74 68 61 74 20 61 74 20 6c 65 61 73 74 20 6d 69 that at least mi
14220 6e 46 61 6e 6f 75 74 0a 20 20 2a 2a 20 63 65 6c nFanout. ** cel
14230 6c 73 20 63 61 6e 20 77 69 6c 6c 20 66 69 74 20 ls can will fit
14240 6f 6e 20 6f 6e 65 20 70 61 67 65 2e 20 20 57 65 on one page. We
14250 20 61 73 73 75 6d 65 20 61 20 31 30 2d 62 79 74 assume a 10-byt
14260 65 20 70 61 67 65 20 68 65 61 64 65 72 2e 0a 20 e page header..
14270 20 2a 2a 20 42 65 73 69 64 65 73 20 74 68 65 20 ** Besides the
14280 70 61 79 6c 6f 61 64 2c 20 74 68 65 20 63 65 6c payload, the cel
14290 6c 20 6d 75 73 74 20 73 74 6f 72 65 3a 0a 20 20 l must store:.
142a0 2a 2a 20 20 20 20 20 32 2d 62 79 74 65 20 70 6f ** 2-byte po
142b0 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 65 6c inter to the cel
142c0 6c 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 l. ** 4-byt
142d0 65 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 0a e child pointer.
142e0 20 20 2a 2a 20 20 20 20 20 39 2d 62 79 74 65 20 ** 9-byte
142f0 6e 4b 65 79 20 76 61 6c 75 65 0a 20 20 2a 2a 20 nKey value. **
14300 20 20 20 20 34 2d 62 79 74 65 20 6e 44 61 74 61 4-byte nData
14310 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 value. **
14320 34 2d 62 79 74 65 20 6f 76 65 72 66 6c 6f 77 20 4-byte overflow
14330 70 61 67 65 20 70 6f 69 6e 74 65 72 0a 20 20 2a page pointer. *
14340 2a 20 53 6f 20 61 20 63 65 6c 6c 20 63 6f 6e 73 * So a cell cons
14350 69 73 74 73 20 6f 66 20 61 20 32 2d 62 79 74 65 ists of a 2-byte
14360 20 70 6f 69 6e 74 65 72 2c 20 61 20 68 65 61 64 pointer, a head
14370 65 72 20 77 68 69 63 68 20 69 73 20 61 73 20 6d er which is as m
14380 75 63 68 20 61 73 0a 20 20 2a 2a 20 31 37 20 62 uch as. ** 17 b
14390 79 74 65 73 20 6c 6f 6e 67 2c 20 30 20 74 6f 20 ytes long, 0 to
143a0 4e 20 62 79 74 65 73 20 6f 66 20 70 61 79 6c 6f N bytes of paylo
143b0 61 64 2c 20 61 6e 64 20 61 6e 20 6f 70 74 69 6f ad, and an optio
143c0 6e 61 6c 20 34 20 62 79 74 65 20 6f 76 65 72 66 nal 4 byte overf
143d0 6c 6f 77 0a 20 20 2a 2a 20 70 61 67 65 20 70 6f low. ** page po
143e0 69 6e 74 65 72 2e 0a 20 20 2a 2f 0a 20 20 70 42 inter.. */. pB
143f0 74 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d 20 28 75 t->maxLocal = (u
14400 31 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 16)((pBt->usable
14410 53 69 7a 65 2d 31 32 29 2a 36 34 2f 32 35 35 20 Size-12)*64/255
14420 2d 20 32 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 - 23);. pBt->mi
14430 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 28 28 nLocal = (u16)((
14440 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d pBt->usableSize-
14450 31 32 29 2a 33 32 2f 32 35 35 20 2d 20 32 33 29 12)*32/255 - 23)
14460 3b 0a 20 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 ;. pBt->maxLeaf
14470 20 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 75 73 = (u16)(pBt->us
14480 61 62 6c 65 53 69 7a 65 20 2d 20 33 35 29 3b 0a ableSize - 35);.
14490 20 20 70 42 74 2d 3e 6d 69 6e 4c 65 61 66 20 3d pBt->minLeaf =
144a0 20 28 75 31 36 29 28 28 70 42 74 2d 3e 75 73 61 (u16)((pBt->usa
144b0 62 6c 65 53 69 7a 65 2d 31 32 29 2a 33 32 2f 32 bleSize-12)*32/2
144c0 35 35 20 2d 20 32 33 29 3b 0a 20 20 69 66 28 20 55 - 23);. if(
144d0 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3e 31 32 pBt->maxLocal>12
144e0 37 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e 6d 61 7 ){. pBt->ma
144f0 78 31 62 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 x1bytePayload =
14500 31 32 37 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 127;. }else{.
14510 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 pBt->max1byteP
14520 61 79 6c 6f 61 64 20 3d 20 28 75 38 29 70 42 74 ayload = (u8)pBt
14530 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 7d 0a ->maxLocal;. }.
14540 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6d assert( pBt->m
14550 61 78 4c 65 61 66 20 2b 20 32 33 20 3c 3d 20 4d axLeaf + 23 <= M
14560 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 42 74 29 X_CELL_SIZE(pBt)
14570 20 29 3b 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 );. pBt->pPage
14580 31 20 3d 20 70 50 61 67 65 31 3b 0a 20 20 70 42 1 = pPage1;. pB
14590 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 t->nPage = nPage
145a0 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
145b0 45 5f 4f 4b 3b 0a 0a 70 61 67 65 31 5f 69 6e 69 E_OK;..page1_ini
145c0 74 5f 66 61 69 6c 65 64 3a 0a 20 20 72 65 6c 65 t_failed:. rele
145d0 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b asePage(pPage1);
145e0 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d . pBt->pPage1 =
145f0 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0;. return rc;
14600 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 .}..#ifndef NDEB
14610 55 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 UG./*.** Return
14620 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 75 the number of cu
14630 72 73 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 70 42 rsors open on pB
14640 74 2e 20 54 68 69 73 20 69 73 20 66 6f 72 20 75 t. This is for u
14650 73 65 0a 2a 2a 20 69 6e 20 61 73 73 65 72 74 28 se.** in assert(
14660 29 20 65 78 70 72 65 73 73 69 6f 6e 73 2c 20 73 ) expressions, s
14670 6f 20 69 74 20 69 73 20 6f 6e 6c 79 20 63 6f 6d o it is only com
14680 70 69 6c 65 64 20 69 66 20 4e 44 45 42 55 47 20 piled if NDEBUG
14690 69 73 20 6e 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 is not.** define
146a0 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 77 72 d..**.** Only wr
146b0 69 74 65 20 63 75 72 73 6f 72 73 20 61 72 65 20 ite cursors are
146c0 63 6f 75 6e 74 65 64 20 69 66 20 77 72 4f 6e 6c counted if wrOnl
146d0 79 20 69 73 20 74 72 75 65 2e 20 20 49 66 20 77 y is true. If w
146e0 72 4f 6e 6c 79 20 69 73 0a 2a 2a 20 66 61 6c 73 rOnly is.** fals
146f0 65 20 74 68 65 6e 20 61 6c 6c 20 63 75 72 73 6f e then all curso
14700 72 73 20 61 72 65 20 63 6f 75 6e 74 65 64 2e 0a rs are counted..
14710 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 20 70 75 **.** For the pu
14720 72 70 6f 73 65 73 20 6f 66 20 74 68 69 73 20 72 rposes of this r
14730 6f 75 74 69 6e 65 2c 20 61 20 63 75 72 73 6f 72 outine, a cursor
14740 20 69 73 20 61 6e 79 20 63 75 72 73 6f 72 20 74 is any cursor t
14750 68 61 74 0a 2a 2a 20 69 73 20 63 61 70 61 62 6c hat.** is capabl
14760 65 20 6f 66 20 72 65 61 64 69 6e 67 20 6f 72 20 e of reading or
14770 77 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 writing to the d
14780 61 74 61 62 73 65 2e 20 20 43 75 72 73 6f 72 73 atabse. Cursors
14790 20 74 68 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 that.** have be
147a0 65 6e 20 74 72 69 70 70 65 64 20 69 6e 74 6f 20 en tripped into
147b0 74 68 65 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 the CURSOR_FAULT
147c0 20 73 74 61 74 65 20 61 72 65 20 6e 6f 74 20 63 state are not c
147d0 6f 75 6e 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 ounted..*/.stati
147e0 63 20 69 6e 74 20 63 6f 75 6e 74 56 61 6c 69 64 c int countValid
147f0 43 75 72 73 6f 72 73 28 42 74 53 68 61 72 65 64 Cursors(BtShared
14800 20 2a 70 42 74 2c 20 69 6e 74 20 77 72 4f 6e 6c *pBt, int wrOnl
14810 79 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a y){. BtCursor *
14820 70 43 75 72 3b 0a 20 20 69 6e 74 20 72 20 3d 20 pCur;. int r =
14830 30 3b 0a 20 20 66 6f 72 28 70 43 75 72 3d 70 42 0;. for(pCur=pB
14840 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 43 75 72 t->pCursor; pCur
14850 3b 20 70 43 75 72 3d 70 43 75 72 2d 3e 70 4e 65 ; pCur=pCur->pNe
14860 78 74 29 7b 0a 20 20 20 20 69 66 28 20 28 77 72 xt){. if( (wr
14870 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Only==0 || pCur-
14880 3e 77 72 46 6c 61 67 29 20 26 26 20 70 43 75 72 >wrFlag) && pCur
14890 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
148a0 5f 46 41 55 4c 54 20 29 20 72 2b 2b 3b 20 0a 20 _FAULT ) r++; .
148b0 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d }. return r;.}
148c0 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
148d0 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f f there are no o
148e0 75 74 73 74 61 6e 64 69 6e 67 20 63 75 72 73 6f utstanding curso
148f0 72 73 20 61 6e 64 20 77 65 20 61 72 65 20 6e 6f rs and we are no
14900 74 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 0a t in the middle.
14910 2a 2a 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 ** of a transact
14920 69 6f 6e 20 62 75 74 20 74 68 65 72 65 20 69 73 ion but there is
14930 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 a read lock on
14940 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 the database, th
14950 65 6e 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 en.** this routi
14960 6e 65 20 75 6e 72 65 66 73 20 74 68 65 20 66 69 ne unrefs the fi
14970 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 rst page of the
14980 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 68 database file wh
14990 69 63 68 20 0a 2a 2a 20 68 61 73 20 74 68 65 20 ich .** has the
149a0 65 66 66 65 63 74 20 6f 66 20 72 65 6c 65 61 73 effect of releas
149b0 69 6e 67 20 74 68 65 20 72 65 61 64 20 6c 6f 63 ing the read loc
149c0 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 72 k..**.** If ther
149d0 65 20 69 73 20 61 20 74 72 61 6e 73 61 63 74 69 e is a transacti
149e0 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20 on in progress,
149f0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
14a00 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 a no-op..*/.stat
14a10 69 63 20 76 6f 69 64 20 75 6e 6c 6f 63 6b 42 74 ic void unlockBt
14a20 72 65 65 49 66 55 6e 75 73 65 64 28 42 74 53 68 reeIfUnused(BtSh
14a30 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 61 73 ared *pBt){. as
14a40 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
14a50 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
14a60 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
14a70 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 ( countValidCurs
14a80 6f 72 73 28 70 42 74 2c 30 29 3d 3d 30 20 7c 7c ors(pBt,0)==0 ||
14a90 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
14aa0 69 6f 6e 3e 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 ion>TRANS_NONE )
14ab0 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 69 6e 54 ;. if( pBt->inT
14ac0 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
14ad0 53 5f 4e 4f 4e 45 20 26 26 20 70 42 74 2d 3e 70 S_NONE && pBt->p
14ae0 50 61 67 65 31 21 3d 30 20 29 7b 0a 20 20 20 20 Page1!=0 ){.
14af0 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 assert( pBt->pPa
14b00 67 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 ge1->aData );.
14b10 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
14b20 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 70 3PagerRefcount(p
14b30 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d 31 20 29 Bt->pPager)==1 )
14b40 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 ;. assert( pB
14b50 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
14b60 20 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 );. releaseP
14b70 61 67 65 28 70 42 74 2d 3e 70 50 61 67 65 31 29 age(pBt->pPage1)
14b80 3b 0a 20 20 20 20 70 42 74 2d 3e 70 50 61 67 65 ;. pBt->pPage
14b90 31 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 1 = 0;. }.}../*
14ba0 0a 2a 2a 20 49 66 20 70 42 74 20 70 6f 69 6e 74 .** If pBt point
14bb0 73 20 74 6f 20 61 6e 20 65 6d 70 74 79 20 66 69 s to an empty fi
14bc0 6c 65 20 74 68 65 6e 20 63 6f 6e 76 65 72 74 20 le then convert
14bd0 74 68 61 74 20 65 6d 70 74 79 20 66 69 6c 65 0a that empty file.
14be0 2a 2a 20 69 6e 74 6f 20 61 20 6e 65 77 20 65 6d ** into a new em
14bf0 70 74 79 20 64 61 74 61 62 61 73 65 20 62 79 20 pty database by
14c00 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 initializing the
14c10 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 0a 2a first page of.*
14c20 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a * the database..
14c30 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 65 */.static int ne
14c40 77 44 61 74 61 62 61 73 65 28 42 74 53 68 61 72 wDatabase(BtShar
14c50 65 64 20 2a 70 42 74 29 7b 0a 20 20 4d 65 6d 50 ed *pBt){. MemP
14c60 61 67 65 20 2a 70 50 31 3b 0a 20 20 75 6e 73 69 age *pP1;. unsi
14c70 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 3b gned char *data;
14c80 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
14c90 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
14ca0 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
14cb0 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 tex) );. if( pB
14cc0 74 2d 3e 6e 50 61 67 65 3e 30 20 29 7b 0a 20 20 t->nPage>0 ){.
14cd0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
14ce0 4f 4b 3b 0a 20 20 7d 0a 20 20 70 50 31 20 3d 20 OK;. }. pP1 =
14cf0 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 61 pBt->pPage1;. a
14d00 73 73 65 72 74 28 20 70 50 31 21 3d 30 20 29 3b ssert( pP1!=0 );
14d10 0a 20 20 64 61 74 61 20 3d 20 70 50 31 2d 3e 61 . data = pP1->a
14d20 44 61 74 61 3b 0a 20 20 72 63 20 3d 20 73 71 6c Data;. rc = sql
14d30 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
14d40 50 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 P1->pDbPage);.
14d50 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
14d60 72 63 3b 0a 20 20 6d 65 6d 63 70 79 28 64 61 74 rc;. memcpy(dat
14d70 61 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 2c a, zMagicHeader,
14d80 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 sizeof(zMagicHe
14d90 61 64 65 72 29 29 3b 0a 20 20 61 73 73 65 72 74 ader));. assert
14da0 28 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 ( sizeof(zMagicH
14db0 65 61 64 65 72 29 3d 3d 31 36 20 29 3b 0a 20 20 eader)==16 );.
14dc0 64 61 74 61 5b 31 36 5d 20 3d 20 28 75 38 29 28 data[16] = (u8)(
14dd0 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e (pBt->pageSize>>
14de0 38 29 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 8)&0xff);. data
14df0 5b 31 37 5d 20 3d 20 28 75 38 29 28 28 70 42 74 [17] = (u8)((pBt
14e00 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 31 36 29 26 ->pageSize>>16)&
14e10 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 38 0xff);. data[18
14e20 5d 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 31 39 ] = 1;. data[19
14e30 5d 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 28 ] = 1;. assert(
14e40 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
14e50 3c 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 <=pBt->pageSize
14e60 26 26 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 && pBt->usableSi
14e70 7a 65 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 61 67 ze+255>=pBt->pag
14e80 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 eSize);. data[2
14e90 30 5d 20 3d 20 28 75 38 29 28 70 42 74 2d 3e 70 0] = (u8)(pBt->p
14ea0 61 67 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 ageSize - pBt->u
14eb0 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 64 61 sableSize);. da
14ec0 74 61 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 20 64 ta[21] = 64;. d
14ed0 61 74 61 5b 32 32 5d 20 3d 20 33 32 3b 0a 20 20 ata[22] = 32;.
14ee0 64 61 74 61 5b 32 33 5d 20 3d 20 33 32 3b 0a 20 data[23] = 32;.
14ef0 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 32 34 memset(&data[24
14f00 5d 2c 20 30 2c 20 31 30 30 2d 32 34 29 3b 0a 20 ], 0, 100-24);.
14f10 20 7a 65 72 6f 50 61 67 65 28 70 50 31 2c 20 50 zeroPage(pP1, P
14f20 54 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 TF_INTKEY|PTF_LE
14f30 41 46 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 20 AF|PTF_LEAFDATA
14f40 29 3b 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 );. pBt->btsFla
14f50 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 gs |= BTS_PAGESI
14f60 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 ZE_FIXED;.#ifnde
14f70 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
14f80 54 4f 56 41 43 55 55 4d 0a 20 20 61 73 73 65 72 TOVACUUM. asser
14f90 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 t( pBt->autoVacu
14fa0 75 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 61 75 um==1 || pBt->au
14fb0 74 6f 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 toVacuum==0 );.
14fc0 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e assert( pBt->in
14fd0 63 72 56 61 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 crVacuum==1 || p
14fe0 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 3d 3d Bt->incrVacuum==
14ff0 30 20 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 0 );. put4byte(
15000 26 64 61 74 61 5b 33 36 20 2b 20 34 2a 34 5d 2c &data[36 + 4*4],
15010 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
15020 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 64 );. put4byte(&d
15030 61 74 61 5b 33 36 20 2b 20 37 2a 34 5d 2c 20 70 ata[36 + 7*4], p
15040 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 3b Bt->incrVacuum);
15050 0a 23 65 6e 64 69 66 0a 20 20 70 42 74 2d 3e 6e .#endif. pBt->n
15060 50 61 67 65 20 3d 20 31 3b 0a 20 20 64 61 74 61 Page = 1;. data
15070 5b 33 31 5d 20 3d 20 31 3b 0a 20 20 72 65 74 75 [31] = 1;. retu
15080 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
15090 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a ./*.** Initializ
150a0 65 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 e the first page
150b0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
150c0 20 66 69 6c 65 20 28 63 72 65 61 74 69 6e 67 20 file (creating
150d0 61 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f a database.** co
150e0 6e 73 69 73 74 69 6e 67 20 6f 66 20 61 20 73 69 nsisting of a si
150f0 6e 67 6c 65 20 70 61 67 65 20 61 6e 64 20 6e 6f ngle page and no
15100 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 29 schema objects)
15110 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f . Return SQLITE_
15120 4f 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 OK.** if success
15130 66 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 ful, or an SQLit
15140 65 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 e error code oth
15150 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 erwise..*/.int s
15160 71 6c 69 74 65 33 42 74 72 65 65 4e 65 77 44 62 qlite3BtreeNewDb
15170 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e (Btree *p){. in
15180 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 t rc;. sqlite3B
15190 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
151a0 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 p->pBt->nPage =
151b0 30 3b 0a 20 20 72 63 20 3d 20 6e 65 77 44 61 74 0;. rc = newDat
151c0 61 62 61 73 65 28 70 2d 3e 70 42 74 29 3b 0a 20 abase(p->pBt);.
151d0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
151e0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
151f0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 rc;.}../*.** Att
15200 65 6d 70 74 20 74 6f 20 73 74 61 72 74 20 61 20 empt to start a
15210 6e 65 77 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e new transaction.
15220 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 A write-transac
15230 74 69 6f 6e 0a 2a 2a 20 69 73 20 73 74 61 72 74 tion.** is start
15240 65 64 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 ed if the second
15250 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e argument is non
15260 7a 65 72 6f 2c 20 6f 74 68 65 72 77 69 73 65 20 zero, otherwise
15270 61 20 72 65 61 64 2d 0a 2a 2a 20 74 72 61 6e 73 a read-.** trans
15280 61 63 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 action. If the
15290 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 second argument
152a0 69 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 6e 64 is 2 or more and
152b0 20 65 78 63 6c 75 73 69 76 65 0a 2a 2a 20 74 72 exclusive.** tr
152c0 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 ansaction is sta
152d0 72 74 65 64 2c 20 6d 65 61 6e 69 6e 67 20 74 68 rted, meaning th
152e0 61 74 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 at no other proc
152f0 65 73 73 20 69 73 20 61 6c 6c 6f 77 65 64 0a 2a ess is allowed.*
15300 2a 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 * to access the
15310 64 61 74 61 62 61 73 65 2e 20 20 41 20 70 72 65 database. A pre
15320 65 78 69 73 74 69 6e 67 20 74 72 61 6e 73 61 63 existing transac
15330 74 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 0a tion may not be.
15340 2a 2a 20 75 70 67 72 61 64 65 64 20 74 6f 20 65 ** upgraded to e
15350 78 63 6c 75 73 69 76 65 20 62 79 20 63 61 6c 6c xclusive by call
15360 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ing this routine
15370 20 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 20 2d a second time -
15380 20 74 68 65 0a 2a 2a 20 65 78 63 6c 75 73 69 76 the.** exclusiv
15390 69 74 79 20 66 6c 61 67 20 6f 6e 6c 79 20 77 6f ity flag only wo
153a0 72 6b 73 20 66 6f 72 20 61 20 6e 65 77 20 74 72 rks for a new tr
153b0 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a ansaction..**.**
153c0 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 A write-transac
153d0 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 73 74 61 tion must be sta
153e0 72 74 65 64 20 62 65 66 6f 72 65 20 61 74 74 65 rted before atte
153f0 6d 70 74 69 6e 67 20 61 6e 79 20 0a 2a 2a 20 63 mpting any .** c
15400 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 hanges to the da
15410 74 61 62 61 73 65 2e 20 20 4e 6f 6e 65 20 6f 66 tabase. None of
15420 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 the following r
15430 6f 75 74 69 6e 65 73 20 0a 2a 2a 20 77 69 6c 6c outines .** will
15440 20 77 6f 72 6b 20 75 6e 6c 65 73 73 20 61 20 74 work unless a t
15450 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 ransaction is st
15460 61 72 74 65 64 20 66 69 72 73 74 3a 0a 2a 2a 0a arted first:.**.
15470 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
15480 74 72 65 65 43 72 65 61 74 65 54 61 62 6c 65 28 treeCreateTable(
15490 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 ).** sqlite
154a0 33 42 74 72 65 65 43 72 65 61 74 65 49 6e 64 65 3BtreeCreateInde
154b0 78 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 x().** sqli
154c0 74 65 33 42 74 72 65 65 43 6c 65 61 72 54 61 62 te3BtreeClearTab
154d0 6c 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c le().** sql
154e0 69 74 65 33 42 74 72 65 65 44 72 6f 70 54 61 62 ite3BtreeDropTab
154f0 6c 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c le().** sql
15500 69 74 65 33 42 74 72 65 65 49 6e 73 65 72 74 28 ite3BtreeInsert(
15510 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 ).** sqlite
15520 33 42 74 72 65 65 44 65 6c 65 74 65 28 29 0a 2a 3BtreeDelete().*
15530 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 * sqlite3Bt
15540 72 65 65 55 70 64 61 74 65 4d 65 74 61 28 29 0a reeUpdateMeta().
15550 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 69 6e 69 74 **.** If an init
15560 69 61 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 61 ial attempt to a
15570 63 71 75 69 72 65 20 74 68 65 20 6c 6f 63 6b 20 cquire the lock
15580 66 61 69 6c 73 20 62 65 63 61 75 73 65 20 6f 66 fails because of
15590 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e lock contention
155a0 0a 2a 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 .** and the data
155b0 62 61 73 65 20 77 61 73 20 70 72 65 76 69 6f 75 base was previou
155c0 73 6c 79 20 75 6e 6c 6f 63 6b 65 64 2c 20 74 68 sly unlocked, th
155d0 65 6e 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 en invoke the bu
155e0 73 79 20 68 61 6e 64 6c 65 72 0a 2a 2a 20 69 66 sy handler.** if
155f0 20 74 68 65 72 65 20 69 73 20 6f 6e 65 2e 20 20 there is one.
15600 42 75 74 20 69 66 20 74 68 65 72 65 20 77 61 73 But if there was
15610 20 70 72 65 76 69 6f 75 73 6c 79 20 61 20 72 65 previously a re
15620 61 64 2d 6c 6f 63 6b 2c 20 64 6f 20 6e 6f 74 0a ad-lock, do not.
15630 2a 2a 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 ** invoke the bu
15640 73 79 20 68 61 6e 64 6c 65 72 20 2d 20 6a 75 73 sy handler - jus
15650 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f t return SQLITE_
15660 42 55 53 59 2e 20 20 53 51 4c 49 54 45 5f 42 55 BUSY. SQLITE_BU
15670 53 59 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e SY is .** return
15680 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 ed when there is
15690 20 61 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d already a read-
156a0 6c 6f 63 6b 20 69 6e 20 6f 72 64 65 72 20 74 6f lock in order to
156b0 20 61 76 6f 69 64 20 61 20 64 65 61 64 6c 6f 63 avoid a deadloc
156c0 6b 2e 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 k..**.** Suppose
156d0 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 there are two p
156e0 72 6f 63 65 73 73 65 73 20 41 20 61 6e 64 20 42 rocesses A and B
156f0 2e 20 20 41 20 68 61 73 20 61 20 72 65 61 64 20 . A has a read
15700 6c 6f 63 6b 20 61 6e 64 20 42 20 68 61 73 0a 2a lock and B has.*
15710 2a 20 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 * a reserved loc
15720 6b 2e 20 20 42 20 74 72 69 65 73 20 74 6f 20 70 k. B tries to p
15730 72 6f 6d 6f 74 65 20 74 6f 20 65 78 63 6c 75 73 romote to exclus
15740 69 76 65 20 62 75 74 20 69 73 20 62 6c 6f 63 6b ive but is block
15750 65 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 6f 66 ed because.** of
15760 20 41 27 73 20 72 65 61 64 20 6c 6f 63 6b 2e 20 A's read lock.
15770 20 41 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d A tries to prom
15780 6f 74 65 20 74 6f 20 72 65 73 65 72 76 65 64 20 ote to reserved
15790 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 but is blocked b
157a0 79 20 42 2e 0a 2a 2a 20 4f 6e 65 20 6f 72 20 74 y B..** One or t
157b0 68 65 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 he other of the
157c0 74 77 6f 20 70 72 6f 63 65 73 73 65 73 20 6d 75 two processes mu
157d0 73 74 20 67 69 76 65 20 77 61 79 20 6f 72 20 74 st give way or t
157e0 68 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 6e here can be.** n
157f0 6f 20 70 72 6f 67 72 65 73 73 2e 20 20 42 79 20 o progress. By
15800 72 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 returning SQLITE
15810 5f 42 55 53 59 20 61 6e 64 20 6e 6f 74 20 69 6e _BUSY and not in
15820 76 6f 6b 69 6e 67 20 74 68 65 20 62 75 73 79 20 voking the busy
15830 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 77 68 65 6e callback.** when
15840 20 41 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 A already has a
15850 20 72 65 61 64 20 6c 6f 63 6b 2c 20 77 65 20 65 read lock, we e
15860 6e 63 6f 75 72 61 67 65 20 41 20 74 6f 20 67 69 ncourage A to gi
15870 76 65 20 75 70 20 61 6e 64 20 6c 65 74 20 42 0a ve up and let B.
15880 2a 2a 20 70 72 6f 63 65 65 64 2e 0a 2a 2f 0a 69 ** proceed..*/.i
15890 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 nt sqlite3BtreeB
158a0 65 67 69 6e 54 72 61 6e 73 28 42 74 72 65 65 20 eginTrans(Btree
158b0 2a 70 2c 20 69 6e 74 20 77 72 66 6c 61 67 29 7b *p, int wrflag){
158c0 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f . sqlite3 *pBlo
158d0 63 6b 20 3d 20 30 3b 0a 20 20 42 74 53 68 61 72 ck = 0;. BtShar
158e0 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
158f0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
15900 49 54 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c 69 74 ITE_OK;.. sqlit
15910 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
15920 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 . btreeIntegrit
15930 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 y(p);.. /* If t
15940 68 65 20 62 74 72 65 65 20 69 73 20 61 6c 72 65 he btree is alre
15950 61 64 79 20 69 6e 20 61 20 77 72 69 74 65 2d 74 ady in a write-t
15960 72 61 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 20 69 ransaction, or i
15970 74 0a 20 20 2a 2a 20 69 73 20 61 6c 72 65 61 64 t. ** is alread
15980 79 20 69 6e 20 61 20 72 65 61 64 2d 74 72 61 6e y in a read-tran
15990 73 61 63 74 69 6f 6e 20 61 6e 64 20 61 20 72 65 saction and a re
159a0 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 ad-transaction.
159b0 20 2a 2a 20 69 73 20 72 65 71 75 65 73 74 65 64 ** is requested
159c0 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f , this is a no-o
159d0 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d p.. */. if( p-
159e0 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
159f0 57 52 49 54 45 20 7c 7c 20 28 70 2d 3e 69 6e 54 WRITE || (p->inT
15a00 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 41 44 rans==TRANS_READ
15a10 20 26 26 20 21 77 72 66 6c 61 67 29 20 29 7b 0a && !wrflag) ){.
15a20 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 goto trans_b
15a30 65 67 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 73 65 egun;. }. asse
15a40 72 74 28 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 rt( IfNotOmitAV(
15a50 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 pBt->bDoTruncate
15a60 29 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 57 72 )==0 );.. /* Wr
15a70 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 ite transactions
15a80 20 61 72 65 20 6e 6f 74 20 70 6f 73 73 69 62 6c are not possibl
15a90 65 20 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c 79 e on a read-only
15aa0 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 database */. i
15ab0 66 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 f( (pBt->btsFlag
15ac0 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
15ad0 59 29 21 3d 30 20 26 26 20 77 72 66 6c 61 67 20 Y)!=0 && wrflag
15ae0 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 ){. rc = SQLI
15af0 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 TE_READONLY;.
15b00 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 goto trans_begu
15b10 6e 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 n;. }..#ifndef
15b20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
15b30 45 44 5f 43 41 43 48 45 0a 20 20 2f 2a 20 49 66 ED_CACHE. /* If
15b40 20 61 6e 6f 74 68 65 72 20 64 61 74 61 62 61 73 another databas
15b50 65 20 68 61 6e 64 6c 65 20 68 61 73 20 61 6c 72 e handle has alr
15b60 65 61 64 79 20 6f 70 65 6e 65 64 20 61 20 77 72 eady opened a wr
15b70 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite transaction
15b80 0a 20 20 2a 2a 20 6f 6e 20 74 68 69 73 20 73 68 . ** on this sh
15b90 61 72 65 64 2d 62 74 72 65 65 20 73 74 72 75 63 ared-btree struc
15ba0 74 75 72 65 20 61 6e 64 20 61 20 73 65 63 6f 6e ture and a secon
15bb0 64 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 d write transact
15bc0 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 72 65 71 75 ion is. ** requ
15bd0 65 73 74 65 64 2c 20 72 65 74 75 72 6e 20 53 51 ested, return SQ
15be0 4c 49 54 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 2a LITE_LOCKED.. *
15bf0 2f 0a 20 20 69 66 28 20 28 77 72 66 6c 61 67 20 /. if( (wrflag
15c00 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 && pBt->inTransa
15c10 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 ction==TRANS_WRI
15c20 54 45 29 0a 20 20 20 7c 7c 20 28 70 42 74 2d 3e TE). || (pBt->
15c30 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 btsFlags & BTS_P
15c40 45 4e 44 49 4e 47 29 21 3d 30 0a 20 20 29 7b 0a ENDING)!=0. ){.
15c50 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 74 pBlock = pBt
15c60 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a 20 ->pWriter->db;.
15c70 20 7d 65 6c 73 65 20 69 66 28 20 77 72 66 6c 61 }else if( wrfla
15c80 67 3e 31 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 g>1 ){. BtLoc
15c90 6b 20 2a 70 49 74 65 72 3b 0a 20 20 20 20 66 6f k *pIter;. fo
15ca0 72 28 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f r(pIter=pBt->pLo
15cb0 63 6b 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 ck; pIter; pIter
15cc0 3d 70 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a =pIter->pNext){.
15cd0 20 20 20 20 20 20 69 66 28 20 70 49 74 65 72 2d if( pIter-
15ce0 3e 70 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 20 >pBtree!=p ){.
15cf0 20 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 pBlock = p
15d00 49 74 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 Iter->pBtree->db
15d10 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b ;. break;
15d20 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
15d30 20 7d 0a 20 20 69 66 28 20 70 42 6c 6f 63 6b 20 }. if( pBlock
15d40 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f ){. sqlite3Co
15d50 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 nnectionBlocked(
15d60 70 2d 3e 64 62 2c 20 70 42 6c 6f 63 6b 29 3b 0a p->db, pBlock);.
15d70 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
15d80 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 LOCKED_SHAREDCAC
15d90 48 45 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 HE;. goto tra
15da0 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 23 65 ns_begun;. }.#e
15db0 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 72 ndif.. /* Any r
15dc0 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 64 ead-only or read
15dd0 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 -write transacti
15de0 6f 6e 20 69 6d 70 6c 69 65 73 20 61 20 72 65 61 on implies a rea
15df0 64 2d 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a 20 d-lock on . **
15e00 70 61 67 65 20 31 2e 20 53 6f 20 69 66 20 73 6f page 1. So if so
15e10 6d 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 2d me other shared-
15e20 63 61 63 68 65 20 63 6c 69 65 6e 74 20 61 6c 72 cache client alr
15e30 65 61 64 79 20 68 61 73 20 61 20 77 72 69 74 65 eady has a write
15e40 2d 6c 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 70 -lock . ** on p
15e50 61 67 65 20 31 2c 20 74 68 65 20 74 72 61 6e 73 age 1, the trans
15e60 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 65 action cannot be
15e70 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 63 opened. */. rc
15e80 20 3d 20 71 75 65 72 79 53 68 61 72 65 64 43 61 = querySharedCa
15e90 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 cheTableLock(p,
15ea0 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 41 MASTER_ROOT, REA
15eb0 44 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 53 D_LOCK);. if( S
15ec0 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 67 QLITE_OK!=rc ) g
15ed0 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b oto trans_begun;
15ee0 0a 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 .. pBt->btsFlag
15ef0 73 20 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 41 s &= ~BTS_INITIA
15f00 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 28 LLY_EMPTY;. if(
15f10 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 29 pBt->nPage==0 )
15f20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c pBt->btsFlags |
15f30 3d 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f = BTS_INITIALLY_
15f40 45 4d 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 20 EMPTY;. do {.
15f50 20 20 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 74 /* Call lockBt
15f60 72 65 65 28 29 20 75 6e 74 69 6c 20 65 69 74 68 ree() until eith
15f70 65 72 20 70 42 74 2d 3e 70 50 61 67 65 31 20 69 er pBt->pPage1 i
15f80 73 20 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a 20 s populated or.
15f90 20 20 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 28 ** lockBtree(
15fa0 29 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 ) returns someth
15fb0 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 53 ing other than S
15fc0 51 4c 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 74 QLITE_OK. lockBt
15fd0 72 65 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 79 ree(). ** may
15fe0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
15ff0 4b 20 62 75 74 20 6c 65 61 76 65 20 70 42 74 2d K but leave pBt-
16000 3e 70 50 61 67 65 31 20 73 65 74 20 74 6f 20 30 >pPage1 set to 0
16010 20 69 66 20 61 66 74 65 72 0a 20 20 20 20 2a 2a if after. **
16020 20 72 65 61 64 69 6e 67 20 70 61 67 65 20 31 20 reading page 1
16030 69 74 20 64 69 73 63 6f 76 65 72 73 20 74 68 61 it discovers tha
16040 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 t the page-size
16050 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
16060 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 20 . ** file is
16070 6e 6f 74 20 70 42 74 2d 3e 70 61 67 65 53 69 7a not pBt->pageSiz
16080 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 e. In this case
16090 6c 6f 63 6b 42 74 72 65 65 28 29 20 77 69 6c 6c lockBtree() will
160a0 20 75 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 70 update. ** p
160b0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f 20 Bt->pageSize to
160c0 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 the page-size of
160d0 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 the file on dis
160e0 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 68 k.. */. wh
160f0 69 6c 65 28 20 70 42 74 2d 3e 70 50 61 67 65 31 ile( pBt->pPage1
16100 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b ==0 && SQLITE_OK
16110 3d 3d 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 65 ==(rc = lockBtre
16120 65 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 20 e(pBt)) );..
16130 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
16140 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 K && wrflag ){.
16150 20 20 20 20 20 69 66 28 20 28 70 42 74 2d 3e 62 if( (pBt->b
16160 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 tsFlags & BTS_RE
16170 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a 20 AD_ONLY)!=0 ){.
16180 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
16190 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 TE_READONLY;.
161a0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
161b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
161c0 67 65 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 50 gerBegin(pBt->pP
161d0 61 67 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 71 ager,wrflag>1,sq
161e0 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 lite3TempInMemor
161f0 79 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20 y(p->db));.
16200 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
16210 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
16220 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 rc = newDataba
16230 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 se(pBt);.
16240 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
16250 0a 20 20 0a 20 20 20 20 69 66 28 20 72 63 21 3d . . if( rc!=
16260 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
16270 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 unlockBtreeIf
16280 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 Unused(pBt);.
16290 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 63 }. }while( (rc
162a0 26 30 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f 42 &0xFF)==SQLITE_B
162b0 55 53 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 USY && pBt->inTr
162c0 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
162d0 5f 4e 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 20 _NONE &&.
162e0 20 20 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 btreeInvokeBu
162f0 73 79 48 61 6e 64 6c 65 72 28 70 42 74 29 20 29 syHandler(pBt) )
16300 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c ;.. if( rc==SQL
16310 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 ITE_OK ){. if
16320 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 ( p->inTrans==TR
16330 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 ANS_NONE ){.
16340 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 pBt->nTransact
16350 69 6f 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 53 ion++;.#ifndef S
16360 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
16370 44 5f 43 41 43 48 45 0a 20 20 20 20 20 20 69 66 D_CACHE. if
16380 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b ( p->sharable ){
16390 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
163a0 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 3d p->lock.pBtree=
163b0 3d 70 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 54 =p && p->lock.iT
163c0 61 62 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 20 20 able==1 );.
163d0 20 20 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 6b p->lock.eLock
163e0 20 3d 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 = READ_LOCK;.
163f0 20 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 4e p->lock.pN
16400 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 6b ext = pBt->pLock
16410 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 70 ;. pBt->p
16420 4c 6f 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b 3b Lock = &p->lock;
16430 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a . }.#endif.
16440 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 6e 54 }. p->inT
16450 72 61 6e 73 20 3d 20 28 77 72 66 6c 61 67 3f 54 rans = (wrflag?T
16460 52 41 4e 53 5f 57 52 49 54 45 3a 54 52 41 4e 53 RANS_WRITE:TRANS
16470 5f 52 45 41 44 29 3b 0a 20 20 20 20 69 66 28 20 _READ);. if(
16480 70 2d 3e 69 6e 54 72 61 6e 73 3e 70 42 74 2d 3e p->inTrans>pBt->
16490 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b inTransaction ){
164a0 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 . pBt->inTr
164b0 61 6e 73 61 63 74 69 6f 6e 20 3d 20 70 2d 3e 69 ansaction = p->i
164c0 6e 54 72 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 20 nTrans;. }.
164d0 20 20 69 66 28 20 77 72 66 6c 61 67 20 29 7b 0a if( wrflag ){.
164e0 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 MemPage *p
164f0 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 Page1 = pBt->pPa
16500 67 65 31 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c ge1;.#ifndef SQL
16510 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
16520 43 41 43 48 45 0a 20 20 20 20 20 20 61 73 73 65 CACHE. asse
16530 72 74 28 20 21 70 42 74 2d 3e 70 57 72 69 74 65 rt( !pBt->pWrite
16540 72 20 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e r );. pBt->
16550 70 57 72 69 74 65 72 20 3d 20 70 3b 0a 20 20 20 pWriter = p;.
16560 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 pBt->btsFlags
16570 20 26 3d 20 7e 42 54 53 5f 45 58 43 4c 55 53 49 &= ~BTS_EXCLUSI
16580 56 45 3b 0a 20 20 20 20 20 20 69 66 28 20 77 72 VE;. if( wr
16590 66 6c 61 67 3e 31 20 29 20 70 42 74 2d 3e 62 74 flag>1 ) pBt->bt
165a0 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 45 58 sFlags |= BTS_EX
165b0 43 4c 55 53 49 56 45 3b 0a 23 65 6e 64 69 66 0a CLUSIVE;.#endif.
165c0 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 . /* If the
165d0 20 64 62 2d 73 69 7a 65 20 68 65 61 64 65 72 20 db-size header
165e0 66 69 65 6c 64 20 69 73 20 69 6e 63 6f 72 72 65 field is incorre
165f0 63 74 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 ct (as it may be
16600 20 69 66 20 61 6e 20 6f 6c 64 0a 20 20 20 20 20 if an old.
16610 20 2a 2a 20 63 6c 69 65 6e 74 20 68 61 73 20 62 ** client has b
16620 65 65 6e 20 77 72 69 74 69 6e 67 20 74 68 65 20 een writing the
16630 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 2c 20 database file),
16640 75 70 64 61 74 65 20 69 74 20 6e 6f 77 2e 20 44 update it now. D
16650 6f 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 74 68 oing. ** th
16660 69 73 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 72 is sooner rather
16670 20 74 68 61 6e 20 6c 61 74 65 72 20 6d 65 61 6e than later mean
16680 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 s the database s
16690 69 7a 65 20 63 61 6e 20 73 61 66 65 6c 79 20 0a ize can safely .
166a0 20 20 20 20 20 20 2a 2a 20 72 65 2d 72 65 61 64 ** re-read
166b0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 69 the database si
166c0 7a 65 20 66 72 6f 6d 20 70 61 67 65 20 31 20 69 ze from page 1 i
166d0 66 20 61 20 73 61 76 65 70 6f 69 6e 74 20 6f 72 f a savepoint or
166e0 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 transaction.
166f0 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6f ** rollback o
16700 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 ccurs within the
16710 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 transaction..
16720 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 */. if(
16730 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 67 65 74 pBt->nPage!=get
16740 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
16750 44 61 74 61 5b 32 38 5d 29 20 29 7b 0a 20 20 20 Data[28]) ){.
16760 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
16770 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 3PagerWrite(pPag
16780 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e1->pDbPage);.
16790 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
167a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
167b0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
167c0 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d Page1->aData[28]
167d0 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 , pBt->nPage);.
167e0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
167f0 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 61 . }. }...tra
16800 6e 73 5f 62 65 67 75 6e 3a 0a 20 20 69 66 28 20 ns_begun:. if(
16810 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
16820 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 20 2f wrflag ){. /
16830 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 61 6b 65 * This call make
16840 73 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20 s sure that the
16850 70 61 67 65 72 20 68 61 73 20 74 68 65 20 63 6f pager has the co
16860 72 72 65 63 74 20 6e 75 6d 62 65 72 20 6f 66 0a rrect number of.
16870 20 20 20 20 2a 2a 20 6f 70 65 6e 20 73 61 76 65 ** open save
16880 70 6f 69 6e 74 73 2e 20 49 66 20 74 68 65 20 73 points. If the s
16890 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 econd parameter
168a0 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
168b0 30 20 61 6e 64 0a 20 20 20 20 2a 2a 20 74 68 65 0 and. ** the
168c0 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 sub-journal is
168d0 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e not already open
168e0 2c 20 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 , then it will b
168f0 65 20 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a 20 e opened here..
16900 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 */. rc = s
16910 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e 53 qlite3PagerOpenS
16920 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 avepoint(pBt->pP
16930 61 67 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 61 ager, p->db->nSa
16940 76 65 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a 20 vepoint);. }..
16950 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 btreeIntegrity(
16960 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 p);. sqlite3Btr
16970 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
16980 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e turn rc;.}..#ifn
16990 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
169a0 41 55 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a 2a AUTOVACUUM../*.*
169b0 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e 74 65 * Set the pointe
169c0 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f r-map entries fo
169d0 72 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f r all children o
169e0 66 20 70 61 67 65 20 70 50 61 67 65 2e 20 41 6c f page pPage. Al
169f0 73 6f 2c 20 69 66 0a 2a 2a 20 70 50 61 67 65 20 so, if.** pPage
16a00 63 6f 6e 74 61 69 6e 73 20 63 65 6c 6c 73 20 74 contains cells t
16a10 68 61 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 65 hat point to ove
16a20 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 73 65 74 rflow pages, set
16a30 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 the pointer.**
16a40 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 map entries for
16a50 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 the overflow pag
16a60 65 73 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 73 es as well..*/.s
16a70 74 61 74 69 63 20 69 6e 74 20 73 65 74 43 68 69 tatic int setChi
16a80 6c 64 50 74 72 6d 61 70 73 28 4d 65 6d 50 61 67 ldPtrmaps(MemPag
16a90 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 e *pPage){. int
16aa0 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
16ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16ac0 2f 2a 20 43 6f 75 6e 74 65 72 20 76 61 72 69 61 /* Counter varia
16ad0 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 ble */. int nCe
16ae0 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ll;
16af0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
16b00 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 umber of cells i
16b10 6e 20 70 61 67 65 20 70 50 61 67 65 20 2a 2f 0a n page pPage */.
16b20 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
16b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16b40 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
16b50 6f 64 65 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 ode */. BtShare
16b60 64 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e d *pBt = pPage->
16b70 70 42 74 3b 0a 20 20 75 38 20 69 73 49 6e 69 74 pBt;. u8 isInit
16b80 4f 72 69 67 20 3d 20 70 50 61 67 65 2d 3e 69 73 Orig = pPage->is
16b90 49 6e 69 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e Init;. Pgno pgn
16ba0 6f 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3b o = pPage->pgno;
16bb0 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
16bc0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
16bd0 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
16be0 29 20 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 ) );. rc = btre
16bf0 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 eInitPage(pPage)
16c00 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
16c10 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 TE_OK ){. got
16c20 6f 20 73 65 74 5f 63 68 69 6c 64 5f 70 74 72 6d o set_child_ptrm
16c30 61 70 73 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 6e aps_out;. }. n
16c40 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 Cell = pPage->nC
16c50 65 6c 6c 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b ell;.. for(i=0;
16c60 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a i<nCell; i++){.
16c70 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 u8 *pCell =
16c80 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
16c90 69 29 3b 0a 0a 20 20 20 20 70 74 72 6d 61 70 50 i);.. ptrmapP
16ca0 75 74 4f 76 66 6c 50 74 72 28 70 50 61 67 65 2c utOvflPtr(pPage,
16cb0 20 70 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a 20 pCell, &rc);..
16cc0 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c if( !pPage->l
16cd0 65 61 66 20 29 7b 0a 20 20 20 20 20 20 50 67 6e eaf ){. Pgn
16ce0 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 o childPgno = ge
16cf0 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a 20 t4byte(pCell);.
16d00 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 ptrmapPut(p
16d10 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 50 Bt, childPgno, P
16d20 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 6e TRMAP_BTREE, pgn
16d30 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 o, &rc);. }.
16d40 20 7d 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65 }.. if( !pPage
16d50 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 ->leaf ){. Pg
16d60 6e 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 no childPgno = g
16d70 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e et4byte(&pPage->
16d80 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 aData[pPage->hdr
16d90 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 Offset+8]);.
16da0 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 63 ptrmapPut(pBt, c
16db0 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 50 hildPgno, PTRMAP
16dc0 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 72 _BTREE, pgno, &r
16dd0 63 29 3b 0a 20 20 7d 0a 0a 73 65 74 5f 63 68 69 c);. }..set_chi
16de0 6c 64 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3a 0a ld_ptrmaps_out:.
16df0 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 pPage->isInit
16e00 3d 20 69 73 49 6e 69 74 4f 72 69 67 3b 0a 20 20 = isInitOrig;.
16e10 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
16e20 0a 2a 2a 20 53 6f 6d 65 77 68 65 72 65 20 6f 6e .** Somewhere on
16e30 20 70 50 61 67 65 20 69 73 20 61 20 70 6f 69 6e pPage is a poin
16e40 74 65 72 20 74 6f 20 70 61 67 65 20 69 46 72 6f ter to page iFro
16e50 6d 2e 20 20 4d 6f 64 69 66 79 20 74 68 69 73 20 m. Modify this
16e60 70 6f 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 74 68 pointer so.** th
16e70 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 at it points to
16e80 69 54 6f 2e 20 50 61 72 61 6d 65 74 65 72 20 65 iTo. Parameter e
16e90 54 79 70 65 20 64 65 73 63 72 69 62 65 73 20 74 Type describes t
16ea0 68 65 20 74 79 70 65 20 6f 66 20 70 6f 69 6e 74 he type of point
16eb0 65 72 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f 64 69 er to.** be modi
16ec0 66 69 65 64 2c 20 61 73 20 20 66 6f 6c 6c 6f 77 fied, as follow
16ed0 73 3a 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f s:.**.** PTRMAP_
16ee0 42 54 52 45 45 3a 20 20 20 20 20 70 50 61 67 65 BTREE: pPage
16ef0 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 is a btree-page
16f00 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f . The pointer po
16f10 69 6e 74 73 20 61 74 20 61 20 63 68 69 6c 64 20 ints at a child
16f20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
16f30 20 20 20 20 20 20 70 61 67 65 20 6f 66 20 70 50 page of pP
16f40 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 age..**.** PTRMA
16f50 50 5f 4f 56 45 52 46 4c 4f 57 31 3a 20 70 50 61 P_OVERFLOW1: pPa
16f60 67 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 ge is a btree-pa
16f70 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 ge. The pointer
16f80 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 6f 76 65 points at an ove
16f90 72 66 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 rflow.**
16fa0 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 20 page
16fb0 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 6f 6e pointed to by on
16fc0 65 20 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 6f e of the cells o
16fd0 6e 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 n pPage..**.** P
16fe0 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 3a TRMAP_OVERFLOW2:
16ff0 20 70 50 61 67 65 20 69 73 20 61 6e 20 6f 76 65 pPage is an ove
17000 72 66 6c 6f 77 2d 70 61 67 65 2e 20 54 68 65 20 rflow-page. The
17010 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 pointer points a
17020 74 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 20 20 t the next.**
17030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17040 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e overflow page in
17050 20 74 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 the list..*/.st
17060 61 74 69 63 20 69 6e 74 20 6d 6f 64 69 66 79 50 atic int modifyP
17070 61 67 65 50 6f 69 6e 74 65 72 28 4d 65 6d 50 61 agePointer(MemPa
17080 67 65 20 2a 70 50 61 67 65 2c 20 50 67 6e 6f 20 ge *pPage, Pgno
17090 69 46 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 6f 2c iFrom, Pgno iTo,
170a0 20 75 38 20 65 54 79 70 65 29 7b 0a 20 20 61 73 u8 eType){. as
170b0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
170c0 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
170d0 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
170e0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
170f0 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
17100 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
17110 20 29 3b 0a 20 20 69 66 28 20 65 54 79 70 65 3d );. if( eType=
17120 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 =PTRMAP_OVERFLOW
17130 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 2 ){. /* The
17140 70 6f 69 6e 74 65 72 20 69 73 20 61 6c 77 61 79 pointer is alway
17150 73 20 74 68 65 20 66 69 72 73 74 20 34 20 62 79 s the first 4 by
17160 74 65 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 tes of the page
17170 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a in this case. *
17180 2f 0a 20 20 20 20 69 66 28 20 67 65 74 34 62 79 /. if( get4by
17190 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 te(pPage->aData)
171a0 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 !=iFrom ){.
171b0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
171c0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
171d0 20 7d 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 }. put4byte(
171e0 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 54 pPage->aData, iT
171f0 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 o);. }else{.
17200 20 75 38 20 69 73 49 6e 69 74 4f 72 69 67 20 3d u8 isInitOrig =
17210 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 3b 0a pPage->isInit;.
17220 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 int i;. i
17230 6e 74 20 6e 43 65 6c 6c 3b 0a 0a 20 20 20 20 62 nt nCell;.. b
17240 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 treeInitPage(pPa
17250 67 65 29 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 3d ge);. nCell =
17260 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a pPage->nCell;..
17270 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e for(i=0; i<n
17280 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 Cell; i++){.
17290 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 u8 *pCell = fi
172a0 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 ndCell(pPage, i)
172b0 3b 0a 20 20 20 20 20 20 69 66 28 20 65 54 79 70 ;. if( eTyp
172c0 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c e==PTRMAP_OVERFL
172d0 4f 57 31 20 29 7b 0a 20 20 20 20 20 20 20 20 43 OW1 ){. C
172e0 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 ellInfo info;.
172f0 20 20 20 20 20 20 62 74 72 65 65 50 61 72 73 65 btreeParse
17300 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 CellPtr(pPage, p
17310 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 Cell, &info);.
17320 20 20 20 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 if( info.i
17330 4f 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 Overflow.
17340 20 20 26 26 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e && pCell+info.
17350 69 4f 76 65 72 66 6c 6f 77 2b 33 3c 3d 70 50 61 iOverflow+3<=pPa
17360 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d ge->aData+pPage-
17370 3e 6d 61 73 6b 50 61 67 65 0a 20 20 20 20 20 20 >maskPage.
17380 20 20 20 26 26 20 69 46 72 6f 6d 3d 3d 67 65 74 && iFrom==get
17390 34 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 4byte(&pCell[inf
173a0 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d 29 0a 20 20 o.iOverflow]).
173b0 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
173c0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 43 65 put4byte(&pCe
173d0 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f ll[info.iOverflo
173e0 77 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 w], iTo);.
173f0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
17400 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
17410 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 67 65 {. if( ge
17420 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3d 3d 69 t4byte(pCell)==i
17430 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 From ){.
17440 20 20 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c put4byte(pCell
17450 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 , iTo);.
17460 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
17470 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
17480 0a 20 20 0a 20 20 20 20 69 66 28 20 69 3d 3d 6e . . if( i==n
17490 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 Cell ){. if
174a0 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f ( eType!=PTRMAP_
174b0 42 54 52 45 45 20 7c 7c 20 0a 20 20 20 20 20 20 BTREE || .
174c0 20 20 20 20 67 65 74 34 62 79 74 65 28 26 70 50 get4byte(&pP
174d0 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 age->aData[pPage
174e0 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 21 ->hdrOffset+8])!
174f0 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 =iFrom ){.
17500 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
17510 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
17520 20 20 20 20 7d 0a 20 20 20 20 20 20 70 75 74 34 }. put4
17530 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 byte(&pPage->aDa
17540 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 ta[pPage->hdrOff
17550 73 65 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 20 set+8], iTo);.
17560 20 20 7d 0a 0a 20 20 20 20 70 50 61 67 65 2d 3e }.. pPage->
17570 69 73 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 4f isInit = isInitO
17580 72 69 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 rig;. }. retur
17590 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
175a0 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
175b0 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 70 61 open database pa
175c0 67 65 20 70 44 62 50 61 67 65 20 74 6f 20 6c 6f ge pDbPage to lo
175d0 63 61 74 69 6f 6e 20 69 46 72 65 65 50 61 67 65 cation iFreePage
175e0 20 69 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 in the .** data
175f0 62 61 73 65 2e 20 54 68 65 20 70 44 62 50 61 67 base. The pDbPag
17600 65 20 72 65 66 65 72 65 6e 63 65 20 72 65 6d 61 e reference rema
17610 69 6e 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a ins valid..**.**
17620 20 54 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 6c The isCommit fl
17630 61 67 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 ag indicates tha
17640 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 t there is no ne
17650 65 64 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 74 ed to remember t
17660 68 61 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e hat.** the journ
17670 61 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 al needs to be s
17680 79 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 64 ync()ed before d
17690 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
176a0 50 61 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 63 Page->pgno .** c
176b0 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f an be written to
176c0 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 68 61 73 . The caller has
176d0 20 61 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 65 already promise
176e0 64 20 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 74 d not to write t
176f0 6f 20 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e 0a o that.** page..
17700 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 */.static int re
17710 6c 6f 63 61 74 65 50 61 67 65 28 0a 20 20 42 74 locatePage(. Bt
17720 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 Shared *pBt,
17730 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 /* Btree
17740 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 44 */. MemPage *pD
17750 62 50 61 67 65 2c 20 20 20 20 20 20 20 20 2f 2a bPage, /*
17760 20 4f 70 65 6e 20 70 61 67 65 20 74 6f 20 6d 6f Open page to mo
17770 76 65 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 65 ve */. u8 eType
17780 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
17790 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
177a0 27 74 79 70 65 27 20 65 6e 74 72 79 20 66 6f 72 'type' entry for
177b0 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 pDbPage */. Pg
177c0 6e 6f 20 69 50 74 72 50 61 67 65 2c 20 20 20 20 no iPtrPage,
177d0 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
177e0 72 20 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 20 r map 'page-no'
177f0 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 61 67 entry for pDbPag
17800 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 65 e */. Pgno iFre
17810 65 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 ePage,
17820 2f 2a 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e 20 /* The location
17830 74 6f 20 6d 6f 76 65 20 70 44 62 50 61 67 65 20 to move pDbPage
17840 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f to */. int isCo
17850 6d 6d 69 74 20 20 20 20 20 20 20 20 20 20 20 20 mmit
17860 20 2f 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 /* isCommit fla
17870 67 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 g passed to sqli
17880 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 te3PagerMovepage
17890 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 */.){. MemPage
178a0 20 2a 70 50 74 72 50 61 67 65 3b 20 20 20 2f 2a *pPtrPage; /*
178b0 20 54 68 65 20 70 61 67 65 20 74 68 61 74 20 63 The page that c
178c0 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 ontains a pointe
178d0 72 20 74 6f 20 70 44 62 50 61 67 65 20 2a 2f 0a r to pDbPage */.
178e0 20 20 50 67 6e 6f 20 69 44 62 50 61 67 65 20 3d Pgno iDbPage =
178f0 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a pDbPage->pgno;.
17900 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
17910 3d 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 = pBt->pPager;.
17920 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
17930 72 74 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 rt( eType==PTRMA
17940 50 5f 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 65 P_OVERFLOW2 || e
17950 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 Type==PTRMAP_OVE
17960 52 46 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 20 RFLOW1 || .
17970 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 eType==PTRMAP_B
17980 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 TREE || eType==P
17990 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 TRMAP_ROOTPAGE )
179a0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
179b0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
179c0 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
179d0 61 73 73 65 72 74 28 20 70 44 62 50 61 67 65 2d assert( pDbPage-
179e0 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 20 >pBt==pBt );..
179f0 2f 2a 20 4d 6f 76 65 20 70 61 67 65 20 69 44 62 /* Move page iDb
17a00 50 61 67 65 20 66 72 6f 6d 20 69 74 73 20 63 75 Page from its cu
17a10 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 74 rrent location t
17a20 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 46 o page number iF
17a30 72 65 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 41 reePage */. TRA
17a40 43 45 28 28 22 41 55 54 4f 56 41 43 55 55 4d 3a CE(("AUTOVACUUM:
17a50 20 4d 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 72 Moving %d to fr
17a60 65 65 20 70 61 67 65 20 25 64 20 28 70 74 72 20 ee page %d (ptr
17a70 70 61 67 65 20 25 64 20 74 79 70 65 20 25 64 29 page %d type %d)
17a80 5c 6e 22 2c 20 0a 20 20 20 20 20 20 69 44 62 50 \n", . iDbP
17a90 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 age, iFreePage,
17aa0 69 50 74 72 50 61 67 65 2c 20 65 54 79 70 65 29 iPtrPage, eType)
17ab0 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
17ac0 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 70 3PagerMovepage(p
17ad0 50 61 67 65 72 2c 20 70 44 62 50 61 67 65 2d 3e Pager, pDbPage->
17ae0 70 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 pDbPage, iFreePa
17af0 67 65 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a 20 ge, isCommit);.
17b00 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
17b10 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
17b20 20 72 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 61 rc;. }. pDbPa
17b30 67 65 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 65 ge->pgno = iFree
17b40 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 Page;.. /* If p
17b50 44 62 50 61 67 65 20 77 61 73 20 61 20 62 74 72 DbPage was a btr
17b60 65 65 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 74 ee-page, then it
17b70 20 6d 61 79 20 68 61 76 65 20 63 68 69 6c 64 20 may have child
17b80 70 61 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 6c pages and/or cel
17b90 6c 73 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f 69 ls. ** that poi
17ba0 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 nt to overflow p
17bb0 61 67 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 65 ages. The pointe
17bc0 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f r map entries fo
17bd0 72 20 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a 2a r all these. **
17be0 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f 20 62 pages need to b
17bf0 65 20 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a 0a e changed.. **.
17c00 20 20 2a 2a 20 49 66 20 70 44 62 50 61 67 65 20 ** If pDbPage
17c10 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 is an overflow p
17c20 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 66 69 age, then the fi
17c30 72 73 74 20 34 20 62 79 74 65 73 20 6d 61 79 20 rst 4 bytes may
17c40 73 74 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f 69 store a. ** poi
17c50 6e 74 65 72 20 74 6f 20 61 20 73 75 62 73 65 71 nter to a subseq
17c60 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 uent overflow pa
17c70 67 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 74 ge. If this is t
17c80 68 65 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 20 he case, then.
17c90 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d ** the pointer m
17ca0 61 70 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 ap needs to be u
17cb0 70 64 61 74 65 64 20 66 6f 72 20 74 68 65 20 73 pdated for the s
17cc0 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 66 6c ubsequent overfl
17cd0 6f 77 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 ow page.. */.
17ce0 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
17cf0 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 P_BTREE || eType
17d00 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 ==PTRMAP_ROOTPAG
17d10 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 65 E ){. rc = se
17d20 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 70 44 tChildPtrmaps(pD
17d30 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 bPage);. if(
17d40 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
17d50 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
17d60 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b ;. }. }else{
17d70 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f 76 . Pgno nextOv
17d80 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 70 44 fl = get4byte(pD
17d90 62 50 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a 20 bPage->aData);.
17da0 20 20 20 69 66 28 20 6e 65 78 74 4f 76 66 6c 21 if( nextOvfl!
17db0 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d =0 ){. ptrm
17dc0 61 70 50 75 74 28 70 42 74 2c 20 6e 65 78 74 4f apPut(pBt, nextO
17dd0 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 vfl, PTRMAP_OVER
17de0 46 4c 4f 57 32 2c 20 69 46 72 65 65 50 61 67 65 FLOW2, iFreePage
17df0 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 69 66 , &rc);. if
17e00 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
17e10 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
17e20 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 n rc;. }.
17e30 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 }. }.. /* Fi
17e40 78 20 74 68 65 20 64 61 74 61 62 61 73 65 20 70 x the database p
17e50 6f 69 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 69 ointer on page i
17e60 50 74 72 50 61 67 65 20 74 68 61 74 20 70 6f 69 PtrPage that poi
17e70 6e 74 65 64 20 61 74 20 69 44 62 50 61 67 65 20 nted at iDbPage
17e80 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 20 so. ** that it
17e90 70 6f 69 6e 74 73 20 61 74 20 69 46 72 65 65 50 points at iFreeP
17ea0 61 67 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 68 age. Also fix th
17eb0 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e e pointer map en
17ec0 74 72 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 74 try for. ** iPt
17ed0 72 50 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 rPage.. */. if
17ee0 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f ( eType!=PTRMAP_
17ef0 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 ROOTPAGE ){.
17f00 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
17f10 65 28 70 42 74 2c 20 69 50 74 72 50 61 67 65 2c e(pBt, iPtrPage,
17f20 20 26 70 50 74 72 50 61 67 65 2c 20 30 2c 20 30 &pPtrPage, 0, 0
17f30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
17f40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
17f50 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
17f60 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 }. rc = sqli
17f70 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
17f80 74 72 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 trPage->pDbPage)
17f90 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
17fa0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
17fb0 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 releasePage(pPt
17fc0 72 50 61 67 65 29 3b 0a 20 20 20 20 20 20 72 65 rPage);. re
17fd0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
17fe0 20 20 20 72 63 20 3d 20 6d 6f 64 69 66 79 50 61 rc = modifyPa
17ff0 67 65 50 6f 69 6e 74 65 72 28 70 50 74 72 50 61 gePointer(pPtrPa
18000 67 65 2c 20 69 44 62 50 61 67 65 2c 20 69 46 72 ge, iDbPage, iFr
18010 65 65 50 61 67 65 2c 20 65 54 79 70 65 29 3b 0a eePage, eType);.
18020 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
18030 70 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 pPtrPage);. i
18040 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
18050 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 ){. ptrmap
18060 50 75 74 28 70 42 74 2c 20 69 46 72 65 65 50 61 Put(pBt, iFreePa
18070 67 65 2c 20 65 54 79 70 65 2c 20 69 50 74 72 50 ge, eType, iPtrP
18080 61 67 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d age, &rc);. }
18090 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
180a0 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 ;.}../* Forward
180b0 64 65 63 6c 61 72 61 74 69 6f 6e 20 72 65 71 75 declaration requ
180c0 69 72 65 64 20 62 79 20 69 6e 63 72 56 61 63 75 ired by incrVacu
180d0 75 6d 53 74 65 70 28 29 2e 20 2a 2f 0a 73 74 61 umStep(). */.sta
180e0 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 tic int allocate
180f0 42 74 72 65 65 50 61 67 65 28 42 74 53 68 61 72 BtreePage(BtShar
18100 65 64 20 2a 2c 20 4d 65 6d 50 61 67 65 20 2a 2a ed *, MemPage **
18110 2c 20 50 67 6e 6f 20 2a 2c 20 50 67 6e 6f 2c 20 , Pgno *, Pgno,
18120 75 38 29 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 66 u8);../*.** Perf
18130 6f 72 6d 20 61 20 73 69 6e 67 6c 65 20 73 74 65 orm a single ste
18140 70 20 6f 66 20 61 6e 20 69 6e 63 72 65 6d 65 6e p of an incremen
18150 74 61 6c 2d 76 61 63 75 75 6d 2e 20 49 66 20 73 tal-vacuum. If s
18160 75 63 63 65 73 73 66 75 6c 2c 20 72 65 74 75 72 uccessful, retur
18170 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 n.** SQLITE_OK.
18180 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 If there is no w
18190 6f 72 6b 20 74 6f 20 64 6f 20 28 61 6e 64 20 74 ork to do (and t
181a0 68 65 72 65 66 6f 72 65 20 6e 6f 20 70 6f 69 6e herefore no poin
181b0 74 20 69 6e 20 0a 2a 2a 20 63 61 6c 6c 69 6e 67 t in .** calling
181c0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 this function a
181d0 67 61 69 6e 29 2c 20 72 65 74 75 72 6e 20 53 51 gain), return SQ
181e0 4c 49 54 45 5f 44 4f 4e 45 2e 20 4f 72 2c 20 69 LITE_DONE. Or, i
181f0 66 20 61 6e 20 65 72 72 6f 72 20 0a 2a 2a 20 6f f an error .** o
18200 63 63 75 72 73 2c 20 72 65 74 75 72 6e 20 73 6f ccurs, return so
18210 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 me other error c
18220 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 ode..**.** More
18230 73 70 65 63 69 66 69 63 6c 79 2c 20 74 68 69 73 specificly, this
18240 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 function attemp
18250 74 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a ts to re-organiz
18260 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 e the database s
18270 6f 20 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 6c o .** that the l
18280 61 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 ast page of the
18290 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 69 file currently i
182a0 6e 20 75 73 65 20 69 73 20 6e 6f 20 6c 6f 6e 67 n use is no long
182b0 65 72 20 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a 2a er in use..**.**
182c0 20 50 61 72 61 6d 65 74 65 72 20 6e 46 69 6e 20 Parameter nFin
182d0 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
182e0 20 70 61 67 65 73 20 74 68 61 74 20 74 68 69 73 pages that this
182f0 20 64 61 74 61 62 61 73 65 20 77 6f 75 6c 64 20 database would
18300 63 6f 6e 74 61 69 6e 0a 2a 2a 20 77 65 72 65 20 contain.** were
18310 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 this function ca
18320 6c 6c 65 64 20 75 6e 74 69 6c 20 69 74 20 72 65 lled until it re
18330 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e turns SQLITE_DON
18340 45 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 E..**.** If the
18350 62 43 6f 6d 6d 69 74 20 70 61 72 61 6d 65 74 65 bCommit paramete
18360 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 r is non-zero, t
18370 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 his function ass
18380 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 0a 2a umes that the .*
18390 2a 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6b 65 * caller will ke
183a0 65 70 20 63 61 6c 6c 69 6e 67 20 69 6e 63 72 56 ep calling incrV
183b0 61 63 75 75 6d 53 74 65 70 28 29 20 75 6e 74 69 acuumStep() unti
183c0 6c 20 69 74 20 72 65 74 75 72 6e 73 20 53 51 4c l it returns SQL
183d0 49 54 45 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 20 ITE_DONE .** or
183e0 61 6e 20 65 72 72 6f 72 2e 20 62 43 6f 6d 6d 69 an error. bCommi
183f0 74 20 69 73 20 70 61 73 73 65 64 20 74 72 75 65 t is passed true
18400 20 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 for an auto-vac
18410 75 75 6d 2d 6f 6e 2d 63 6f 6d 6d 6d 69 74 20 0a uum-on-commmit .
18420 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 2c 20 6f 72 ** operation, or
18430 20 66 61 6c 73 65 20 66 6f 72 20 61 6e 20 69 6e false for an in
18440 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
18450 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
18460 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 42 incrVacuumStep(B
18470 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
18480 6e 6f 20 6e 46 69 6e 2c 20 50 67 6e 6f 20 69 4c no nFin, Pgno iL
18490 61 73 74 50 67 2c 20 69 6e 74 20 62 43 6f 6d 6d astPg, int bComm
184a0 69 74 29 7b 0a 20 20 50 67 6e 6f 20 6e 46 72 65 it){. Pgno nFre
184b0 65 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 eList;
184c0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
184d0 67 65 73 20 73 74 69 6c 6c 20 6f 6e 20 74 68 65 ges still on the
184e0 20 66 72 65 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 free-list */.
184f0 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
18500 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
18510 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
18520 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 ) );. assert( i
18530 4c 61 73 74 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a LastPg>nFin );..
18540 20 20 69 66 28 20 21 50 54 52 4d 41 50 5f 49 53 if( !PTRMAP_IS
18550 50 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 PAGE(pBt, iLastP
18560 67 29 20 26 26 20 69 4c 61 73 74 50 67 21 3d 50 g) && iLastPg!=P
18570 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
18580 28 70 42 74 29 20 29 7b 0a 20 20 20 20 75 38 20 (pBt) ){. u8
18590 65 54 79 70 65 3b 0a 20 20 20 20 50 67 6e 6f 20 eType;. Pgno
185a0 69 50 74 72 50 61 67 65 3b 0a 0a 20 20 20 20 6e iPtrPage;.. n
185b0 46 72 65 65 4c 69 73 74 20 3d 20 67 65 74 34 62 FreeList = get4b
185c0 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 yte(&pBt->pPage1
185d0 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 ->aData[36]);.
185e0 20 20 69 66 28 20 6e 46 72 65 65 4c 69 73 74 3d if( nFreeList=
185f0 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 =0 ){. retu
18600 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a rn SQLITE_DONE;.
18610 20 20 20 20 7d 0a 0a 20 20 20 20 72 63 20 3d 20 }.. rc =
18620 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 69 ptrmapGet(pBt, i
18630 4c 61 73 74 50 67 2c 20 26 65 54 79 70 65 2c 20 LastPg, &eType,
18640 26 69 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 &iPtrPage);.
18650 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
18660 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 K ){. retur
18670 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
18680 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
18690 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 P_ROOTPAGE ){.
186a0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
186b0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
186c0 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 65 }.. if( e
186d0 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 52 45 Type==PTRMAP_FRE
186e0 45 50 41 47 45 20 29 7b 0a 20 20 20 20 20 20 69 EPAGE ){. i
186f0 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b f( bCommit==0 ){
18700 0a 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f . /* Remo
18710 76 65 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d ve the page from
18720 20 74 68 65 20 66 69 6c 65 73 20 66 72 65 65 2d the files free-
18730 6c 69 73 74 2e 20 54 68 69 73 20 69 73 20 6e 6f list. This is no
18740 74 20 72 65 71 75 69 72 65 64 0a 20 20 20 20 20 t required.
18750 20 20 20 2a 2a 20 69 66 20 62 43 6f 6d 6d 69 74 ** if bCommit
18760 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e is non-zero. In
18770 20 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 that case, the
18780 66 72 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 free-list will b
18790 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 75 e. ** tru
187a0 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 61 ncated to zero a
187b0 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 fter this functi
187c0 6f 6e 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 69 on returns, so i
187d0 74 20 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 20 t doesn't .
187e0 20 20 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 20 ** matter if
187f0 69 74 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 6e it still contain
18800 73 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 65 s some garbage e
18810 6e 74 72 69 65 73 2e 0a 20 20 20 20 20 20 20 20 ntries..
18820 2a 2f 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 */. Pgno
18830 69 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 iFreePg;.
18840 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 MemPage *pFreeP
18850 67 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 g;. rc =
18860 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
18870 65 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c e(pBt, &pFreePg,
18880 20 26 69 46 72 65 65 50 67 2c 20 69 4c 61 73 74 &iFreePg, iLast
18890 50 67 2c 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 Pg, BTALLOC_EXAC
188a0 54 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 T);. if(
188b0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
188c0 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
188d0 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
188e0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
188f0 69 46 72 65 65 50 67 3d 3d 69 4c 61 73 74 50 67 iFreePg==iLastPg
18900 20 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 );. rele
18910 61 73 65 50 61 67 65 28 70 46 72 65 65 50 67 29 asePage(pFreePg)
18920 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 ;. }. }
18930 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 50 67 6e else {. Pgn
18940 6f 20 69 46 72 65 65 50 67 3b 20 20 20 20 20 20 o iFreePg;
18950 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 /* Index
18960 6f 66 20 66 72 65 65 20 70 61 67 65 20 74 6f 20 of free page to
18970 6d 6f 76 65 20 70 4c 61 73 74 50 67 20 74 6f 20 move pLastPg to
18980 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 */. MemPage
18990 20 2a 70 4c 61 73 74 50 67 3b 0a 20 20 20 20 20 *pLastPg;.
189a0 20 75 38 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c u8 eMode = BTAL
189b0 4c 4f 43 5f 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f LOC_ANY; /* Mo
189c0 64 65 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 de parameter for
189d0 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 allocateBtreePa
189e0 67 65 28 29 20 2a 2f 0a 20 20 20 20 20 20 50 67 ge() */. Pg
189f0 6e 6f 20 69 4e 65 61 72 20 3d 20 30 3b 20 20 20 no iNear = 0;
18a00 20 20 20 20 20 20 20 20 2f 2a 20 6e 65 61 72 62 /* nearb
18a10 79 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 y parameter for
18a20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
18a30 65 28 29 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 e() */.. rc
18a40 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
18a50 70 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 70 pBt, iLastPg, &p
18a60 4c 61 73 74 50 67 2c 20 30 2c 20 30 29 3b 0a 20 LastPg, 0, 0);.
18a70 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
18a80 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
18a90 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
18aa0 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 }.. /* I
18ab0 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 7a 65 72 f bCommit is zer
18ac0 6f 2c 20 74 68 69 73 20 6c 6f 6f 70 20 72 75 6e o, this loop run
18ad0 73 20 65 78 61 63 74 6c 79 20 6f 6e 63 65 20 61 s exactly once a
18ae0 6e 64 20 70 61 67 65 20 70 4c 61 73 74 50 67 0a nd page pLastPg.
18af0 20 20 20 20 20 20 2a 2a 20 69 73 20 73 77 61 70 ** is swap
18b00 70 65 64 20 77 69 74 68 20 74 68 65 20 66 69 72 ped with the fir
18b10 73 74 20 66 72 65 65 20 70 61 67 65 20 70 75 6c st free page pul
18b20 6c 65 64 20 6f 66 66 20 74 68 65 20 66 72 65 65 led off the free
18b30 20 6c 69 73 74 2e 0a 20 20 20 20 20 20 2a 2a 0a list.. **.
18b40 20 20 20 20 20 20 2a 2a 20 4f 6e 20 74 68 65 20 ** On the
18b50 6f 74 68 65 72 20 68 61 6e 64 2c 20 69 66 20 62 other hand, if b
18b60 43 6f 6d 6d 69 74 20 69 73 20 67 72 65 61 74 65 Commit is greate
18b70 72 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 r than zero, the
18b80 6e 20 6b 65 65 70 0a 20 20 20 20 20 20 2a 2a 20 n keep. **
18b90 6c 6f 6f 70 69 6e 67 20 75 6e 74 69 6c 20 61 20 looping until a
18ba0 66 72 65 65 2d 70 61 67 65 20 6c 6f 63 61 74 65 free-page locate
18bb0 64 20 77 69 74 68 69 6e 20 74 68 65 20 66 69 72 d within the fir
18bc0 73 74 20 6e 46 69 6e 20 70 61 67 65 73 0a 20 20 st nFin pages.
18bd0 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 ** of the fi
18be0 6c 65 20 69 73 20 66 6f 75 6e 64 2e 0a 20 20 20 le is found..
18bf0 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
18c00 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 bCommit==0 ){.
18c10 20 20 20 20 20 20 65 4d 6f 64 65 20 3d 20 42 54 eMode = BT
18c20 41 4c 4c 4f 43 5f 4c 45 3b 0a 20 20 20 20 20 20 ALLOC_LE;.
18c30 20 20 69 4e 65 61 72 20 3d 20 6e 46 69 6e 3b 0a iNear = nFin;.
18c40 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 64 6f }. do
18c50 20 7b 0a 20 20 20 20 20 20 20 20 4d 65 6d 50 61 {. MemPa
18c60 67 65 20 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 ge *pFreePg;.
18c70 20 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 rc = alloca
18c80 74 65 42 74 72 65 65 50 61 67 65 28 70 42 74 2c teBtreePage(pBt,
18c90 20 26 70 46 72 65 65 50 67 2c 20 26 69 46 72 65 &pFreePg, &iFre
18ca0 65 50 67 2c 20 69 4e 65 61 72 2c 20 65 4d 6f 64 ePg, iNear, eMod
18cb0 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 e);. if(
18cc0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
18cd0 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 . relea
18ce0 73 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b sePage(pLastPg);
18cf0 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
18d00 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
18d10 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
18d20 61 67 65 28 70 46 72 65 65 50 67 29 3b 0a 20 20 age(pFreePg);.
18d30 20 20 20 20 7d 77 68 69 6c 65 28 20 62 43 6f 6d }while( bCom
18d40 6d 69 74 20 26 26 20 69 46 72 65 65 50 67 3e 6e mit && iFreePg>n
18d50 46 69 6e 20 29 3b 0a 20 20 20 20 20 20 61 73 73 Fin );. ass
18d60 65 72 74 28 20 69 46 72 65 65 50 67 3c 69 4c 61 ert( iFreePg<iLa
18d70 73 74 50 67 20 29 3b 0a 20 20 20 20 20 20 0a 20 stPg );. .
18d80 20 20 20 20 20 72 63 20 3d 20 72 65 6c 6f 63 61 rc = reloca
18d90 74 65 50 61 67 65 28 70 42 74 2c 20 70 4c 61 73 tePage(pBt, pLas
18da0 74 50 67 2c 20 65 54 79 70 65 2c 20 69 50 74 72 tPg, eType, iPtr
18db0 50 61 67 65 2c 20 69 46 72 65 65 50 67 2c 20 62 Page, iFreePg, b
18dc0 43 6f 6d 6d 69 74 29 3b 0a 20 20 20 20 20 20 72 Commit);. r
18dd0 65 6c 65 61 73 65 50 61 67 65 28 70 4c 61 73 74 eleasePage(pLast
18de0 50 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 Pg);. if( r
18df0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
18e00 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
18e10 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d c;. }. }
18e20 0a 20 20 7d 0a 0a 20 20 69 66 28 20 62 43 6f 6d . }.. if( bCom
18e30 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 64 6f mit==0 ){. do
18e40 20 7b 0a 20 20 20 20 20 20 69 4c 61 73 74 50 67 {. iLastPg
18e50 2d 2d 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 --;. }while(
18e60 69 4c 61 73 74 50 67 3d 3d 50 45 4e 44 49 4e 47 iLastPg==PENDING
18e70 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
18e80 7c 7c 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 || PTRMAP_ISPAGE
18e90 28 70 42 74 2c 20 69 4c 61 73 74 50 67 29 20 29 (pBt, iLastPg) )
18ea0 3b 0a 20 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 ;. pBt->bDoTr
18eb0 75 6e 63 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 uncate = 1;.
18ec0 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 69 4c 61 pBt->nPage = iLa
18ed0 73 74 50 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 stPg;. }. retu
18ee0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
18ef0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 ./*.** The datab
18f00 61 73 65 20 6f 70 65 6e 65 64 20 62 79 20 74 68 ase opened by th
18f10 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 e first argument
18f20 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 is an auto-vacu
18f30 75 6d 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 6e um database.** n
18f40 4f 72 69 67 20 70 61 67 65 73 20 69 6e 20 73 69 Orig pages in si
18f50 7a 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6e 46 ze containing nF
18f60 72 65 65 20 66 72 65 65 20 70 61 67 65 73 2e 20 ree free pages.
18f70 52 65 74 75 72 6e 20 74 68 65 20 65 78 70 65 63 Return the expec
18f80 74 65 64 20 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 ted .** size of
18f90 74 68 65 20 64 61 74 61 62 61 73 65 20 69 6e 20 the database in
18fa0 70 61 67 65 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 pages following
18fb0 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 6f an auto-vacuum o
18fc0 70 65 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 peration..*/.sta
18fd0 74 69 63 20 50 67 6e 6f 20 66 69 6e 61 6c 44 62 tic Pgno finalDb
18fe0 53 69 7a 65 28 42 74 53 68 61 72 65 64 20 2a 70 Size(BtShared *p
18ff0 42 74 2c 20 50 67 6e 6f 20 6e 4f 72 69 67 2c 20 Bt, Pgno nOrig,
19000 50 67 6e 6f 20 6e 46 72 65 65 29 7b 0a 20 20 69 Pgno nFree){. i
19010 6e 74 20 6e 45 6e 74 72 79 3b 20 20 20 20 20 20 nt nEntry;
19020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
19030 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 * Number of entr
19040 69 65 73 20 6f 6e 20 6f 6e 65 20 70 74 72 6d 61 ies on one ptrma
19050 70 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f p page */. Pgno
19060 20 6e 50 74 72 6d 61 70 3b 20 20 20 20 20 20 20 nPtrmap;
19070 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
19080 75 6d 62 65 72 20 6f 66 20 50 74 72 4d 61 70 20 umber of PtrMap
19090 70 61 67 65 73 20 74 6f 20 62 65 20 66 72 65 65 pages to be free
190a0 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 46 69 6e d */. Pgno nFin
190b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
190c0 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
190d0 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 20 6e 45 6e value */.. nEn
190e0 74 72 79 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c try = pBt->usabl
190f0 65 53 69 7a 65 2f 35 3b 0a 20 20 6e 50 74 72 6d eSize/5;. nPtrm
19100 61 70 20 3d 20 28 6e 46 72 65 65 2d 6e 4f 72 69 ap = (nFree-nOri
19110 67 2b 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 g+PTRMAP_PAGENO(
19120 70 42 74 2c 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 pBt, nOrig)+nEnt
19130 72 79 29 2f 6e 45 6e 74 72 79 3b 0a 20 20 6e 46 ry)/nEntry;. nF
19140 69 6e 20 3d 20 6e 4f 72 69 67 20 2d 20 6e 46 72 in = nOrig - nFr
19150 65 65 20 2d 20 6e 50 74 72 6d 61 70 3b 0a 20 20 ee - nPtrmap;.
19160 69 66 28 20 6e 4f 72 69 67 3e 50 45 4e 44 49 4e if( nOrig>PENDIN
19170 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
19180 20 26 26 20 6e 46 69 6e 3c 50 45 4e 44 49 4e 47 && nFin<PENDING
19190 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
191a0 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 ){. nFin--;.
191b0 20 7d 0a 20 20 77 68 69 6c 65 28 20 50 54 52 4d }. while( PTRM
191c0 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 6e AP_ISPAGE(pBt, n
191d0 46 69 6e 29 20 7c 7c 20 6e 46 69 6e 3d 3d 50 45 Fin) || nFin==PE
191e0 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
191f0 70 42 74 29 20 29 7b 0a 20 20 20 20 6e 46 69 6e pBt) ){. nFin
19200 2d 2d 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 --;. }.. retur
19210 6e 20 6e 46 69 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n nFin;.}../*.**
19220 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 A write-transac
19230 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 6f 70 65 tion must be ope
19240 6e 65 64 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 ned before calli
19250 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ng this function
19260 2e 0a 2a 2a 20 49 74 20 70 65 72 66 6f 72 6d 73 ..** It performs
19270 20 61 20 73 69 6e 67 6c 65 20 75 6e 69 74 20 6f a single unit o
19280 66 20 77 6f 72 6b 20 74 6f 77 61 72 64 73 20 61 f work towards a
19290 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 n incremental va
192a0 63 75 75 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 cuum..**.** If t
192b0 68 65 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 he incremental v
192c0 61 63 75 75 6d 20 69 73 20 66 69 6e 69 73 68 65 acuum is finishe
192d0 64 20 61 66 74 65 72 20 74 68 69 73 20 66 75 6e d after this fun
192e0 63 74 69 6f 6e 20 68 61 73 20 72 75 6e 2c 0a 2a ction has run,.*
192f0 2a 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 * SQLITE_DONE is
19300 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 returned. If it
19310 20 69 73 20 6e 6f 74 20 66 69 6e 69 73 68 65 64 is not finished
19320 2c 20 62 75 74 20 6e 6f 20 65 72 72 6f 72 20 6f , but no error o
19330 63 63 75 72 72 65 64 2c 0a 2a 2a 20 53 51 4c 49 ccurred,.** SQLI
19340 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
19350 64 2e 20 4f 74 68 65 72 77 69 73 65 20 61 6e 20 d. Otherwise an
19360 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
19370 65 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 e. .*/.int sqlit
19380 65 33 42 74 72 65 65 49 6e 63 72 56 61 63 75 75 e3BtreeIncrVacuu
19390 6d 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 m(Btree *p){. i
193a0 6e 74 20 72 63 3b 0a 20 20 42 74 53 68 61 72 65 nt rc;. BtShare
193b0 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
193c0 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 .. sqlite3Btree
193d0 45 6e 74 65 72 28 70 29 3b 0a 20 20 61 73 73 65 Enter(p);. asse
193e0 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 rt( pBt->inTrans
193f0 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
19400 49 54 45 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e ITE && p->inTran
19410 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 s==TRANS_WRITE )
19420 3b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 61 75 ;. if( !pBt->au
19430 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 toVacuum ){.
19440 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
19450 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 50 ;. }else{. P
19460 67 6e 6f 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 gno nOrig = btre
19470 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
19480 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 65 20 . Pgno nFree
19490 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 2d = get4byte(&pBt-
194a0 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 >pPage1->aData[3
194b0 36 5d 29 3b 0a 20 20 20 20 50 67 6e 6f 20 6e 46 6]);. Pgno nF
194c0 69 6e 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 in = finalDbSize
194d0 28 70 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 (pBt, nOrig, nFr
194e0 65 65 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e 4f ee);.. if( nO
194f0 72 69 67 3c 6e 46 69 6e 20 29 7b 0a 20 20 20 20 rig<nFin ){.
19500 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
19510 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
19520 7d 65 6c 73 65 20 69 66 28 20 6e 46 72 65 65 3e }else if( nFree>
19530 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 0 ){. rc =
19540 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 saveAllCursors(p
19550 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 Bt, 0, 0);.
19560 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
19570 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e OK ){. in
19580 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 validateAllOverf
19590 6c 6f 77 43 61 63 68 65 28 70 42 74 29 3b 0a 20 lowCache(pBt);.
195a0 20 20 20 20 20 20 20 72 63 20 3d 20 69 6e 63 72 rc = incr
195b0 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 2c 20 VacuumStep(pBt,
195c0 6e 46 69 6e 2c 20 6e 4f 72 69 67 2c 20 30 29 3b nFin, nOrig, 0);
195d0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
195e0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
195f0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
19600 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
19610 74 65 28 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e te(pBt->pPage1->
19620 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
19630 20 20 70 75 74 34 62 79 74 65 28 26 70 42 74 2d put4byte(&pBt-
19640 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 >pPage1->aData[2
19650 38 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 8], pBt->nPage);
19660 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
19670 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
19680 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 QLITE_DONE;.
19690 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 }. }. sqlite3B
196a0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
196b0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
196c0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
196d0 20 69 73 20 63 61 6c 6c 65 64 20 70 72 69 6f 72 is called prior
196e0 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
196f0 43 6f 6d 6d 69 74 20 77 68 65 6e 20 61 20 74 72 Commit when a tr
19700 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 ansaction.** is
19710 63 6f 6d 6d 69 74 74 65 64 20 66 6f 72 20 61 6e committed for an
19720 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61 74 auto-vacuum dat
19730 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 abase..**.** If
19740 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
19750 75 72 6e 65 64 2c 20 74 68 65 6e 20 2a 70 6e 54 urned, then *pnT
19760 72 75 6e 63 20 69 73 20 73 65 74 20 74 6f 20 74 runc is set to t
19770 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
19780 65 73 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 es.** the databa
19790 73 65 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 se file should b
197a0 65 20 74 72 75 6e 63 61 74 65 64 20 74 6f 20 64 e truncated to d
197b0 75 72 69 6e 67 20 74 68 65 20 63 6f 6d 6d 69 74 uring the commit
197c0 20 70 72 6f 63 65 73 73 2e 20 0a 2a 2a 20 69 2e process. .** i.
197d0 65 2e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 e. the database
197e0 68 61 73 20 62 65 65 6e 20 72 65 6f 72 67 61 6e has been reorgan
197f0 69 7a 65 64 20 73 6f 20 74 68 61 74 20 6f 6e 6c ized so that onl
19800 79 20 74 68 65 20 66 69 72 73 74 20 2a 70 6e 54 y the first *pnT
19810 72 75 6e 63 0a 2a 2a 20 70 61 67 65 73 20 61 72 runc.** pages ar
19820 65 20 69 6e 20 75 73 65 2e 0a 2a 2f 0a 73 74 61 e in use..*/.sta
19830 74 69 63 20 69 6e 74 20 61 75 74 6f 56 61 63 75 tic int autoVacu
19840 75 6d 43 6f 6d 6d 69 74 28 42 74 53 68 61 72 65 umCommit(BtShare
19850 64 20 2a 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 d *pBt){. int r
19860 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
19870 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
19880 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 pBt->pPager;.
19890 56 56 41 5f 4f 4e 4c 59 28 20 69 6e 74 20 6e 52 VVA_ONLY( int nR
198a0 65 66 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 ef = sqlite3Page
198b0 72 52 65 66 63 6f 75 6e 74 28 70 50 61 67 65 72 rRefcount(pPager
198c0 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ) );.. assert(
198d0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
198e0 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
198f0 3b 0a 20 20 69 6e 76 61 6c 69 64 61 74 65 41 6c ;. invalidateAl
19900 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 lOverflowCache(p
19910 42 74 29 3b 0a 20 20 61 73 73 65 72 74 28 70 42 Bt);. assert(pB
19920 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 3b 0a t->autoVacuum);.
19930 20 20 69 66 28 20 21 70 42 74 2d 3e 69 6e 63 72 if( !pBt->incr
19940 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 Vacuum ){. Pg
19950 6e 6f 20 6e 46 69 6e 3b 20 20 20 20 20 20 20 20 no nFin;
19960 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
19970 67 65 73 20 69 6e 20 64 61 74 61 62 61 73 65 20 ges in database
19980 61 66 74 65 72 20 61 75 74 6f 76 61 63 75 75 6d after autovacuum
19990 69 6e 67 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 ing */. Pgno
199a0 6e 46 72 65 65 3b 20 20 20 20 20 20 20 20 2f 2a nFree; /*
199b0 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
199c0 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 on the freelist
199d0 20 69 6e 69 74 69 61 6c 6c 79 20 2a 2f 0a 20 20 initially */.
199e0 20 20 50 67 6e 6f 20 69 46 72 65 65 3b 20 20 20 Pgno iFree;
199f0 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 /* The next
19a00 20 70 61 67 65 20 74 6f 20 62 65 20 66 72 65 65 page to be free
19a10 64 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 4f d */. Pgno nO
19a20 72 69 67 3b 20 20 20 20 20 20 20 20 2f 2a 20 44 rig; /* D
19a30 61 74 61 62 61 73 65 20 73 69 7a 65 20 62 65 66 atabase size bef
19a40 6f 72 65 20 66 72 65 65 69 6e 67 20 2a 2f 0a 0a ore freeing */..
19a50 20 20 20 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 nOrig = btre
19a60 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
19a70 0a 20 20 20 20 69 66 28 20 50 54 52 4d 41 50 5f . if( PTRMAP_
19a80 49 53 50 41 47 45 28 70 42 74 2c 20 6e 4f 72 69 ISPAGE(pBt, nOri
19a90 67 29 20 7c 7c 20 6e 4f 72 69 67 3d 3d 50 45 4e g) || nOrig==PEN
19aa0 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 DING_BYTE_PAGE(p
19ab0 42 74 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 Bt) ){. /*
19ac0 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 It is not possib
19ad0 6c 65 20 74 6f 20 63 72 65 61 74 65 20 61 20 64 le to create a d
19ae0 61 74 61 62 61 73 65 20 66 6f 72 20 77 68 69 63 atabase for whic
19af0 68 20 74 68 65 20 66 69 6e 61 6c 20 70 61 67 65 h the final page
19b00 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 65 69 74 . ** is eit
19b10 68 65 72 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 her a pointer-ma
19b20 70 20 70 61 67 65 20 6f 72 20 74 68 65 20 70 65 p page or the pe
19b30 6e 64 69 6e 67 2d 62 79 74 65 20 70 61 67 65 2e nding-byte page.
19b40 20 49 66 20 6f 6e 65 0a 20 20 20 20 20 20 2a 2a If one. **
19b50 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c is encountered,
19b60 20 74 68 69 73 20 69 6e 64 69 63 61 74 65 73 20 this indicates
19b70 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 20 20 20 20 corruption..
19b80 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 */. retur
19b90 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
19ba0 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 _BKPT;. }..
19bb0 20 20 6e 46 72 65 65 20 3d 20 67 65 74 34 62 79 nFree = get4by
19bc0 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d te(&pBt->pPage1-
19bd0 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 >aData[36]);.
19be0 20 6e 46 69 6e 20 3d 20 66 69 6e 61 6c 44 62 53 nFin = finalDbS
19bf0 69 7a 65 28 70 42 74 2c 20 6e 4f 72 69 67 2c 20 ize(pBt, nOrig,
19c00 6e 46 72 65 65 29 3b 0a 20 20 20 20 69 66 28 20 nFree);. if(
19c10 6e 46 69 6e 3e 6e 4f 72 69 67 20 29 20 72 65 74 nFin>nOrig ) ret
19c20 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
19c30 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 69 66 28 PT_BKPT;. if(
19c40 20 6e 46 69 6e 3c 6e 4f 72 69 67 20 29 7b 0a 20 nFin<nOrig ){.
19c50 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 41 6c rc = saveAl
19c60 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 30 2c lCursors(pBt, 0,
19c70 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 0);. }. f
19c80 6f 72 28 69 46 72 65 65 3d 6e 4f 72 69 67 3b 20 or(iFree=nOrig;
19c90 69 46 72 65 65 3e 6e 46 69 6e 20 26 26 20 72 63 iFree>nFin && rc
19ca0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 46 72 ==SQLITE_OK; iFr
19cb0 65 65 2d 2d 29 7b 0a 20 20 20 20 20 20 72 63 20 ee--){. rc
19cc0 3d 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 = incrVacuumStep
19cd0 28 70 42 74 2c 20 6e 46 69 6e 2c 20 69 46 72 65 (pBt, nFin, iFre
19ce0 65 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 e, 1);. }.
19cf0 20 69 66 28 20 28 72 63 3d 3d 53 51 4c 49 54 45 if( (rc==SQLITE
19d00 5f 44 4f 4e 45 20 7c 7c 20 72 63 3d 3d 53 51 4c _DONE || rc==SQL
19d10 49 54 45 5f 4f 4b 29 20 26 26 20 6e 46 72 65 65 ITE_OK) && nFree
19d20 3e 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d >0 ){. rc =
19d30 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
19d40 74 65 28 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e te(pBt->pPage1->
19d50 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
19d60 70 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 put4byte(&pBt->p
19d70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
19d80 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 75 74 34 , 0);. put4
19d90 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 byte(&pBt->pPage
19da0 31 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 30 29 1->aData[36], 0)
19db0 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
19dc0 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
19dd0 44 61 74 61 5b 32 38 5d 2c 20 6e 46 69 6e 29 3b Data[28], nFin);
19de0 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 44 6f 54 . pBt->bDoT
19df0 72 75 6e 63 61 74 65 20 3d 20 31 3b 0a 20 20 20 runcate = 1;.
19e00 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 pBt->nPage =
19e10 6e 46 69 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nFin;. }.
19e20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
19e30 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
19e40 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 e3PagerRollback(
19e50 70 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 pPager);. }.
19e60 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 6e 52 }.. assert( nR
19e70 65 66 3e 3d 73 71 6c 69 74 65 33 50 61 67 65 72 ef>=sqlite3Pager
19e80 52 65 66 63 6f 75 6e 74 28 70 50 61 67 65 72 29 Refcount(pPager)
19e90 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
19ea0 0a 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 6e .}..#else /* ifn
19eb0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
19ec0 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f 0a 23 20 AUTOVACUUM */.#
19ed0 64 65 66 69 6e 65 20 73 65 74 43 68 69 6c 64 50 define setChildP
19ee0 74 72 6d 61 70 73 28 78 29 20 53 51 4c 49 54 45 trmaps(x) SQLITE
19ef0 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a _OK.#endif../*.*
19f00 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 * This routine d
19f10 6f 65 73 20 74 68 65 20 66 69 72 73 74 20 70 68 oes the first ph
19f20 61 73 65 20 6f 66 20 61 20 74 77 6f 2d 70 68 61 ase of a two-pha
19f30 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 69 73 se commit. This
19f40 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 63 61 75 73 routine.** caus
19f50 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f es a rollback jo
19f60 75 72 6e 61 6c 20 74 6f 20 62 65 20 63 72 65 61 urnal to be crea
19f70 74 65 64 20 28 69 66 20 69 74 20 64 6f 65 73 20 ted (if it does
19f80 6e 6f 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 not already exis
19f90 74 29 0a 2a 2a 20 61 6e 64 20 70 6f 70 75 6c 61 t).** and popula
19fa0 74 65 64 20 77 69 74 68 20 65 6e 6f 75 67 68 20 ted with enough
19fb0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 6f 20 74 information so t
19fc0 68 61 74 20 69 66 20 61 20 70 6f 77 65 72 20 6c hat if a power l
19fd0 6f 73 73 20 6f 63 63 75 72 73 0a 2a 2a 20 74 68 oss occurs.** th
19fe0 65 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 e database can b
19ff0 65 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74 e restored to it
1a000 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 65 s original state
1a010 20 62 79 20 70 6c 61 79 69 6e 67 20 62 61 63 6b by playing back
1a020 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e .** the journal.
1a030 20 20 54 68 65 6e 20 74 68 65 20 63 6f 6e 74 65 Then the conte
1a040 6e 74 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e nts of the journ
1a050 61 6c 20 61 72 65 20 66 6c 75 73 68 65 64 20 6f al are flushed o
1a060 75 74 20 74 6f 0a 2a 2a 20 74 68 65 20 64 69 73 ut to.** the dis
1a070 6b 2e 20 20 41 66 74 65 72 20 74 68 65 20 6a 6f k. After the jo
1a080 75 72 6e 61 6c 20 69 73 20 73 61 66 65 6c 79 20 urnal is safely
1a090 6f 6e 20 6f 78 69 64 65 2c 20 74 68 65 20 63 68 on oxide, the ch
1a0a0 61 6e 67 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 anges to the.**
1a0b0 64 61 74 61 62 61 73 65 20 61 72 65 20 77 72 69 database are wri
1a0c0 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 64 61 tten into the da
1a0d0 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 tabase file and
1a0e0 66 6c 75 73 68 65 64 20 74 6f 20 6f 78 69 64 65 flushed to oxide
1a0f0 2e 0a 2a 2a 20 41 74 20 74 68 65 20 65 6e 64 20 ..** At the end
1a100 6f 66 20 74 68 69 73 20 63 61 6c 6c 2c 20 74 68 of this call, th
1a110 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
1a120 61 6c 20 73 74 69 6c 6c 20 65 78 69 73 74 73 20 al still exists
1a130 6f 6e 20 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 on the.** disk a
1a140 6e 64 20 77 65 20 61 72 65 20 73 74 69 6c 6c 20 nd we are still
1a150 68 6f 6c 64 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b holding all lock
1a160 73 2c 20 73 6f 20 74 68 65 20 74 72 61 6e 73 61 s, so the transa
1a170 63 74 69 6f 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a ction has not.**
1a180 20 63 6f 6d 6d 69 74 74 65 64 2e 20 20 53 65 65 committed. See
1a190 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d sqlite3BtreeCom
1a1a0 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 66 6f mitPhaseTwo() fo
1a1b0 72 20 74 68 65 20 73 65 63 6f 6e 64 20 70 68 61 r the second pha
1a1c0 73 65 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 6d se of the.** com
1a1d0 6d 69 74 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a mit process..**.
1a1e0 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20 ** This call is
1a1f0 61 20 6e 6f 2d 6f 70 20 69 66 20 6e 6f 20 77 72 a no-op if no wr
1a200 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
1a210 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 is currently act
1a220 69 76 65 20 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a ive on pBt..**.*
1a230 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 73 79 6e * Otherwise, syn
1a240 63 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 c the database f
1a250 69 6c 65 20 66 6f 72 20 74 68 65 20 62 74 72 65 ile for the btre
1a260 65 20 70 42 74 2e 20 7a 4d 61 73 74 65 72 20 70 e pBt. zMaster p
1a270 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68 65 20 oints to.** the
1a280 6e 61 6d 65 20 6f 66 20 61 20 6d 61 73 74 65 72 name of a master
1a290 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 journal file th
1a2a0 61 74 20 73 68 6f 75 6c 64 20 62 65 20 77 72 69 at should be wri
1a2b0 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 0a 2a 2a tten into the.**
1a2c0 20 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 individual jour
1a2d0 6e 61 6c 20 66 69 6c 65 2c 20 6f 72 20 69 73 20 nal file, or is
1a2e0 4e 55 4c 4c 2c 20 69 6e 64 69 63 61 74 69 6e 67 NULL, indicating
1a2f0 20 6e 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e no master journ
1a300 61 6c 20 66 69 6c 65 20 0a 2a 2a 20 28 73 69 6e al file .** (sin
1a310 67 6c 65 20 64 61 74 61 62 61 73 65 20 74 72 61 gle database tra
1a320 6e 73 61 63 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a nsaction)..**.**
1a330 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 When this is ca
1a340 6c 6c 65 64 2c 20 74 68 65 20 6d 61 73 74 65 72 lled, the master
1a350 20 6a 6f 75 72 6e 61 6c 20 73 68 6f 75 6c 64 20 journal should
1a360 61 6c 72 65 61 64 79 20 68 61 76 65 20 62 65 65 already have bee
1a370 6e 0a 2a 2a 20 63 72 65 61 74 65 64 2c 20 70 6f n.** created, po
1a380 70 75 6c 61 74 65 64 20 77 69 74 68 20 74 68 69 pulated with thi
1a390 73 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 s journal pointe
1a3a0 72 20 61 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 r and synced to
1a3b0 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 disk..**.** Once
1a3c0 20 74 68 69 73 20 69 73 20 72 6f 75 74 69 6e 65 this is routine
1a3d0 20 68 61 73 20 72 65 74 75 72 6e 65 64 2c 20 74 has returned, t
1a3e0 68 65 20 6f 6e 6c 79 20 74 68 69 6e 67 20 72 65 he only thing re
1a3f0 71 75 69 72 65 64 20 74 6f 20 63 6f 6d 6d 69 74 quired to commit
1a400 0a 2a 2a 20 74 68 65 20 77 72 69 74 65 2d 74 72 .** the write-tr
1a410 61 6e 73 61 63 74 69 6f 6e 20 66 6f 72 20 74 68 ansaction for th
1a420 69 73 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 is database file
1a430 20 69 73 20 74 6f 20 64 65 6c 65 74 65 20 74 68 is to delete th
1a440 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e e journal..*/.in
1a450 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f t sqlite3BtreeCo
1a460 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 42 74 72 mmitPhaseOne(Btr
1a470 65 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 ee *p, const cha
1a480 72 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 69 r *zMaster){. i
1a490 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1a4a0 4b 3b 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 K;. if( p->inTr
1a4b0 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
1a4c0 20 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 ){. BtShared
1a4d0 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
1a4e0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1a4f0 45 6e 74 65 72 28 70 29 3b 0a 23 69 66 6e 64 65 Enter(p);.#ifnde
1a500 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
1a510 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
1a520 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
1a530 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 ){. rc = a
1a540 75 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 utoVacuumCommit(
1a550 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pBt);. if(
1a560 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1a570 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
1a580 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1a590 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
1a5a0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
1a5b0 20 20 20 20 69 66 28 20 70 42 74 2d 3e 62 44 6f if( pBt->bDo
1a5c0 54 72 75 6e 63 61 74 65 20 29 7b 0a 20 20 20 20 Truncate ){.
1a5d0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 sqlite3PagerTr
1a5e0 75 6e 63 61 74 65 49 6d 61 67 65 28 70 42 74 2d uncateImage(pBt-
1a5f0 3e 70 50 61 67 65 72 2c 20 70 42 74 2d 3e 6e 50 >pPager, pBt->nP
1a600 61 67 65 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 age);. }.#end
1a610 69 66 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 if. rc = sqli
1a620 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 te3PagerCommitPh
1a630 61 73 65 4f 6e 65 28 70 42 74 2d 3e 70 50 61 67 aseOne(pBt->pPag
1a640 65 72 2c 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b er, zMaster, 0);
1a650 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
1a660 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 eLeave(p);. }.
1a670 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1a680 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
1a690 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f on is called fro
1a6a0 6d 20 62 6f 74 68 20 42 74 72 65 65 43 6f 6d 6d m both BtreeComm
1a6b0 69 74 50 68 61 73 65 54 77 6f 28 29 20 61 6e 64 itPhaseTwo() and
1a6c0 20 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 BtreeRollback()
1a6d0 0a 2a 2a 20 61 74 20 74 68 65 20 63 6f 6e 63 6c .** at the concl
1a6e0 75 73 69 6f 6e 20 6f 66 20 61 20 74 72 61 6e 73 usion of a trans
1a6f0 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 action..*/.stati
1a700 63 20 76 6f 69 64 20 62 74 72 65 65 45 6e 64 54 c void btreeEndT
1a710 72 61 6e 73 61 63 74 69 6f 6e 28 42 74 72 65 65 ransaction(Btree
1a720 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 *p){. BtShared
1a730 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
1a740 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
1a750 70 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28 p->db;. assert(
1a760 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
1a770 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 0a 23 dsMutex(p) );..#
1a780 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1a790 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
1a7a0 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 pBt->bDoTruncate
1a7b0 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 69 = 0;.#endif. i
1a7c0 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 f( p->inTrans>TR
1a7d0 41 4e 53 5f 4e 4f 4e 45 20 26 26 20 64 62 2d 3e ANS_NONE && db->
1a7e0 6e 56 64 62 65 52 65 61 64 3e 31 20 29 7b 0a 20 nVdbeRead>1 ){.
1a7f0 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 /* If there a
1a800 72 65 20 6f 74 68 65 72 20 61 63 74 69 76 65 20 re other active
1a810 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 statements that
1a820 62 65 6c 6f 6e 67 20 74 6f 20 74 68 69 73 20 64 belong to this d
1a830 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 68 atabase. ** h
1a840 61 6e 64 6c 65 2c 20 64 6f 77 6e 67 72 61 64 65 andle, downgrade
1a850 20 74 6f 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 to a read-only
1a860 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 transaction. The
1a870 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 other statement
1a880 73 0a 20 20 20 20 2a 2a 20 6d 61 79 20 73 74 69 s. ** may sti
1a890 6c 6c 20 62 65 20 72 65 61 64 69 6e 67 20 66 72 ll be reading fr
1a8a0 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e om the database.
1a8b0 20 20 2a 2f 0a 20 20 20 20 64 6f 77 6e 67 72 61 */. downgra
1a8c0 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 deAllSharedCache
1a8d0 54 61 62 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 TableLocks(p);.
1a8e0 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 p->inTrans =
1a8f0 54 52 41 4e 53 5f 52 45 41 44 3b 0a 20 20 7d 65 TRANS_READ;. }e
1a900 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 lse{. /* If t
1a910 68 65 20 68 61 6e 64 6c 65 20 68 61 64 20 61 6e he handle had an
1a920 79 20 6b 69 6e 64 20 6f 66 20 74 72 61 6e 73 61 y kind of transa
1a930 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 64 65 63 72 ction open, decr
1a940 65 6d 65 6e 74 20 74 68 65 20 0a 20 20 20 20 2a ement the . *
1a950 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f * transaction co
1a960 75 6e 74 20 6f 66 20 74 68 65 20 73 68 61 72 65 unt of the share
1a970 64 20 62 74 72 65 65 2e 20 49 66 20 74 68 65 20 d btree. If the
1a980 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e transaction coun
1a990 74 20 0a 20 20 20 20 2a 2a 20 72 65 61 63 68 65 t . ** reache
1a9a0 73 20 30 2c 20 73 65 74 20 74 68 65 20 73 68 61 s 0, set the sha
1a9b0 72 65 64 20 73 74 61 74 65 20 74 6f 20 54 52 41 red state to TRA
1a9c0 4e 53 5f 4e 4f 4e 45 2e 20 54 68 65 20 75 6e 6c NS_NONE. The unl
1a9d0 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1a9e0 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 (). ** call b
1a9f0 65 6c 6f 77 20 77 69 6c 6c 20 75 6e 6c 6f 63 6b elow will unlock
1aa00 20 74 68 65 20 70 61 67 65 72 2e 20 20 2a 2f 0a the pager. */.
1aa10 20 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 if( p->inTra
1aa20 6e 73 21 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 ns!=TRANS_NONE )
1aa30 7b 0a 20 20 20 20 20 20 63 6c 65 61 72 41 6c 6c {. clearAll
1aa40 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
1aa50 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 20 20 Locks(p);.
1aa60 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f pBt->nTransactio
1aa70 6e 2d 2d 3b 0a 20 20 20 20 20 20 69 66 28 20 30 n--;. if( 0
1aa80 3d 3d 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 ==pBt->nTransact
1aa90 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ion ){. p
1aaa0 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1aab0 6e 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a n = TRANS_NONE;.
1aac0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 }. }..
1aad0 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 63 75 /* Set the cu
1aae0 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f rrent transactio
1aaf0 6e 20 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 n state to TRANS
1ab00 5f 4e 4f 4e 45 20 61 6e 64 20 75 6e 6c 6f 63 6b _NONE and unlock
1ab10 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 70 61 67 the . ** pag
1ab20 65 72 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 er if this call
1ab30 63 6c 6f 73 65 64 20 74 68 65 20 6f 6e 6c 79 20 closed the only
1ab40 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 read or write tr
1ab50 61 6e 73 61 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 ansaction. */.
1ab60 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 p->inTrans =
1ab70 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 TRANS_NONE;.
1ab80 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 unlockBtreeIfUnu
1ab90 73 65 64 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 sed(pBt);. }..
1aba0 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 btreeIntegrity(
1abb0 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d p);.}../*.** Com
1abc0 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 mit the transact
1abd0 69 6f 6e 20 63 75 72 72 65 6e 74 6c 79 20 69 6e ion currently in
1abe0 20 70 72 6f 67 72 65 73 73 2e 0a 2a 2a 0a 2a 2a progress..**.**
1abf0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d This routine im
1ac00 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 73 65 63 plements the sec
1ac10 6f 6e 64 20 70 68 61 73 65 20 6f 66 20 61 20 32 ond phase of a 2
1ac20 2d 70 68 61 73 65 20 63 6f 6d 6d 69 74 2e 20 20 -phase commit.
1ac30 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 42 74 The.** sqlite3Bt
1ac40 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e reeCommitPhaseOn
1ac50 65 28 29 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 e() routine does
1ac60 20 74 68 65 20 66 69 72 73 74 20 70 68 61 73 65 the first phase
1ac70 20 61 6e 64 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 and should.** b
1ac80 65 20 69 6e 76 6f 6b 65 64 20 70 72 69 6f 72 20 e invoked prior
1ac90 74 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 to calling this
1aca0 72 6f 75 74 69 6e 65 2e 20 20 54 68 65 20 73 71 routine. The sq
1acb0 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1acc0 50 68 61 73 65 4f 6e 65 28 29 0a 2a 2a 20 72 6f PhaseOne().** ro
1acd0 75 74 69 6e 65 20 64 69 64 20 61 6c 6c 20 74 68 utine did all th
1ace0 65 20 77 6f 72 6b 20 6f 66 20 77 72 69 74 69 6e e work of writin
1acf0 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 g information ou
1ad00 74 20 74 6f 20 64 69 73 6b 20 61 6e 64 20 66 6c t to disk and fl
1ad10 75 73 68 69 6e 67 20 74 68 65 0a 2a 2a 20 63 6f ushing the.** co
1ad20 6e 74 65 6e 74 73 20 73 6f 20 74 68 61 74 20 74 ntents so that t
1ad30 68 65 79 20 61 72 65 20 77 72 69 74 74 65 6e 20 hey are written
1ad40 6f 6e 74 6f 20 74 68 65 20 64 69 73 6b 20 70 6c onto the disk pl
1ad50 61 74 74 65 72 2e 20 20 41 6c 6c 20 74 68 69 73 atter. All this
1ad60 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 68 61 73 20 .** routine has
1ad70 74 6f 20 64 6f 20 69 73 20 64 65 6c 65 74 65 20 to do is delete
1ad80 6f 72 20 74 72 75 6e 63 61 74 65 20 6f 72 20 7a or truncate or z
1ad90 65 72 6f 20 74 68 65 20 68 65 61 64 65 72 20 69 ero the header i
1ada0 6e 20 74 68 65 0a 2a 2a 20 74 68 65 20 72 6f 6c n the.** the rol
1adb0 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 28 77 lback journal (w
1adc0 68 69 63 68 20 63 61 75 73 65 73 20 74 68 65 20 hich causes the
1add0 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 6f 20 63 transaction to c
1ade0 6f 6d 6d 69 74 29 20 61 6e 64 0a 2a 2a 20 64 72 ommit) and.** dr
1adf0 6f 70 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 op locks..**.**
1ae00 4e 6f 72 6d 61 6c 6c 79 2c 20 69 66 20 61 6e 20 Normally, if an
1ae10 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
1ae20 6c 65 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 le the pager lay
1ae30 65 72 20 69 73 20 61 74 74 65 6d 70 74 69 6e 67 er is attempting
1ae40 20 74 6f 20 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 to .** finalize
1ae50 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 the underlying
1ae60 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 journal file, th
1ae70 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
1ae80 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 rns an error and
1ae90 0a 2a 2a 20 74 68 65 20 75 70 70 65 72 20 6c 61 .** the upper la
1aea0 79 65 72 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 yer will attempt
1aeb0 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 48 6f 77 a rollback. How
1aec0 65 76 65 72 2c 20 69 66 20 74 68 65 20 73 65 63 ever, if the sec
1aed0 6f 6e 64 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 ond argument.**
1aee0 69 73 20 6e 6f 6e 2d 7a 65 72 6f 20 74 68 65 6e is non-zero then
1aef0 20 74 68 69 73 20 62 2d 74 72 65 65 20 74 72 61 this b-tree tra
1af00 6e 73 61 63 74 69 6f 6e 20 69 73 20 70 61 72 74 nsaction is part
1af10 20 6f 66 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 of a multi-file
1af20 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e .** transaction
1af30 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 . In this case,
1af40 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
1af50 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
1af60 20 63 6f 6d 6d 69 74 74 65 64 20 0a 2a 2a 20 28 committed .** (
1af70 62 79 20 64 65 6c 65 74 69 6e 67 20 61 20 6d 61 by deleting a ma
1af80 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
1af90 65 29 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 65 e) and the calle
1afa0 72 20 77 69 6c 6c 20 69 67 6e 6f 72 65 20 74 68 r will ignore th
1afb0 69 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 is .** functions
1afc0 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 20 53 6f return code. So
1afd0 2c 20 65 76 65 6e 20 69 66 20 61 6e 20 65 72 72 , even if an err
1afe0 6f 72 20 6f 63 63 75 72 73 20 69 6e 20 74 68 65 or occurs in the
1aff0 20 70 61 67 65 72 20 6c 61 79 65 72 2c 0a 2a 2a pager layer,.**
1b000 20 72 65 73 65 74 20 74 68 65 20 62 2d 74 72 65 reset the b-tre
1b010 65 20 6f 62 6a 65 63 74 73 20 69 6e 74 65 72 6e e objects intern
1b020 61 6c 20 73 74 61 74 65 20 74 6f 20 69 6e 64 69 al state to indi
1b030 63 61 74 65 20 74 68 61 74 20 74 68 65 20 77 72 cate that the wr
1b040 69 74 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ite.** transacti
1b050 6f 6e 20 68 61 73 20 62 65 65 6e 20 63 6c 6f 73 on has been clos
1b060 65 64 2e 20 54 68 69 73 20 69 73 20 71 75 69 74 ed. This is quit
1b070 65 20 73 61 66 65 2c 20 61 73 20 74 68 65 20 70 e safe, as the p
1b080 61 67 65 72 20 77 69 6c 6c 20 68 61 76 65 0a 2a ager will have.*
1b090 2a 20 74 72 61 6e 73 69 74 69 6f 6e 65 64 20 74 * transitioned t
1b0a0 6f 20 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 o the error stat
1b0b0 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 e..**.** This wi
1b0c0 6c 6c 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 ll release the w
1b0d0 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 rite lock on the
1b0e0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
1b0f0 20 49 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 If there.** are
1b100 20 6e 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f no active curso
1b110 72 73 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 rs, it also rele
1b120 61 73 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f ases the read lo
1b130 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ck..*/.int sqlit
1b140 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 e3BtreeCommitPha
1b150 73 65 54 77 6f 28 42 74 72 65 65 20 2a 70 2c 20 seTwo(Btree *p,
1b160 69 6e 74 20 62 43 6c 65 61 6e 75 70 29 7b 0a 0a int bCleanup){..
1b170 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1b180 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 20 72 ==TRANS_NONE ) r
1b190 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1b1a0 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
1b1b0 6e 74 65 72 28 70 29 3b 0a 20 20 62 74 72 65 65 nter(p);. btree
1b1c0 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 Integrity(p);..
1b1d0 20 2f 2a 20 49 66 20 74 68 65 20 68 61 6e 64 6c /* If the handl
1b1e0 65 20 68 61 73 20 61 20 77 72 69 74 65 2d 74 72 e has a write-tr
1b1f0 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 ansaction open,
1b200 63 6f 6d 6d 69 74 20 74 68 65 20 73 68 61 72 65 commit the share
1b210 64 2d 62 74 72 65 65 73 20 0a 20 20 2a 2a 20 74 d-btrees . ** t
1b220 72 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 73 ransaction and s
1b230 65 74 20 74 68 65 20 73 68 61 72 65 64 20 73 74 et the shared st
1b240 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 52 45 41 ate to TRANS_REA
1b250 44 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d D.. */. if( p-
1b260 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1b270 57 52 49 54 45 20 29 7b 0a 20 20 20 20 69 6e 74 WRITE ){. int
1b280 20 72 63 3b 0a 20 20 20 20 42 74 53 68 61 72 65 rc;. BtShare
1b290 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
1b2a0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 . assert( pBt
1b2b0 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d ->inTransaction=
1b2c0 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a =TRANS_WRITE );.
1b2d0 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
1b2e0 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3e 30 20 >nTransaction>0
1b2f0 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
1b300 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 te3PagerCommitPh
1b310 61 73 65 54 77 6f 28 70 42 74 2d 3e 70 50 61 67 aseTwo(pBt->pPag
1b320 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 er);. if( rc!
1b330 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 43 =SQLITE_OK && bC
1b340 6c 65 61 6e 75 70 3d 3d 30 20 29 7b 0a 20 20 20 leanup==0 ){.
1b350 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
1b360 65 61 76 65 28 70 29 3b 0a 20 20 20 20 20 20 72 eave(p);. r
1b370 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
1b380 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 pBt->inTrans
1b390 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 action = TRANS_R
1b3a0 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 43 6c EAD;. btreeCl
1b3b0 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 earHasContent(pB
1b3c0 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 t);. }.. btree
1b3d0 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 EndTransaction(p
1b3e0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
1b3f0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
1b400 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
1b410 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 6f 74 68 20 ../*.** Do both
1b420 70 68 61 73 65 73 20 6f 66 20 61 20 63 6f 6d 6d phases of a comm
1b430 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 it..*/.int sqlit
1b440 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 42 74 e3BtreeCommit(Bt
1b450 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 ree *p){. int r
1b460 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 c;. sqlite3Btre
1b470 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 20 eEnter(p);. rc
1b480 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f = sqlite3BtreeCo
1b490 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 2c 20 mmitPhaseOne(p,
1b4a0 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 0);. if( rc==SQ
1b4b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
1b4c0 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
1b4d0 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70 CommitPhaseTwo(p
1b4e0 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 , 0);. }. sqli
1b4f0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
1b500 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1b510 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
1b520 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 73 74 tine sets the st
1b530 61 74 65 20 74 6f 20 43 55 52 53 4f 52 5f 46 41 ate to CURSOR_FA
1b540 55 4c 54 20 61 6e 64 20 74 68 65 20 65 72 72 6f ULT and the erro
1b550 72 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 65 72 72 r.** code to err
1b560 43 6f 64 65 20 66 6f 72 20 65 76 65 72 79 20 63 Code for every c
1b570 75 72 73 6f 72 20 6f 6e 20 42 74 53 68 61 72 65 ursor on BtShare
1b580 64 20 74 68 61 74 20 70 42 74 72 65 65 0a 2a 2a d that pBtree.**
1b590 20 72 65 66 65 72 65 6e 63 65 73 2e 0a 2a 2a 0a references..**.
1b5a0 2a 2a 20 45 76 65 72 79 20 63 75 72 73 6f 72 20 ** Every cursor
1b5b0 69 73 20 74 72 69 70 70 65 64 2c 20 69 6e 63 6c is tripped, incl
1b5c0 75 64 69 6e 67 20 63 75 72 73 6f 72 73 20 74 68 uding cursors th
1b5d0 61 74 20 62 65 6c 6f 6e 67 0a 2a 2a 20 74 6f 20 at belong.** to
1b5e0 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 63 other database c
1b5f0 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 68 61 74 20 onnections that
1b600 68 61 70 70 65 6e 20 74 6f 20 62 65 20 73 68 61 happen to be sha
1b610 72 69 6e 67 0a 2a 2a 20 74 68 65 20 63 61 63 68 ring.** the cach
1b620 65 20 77 69 74 68 20 70 42 74 72 65 65 2e 0a 2a e with pBtree..*
1b630 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
1b640 65 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77 68 e gets called wh
1b650 65 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 en a rollback oc
1b660 63 75 72 73 2e 0a 2a 2a 20 41 6c 6c 20 63 75 72 curs..** All cur
1b670 73 6f 72 73 20 75 73 69 6e 67 20 74 68 65 20 73 sors using the s
1b680 61 6d 65 20 63 61 63 68 65 20 6d 75 73 74 20 62 ame cache must b
1b690 65 20 74 72 69 70 70 65 64 0a 2a 2a 20 74 6f 20 e tripped.** to
1b6a0 70 72 65 76 65 6e 74 20 74 68 65 6d 20 66 72 6f prevent them fro
1b6b0 6d 20 74 72 79 69 6e 67 20 74 6f 20 75 73 65 20 m trying to use
1b6c0 74 68 65 20 62 74 72 65 65 20 61 66 74 65 72 0a the btree after.
1b6d0 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 2e ** the rollback.
1b6e0 20 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6d The rollback m
1b6f0 61 79 20 68 61 76 65 20 64 65 6c 65 74 65 64 20 ay have deleted
1b700 74 61 62 6c 65 73 0a 2a 2a 20 6f 72 20 6d 6f 76 tables.** or mov
1b710 65 64 20 72 6f 6f 74 20 70 61 67 65 73 2c 20 73 ed root pages, s
1b720 6f 20 69 74 20 69 73 20 6e 6f 74 20 73 75 66 66 o it is not suff
1b730 69 63 69 65 6e 74 20 74 6f 0a 2a 2a 20 73 61 76 icient to.** sav
1b740 65 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 e the state of t
1b750 68 65 20 63 75 72 73 6f 72 2e 20 20 54 68 65 20 he cursor. The
1b760 63 75 72 73 6f 72 20 6d 75 73 74 20 62 65 0a 2a cursor must be.*
1b770 2a 20 69 6e 76 61 6c 69 64 61 74 65 64 2e 0a 2a * invalidated..*
1b780 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 /.void sqlite3Bt
1b790 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 reeTripAllCursor
1b7a0 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 65 2c s(Btree *pBtree,
1b7b0 20 69 6e 74 20 65 72 72 43 6f 64 65 29 7b 0a 20 int errCode){.
1b7c0 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 BtCursor *p;.
1b7d0 69 66 28 20 70 42 74 72 65 65 3d 3d 30 20 29 20 if( pBtree==0 )
1b7e0 72 65 74 75 72 6e 3b 0a 20 20 73 71 6c 69 74 65 return;. sqlite
1b7f0 33 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 3BtreeEnter(pBtr
1b800 65 65 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 ee);. for(p=pBt
1b810 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 73 6f ree->pBt->pCurso
1b820 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 r; p; p=p->pNext
1b830 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 ){. int i;.
1b840 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
1b850 65 61 72 43 75 72 73 6f 72 28 70 29 3b 0a 20 20 earCursor(p);.
1b860 20 20 70 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 p->eState = CU
1b870 52 53 4f 52 5f 46 41 55 4c 54 3b 0a 20 20 20 20 RSOR_FAULT;.
1b880 70 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 65 72 p->skipNext = er
1b890 72 43 6f 64 65 3b 0a 20 20 20 20 66 6f 72 28 69 rCode;. for(i
1b8a0 3d 30 3b 20 69 3c 3d 70 2d 3e 69 50 61 67 65 3b =0; i<=p->iPage;
1b8b0 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 65 6c i++){. rel
1b8c0 65 61 73 65 50 61 67 65 28 70 2d 3e 61 70 50 61 easePage(p->apPa
1b8d0 67 65 5b 69 5d 29 3b 0a 20 20 20 20 20 20 70 2d ge[i]);. p-
1b8e0 3e 61 70 50 61 67 65 5b 69 5d 20 3d 20 30 3b 0a >apPage[i] = 0;.
1b8f0 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
1b900 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 42 te3BtreeLeave(pB
1b910 74 72 65 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 tree);.}../*.**
1b920 52 6f 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 Rollback the tra
1b930 6e 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 nsaction in prog
1b940 72 65 73 73 2e 20 20 41 6c 6c 20 63 75 72 73 6f ress. All curso
1b950 72 73 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 69 6e rs will be.** in
1b960 76 61 6c 69 64 65 64 20 62 79 20 74 68 69 73 20 valided by this
1b970 6f 70 65 72 61 74 69 6f 6e 2e 20 20 41 6e 79 20 operation. Any
1b980 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 61 attempt to use a
1b990 20 63 75 72 73 6f 72 0a 2a 2a 20 74 68 61 74 20 cursor.** that
1b9a0 77 61 73 20 6f 70 65 6e 20 61 74 20 74 68 65 20 was open at the
1b9b0 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 69 beginning of thi
1b9c0 73 20 6f 70 65 72 61 74 69 6f 6e 20 77 69 6c 6c s operation will
1b9d0 20 72 65 73 75 6c 74 0a 2a 2a 20 69 6e 20 61 6e result.** in an
1b9e0 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 error..**.** Th
1b9f0 69 73 20 77 69 6c 6c 20 72 65 6c 65 61 73 65 20 is will release
1ba00 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 6f the write lock o
1ba10 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
1ba20 69 6c 65 2e 20 20 49 66 20 74 68 65 72 65 0a 2a ile. If there.*
1ba30 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 * are no active
1ba40 63 75 72 73 6f 72 73 2c 20 69 74 20 61 6c 73 6f cursors, it also
1ba50 20 72 65 6c 65 61 73 65 73 20 74 68 65 20 72 65 releases the re
1ba60 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 ad lock..*/.int
1ba70 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c sqlite3BtreeRoll
1ba80 62 61 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 69 back(Btree *p, i
1ba90 6e 74 20 74 72 69 70 43 6f 64 65 29 7b 0a 20 20 nt tripCode){.
1baa0 69 6e 74 20 72 63 3b 0a 20 20 42 74 53 68 61 72 int rc;. BtShar
1bab0 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
1bac0 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 ;. MemPage *pPa
1bad0 67 65 31 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 ge1;.. sqlite3B
1bae0 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
1baf0 69 66 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 if( tripCode==SQ
1bb00 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
1bb10 63 20 3d 20 74 72 69 70 43 6f 64 65 20 3d 20 73 c = tripCode = s
1bb20 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 aveAllCursors(pB
1bb30 74 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 t, 0, 0);. }els
1bb40 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 e{. rc = SQLI
1bb50 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 TE_OK;. }. if(
1bb60 20 74 72 69 70 43 6f 64 65 20 29 7b 0a 20 20 20 tripCode ){.
1bb70 20 73 71 6c 69 74 65 33 42 74 72 65 65 54 72 69 sqlite3BtreeTri
1bb80 70 41 6c 6c 43 75 72 73 6f 72 73 28 70 2c 20 74 pAllCursors(p, t
1bb90 72 69 70 43 6f 64 65 29 3b 0a 20 20 7d 0a 20 20 ripCode);. }.
1bba0 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 btreeIntegrity(p
1bbb0 29 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 );.. if( p->inT
1bbc0 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 rans==TRANS_WRIT
1bbd0 45 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 32 E ){. int rc2
1bbe0 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 54 ;.. assert( T
1bbf0 52 41 4e 53 5f 57 52 49 54 45 3d 3d 70 42 74 2d RANS_WRITE==pBt-
1bc00 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 >inTransaction )
1bc10 3b 0a 20 20 20 20 72 63 32 20 3d 20 73 71 6c 69 ;. rc2 = sqli
1bc20 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b te3PagerRollback
1bc30 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 (pBt->pPager);.
1bc40 20 20 20 69 66 28 20 72 63 32 21 3d 53 51 4c 49 if( rc2!=SQLI
1bc50 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
1bc60 63 20 3d 20 72 63 32 3b 0a 20 20 20 20 7d 0a 0a c = rc2;. }..
1bc70 20 20 20 20 2f 2a 20 54 68 65 20 72 6f 6c 6c 62 /* The rollb
1bc80 61 63 6b 20 6d 61 79 20 68 61 76 65 20 64 65 73 ack may have des
1bc90 74 72 6f 79 65 64 20 74 68 65 20 70 50 61 67 65 troyed the pPage
1bca0 31 2d 3e 61 44 61 74 61 20 76 61 6c 75 65 2e 20 1->aData value.
1bcb0 20 53 6f 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 So. ** call
1bcc0 62 74 72 65 65 47 65 74 50 61 67 65 28 29 20 6f btreeGetPage() o
1bcd0 6e 20 70 61 67 65 20 31 20 61 67 61 69 6e 20 74 n page 1 again t
1bce0 6f 20 6d 61 6b 65 0a 20 20 20 20 2a 2a 20 73 75 o make. ** su
1bcf0 72 65 20 70 50 61 67 65 31 2d 3e 61 44 61 74 61 re pPage1->aData
1bd00 20 69 73 20 73 65 74 20 63 6f 72 72 65 63 74 6c is set correctl
1bd10 79 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 62 74 y. */. if( bt
1bd20 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 reeGetPage(pBt,
1bd30 31 2c 20 26 70 50 61 67 65 31 2c 20 30 2c 20 30 1, &pPage1, 0, 0
1bd40 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a )==SQLITE_OK ){.
1bd50 20 20 20 20 20 20 69 6e 74 20 6e 50 61 67 65 20 int nPage
1bd60 3d 20 67 65 74 34 62 79 74 65 28 32 38 2b 28 75 = get4byte(28+(u
1bd70 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 61 8*)pPage1->aData
1bd80 29 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 );. testcas
1bd90 65 28 20 6e 50 61 67 65 3d 3d 30 20 29 3b 0a 20 e( nPage==0 );.
1bda0 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 3d 3d if( nPage==
1bdb0 30 20 29 20 73 71 6c 69 74 65 33 50 61 67 65 72 0 ) sqlite3Pager
1bdc0 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d 3e 70 Pagecount(pBt->p
1bdd0 50 61 67 65 72 2c 20 26 6e 50 61 67 65 29 3b 0a Pager, &nPage);.
1bde0 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
1bdf0 70 42 74 2d 3e 6e 50 61 67 65 21 3d 6e 50 61 67 pBt->nPage!=nPag
1be00 65 20 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e e );. pBt->
1be10 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 nPage = nPage;.
1be20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
1be30 28 70 50 61 67 65 31 29 3b 0a 20 20 20 20 7d 0a (pPage1);. }.
1be40 20 20 20 20 61 73 73 65 72 74 28 20 63 6f 75 6e assert( coun
1be50 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 70 42 tValidCursors(pB
1be60 74 2c 20 31 29 3d 3d 30 20 29 3b 0a 20 20 20 20 t, 1)==0 );.
1be70 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
1be80 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b on = TRANS_READ;
1be90 0a 20 20 20 20 62 74 72 65 65 43 6c 65 61 72 48 . btreeClearH
1bea0 61 73 43 6f 6e 74 65 6e 74 28 70 42 74 29 3b 0a asContent(pBt);.
1beb0 20 20 7d 0a 0a 20 20 62 74 72 65 65 45 6e 64 54 }.. btreeEndT
1bec0 72 61 6e 73 61 63 74 69 6f 6e 28 70 29 3b 0a 20 ransaction(p);.
1bed0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1bee0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
1bef0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 61 rc;.}../*.** Sta
1bf00 72 74 20 61 20 73 74 61 74 65 6d 65 6e 74 20 73 rt a statement s
1bf10 75 62 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 ubtransaction. T
1bf20 68 65 20 73 75 62 74 72 61 6e 73 61 63 74 69 6f he subtransactio
1bf30 6e 20 63 61 6e 20 63 61 6e 20 62 65 20 72 6f 6c n can can be rol
1bf40 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 69 6e 64 65 led.** back inde
1bf50 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 68 65 pendently of the
1bf60 20 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f main transactio
1bf70 6e 2e 20 59 6f 75 20 6d 75 73 74 20 73 74 61 72 n. You must star
1bf80 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 t a transaction
1bf90 0a 2a 2a 20 62 65 66 6f 72 65 20 73 74 61 72 74 .** before start
1bfa0 69 6e 67 20 61 20 73 75 62 74 72 61 6e 73 61 63 ing a subtransac
1bfb0 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 61 tion. The subtra
1bfc0 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 6e 64 65 nsaction is ende
1bfd0 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 d automatically
1bfe0 0a 2a 2a 20 69 66 20 74 68 65 20 6d 61 69 6e 20 .** if the main
1bff0 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d transaction comm
1c000 69 74 73 20 6f 72 20 72 6f 6c 6c 73 20 62 61 63 its or rolls bac
1c010 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 65 6d 65 k..**.** Stateme
1c020 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 69 6f nt subtransactio
1c030 6e 73 20 61 72 65 20 75 73 65 64 20 61 72 6f 75 ns are used arou
1c040 6e 64 20 69 6e 64 69 76 69 64 75 61 6c 20 53 51 nd individual SQ
1c050 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 L statements.**
1c060 74 68 61 74 20 61 72 65 20 63 6f 6e 74 61 69 6e that are contain
1c070 65 64 20 77 69 74 68 69 6e 20 61 20 42 45 47 49 ed within a BEGI
1c080 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 6c 6f 63 6b N...COMMIT block
1c090 2e 20 20 49 66 20 61 20 63 6f 6e 73 74 72 61 69 . If a constrai
1c0a0 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 63 75 nt.** error occu
1c0b0 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 74 rs within the st
1c0c0 61 74 65 6d 65 6e 74 2c 20 74 68 65 20 65 66 66 atement, the eff
1c0d0 65 63 74 20 6f 66 20 74 68 61 74 20 6f 6e 65 20 ect of that one
1c0e0 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 63 61 6e statement.** can
1c0f0 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 be rolled back
1c100 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 without having t
1c110 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 20 65 o rollback the e
1c120 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74 69 6f ntire transactio
1c130 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 74 61 74 65 n..**.** A state
1c140 6d 65 6e 74 20 73 75 62 2d 74 72 61 6e 73 61 63 ment sub-transac
1c150 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65 6d 65 6e tion is implemen
1c160 74 65 64 20 61 73 20 61 6e 20 61 6e 6f 6e 79 6d ted as an anonym
1c170 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 2e 20 54 ous savepoint. T
1c180 68 65 0a 2a 2a 20 76 61 6c 75 65 20 70 61 73 73 he.** value pass
1c190 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
1c1a0 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 68 parameter is th
1c1b0 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
1c1c0 66 20 73 61 76 65 70 6f 69 6e 74 73 2c 0a 2a 2a f savepoints,.**
1c1d0 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 6e including the n
1c1e0 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 20 73 61 76 ew anonymous sav
1c1f0 65 70 6f 69 6e 74 2c 20 6f 70 65 6e 20 6f 6e 20 epoint, open on
1c200 74 68 65 20 42 2d 54 72 65 65 2e 20 69 2e 65 2e the B-Tree. i.e.
1c210 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 if there.** are
1c220 20 6e 6f 20 61 63 74 69 76 65 20 73 61 76 65 70 no active savep
1c230 6f 69 6e 74 73 20 61 6e 64 20 6e 6f 20 6f 74 68 oints and no oth
1c240 65 72 20 73 74 61 74 65 6d 65 6e 74 2d 74 72 61 er statement-tra
1c250 6e 73 61 63 74 69 6f 6e 73 20 6f 70 65 6e 2c 0a nsactions open,.
1c260 2a 2a 20 69 53 74 61 74 65 6d 65 6e 74 20 69 73 ** iStatement is
1c270 20 31 2e 20 54 68 69 73 20 61 6e 6f 6e 79 6d 6f 1. This anonymo
1c280 75 73 20 73 61 76 65 70 6f 69 6e 74 20 63 61 6e us savepoint can
1c290 20 62 65 20 72 65 6c 65 61 73 65 64 20 6f 72 20 be released or
1c2a0 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 2a 2a 20 75 rolled back.** u
1c2b0 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 sing the sqlite3
1c2c0 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 28 29 BtreeSavepoint()
1c2d0 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e function..*/.in
1c2e0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 t sqlite3BtreeBe
1c2f0 67 69 6e 53 74 6d 74 28 42 74 72 65 65 20 2a 70 ginStmt(Btree *p
1c300 2c 20 69 6e 74 20 69 53 74 61 74 65 6d 65 6e 74 , int iStatement
1c310 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 ){. int rc;. B
1c320 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
1c330 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 65 33 ->pBt;. sqlite3
1c340 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
1c350 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e 54 72 assert( p->inTr
1c360 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
1c370 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 );. assert( (p
1c380 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
1c390 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d 3d 30 TS_READ_ONLY)==0
1c3a0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 );. assert( iS
1c3b0 74 61 74 65 6d 65 6e 74 3e 30 20 29 3b 0a 20 20 tatement>0 );.
1c3c0 61 73 73 65 72 74 28 20 69 53 74 61 74 65 6d 65 assert( iStateme
1c3d0 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 61 76 65 70 nt>p->db->nSavep
1c3e0 6f 69 6e 74 20 29 3b 0a 20 20 61 73 73 65 72 74 oint );. assert
1c3f0 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 ( pBt->inTransac
1c400 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 tion==TRANS_WRIT
1c410 45 20 29 3b 0a 20 20 2f 2a 20 41 74 20 74 68 65 E );. /* At the
1c420 20 70 61 67 65 72 20 6c 65 76 65 6c 2c 20 61 20 pager level, a
1c430 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 statement transa
1c440 63 74 69 6f 6e 20 69 73 20 61 20 73 61 76 65 70 ction is a savep
1c450 6f 69 6e 74 20 77 69 74 68 0a 20 20 2a 2a 20 61 oint with. ** a
1c460 6e 20 69 6e 64 65 78 20 67 72 65 61 74 65 72 20 n index greater
1c470 74 68 61 6e 20 61 6c 6c 20 73 61 76 65 70 6f 69 than all savepoi
1c480 6e 74 73 20 63 72 65 61 74 65 64 20 65 78 70 6c nts created expl
1c490 69 63 69 74 6c 79 20 75 73 69 6e 67 0a 20 20 2a icitly using. *
1c4a0 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 * SQL statements
1c4b0 2e 20 49 74 20 69 73 20 69 6c 6c 65 67 61 6c 20 . It is illegal
1c4c0 74 6f 20 6f 70 65 6e 2c 20 72 65 6c 65 61 73 65 to open, release
1c4d0 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 79 or rollback any
1c4e0 0a 20 20 2a 2a 20 73 75 63 68 20 73 61 76 65 70 . ** such savep
1c4f0 6f 69 6e 74 73 20 77 68 69 6c 65 20 74 68 65 20 oints while the
1c500 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 statement transa
1c510 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e 74 20 ction savepoint
1c520 69 73 20 61 63 74 69 76 65 2e 0a 20 20 2a 2f 0a is active.. */.
1c530 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1c540 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 69 6e 74 gerOpenSavepoint
1c550 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 69 53 (pBt->pPager, iS
1c560 74 61 74 65 6d 65 6e 74 29 3b 0a 20 20 73 71 6c tatement);. sql
1c570 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
1c580 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
1c590 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 65 63 }../*.** The sec
1c5a0 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 ond argument to
1c5b0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 6f this function, o
1c5c0 70 2c 20 69 73 20 61 6c 77 61 79 73 20 53 41 56 p, is always SAV
1c5d0 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 0a EPOINT_ROLLBACK.
1c5e0 2a 2a 20 6f 72 20 53 41 56 45 50 4f 49 4e 54 5f ** or SAVEPOINT_
1c5f0 52 45 4c 45 41 53 45 2e 20 54 68 69 73 20 66 75 RELEASE. This fu
1c600 6e 63 74 69 6f 6e 20 65 69 74 68 65 72 20 72 65 nction either re
1c610 6c 65 61 73 65 73 20 6f 72 20 72 6f 6c 6c 73 20 leases or rolls
1c620 62 61 63 6b 20 74 68 65 0a 2a 2a 20 73 61 76 65 back the.** save
1c630 70 6f 69 6e 74 20 69 64 65 6e 74 69 66 69 65 64 point identified
1c640 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 69 53 by parameter iS
1c650 61 76 65 70 6f 69 6e 74 2c 20 64 65 70 65 6e 64 avepoint, depend
1c660 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 ing on the value
1c670 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a 2a 2a 0a 2a .** of op..**.*
1c680 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 53 61 76 * Normally, iSav
1c690 65 70 6f 69 6e 74 20 69 73 20 67 72 65 61 74 65 epoint is greate
1c6a0 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 r than or equal
1c6b0 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 65 76 65 72 to zero. However
1c6c0 2c 20 69 66 20 6f 70 20 69 73 0a 2a 2a 20 53 41 , if op is.** SA
1c6d0 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b VEPOINT_ROLLBACK
1c6e0 2c 20 74 68 65 6e 20 69 53 61 76 65 70 6f 69 6e , then iSavepoin
1c6f0 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 2d 31 t may also be -1
1c700 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 . In this case t
1c710 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 20 he .** contents
1c720 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20 74 72 of the entire tr
1c730 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 20 72 6f ansaction are ro
1c740 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 69 73 20 lled back. This
1c750 69 73 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20 is different.**
1c760 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 74 72 from a normal tr
1c770 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c 62 61 ansaction rollba
1c780 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f 63 6b 73 20 ck, as no locks
1c790 61 72 65 20 72 65 6c 65 61 73 65 64 20 61 6e 64 are released and
1c7a0 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 the.** transact
1c7b0 69 6f 6e 20 72 65 6d 61 69 6e 73 20 6f 70 65 6e ion remains open
1c7c0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1c7d0 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 28 42 BtreeSavepoint(B
1c7e0 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6f 70 2c tree *p, int op,
1c7f0 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 29 int iSavepoint)
1c800 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
1c810 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 20 ITE_OK;. if( p
1c820 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 && p->inTrans==T
1c830 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 RANS_WRITE ){.
1c840 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1c850 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 61 73 = p->pBt;. as
1c860 73 65 72 74 28 20 6f 70 3d 3d 53 41 56 45 50 4f sert( op==SAVEPO
1c870 49 4e 54 5f 52 45 4c 45 41 53 45 20 7c 7c 20 6f INT_RELEASE || o
1c880 70 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c p==SAVEPOINT_ROL
1c890 4c 42 41 43 4b 20 29 3b 0a 20 20 20 20 61 73 73 LBACK );. ass
1c8a0 65 72 74 28 20 69 53 61 76 65 70 6f 69 6e 74 3e ert( iSavepoint>
1c8b0 3d 30 20 7c 7c 20 28 69 53 61 76 65 70 6f 69 6e =0 || (iSavepoin
1c8c0 74 3d 3d 2d 31 20 26 26 20 6f 70 3d 3d 53 41 56 t==-1 && op==SAV
1c8d0 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 29 EPOINT_ROLLBACK)
1c8e0 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 );. sqlite3B
1c8f0 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
1c900 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1c910 67 65 72 53 61 76 65 70 6f 69 6e 74 28 70 42 74 gerSavepoint(pBt
1c920 2d 3e 70 50 61 67 65 72 2c 20 6f 70 2c 20 69 53 ->pPager, op, iS
1c930 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 20 20 69 avepoint);. i
1c940 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1c950 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 53 ){. if( iS
1c960 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 20 28 70 avepoint<0 && (p
1c970 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
1c980 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d 50 TS_INITIALLY_EMP
1c990 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 TY)!=0 ){.
1c9a0 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 30 pBt->nPage = 0
1c9b0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
1c9c0 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 rc = newDatabase
1c9d0 28 70 42 74 29 3b 0a 20 20 20 20 20 20 70 42 74 (pBt);. pBt
1c9e0 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 ->nPage = get4by
1c9f0 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 70 50 61 te(28 + pBt->pPa
1ca00 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a 0a 20 20 ge1->aData);..
1ca10 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 /* The datab
1ca20 61 73 65 20 73 69 7a 65 20 77 61 73 20 77 72 69 ase size was wri
1ca30 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6f 66 tten into the of
1ca40 66 73 65 74 20 32 38 20 6f 66 20 74 68 65 20 68 fset 28 of the h
1ca50 65 61 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 77 eader. ** w
1ca60 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 hen the transact
1ca70 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 73 6f 20 ion started, so
1ca80 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 we know that the
1ca90 20 76 61 6c 75 65 20 61 74 20 6f 66 66 73 65 74 value at offset
1caa0 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 69 73 20 . ** 28 is
1cab0 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 20 20 20 nonzero. */.
1cac0 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e assert( pBt->n
1cad0 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 20 7d 0a Page>0 );. }.
1cae0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1caf0 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 20 Leave(p);. }.
1cb00 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1cb10 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 .** Create a new
1cb20 20 63 75 72 73 6f 72 20 66 6f 72 20 74 68 65 20 cursor for the
1cb30 42 54 72 65 65 20 77 68 6f 73 65 20 72 6f 6f 74 BTree whose root
1cb40 20 69 73 20 6f 6e 20 74 68 65 20 70 61 67 65 0a is on the page.
1cb50 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 20 61 20 ** iTable. If a
1cb60 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 73 6f 72 read-only cursor
1cb70 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 69 is requested, i
1cb80 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 t is assumed tha
1cb90 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 20 t.** the caller
1cba0 61 6c 72 65 61 64 79 20 68 61 73 20 61 74 20 6c already has at l
1cbb0 65 61 73 74 20 61 20 72 65 61 64 2d 6f 6e 6c 79 east a read-only
1cbc0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 transaction ope
1cbd0 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 61 74 61 n.** on the data
1cbe0 62 61 73 65 20 61 6c 72 65 61 64 79 2e 20 49 66 base already. If
1cbf0 20 61 20 77 72 69 74 65 2d 63 75 72 73 6f 72 20 a write-cursor
1cc00 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 68 is requested, th
1cc10 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 en.** the caller
1cc20 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 68 is assumed to h
1cc30 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 74 ave an open writ
1cc40 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a e transaction..*
1cc50 2a 0a 2a 2a 20 49 66 20 77 72 46 6c 61 67 3d 3d *.** If wrFlag==
1cc60 30 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 0, then the curs
1cc70 6f 72 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 75 or can only be u
1cc80 73 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 2e sed for reading.
1cc90 0a 2a 2a 20 49 66 20 77 72 46 6c 61 67 3d 3d 31 .** If wrFlag==1
1cca0 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
1ccb0 72 20 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f r can be used fo
1ccc0 72 20 72 65 61 64 69 6e 67 20 6f 72 20 66 6f 72 r reading or for
1ccd0 0a 2a 2a 20 77 72 69 74 69 6e 67 20 69 66 20 6f .** writing if o
1cce0 74 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e 73 20 ther conditions
1ccf0 66 6f 72 20 77 72 69 74 69 6e 67 20 61 72 65 20 for writing are
1cd00 61 6c 73 6f 20 6d 65 74 2e 20 20 54 68 65 73 65 also met. These
1cd10 0a 2a 2a 20 61 72 65 20 74 68 65 20 63 6f 6e 64 .** are the cond
1cd20 69 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 73 74 itions that must
1cd30 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 65 72 be met in order
1cd40 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 6f 0a for writing to.
1cd50 2a 2a 20 62 65 20 61 6c 6c 6f 77 65 64 3a 0a 2a ** be allowed:.*
1cd60 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 75 72 *.** 1: The cur
1cd70 73 6f 72 20 6d 75 73 74 20 68 61 76 65 20 62 65 sor must have be
1cd80 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 20 77 en opened with w
1cd90 72 46 6c 61 67 3d 3d 31 0a 2a 2a 0a 2a 2a 20 32 rFlag==1.**.** 2
1cda0 3a 20 20 4f 74 68 65 72 20 64 61 74 61 62 61 73 : Other databas
1cdb0 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 68 e connections th
1cdc0 61 74 20 73 68 61 72 65 20 74 68 65 20 73 61 6d at share the sam
1cdd0 65 20 70 61 67 65 72 20 63 61 63 68 65 0a 2a 2a e pager cache.**
1cde0 20 20 20 20 20 62 75 74 20 77 68 69 63 68 20 61 but which a
1cdf0 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 52 45 re not in the RE
1ce00 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 20 73 AD_UNCOMMITTED s
1ce10 74 61 74 65 20 6d 61 79 20 6e 6f 74 20 68 61 76 tate may not hav
1ce20 65 0a 2a 2a 20 20 20 20 20 63 75 72 73 6f 72 73 e.** cursors
1ce30 20 6f 70 65 6e 20 77 69 74 68 20 77 72 46 6c 61 open with wrFla
1ce40 67 3d 3d 30 20 6f 6e 20 74 68 65 20 73 61 6d 65 g==0 on the same
1ce50 20 74 61 62 6c 65 2e 20 20 4f 74 68 65 72 77 69 table. Otherwi
1ce60 73 65 0a 2a 2a 20 20 20 20 20 74 68 65 20 63 68 se.** the ch
1ce70 61 6e 67 65 73 20 6d 61 64 65 20 62 79 20 74 68 anges made by th
1ce80 69 73 20 77 72 69 74 65 20 63 75 72 73 6f 72 20 is write cursor
1ce90 77 6f 75 6c 64 20 62 65 20 76 69 73 69 62 6c 65 would be visible
1cea0 20 74 6f 0a 2a 2a 20 20 20 20 20 74 68 65 20 72 to.** the r
1ceb0 65 61 64 20 63 75 72 73 6f 72 73 20 69 6e 20 74 ead cursors in t
1cec0 68 65 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 he other databas
1ced0 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2a e connection..**
1cee0 0a 2a 2a 20 33 3a 20 20 54 68 65 20 64 61 74 61 .** 3: The data
1cef0 62 61 73 65 20 6d 75 73 74 20 62 65 20 77 72 69 base must be wri
1cf00 74 61 62 6c 65 20 28 6e 6f 74 20 6f 6e 20 72 65 table (not on re
1cf10 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 61 29 0a 2a ad-only media).*
1cf20 2a 0a 2a 2a 20 34 3a 20 20 54 68 65 72 65 20 6d *.** 4: There m
1cf30 75 73 74 20 62 65 20 61 6e 20 61 63 74 69 76 65 ust be an active
1cf40 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
1cf50 0a 2a 2a 20 4e 6f 20 63 68 65 63 6b 69 6e 67 20 .** No checking
1cf60 69 73 20 64 6f 6e 65 20 74 6f 20 6d 61 6b 65 20 is done to make
1cf70 73 75 72 65 20 74 68 61 74 20 70 61 67 65 20 69 sure that page i
1cf80 54 61 62 6c 65 20 72 65 61 6c 6c 79 20 69 73 20 Table really is
1cf90 74 68 65 0a 2a 2a 20 72 6f 6f 74 20 70 61 67 65 the.** root page
1cfa0 20 6f 66 20 61 20 62 2d 74 72 65 65 2e 20 20 49 of a b-tree. I
1cfb0 66 20 69 74 20 69 73 20 6e 6f 74 2c 20 74 68 65 f it is not, the
1cfc0 6e 20 74 68 65 20 63 75 72 73 6f 72 20 61 63 71 n the cursor acq
1cfd0 75 69 72 65 64 0a 2a 2a 20 77 69 6c 6c 20 6e 6f uired.** will no
1cfe0 74 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 t work correctly
1cff0 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 61 73 ..**.** It is as
1d000 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 20 73 sumed that the s
1d010 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f qlite3BtreeCurso
1d020 72 5a 65 72 6f 28 29 20 68 61 73 20 62 65 65 6e rZero() has been
1d030 20 63 61 6c 6c 65 64 0a 2a 2a 20 6f 6e 20 70 43 called.** on pC
1d040 75 72 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 ur to initialize
1d050 20 74 68 65 20 6d 65 6d 6f 72 79 20 73 70 61 63 the memory spac
1d060 65 20 70 72 69 6f 72 20 74 6f 20 69 6e 76 6f 6b e prior to invok
1d070 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ing this routine
1d080 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1d090 62 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 42 btreeCursor(. B
1d0a0 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 tree *p,
1d0b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d0c0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 /* The btr
1d0d0 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 54 61 62 ee */. int iTab
1d0e0 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 le,
1d0f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d100 2a 20 52 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 * Root page of t
1d110 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a able to open */.
1d120 20 20 69 6e 74 20 77 72 46 6c 61 67 2c 20 20 20 int wrFlag,
1d130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d140 20 20 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f /* 1 to
1d150 20 77 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f write. 0 read-o
1d160 6e 6c 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 nly */. struct
1d170 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 KeyInfo *pKeyInf
1d180 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o,
1d190 2f 2a 20 46 69 72 73 74 20 61 72 67 20 74 6f 20 /* First arg to
1d1a0 63 6f 6d 70 61 72 69 73 6f 6e 20 66 75 6e 63 74 comparison funct
1d1b0 69 6f 6e 20 2a 2f 0a 20 20 42 74 43 75 72 73 6f ion */. BtCurso
1d1c0 72 20 2a 70 43 75 72 20 20 20 20 20 20 20 20 20 r *pCur
1d1d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d1e0 2f 2a 20 53 70 61 63 65 20 66 6f 72 20 6e 65 77 /* Space for new
1d1f0 20 63 75 72 73 6f 72 20 2a 2f 0a 29 7b 0a 20 20 cursor */.){.
1d200 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
1d210 70 2d 3e 70 42 74 3b 20 20 20 20 20 20 20 20 20 p->pBt;
1d220 20 20 20 20 20 20 20 2f 2a 20 53 68 61 72 65 64 /* Shared
1d230 20 62 2d 74 72 65 65 20 68 61 6e 64 6c 65 20 2a b-tree handle *
1d240 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c /.. assert( sql
1d250 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 ite3BtreeHoldsMu
1d260 74 65 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 tex(p) );. asse
1d270 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c rt( wrFlag==0 ||
1d280 20 77 72 46 6c 61 67 3d 3d 31 20 29 3b 0a 0a 20 wrFlag==1 );..
1d290 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e /* The followin
1d2a0 67 20 61 73 73 65 72 74 20 73 74 61 74 65 6d 65 g assert stateme
1d2b0 6e 74 73 20 76 65 72 69 66 79 20 74 68 61 74 20 nts verify that
1d2c0 69 66 20 74 68 69 73 20 69 73 20 61 20 73 68 61 if this is a sha
1d2d0 72 61 62 6c 65 20 0a 20 20 2a 2a 20 62 2d 74 72 rable . ** b-tr
1d2e0 65 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 ee database, the
1d2f0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 connection is h
1d300 6f 6c 64 69 6e 67 20 74 68 65 20 72 65 71 75 69 olding the requi
1d310 72 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 2c red table locks,
1d320 20 0a 20 20 2a 2a 20 61 6e 64 20 74 68 61 74 20 . ** and that
1d330 6e 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 no other connect
1d340 69 6f 6e 20 68 61 73 20 61 6e 79 20 6f 70 65 6e ion has any open
1d350 20 63 75 72 73 6f 72 20 74 68 61 74 20 63 6f 6e cursor that con
1d360 66 6c 69 63 74 73 20 77 69 74 68 20 0a 20 20 2a flicts with . *
1d370 2a 20 74 68 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f * this lock. */
1d380 0a 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 . assert( hasSh
1d390 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
1d3a0 63 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 70 4b ck(p, iTable, pK
1d3b0 65 79 49 6e 66 6f 21 3d 30 2c 20 77 72 46 6c 61 eyInfo!=0, wrFla
1d3c0 67 2b 31 29 20 29 3b 0a 20 20 61 73 73 65 72 74 g+1) );. assert
1d3d0 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 21 ( wrFlag==0 || !
1d3e0 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 hasReadConflicts
1d3f0 28 70 2c 20 69 54 61 62 6c 65 29 20 29 3b 0a 0a (p, iTable) );..
1d400 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 /* Assert that
1d410 20 74 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 the caller has
1d420 6f 70 65 6e 65 64 20 74 68 65 20 72 65 71 75 69 opened the requi
1d430 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e red transaction.
1d440 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d */. assert( p-
1d450 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f 4e >inTrans>TRANS_N
1d460 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ONE );. assert(
1d470 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 70 2d wrFlag==0 || p-
1d480 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1d490 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 WRITE );. asser
1d4a0 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 20 26 t( pBt->pPage1 &
1d4b0 26 20 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 & pBt->pPage1->a
1d4c0 44 61 74 61 20 29 3b 0a 0a 20 20 69 66 28 20 4e Data );.. if( N
1d4d0 45 56 45 52 28 77 72 46 6c 61 67 20 26 26 20 28 EVER(wrFlag && (
1d4e0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
1d4f0 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 21 3d BTS_READ_ONLY)!=
1d500 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 0) ){. return
1d510 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
1d520 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 54 61 62 ;. }. if( iTab
1d530 6c 65 3d 3d 31 20 26 26 20 62 74 72 65 65 50 61 le==1 && btreePa
1d540 67 65 63 6f 75 6e 74 28 70 42 74 29 3d 3d 30 20 gecount(pBt)==0
1d550 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 77 ){. assert( w
1d560 72 46 6c 61 67 3d 3d 30 20 29 3b 0a 20 20 20 20 rFlag==0 );.
1d570 69 54 61 62 6c 65 20 3d 20 30 3b 0a 20 20 7d 0a iTable = 0;. }.
1d580 0a 20 20 2f 2a 20 4e 6f 77 20 74 68 61 74 20 6e . /* Now that n
1d590 6f 20 6f 74 68 65 72 20 65 72 72 6f 72 73 20 63 o other errors c
1d5a0 61 6e 20 6f 63 63 75 72 2c 20 66 69 6e 69 73 68 an occur, finish
1d5b0 20 66 69 6c 6c 69 6e 67 20 69 6e 20 74 68 65 20 filling in the
1d5c0 42 74 43 75 72 73 6f 72 0a 20 20 2a 2a 20 76 61 BtCursor. ** va
1d5d0 72 69 61 62 6c 65 73 20 61 6e 64 20 6c 69 6e 6b riables and link
1d5e0 20 74 68 65 20 63 75 72 73 6f 72 20 69 6e 74 6f the cursor into
1d5f0 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6c 69 the BtShared li
1d600 73 74 2e 20 20 2a 2f 0a 20 20 70 43 75 72 2d 3e st. */. pCur->
1d610 70 67 6e 6f 52 6f 6f 74 20 3d 20 28 50 67 6e 6f pgnoRoot = (Pgno
1d620 29 69 54 61 62 6c 65 3b 0a 20 20 70 43 75 72 2d )iTable;. pCur-
1d630 3e 69 50 61 67 65 20 3d 20 2d 31 3b 0a 20 20 70 >iPage = -1;. p
1d640 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 3d 20 Cur->pKeyInfo =
1d650 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 70 43 75 72 pKeyInfo;. pCur
1d660 2d 3e 70 42 74 72 65 65 20 3d 20 70 3b 0a 20 20 ->pBtree = p;.
1d670 70 43 75 72 2d 3e 70 42 74 20 3d 20 70 42 74 3b pCur->pBt = pBt;
1d680 0a 20 20 70 43 75 72 2d 3e 77 72 46 6c 61 67 20 . pCur->wrFlag
1d690 3d 20 28 75 38 29 77 72 46 6c 61 67 3b 0a 20 20 = (u8)wrFlag;.
1d6a0 70 43 75 72 2d 3e 70 4e 65 78 74 20 3d 20 70 42 pCur->pNext = pB
1d6b0 74 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 20 69 66 t->pCursor;. if
1d6c0 28 20 70 43 75 72 2d 3e 70 4e 65 78 74 20 29 7b ( pCur->pNext ){
1d6d0 0a 20 20 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 . pCur->pNext
1d6e0 2d 3e 70 50 72 65 76 20 3d 20 70 43 75 72 3b 0a ->pPrev = pCur;.
1d6f0 20 20 7d 0a 20 20 70 42 74 2d 3e 70 43 75 72 73 }. pBt->pCurs
1d700 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 43 75 or = pCur;. pCu
1d710 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
1d720 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 70 43 OR_INVALID;. pC
1d730 75 72 2d 3e 63 61 63 68 65 64 52 6f 77 69 64 20 ur->cachedRowid
1d740 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 = 0;. return SQ
1d750 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 LITE_OK;.}.int s
1d760 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f qlite3BtreeCurso
1d770 72 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 r(. Btree *p,
1d780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d7a0 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
1d7b0 0a 20 20 69 6e 74 20 69 54 61 62 6c 65 2c 20 20 . int iTable,
1d7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d7e0 2a 20 52 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 * Root page of t
1d7f0 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a able to open */.
1d800 20 20 69 6e 74 20 77 72 46 6c 61 67 2c 20 20 20 int wrFlag,
1d810 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1d830 20 31 20 74 6f 20 77 72 69 74 65 2e 20 30 20 72 1 to write. 0 r
1d840 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 ead-only */. st
1d850 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 2a 70 4b ruct KeyInfo *pK
1d860 65 79 49 6e 66 6f 2c 20 20 20 20 20 20 20 20 20 eyInfo,
1d870 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
1d880 73 74 20 61 72 67 20 74 6f 20 78 43 6f 6d 70 61 st arg to xCompa
1d890 72 65 28 29 20 2a 2f 0a 20 20 42 74 43 75 72 73 re() */. BtCurs
1d8a0 6f 72 20 2a 70 43 75 72 20 20 20 20 20 20 20 20 or *pCur
1d8b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d8c0 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 6e /* Write n
1d8d0 65 77 20 63 75 72 73 6f 72 20 68 65 72 65 20 2a ew cursor here *
1d8e0 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 /.){. int rc;.
1d8f0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1d900 65 72 28 70 29 3b 0a 20 20 72 63 20 3d 20 62 74 er(p);. rc = bt
1d910 72 65 65 43 75 72 73 6f 72 28 70 2c 20 69 54 61 reeCursor(p, iTa
1d920 62 6c 65 2c 20 77 72 46 6c 61 67 2c 20 70 4b 65 ble, wrFlag, pKe
1d930 79 49 6e 66 6f 2c 20 70 43 75 72 29 3b 0a 20 20 yInfo, pCur);.
1d940 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1d950 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
1d960 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 c;.}../*.** Retu
1d970 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61 rn the size of a
1d980 20 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 BtCursor object
1d990 20 69 6e 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a in bytes..**.**
1d9a0 20 54 68 69 73 20 69 6e 74 65 72 66 61 63 65 73 This interfaces
1d9b0 20 69 73 20 6e 65 65 64 65 64 20 73 6f 20 74 68 is needed so th
1d9c0 61 74 20 75 73 65 72 73 20 6f 66 20 63 75 72 73 at users of curs
1d9d0 6f 72 73 20 63 61 6e 20 70 72 65 61 6c 6c 6f 63 ors can prealloc
1d9e0 61 74 65 0a 2a 2a 20 73 75 66 66 69 63 69 65 6e ate.** sufficien
1d9f0 74 20 73 74 6f 72 61 67 65 20 74 6f 20 68 6f 6c t storage to hol
1da00 64 20 61 20 63 75 72 73 6f 72 2e 20 20 54 68 65 d a cursor. The
1da10 20 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 BtCursor object
1da20 20 69 73 20 6f 70 61 71 75 65 0a 2a 2a 20 74 6f is opaque.** to
1da30 20 75 73 65 72 73 20 73 6f 20 74 68 65 79 20 63 users so they c
1da40 61 6e 6e 6f 74 20 64 6f 20 74 68 65 20 73 69 7a annot do the siz
1da50 65 6f 66 28 29 20 74 68 65 6d 73 65 6c 76 65 73 eof() themselves
1da60 20 2d 20 74 68 65 79 20 6d 75 73 74 20 63 61 6c - they must cal
1da70 6c 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e l.** this routin
1da80 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
1da90 33 42 74 72 65 65 43 75 72 73 6f 72 53 69 7a 65 3BtreeCursorSize
1daa0 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e (void){. return
1dab0 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 42 ROUND8(sizeof(B
1dac0 74 43 75 72 73 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a tCursor));.}../*
1dad0 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 6d .** Initialize m
1dae0 65 6d 6f 72 79 20 74 68 61 74 20 77 69 6c 6c 20 emory that will
1daf0 62 65 20 63 6f 6e 76 65 72 74 65 64 20 69 6e 74 be converted int
1db00 6f 20 61 20 42 74 43 75 72 73 6f 72 20 6f 62 6a o a BtCursor obj
1db10 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 ect..**.** The s
1db20 69 6d 70 6c 65 20 61 70 70 72 6f 61 63 68 20 68 imple approach h
1db30 65 72 65 20 77 6f 75 6c 64 20 62 65 20 74 6f 20 ere would be to
1db40 6d 65 6d 73 65 74 28 29 20 74 68 65 20 65 6e 74 memset() the ent
1db50 69 72 65 20 6f 62 6a 65 63 74 0a 2a 2a 20 74 6f ire object.** to
1db60 20 7a 65 72 6f 2e 20 20 42 75 74 20 69 74 20 74 zero. But it t
1db70 75 72 6e 73 20 6f 75 74 20 74 68 61 74 20 74 68 urns out that th
1db80 65 20 61 70 50 61 67 65 5b 5d 20 61 6e 64 20 61 e apPage[] and a
1db90 69 49 64 78 5b 5d 20 61 72 72 61 79 73 0a 2a 2a iIdx[] arrays.**
1dba0 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 do not need to
1dbb0 62 65 20 7a 65 72 6f 65 64 20 61 6e 64 20 74 68 be zeroed and th
1dbc0 65 79 20 61 72 65 20 6c 61 72 67 65 2c 20 73 6f ey are large, so
1dbd0 20 77 65 20 63 61 6e 20 73 61 76 65 20 61 20 6c we can save a l
1dbe0 6f 74 0a 2a 2a 20 6f 66 20 72 75 6e 2d 74 69 6d ot.** of run-tim
1dbf0 65 20 62 79 20 73 6b 69 70 70 69 6e 67 20 74 68 e by skipping th
1dc00 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e e initialization
1dc10 20 6f 66 20 74 68 6f 73 65 20 65 6c 65 6d 65 6e of those elemen
1dc20 74 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ts..*/.void sqli
1dc30 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 5a 65 te3BtreeCursorZe
1dc40 72 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 29 7b ro(BtCursor *p){
1dc50 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 . memset(p, 0,
1dc60 6f 66 66 73 65 74 6f 66 28 42 74 43 75 72 73 6f offsetof(BtCurso
1dc70 72 2c 20 69 50 61 67 65 29 29 3b 0a 7d 0a 0a 2f r, iPage));.}../
1dc80 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 63 61 63 *.** Set the cac
1dc90 68 65 64 20 72 6f 77 69 64 20 76 61 6c 75 65 20 hed rowid value
1dca0 6f 66 20 65 76 65 72 79 20 63 75 72 73 6f 72 20 of every cursor
1dcb0 69 6e 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 in the same data
1dcc0 62 61 73 65 20 66 69 6c 65 0a 2a 2a 20 61 73 20 base file.** as
1dcd0 70 43 75 72 20 61 6e 64 20 68 61 76 69 6e 67 20 pCur and having
1dce0 74 68 65 20 73 61 6d 65 20 72 6f 6f 74 20 70 61 the same root pa
1dcf0 67 65 20 6e 75 6d 62 65 72 20 61 73 20 70 43 75 ge number as pCu
1dd00 72 2e 20 20 54 68 65 20 76 61 6c 75 65 20 69 73 r. The value is
1dd10 0a 2a 2a 20 73 65 74 20 74 6f 20 69 52 6f 77 69 .** set to iRowi
1dd20 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 70 6f d..**.** Only po
1dd30 73 69 74 69 76 65 20 72 6f 77 69 64 20 76 61 6c sitive rowid val
1dd40 75 65 73 20 61 72 65 20 63 6f 6e 73 69 64 65 72 ues are consider
1dd50 65 64 20 76 61 6c 69 64 20 66 6f 72 20 74 68 69 ed valid for thi
1dd60 73 20 63 61 63 68 65 2e 0a 2a 2a 20 54 68 65 20 s cache..** The
1dd70 63 61 63 68 65 20 69 73 20 69 6e 69 74 69 61 6c cache is initial
1dd80 69 7a 65 64 20 74 6f 20 7a 65 72 6f 2c 20 69 6e ized to zero, in
1dd90 64 69 63 61 74 69 6e 67 20 61 6e 20 69 6e 76 61 dicating an inva
1dda0 6c 69 64 20 63 61 63 68 65 2e 0a 2a 2a 20 41 20 lid cache..** A
1ddb0 62 74 72 65 65 20 77 69 6c 6c 20 77 6f 72 6b 20 btree will work
1ddc0 66 69 6e 65 20 77 69 74 68 20 7a 65 72 6f 20 6f fine with zero o
1ddd0 72 20 6e 65 67 61 74 69 76 65 20 72 6f 77 69 64 r negative rowid
1dde0 73 2e 20 20 57 65 20 6a 75 73 74 20 63 61 6e 6e s. We just cann
1ddf0 6f 74 0a 2a 2a 20 63 61 63 68 65 20 7a 65 72 6f ot.** cache zero
1de00 20 6f 72 20 6e 65 67 61 74 69 76 65 20 72 6f 77 or negative row
1de10 69 64 73 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 ids, which means
1de20 20 74 61 62 6c 65 73 20 74 68 61 74 20 75 73 65 tables that use
1de30 20 7a 65 72 6f 20 6f 72 0a 2a 2a 20 6e 65 67 61 zero or.** nega
1de40 74 69 76 65 20 72 6f 77 69 64 73 20 6d 69 67 68 tive rowids migh
1de50 74 20 72 75 6e 20 61 20 6c 69 74 74 6c 65 20 73 t run a little s
1de60 6c 6f 77 65 72 2e 20 20 42 75 74 20 69 6e 20 70 lower. But in p
1de70 72 61 63 74 69 63 65 2c 20 7a 65 72 6f 0a 2a 2a ractice, zero.**
1de80 20 6f 72 20 6e 65 67 61 74 69 76 65 20 72 6f 77 or negative row
1de90 69 64 73 20 61 72 65 20 76 65 72 79 20 75 6e 63 ids are very unc
1dea0 6f 6d 6d 6f 6e 20 73 6f 20 74 68 69 73 20 73 68 ommon so this sh
1deb0 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 20 70 72 ould not be a pr
1dec0 6f 62 6c 65 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 oblem..*/.void s
1ded0 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 qlite3BtreeSetCa
1dee0 63 68 65 64 52 6f 77 69 64 28 42 74 43 75 72 73 chedRowid(BtCurs
1def0 6f 72 20 2a 70 43 75 72 2c 20 73 71 6c 69 74 65 or *pCur, sqlite
1df00 33 5f 69 6e 74 36 34 20 69 52 6f 77 69 64 29 7b 3_int64 iRowid){
1df10 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a . BtCursor *p;.
1df20 20 20 66 6f 72 28 70 3d 70 43 75 72 2d 3e 70 42 for(p=pCur->pB
1df30 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 t->pCursor; p; p
1df40 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 =p->pNext){.
1df50 69 66 28 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d if( p->pgnoRoot=
1df60 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 =pCur->pgnoRoot
1df70 29 20 70 2d 3e 63 61 63 68 65 64 52 6f 77 69 64 ) p->cachedRowid
1df80 20 3d 20 69 52 6f 77 69 64 3b 0a 20 20 7d 0a 20 = iRowid;. }.
1df90 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 63 assert( pCur->c
1dfa0 61 63 68 65 64 52 6f 77 69 64 3d 3d 69 52 6f 77 achedRowid==iRow
1dfb0 69 64 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 id );.}../*.** R
1dfc0 65 74 75 72 6e 20 74 68 65 20 63 61 63 68 65 64 eturn the cached
1dfd0 20 72 6f 77 69 64 20 66 6f 72 20 74 68 65 20 67 rowid for the g
1dfe0 69 76 65 6e 20 63 75 72 73 6f 72 2e 20 20 41 20 iven cursor. A
1dff0 6e 65 67 61 74 69 76 65 20 6f 72 20 7a 65 72 6f negative or zero
1e000 0a 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c 75 65 .** return value
1e010 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 indicates that
1e020 74 68 65 20 72 6f 77 69 64 20 63 61 63 68 65 20 the rowid cache
1e030 69 73 20 69 6e 76 61 6c 69 64 20 61 6e 64 20 73 is invalid and s
1e040 68 6f 75 6c 64 20 62 65 0a 2a 2a 20 69 67 6e 6f hould be.** igno
1e050 72 65 64 2e 20 20 49 66 20 74 68 65 20 72 6f 77 red. If the row
1e060 69 64 20 63 61 63 68 65 20 68 61 73 20 6e 65 76 id cache has nev
1e070 65 72 20 62 65 66 6f 72 65 20 62 65 65 6e 20 73 er before been s
1e080 65 74 2c 20 74 68 65 6e 20 61 0a 2a 2a 20 7a 65 et, then a.** ze
1e090 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a ro is returned..
1e0a0 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 */.sqlite3_int64
1e0b0 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
1e0c0 43 61 63 68 65 64 52 6f 77 69 64 28 42 74 43 75 CachedRowid(BtCu
1e0d0 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 rsor *pCur){. r
1e0e0 65 74 75 72 6e 20 70 43 75 72 2d 3e 63 61 63 68 eturn pCur->cach
1e0f0 65 64 52 6f 77 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a edRowid;.}../*.*
1e100 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 * Close a cursor
1e110 2e 20 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b . The read lock
1e120 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
1e130 20 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 file is release
1e140 64 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 d.** when the la
1e150 73 74 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f st cursor is clo
1e160 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 sed..*/.int sqli
1e170 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 te3BtreeCloseCur
1e180 73 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 sor(BtCursor *pC
1e190 75 72 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 ur){. Btree *pB
1e1a0 74 72 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 tree = pCur->pBt
1e1b0 72 65 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 ree;. if( pBtre
1e1c0 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a e ){. int i;.
1e1d0 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
1e1e0 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 t = pCur->pBt;.
1e1f0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 sqlite3BtreeE
1e200 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
1e210 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
1e220 65 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b earCursor(pCur);
1e230 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 70 . if( pCur->p
1e240 50 72 65 76 20 29 7b 0a 20 20 20 20 20 20 70 43 Prev ){. pC
1e250 75 72 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 ur->pPrev->pNext
1e260 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a = pCur->pNext;.
1e270 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
1e280 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 3d 20 pBt->pCursor =
1e290 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 pCur->pNext;.
1e2a0 20 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d }. if( pCur-
1e2b0 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 >pNext ){.
1e2c0 70 43 75 72 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 pCur->pNext->pPr
1e2d0 65 76 20 3d 20 70 43 75 72 2d 3e 70 50 72 65 76 ev = pCur->pPrev
1e2e0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 ;. }. for(
1e2f0 69 3d 30 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 i=0; i<=pCur->iP
1e300 61 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 age; i++){.
1e310 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 releasePage(pCu
1e320 72 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 r->apPage[i]);.
1e330 20 20 20 7d 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 }. unlockB
1e340 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 treeIfUnused(pBt
1e350 29 3b 0a 20 20 20 20 69 6e 76 61 6c 69 64 61 74 );. invalidat
1e360 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 eOverflowCache(p
1e370 43 75 72 29 3b 0a 20 20 20 20 2f 2a 20 73 71 6c Cur);. /* sql
1e380 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 29 3b ite3_free(pCur);
1e390 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 42 */. sqlite3B
1e3a0 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 treeLeave(pBtree
1e3b0 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
1e3c0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1e3d0 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 .** Make sure th
1e3e0 65 20 42 74 43 75 72 73 6f 72 2a 20 67 69 76 65 e BtCursor* give
1e3f0 6e 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e n in the argumen
1e400 74 20 68 61 73 20 61 20 76 61 6c 69 64 0a 2a 2a t has a valid.**
1e410 20 42 74 43 75 72 73 6f 72 2e 69 6e 66 6f 20 73 BtCursor.info s
1e420 74 72 75 63 74 75 72 65 2e 20 20 49 66 20 69 74 tructure. If it
1e430 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
1e440 76 61 6c 69 64 2c 20 63 61 6c 6c 0a 2a 2a 20 62 valid, call.** b
1e450 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 29 20 treeParseCell()
1e460 74 6f 20 66 69 6c 6c 20 69 74 20 69 6e 2e 0a 2a to fill it in..*
1e470 2a 0a 2a 2a 20 42 74 43 75 72 73 6f 72 2e 69 6e *.** BtCursor.in
1e480 66 6f 20 69 73 20 61 20 63 61 63 68 65 20 6f 66 fo is a cache of
1e490 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e the information
1e4a0 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 in the current
1e4b0 63 65 6c 6c 2e 0a 2a 2a 20 55 73 69 6e 67 20 74 cell..** Using t
1e4c0 68 69 73 20 63 61 63 68 65 20 72 65 64 75 63 65 his cache reduce
1e4d0 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
1e4e0 63 61 6c 6c 73 20 74 6f 20 62 74 72 65 65 50 61 calls to btreePa
1e4f0 72 73 65 43 65 6c 6c 28 29 2e 0a 2a 2a 0a 2a 2a rseCell()..**.**
1e500 20 32 30 30 37 2d 30 36 2d 32 35 3a 20 20 54 68 2007-06-25: Th
1e510 65 72 65 20 69 73 20 61 20 62 75 67 20 69 6e 20 ere is a bug in
1e520 73 6f 6d 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 some versions of
1e530 20 4d 53 56 43 20 74 68 61 74 20 63 61 75 73 65 MSVC that cause
1e540 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 the.** compiler
1e550 20 74 6f 20 63 72 61 73 68 20 77 68 65 6e 20 67 to crash when g
1e560 65 74 43 65 6c 6c 49 6e 66 6f 28 29 20 69 73 20 etCellInfo() is
1e570 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 implemented as a
1e580 20 6d 61 63 72 6f 2e 0a 2a 2a 20 42 75 74 20 74 macro..** But t
1e590 68 65 72 65 20 69 73 20 61 20 6d 65 61 73 75 72 here is a measur
1e5a0 65 61 62 6c 65 20 73 70 65 65 64 20 61 64 76 61 eable speed adva
1e5b0 6e 74 61 67 65 20 74 6f 20 75 73 69 6e 67 20 74 ntage to using t
1e5c0 68 65 20 6d 61 63 72 6f 20 6f 6e 20 67 63 63 0a he macro on gcc.
1e5d0 2a 2a 20 28 77 68 65 6e 20 6c 65 73 73 20 63 6f ** (when less co
1e5e0 6d 70 69 6c 65 72 20 6f 70 74 69 6d 69 7a 61 74 mpiler optimizat
1e5f0 69 6f 6e 73 20 6c 69 6b 65 20 2d 4f 73 20 6f 72 ions like -Os or
1e600 20 2d 4f 30 20 61 72 65 20 75 73 65 64 20 61 6e -O0 are used an
1e610 64 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 69 6c 65 d the.** compile
1e620 72 20 69 73 20 6e 6f 74 20 64 6f 69 6e 67 20 61 r is not doing a
1e630 67 72 65 73 73 69 76 65 20 69 6e 6c 69 6e 69 6e gressive inlinin
1e640 67 2e 29 20 20 53 6f 20 77 65 20 75 73 65 20 61 g.) So we use a
1e650 20 72 65 61 6c 20 66 75 6e 63 74 69 6f 6e 0a 2a real function.*
1e660 2a 20 66 6f 72 20 4d 53 56 43 20 61 6e 64 20 61 * for MSVC and a
1e670 20 6d 61 63 72 6f 20 66 6f 72 20 65 76 65 72 79 macro for every
1e680 74 68 69 6e 67 20 65 6c 73 65 2e 20 20 54 69 63 thing else. Tic
1e690 6b 65 74 20 23 32 34 35 37 2e 0a 2a 2f 0a 23 69 ket #2457..*/.#i
1e6a0 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 73 fndef NDEBUG. s
1e6b0 74 61 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 tatic void asser
1e6c0 74 43 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 tCellInfo(BtCurs
1e6d0 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 20 20 43 or *pCur){. C
1e6e0 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 ellInfo info;.
1e6f0 20 20 69 6e 74 20 69 50 61 67 65 20 3d 20 70 43 int iPage = pC
1e700 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 20 20 6d ur->iPage;. m
1e710 65 6d 73 65 74 28 26 69 6e 66 6f 2c 20 30 2c 20 emset(&info, 0,
1e720 73 69 7a 65 6f 66 28 69 6e 66 6f 29 29 3b 0a 20 sizeof(info));.
1e730 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c btreeParseCel
1e740 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 l(pCur->apPage[i
1e750 50 61 67 65 5d 2c 20 70 43 75 72 2d 3e 61 69 49 Page], pCur->aiI
1e760 64 78 5b 69 50 61 67 65 5d 2c 20 26 69 6e 66 6f dx[iPage], &info
1e770 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6d );. assert( m
1e780 65 6d 63 6d 70 28 26 69 6e 66 6f 2c 20 26 70 43 emcmp(&info, &pC
1e790 75 72 2d 3e 69 6e 66 6f 2c 20 73 69 7a 65 6f 66 ur->info, sizeof
1e7a0 28 69 6e 66 6f 29 29 3d 3d 30 20 29 3b 0a 20 20 (info))==0 );.
1e7b0 7d 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e }.#else. #defin
1e7c0 65 20 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f e assertCellInfo
1e7d0 28 78 29 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 (x).#endif.#ifde
1e7e0 66 20 5f 4d 53 43 5f 56 45 52 0a 20 20 2f 2a 20 f _MSC_VER. /*
1e7f0 55 73 65 20 61 20 72 65 61 6c 20 66 75 6e 63 74 Use a real funct
1e800 69 6f 6e 20 69 6e 20 4d 53 56 43 20 74 6f 20 77 ion in MSVC to w
1e810 6f 72 6b 20 61 72 6f 75 6e 64 20 62 75 67 73 20 ork around bugs
1e820 69 6e 20 74 68 61 74 20 63 6f 6d 70 69 6c 65 72 in that compiler
1e830 2e 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 76 6f . */. static vo
1e840 69 64 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 42 id getCellInfo(B
1e850 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
1e860 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e if( pCur->in
1e870 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 0a 20 fo.nSize==0 ){.
1e880 20 20 20 20 20 69 6e 74 20 69 50 61 67 65 20 3d int iPage =
1e890 20 70 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 pCur->iPage;.
1e8a0 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
1e8b0 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b ll(pCur->apPage[
1e8c0 69 50 61 67 65 5d 2c 70 43 75 72 2d 3e 61 69 49 iPage],pCur->aiI
1e8d0 64 78 5b 69 50 61 67 65 5d 2c 26 70 43 75 72 2d dx[iPage],&pCur-
1e8e0 3e 69 6e 66 6f 29 3b 0a 20 20 20 20 20 20 70 43 >info);. pC
1e8f0 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 ur->validNKey =
1e900 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 1;. }else{.
1e910 20 20 20 20 61 73 73 65 72 74 43 65 6c 6c 49 6e assertCellIn
1e920 66 6f 28 70 43 75 72 29 3b 0a 20 20 20 20 7d 0a fo(pCur);. }.
1e930 20 20 7d 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 }.#else /* if
1e940 6e 6f 74 20 5f 4d 53 43 5f 56 45 52 20 2a 2f 0a not _MSC_VER */.
1e950 20 20 2f 2a 20 55 73 65 20 61 20 6d 61 63 72 6f /* Use a macro
1e960 20 69 6e 20 61 6c 6c 20 6f 74 68 65 72 20 63 6f in all other co
1e970 6d 70 69 6c 65 72 73 20 73 6f 20 74 68 61 74 20 mpilers so that
1e980 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 the function is
1e990 69 6e 6c 69 6e 65 64 20 2a 2f 0a 23 64 65 66 69 inlined */.#defi
1e9a0 6e 65 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 ne getCellInfo(p
1e9b0 43 75 72 29 20 20 20 20 20 20 20 20 20 20 20 20 Cur)
1e9c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e9d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e9e0 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 69 66 \. if
1e9f0 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 ( pCur->info.nSi
1ea00 7a 65 3d 3d 30 20 29 7b 20 20 20 20 20 20 20 20 ze==0 ){
1ea10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea30 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
1ea40 20 69 6e 74 20 69 50 61 67 65 20 3d 20 70 43 75 int iPage = pCu
1ea50 72 2d 3e 69 50 61 67 65 3b 20 20 20 20 20 20 20 r->iPage;
1ea60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea80 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 \.
1ea90 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c btreeParseCell
1eaa0 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 (pCur->apPage[iP
1eab0 61 67 65 5d 2c 70 43 75 72 2d 3e 61 69 49 64 78 age],pCur->aiIdx
1eac0 5b 69 50 61 67 65 5d 2c 26 70 43 75 72 2d 3e 69 [iPage],&pCur->i
1ead0 6e 66 6f 29 3b 20 5c 0a 20 20 20 20 70 43 75 72 nfo); \. pCur
1eae0 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 31 3b ->validNKey = 1;
1eaf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb20 20 20 20 20 20 20 20 5c 0a 20 20 7d 65 6c 73 65 \. }else
1eb30 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
1eb40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb70 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20 61 73 \. as
1eb80 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 sertCellInfo(pCu
1eb90 72 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 r);
1eba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ebb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ebc0 20 20 20 20 20 20 20 20 20 5c 0a 20 20 7d 0a 23 \. }.#
1ebd0 65 6e 64 69 66 20 2f 2a 20 5f 4d 53 43 5f 56 45 endif /* _MSC_VE
1ebe0 52 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 4e 44 R */..#ifndef ND
1ebf0 45 42 55 47 20 20 2f 2a 20 54 68 65 20 6e 65 78 EBUG /* The nex
1ec00 74 20 72 6f 75 74 69 6e 65 20 75 73 65 64 20 6f t routine used o
1ec10 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 73 65 72 nly within asser
1ec20 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 2a t() statements *
1ec30 2f 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 /./*.** Return t
1ec40 72 75 65 20 69 66 20 74 68 65 20 67 69 76 65 6e rue if the given
1ec50 20 42 74 43 75 72 73 6f 72 20 69 73 20 76 61 6c BtCursor is val
1ec60 69 64 2e 20 20 41 20 76 61 6c 69 64 20 63 75 72 id. A valid cur
1ec70 73 6f 72 20 69 73 20 6f 6e 65 0a 2a 2a 20 74 68 sor is one.** th
1ec80 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 at is currently
1ec90 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 72 6f pointing to a ro
1eca0 77 20 69 6e 20 61 20 28 6e 6f 6e 2d 65 6d 70 74 w in a (non-empt
1ecb0 79 29 20 74 61 62 6c 65 2e 0a 2a 2a 20 54 68 69 y) table..** Thi
1ecc0 73 20 69 73 20 61 20 76 65 72 69 66 69 63 61 74 s is a verificat
1ecd0 69 6f 6e 20 72 6f 75 74 69 6e 65 20 69 73 20 75 ion routine is u
1ece0 73 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 sed only within
1ecf0 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
1ed00 6e 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 nts..*/.int sqli
1ed10 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 49 73 te3BtreeCursorIs
1ed20 56 61 6c 69 64 28 42 74 43 75 72 73 6f 72 20 2a Valid(BtCursor *
1ed30 70 43 75 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 pCur){. return
1ed40 70 43 75 72 20 26 26 20 70 43 75 72 2d 3e 65 53 pCur && pCur->eS
1ed50 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
1ed60 49 44 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 ID;.}.#endif /*
1ed70 4e 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a NDEBUG */../*.**
1ed80 20 53 65 74 20 2a 70 53 69 7a 65 20 74 6f 20 74 Set *pSize to t
1ed90 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 he size of the b
1eda0 75 66 66 65 72 20 6e 65 65 64 65 64 20 74 6f 20 uffer needed to
1edb0 68 6f 6c 64 20 74 68 65 20 76 61 6c 75 65 20 6f hold the value o
1edc0 66 0a 2a 2a 20 74 68 65 20 6b 65 79 20 66 6f 72 f.** the key for
1edd0 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e 74 the current ent
1ede0 72 79 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 ry. If the curs
1edf0 6f 72 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 69 or is not pointi
1ee00 6e 67 0a 2a 2a 20 74 6f 20 61 20 76 61 6c 69 64 ng.** to a valid
1ee10 20 65 6e 74 72 79 2c 20 2a 70 53 69 7a 65 20 69 entry, *pSize i
1ee20 73 20 73 65 74 20 74 6f 20 30 2e 20 0a 2a 2a 0a s set to 0. .**.
1ee30 2a 2a 20 46 6f 72 20 61 20 74 61 62 6c 65 20 77 ** For a table w
1ee40 69 74 68 20 74 68 65 20 49 4e 54 4b 45 59 20 66 ith the INTKEY f
1ee50 6c 61 67 20 73 65 74 2c 20 74 68 69 73 20 72 6f lag set, this ro
1ee60 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 utine returns th
1ee70 65 20 6b 65 79 0a 2a 2a 20 69 74 73 65 6c 66 2c e key.** itself,
1ee80 20 6e 6f 74 20 74 68 65 20 6e 75 6d 62 65 72 20 not the number
1ee90 6f 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 of bytes in the
1eea0 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 key..**.** The c
1eeb0 61 6c 6c 65 72 20 6d 75 73 74 20 70 6f 73 69 74 aller must posit
1eec0 69 6f 6e 20 74 68 65 20 63 75 72 73 6f 72 20 70 ion the cursor p
1eed0 72 69 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 rior to invoking
1eee0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a this routine..*
1eef0 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 * .** This routi
1ef00 6e 65 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 20 ne cannot fail.
1ef10 20 49 74 20 61 6c 77 61 79 73 20 72 65 74 75 72 It always retur
1ef20 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 20 0a ns SQLITE_OK. .
1ef30 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1ef40 72 65 65 4b 65 79 53 69 7a 65 28 42 74 43 75 72 reeKeySize(BtCur
1ef50 73 6f 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a sor *pCur, i64 *
1ef60 70 53 69 7a 65 29 7b 0a 20 20 61 73 73 65 72 74 pSize){. assert
1ef70 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
1ef80 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
1ef90 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
1efa0 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c te==CURSOR_INVAL
1efb0 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 ID || pCur->eSta
1efc0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
1efd0 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e );. if( pCur->
1efe0 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
1eff0 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a 70 53 69 ALID ){. *pSi
1f000 7a 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b ze = 0;. }else{
1f010 0a 20 20 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f . getCellInfo
1f020 28 70 43 75 72 29 3b 0a 20 20 20 20 2a 70 53 69 (pCur);. *pSi
1f030 7a 65 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ze = pCur->info.
1f040 6e 4b 65 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75 nKey;. }. retu
1f050 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
1f060 0a 2f 2a 0a 2a 2a 20 53 65 74 20 2a 70 53 69 7a ./*.** Set *pSiz
1f070 65 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 e to the number
1f080 6f 66 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 of bytes of data
1f090 20 69 6e 20 74 68 65 20 65 6e 74 72 79 20 74 68 in the entry th
1f0a0 65 0a 2a 2a 20 63 75 72 73 6f 72 20 63 75 72 72 e.** cursor curr
1f0b0 65 6e 74 6c 79 20 70 6f 69 6e 74 73 20 74 6f 2e ently points to.
1f0c0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 .**.** The calle
1f0d0 72 20 6d 75 73 74 20 67 75 61 72 61 6e 74 65 65 r must guarantee
1f0e0 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 that the cursor
1f0f0 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 is pointing to
1f100 61 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 a non-NULL.** va
1f110 6c 69 64 20 65 6e 74 72 79 2e 20 20 49 6e 20 6f lid entry. In o
1f120 74 68 65 72 20 77 6f 72 64 73 2c 20 74 68 65 20 ther words, the
1f130 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 calling procedur
1f140 65 20 6d 75 73 74 20 67 75 61 72 61 6e 74 65 65 e must guarantee
1f150 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 63 75 72 .** that the cur
1f160 73 6f 72 20 68 61 73 20 43 75 72 73 6f 72 2e 65 sor has Cursor.e
1f170 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
1f180 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 46 61 69 6c 75 LID..**.** Failu
1f190 72 65 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 re is not possib
1f1a0 6c 65 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 le. This functi
1f1b0 6f 6e 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e on always return
1f1c0 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 s SQLITE_OK..**
1f1d0 49 74 20 6d 69 67 68 74 20 6a 75 73 74 20 61 73 It might just as
1f1e0 20 77 65 6c 6c 20 62 65 20 61 20 70 72 6f 63 65 well be a proce
1f1f0 64 75 72 65 20 28 72 65 74 75 72 6e 69 6e 67 20 dure (returning
1f200 76 6f 69 64 29 20 62 75 74 20 77 65 20 63 6f 6e void) but we con
1f210 74 69 6e 75 65 0a 2a 2a 20 74 6f 20 72 65 74 75 tinue.** to retu
1f220 72 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 72 65 rn an integer re
1f230 73 75 6c 74 20 63 6f 64 65 20 66 6f 72 20 68 69 sult code for hi
1f240 73 74 6f 72 69 63 61 6c 20 72 65 61 73 6f 6e 73 storical reasons
1f250 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1f260 42 74 72 65 65 44 61 74 61 53 69 7a 65 28 42 74 BtreeDataSize(Bt
1f270 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 Cursor *pCur, u3
1f280 32 20 2a 70 53 69 7a 65 29 7b 0a 20 20 61 73 73 2 *pSize){. ass
1f290 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
1f2a0 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 Mutex(pCur) );.
1f2b0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
1f2c0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
1f2d0 4c 49 44 20 29 3b 0a 20 20 67 65 74 43 65 6c 6c LID );. getCell
1f2e0 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 2a 70 Info(pCur);. *p
1f2f0 53 69 7a 65 20 3d 20 70 43 75 72 2d 3e 69 6e 66 Size = pCur->inf
1f300 6f 2e 6e 44 61 74 61 3b 0a 20 20 72 65 74 75 72 o.nData;. retur
1f310 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1f320 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 68 65 20 /*.** Given the
1f330 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 page number of a
1f340 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 n overflow page
1f350 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
1f360 28 70 61 72 61 6d 65 74 65 72 0a 2a 2a 20 6f 76 (parameter.** ov
1f370 66 6c 29 2c 20 74 68 69 73 20 66 75 6e 63 74 69 fl), this functi
1f380 6f 6e 20 66 69 6e 64 73 20 74 68 65 20 70 61 67 on finds the pag
1f390 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
1f3a0 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 next page in the
1f3b0 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 6c 69 73 74 .** linked list
1f3c0 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 of overflow pag
1f3d0 65 73 2e 20 49 66 20 70 6f 73 73 69 62 6c 65 2c es. If possible,
1f3e0 20 69 74 20 75 73 65 73 20 74 68 65 20 61 75 74 it uses the aut
1f3f0 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 70 6f 69 6e o-vacuum.** poin
1f400 74 65 72 2d 6d 61 70 20 64 61 74 61 20 69 6e 73 ter-map data ins
1f410 74 65 61 64 20 6f 66 20 72 65 61 64 69 6e 67 20 tead of reading
1f420 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 70 the content of p
1f430 61 67 65 20 6f 76 66 6c 20 74 6f 20 64 6f 20 73 age ovfl to do s
1f440 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 o. .**.** If an
1f450 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 6e 20 error occurs an
1f460 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
1f470 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f e is returned. O
1f480 74 68 65 72 77 69 73 65 3a 0a 2a 2a 0a 2a 2a 20 therwise:.**.**
1f490 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 The page number
1f4a0 6f 66 20 74 68 65 20 6e 65 78 74 20 6f 76 65 72 of the next over
1f4b0 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 68 65 flow page in the
1f4c0 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 69 73 20 linked list is
1f4d0 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 6f 20 2a .** written to *
1f4e0 70 50 67 6e 6f 4e 65 78 74 2e 20 49 66 20 70 61 pPgnoNext. If pa
1f4f0 67 65 20 6f 76 66 6c 20 69 73 20 74 68 65 20 6c ge ovfl is the l
1f500 61 73 74 20 70 61 67 65 20 69 6e 20 69 74 73 20 ast page in its
1f510 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c 69 73 74 2c linked .** list,
1f520 20 2a 70 50 67 6e 6f 4e 65 78 74 20 69 73 20 73 *pPgnoNext is s
1f530 65 74 20 74 6f 20 7a 65 72 6f 2e 20 0a 2a 2a 0a et to zero. .**.
1f540 2a 2a 20 49 66 20 70 70 50 61 67 65 20 69 73 20 ** If ppPage is
1f550 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e 64 20 61 20 not NULL, and a
1f560 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 reference to the
1f570 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 63 74 20 MemPage object
1f580 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 2a 2a corresponding.**
1f590 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 to page number
1f5a0 70 4f 76 66 6c 20 77 61 73 20 6f 62 74 61 69 6e pOvfl was obtain
1f5b0 65 64 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 65 ed, then *ppPage
1f5c0 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 is set to point
1f5d0 20 74 6f 20 74 68 61 74 0a 2a 2a 20 72 65 66 65 to that.** refe
1f5e0 72 65 6e 63 65 2e 20 49 74 20 69 73 20 74 68 65 rence. It is the
1f5f0 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 responsibility
1f600 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f of the caller to
1f610 20 63 61 6c 6c 20 72 65 6c 65 61 73 65 50 61 67 call releasePag
1f620 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 70 50 61 67 e().** on *ppPag
1f630 65 20 74 6f 20 66 72 65 65 20 74 68 65 20 72 65 e to free the re
1f640 66 65 72 65 6e 63 65 2e 20 49 6e 20 6e 6f 20 72 ference. In no r
1f650 65 66 65 72 65 6e 63 65 20 77 61 73 20 6f 62 74 eference was obt
1f660 61 69 6e 65 64 20 28 62 65 63 61 75 73 65 0a 2a ained (because.*
1f670 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 * the pointer-ma
1f680 70 20 77 61 73 20 75 73 65 64 20 74 6f 20 6f 62 p was used to ob
1f690 74 61 69 6e 20 74 68 65 20 76 61 6c 75 65 20 66 tain the value f
1f6a0 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 74 29 2c 20 or *pPgnoNext),
1f6b0 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 61 67 65 20 then.** *ppPage
1f6c0 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 0a is set to zero..
1f6d0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 65 */.static int ge
1f6e0 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 0a 20 tOverflowPage(.
1f6f0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 BtShared *pBt,
1f700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f710 20 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 The database fi
1f720 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6f 76 66 le */. Pgno ovf
1f730 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
1f740 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 /* Current
1f750 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 overflow page nu
1f760 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 mber */. MemPag
1f770 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 e **ppPage,
1f780 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4d /* OUT: M
1f790 65 6d 50 61 67 65 20 68 61 6e 64 6c 65 20 28 6d emPage handle (m
1f7a0 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 ay be NULL) */.
1f7b0 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 Pgno *pPgnoNext
1f7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f7d0 20 4f 55 54 3a 20 4e 65 78 74 20 6f 76 65 72 66 OUT: Next overf
1f7e0 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 65 72 20 low page number
1f7f0 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f 20 6e 65 78 */.){. Pgno nex
1f800 74 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 t = 0;. MemPage
1f810 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 69 *pPage = 0;. i
1f820 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1f830 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 K;.. assert( sq
1f840 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
1f850 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
1f860 20 20 61 73 73 65 72 74 28 70 50 67 6e 6f 4e 65 assert(pPgnoNe
1f870 78 74 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 xt);..#ifndef SQ
1f880 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
1f890 43 55 55 4d 0a 20 20 2f 2a 20 54 72 79 20 74 6f CUUM. /* Try to
1f8a0 20 66 69 6e 64 20 74 68 65 20 6e 65 78 74 20 70 find the next p
1f8b0 61 67 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 age in the overf
1f8c0 6c 6f 77 20 6c 69 73 74 20 75 73 69 6e 67 20 74 low list using t
1f8d0 68 65 0a 20 20 2a 2a 20 61 75 74 6f 76 61 63 75 he. ** autovacu
1f8e0 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 um pointer-map p
1f8f0 61 67 65 73 2e 20 47 75 65 73 73 20 74 68 61 74 ages. Guess that
1f900 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 the next page i
1f910 6e 20 0a 20 20 2a 2a 20 74 68 65 20 6f 76 65 72 n . ** the over
1f920 66 6c 6f 77 20 6c 69 73 74 20 69 73 20 70 61 67 flow list is pag
1f930 65 20 6e 75 6d 62 65 72 20 28 6f 76 66 6c 2b 31 e number (ovfl+1
1f940 29 2e 20 49 66 20 74 68 61 74 20 67 75 65 73 73 ). If that guess
1f950 20 74 75 72 6e 73 20 0a 20 20 2a 2a 20 6f 75 74 turns . ** out
1f960 20 74 6f 20 62 65 20 77 72 6f 6e 67 2c 20 66 61 to be wrong, fa
1f970 6c 6c 20 62 61 63 6b 20 74 6f 20 6c 6f 61 64 69 ll back to loadi
1f980 6e 67 20 74 68 65 20 64 61 74 61 20 6f 66 20 70 ng the data of p
1f990 61 67 65 20 0a 20 20 2a 2a 20 6e 75 6d 62 65 72 age . ** number
1f9a0 20 6f 76 66 6c 20 74 6f 20 64 65 74 65 72 6d 69 ovfl to determi
1f9b0 6e 65 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 ne the next page
1f9c0 20 6e 75 6d 62 65 72 2e 0a 20 20 2a 2f 0a 20 20 number.. */.
1f9d0 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 if( pBt->autoVac
1f9e0 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 uum ){. Pgno
1f9f0 70 67 6e 6f 3b 0a 20 20 20 20 50 67 6e 6f 20 69 pgno;. Pgno i
1fa00 47 75 65 73 73 20 3d 20 6f 76 66 6c 2b 31 3b 0a Guess = ovfl+1;.
1fa10 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a 0a 20 u8 eType;..
1fa20 20 20 20 77 68 69 6c 65 28 20 50 54 52 4d 41 50 while( PTRMAP
1fa30 5f 49 53 50 41 47 45 28 70 42 74 2c 20 69 47 75 _ISPAGE(pBt, iGu
1fa40 65 73 73 29 20 7c 7c 20 69 47 75 65 73 73 3d 3d ess) || iGuess==
1fa50 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
1fa60 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 E(pBt) ){.
1fa70 69 47 75 65 73 73 2b 2b 3b 0a 20 20 20 20 7d 0a iGuess++;. }.
1fa80 0a 20 20 20 20 69 66 28 20 69 47 75 65 73 73 3c . if( iGuess<
1fa90 3d 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 =btreePagecount(
1faa0 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63 pBt) ){. rc
1fab0 20 3d 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 = ptrmapGet(pBt
1fac0 2c 20 69 47 75 65 73 73 2c 20 26 65 54 79 70 65 , iGuess, &eType
1fad0 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 , &pgno);.
1fae0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1faf0 4b 20 26 26 20 65 54 79 70 65 3d 3d 50 54 52 4d K && eType==PTRM
1fb00 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 26 26 20 AP_OVERFLOW2 &&
1fb10 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 7b 0a 20 20 pgno==ovfl ){.
1fb20 20 20 20 20 20 20 6e 65 78 74 20 3d 20 69 47 75 next = iGu
1fb30 65 73 73 3b 0a 20 20 20 20 20 20 20 20 72 63 20 ess;. rc
1fb40 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 = SQLITE_DONE;.
1fb50 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
1fb60 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
1fb70 74 28 20 6e 65 78 74 3d 3d 30 20 7c 7c 20 72 63 t( next==0 || rc
1fb80 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 3b ==SQLITE_DONE );
1fb90 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
1fba0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d E_OK ){. rc =
1fbb0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
1fbc0 74 2c 20 6f 76 66 6c 2c 20 26 70 50 61 67 65 2c t, ovfl, &pPage,
1fbd0 20 30 2c 20 28 70 70 50 61 67 65 3d 3d 30 29 29 0, (ppPage==0))
1fbe0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 ;. assert( rc
1fbf0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 ==SQLITE_OK || p
1fc00 50 61 67 65 3d 3d 30 20 29 3b 0a 20 20 20 20 69 Page==0 );. i
1fc10 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1fc20 20 29 7b 0a 20 20 20 20 20 20 6e 65 78 74 20 3d ){. next =
1fc30 20 67 65 74 34 62 79 74 65 28 70 50 61 67 65 2d get4byte(pPage-
1fc40 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 >aData);. }.
1fc50 20 7d 0a 0a 20 20 2a 70 50 67 6e 6f 4e 65 78 74 }.. *pPgnoNext
1fc60 20 3d 20 6e 65 78 74 3b 0a 20 20 69 66 28 20 70 = next;. if( p
1fc70 70 50 61 67 65 20 29 7b 0a 20 20 20 20 2a 70 70 pPage ){. *pp
1fc80 50 61 67 65 20 3d 20 70 50 61 67 65 3b 0a 20 20 Page = pPage;.
1fc90 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 6c 65 61 }else{. relea
1fca0 73 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 sePage(pPage);.
1fcb0 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d }. return (rc=
1fcc0 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 3f 20 53 =SQLITE_DONE ? S
1fcd0 51 4c 49 54 45 5f 4f 4b 20 3a 20 72 63 29 3b 0a QLITE_OK : rc);.
1fce0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 70 79 20 64 61 }../*.** Copy da
1fcf0 74 61 20 66 72 6f 6d 20 61 20 62 75 66 66 65 72 ta from a buffer
1fd00 20 74 6f 20 61 20 70 61 67 65 2c 20 6f 72 20 66 to a page, or f
1fd10 72 6f 6d 20 61 20 70 61 67 65 20 74 6f 20 61 20 rom a page to a
1fd20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 70 50 buffer..**.** pP
1fd30 61 79 6c 6f 61 64 20 69 73 20 61 20 70 6f 69 6e ayload is a poin
1fd40 74 65 72 20 74 6f 20 64 61 74 61 20 73 74 6f 72 ter to data stor
1fd50 65 64 20 6f 6e 20 64 61 74 61 62 61 73 65 20 70 ed on database p
1fd60 61 67 65 20 70 44 62 50 61 67 65 2e 0a 2a 2a 20 age pDbPage..**
1fd70 49 66 20 61 72 67 75 6d 65 6e 74 20 65 4f 70 20 If argument eOp
1fd80 69 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 6e is false, then n
1fd90 42 79 74 65 20 62 79 74 65 73 20 6f 66 20 64 61 Byte bytes of da
1fda0 74 61 20 61 72 65 20 63 6f 70 69 65 64 0a 2a 2a ta are copied.**
1fdb0 20 66 72 6f 6d 20 70 50 61 79 6c 6f 61 64 20 74 from pPayload t
1fdc0 6f 20 74 68 65 20 62 75 66 66 65 72 20 70 6f 69 o the buffer poi
1fdd0 6e 74 65 64 20 61 74 20 62 79 20 70 42 75 66 2e nted at by pBuf.
1fde0 20 49 66 20 65 4f 70 20 69 73 20 74 72 75 65 2c If eOp is true,
1fdf0 0a 2a 2a 20 74 68 65 6e 20 73 71 6c 69 74 65 33 .** then sqlite3
1fe00 50 61 67 65 72 57 72 69 74 65 28 29 20 69 73 20 PagerWrite() is
1fe10 63 61 6c 6c 65 64 20 6f 6e 20 70 44 62 50 61 67 called on pDbPag
1fe20 65 20 61 6e 64 20 6e 42 79 74 65 20 62 79 74 65 e and nByte byte
1fe30 73 0a 2a 2a 20 6f 66 20 64 61 74 61 20 61 72 65 s.** of data are
1fe40 20 63 6f 70 69 65 64 20 66 72 6f 6d 20 74 68 65 copied from the
1fe50 20 62 75 66 66 65 72 20 70 42 75 66 20 74 6f 20 buffer pBuf to
1fe60 70 50 61 79 6c 6f 61 64 2e 0a 2a 2a 0a 2a 2a 20 pPayload..**.**
1fe70 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
1fe80 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 73 urned on success
1fe90 2c 20 6f 74 68 65 72 77 69 73 65 20 61 6e 20 65 , otherwise an e
1fea0 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 rror code..*/.st
1feb0 61 74 69 63 20 69 6e 74 20 63 6f 70 79 50 61 79 atic int copyPay
1fec0 6c 6f 61 64 28 0a 20 20 76 6f 69 64 20 2a 70 50 load(. void *pP
1fed0 61 79 6c 6f 61 64 2c 20 20 20 20 20 20 20 20 20 ayload,
1fee0 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
1fef0 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 20 76 page data */. v
1ff00 6f 69 64 20 2a 70 42 75 66 2c 20 20 20 20 20 20 oid *pBuf,
1ff10 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
1ff20 74 65 72 20 74 6f 20 62 75 66 66 65 72 20 2a 2f ter to buffer */
1ff30 0a 20 20 69 6e 74 20 6e 42 79 74 65 2c 20 20 20 . int nByte,
1ff40 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ff50 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
1ff60 74 6f 20 63 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 to copy */. int
1ff70 20 65 4f 70 2c 20 20 20 20 20 20 20 20 20 20 20 eOp,
1ff80 20 20 20 20 20 20 20 2f 2a 20 30 20 2d 3e 20 63 /* 0 -> c
1ff90 6f 70 79 20 66 72 6f 6d 20 70 61 67 65 2c 20 31 opy from page, 1
1ffa0 20 2d 3e 20 63 6f 70 79 20 74 6f 20 70 61 67 65 -> copy to page
1ffb0 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 70 44 */. DbPage *pD
1ffc0 62 50 61 67 65 20 20 20 20 20 20 20 20 20 20 20 bPage
1ffd0 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 /* Page containi
1ffe0 6e 67 20 70 50 61 79 6c 6f 61 64 20 2a 2f 0a 29 ng pPayload */.)
1fff0 7b 0a 20 20 69 66 28 20 65 4f 70 20 29 7b 0a 20 {. if( eOp ){.
20000 20 20 20 2f 2a 20 43 6f 70 79 20 64 61 74 61 20 /* Copy data
20010 66 72 6f 6d 20 62 75 66 66 65 72 20 74 6f 20 70 from buffer to p
20020 61 67 65 20 28 61 20 77 72 69 74 65 20 6f 70 65 age (a write ope
20030 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 69 ration) */. i
20040 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 nt rc = sqlite3P
20050 61 67 65 72 57 72 69 74 65 28 70 44 62 50 61 67 agerWrite(pDbPag
20060 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
20070 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
20080 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
20090 20 20 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 }. memcpy(p
200a0 50 61 79 6c 6f 61 64 2c 20 70 42 75 66 2c 20 6e Payload, pBuf, n
200b0 42 79 74 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a Byte);. }else{.
200c0 20 20 20 20 2f 2a 20 43 6f 70 79 20 64 61 74 61 /* Copy data
200d0 20 66 72 6f 6d 20 70 61 67 65 20 74 6f 20 62 75 from page to bu
200e0 66 66 65 72 20 28 61 20 72 65 61 64 20 6f 70 65 ffer (a read ope
200f0 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 6d ration) */. m
20100 65 6d 63 70 79 28 70 42 75 66 2c 20 70 50 61 79 emcpy(pBuf, pPay
20110 6c 6f 61 64 2c 20 6e 42 79 74 65 29 3b 0a 20 20 load, nByte);.
20120 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
20130 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 E_OK;.}../*.** T
20140 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
20150 75 73 65 64 20 74 6f 20 72 65 61 64 20 6f 72 20 used to read or
20160 6f 76 65 72 77 72 69 74 65 20 70 61 79 6c 6f 61 overwrite payloa
20170 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a d information.**
20180 20 66 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 for the entry t
20190 68 61 74 20 74 68 65 20 70 43 75 72 20 63 75 72 hat the pCur cur
201a0 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 sor is pointing
201b0 74 6f 2e 20 49 66 20 74 68 65 20 65 4f 70 0a 2a to. If the eOp.*
201c0 2a 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 30 * parameter is 0
201d0 2c 20 74 68 69 73 20 69 73 20 61 20 72 65 61 64 , this is a read
201e0 20 6f 70 65 72 61 74 69 6f 6e 20 28 64 61 74 61 operation (data
201f0 20 63 6f 70 69 65 64 20 69 6e 74 6f 0a 2a 2a 20 copied into.**
20200 62 75 66 66 65 72 20 70 42 75 66 29 2e 20 49 66 buffer pBuf). If
20210 20 69 74 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c it is non-zero,
20220 20 61 20 77 72 69 74 65 20 28 64 61 74 61 20 63 a write (data c
20230 6f 70 69 65 64 20 66 72 6f 6d 0a 2a 2a 20 62 75 opied from.** bu
20240 66 66 65 72 20 70 42 75 66 29 2e 0a 2a 2a 0a 2a ffer pBuf)..**.*
20250 2a 20 41 20 74 6f 74 61 6c 20 6f 66 20 22 61 6d * A total of "am
20260 74 22 20 62 79 74 65 73 20 61 72 65 20 72 65 61 t" bytes are rea
20270 64 20 6f 72 20 77 72 69 74 74 65 6e 20 62 65 67 d or written beg
20280 69 6e 6e 69 6e 67 20 61 74 20 22 6f 66 66 73 65 inning at "offse
20290 74 22 2e 0a 2a 2a 20 44 61 74 61 20 69 73 20 72 t"..** Data is r
202a0 65 61 64 20 74 6f 20 6f 72 20 66 72 6f 6d 20 74 ead to or from t
202b0 68 65 20 62 75 66 66 65 72 20 70 42 75 66 2e 0a he buffer pBuf..
202c0 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6e 74 65 6e **.** The conten
202d0 74 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 20 t being read or
202e0 77 72 69 74 74 65 6e 20 6d 69 67 68 74 20 61 70 written might ap
202f0 70 65 61 72 20 6f 6e 20 74 68 65 20 6d 61 69 6e pear on the main
20300 20 70 61 67 65 0a 2a 2a 20 6f 72 20 62 65 20 73 page.** or be s
20310 63 61 74 74 65 72 65 64 20 6f 75 74 20 6f 6e 20 cattered out on
20320 6d 75 6c 74 69 70 6c 65 20 6f 76 65 72 66 6c 6f multiple overflo
20330 77 20 70 61 67 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 w pages..**.** I
20340 66 20 74 68 65 20 42 74 43 75 72 73 6f 72 2e 69 f the BtCursor.i
20350 73 49 6e 63 72 62 6c 6f 62 48 61 6e 64 6c 65 20 sIncrblobHandle
20360 66 6c 61 67 20 69 73 20 73 65 74 2c 20 61 6e 64 flag is set, and
20370 20 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 the current.**
20380 63 75 72 73 6f 72 20 65 6e 74 72 79 20 75 73 65 cursor entry use
20390 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 s one or more ov
203a0 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 74 68 erflow pages, th
203b0 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 61 is function.** a
203c0 6c 6c 6f 63 61 74 65 73 20 73 70 61 63 65 20 66 llocates space f
203d0 6f 72 20 61 6e 64 20 6c 61 7a 69 6c 79 20 70 6f or and lazily po
203e0 70 6c 75 61 74 65 73 20 74 68 65 20 6f 76 65 72 pluates the over
203f0 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 0a flow page-list .
20400 2a 2a 20 63 61 63 68 65 20 61 72 72 61 79 20 28 ** cache array (
20410 42 74 43 75 72 73 6f 72 2e 61 4f 76 65 72 66 6c BtCursor.aOverfl
20420 6f 77 29 2e 20 53 75 62 73 65 71 75 65 6e 74 20 ow). Subsequent
20430 63 61 6c 6c 73 20 75 73 65 20 74 68 69 73 0a 2a calls use this.*
20440 2a 20 63 61 63 68 65 20 74 6f 20 6d 61 6b 65 20 * cache to make
20450 73 65 65 6b 69 6e 67 20 74 6f 20 74 68 65 20 73 seeking to the s
20460 75 70 70 6c 69 65 64 20 6f 66 66 73 65 74 20 6d upplied offset m
20470 6f 72 65 20 65 66 66 69 63 69 65 6e 74 2e 0a 2a ore efficient..*
20480 2a 0a 2a 2a 20 4f 6e 63 65 20 61 6e 20 6f 76 65 *.** Once an ove
20490 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 rflow page-list
204a0 63 61 63 68 65 20 68 61 73 20 62 65 65 6e 20 61 cache has been a
204b0 6c 6c 6f 63 61 74 65 64 2c 20 69 74 20 6d 61 79 llocated, it may
204c0 20 62 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 61 74 be.** invalidat
204d0 65 64 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 ed if some other
204e0 20 63 75 72 73 6f 72 20 77 72 69 74 65 73 20 74 cursor writes t
204f0 6f 20 74 68 65 20 73 61 6d 65 20 74 61 62 6c 65 o the same table
20500 2c 20 6f 72 20 69 66 0a 2a 2a 20 74 68 65 20 63 , or if.** the c
20510 75 72 73 6f 72 20 69 73 20 6d 6f 76 65 64 20 74 ursor is moved t
20520 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 72 6f o a different ro
20530 77 2e 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c w. Additionally,
20540 20 69 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a in auto-vacuum.
20550 2a 2a 20 6d 6f 64 65 2c 20 74 68 65 20 66 6f 6c ** mode, the fol
20560 6c 6f 77 69 6e 67 20 65 76 65 6e 74 73 20 6d 61 lowing events ma
20570 79 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 20 y invalidate an
20580 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 overflow page-li
20590 73 74 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 st cache..**.**
205a0 20 20 2a 20 41 6e 20 69 6e 63 72 65 6d 65 6e 74 * An increment
205b0 61 6c 20 76 61 63 75 75 6d 2c 0a 2a 2a 20 20 20 al vacuum,.**
205c0 2a 20 41 20 63 6f 6d 6d 69 74 20 69 6e 20 61 75 * A commit in au
205d0 74 6f 5f 76 61 63 75 75 6d 3d 22 66 75 6c 6c 22 to_vacuum="full"
205e0 20 6d 6f 64 65 2c 0a 2a 2a 20 20 20 2a 20 43 72 mode,.** * Cr
205f0 65 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 28 eating a table (
20600 6d 61 79 20 72 65 71 75 69 72 65 20 6d 6f 76 69 may require movi
20610 6e 67 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 ng an overflow p
20620 61 67 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 age)..*/.static
20630 69 6e 74 20 61 63 63 65 73 73 50 61 79 6c 6f 61 int accessPayloa
20640 64 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 d(. BtCursor *p
20650 43 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 Cur, /* Cur
20660 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 sor pointing to
20670 65 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 entry to read fr
20680 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 6f 66 66 73 om */. u32 offs
20690 65 74 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 et, /*
206a0 42 65 67 69 6e 20 72 65 61 64 69 6e 67 20 74 68 Begin reading th
206b0 69 73 20 66 61 72 20 69 6e 74 6f 20 70 61 79 6c is far into payl
206c0 6f 61 64 20 2a 2f 0a 20 20 75 33 32 20 61 6d 74 oad */. u32 amt
206d0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a , /*
206e0 20 52 65 61 64 20 74 68 69 73 20 6d 61 6e 79 20 Read this many
206f0 62 79 74 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 bytes */. unsig
20700 6e 65 64 20 63 68 61 72 20 2a 70 42 75 66 2c 20 ned char *pBuf,
20710 2f 2a 20 57 72 69 74 65 20 74 68 65 20 62 79 74 /* Write the byt
20720 65 73 20 69 6e 74 6f 20 74 68 69 73 20 62 75 66 es into this buf
20730 66 65 72 20 2a 2f 20 0a 20 20 69 6e 74 20 65 4f fer */ . int eO
20740 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f p /
20750 2a 20 7a 65 72 6f 20 74 6f 20 72 65 61 64 2e 20 * zero to read.
20760 6e 6f 6e 2d 7a 65 72 6f 20 74 6f 20 77 72 69 74 non-zero to writ
20770 65 2e 20 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 e. */.){. unsig
20780 6e 65 64 20 63 68 61 72 20 2a 61 50 61 79 6c 6f ned char *aPaylo
20790 61 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 ad;. int rc = S
207a0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 33 32 20 QLITE_OK;. u32
207b0 6e 4b 65 79 3b 0a 20 20 69 6e 74 20 69 49 64 78 nKey;. int iIdx
207c0 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 = 0;. MemPage
207d0 2a 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 *pPage = pCur->a
207e0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
207f0 65 5d 3b 20 2f 2a 20 42 74 72 65 65 20 70 61 67 e]; /* Btree pag
20800 65 20 6f 66 20 63 75 72 72 65 6e 74 20 65 6e 74 e of current ent
20810 72 79 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 ry */. BtShared
20820 20 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 *pBt = pCur->pB
20830 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
20840 20 20 20 20 2f 2a 20 42 74 72 65 65 20 74 68 69 /* Btree thi
20850 73 20 63 75 72 73 6f 72 20 62 65 6c 6f 6e 67 73 s cursor belongs
20860 20 74 6f 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 to */.. assert
20870 28 20 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 ( pPage );. ass
20880 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
20890 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
208a0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
208b0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
208c0 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e 6e 43 65 Page]<pPage->nCe
208d0 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ll );. assert(
208e0 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
208f0 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 67 65 74 (pCur) );.. get
20900 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a CellInfo(pCur);.
20910 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 70 43 75 aPayload = pCu
20920 72 2d 3e 69 6e 66 6f 2e 70 43 65 6c 6c 20 2b 20 r->info.pCell +
20930 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 48 65 61 64 pCur->info.nHead
20940 65 72 3b 0a 20 20 6e 4b 65 79 20 3d 20 28 70 50 er;. nKey = (pP
20950 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3f 20 30 20 age->intKey ? 0
20960 3a 20 28 69 6e 74 29 70 43 75 72 2d 3e 69 6e 66 : (int)pCur->inf
20970 6f 2e 6e 4b 65 79 29 3b 0a 0a 20 20 69 66 28 20 o.nKey);.. if(
20980 4e 45 56 45 52 28 6f 66 66 73 65 74 2b 61 6d 74 NEVER(offset+amt
20990 20 3e 20 6e 4b 65 79 2b 70 43 75 72 2d 3e 69 6e > nKey+pCur->in
209a0 66 6f 2e 6e 44 61 74 61 29 20 0a 20 20 20 7c 7c fo.nData) . ||
209b0 20 26 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d &aPayload[pCur-
209c0 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 >info.nLocal] >
209d0 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
209e0 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 5d 0a 20 t->usableSize].
209f0 20 29 7b 0a 20 20 20 20 2f 2a 20 54 72 79 69 6e ){. /* Tryin
20a00 67 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72 69 g to read or wri
20a10 74 65 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 te past the end
20a20 6f 66 20 74 68 65 20 64 61 74 61 20 69 73 20 61 of the data is a
20a30 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 20 20 72 n error */. r
20a40 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
20a50 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a RUPT_BKPT;. }..
20a60 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 64 61 /* Check if da
20a70 74 61 20 6d 75 73 74 20 62 65 20 72 65 61 64 2f ta must be read/
20a80 77 72 69 74 74 65 6e 20 74 6f 2f 66 72 6f 6d 20 written to/from
20a90 74 68 65 20 62 74 72 65 65 20 70 61 67 65 20 69 the btree page i
20aa0 74 73 65 6c 66 2e 20 2a 2f 0a 20 20 69 66 28 20 tself. */. if(
20ab0 6f 66 66 73 65 74 3c 70 43 75 72 2d 3e 69 6e 66 offset<pCur->inf
20ac0 6f 2e 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 o.nLocal ){.
20ad0 69 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 int a = amt;.
20ae0 20 69 66 28 20 61 2b 6f 66 66 73 65 74 3e 70 43 if( a+offset>pC
20af0 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 ur->info.nLocal
20b00 29 7b 0a 20 20 20 20 20 20 61 20 3d 20 70 43 75 ){. a = pCu
20b10 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d r->info.nLocal -
20b20 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 7d 0a 20 offset;. }.
20b30 20 20 20 72 63 20 3d 20 63 6f 70 79 50 61 79 6c rc = copyPayl
20b40 6f 61 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 oad(&aPayload[of
20b50 66 73 65 74 5d 2c 20 70 42 75 66 2c 20 61 2c 20 fset], pBuf, a,
20b60 65 4f 70 2c 20 70 50 61 67 65 2d 3e 70 44 62 50 eOp, pPage->pDbP
20b70 61 67 65 29 3b 0a 20 20 20 20 6f 66 66 73 65 74 age);. offset
20b80 20 3d 20 30 3b 0a 20 20 20 20 70 42 75 66 20 2b = 0;. pBuf +
20b90 3d 20 61 3b 0a 20 20 20 20 61 6d 74 20 2d 3d 20 = a;. amt -=
20ba0 61 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 a;. }else{.
20bb0 6f 66 66 73 65 74 20 2d 3d 20 70 43 75 72 2d 3e offset -= pCur->
20bc0 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 7d info.nLocal;. }
20bd0 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 .. if( rc==SQLI
20be0 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 TE_OK && amt>0 )
20bf0 7b 0a 20 20 20 20 63 6f 6e 73 74 20 75 33 32 20 {. const u32
20c00 6f 76 66 6c 53 69 7a 65 20 3d 20 70 42 74 2d 3e ovflSize = pBt->
20c10 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 20 usableSize - 4;
20c20 20 2f 2a 20 42 79 74 65 73 20 63 6f 6e 74 65 6e /* Bytes conten
20c30 74 20 70 65 72 20 6f 76 66 6c 20 70 61 67 65 20 t per ovfl page
20c40 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 */. Pgno next
20c50 50 61 67 65 3b 0a 0a 20 20 20 20 6e 65 78 74 50 Page;.. nextP
20c60 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 age = get4byte(&
20c70 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d 3e 69 aPayload[pCur->i
20c80 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 29 3b 0a 0a 23 nfo.nLocal]);..#
20c90 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
20ca0 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 20 20 IT_INCRBLOB.
20cb0 2f 2a 20 49 66 20 74 68 65 20 69 73 49 6e 63 72 /* If the isIncr
20cc0 62 6c 6f 62 48 61 6e 64 6c 65 20 66 6c 61 67 20 blobHandle flag
20cd0 69 73 20 73 65 74 20 61 6e 64 20 74 68 65 20 42 is set and the B
20ce0 74 43 75 72 73 6f 72 2e 61 4f 76 65 72 66 6c 6f tCursor.aOverflo
20cf0 77 5b 5d 0a 20 20 20 20 2a 2a 20 68 61 73 20 6e w[]. ** has n
20d00 6f 74 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 ot been allocate
20d10 64 2c 20 61 6c 6c 6f 63 61 74 65 20 69 74 20 6e d, allocate it n
20d20 6f 77 2e 20 54 68 65 20 61 72 72 61 79 20 69 73 ow. The array is
20d30 20 73 69 7a 65 64 20 61 74 0a 20 20 20 20 2a 2a sized at. **
20d40 20 6f 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 one entry for e
20d50 61 63 68 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ach overflow pag
20d60 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f e in the overflo
20d70 77 20 63 68 61 69 6e 2e 20 54 68 65 0a 20 20 20 w chain. The.
20d80 20 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 72 20 ** page number
20d90 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 of the first ove
20da0 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 73 74 rflow page is st
20db0 6f 72 65 64 20 69 6e 20 61 4f 76 65 72 66 6c 6f ored in aOverflo
20dc0 77 5b 30 5d 2c 0a 20 20 20 20 2a 2a 20 65 74 63 w[0],. ** etc
20dd0 2e 20 41 20 76 61 6c 75 65 20 6f 66 20 30 20 69 . A value of 0 i
20de0 6e 20 74 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b n the aOverflow[
20df0 5d 20 61 72 72 61 79 20 6d 65 61 6e 73 20 22 6e ] array means "n
20e00 6f 74 20 79 65 74 20 6b 6e 6f 77 6e 22 0a 20 20 ot yet known".
20e10 20 20 2a 2a 20 28 74 68 65 20 63 61 63 68 65 20 ** (the cache
20e20 69 73 20 6c 61 7a 69 6c 79 20 70 6f 70 75 6c 61 is lazily popula
20e30 74 65 64 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ted).. */.
20e40 20 69 66 28 20 70 43 75 72 2d 3e 69 73 49 6e 63 if( pCur->isInc
20e50 72 62 6c 6f 62 48 61 6e 64 6c 65 20 26 26 20 21 rblobHandle && !
20e60 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 pCur->aOverflow
20e70 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f 76 ){. int nOv
20e80 66 6c 20 3d 20 28 70 43 75 72 2d 3e 69 6e 66 6f fl = (pCur->info
20e90 2e 6e 50 61 79 6c 6f 61 64 2d 70 43 75 72 2d 3e .nPayload-pCur->
20ea0 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 2b 6f 76 66 6c info.nLocal+ovfl
20eb0 53 69 7a 65 2d 31 29 2f 6f 76 66 6c 53 69 7a 65 Size-1)/ovflSize
20ec0 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 61 4f ;. pCur->aO
20ed0 76 65 72 66 6c 6f 77 20 3d 20 28 50 67 6e 6f 20 verflow = (Pgno
20ee0 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a *)sqlite3MallocZ
20ef0 65 72 6f 28 73 69 7a 65 6f 66 28 50 67 6e 6f 29 ero(sizeof(Pgno)
20f00 2a 6e 4f 76 66 6c 29 3b 0a 20 20 20 20 20 20 2f *nOvfl);. /
20f10 2a 20 6e 4f 76 66 6c 20 69 73 20 61 6c 77 61 79 * nOvfl is alway
20f20 73 20 70 6f 73 69 74 69 76 65 2e 20 20 49 66 20 s positive. If
20f30 69 74 20 77 65 72 65 20 7a 65 72 6f 2c 20 66 65 it were zero, fe
20f40 74 63 68 50 61 79 6c 6f 61 64 20 77 6f 75 6c 64 tchPayload would
20f50 20 68 61 76 65 0a 20 20 20 20 20 20 2a 2a 20 62 have. ** b
20f60 65 65 6e 20 75 73 65 64 20 69 6e 73 74 65 61 64 een used instead
20f70 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 of this routine
20f80 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 41 . */. if( A
20f90 4c 57 41 59 53 28 6e 4f 76 66 6c 29 20 26 26 20 LWAYS(nOvfl) &&
20fa0 21 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 !pCur->aOverflow
20fb0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
20fc0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
20fd0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 }. }..
20fe0 20 20 2f 2a 20 49 66 20 74 68 65 20 6f 76 65 72 /* If the over
20ff0 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 flow page-list c
21000 61 63 68 65 20 68 61 73 20 62 65 65 6e 20 61 6c ache has been al
21010 6c 6f 63 61 74 65 64 20 61 6e 64 20 74 68 65 0a located and the.
21020 20 20 20 20 2a 2a 20 65 6e 74 72 79 20 66 6f 72 ** entry for
21030 20 74 68 65 20 66 69 72 73 74 20 72 65 71 75 69 the first requi
21040 72 65 64 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 red overflow pag
21050 65 20 69 73 20 76 61 6c 69 64 2c 20 73 6b 69 70 e is valid, skip
21060 0a 20 20 20 20 2a 2a 20 64 69 72 65 63 74 6c 79 . ** directly
21070 20 74 6f 20 69 74 2e 0a 20 20 20 20 2a 2f 0a 20 to it.. */.
21080 20 20 20 69 66 28 20 70 43 75 72 2d 3e 61 4f 76 if( pCur->aOv
21090 65 72 66 6c 6f 77 20 26 26 20 70 43 75 72 2d 3e erflow && pCur->
210a0 61 4f 76 65 72 66 6c 6f 77 5b 6f 66 66 73 65 74 aOverflow[offset
210b0 2f 6f 76 66 6c 53 69 7a 65 5d 20 29 7b 0a 20 20 /ovflSize] ){.
210c0 20 20 20 20 69 49 64 78 20 3d 20 28 6f 66 66 73 iIdx = (offs
210d0 65 74 2f 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 et/ovflSize);.
210e0 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 70 nextPage = p
210f0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 Cur->aOverflow[i
21100 49 64 78 5d 3b 0a 20 20 20 20 20 20 6f 66 66 73 Idx];. offs
21110 65 74 20 3d 20 28 6f 66 66 73 65 74 25 6f 76 66 et = (offset%ovf
21120 6c 53 69 7a 65 29 3b 0a 20 20 20 20 7d 0a 23 65 lSize);. }.#e
21130 6e 64 69 66 0a 0a 20 20 20 20 66 6f 72 28 20 3b ndif.. for( ;
21140 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
21150 26 20 61 6d 74 3e 30 20 26 26 20 6e 65 78 74 50 & amt>0 && nextP
21160 61 67 65 3b 20 69 49 64 78 2b 2b 29 7b 0a 0a 23 age; iIdx++){..#
21170 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
21180 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 20 20 IT_INCRBLOB.
21190 20 20 2f 2a 20 49 66 20 72 65 71 75 69 72 65 64 /* If required
211a0 2c 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20 6f , populate the o
211b0 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 verflow page-lis
211c0 74 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20 20 20 t cache. */.
211d0 20 20 69 66 28 20 70 43 75 72 2d 3e 61 4f 76 65 if( pCur->aOve
211e0 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 rflow ){.
211f0 20 61 73 73 65 72 74 28 21 70 43 75 72 2d 3e 61 assert(!pCur->a
21200 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 20 7c Overflow[iIdx] |
21210 7c 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f | pCur->aOverflo
21220 77 5b 69 49 64 78 5d 3d 3d 6e 65 78 74 50 61 67 w[iIdx]==nextPag
21230 65 29 3b 0a 20 20 20 20 20 20 20 20 70 43 75 72 e);. pCur
21240 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 ->aOverflow[iIdx
21250 5d 20 3d 20 6e 65 78 74 50 61 67 65 3b 0a 20 20 ] = nextPage;.
21260 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }.#endif..
21270 20 20 20 20 69 66 28 20 6f 66 66 73 65 74 3e 3d if( offset>=
21280 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 ovflSize ){.
21290 20 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c 79 20 /* The only
212a0 72 65 61 73 6f 6e 20 74 6f 20 72 65 61 64 20 74 reason to read t
212b0 68 69 73 20 70 61 67 65 20 69 73 20 74 6f 20 6f his page is to o
212c0 62 74 61 69 6e 20 74 68 65 20 70 61 67 65 0a 20 btain the page.
212d0 20 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 ** number
212e0 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 70 61 for the next pa
212f0 67 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c ge in the overfl
21300 6f 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 ow chain. The pa
21310 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 61 ge. ** da
21320 74 61 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 ta is not requir
21330 65 64 2e 20 53 6f 20 66 69 72 73 74 20 74 72 79 ed. So first try
21340 20 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 6f to lookup the o
21350 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 verflow.
21360 2a 2a 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ** page-list cac
21370 68 65 2c 20 69 66 20 61 6e 79 2c 20 74 68 65 6e he, if any, then
21380 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74 68 fall back to th
21390 65 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 e getOverflowPag
213a0 65 28 29 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 e(). ** f
213b0 75 6e 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 unction..
213c0 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */.#ifndef SQLI
213d0 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 TE_OMIT_INCRBLOB
213e0 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 43 75 . if( pCu
213f0 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 26 26 20 r->aOverflow &&
21400 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
21410 69 49 64 78 2b 31 5d 20 29 7b 0a 20 20 20 20 20 iIdx+1] ){.
21420 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
21430 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
21440 69 49 64 78 2b 31 5d 3b 0a 20 20 20 20 20 20 20 iIdx+1];.
21450 20 7d 20 65 6c 73 65 20 0a 23 65 6e 64 69 66 0a } else .#endif.
21460 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 67 rc = g
21470 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 70 etOverflowPage(p
21480 42 74 2c 20 6e 65 78 74 50 61 67 65 2c 20 30 2c Bt, nextPage, 0,
21490 20 26 6e 65 78 74 50 61 67 65 29 3b 0a 20 20 20 &nextPage);.
214a0 20 20 20 20 20 6f 66 66 73 65 74 20 2d 3d 20 6f offset -= o
214b0 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 20 7d vflSize;. }
214c0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a else{. /*
214d0 20 4e 65 65 64 20 74 6f 20 72 65 61 64 20 74 68 Need to read th
214e0 69 73 20 70 61 67 65 20 70 72 6f 70 65 72 6c 79 is page properly
214f0 2e 20 49 74 20 63 6f 6e 74 61 69 6e 73 20 73 6f . It contains so
21500 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 me of the.
21510 20 20 2a 2a 20 72 61 6e 67 65 20 6f 66 20 64 61 ** range of da
21520 74 61 20 74 68 61 74 20 69 73 20 62 65 69 6e 67 ta that is being
21530 20 72 65 61 64 20 28 65 4f 70 3d 3d 30 29 20 6f read (eOp==0) o
21540 72 20 77 72 69 74 74 65 6e 20 28 65 4f 70 21 3d r written (eOp!=
21550 30 29 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 23 0).. */.#
21560 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 ifdef SQLITE_DIR
21570 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 ECT_OVERFLOW_REA
21580 44 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 D. sqlite
21590 33 5f 66 69 6c 65 20 2a 66 64 3b 0a 23 65 6e 64 3_file *fd;.#end
215a0 69 66 0a 20 20 20 20 20 20 20 20 69 6e 74 20 61 if. int a
215b0 20 3d 20 61 6d 74 3b 0a 20 20 20 20 20 20 20 20 = amt;.
215c0 69 66 28 20 61 20 2b 20 6f 66 66 73 65 74 20 3e if( a + offset >
215d0 20 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 ovflSize ){.
215e0 20 20 20 20 20 20 20 61 20 3d 20 6f 76 66 6c 53 a = ovflS
215f0 69 7a 65 20 2d 20 6f 66 66 73 65 74 3b 0a 20 20 ize - offset;.
21600 20 20 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 }..#ifdef
21610 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 SQLITE_DIRECT_OV
21620 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 20 20 ERFLOW_READ.
21630 20 20 20 20 2f 2a 20 49 66 20 61 6c 6c 20 74 68 /* If all th
21640 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
21650 74 72 75 65 3a 0a 20 20 20 20 20 20 20 20 2a 2a true:. **
21660 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 31 29 . ** 1)
21670 20 74 68 69 73 20 69 73 20 61 20 72 65 61 64 20 this is a read
21680 6f 70 65 72 61 74 69 6f 6e 2c 20 61 6e 64 20 0a operation, and .
21690 20 20 20 20 20 20 20 20 2a 2a 20 20 20 32 29 20 ** 2)
216a0 64 61 74 61 20 69 73 20 72 65 71 75 69 72 65 64 data is required
216b0 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 74 20 from the start
216c0 6f 66 20 74 68 69 73 20 6f 76 65 72 66 6c 6f 77 of this overflow
216d0 20 70 61 67 65 2c 20 61 6e 64 0a 20 20 20 20 20 page, and.
216e0 20 20 20 2a 2a 20 20 20 33 29 20 74 68 65 20 64 ** 3) the d
216f0 61 74 61 62 61 73 65 20 69 73 20 66 69 6c 65 2d atabase is file-
21700 62 61 63 6b 65 64 2c 20 61 6e 64 0a 20 20 20 20 backed, and.
21710 20 20 20 20 2a 2a 20 20 20 34 29 20 74 68 65 72 ** 4) ther
21720 65 20 69 73 20 6e 6f 20 6f 70 65 6e 20 77 72 69 e is no open wri
21730 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 te-transaction,
21740 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 and. **
21750 20 35 29 20 74 68 65 20 64 61 74 61 62 61 73 65 5) the database
21760 20 69 73 20 6e 6f 74 20 61 20 57 41 4c 20 64 61 is not a WAL da
21770 74 61 62 61 73 65 2c 0a 20 20 20 20 20 20 20 20 tabase,.
21780 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 **. ** th
21790 65 6e 20 64 61 74 61 20 63 61 6e 20 62 65 20 72 en data can be r
217a0 65 61 64 20 64 69 72 65 63 74 6c 79 20 66 72 6f ead directly fro
217b0 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 m the database f
217c0 69 6c 65 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 ile into the.
217d0 20 20 20 20 20 2a 2a 20 6f 75 74 70 75 74 20 62 ** output b
217e0 75 66 66 65 72 2c 20 62 79 70 61 73 73 69 6e 67 uffer, bypassing
217f0 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 the page-cache
21800 61 6c 74 6f 67 65 74 68 65 72 2e 20 54 68 69 73 altogether. This
21810 20 73 70 65 65 64 73 0a 20 20 20 20 20 20 20 20 speeds.
21820 2a 2a 20 75 70 20 6c 6f 61 64 69 6e 67 20 6c 61 ** up loading la
21830 72 67 65 20 72 65 63 6f 72 64 73 20 74 68 61 74 rge records that
21840 20 73 70 61 6e 20 6d 61 6e 79 20 6f 76 65 72 66 span many overf
21850 6c 6f 77 20 70 61 67 65 73 2e 0a 20 20 20 20 20 low pages..
21860 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 */. if
21870 28 20 65 4f 70 3d 3d 30 20 20 20 20 20 20 20 20 ( eOp==0
21880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
218a0 20 20 20 20 20 2f 2a 20 28 31 29 20 2a 2f 0a 20 /* (1) */.
218b0 20 20 20 20 20 20 20 20 26 26 20 6f 66 66 73 65 && offse
218c0 74 3d 3d 30 20 20 20 20 20 20 20 20 20 20 20 20 t==0
218d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
218e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
218f0 20 28 32 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 (2) */.
21900 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 && pBt->inTrans
21910 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 52 45 action==TRANS_RE
21920 41 44 20 20 20 20 20 20 20 20 20 20 20 20 20 20 AD
21930 20 20 20 20 20 20 20 2f 2a 20 28 34 29 20 2a 2f /* (4) */
21940 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 66 64 . && (fd
21950 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 = sqlite3PagerF
21960 69 6c 65 28 70 42 74 2d 3e 70 50 61 67 65 72 29 ile(pBt->pPager)
21970 29 2d 3e 70 4d 65 74 68 6f 64 73 20 20 20 20 20 )->pMethods
21980 2f 2a 20 28 33 29 20 2a 2f 0a 20 20 20 20 20 20 /* (3) */.
21990 20 20 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 && pBt->pPage
219a0 31 2d 3e 61 44 61 74 61 5b 31 39 5d 3d 3d 30 78 1->aData[19]==0x
219b0 30 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 01
219c0 20 20 20 20 20 20 20 20 20 2f 2a 20 28 35 29 20 /* (5)
219d0 2a 2f 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 */. ){.
219e0 20 20 20 20 20 20 20 20 75 38 20 61 53 61 76 65 u8 aSave
219f0 5b 34 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 75 [4];. u
21a00 38 20 2a 61 57 72 69 74 65 20 3d 20 26 70 42 75 8 *aWrite = &pBu
21a10 66 5b 2d 34 5d 3b 0a 20 20 20 20 20 20 20 20 20 f[-4];.
21a20 20 6d 65 6d 63 70 79 28 61 53 61 76 65 2c 20 61 memcpy(aSave, a
21a30 57 72 69 74 65 2c 20 34 29 3b 0a 20 20 20 20 20 Write, 4);.
21a40 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
21a50 33 4f 73 52 65 61 64 28 66 64 2c 20 61 57 72 69 3OsRead(fd, aWri
21a60 74 65 2c 20 61 2b 34 2c 20 28 69 36 34 29 70 42 te, a+4, (i64)pB
21a70 74 2d 3e 70 61 67 65 53 69 7a 65 2a 28 6e 65 78 t->pageSize*(nex
21a80 74 50 61 67 65 2d 31 29 29 3b 0a 20 20 20 20 20 tPage-1));.
21a90 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
21aa0 67 65 74 34 62 79 74 65 28 61 57 72 69 74 65 29 get4byte(aWrite)
21ab0 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 ;. memc
21ac0 70 79 28 61 57 72 69 74 65 2c 20 61 53 61 76 65 py(aWrite, aSave
21ad0 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 , 4);. }e
21ae0 6c 73 65 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 lse.#endif..
21af0 20 20 20 20 7b 0a 20 20 20 20 20 20 20 20 20 20 {.
21b00 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b DbPage *pDbPage;
21b10 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
21b20 73 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 75 sqlite3PagerAcqu
21b30 69 72 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ire(pBt->pPager,
21b40 20 6e 65 78 74 50 61 67 65 2c 20 26 70 44 62 50 nextPage, &pDbP
21b50 61 67 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 age,.
21b60 20 20 20 28 65 4f 70 3d 3d 30 20 3f 20 50 41 47 (eOp==0 ? PAG
21b70 45 52 5f 41 43 51 55 49 52 45 5f 52 45 41 44 4f ER_ACQUIRE_READO
21b80 4e 4c 59 20 3a 20 30 29 0a 20 20 20 20 20 20 20 NLY : 0).
21b90 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 );.
21ba0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
21bb0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 K ){.
21bc0 20 61 50 61 79 6c 6f 61 64 20 3d 20 73 71 6c 69 aPayload = sqli
21bd0 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 te3PagerGetData(
21be0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
21bf0 20 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d nextPage =
21c00 20 67 65 74 34 62 79 74 65 28 61 50 61 79 6c 6f get4byte(aPaylo
21c10 61 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ad);.
21c20 20 72 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 rc = copyPayloa
21c30 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 d(&aPayload[offs
21c40 65 74 2b 34 5d 2c 20 70 42 75 66 2c 20 61 2c 20 et+4], pBuf, a,
21c50 65 4f 70 2c 20 70 44 62 50 61 67 65 29 3b 0a 20 eOp, pDbPage);.
21c60 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
21c70 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
21c80 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
21c90 20 20 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 offset = 0;.
21ca0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
21cb0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 6d 74 }. amt
21cc0 20 2d 3d 20 61 3b 0a 20 20 20 20 20 20 20 20 70 -= a;. p
21cd0 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 20 20 Buf += a;.
21ce0 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 }. }. }.. i
21cf0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
21d00 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 && amt>0 ){.
21d10 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
21d20 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d ORRUPT_BKPT;. }
21d30 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
21d40 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 61 72 74 ./*.** Read part
21d50 20 6f 66 20 74 68 65 20 6b 65 79 20 61 73 73 6f of the key asso
21d60 63 69 61 74 65 64 20 77 69 74 68 20 63 75 72 73 ciated with curs
21d70 6f 72 20 70 43 75 72 2e 20 20 45 78 61 63 74 6c or pCur. Exactl
21d80 79 0a 2a 2a 20 22 61 6d 74 22 20 62 79 74 65 73 y.** "amt" bytes
21d90 20 77 69 6c 6c 20 62 65 20 74 72 61 6e 73 66 65 will be transfe
21da0 72 65 64 20 69 6e 74 6f 20 70 42 75 66 5b 5d 2e red into pBuf[].
21db0 20 20 54 68 65 20 74 72 61 6e 73 66 65 72 0a 2a The transfer.*
21dc0 2a 20 62 65 67 69 6e 73 20 61 74 20 22 6f 66 66 * begins at "off
21dd0 73 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 set"..**.** The
21de0 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 6e 73 75 caller must ensu
21df0 72 65 20 74 68 61 74 20 70 43 75 72 20 69 73 20 re that pCur is
21e00 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 76 61 pointing to a va
21e10 6c 69 64 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68 lid row.** in th
21e20 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 52 e table..**.** R
21e30 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
21e40 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 61 6e on success or an
21e50 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61 error code if a
21e60 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 nything goes.**
21e70 77 72 6f 6e 67 2e 20 20 41 6e 20 65 72 72 6f 72 wrong. An error
21e80 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
21e90 22 6f 66 66 73 65 74 2b 61 6d 74 22 20 69 73 20 "offset+amt" is
21ea0 6c 61 72 67 65 72 20 74 68 61 6e 0a 2a 2a 20 74 larger than.** t
21eb0 68 65 20 61 76 61 69 6c 61 62 6c 65 20 70 61 79 he available pay
21ec0 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c load..*/.int sql
21ed0 69 74 65 33 42 74 72 65 65 4b 65 79 28 42 74 43 ite3BtreeKey(BtC
21ee0 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 ursor *pCur, u32
21ef0 20 6f 66 66 73 65 74 2c 20 75 33 32 20 61 6d 74 offset, u32 amt
21f00 2c 20 76 6f 69 64 20 2a 70 42 75 66 29 7b 0a 20 , void *pBuf){.
21f10 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
21f20 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
21f30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
21f40 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
21f50 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
21f60 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 ert( pCur->iPage
21f70 3e 3d 30 20 26 26 20 70 43 75 72 2d 3e 61 70 50 >=0 && pCur->apP
21f80 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
21f90 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
21fa0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
21fb0 69 50 61 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 iPage]<pCur->apP
21fc0 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
21fd0 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 72 65 74 ->nCell );. ret
21fe0 75 72 6e 20 61 63 63 65 73 73 50 61 79 6c 6f 61 urn accessPayloa
21ff0 64 28 70 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 d(pCur, offset,
22000 61 6d 74 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 amt, (unsigned c
22010 68 61 72 2a 29 70 42 75 66 2c 20 30 29 3b 0a 7d har*)pBuf, 0);.}
22020 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 61 72 ../*.** Read par
22030 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 73 t of the data as
22040 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 63 75 sociated with cu
22050 72 73 6f 72 20 70 43 75 72 2e 20 20 45 78 61 63 rsor pCur. Exac
22060 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 62 79 74 tly.** "amt" byt
22070 65 73 20 77 69 6c 6c 20 62 65 20 74 72 61 6e 73 es will be trans
22080 66 65 72 65 64 20 69 6e 74 6f 20 70 42 75 66 5b fered into pBuf[
22090 5d 2e 20 20 54 68 65 20 74 72 61 6e 73 66 65 72 ]. The transfer
220a0 0a 2a 2a 20 62 65 67 69 6e 73 20 61 74 20 22 6f .** begins at "o
220b0 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 52 65 ffset"..**.** Re
220c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f turn SQLITE_OK o
220d0 6e 20 73 75 63 63 65 73 73 20 6f 72 20 61 6e 20 n success or an
220e0 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61 6e error code if an
220f0 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 77 ything goes.** w
22100 72 6f 6e 67 2e 20 20 41 6e 20 65 72 72 6f 72 20 rong. An error
22110 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 22 is returned if "
22120 6f 66 66 73 65 74 2b 61 6d 74 22 20 69 73 20 6c offset+amt" is l
22130 61 72 67 65 72 20 74 68 61 6e 0a 2a 2a 20 74 68 arger than.** th
22140 65 20 61 76 61 69 6c 61 62 6c 65 20 70 61 79 6c e available payl
22150 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 oad..*/.int sqli
22160 74 65 33 42 74 72 65 65 44 61 74 61 28 42 74 43 te3BtreeData(BtC
22170 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 ursor *pCur, u32
22180 20 6f 66 66 73 65 74 2c 20 75 33 32 20 61 6d 74 offset, u32 amt
22190 2c 20 76 6f 69 64 20 2a 70 42 75 66 29 7b 0a 20 , void *pBuf){.
221a0 20 69 6e 74 20 72 63 3b 0a 0a 23 69 66 6e 64 65 int rc;..#ifnde
221b0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e f SQLITE_OMIT_IN
221c0 43 52 42 4c 4f 42 0a 20 20 69 66 20 28 20 70 43 CRBLOB. if ( pC
221d0 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
221e0 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a 20 20 OR_INVALID ){.
221f0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
22200 41 42 4f 52 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 ABORT;. }.#endi
22210 66 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 f.. assert( cur
22220 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
22230 75 72 29 20 29 3b 0a 20 20 72 63 20 3d 20 72 65 ur) );. rc = re
22240 73 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 storeCursorPosit
22250 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 69 66 28 ion(pCur);. if(
22260 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
22270 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 {. assert( pC
22280 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
22290 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 20 20 OR_VALID );.
222a0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 assert( pCur->iP
222b0 61 67 65 3e 3d 30 20 26 26 20 70 43 75 72 2d 3e age>=0 && pCur->
222c0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
222d0 67 65 5d 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ge] );. asser
222e0 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 t( pCur->aiIdx[p
222f0 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 Cur->iPage]<pCur
22300 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
22310 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a Page]->nCell );.
22320 20 20 20 20 72 63 20 3d 20 61 63 63 65 73 73 50 rc = accessP
22330 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 ayload(pCur, off
22340 73 65 74 2c 20 61 6d 74 2c 20 70 42 75 66 2c 20 set, amt, pBuf,
22350 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 0);. }. return
22360 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
22370 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 turn a pointer t
22380 6f 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 6d o payload inform
22390 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 65 ation from the e
223a0 6e 74 72 79 20 74 68 61 74 20 74 68 65 20 0a 2a ntry that the .*
223b0 2a 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 * pCur cursor is
223c0 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 20 54 pointing to. T
223d0 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 74 6f he pointer is to
223e0 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f the beginning o
223f0 66 0a 2a 2a 20 74 68 65 20 6b 65 79 20 69 66 20 f.** the key if
22400 73 6b 69 70 4b 65 79 3d 3d 30 20 61 6e 64 20 69 skipKey==0 and i
22410 74 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 t points to the
22420 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 64 61 74 beginning of dat
22430 61 20 69 66 0a 2a 2a 20 73 6b 69 70 4b 65 79 3d a if.** skipKey=
22440 3d 31 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 =1. The number
22450 6f 66 20 62 79 74 65 73 20 6f 66 20 61 76 61 69 of bytes of avai
22460 6c 61 62 6c 65 20 6b 65 79 2f 64 61 74 61 20 69 lable key/data i
22470 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 69 6e 74 s written.** int
22480 6f 20 2a 70 41 6d 74 2e 20 20 49 66 20 2a 70 41 o *pAmt. If *pA
22490 6d 74 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 20 mt==0, then the
224a0 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 77 value returned w
224b0 69 6c 6c 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 20 ill not be.** a
224c0 76 61 6c 69 64 20 70 6f 69 6e 74 65 72 2e 0a 2a valid pointer..*
224d0 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
224e0 65 20 69 73 20 61 6e 20 6f 70 74 69 6d 69 7a 61 e is an optimiza
224f0 74 69 6f 6e 2e 20 20 49 74 20 69 73 20 63 6f 6d tion. It is com
22500 6d 6f 6e 20 66 6f 72 20 74 68 65 20 65 6e 74 69 mon for the enti
22510 72 65 20 6b 65 79 0a 2a 2a 20 61 6e 64 20 64 61 re key.** and da
22520 74 61 20 74 6f 20 66 69 74 20 6f 6e 20 74 68 65 ta to fit on the
22530 20 6c 6f 63 61 6c 20 70 61 67 65 20 61 6e 64 20 local page and
22540 66 6f 72 20 74 68 65 72 65 20 74 6f 20 62 65 20 for there to be
22550 6e 6f 20 6f 76 65 72 66 6c 6f 77 0a 2a 2a 20 70 no overflow.** p
22560 61 67 65 73 2e 20 20 57 68 65 6e 20 74 68 61 74 ages. When that
22570 20 69 73 20 73 6f 2c 20 74 68 69 73 20 72 6f 75 is so, this rou
22580 74 69 6e 65 20 63 61 6e 20 62 65 20 75 73 65 64 tine can be used
22590 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 0a 2a to access the.*
225a0 2a 20 6b 65 79 20 61 6e 64 20 64 61 74 61 20 77 * key and data w
225b0 69 74 68 6f 75 74 20 6d 61 6b 69 6e 67 20 61 20 ithout making a
225c0 63 6f 70 79 2e 20 20 49 66 20 74 68 65 20 6b 65 copy. If the ke
225d0 79 20 61 6e 64 2f 6f 72 20 64 61 74 61 20 73 70 y and/or data sp
225e0 69 6c 6c 73 0a 2a 2a 20 6f 6e 74 6f 20 6f 76 65 ills.** onto ove
225f0 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 74 68 65 rflow pages, the
22600 6e 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 n accessPayload(
22610 29 20 6d 75 73 74 20 62 65 20 75 73 65 64 20 74 ) must be used t
22620 6f 20 72 65 61 73 73 65 6d 62 6c 65 0a 2a 2a 20 o reassemble.**
22630 74 68 65 20 6b 65 79 2f 64 61 74 61 20 61 6e 64 the key/data and
22640 20 63 6f 70 79 20 69 74 20 69 6e 74 6f 20 61 20 copy it into a
22650 70 72 65 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 preallocated buf
22660 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 fer..**.** The p
22670 6f 69 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 ointer returned
22680 62 79 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 by this routine
22690 6c 6f 6f 6b 73 20 64 69 72 65 63 74 6c 79 20 69 looks directly i
226a0 6e 74 6f 20 74 68 65 20 63 61 63 68 65 64 0a 2a nto the cached.*
226b0 2a 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 * page of the da
226c0 74 61 62 61 73 65 2e 20 20 54 68 65 20 64 61 74 tabase. The dat
226d0 61 20 6d 69 67 68 74 20 63 68 61 6e 67 65 20 6f a might change o
226e0 72 20 6d 6f 76 65 20 74 68 65 20 6e 65 78 74 20 r move the next
226f0 74 69 6d 65 0a 2a 2a 20 61 6e 79 20 62 74 72 65 time.** any btre
22700 65 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c e routine is cal
22710 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 led..*/.static c
22720 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
22730 61 72 20 2a 66 65 74 63 68 50 61 79 6c 6f 61 64 ar *fetchPayload
22740 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 (. BtCursor *pC
22750 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 ur, /* Curs
22760 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 or pointing to e
22770 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f ntry to read fro
22780 6d 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 6d 74 m */. int *pAmt
22790 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 , /* W
227a0 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 rite the number
227b0 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 of available byt
227c0 65 73 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 es here */. int
227d0 20 73 6b 69 70 4b 65 79 20 20 20 20 20 20 20 20 skipKey
227e0 20 20 2f 2a 20 72 65 61 64 20 62 65 67 69 6e 6e /* read beginn
227f0 69 6e 67 20 61 74 20 64 61 74 61 20 69 66 20 74 ing at data if t
22800 68 69 73 20 69 73 20 74 72 75 65 20 2a 2f 0a 29 his is true */.)
22810 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 {. unsigned cha
22820 72 20 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 20 4d r *aPayload;. M
22830 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 emPage *pPage;.
22840 20 75 33 32 20 6e 4b 65 79 3b 0a 20 20 75 33 32 u32 nKey;. u32
22850 20 6e 4c 6f 63 61 6c 3b 0a 0a 20 20 61 73 73 65 nLocal;.. asse
22860 72 74 28 20 70 43 75 72 21 3d 30 20 26 26 20 70 rt( pCur!=0 && p
22870 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 Cur->iPage>=0 &&
22880 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
22890 75 72 2d 3e 69 50 61 67 65 5d 29 3b 0a 20 20 61 ur->iPage]);. a
228a0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
228b0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
228c0 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 D );. assert( c
228d0 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
228e0 70 43 75 72 29 20 29 3b 0a 20 20 70 50 61 67 65 pCur) );. pPage
228f0 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
22900 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
22910 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
22920 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
22930 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b <pPage->nCell );
22940 0a 20 20 69 66 28 20 4e 45 56 45 52 28 70 43 75 . if( NEVER(pCu
22950 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
22960 29 20 29 7b 0a 20 20 20 20 62 74 72 65 65 50 61 ) ){. btreePa
22970 72 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 rseCell(pCur->ap
22980 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
22990 5d 2c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 ], pCur->aiIdx[p
229a0 43 75 72 2d 3e 69 50 61 67 65 5d 2c 0a 20 20 20 Cur->iPage],.
229b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
229c0 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 &pCur->info);.
229d0 7d 0a 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 70 }. aPayload = p
229e0 43 75 72 2d 3e 69 6e 66 6f 2e 70 43 65 6c 6c 3b Cur->info.pCell;
229f0 0a 20 20 61 50 61 79 6c 6f 61 64 20 2b 3d 20 70 . aPayload += p
22a00 43 75 72 2d 3e 69 6e 66 6f 2e 6e 48 65 61 64 65 Cur->info.nHeade
22a10 72 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e r;. if( pPage->
22a20 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 6e 4b intKey ){. nK
22a30 65 79 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b ey = 0;. }else{
22a40 0a 20 20 20 20 6e 4b 65 79 20 3d 20 28 69 6e 74 . nKey = (int
22a50 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 )pCur->info.nKey
22a60 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 6b 69 70 ;. }. if( skip
22a70 4b 65 79 20 29 7b 0a 20 20 20 20 61 50 61 79 6c Key ){. aPayl
22a80 6f 61 64 20 2b 3d 20 6e 4b 65 79 3b 0a 20 20 20 oad += nKey;.
22a90 20 6e 4c 6f 63 61 6c 20 3d 20 70 43 75 72 2d 3e nLocal = pCur->
22aa0 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d 20 6e 4b info.nLocal - nK
22ab0 65 79 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ey;. }else{.
22ac0 20 6e 4c 6f 63 61 6c 20 3d 20 70 43 75 72 2d 3e nLocal = pCur->
22ad0 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 20 info.nLocal;.
22ae0 20 61 73 73 65 72 74 28 20 6e 4c 6f 63 61 6c 3c assert( nLocal<
22af0 3d 6e 4b 65 79 20 29 3b 0a 20 20 7d 0a 20 20 2a =nKey );. }. *
22b00 70 41 6d 74 20 3d 20 6e 4c 6f 63 61 6c 3b 0a 20 pAmt = nLocal;.
22b10 20 72 65 74 75 72 6e 20 61 50 61 79 6c 6f 61 64 return aPayload
22b20 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 ;.}.../*.** For
22b30 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 63 the entry that c
22b40 75 72 73 6f 72 20 70 43 75 72 20 69 73 20 70 6f ursor pCur is po
22b50 69 6e 74 20 74 6f 2c 20 72 65 74 75 72 6e 20 61 int to, return a
22b60 73 0a 2a 2a 20 6d 61 6e 79 20 62 79 74 65 73 20 s.** many bytes
22b70 6f 66 20 74 68 65 20 6b 65 79 20 6f 72 20 64 61 of the key or da
22b80 74 61 20 61 73 20 61 72 65 20 61 76 61 69 6c 61 ta as are availa
22b90 62 6c 65 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c ble on the local
22ba0 0a 2a 2a 20 62 2d 74 72 65 65 20 70 61 67 65 2e .** b-tree page.
22bb0 20 20 57 72 69 74 65 20 74 68 65 20 6e 75 6d 62 Write the numb
22bc0 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 er of available
22bd0 62 79 74 65 73 20 69 6e 74 6f 20 2a 70 41 6d 74 bytes into *pAmt
22be0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 6e ..**.** The poin
22bf0 74 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 20 ter returned is
22c00 65 70 68 65 6d 65 72 61 6c 2e 20 20 54 68 65 20 ephemeral. The
22c10 6b 65 79 2f 64 61 74 61 20 6d 61 79 20 6d 6f 76 key/data may mov
22c20 65 0a 2a 2a 20 6f 72 20 62 65 20 64 65 73 74 72 e.** or be destr
22c30 6f 79 65 64 20 6f 6e 20 74 68 65 20 6e 65 78 74 oyed on the next
22c40 20 63 61 6c 6c 20 74 6f 20 61 6e 79 20 42 74 72 call to any Btr
22c50 65 65 20 72 6f 75 74 69 6e 65 2c 0a 2a 2a 20 69 ee routine,.** i
22c60 6e 63 6c 75 64 69 6e 67 20 63 61 6c 6c 73 20 66 ncluding calls f
22c70 72 6f 6d 20 6f 74 68 65 72 20 74 68 72 65 61 64 rom other thread
22c80 73 20 61 67 61 69 6e 73 74 20 74 68 65 20 73 61 s against the sa
22c90 6d 65 20 63 61 63 68 65 2e 0a 2a 2a 20 48 65 6e me cache..** Hen
22ca0 63 65 2c 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 ce, a mutex on t
22cb0 68 65 20 42 74 53 68 61 72 65 64 20 73 68 6f 75 he BtShared shou
22cc0 6c 64 20 62 65 20 68 65 6c 64 20 70 72 69 6f 72 ld be held prior
22cd0 20 74 6f 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 74 to calling.** t
22ce0 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 0a his routine..**.
22cf0 2a 2a 20 54 68 65 73 65 20 72 6f 75 74 69 6e 65 ** These routine
22d00 73 20 69 73 20 75 73 65 64 20 74 6f 20 67 65 74 s is used to get
22d10 20 71 75 69 63 6b 20 61 63 63 65 73 73 20 74 6f quick access to
22d20 20 6b 65 79 20 61 6e 64 20 64 61 74 61 0a 2a 2a key and data.**
22d30 20 69 6e 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 in the common c
22d40 61 73 65 20 77 68 65 72 65 20 6e 6f 20 6f 76 65 ase where no ove
22d50 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 65 20 rflow pages are
22d60 75 73 65 64 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 used..*/.const v
22d70 6f 69 64 20 2a 73 71 6c 69 74 65 33 42 74 72 65 oid *sqlite3Btre
22d80 65 4b 65 79 46 65 74 63 68 28 42 74 43 75 72 73 eKeyFetch(BtCurs
22d90 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
22da0 41 6d 74 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f Amt){. const vo
22db0 69 64 20 2a 70 20 3d 20 30 3b 0a 20 20 61 73 73 id *p = 0;. ass
22dc0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
22dd0 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 ex_held(pCur->pB
22de0 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 tree->db->mutex)
22df0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 );. assert( cu
22e00 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
22e10 43 75 72 29 20 29 3b 0a 20 20 69 66 28 20 41 4c Cur) );. if( AL
22e20 57 41 59 53 28 70 43 75 72 2d 3e 65 53 74 61 74 WAYS(pCur->eStat
22e30 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 29 e==CURSOR_VALID)
22e40 20 29 7b 0a 20 20 20 20 70 20 3d 20 28 63 6f 6e ){. p = (con
22e50 73 74 20 76 6f 69 64 2a 29 66 65 74 63 68 50 61 st void*)fetchPa
22e60 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 6d 74 yload(pCur, pAmt
22e70 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 , 0);. }. retu
22e80 72 6e 20 70 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f rn p;.}.const vo
22e90 69 64 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 id *sqlite3Btree
22ea0 44 61 74 61 46 65 74 63 68 28 42 74 43 75 72 73 DataFetch(BtCurs
22eb0 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
22ec0 41 6d 74 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f Amt){. const vo
22ed0 69 64 20 2a 70 20 3d 20 30 3b 0a 20 20 61 73 73 id *p = 0;. ass
22ee0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
22ef0 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 ex_held(pCur->pB
22f00 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 tree->db->mutex)
22f10 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 );. assert( cu
22f20 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
22f30 43 75 72 29 20 29 3b 0a 20 20 69 66 28 20 41 4c Cur) );. if( AL
22f40 57 41 59 53 28 70 43 75 72 2d 3e 65 53 74 61 74 WAYS(pCur->eStat
22f50 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 29 e==CURSOR_VALID)
22f60 20 29 7b 0a 20 20 20 20 70 20 3d 20 28 63 6f 6e ){. p = (con
22f70 73 74 20 76 6f 69 64 2a 29 66 65 74 63 68 50 61 st void*)fetchPa
22f80 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 6d 74 yload(pCur, pAmt
22f90 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 , 1);. }. retu
22fa0 72 6e 20 70 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 rn p;.}.../*.**
22fb0 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 Move the cursor
22fc0 64 6f 77 6e 20 74 6f 20 61 20 6e 65 77 20 63 68 down to a new ch
22fd0 69 6c 64 20 70 61 67 65 2e 20 20 54 68 65 20 6e ild page. The n
22fe0 65 77 50 67 6e 6f 20 61 72 67 75 6d 65 6e 74 20 ewPgno argument
22ff0 69 73 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 6e is the.** page n
23000 75 6d 62 65 72 20 6f 66 20 74 68 65 20 63 68 69 umber of the chi
23010 6c 64 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 ld page to move
23020 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 to..**.** This f
23030 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
23040 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69 SQLITE_CORRUPT i
23050 66 20 74 68 65 20 70 61 67 65 2d 68 65 61 64 65 f the page-heade
23060 72 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 r flags field of
23070 0a 2a 2a 20 74 68 65 20 6e 65 77 20 63 68 69 6c .** the new chil
23080 64 20 70 61 67 65 20 64 6f 65 73 20 6e 6f 74 20 d page does not
23090 6d 61 74 63 68 20 74 68 65 20 66 6c 61 67 73 20 match the flags
230a0 66 69 65 6c 64 20 6f 66 20 74 68 65 20 70 61 72 field of the par
230b0 65 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 69 66 20 ent (i.e..** if
230c0 61 6e 20 69 6e 74 6b 65 79 20 70 61 67 65 20 61 an intkey page a
230d0 70 70 65 61 72 73 20 74 6f 20 62 65 20 74 68 65 ppears to be the
230e0 20 70 61 72 65 6e 74 20 6f 66 20 61 20 6e 6f 6e parent of a non
230f0 2d 69 6e 74 6b 65 79 20 70 61 67 65 2c 20 6f 72 -intkey page, or
23100 0a 2a 2a 20 76 69 63 65 2d 76 65 72 73 61 29 2e .** vice-versa).
23110 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d .*/.static int m
23120 6f 76 65 54 6f 43 68 69 6c 64 28 42 74 43 75 72 oveToChild(BtCur
23130 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6e sor *pCur, u32 n
23140 65 77 50 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 72 ewPgno){. int r
23150 63 3b 0a 20 20 69 6e 74 20 69 20 3d 20 70 43 75 c;. int i = pCu
23160 72 2d 3e 69 50 61 67 65 3b 0a 20 20 4d 65 6d 50 r->iPage;. MemP
23170 61 67 65 20 2a 70 4e 65 77 50 61 67 65 3b 0a 20 age *pNewPage;.
23180 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
23190 20 70 43 75 72 2d 3e 70 42 74 3b 0a 0a 20 20 61 pCur->pBt;.. a
231a0 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
231b0 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
231c0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
231d0 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
231e0 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
231f0 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3c 42 t( pCur->iPage<B
23200 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 45 50 54 TCURSOR_MAX_DEPT
23210 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 H );. assert( p
23220 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 29 3b Cur->iPage>=0 );
23230 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 . if( pCur->iPa
23240 67 65 3e 3d 28 42 54 43 55 52 53 4f 52 5f 4d 41 ge>=(BTCURSOR_MA
23250 58 5f 44 45 50 54 48 2d 31 29 20 29 7b 0a 20 20 X_DEPTH-1) ){.
23260 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
23270 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
23280 7d 0a 20 20 72 63 20 3d 20 67 65 74 41 6e 64 49 }. rc = getAndI
23290 6e 69 74 50 61 67 65 28 70 42 74 2c 20 6e 65 77 nitPage(pBt, new
232a0 50 67 6e 6f 2c 20 26 70 4e 65 77 50 61 67 65 2c Pgno, &pNewPage,
232b0 20 28 70 43 75 72 2d 3e 77 72 46 6c 61 67 3d 3d (pCur->wrFlag==
232c0 30 29 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 0));. if( rc )
232d0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 70 43 75 return rc;. pCu
232e0 72 2d 3e 61 70 50 61 67 65 5b 69 2b 31 5d 20 3d r->apPage[i+1] =
232f0 20 70 4e 65 77 50 61 67 65 3b 0a 20 20 70 43 75 pNewPage;. pCu
23300 72 2d 3e 61 69 49 64 78 5b 69 2b 31 5d 20 3d 20 r->aiIdx[i+1] =
23310 30 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 0;. pCur->iPage
23320 2b 2b 3b 0a 0a 20 20 70 43 75 72 2d 3e 69 6e 66 ++;.. pCur->inf
23330 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 o.nSize = 0;. p
23340 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d Cur->validNKey =
23350 20 30 3b 0a 20 20 69 66 28 20 70 4e 65 77 50 61 0;. if( pNewPa
23360 67 65 2d 3e 6e 43 65 6c 6c 3c 31 20 7c 7c 20 70 ge->nCell<1 || p
23370 4e 65 77 50 61 67 65 2d 3e 69 6e 74 4b 65 79 21 NewPage->intKey!
23380 3d 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d =pCur->apPage[i]
23390 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 ->intKey ){.
233a0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
233b0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a RRUPT_BKPT;. }.
233c0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
233d0 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 30 0a 2f 2a 0a OK;.}..#if 0./*.
233e0 2a 2a 20 50 61 67 65 20 70 50 61 72 65 6e 74 20 ** Page pParent
233f0 69 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 28 is an internal (
23400 6e 6f 6e 2d 6c 65 61 66 29 20 74 72 65 65 20 70 non-leaf) tree p
23410 61 67 65 2e 20 54 68 69 73 20 66 75 6e 63 74 69 age. This functi
23420 6f 6e 20 0a 2a 2a 20 61 73 73 65 72 74 73 20 74 on .** asserts t
23430 68 61 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 hat page number
23440 69 43 68 69 6c 64 20 69 73 20 74 68 65 20 6c 65 iChild is the le
23450 66 74 2d 63 68 69 6c 64 20 69 66 20 74 68 65 20 ft-child if the
23460 69 49 64 78 27 74 68 0a 2a 2a 20 63 65 6c 6c 20 iIdx'th.** cell
23470 69 6e 20 70 61 67 65 20 70 50 61 72 65 6e 74 2e in page pParent.
23480 20 4f 72 2c 20 69 66 20 69 49 64 78 20 69 73 20 Or, if iIdx is
23490 65 71 75 61 6c 20 74 6f 20 74 68 65 20 74 6f 74 equal to the tot
234a0 61 6c 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 al number of.**
234b0 63 65 6c 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 cells in pParent
234c0 2c 20 74 68 61 74 20 70 61 67 65 20 6e 75 6d 62 , that page numb
234d0 65 72 20 69 43 68 69 6c 64 20 69 73 20 74 68 65 er iChild is the
234e0 20 72 69 67 68 74 2d 63 68 69 6c 64 20 6f 66 0a right-child of.
234f0 2a 2a 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a ** the page..*/.
23500 73 74 61 74 69 63 20 76 6f 69 64 20 61 73 73 65 static void asse
23510 72 74 50 61 72 65 6e 74 49 6e 64 65 78 28 4d 65 rtParentIndex(Me
23520 6d 50 61 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 mPage *pParent,
23530 69 6e 74 20 69 49 64 78 2c 20 50 67 6e 6f 20 69 int iIdx, Pgno i
23540 43 68 69 6c 64 29 7b 0a 20 20 61 73 73 65 72 74 Child){. assert
23550 28 20 69 49 64 78 3c 3d 70 50 61 72 65 6e 74 2d ( iIdx<=pParent-
23560 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 69 66 28 20 >nCell );. if(
23570 69 49 64 78 3d 3d 70 50 61 72 65 6e 74 2d 3e 6e iIdx==pParent->n
23580 43 65 6c 6c 20 29 7b 0a 20 20 20 20 61 73 73 65 Cell ){. asse
23590 72 74 28 20 67 65 74 34 62 79 74 65 28 26 70 50 rt( get4byte(&pP
235a0 61 72 65 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 arent->aData[pPa
235b0 72 65 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b rent->hdrOffset+
235c0 38 5d 29 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 8])==iChild );.
235d0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
235e0 72 74 28 20 67 65 74 34 62 79 74 65 28 66 69 6e rt( get4byte(fin
235f0 64 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 69 dCell(pParent, i
23600 49 64 78 29 29 3d 3d 69 43 68 69 6c 64 20 29 3b Idx))==iChild );
23610 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 0a 23 20 20 . }.}.#else.#
23620 64 65 66 69 6e 65 20 61 73 73 65 72 74 50 61 72 define assertPar
23630 65 6e 74 49 6e 64 65 78 28 78 2c 79 2c 7a 29 20 entIndex(x,y,z)
23640 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d .#endif../*.** M
23650 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 75 ove the cursor u
23660 70 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 p to the parent
23670 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 page..**.** pCur
23680 2d 3e 69 64 78 20 69 73 20 73 65 74 20 74 6f 20 ->idx is set to
23690 74 68 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 74 the cell index t
236a0 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 hat contains the
236b0 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 pointer.** to t
236c0 68 65 20 70 61 67 65 20 77 65 20 61 72 65 20 63 he page we are c
236d0 6f 6d 69 6e 67 20 66 72 6f 6d 2e 20 20 49 66 20 oming from. If
236e0 77 65 20 61 72 65 20 63 6f 6d 69 6e 67 20 66 72 we are coming fr
236f0 6f 6d 20 74 68 65 0a 2a 2a 20 72 69 67 68 74 2d om the.** right-
23700 6d 6f 73 74 20 63 68 69 6c 64 20 70 61 67 65 20 most child page
23710 74 68 65 6e 20 70 43 75 72 2d 3e 69 64 78 20 69 then pCur->idx i
23720 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 6d 6f 72 s set to one mor
23730 65 20 74 68 61 6e 0a 2a 2a 20 74 68 65 20 6c 61 e than.** the la
23740 72 67 65 73 74 20 63 65 6c 6c 20 69 6e 64 65 78 rgest cell index
23750 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
23760 20 6d 6f 76 65 54 6f 50 61 72 65 6e 74 28 42 74 moveToParent(Bt
23770 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
23780 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
23790 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
237a0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
237b0 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
237c0 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
237d0 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 ert( pCur->iPage
237e0 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 >0 );. assert(
237f0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
23800 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 0a 20 20 r->iPage] );..
23810 2f 2a 20 55 50 44 41 54 45 3a 20 49 74 20 69 73 /* UPDATE: It is
23820 20 61 63 74 75 61 6c 6c 79 20 70 6f 73 73 69 62 actually possib
23830 6c 65 20 66 6f 72 20 74 68 65 20 63 6f 6e 64 69 le for the condi
23840 74 69 6f 6e 20 74 65 73 74 65 64 20 62 79 20 74 tion tested by t
23850 68 65 20 61 73 73 65 72 74 0a 20 20 2a 2a 20 62 he assert. ** b
23860 65 6c 6f 77 20 74 6f 20 62 65 20 75 6e 74 72 75 elow to be untru
23870 65 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 e if the databas
23880 65 20 66 69 6c 65 20 69 73 20 63 6f 72 72 75 70 e file is corrup
23890 74 2e 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75 t. This can occu
238a0 72 20 69 66 0a 20 20 2a 2a 20 6f 6e 65 20 63 75 r if. ** one cu
238b0 72 73 6f 72 20 68 61 73 20 6d 6f 64 69 66 69 65 rsor has modifie
238c0 64 20 70 61 67 65 20 70 50 61 72 65 6e 74 20 77 d page pParent w
238d0 68 69 6c 65 20 61 20 72 65 66 65 72 65 6e 63 65 hile a reference
238e0 20 74 6f 20 69 74 20 69 73 20 68 65 6c 64 20 0a to it is held .
238f0 20 20 2a 2a 20 62 79 20 61 20 73 65 63 6f 6e 64 ** by a second
23900 20 63 75 72 73 6f 72 2e 20 57 68 69 63 68 20 63 cursor. Which c
23910 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 an only happen i
23920 66 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 f a single page
23930 69 73 20 6c 69 6e 6b 65 64 0a 20 20 2a 2a 20 69 is linked. ** i
23940 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e nto more than on
23950 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 e b-tree structu
23960 72 65 20 69 6e 20 61 20 63 6f 72 72 75 70 74 20 re in a corrupt
23970 64 61 74 61 62 61 73 65 2e 20 20 2a 2f 0a 23 69 database. */.#i
23980 66 20 30 0a 20 20 61 73 73 65 72 74 50 61 72 65 f 0. assertPare
23990 6e 74 49 6e 64 65 78 28 0a 20 20 20 20 70 43 75 ntIndex(. pCu
239a0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
239b0 69 50 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 iPage-1], . p
239c0 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
239d0 3e 69 50 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 >iPage-1], .
239e0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
239f0 72 2d 3e 69 50 61 67 65 5d 2d 3e 70 67 6e 6f 0a r->iPage]->pgno.
23a00 20 20 29 3b 0a 23 65 6e 64 69 66 0a 20 20 74 65 );.#endif. te
23a10 73 74 63 61 73 65 28 20 70 43 75 72 2d 3e 61 69 stcase( pCur->ai
23a20 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d Idx[pCur->iPage-
23a30 31 5d 20 3e 20 70 43 75 72 2d 3e 61 70 50 61 67 1] > pCur->apPag
23a40 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d e[pCur->iPage-1]
23a50 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 0a 20 20 72 65 ->nCell );.. re
23a60 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 2d 3e leasePage(pCur->
23a70 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
23a80 67 65 5d 29 3b 0a 20 20 70 43 75 72 2d 3e 69 50 ge]);. pCur->iP
23a90 61 67 65 2d 2d 3b 0a 20 20 70 43 75 72 2d 3e 69 age--;. pCur->i
23aa0 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
23ab0 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 pCur->validNKey
23ac0 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d = 0;.}../*.** M
23ad0 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 ove the cursor t
23ae0 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 72 o point to the r
23af0 6f 6f 74 20 70 61 67 65 20 6f 66 20 69 74 73 20 oot page of its
23b00 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 b-tree structure
23b10 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 74 ..**.** If the t
23b20 61 62 6c 65 20 68 61 73 20 61 20 76 69 72 74 75 able has a virtu
23b30 61 6c 20 72 6f 6f 74 20 70 61 67 65 2c 20 74 68 al root page, th
23b40 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 en the cursor is
23b50 20 6d 6f 76 65 64 20 74 6f 20 70 6f 69 6e 74 0a moved to point.
23b60 2a 2a 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 ** to the virtua
23b70 6c 20 72 6f 6f 74 20 70 61 67 65 20 69 6e 73 74 l root page inst
23b80 65 61 64 20 6f 66 20 74 68 65 20 61 63 74 75 61 ead of the actua
23b90 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 41 20 74 l root page. A t
23ba0 61 62 6c 65 20 68 61 73 20 61 0a 2a 2a 20 76 69 able has a.** vi
23bb0 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 rtual root page
23bc0 77 68 65 6e 20 74 68 65 20 61 63 74 75 61 6c 20 when the actual
23bd0 72 6f 6f 74 20 70 61 67 65 20 63 6f 6e 74 61 69 root page contai
23be0 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 61 6e 64 20 ns no cells and
23bf0 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 20 63 68 69 a .** single chi
23c00 6c 64 20 70 61 67 65 2e 20 54 68 69 73 20 63 61 ld page. This ca
23c10 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 77 69 n only happen wi
23c20 74 68 20 74 68 65 20 74 61 62 6c 65 20 72 6f 6f th the table roo
23c30 74 65 64 20 61 74 20 70 61 67 65 20 31 2e 0a 2a ted at page 1..*
23c40 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 2d 74 72 *.** If the b-tr
23c50 65 65 20 73 74 72 75 63 74 75 72 65 20 69 73 20 ee structure is
23c60 65 6d 70 74 79 2c 20 74 68 65 20 63 75 72 73 6f empty, the curso
23c70 72 20 73 74 61 74 65 20 69 73 20 73 65 74 20 74 r state is set t
23c80 6f 20 0a 2a 2a 20 43 55 52 53 4f 52 5f 49 4e 56 o .** CURSOR_INV
23c90 41 4c 49 44 2e 20 4f 74 68 65 72 77 69 73 65 2c ALID. Otherwise,
23ca0 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 73 the cursor is s
23cb0 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 et to point to t
23cc0 68 65 20 66 69 72 73 74 0a 2a 2a 20 63 65 6c 6c he first.** cell
23cd0 20 6c 6f 63 61 74 65 64 20 6f 6e 20 74 68 65 20 located on the
23ce0 72 6f 6f 74 20 28 6f 72 20 76 69 72 74 75 61 6c root (or virtual
23cf0 20 72 6f 6f 74 29 20 70 61 67 65 20 61 6e 64 20 root) page and
23d00 74 68 65 20 63 75 72 73 6f 72 20 73 74 61 74 65 the cursor state
23d10 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 43 55 .** is set to CU
23d20 52 53 4f 52 5f 56 41 4c 49 44 2e 0a 2a 2a 0a 2a RSOR_VALID..**.*
23d30 2a 20 49 66 20 74 68 69 73 20 66 75 6e 63 74 69 * If this functi
23d40 6f 6e 20 72 65 74 75 72 6e 73 20 73 75 63 63 65 on returns succe
23d50 73 73 66 75 6c 6c 79 2c 20 69 74 20 6d 61 79 20 ssfully, it may
23d60 62 65 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 be assumed that
23d70 74 68 65 0a 2a 2a 20 70 61 67 65 2d 68 65 61 64 the.** page-head
23d80 65 72 20 66 6c 61 67 73 20 69 6e 64 69 63 61 74 er flags indicat
23d90 65 20 74 68 61 74 20 74 68 65 20 5b 76 69 72 74 e that the [virt
23da0 75 61 6c 5d 20 72 6f 6f 74 2d 70 61 67 65 20 69 ual] root-page i
23db0 73 20 74 68 65 20 65 78 70 65 63 74 65 64 20 0a s the expected .
23dc0 2a 2a 20 6b 69 6e 64 20 6f 66 20 62 2d 74 72 65 ** kind of b-tre
23dd0 65 20 70 61 67 65 20 28 69 2e 65 2e 20 69 66 20 e page (i.e. if
23de0 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 74 68 65 when opening the
23df0 20 63 75 72 73 6f 72 20 74 68 65 20 63 61 6c 6c cursor the call
23e00 65 72 20 64 69 64 20 6e 6f 74 0a 2a 2a 20 73 70 er did not.** sp
23e10 65 63 69 66 79 20 61 20 4b 65 79 49 6e 66 6f 20 ecify a KeyInfo
23e20 73 74 72 75 63 74 75 72 65 20 74 68 65 20 66 6c structure the fl
23e30 61 67 73 20 62 79 74 65 20 69 73 20 73 65 74 20 ags byte is set
23e40 74 6f 20 30 78 30 35 20 6f 72 20 30 78 30 44 2c to 0x05 or 0x0D,
23e50 0a 2a 2a 20 69 6e 64 69 63 61 74 69 6e 67 20 61 .** indicating a
23e60 20 74 61 62 6c 65 20 62 2d 74 72 65 65 2c 20 6f table b-tree, o
23e70 72 20 69 66 20 74 68 65 20 63 61 6c 6c 65 72 20 r if the caller
23e80 64 69 64 20 73 70 65 63 69 66 79 20 61 20 4b 65 did specify a Ke
23e90 79 49 6e 66 6f 20 0a 2a 2a 20 73 74 72 75 63 74 yInfo .** struct
23ea0 75 72 65 20 74 68 65 20 66 6c 61 67 73 20 62 79 ure the flags by
23eb0 74 65 20 69 73 20 73 65 74 20 74 6f 20 30 78 30 te is set to 0x0
23ec0 32 20 6f 72 20 30 78 30 41 2c 20 69 6e 64 69 63 2 or 0x0A, indic
23ed0 61 74 69 6e 67 20 61 6e 20 69 6e 64 65 78 0a 2a ating an index.*
23ee0 2a 20 62 2d 74 72 65 65 29 2e 0a 2a 2f 0a 73 74 * b-tree)..*/.st
23ef0 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 atic int moveToR
23f00 6f 6f 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 oot(BtCursor *pC
23f10 75 72 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a ur){. MemPage *
23f20 70 52 6f 6f 74 3b 0a 20 20 69 6e 74 20 72 63 20 pRoot;. int rc
23f30 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 42 = SQLITE_OK;. B
23f40 74 72 65 65 20 2a 70 20 3d 20 70 43 75 72 2d 3e tree *p = pCur->
23f50 70 42 74 72 65 65 3b 0a 20 20 42 74 53 68 61 72 pBtree;. BtShar
23f60 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
23f70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
23f80 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
23f90 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
23fa0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 CURSOR_INVALID
23fb0 3c 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 < CURSOR_REQUIRE
23fc0 53 45 45 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 SEEK );. assert
23fd0 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 20 ( CURSOR_VALID
23fe0 20 3c 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 < CURSOR_REQUIR
23ff0 45 53 45 45 4b 20 29 3b 0a 20 20 61 73 73 65 72 ESEEK );. asser
24000 74 28 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 t( CURSOR_FAULT
24010 20 20 3e 20 43 55 52 53 4f 52 5f 52 45 51 55 49 > CURSOR_REQUI
24020 52 45 53 45 45 4b 20 29 3b 0a 20 20 69 66 28 20 RESEEK );. if(
24030 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d 43 55 pCur->eState>=CU
24040 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
24050 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 ){. if( pCur
24060 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
24070 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 20 20 20 _FAULT ){.
24080 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
24090 69 70 4e 65 78 74 21 3d 53 51 4c 49 54 45 5f 4f ipNext!=SQLITE_O
240a0 4b 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 K );. retur
240b0 6e 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 n pCur->skipNext
240c0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
240d0 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 72 te3BtreeClearCur
240e0 73 6f 72 28 70 43 75 72 29 3b 0a 20 20 7d 0a 0a sor(pCur);. }..
240f0 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 if( pCur->iPag
24100 65 3e 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 e>=0 ){. int
24110 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 31 3b 20 i;. for(i=1;
24120 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 i<=pCur->iPage;
24130 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 i++){. rele
24140 61 73 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 asePage(pCur->ap
24150 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a Page[i]);. }.
24160 20 20 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 pCur->iPage
24170 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 = 0;. }else if(
24180 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d pCur->pgnoRoot=
24190 3d 30 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e =0 ){. pCur->
241a0 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f eState = CURSOR_
241b0 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 INVALID;. ret
241c0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
241d0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d }else{. rc =
241e0 20 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 getAndInitPage(
241f0 70 42 74 2c 20 70 43 75 72 2d 3e 70 67 6e 6f 52 pBt, pCur->pgnoR
24200 6f 6f 74 2c 20 26 70 43 75 72 2d 3e 61 70 50 61 oot, &pCur->apPa
24210 67 65 5b 30 5d 2c 20 70 43 75 72 2d 3e 77 72 46 ge[0], pCur->wrF
24220 6c 61 67 3d 3d 30 29 3b 0a 20 20 20 20 69 66 28 lag==0);. if(
24230 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
24240 7b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 {. pCur->eS
24250 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
24260 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 72 65 74 VALID;. ret
24270 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
24280 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 pCur->iPage =
24290 30 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 70 43 0;.. /* If pC
242a0 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 69 73 20 ur->pKeyInfo is
242b0 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 not NULL, then t
242c0 68 65 20 63 61 6c 6c 65 72 20 74 68 61 74 20 6f he caller that o
242d0 70 65 6e 65 64 20 74 68 69 73 20 63 75 72 73 6f pened this curso
242e0 72 0a 20 20 20 20 2a 2a 20 65 78 70 65 63 74 65 r. ** expecte
242f0 64 20 74 6f 20 6f 70 65 6e 20 69 74 20 6f 6e 20 d to open it on
24300 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 2e an index b-tree.
24310 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 Otherwise, if p
24320 4b 65 79 49 6e 66 6f 20 69 73 0a 20 20 20 20 2a KeyInfo is. *
24330 2a 20 4e 55 4c 4c 2c 20 74 68 65 20 63 61 6c 6c * NULL, the call
24340 65 72 20 65 78 70 65 63 74 73 20 61 20 74 61 62 er expects a tab
24350 6c 65 20 62 2d 74 72 65 65 2e 20 49 66 20 74 68 le b-tree. If th
24360 69 73 20 69 73 20 6e 6f 74 20 74 68 65 20 63 61 is is not the ca
24370 73 65 2c 0a 20 20 20 20 2a 2a 20 72 65 74 75 72 se,. ** retur
24380 6e 20 61 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 n an SQLITE_CORR
24390 55 50 54 20 65 72 72 6f 72 2e 20 20 2a 2f 0a 20 UPT error. */.
243a0 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
243b0 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b >apPage[0]->intK
243c0 65 79 3d 3d 31 20 7c 7c 20 70 43 75 72 2d 3e 61 ey==1 || pCur->a
243d0 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 pPage[0]->intKey
243e0 3d 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 28 ==0 );. if( (
243f0 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d 3d pCur->pKeyInfo==
24400 30 29 21 3d 70 43 75 72 2d 3e 61 70 50 61 67 65 0)!=pCur->apPage
24410 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 [0]->intKey ){.
24420 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
24430 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
24440 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
24450 20 41 73 73 65 72 74 20 74 68 61 74 20 74 68 65 Assert that the
24460 20 72 6f 6f 74 20 70 61 67 65 20 69 73 20 6f 66 root page is of
24470 20 74 68 65 20 63 6f 72 72 65 63 74 20 74 79 70 the correct typ
24480 65 2e 20 54 68 69 73 20 6d 75 73 74 20 62 65 20 e. This must be
24490 74 68 65 0a 20 20 2a 2a 20 63 61 73 65 20 61 73 the. ** case as
244a0 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 74 68 69 the call to thi
244b0 73 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 s function that
244c0 6c 6f 61 64 65 64 20 74 68 65 20 72 6f 6f 74 2d loaded the root-
244d0 70 61 67 65 20 28 65 69 74 68 65 72 0a 20 20 2a page (either. *
244e0 2a 20 74 68 69 73 20 63 61 6c 6c 20 6f 72 20 61 * this call or a
244f0 20 70 72 65 76 69 6f 75 73 20 69 6e 76 6f 63 61 previous invoca
24500 74 69 6f 6e 29 20 77 6f 75 6c 64 20 68 61 76 65 tion) would have
24510 20 64 65 74 65 63 74 65 64 20 63 6f 72 72 75 70 detected corrup
24520 74 69 6f 6e 20 0a 20 20 2a 2a 20 69 66 20 74 68 tion . ** if th
24530 65 20 61 73 73 75 6d 70 74 69 6f 6e 20 77 65 72 e assumption wer
24540 65 20 6e 6f 74 20 74 72 75 65 2c 20 61 6e 64 20 e not true, and
24550 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 it is not possib
24560 6c 65 20 66 6f 72 20 74 68 65 20 66 6c 61 67 73 le for the flags
24570 20 0a 20 20 2a 2a 20 62 79 74 65 20 74 6f 20 68 . ** byte to h
24580 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 ave been modifie
24590 64 20 77 68 69 6c 65 20 74 68 69 73 20 63 75 72 d while this cur
245a0 73 6f 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 sor is holding a
245b0 20 72 65 66 65 72 65 6e 63 65 0a 20 20 2a 2a 20 reference. **
245c0 74 6f 20 74 68 65 20 70 61 67 65 2e 20 20 2a 2f to the page. */
245d0 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d . pRoot = pCur-
245e0 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 20 61 73 >apPage[0];. as
245f0 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 70 67 6e sert( pRoot->pgn
24600 6f 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f o==pCur->pgnoRoo
24610 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 t );. assert( p
24620 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 20 26 26 20 Root->isInit &&
24630 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d (pCur->pKeyInfo=
24640 3d 30 29 3d 3d 70 52 6f 6f 74 2d 3e 69 6e 74 4b =0)==pRoot->intK
24650 65 79 20 29 3b 0a 0a 20 20 70 43 75 72 2d 3e 61 ey );.. pCur->a
24660 69 49 64 78 5b 30 5d 20 3d 20 30 3b 0a 20 20 70 iIdx[0] = 0;. p
24670 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
24680 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 61 74 4c = 0;. pCur->atL
24690 61 73 74 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d ast = 0;. pCur-
246a0 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 30 3b 0a >validNKey = 0;.
246b0 0a 20 20 69 66 28 20 70 52 6f 6f 74 2d 3e 6e 43 . if( pRoot->nC
246c0 65 6c 6c 3d 3d 30 20 26 26 20 21 70 52 6f 6f 74 ell==0 && !pRoot
246d0 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 ->leaf ){. Pg
246e0 6e 6f 20 73 75 62 70 61 67 65 3b 0a 20 20 20 20 no subpage;.
246f0 69 66 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 21 if( pRoot->pgno!
24700 3d 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =1 ) return SQLI
24710 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
24720 0a 20 20 20 20 73 75 62 70 61 67 65 20 3d 20 67 . subpage = g
24730 65 74 34 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e et4byte(&pRoot->
24740 61 44 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 aData[pRoot->hdr
24750 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 Offset+8]);.
24760 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
24770 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 URSOR_VALID;.
24780 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
24790 64 28 70 43 75 72 2c 20 73 75 62 70 61 67 65 29 d(pCur, subpage)
247a0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
247b0 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 28 28 Cur->eState = ((
247c0 70 52 6f 6f 74 2d 3e 6e 43 65 6c 6c 3e 30 29 3f pRoot->nCell>0)?
247d0 43 55 52 53 4f 52 5f 56 41 4c 49 44 3a 43 55 52 CURSOR_VALID:CUR
247e0 53 4f 52 5f 49 4e 56 41 4c 49 44 29 3b 0a 20 20 SOR_INVALID);.
247f0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
24800 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
24810 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 cursor down to
24820 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 the left-most le
24830 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
24840 20 74 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f the.** entry to
24850 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 which it is cur
24860 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e rently pointing.
24870 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d .**.** The left-
24880 6d 6f 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 most leaf is the
24890 20 6f 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d one with the sm
248a0 61 6c 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 allest key - the
248b0 20 66 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 first.** in asc
248c0 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f ending order..*/
248d0 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 .static int move
248e0 54 6f 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 ToLeftmost(BtCur
248f0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 sor *pCur){. Pg
24900 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 no pgno;. int r
24910 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
24920 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
24930 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
24940 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
24950 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
24960 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
24970 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
24980 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 while( rc==SQLIT
24990 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 E_OK && !(pPage
249a0 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
249b0 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 Cur->iPage])->le
249c0 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 af ){. assert
249d0 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
249e0 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 ur->iPage]<pPage
249f0 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 70 ->nCell );. p
24a00 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 66 gno = get4byte(f
24a10 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 indCell(pPage, p
24a20 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
24a30 3e 69 50 61 67 65 5d 29 29 3b 0a 20 20 20 20 72 >iPage]));. r
24a40 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
24a50 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d pCur, pgno);. }
24a60 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
24a70 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
24a80 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 cursor down to t
24a90 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 he right-most le
24aa0 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
24ab0 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 the.** page to
24ac0 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 which it is curr
24ad0 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 20 ently pointing.
24ae0 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 66 66 Notice the diff
24af0 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 65 erence.** betwee
24b00 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
24b10 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 67 () and moveToRig
24b20 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 54 htmost(). moveT
24b30 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 oLeftmost().** f
24b40 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d 6d 6f inds the left-mo
24b50 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 st entry beneath
24b60 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 65 the *entry* whe
24b70 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 74 reas moveToRight
24b80 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 most().** finds
24b90 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 the right-most e
24ba0 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 ntry beneath the
24bb0 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 *page*..**.** T
24bc0 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e he right-most en
24bd0 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 20 77 try is the one w
24be0 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 74 20 ith the largest
24bf0 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 0a 2a key - the last.*
24c00 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 69 * key in ascendi
24c10 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ng order..*/.sta
24c20 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 69 tic int moveToRi
24c30 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 ghtmost(BtCursor
24c40 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 *pCur){. Pgno
24c50 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d pgno;. int rc =
24c60 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 SQLITE_OK;. Me
24c70 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 mPage *pPage = 0
24c80 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
24c90 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
24ca0 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
24cb0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
24cc0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
24cd0 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 while( rc==SQLI
24ce0 54 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 TE_OK && !(pPage
24cf0 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
24d00 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c pCur->iPage])->l
24d10 65 61 66 20 29 7b 0a 20 20 20 20 70 67 6e 6f 20 eaf ){. pgno
24d20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 = get4byte(&pPag
24d30 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e e->aData[pPage->
24d40 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 hdrOffset+8]);.
24d50 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 pCur->aiIdx[p
24d60 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 Cur->iPage] = pP
24d70 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 age->nCell;.
24d80 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 rc = moveToChild
24d90 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 (pCur, pgno);.
24da0 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 }. if( rc==SQLI
24db0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 43 75 TE_OK ){. pCu
24dc0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
24dd0 50 61 67 65 5d 20 3d 20 70 50 61 67 65 2d 3e 6e Page] = pPage->n
24de0 43 65 6c 6c 2d 31 3b 0a 20 20 20 20 70 43 75 72 Cell-1;. pCur
24df0 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
24e00 3b 0a 20 20 20 20 70 43 75 72 2d 3e 76 61 6c 69 ;. pCur->vali
24e10 64 4e 4b 65 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 dNKey = 0;. }.
24e20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
24e30 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f * Move the curso
24e40 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 r to the first e
24e50 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c ntry in the tabl
24e60 65 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 e. Return SQLIT
24e70 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 E_OK.** on succe
24e80 73 73 2e 20 20 53 65 74 20 2a 70 52 65 73 20 74 ss. Set *pRes t
24e90 6f 20 30 20 69 66 20 74 68 65 20 63 75 72 73 6f o 0 if the curso
24ea0 72 20 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e 74 r actually point
24eb0 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 2a s to something.*
24ec0 2a 20 6f 72 20 73 65 74 20 2a 70 52 65 73 20 74 * or set *pRes t
24ed0 6f 20 31 20 69 66 20 74 68 65 20 74 61 62 6c 65 o 1 if the table
24ee0 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e is empty..*/.in
24ef0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 69 t sqlite3BtreeFi
24f00 72 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 rst(BtCursor *pC
24f10 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a ur, int *pRes){.
24f20 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 int rc;.. ass
24f30 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
24f40 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 Mutex(pCur) );.
24f50 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
24f60 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 _mutex_held(pCur
24f70 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 ->pBtree->db->mu
24f80 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 6d tex) );. rc = m
24f90 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b oveToRoot(pCur);
24fa0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
24fb0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
24fc0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
24fd0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a RSOR_INVALID ){.
24fe0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 assert( pC
24ff0 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
25000 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b || pCur->apPage[
25010 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
25020 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ell==0 );.
25030 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d *pRes = 1;. }
25040 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 else{. asse
25050 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 rt( pCur->apPage
25060 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
25070 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 20 20 Cell>0 );.
25080 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 *pRes = 0;.
25090 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 74 rc = moveToLeft
250a0 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 most(pCur);.
250b0 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
250c0 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 c;.}../* Move th
250d0 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 e cursor to the
250e0 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 last entry in th
250f0 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e e table. Return
25100 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e SQLITE_OK.** on
25110 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a success. Set *
25120 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 pRes to 0 if the
25130 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 cursor actually
25140 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 points to somet
25150 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a hing.** or set *
25160 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 pRes to 1 if the
25170 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e table is empty.
25180 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
25190 74 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 6f treeLast(BtCurso
251a0 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
251b0 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 es){. int rc;.
251c0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
251d0 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
251e0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
251f0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
25200 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e d(pCur->pBtree->
25210 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 db->mutex) );..
25220 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 6f /* If the curso
25230 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 73 r already points
25240 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 to the last ent
25250 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f ry, this is a no
25260 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 55 -op. */. if( CU
25270 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 RSOR_VALID==pCur
25280 2d 3e 65 53 74 61 74 65 20 26 26 20 70 43 75 72 ->eState && pCur
25290 2d 3e 61 74 4c 61 73 74 20 29 7b 0a 23 69 66 64 ->atLast ){.#ifd
252a0 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
252b0 20 20 20 20 2f 2a 20 54 68 69 73 20 62 6c 6f 63 /* This bloc
252c0 6b 20 73 65 72 76 65 73 20 74 6f 20 61 73 73 65 k serves to asse
252d0 72 74 28 29 20 74 68 61 74 20 74 68 65 20 63 75 rt() that the cu
252e0 72 73 6f 72 20 72 65 61 6c 6c 79 20 64 6f 65 73 rsor really does
252f0 20 70 6f 69 6e 74 20 0a 20 20 20 20 2a 2a 20 74 point . ** t
25300 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 79 o the last entry
25310 20 69 6e 20 74 68 65 20 62 2d 74 72 65 65 2e 20 in the b-tree.
25320 2a 2f 0a 20 20 20 20 69 6e 74 20 69 69 3b 0a 20 */. int ii;.
25330 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c for(ii=0; ii<
25340 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 69 2b pCur->iPage; ii+
25350 2b 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 +){. assert
25360 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 69 ( pCur->aiIdx[ii
25370 5d 3d 3d 70 43 75 72 2d 3e 61 70 50 61 67 65 5b ]==pCur->apPage[
25380 69 69 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 ii]->nCell );.
25390 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 }. assert(
253a0 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
253b0 2d 3e 69 50 61 67 65 5d 3d 3d 70 43 75 72 2d 3e ->iPage]==pCur->
253c0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
253d0 67 65 5d 2d 3e 6e 43 65 6c 6c 2d 31 20 29 3b 0a ge]->nCell-1 );.
253e0 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
253f0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
25400 50 61 67 65 5d 2d 3e 6c 65 61 66 20 29 3b 0a 23 Page]->leaf );.#
25410 65 6e 64 69 66 0a 20 20 20 20 72 65 74 75 72 6e endif. return
25420 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
25430 0a 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f . rc = moveToRo
25440 6f 74 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 ot(pCur);. if(
25450 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
25460 0a 20 20 20 20 69 66 28 20 43 55 52 53 4f 52 5f . if( CURSOR_
25470 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 INVALID==pCur->e
25480 53 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 61 State ){. a
25490 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e ssert( pCur->pgn
254a0 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 oRoot==0 || pCur
254b0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
254c0 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 Page]->nCell==0
254d0 29 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d );. *pRes =
254e0 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 1;. }else{.
254f0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
25500 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
25510 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 20 20 20 R_VALID );.
25520 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
25530 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 rc = moveToRig
25540 68 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 htmost(pCur);.
25550 20 20 20 20 70 43 75 72 2d 3e 61 74 4c 61 73 74 pCur->atLast
25560 20 3d 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b = rc==SQLITE_OK
25570 20 3f 31 3a 30 3b 0a 20 20 20 20 7d 0a 20 20 7d ?1:0;. }. }
25580 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
25590 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 ./* Move the cur
255a0 73 6f 72 20 73 6f 20 74 68 61 74 20 69 74 20 70 sor so that it p
255b0 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 6e 74 72 oints to an entr
255c0 79 20 6e 65 61 72 20 74 68 65 20 6b 65 79 20 0a y near the key .
255d0 2a 2a 20 73 70 65 63 69 66 69 65 64 20 62 79 20 ** specified by
255e0 70 49 64 78 4b 65 79 20 6f 72 20 69 6e 74 4b 65 pIdxKey or intKe
255f0 79 2e 20 20 20 52 65 74 75 72 6e 20 61 20 73 75 y. Return a su
25600 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a 2a 0a 2a ccess code..**.*
25610 2a 20 46 6f 72 20 49 4e 54 4b 45 59 20 74 61 62 * For INTKEY tab
25620 6c 65 73 2c 20 74 68 65 20 69 6e 74 4b 65 79 20 les, the intKey
25630 70 61 72 61 6d 65 74 65 72 20 69 73 20 75 73 65 parameter is use
25640 64 2e 20 20 70 49 64 78 4b 65 79 20 0a 2a 2a 20 d. pIdxKey .**
25650 6d 75 73 74 20 62 65 20 4e 55 4c 4c 2e 20 20 46 must be NULL. F
25660 6f 72 20 69 6e 64 65 78 20 74 61 62 6c 65 73 2c or index tables,
25670 20 70 49 64 78 4b 65 79 20 69 73 20 75 73 65 64 pIdxKey is used
25680 20 61 6e 64 20 69 6e 74 4b 65 79 0a 2a 2a 20 69 and intKey.** i
25690 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a 0a 2a 2a s ignored..**.**
256a0 20 49 66 20 61 6e 20 65 78 61 63 74 20 6d 61 74 If an exact mat
256b0 63 68 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c ch is not found,
256c0 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
256d0 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 6c 65 is always.** le
256e0 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ft pointing at a
256f0 20 6c 65 61 66 20 70 61 67 65 20 77 68 69 63 68 leaf page which
25700 20 77 6f 75 6c 64 20 68 6f 6c 64 20 74 68 65 20 would hold the
25710 65 6e 74 72 79 20 69 66 20 69 74 0a 2a 2a 20 77 entry if it.** w
25720 65 72 65 20 70 72 65 73 65 6e 74 2e 20 20 54 68 ere present. Th
25730 65 20 63 75 72 73 6f 72 20 6d 69 67 68 74 20 70 e cursor might p
25740 6f 69 6e 74 20 74 6f 20 61 6e 20 65 6e 74 72 79 oint to an entry
25750 20 74 68 61 74 20 63 6f 6d 65 73 0a 2a 2a 20 62 that comes.** b
25760 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 20 74 efore or after t
25770 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 6e he key..**.** An
25780 20 69 6e 74 65 67 65 72 20 69 73 20 77 72 69 74 integer is writ
25790 74 65 6e 20 69 6e 74 6f 20 2a 70 52 65 73 20 77 ten into *pRes w
257a0 68 69 63 68 20 69 73 20 74 68 65 20 72 65 73 75 hich is the resu
257b0 6c 74 20 6f 66 0a 2a 2a 20 63 6f 6d 70 61 72 69 lt of.** compari
257c0 6e 67 20 74 68 65 20 6b 65 79 20 77 69 74 68 20 ng the key with
257d0 74 68 65 20 65 6e 74 72 79 20 74 6f 20 77 68 69 the entry to whi
257e0 63 68 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 ch the cursor is
257f0 20 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 20 .** pointing.
25800 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 The meaning of t
25810 68 65 20 69 6e 74 65 67 65 72 20 77 72 69 74 74 he integer writt
25820 65 6e 20 69 6e 74 6f 0a 2a 2a 20 2a 70 52 65 73 en into.** *pRes
25830 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a is as follows:.
25840 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3c **.** *pRes<
25850 30 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 0 The curso
25860 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
25870 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
25880 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
25890 20 20 20 20 20 20 20 20 69 73 20 73 6d 61 6c 6c is small
258a0 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 er than intKey/p
258b0 49 64 78 4b 65 79 20 6f 72 20 69 66 20 74 68 65 IdxKey or if the
258c0 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 0a table is empty.
258d0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
258e0 20 20 20 20 61 6e 64 20 74 68 65 20 63 75 72 73 and the curs
258f0 6f 72 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 or is therefore
25900 6c 65 66 74 20 70 6f 69 6e 74 20 74 6f 20 6e 6f left point to no
25910 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 thing..**.**
25920 20 2a 70 52 65 73 3d 3d 30 20 20 20 20 20 54 68 *pRes==0 Th
25930 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
25940 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 pointing at an
25950 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 entry that.**
25960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 e
25970 78 61 63 74 6c 79 20 6d 61 74 63 68 65 73 20 69 xactly matches i
25980 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a ntKey/pIdxKey..*
25990 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3e 30 *.** *pRes>0
259a0 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 The cursor
259b0 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e is left pointin
259c0 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 g at an entry th
259d0 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 at.**
259e0 20 20 20 20 20 20 20 69 73 20 6c 61 72 67 65 72 is larger
259f0 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 64 than intKey/pId
25a00 78 4b 65 79 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 xKey..**.*/.int
25a10 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 sqlite3BtreeMove
25a20 74 6f 55 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 toUnpacked(. Bt
25a30 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 Cursor *pCur,
25a40 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 /* The cu
25a50 72 73 6f 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 rsor to be moved
25a60 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 */. UnpackedRe
25a70 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f cord *pIdxKey, /
25a80 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 * Unpacked index
25a90 20 6b 65 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e key */. i64 in
25aa0 74 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 tKey,
25ab0 20 20 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 /* The table
25ac0 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 key */. int bia
25ad0 73 52 69 67 68 74 2c 20 20 20 20 20 20 20 20 20 sRight,
25ae0 20 20 2f 2a 20 49 66 20 74 72 75 65 2c 20 62 69 /* If true, bi
25af0 61 73 20 74 68 65 20 73 65 61 72 63 68 20 74 6f as the search to
25b00 20 74 68 65 20 68 69 67 68 20 65 6e 64 20 2a 2f the high end */
25b10 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 20 20 20 . int *pRes
25b20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
25b30 72 69 74 65 20 73 65 61 72 63 68 20 72 65 73 75 rite search resu
25b40 6c 74 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 lts here */.){.
25b50 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
25b60 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
25b70 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
25b80 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
25b90 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
25ba0 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
25bb0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
25bc0 20 70 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 pRes );. asser
25bd0 74 28 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d t( (pIdxKey==0)=
25be0 3d 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f =(pCur->pKeyInfo
25bf0 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 ==0) );.. /* If
25c00 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 the cursor is a
25c10 6c 72 65 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 lready positione
25c20 64 20 61 74 20 74 68 65 20 70 6f 69 6e 74 20 77 d at the point w
25c30 65 20 61 72 65 20 74 72 79 69 6e 67 0a 20 20 2a e are trying. *
25c40 2a 20 74 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 * to move to, th
25c50 65 6e 20 6a 75 73 74 20 72 65 74 75 72 6e 20 77 en just return w
25c60 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 ithout doing any
25c70 20 77 6f 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 work */. if( p
25c80 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
25c90 53 4f 52 5f 56 41 4c 49 44 20 26 26 20 70 43 75 SOR_VALID && pCu
25ca0 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 0a 20 20 r->validNKey .
25cb0 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 65 && pCur->apPage
25cc0 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 0a 20 20 29 [0]->intKey . )
25cd0 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e {. if( pCur->
25ce0 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e 74 4b 65 info.nKey==intKe
25cf0 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 73 y ){. *pRes
25d00 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 75 = 0;. retu
25d10 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
25d20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 }. if( pCur
25d30 2d 3e 61 74 4c 61 73 74 20 26 26 20 70 43 75 72 ->atLast && pCur
25d40 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3c 69 6e 74 4b ->info.nKey<intK
25d50 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 ey ){. *pRe
25d60 73 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 72 65 s = -1;. re
25d70 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
25d80 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 63 20 }. }.. rc
25d90 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 = moveToRoot(pCu
25da0 72 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a r);. if( rc ){.
25db0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
25dc0 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 }. assert( pCu
25dd0 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c r->pgnoRoot==0 |
25de0 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 | pCur->apPage[p
25df0 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 Cur->iPage] );.
25e00 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 assert( pCur->p
25e10 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 gnoRoot==0 || pC
25e20 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
25e30 3e 69 50 61 67 65 5d 2d 3e 69 73 49 6e 69 74 20 >iPage]->isInit
25e40 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
25e50 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
25e60 52 5f 49 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 R_INVALID || pCu
25e70 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
25e80 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 iPage]->nCell>0
25e90 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 );. if( pCur->e
25ea0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e State==CURSOR_IN
25eb0 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a 70 52 VALID ){. *pR
25ec0 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 61 73 73 es = -1;. ass
25ed0 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 ert( pCur->pgnoR
25ee0 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e oot==0 || pCur->
25ef0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
25f00 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b ge]->nCell==0 );
25f10 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
25f20 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 TE_OK;. }. ass
25f30 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 ert( pCur->apPag
25f40 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 e[0]->intKey ||
25f50 70 49 64 78 4b 65 79 20 29 3b 0a 20 20 66 6f 72 pIdxKey );. for
25f60 28 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 77 (;;){. int lw
25f70 72 2c 20 75 70 72 2c 20 69 64 78 3b 0a 20 20 20 r, upr, idx;.
25f80 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b 0a 20 20 Pgno chldPg;.
25f90 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
25fa0 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
25fb0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
25fc0 20 20 69 6e 74 20 63 3b 0a 0a 20 20 20 20 2f 2a int c;.. /*
25fd0 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 6d 75 pPage->nCell mu
25fe0 73 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 st be greater th
25ff0 61 6e 20 7a 65 72 6f 2e 20 49 66 20 74 68 69 73 an zero. If this
26000 20 69 73 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 is the root-pag
26010 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 75 72 e. ** the cur
26020 73 6f 72 20 77 6f 75 6c 64 20 68 61 76 65 20 62 sor would have b
26030 65 65 6e 20 49 4e 56 41 4c 49 44 20 61 62 6f 76 een INVALID abov
26040 65 20 61 6e 64 20 74 68 69 73 20 66 6f 72 28 3b e and this for(;
26050 3b 29 20 6c 6f 6f 70 0a 20 20 20 20 2a 2a 20 6e ;) loop. ** n
26060 6f 74 20 72 75 6e 2e 20 49 66 20 74 68 69 73 20 ot run. If this
26070 69 73 20 6e 6f 74 20 74 68 65 20 72 6f 6f 74 2d is not the root-
26080 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 6d page, then the m
26090 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 72 6f 75 oveToChild() rou
260a0 74 69 6e 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c tine. ** woul
260b0 64 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 64 d have already d
260c0 65 74 65 63 74 65 64 20 64 62 20 63 6f 72 72 75 etected db corru
260d0 70 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 72 6c 79 ption. Similarly
260e0 2c 20 70 50 61 67 65 20 6d 75 73 74 0a 20 20 20 , pPage must.
260f0 20 2a 2a 20 62 65 20 74 68 65 20 72 69 67 68 74 ** be the right
26100 20 6b 69 6e 64 20 28 69 6e 64 65 78 20 6f 72 20 kind (index or
26110 74 61 62 6c 65 29 20 6f 66 20 62 2d 74 72 65 65 table) of b-tree
26120 20 70 61 67 65 2e 20 4f 74 68 65 72 77 69 73 65 page. Otherwise
26130 0a 20 20 20 20 2a 2a 20 61 20 6d 6f 76 65 54 6f . ** a moveTo
26140 43 68 69 6c 64 28 29 20 6f 72 20 6d 6f 76 65 54 Child() or moveT
26150 6f 52 6f 6f 74 28 29 20 63 61 6c 6c 20 77 6f 75 oRoot() call wou
26160 6c 64 20 68 61 76 65 20 64 65 74 65 63 74 65 64 ld have detected
26170 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 2a 2f corruption. */
26180 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
26190 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 ge->nCell>0 );.
261a0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
261b0 2d 3e 69 6e 74 4b 65 79 3d 3d 28 70 49 64 78 4b ->intKey==(pIdxK
261c0 65 79 3d 3d 30 29 20 29 3b 0a 20 20 20 20 6c 77 ey==0) );. lw
261d0 72 20 3d 20 30 3b 0a 20 20 20 20 75 70 72 20 3d r = 0;. upr =
261e0 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d 31 3b pPage->nCell-1;
261f0 0a 20 20 20 20 69 66 28 20 62 69 61 73 52 69 67 . if( biasRig
26200 68 74 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 ht ){. pCur
26210 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
26220 61 67 65 5d 20 3d 20 28 75 31 36 29 28 69 64 78 age] = (u16)(idx
26230 20 3d 20 75 70 72 29 3b 0a 20 20 20 20 7d 65 6c = upr);. }el
26240 73 65 7b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e se{. pCur->
26250 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
26260 65 5d 20 3d 20 28 75 31 36 29 28 69 64 78 20 3d e] = (u16)(idx =
26270 20 28 75 70 72 2b 6c 77 72 29 2f 32 29 3b 0a 20 (upr+lwr)/2);.
26280 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 3b 3b 29 }. for(;;)
26290 7b 0a 20 20 20 20 20 20 75 38 20 2a 70 43 65 6c {. u8 *pCel
262a0 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l;
262b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
262c0 6f 69 6e 74 65 72 20 74 6f 20 63 75 72 72 65 6e ointer to curren
262d0 74 20 63 65 6c 6c 20 69 6e 20 70 50 61 67 65 20 t cell in pPage
262e0 2a 2f 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 */.. assert
262f0 28 20 69 64 78 3d 3d 70 43 75 72 2d 3e 61 69 49 ( idx==pCur->aiI
26300 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 dx[pCur->iPage]
26310 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 69 );. pCur->i
26320 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
26330 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 66 69 6e pCell = fin
26340 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 64 78 dCell(pPage, idx
26350 29 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 ) + pPage->child
26360 50 74 72 53 69 7a 65 3b 0a 20 20 20 20 20 20 69 PtrSize;. i
26370 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 f( pPage->intKey
26380 20 29 7b 0a 20 20 20 20 20 20 20 20 69 36 34 20 ){. i64
26390 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 nCellKey;.
263a0 20 20 69 66 28 20 70 50 61 67 65 2d 3e 68 61 73 if( pPage->has
263b0 44 61 74 61 20 29 7b 0a 20 20 20 20 20 20 20 20 Data ){.
263c0 20 20 75 33 32 20 64 75 6d 6d 79 3b 0a 20 20 20 u32 dummy;.
263d0 20 20 20 20 20 20 20 70 43 65 6c 6c 20 2b 3d 20 pCell +=
263e0 67 65 74 56 61 72 69 6e 74 33 32 28 70 43 65 6c getVarint32(pCel
263f0 6c 2c 20 64 75 6d 6d 79 29 3b 0a 20 20 20 20 20 l, dummy);.
26400 20 20 20 7d 0a 20 20 20 20 20 20 20 20 67 65 74 }. get
26410 56 61 72 69 6e 74 28 70 43 65 6c 6c 2c 20 28 75 Varint(pCell, (u
26420 36 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 64*)&nCellKey);.
26430 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c if( nCel
26440 6c 4b 65 79 3d 3d 69 6e 74 4b 65 79 20 29 7b 0a lKey==intKey ){.
26450 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 30 3b c = 0;
26460 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
26470 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 69 6e 74 4b f( nCellKey<intK
26480 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ey ){.
26490 63 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 20 20 c = -1;.
264a0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
264b0 20 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 4b 65 assert( nCellKe
264c0 79 3e 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 y>intKey );.
264d0 20 20 20 20 20 20 63 20 3d 20 2b 31 3b 0a 20 20 c = +1;.
264e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
264f0 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 pCur->validNKey
26500 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 70 43 75 = 1;. pCu
26510 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 20 3d 20 6e r->info.nKey = n
26520 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 7d CellKey;. }
26530 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a else{. /*
26540 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 73 75 70 The maximum sup
26550 70 6f 72 74 65 64 20 70 61 67 65 2d 73 69 7a 65 ported page-size
26560 20 69 73 20 36 35 35 33 36 20 62 79 74 65 73 2e is 65536 bytes.
26570 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 This means that
26580 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 . ** the
26590 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f maximum number o
265a0 66 20 72 65 63 6f 72 64 20 62 79 74 65 73 20 73 f record bytes s
265b0 74 6f 72 65 64 20 6f 6e 20 61 6e 20 69 6e 64 65 tored on an inde
265c0 78 20 42 2d 54 72 65 65 0a 20 20 20 20 20 20 20 x B-Tree.
265d0 20 2a 2a 20 70 61 67 65 20 69 73 20 6c 65 73 73 ** page is less
265e0 20 74 68 61 6e 20 31 36 33 38 34 20 62 79 74 65 than 16384 byte
265f0 73 20 61 6e 64 20 6d 61 79 20 62 65 20 73 74 6f s and may be sto
26600 72 65 64 20 61 73 20 61 20 32 2d 62 79 74 65 0a red as a 2-byte.
26610 20 20 20 20 20 20 20 20 2a 2a 20 76 61 72 69 6e ** varin
26620 74 2e 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 t. This informat
26630 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 ion is used to a
26640 74 74 65 6d 70 74 20 74 6f 20 61 76 6f 69 64 20 ttempt to avoid
26650 70 61 72 73 69 6e 67 20 0a 20 20 20 20 20 20 20 parsing .
26660 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 ** the entire c
26670 65 6c 6c 20 62 79 20 63 68 65 63 6b 69 6e 67 20 ell by checking
26680 66 6f 72 20 74 68 65 20 63 61 73 65 73 20 77 68 for the cases wh
26690 65 72 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 ere the record i
266a0 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 s . ** st
266b0 6f 72 65 64 20 65 6e 74 69 72 65 6c 79 20 77 69 ored entirely wi
266c0 74 68 69 6e 20 74 68 65 20 62 2d 74 72 65 65 20 thin the b-tree
266d0 70 61 67 65 20 62 79 20 69 6e 73 70 65 63 74 69 page by inspecti
266e0 6e 67 20 74 68 65 20 66 69 72 73 74 20 0a 20 20 ng the first .
266f0 20 20 20 20 20 20 2a 2a 20 32 20 62 79 74 65 73 ** 2 bytes
26700 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a 20 20 of the cell..
26710 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
26720 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 70 43 65 int nCell = pCe
26730 6c 6c 5b 30 5d 3b 0a 20 20 20 20 20 20 20 20 69 ll[0];. i
26740 66 28 20 6e 43 65 6c 6c 3c 3d 70 50 61 67 65 2d f( nCell<=pPage-
26750 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 >max1bytePayload
26760 0a 20 20 20 20 20 20 20 20 20 2f 2a 20 26 26 20 . /* &&
26770 28 70 43 65 6c 6c 2b 6e 43 65 6c 6c 29 3c 70 50 (pCell+nCell)<pP
26780 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 2a 2f age->aDataEnd */
26790 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 . ){.
267a0 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 /* This br
267b0 61 6e 63 68 20 72 75 6e 73 20 69 66 20 74 68 65 anch runs if the
267c0 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 69 65 record-size fie
267d0 6c 64 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 69 ld of the cell i
267e0 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 2a 2a s a. **
267f0 20 73 69 6e 67 6c 65 20 62 79 74 65 20 76 61 72 single byte var
26800 69 6e 74 20 61 6e 64 20 74 68 65 20 72 65 63 6f int and the reco
26810 72 64 20 66 69 74 73 20 65 6e 74 69 72 65 6c 79 rd fits entirely
26820 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 20 20 on the main.
26830 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 65 65 ** b-tree
26840 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 page. */.
26850 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 testcase( p
26860 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d 70 50 Cell+nCell+1==pP
26870 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b age->aDataEnd );
26880 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 73 . c = s
26890 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 qlite3VdbeRecord
268a0 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 28 Compare(nCell, (
268b0 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 31 5d 2c void*)&pCell[1],
268c0 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 pIdxKey);.
268d0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 21 28 70 }else if( !(p
268e0 43 65 6c 6c 5b 31 5d 20 26 20 30 78 38 30 29 20 Cell[1] & 0x80)
268f0 0a 20 20 20 20 20 20 20 20 20 20 26 26 20 28 6e . && (n
26900 43 65 6c 6c 20 3d 20 28 28 6e 43 65 6c 6c 26 30 Cell = ((nCell&0
26910 78 37 66 29 3c 3c 37 29 20 2b 20 70 43 65 6c 6c x7f)<<7) + pCell
26920 5b 31 5d 29 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 [1])<=pPage->max
26930 4c 6f 63 61 6c 0a 20 20 20 20 20 20 20 20 20 20 Local.
26940 2f 2a 20 26 26 20 28 70 43 65 6c 6c 2b 6e 43 65 /* && (pCell+nCe
26950 6c 6c 2b 32 29 3c 3d 70 50 61 67 65 2d 3e 61 44 ll+2)<=pPage->aD
26960 61 74 61 45 6e 64 20 2a 2f 0a 20 20 20 20 20 20 ataEnd */.
26970 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f ){. /
26980 2a 20 54 68 65 20 72 65 63 6f 72 64 2d 73 69 7a * The record-siz
26990 65 20 66 69 65 6c 64 20 69 73 20 61 20 32 20 62 e field is a 2 b
269a0 79 74 65 20 76 61 72 69 6e 74 20 61 6e 64 20 74 yte varint and t
269b0 68 65 20 72 65 63 6f 72 64 20 0a 20 20 20 20 20 he record .
269c0 20 20 20 20 20 2a 2a 20 66 69 74 73 20 65 6e 74 ** fits ent
269d0 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 irely on the mai
269e0 6e 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 20 n b-tree page.
269f0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 */. tes
26a00 74 63 61 73 65 28 20 70 43 65 6c 6c 2b 6e 43 65 tcase( pCell+nCe
26a10 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d 3e 61 44 61 ll+2==pPage->aDa
26a20 74 61 45 6e 64 20 29 3b 0a 20 20 20 20 20 20 20 taEnd );.
26a30 20 20 20 63 20 3d 20 73 71 6c 69 74 65 33 56 64 c = sqlite3Vd
26a40 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 beRecordCompare(
26a50 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 nCell, (void*)&p
26a60 43 65 6c 6c 5b 32 5d 2c 20 70 49 64 78 4b 65 79 Cell[2], pIdxKey
26a70 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 );. }else
26a80 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 {. /* T
26a90 68 65 20 72 65 63 6f 72 64 20 66 6c 6f 77 73 20 he record flows
26aa0 6f 76 65 72 20 6f 6e 74 6f 20 6f 6e 65 20 6f 72 over onto one or
26ab0 20 6d 6f 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 more overflow p
26ac0 61 67 65 73 2e 20 49 6e 0a 20 20 20 20 20 20 20 ages. In.
26ad0 20 20 20 2a 2a 20 74 68 69 73 20 63 61 73 65 20 ** this case
26ae0 74 68 65 20 77 68 6f 6c 65 20 63 65 6c 6c 20 6e the whole cell n
26af0 65 65 64 73 20 74 6f 20 62 65 20 70 61 72 73 65 eeds to be parse
26b00 64 2c 20 61 20 62 75 66 66 65 72 20 61 6c 6c 6f d, a buffer allo
26b10 63 61 74 65 64 0a 20 20 20 20 20 20 20 20 20 20 cated.
26b20 2a 2a 20 61 6e 64 20 61 63 63 65 73 73 50 61 79 ** and accessPay
26b30 6c 6f 61 64 28 29 20 75 73 65 64 20 74 6f 20 72 load() used to r
26b40 65 74 72 69 65 76 65 20 74 68 65 20 72 65 63 6f etrieve the reco
26b50 72 64 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 rd into the.
26b60 20 20 20 20 20 20 2a 2a 20 62 75 66 66 65 72 20 ** buffer
26b70 62 65 66 6f 72 65 20 56 64 62 65 52 65 63 6f 72 before VdbeRecor
26b80 64 43 6f 6d 70 61 72 65 28 29 20 63 61 6e 20 62 dCompare() can b
26b90 65 20 63 61 6c 6c 65 64 2e 20 2a 2f 0a 20 20 20 e called. */.
26ba0 20 20 20 20 20 20 20 76 6f 69 64 20 2a 70 43 65 void *pCe
26bb0 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 llKey;.
26bc0 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 43 65 6c u8 * const pCel
26bd0 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c 20 2d 20 lBody = pCell -
26be0 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
26bf0 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 20 20 62 ize;. b
26c00 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
26c10 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 42 6f 64 (pPage, pCellBod
26c20 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b y, &pCur->info);
26c30 0a 20 20 20 20 20 20 20 20 20 20 6e 43 65 6c 6c . nCell
26c40 20 3d 20 28 69 6e 74 29 70 43 75 72 2d 3e 69 6e = (int)pCur->in
26c50 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 20 20 20 fo.nKey;.
26c60 20 20 20 70 43 65 6c 6c 4b 65 79 20 3d 20 73 71 pCellKey = sq
26c70 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 lite3Malloc( nCe
26c80 6c 6c 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ll );.
26c90 69 66 28 20 70 43 65 6c 6c 4b 65 79 3d 3d 30 20 if( pCellKey==0
26ca0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 ){. r
26cb0 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
26cc0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f ;. go
26cd0 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 to moveto_finish
26ce0 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
26cf0 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 63 63 rc = acc
26d00 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c essPayload(pCur,
26d10 20 30 2c 20 6e 43 65 6c 6c 2c 20 28 75 6e 73 69 0, nCell, (unsi
26d20 67 6e 65 64 20 63 68 61 72 2a 29 70 43 65 6c 6c gned char*)pCell
26d30 4b 65 79 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 Key, 0);.
26d40 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 if( rc ){.
26d50 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
26d60 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3b _free(pCellKey);
26d70 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 . got
26d80 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b o moveto_finish;
26d90 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
26da0 20 20 20 20 20 20 20 63 20 3d 20 73 71 6c 69 74 c = sqlit
26db0 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 e3VdbeRecordComp
26dc0 61 72 65 28 6e 43 65 6c 6c 2c 20 70 43 65 6c 6c are(nCell, pCell
26dd0 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 Key, pIdxKey);.
26de0 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
26df0 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3b _free(pCellKey);
26e00 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
26e10 20 7d 0a 20 20 20 20 20 20 69 66 28 20 63 3d 3d }. if( c==
26e20 30 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 0 ){. if(
26e30 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 pPage->intKey &
26e40 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 & !pPage->leaf )
26e50 7b 0a 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 {. lwr
26e60 3d 20 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 = idx;.
26e70 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
26e80 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
26e90 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
26ea0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
26eb0 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 E_OK;.
26ec0 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 goto moveto_fini
26ed0 73 68 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 sh;. }.
26ee0 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
26ef0 63 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20 6c c<0 ){. l
26f00 77 72 20 3d 20 69 64 78 2b 31 3b 0a 20 20 20 20 wr = idx+1;.
26f10 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
26f20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 upr = idx-1;.
26f30 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
26f40 6c 77 72 3e 75 70 72 20 29 7b 0a 20 20 20 20 20 lwr>upr ){.
26f50 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
26f60 7d 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 61 69 }. pCur->ai
26f70 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
26f80 20 3d 20 28 75 31 36 29 28 69 64 78 20 3d 20 28 = (u16)(idx = (
26f90 6c 77 72 2b 75 70 72 29 2f 32 29 3b 0a 20 20 20 lwr+upr)/2);.
26fa0 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 6c }. assert( l
26fb0 77 72 3d 3d 75 70 72 2b 31 20 7c 7c 20 28 70 50 wr==upr+1 || (pP
26fc0 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 20 21 age->intKey && !
26fd0 70 50 61 67 65 2d 3e 6c 65 61 66 29 20 29 3b 0a pPage->leaf) );.
26fe0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
26ff0 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 20 20 20 e->isInit );.
27000 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 if( pPage->leaf
27010 20 29 7b 0a 20 20 20 20 20 20 63 68 6c 64 50 67 ){. chldPg
27020 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 = 0;. }else
27030 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d 3e if( lwr>=pPage->
27040 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 63 nCell ){. c
27050 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 hldPg = get4byte
27060 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
27070 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
27080 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 8]);. }else{.
27090 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 67 chldPg = g
270a0 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
270b0 28 70 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a 20 (pPage, lwr));.
270c0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 63 68 6c }. if( chl
270d0 64 50 67 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 dPg==0 ){.
270e0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
270f0 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
27100 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 <pCur->apPage[pC
27110 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c ur->iPage]->nCel
27120 6c 20 29 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 l );. *pRes
27130 20 3d 20 63 3b 0a 20 20 20 20 20 20 72 63 20 3d = c;. rc =
27140 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
27150 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 goto moveto_fi
27160 6e 69 73 68 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nish;. }.
27170 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
27180 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 ->iPage] = (u16)
27190 6c 77 72 3b 0a 20 20 20 20 70 43 75 72 2d 3e 69 lwr;. pCur->i
271a0 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
271b0 20 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b pCur->validNK
271c0 65 79 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d ey = 0;. rc =
271d0 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 moveToChild(pCu
271e0 72 2c 20 63 68 6c 64 50 67 29 3b 0a 20 20 20 20 r, chldPg);.
271f0 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 6d 6f if( rc ) goto mo
27200 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 7d veto_finish;. }
27210 0a 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3a 0a .moveto_finish:.
27220 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
27230 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 ./*.** Return TR
27240 55 45 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 UE if the cursor
27250 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 69 6e 67 is not pointing
27260 20 61 74 20 61 6e 20 65 6e 74 72 79 20 6f 66 20 at an entry of
27270 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a the table..**.**
27280 20 54 52 55 45 20 77 69 6c 6c 20 62 65 20 72 65 TRUE will be re
27290 74 75 72 6e 65 64 20 61 66 74 65 72 20 61 20 63 turned after a c
272a0 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74 all to sqlite3Bt
272b0 72 65 65 4e 65 78 74 28 29 20 6d 6f 76 65 73 0a reeNext() moves.
272c0 2a 2a 20 70 61 73 74 20 74 68 65 20 6c 61 73 74 ** past the last
272d0 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 entry in the ta
272e0 62 6c 65 20 6f 72 20 73 71 6c 69 74 65 33 42 74 ble or sqlite3Bt
272f0 72 65 65 50 72 65 76 28 29 20 6d 6f 76 65 73 20 reePrev() moves
27300 70 61 73 74 0a 2a 2a 20 74 68 65 20 66 69 72 73 past.** the firs
27310 74 20 65 6e 74 72 79 2e 20 20 54 52 55 45 20 69 t entry. TRUE i
27320 73 20 61 6c 73 6f 20 72 65 74 75 72 6e 65 64 20 s also returned
27330 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 73 20 if the table is
27340 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 empty..*/.int sq
27350 6c 69 74 65 33 42 74 72 65 65 45 6f 66 28 42 74 lite3BtreeEof(Bt
27360 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
27370 20 2f 2a 20 54 4f 44 4f 3a 20 57 68 61 74 20 69 /* TODO: What i
27380 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 f the cursor is
27390 69 6e 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 in CURSOR_REQUIR
273a0 45 53 45 45 4b 20 62 75 74 20 61 6c 6c 20 74 61 ESEEK but all ta
273b0 62 6c 65 20 65 6e 74 72 69 65 73 0a 20 20 2a 2a ble entries. **
273c0 20 68 61 76 65 20 62 65 65 6e 20 64 65 6c 65 74 have been delet
273d0 65 64 3f 20 54 68 69 73 20 41 50 49 20 77 69 6c ed? This API wil
273e0 6c 20 6e 65 65 64 20 74 6f 20 63 68 61 6e 67 65 l need to change
273f0 20 74 6f 20 72 65 74 75 72 6e 20 61 6e 20 65 72 to return an er
27400 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a 20 61 73 ror code. ** as
27410 20 77 65 6c 6c 20 61 73 20 74 68 65 20 62 6f 6f well as the boo
27420 6c 65 61 6e 20 72 65 73 75 6c 74 20 76 61 6c 75 lean result valu
27430 65 2e 0a 20 20 2a 2f 0a 20 20 72 65 74 75 72 6e e.. */. return
27440 20 28 43 55 52 53 4f 52 5f 56 41 4c 49 44 21 3d (CURSOR_VALID!=
27450 70 43 75 72 2d 3e 65 53 74 61 74 65 29 3b 0a 7d pCur->eState);.}
27460 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e 63 65 20 ../*.** Advance
27470 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 the cursor to th
27480 65 20 6e 65 78 74 20 65 6e 74 72 79 20 69 6e 20 e next entry in
27490 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 the database. I
274a0 66 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 20 f.** successful
274b0 74 68 65 6e 20 73 65 74 20 2a 70 52 65 73 3d 30 then set *pRes=0
274c0 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 . If the cursor
274d0 0a 2a 2a 20 77 61 73 20 61 6c 72 65 61 64 79 20 .** was already
274e0 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 pointing to the
274f0 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 last entry in th
27500 65 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 e database befor
27510 65 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e e.** this routin
27520 65 20 77 61 73 20 63 61 6c 6c 65 64 2c 20 74 68 e was called, th
27530 65 6e 20 73 65 74 20 2a 70 52 65 73 3d 31 2e 0a en set *pRes=1..
27540 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
27550 72 65 65 4e 65 78 74 28 42 74 43 75 72 73 6f 72 reeNext(BtCursor
27560 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 *pCur, int *pRe
27570 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 s){. int rc;.
27580 69 6e 74 20 69 64 78 3b 0a 20 20 4d 65 6d 50 61 int idx;. MemPa
27590 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 61 73 ge *pPage;.. as
275a0 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
275b0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
275c0 20 20 61 73 73 65 72 74 28 20 70 52 65 73 21 3d assert( pRes!=
275d0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
275e0 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 Cur->skipNext==0
275f0 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 || pCur->eState
27600 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 !=CURSOR_VALID )
27610 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
27620 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
27630 49 44 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 72 ID ){. rc = r
27640 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 estoreCursorPosi
27650 74 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 tion(pCur);.
27660 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
27670 4b 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 73 K ){. *pRes
27680 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 75 = 0;. retu
27690 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
276a0 20 69 66 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 if( CURSOR_INVA
276b0 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 LID==pCur->eStat
276c0 65 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 73 e ){. *pRes
276d0 20 3d 20 31 3b 0a 20 20 20 20 20 20 72 65 74 75 = 1;. retu
276e0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
276f0 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 }. if( pCur
27700 2d 3e 73 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 ->skipNext ){.
27710 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
27720 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
27730 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e _VALID || pCur->
27740 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 eState==CURSOR_S
27750 4b 49 50 4e 45 58 54 20 29 3b 0a 20 20 20 20 20 KIPNEXT );.
27760 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
27770 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 CURSOR_VALID;.
27780 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b if( pCur->sk
27790 69 70 4e 65 78 74 3e 30 20 29 7b 0a 20 20 20 20 ipNext>0 ){.
277a0 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 pCur->skipNe
277b0 78 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 xt = 0;.
277c0 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 *pRes = 0;.
277d0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
277e0 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 _OK;. }.
277f0 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 pCur->skipNex
27800 74 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d t = 0;. }. }
27810 0a 0a 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 .. pPage = pCur
27820 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
27830 50 61 67 65 5d 3b 0a 20 20 69 64 78 20 3d 20 2b Page];. idx = +
27840 2b 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 +pCur->aiIdx[pCu
27850 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 61 73 73 r->iPage];. ass
27860 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e ert( pPage->isIn
27870 69 74 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 it );.. /* If t
27880 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
27890 20 69 73 20 63 6f 72 72 75 70 74 2c 20 69 74 20 is corrupt, it
278a0 69 73 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 is possible for
278b0 74 68 65 20 76 61 6c 75 65 20 6f 66 20 69 64 78 the value of idx
278c0 20 0a 20 20 2a 2a 20 74 6f 20 62 65 20 69 6e 76 . ** to be inv
278d0 61 6c 69 64 20 68 65 72 65 2e 20 54 68 69 73 20 alid here. This
278e0 63 61 6e 20 6f 6e 6c 79 20 6f 63 63 75 72 20 69 can only occur i
278f0 66 20 61 20 73 65 63 6f 6e 64 20 63 75 72 73 6f f a second curso
27900 72 20 6d 6f 64 69 66 69 65 73 0a 20 20 2a 2a 20 r modifies. **
27910 74 68 65 20 70 61 67 65 20 77 68 69 6c 65 20 63 the page while c
27920 75 72 73 6f 72 20 70 43 75 72 20 69 73 20 68 6f ursor pCur is ho
27930 6c 64 69 6e 67 20 61 20 72 65 66 65 72 65 6e 63 lding a referenc
27940 65 20 74 6f 20 69 74 2e 20 57 68 69 63 68 20 63 e to it. Which c
27950 61 6e 0a 20 20 2a 2a 20 6f 6e 6c 79 20 68 61 70 an. ** only hap
27960 70 65 6e 20 69 66 20 74 68 65 20 64 61 74 61 62 pen if the datab
27970 61 73 65 20 69 73 20 63 6f 72 72 75 70 74 20 69 ase is corrupt i
27980 6e 20 73 75 63 68 20 61 20 77 61 79 20 61 73 20 n such a way as
27990 74 6f 20 6c 69 6e 6b 20 74 68 65 0a 20 20 2a 2a to link the. **
279a0 20 70 61 67 65 20 69 6e 74 6f 20 6d 6f 72 65 20 page into more
279b0 74 68 61 6e 20 6f 6e 65 20 62 2d 74 72 65 65 20 than one b-tree
279c0 73 74 72 75 63 74 75 72 65 2e 20 2a 2f 0a 20 20 structure. */.
279d0 74 65 73 74 63 61 73 65 28 20 69 64 78 3e 70 50 testcase( idx>pP
279e0 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 0a 20 age->nCell );..
279f0 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a pCur->info.nSiz
27a00 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 76 e = 0;. pCur->v
27a10 61 6c 69 64 4e 4b 65 79 20 3d 20 30 3b 0a 20 20 alidNKey = 0;.
27a20 69 66 28 20 69 64 78 3e 3d 70 50 61 67 65 2d 3e if( idx>=pPage->
27a30 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 69 66 28 nCell ){. if(
27a40 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
27a50 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 . rc = move
27a60 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 65 ToChild(pCur, ge
27a70 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 t4byte(&pPage->a
27a80 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f Data[pPage->hdrO
27a90 66 66 73 65 74 2b 38 5d 29 29 3b 0a 20 20 20 20 ffset+8]));.
27aa0 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
27ab0 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
27ac0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
27ad0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
27ae0 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 74 6d rc = moveToLeftm
27af0 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 20 ost(pCur);.
27b00 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
27b10 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
27b20 20 7d 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 }. do{.
27b30 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 if( pCur->iPage
27b40 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2a ==0 ){. *
27b50 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 pRes = 1;.
27b60 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
27b70 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
27b80 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
27b90 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 SQLITE_OK;.
27ba0 20 7d 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f 50 }. moveToP
27bb0 61 72 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 20 arent(pCur);.
27bc0 20 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 2d pPage = pCur-
27bd0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
27be0 61 67 65 5d 3b 0a 20 20 20 20 7d 77 68 69 6c 65 age];. }while
27bf0 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
27c00 75 72 2d 3e 69 50 61 67 65 5d 3e 3d 70 50 61 67 ur->iPage]>=pPag
27c10 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 e->nCell );.
27c20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 69 *pRes = 0;. i
27c30 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 f( pPage->intKey
27c40 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
27c50 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 qlite3BtreeNext(
27c60 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 20 pCur, pRes);.
27c70 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 }else{. rc
27c80 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
27c90 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 72 }. return r
27ca0 63 3b 0a 20 20 7d 0a 20 20 2a 70 52 65 73 20 3d c;. }. *pRes =
27cb0 20 30 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 0;. if( pPage-
27cc0 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 >leaf ){. ret
27cd0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
27ce0 20 7d 0a 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f }. rc = moveTo
27cf0 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a Leftmost(pCur);.
27d00 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
27d10 0a 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 20 ./*.** Step the
27d20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 61 cursor to the ba
27d30 63 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f ck to the previo
27d40 75 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 us entry in the
27d50 64 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a 2a database. If.**
27d60 20 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 6e successful then
27d70 20 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 49 set *pRes=0. I
27d80 66 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 f the cursor.**
27d90 77 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 6e was already poin
27da0 74 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72 73 ting to the firs
27db0 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 t entry in the d
27dc0 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a 2a atabase before.*
27dd0 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 * this routine w
27de0 61 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 as called, then
27df0 73 65 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2f 0a set *pRes=1..*/.
27e00 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
27e10 50 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 6f Previous(BtCurso
27e20 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
27e30 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 es){. int rc;.
27e40 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
27e50 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
27e60 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
27e70 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
27e80 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 pRes!=0 );. ass
27e90 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e ert( pCur->skipN
27ea0 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e ext==0 || pCur->
27eb0 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
27ec0 41 4c 49 44 20 29 3b 0a 20 20 70 43 75 72 2d 3e ALID );. pCur->
27ed0 61 74 4c 61 73 74 20 3d 20 30 3b 0a 20 20 69 66 atLast = 0;. if
27ee0 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d ( pCur->eState!=
27ef0 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a CURSOR_VALID ){.
27f00 20 20 20 20 69 66 28 20 41 4c 57 41 59 53 28 70 if( ALWAYS(p
27f10 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d 43 55 52 Cur->eState>=CUR
27f20 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 29 SOR_REQUIRESEEK)
27f30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 ){. rc = b
27f40 74 72 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f treeRestoreCurso
27f50 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b rPosition(pCur);
27f60 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
27f70 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
27f80 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
27f90 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
27fa0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
27fb0 20 20 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 if( CURSOR_I
27fc0 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 NVALID==pCur->eS
27fd0 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 2a 70 tate ){. *p
27fe0 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 72 Res = 1;. r
27ff0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
28000 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
28010 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 29 7b Cur->skipNext ){
28020 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
28030 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
28040 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 SOR_VALID || pCu
28050 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
28060 52 5f 53 4b 49 50 4e 45 58 54 20 29 3b 0a 20 20 R_SKIPNEXT );.
28070 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 pCur->eState
28080 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b = CURSOR_VALID;
28090 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
280a0 3e 73 6b 69 70 4e 65 78 74 3c 30 20 29 7b 0a 20 >skipNext<0 ){.
280b0 20 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 pCur->ski
280c0 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 20 pNext = 0;.
280d0 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
280e0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
280f0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a ITE_OK;. }.
28100 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 pCur->skip
28110 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 7d 0a Next = 0;. }.
28120 20 20 7d 0a 0a 20 20 70 50 61 67 65 20 3d 20 70 }.. pPage = p
28130 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
28140 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 61 73 73 65 ->iPage];. asse
28150 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 rt( pPage->isIni
28160 74 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 67 t );. if( !pPag
28170 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 69 e->leaf ){. i
28180 6e 74 20 69 64 78 20 3d 20 70 43 75 72 2d 3e 61 nt idx = pCur->a
28190 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
281a0 5d 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 ];. rc = move
281b0 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 65 ToChild(pCur, ge
281c0 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 t4byte(findCell(
281d0 70 50 61 67 65 2c 20 69 64 78 29 29 29 3b 0a 20 pPage, idx)));.
281e0 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 if( rc ){.
281f0 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
28200 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
28210 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 6d 6f }. rc = mo
28220 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 veToRightmost(pC
28230 75 72 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 ur);. }else{.
28240 20 20 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 while( pCur->a
28250 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
28260 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 ]==0 ){. if
28270 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3d 3d 30 ( pCur->iPage==0
28280 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 ){. pCur
28290 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f ->eState = CURSO
282a0 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 R_INVALID;.
282b0 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 *pRes = 1;.
282c0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
282d0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a ITE_OK;. }.
282e0 20 20 20 20 20 20 6d 6f 76 65 54 6f 50 61 72 65 moveToPare
282f0 6e 74 28 70 43 75 72 29 3b 0a 20 20 20 20 7d 0a nt(pCur);. }.
28300 20 20 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e pCur->info.n
28310 53 69 7a 65 20 3d 20 30 3b 0a 20 20 20 20 70 43 Size = 0;. pC
28320 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 ur->validNKey =
28330 30 3b 0a 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 0;.. pCur->ai
28340 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
28350 2d 2d 3b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 --;. pPage =
28360 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
28370 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 69 r->iPage];. i
28380 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 f( pPage->intKey
28390 20 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 && !pPage->leaf
283a0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
283b0 71 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 69 qlite3BtreePrevi
283c0 6f 75 73 28 70 43 75 72 2c 20 70 52 65 73 29 3b ous(pCur, pRes);
283d0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
283e0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
283f0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 ;. }. }. *p
28400 52 65 73 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 Res = 0;. retur
28410 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 n rc;.}../*.** A
28420 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 llocate a new pa
28430 67 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ge from the data
28440 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a base file..**.**
28450 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 69 73 The new page is
28460 20 6d 61 72 6b 65 64 20 61 73 20 64 69 72 74 79 marked as dirty
28470 2e 20 20 28 49 6e 20 6f 74 68 65 72 20 77 6f 72 . (In other wor
28480 64 73 2c 20 73 71 6c 69 74 65 33 50 61 67 65 72 ds, sqlite3Pager
28490 57 72 69 74 65 28 29 0a 2a 2a 20 68 61 73 20 61 Write().** has a
284a0 6c 72 65 61 64 79 20 62 65 65 6e 20 63 61 6c 6c lready been call
284b0 65 64 20 6f 6e 20 74 68 65 20 6e 65 77 20 70 61 ed on the new pa
284c0 67 65 2e 29 20 20 54 68 65 20 6e 65 77 20 70 61 ge.) The new pa
284d0 67 65 20 68 61 73 20 61 6c 73 6f 0a 2a 2a 20 62 ge has also.** b
284e0 65 65 6e 20 72 65 66 65 72 65 6e 63 65 64 20 61 een referenced a
284f0 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 72 nd the calling r
28500 6f 75 74 69 6e 65 20 69 73 20 72 65 73 70 6f 6e outine is respon
28510 73 69 62 6c 65 20 66 6f 72 20 63 61 6c 6c 69 6e sible for callin
28520 67 0a 2a 2a 20 73 71 6c 69 74 65 33 50 61 67 65 g.** sqlite3Page
28530 72 55 6e 72 65 66 28 29 20 6f 6e 20 74 68 65 20 rUnref() on the
28540 6e 65 77 20 70 61 67 65 20 77 68 65 6e 20 69 74 new page when it
28550 20 69 73 20 64 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 is done..**.**
28560 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
28570 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 73 urned on success
28580 2e 20 20 41 6e 79 20 6f 74 68 65 72 20 72 65 74 . Any other ret
28590 75 72 6e 20 76 61 6c 75 65 20 69 6e 64 69 63 61 urn value indica
285a0 74 65 73 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 2e tes.** an error.
285b0 20 20 2a 70 70 50 61 67 65 20 61 6e 64 20 2a 70 *ppPage and *p
285c0 50 67 6e 6f 20 61 72 65 20 75 6e 64 65 66 69 6e Pgno are undefin
285d0 65 64 20 69 6e 20 74 68 65 20 65 76 65 6e 74 20 ed in the event
285e0 6f 66 20 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a 20 of an error..**
285f0 44 6f 20 6e 6f 74 20 69 6e 76 6f 6b 65 20 73 71 Do not invoke sq
28600 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
28610 29 20 6f 6e 20 2a 70 70 50 61 67 65 20 69 66 20 ) on *ppPage if
28620 61 6e 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 an error is retu
28630 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 rned..**.** If t
28640 68 65 20 22 6e 65 61 72 62 79 22 20 70 61 72 61 he "nearby" para
28650 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 30 2c 20 meter is not 0,
28660 74 68 65 6e 20 61 6e 20 65 66 66 6f 72 74 20 69 then an effort i
28670 73 20 6d 61 64 65 20 74 6f 20 0a 2a 2a 20 6c 6f s made to .** lo
28680 63 61 74 65 20 61 20 70 61 67 65 20 63 6c 6f 73 cate a page clos
28690 65 20 74 6f 20 74 68 65 20 70 61 67 65 20 6e 75 e to the page nu
286a0 6d 62 65 72 20 22 6e 65 61 72 62 79 22 2e 20 20 mber "nearby".
286b0 54 68 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 This can be used
286c0 20 69 6e 20 61 6e 0a 2a 2a 20 61 74 74 65 6d 70 in an.** attemp
286d0 74 20 74 6f 20 6b 65 65 70 20 72 65 6c 61 74 65 t to keep relate
286e0 64 20 70 61 67 65 73 20 63 6c 6f 73 65 20 74 6f d pages close to
286f0 20 65 61 63 68 20 6f 74 68 65 72 20 69 6e 20 74 each other in t
28700 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
28710 2c 0a 2a 2a 20 77 68 69 63 68 20 69 6e 20 74 75 ,.** which in tu
28720 72 6e 20 63 61 6e 20 6d 61 6b 65 20 64 61 74 61 rn can make data
28730 62 61 73 65 20 61 63 63 65 73 73 20 66 61 73 74 base access fast
28740 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 er..**.** If the
28750 20 65 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 72 eMode parameter
28760 20 69 73 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 is BTALLOC_EXAC
28770 54 20 61 6e 64 20 74 68 65 20 6e 65 61 72 62 79 T and the nearby
28780 20 70 61 67 65 20 65 78 69 73 74 73 0a 2a 2a 20 page exists.**
28790 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 68 65 20 anywhere on the
287a0 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 20 free-list, then
287b0 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 it is guaranteed
287c0 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 2e to be returned.
287d0 20 20 49 66 0a 2a 2a 20 65 4d 6f 64 65 20 69 73 If.** eMode is
287e0 20 42 54 41 4c 4c 4f 43 5f 4c 54 20 74 68 65 6e BTALLOC_LT then
287f0 20 74 68 65 20 70 61 67 65 20 72 65 74 75 72 6e the page return
28800 65 64 20 77 69 6c 6c 20 62 65 20 6c 65 73 73 20 ed will be less
28810 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a than or equal.**
28820 20 74 6f 20 6e 65 61 72 62 79 20 69 66 20 61 6e to nearby if an
28830 79 20 73 75 63 68 20 70 61 67 65 20 65 78 69 73 y such page exis
28840 74 73 2e 20 20 49 66 20 65 4d 6f 64 65 20 69 73 ts. If eMode is
28850 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 74 68 65 BTALLOC_ANY the
28860 6e 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e n there.** are n
28870 6f 20 72 65 73 74 72 69 63 74 69 6f 6e 73 20 6f o restrictions o
28880 6e 20 77 68 69 63 68 20 70 61 67 65 20 69 73 20 n which page is
28890 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 returned..*/.sta
288a0 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 tic int allocate
288b0 42 74 72 65 65 50 61 67 65 28 0a 20 20 42 74 53 BtreePage(. BtS
288c0 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 hared *pBt,
288d0 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 /* The btree
288e0 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a */. MemPage **
288f0 70 70 50 61 67 65 2c 20 20 20 20 20 20 2f 2a 20 ppPage, /*
28900 53 74 6f 72 65 20 70 6f 69 6e 74 65 72 20 74 6f Store pointer to
28910 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 70 the allocated p
28920 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 20 50 67 age here */. Pg
28930 6e 6f 20 2a 70 50 67 6e 6f 2c 20 20 20 20 20 20 no *pPgno,
28940 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 74 68 /* Store th
28950 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 68 65 e page number he
28960 72 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 65 61 re */. Pgno nea
28970 72 62 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f rby, /
28980 2a 20 53 65 61 72 63 68 20 66 6f 72 20 61 20 70 * Search for a p
28990 61 67 65 20 6e 65 61 72 20 74 68 69 73 20 6f 6e age near this on
289a0 65 20 2a 2f 0a 20 20 75 38 20 65 4d 6f 64 65 20 e */. u8 eMode
289b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
289c0 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 2c 20 BTALLOC_EXACT,
289d0 42 54 41 4c 4c 4f 43 5f 4c 54 2c 20 6f 72 20 42 BTALLOC_LT, or B
289e0 54 41 4c 4c 4f 43 5f 41 4e 59 20 2a 2f 0a 29 7b TALLOC_ANY */.){
289f0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
28a00 65 31 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 e1;. int rc;.
28a10 75 33 32 20 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 u32 n; /* Nu
28a20 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e mber of pages on
28a30 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f the freelist */
28a40 0a 20 20 75 33 32 20 6b 3b 20 20 20 20 20 2f 2a . u32 k; /*
28a50 20 4e 75 6d 62 65 72 20 6f 66 20 6c 65 61 76 65 Number of leave
28a60 73 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 6f s on the trunk o
28a70 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a f the freelist *
28a80 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 72 /. MemPage *pTr
28a90 75 6e 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 unk = 0;. MemPa
28aa0 67 65 20 2a 70 50 72 65 76 54 72 75 6e 6b 20 3d ge *pPrevTrunk =
28ab0 20 30 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 61 67 0;. Pgno mxPag
28ac0 65 3b 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 e; /* Total
28ad0 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 size of the data
28ae0 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 base file */..
28af0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
28b00 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
28b10 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
28b20 72 74 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c rt( eMode==BTALL
28b30 4f 43 5f 41 4e 59 20 7c 7c 20 28 6e 65 61 72 62 OC_ANY || (nearb
28b40 79 3e 30 20 26 26 20 49 66 4e 6f 74 4f 6d 69 74 y>0 && IfNotOmit
28b50 41 56 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 AV(pBt->autoVacu
28b60 75 6d 29 29 20 29 3b 0a 20 20 70 50 61 67 65 31 um)) );. pPage1
28b70 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a = pBt->pPage1;.
28b80 20 20 6d 78 50 61 67 65 20 3d 20 62 74 72 65 65 mxPage = btree
28b90 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a Pagecount(pBt);.
28ba0 20 20 6e 20 3d 20 67 65 74 34 62 79 74 65 28 26 n = get4byte(&
28bb0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
28bc0 5d 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 ]);. testcase(
28bd0 6e 3d 3d 6d 78 50 61 67 65 2d 31 20 29 3b 0a 20 n==mxPage-1 );.
28be0 20 69 66 28 20 6e 3e 3d 6d 78 50 61 67 65 20 29 if( n>=mxPage )
28bf0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
28c00 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
28c10 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 3e 30 20 ;. }. if( n>0
28c20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 ){. /* There
28c30 61 72 65 20 70 61 67 65 73 20 6f 6e 20 74 68 65 are pages on the
28c40 20 66 72 65 65 6c 69 73 74 2e 20 20 52 65 75 73 freelist. Reus
28c50 65 20 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 70 e one of those p
28c60 61 67 65 73 2e 20 2a 2f 0a 20 20 20 20 50 67 6e ages. */. Pgn
28c70 6f 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 75 38 o iTrunk;. u8
28c80 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b searchList = 0;
28c90 20 2f 2a 20 49 66 20 74 68 65 20 66 72 65 65 2d /* If the free-
28ca0 6c 69 73 74 20 6d 75 73 74 20 62 65 20 73 65 61 list must be sea
28cb0 72 63 68 65 64 20 66 6f 72 20 27 6e 65 61 72 62 rched for 'nearb
28cc0 79 27 20 2a 2f 0a 20 20 20 20 0a 20 20 20 20 2f y' */. . /
28cd0 2a 20 49 66 20 65 4d 6f 64 65 3d 3d 42 54 41 4c * If eMode==BTAL
28ce0 4c 4f 43 5f 45 58 41 43 54 20 61 6e 64 20 61 20 LOC_EXACT and a
28cf0 71 75 65 72 79 20 6f 66 20 74 68 65 20 70 6f 69 query of the poi
28d00 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 2a 2a 20 nter-map. **
28d10 73 68 6f 77 73 20 74 68 61 74 20 74 68 65 20 70 shows that the p
28d20 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 age 'nearby' is
28d30 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 74 68 65 somewhere on the
28d40 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e free-list, then
28d50 0a 20 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 . ** the enti
28d60 72 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 20 re-list will be
28d70 73 65 61 72 63 68 65 64 20 66 6f 72 20 74 68 61 searched for tha
28d80 74 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 23 t page.. */.#
28d90 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
28da0 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
28db0 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 if( eMode==BTA
28dc0 4c 4c 4f 43 5f 45 58 41 43 54 20 29 7b 0a 20 20 LLOC_EXACT ){.
28dd0 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 3c 3d if( nearby<=
28de0 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 mxPage ){.
28df0 20 20 75 38 20 65 54 79 70 65 3b 0a 20 20 20 20 u8 eType;.
28e00 20 20 20 20 61 73 73 65 72 74 28 20 6e 65 61 72 assert( near
28e10 62 79 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 by>0 );.
28e20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 75 74 assert( pBt->aut
28e30 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 20 20 20 oVacuum );.
28e40 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 rc = ptrmapGe
28e50 74 28 70 42 74 2c 20 6e 65 61 72 62 79 2c 20 26 t(pBt, nearby, &
28e60 65 54 79 70 65 2c 20 30 29 3b 0a 20 20 20 20 20 eType, 0);.
28e70 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
28e80 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 69 rn rc;. i
28e90 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 f( eType==PTRMAP
28ea0 5f 46 52 45 45 50 41 47 45 20 29 7b 0a 20 20 20 _FREEPAGE ){.
28eb0 20 20 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 searchLis
28ec0 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d t = 1;. }
28ed0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
28ee0 73 65 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 se if( eMode==BT
28ef0 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 20 20 ALLOC_LE ){.
28f00 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 31 searchList = 1
28f10 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a ;. }.#endif..
28f20 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74 /* Decrement
28f30 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 63 the free-list c
28f40 6f 75 6e 74 20 62 79 20 31 2e 20 53 65 74 20 69 ount by 1. Set i
28f50 54 72 75 6e 6b 20 74 6f 20 74 68 65 20 69 6e 64 Trunk to the ind
28f60 65 78 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a ex of the. **
28f70 20 66 69 72 73 74 20 66 72 65 65 2d 6c 69 73 74 first free-list
28f80 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 69 50 72 trunk page. iPr
28f90 65 76 54 72 75 6e 6b 20 69 73 20 69 6e 69 74 69 evTrunk is initi
28fa0 61 6c 6c 79 20 31 2e 0a 20 20 20 20 2a 2f 0a 20 ally 1.. */.
28fb0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
28fc0 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 agerWrite(pPage1
28fd0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
28fe0 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
28ff0 72 63 3b 0a 20 20 20 20 70 75 74 34 62 79 74 65 rc;. put4byte
29000 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b (&pPage1->aData[
29010 33 36 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 20 20 20 36], n-1);..
29020 2f 2a 20 54 68 65 20 63 6f 64 65 20 77 69 74 68 /* The code with
29030 69 6e 20 74 68 69 73 20 6c 6f 6f 70 20 69 73 20 in this loop is
29040 72 75 6e 20 6f 6e 6c 79 20 6f 6e 63 65 20 69 66 run only once if
29050 20 74 68 65 20 27 73 65 61 72 63 68 4c 69 73 74 the 'searchList
29060 27 20 76 61 72 69 61 62 6c 65 0a 20 20 20 20 2a ' variable. *
29070 2a 20 69 73 20 6e 6f 74 20 74 72 75 65 2e 20 4f * is not true. O
29080 74 68 65 72 77 69 73 65 2c 20 69 74 20 72 75 6e therwise, it run
29090 73 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 s once for each
290a0 74 72 75 6e 6b 2d 70 61 67 65 20 6f 6e 20 74 68 trunk-page on th
290b0 65 0a 20 20 20 20 2a 2a 20 66 72 65 65 2d 6c 69 e. ** free-li
290c0 73 74 20 75 6e 74 69 6c 20 74 68 65 20 70 61 67 st until the pag
290d0 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f e 'nearby' is lo
290e0 63 61 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 cated (eMode==BT
290f0 41 4c 4c 4f 43 5f 45 58 41 43 54 29 0a 20 20 20 ALLOC_EXACT).
29100 20 2a 2a 20 6f 72 20 75 6e 74 69 6c 20 61 20 70 ** or until a p
29110 61 67 65 20 6c 65 73 73 20 74 68 61 6e 20 27 6e age less than 'n
29120 65 61 72 62 79 27 20 69 73 20 6c 6f 63 61 74 65 earby' is locate
29130 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f d (eMode==BTALLO
29140 43 5f 4c 54 29 0a 20 20 20 20 2a 2f 0a 20 20 20 C_LT). */.
29150 20 64 6f 20 7b 0a 20 20 20 20 20 20 70 50 72 65 do {. pPre
29160 76 54 72 75 6e 6b 20 3d 20 70 54 72 75 6e 6b 3b vTrunk = pTrunk;
29170 0a 20 20 20 20 20 20 69 66 28 20 70 50 72 65 76 . if( pPrev
29180 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 Trunk ){.
29190 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 iTrunk = get4by
291a0 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e te(&pPrevTrunk->
291b0 61 44 61 74 61 5b 30 5d 29 3b 0a 20 20 20 20 20 aData[0]);.
291c0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
291d0 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 iTrunk = get4byt
291e0 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
291f0 5b 33 32 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 [32]);. }.
29200 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 69 testcase( i
29210 54 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b Trunk==mxPage );
29220 0a 20 20 20 20 20 20 69 66 28 20 69 54 72 75 6e . if( iTrun
29230 6b 3e 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 k>mxPage ){.
29240 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
29250 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
29260 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
29270 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
29280 50 61 67 65 28 70 42 74 2c 20 69 54 72 75 6e 6b Page(pBt, iTrunk
29290 2c 20 26 70 54 72 75 6e 6b 2c 20 30 2c 20 30 29 , &pTrunk, 0, 0)
292a0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
292b0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
292c0 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 pTrunk = 0;.
292d0 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
292e0 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
292f0 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 65 }. asse
29300 72 74 28 20 70 54 72 75 6e 6b 21 3d 30 20 29 3b rt( pTrunk!=0 );
29310 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
29320 54 72 75 6e 6b 2d 3e 61 44 61 74 61 21 3d 30 20 Trunk->aData!=0
29330 29 3b 0a 0a 20 20 20 20 20 20 6b 20 3d 20 67 65 );.. k = ge
29340 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e t4byte(&pTrunk->
29350 61 44 61 74 61 5b 34 5d 29 3b 20 2f 2a 20 23 20 aData[4]); /* #
29360 6f 66 20 6c 65 61 76 65 73 20 6f 6e 20 74 68 69 of leaves on thi
29370 73 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a s trunk page */.
29380 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 26 if( k==0 &
29390 26 20 21 73 65 61 72 63 68 4c 69 73 74 20 29 7b & !searchList ){
293a0 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 . /* The
293b0 74 72 75 6e 6b 20 68 61 73 20 6e 6f 20 6c 65 61 trunk has no lea
293c0 76 65 73 20 61 6e 64 20 74 68 65 20 6c 69 73 74 ves and the list
293d0 20 69 73 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 is not being se
293e0 61 72 63 68 65 64 2e 20 0a 20 20 20 20 20 20 20 arched. .
293f0 20 2a 2a 20 53 6f 20 65 78 74 72 61 63 74 20 74 ** So extract t
29400 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 74 he trunk page it
29410 73 65 6c 66 20 61 6e 64 20 75 73 65 20 69 74 20 self and use it
29420 61 73 20 74 68 65 20 6e 65 77 6c 79 20 0a 20 20 as the newly .
29430 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 ** allocat
29440 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 ed page */.
29450 20 20 20 61 73 73 65 72 74 28 20 70 50 72 65 76 assert( pPrev
29460 54 72 75 6e 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 Trunk==0 );.
29470 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
29480 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e PagerWrite(pTrun
29490 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 k->pDbPage);.
294a0 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 if( rc ){.
294b0 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
294c0 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
294d0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
294e0 20 20 20 2a 70 50 67 6e 6f 20 3d 20 69 54 72 75 *pPgno = iTru
294f0 6e 6b 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 nk;. memc
29500 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 py(&pPage1->aDat
29510 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e a[32], &pTrunk->
29520 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
29530 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 *ppPage =
29540 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 pTrunk;.
29550 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 pTrunk = 0;.
29560 20 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f TRACE(("ALLO
29570 43 41 54 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d CATE: %d trunk -
29580 20 25 64 20 66 72 65 65 20 70 61 67 65 73 20 6c %d free pages l
29590 65 66 74 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 eft\n", *pPgno,
295a0 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c n-1));. }el
295b0 73 65 20 69 66 28 20 6b 3e 28 75 33 32 29 28 70 se if( k>(u32)(p
295c0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 Bt->usableSize/4
295d0 20 2d 20 32 29 20 29 7b 0a 20 20 20 20 20 20 20 - 2) ){.
295e0 20 2f 2a 20 56 61 6c 75 65 20 6f 66 20 6b 20 69 /* Value of k i
295f0 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2e 20 s out of range.
29600 20 44 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 Database corrup
29610 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 tion */.
29620 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
29630 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
29640 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
29650 61 74 65 5f 70 61 67 65 3b 0a 23 69 66 6e 64 65 ate_page;.#ifnde
29660 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
29670 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 7d TOVACUUM. }
29680 65 6c 73 65 20 69 66 28 20 73 65 61 72 63 68 4c else if( searchL
29690 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 20 20 ist .
296a0 20 26 26 20 28 6e 65 61 72 62 79 3d 3d 69 54 72 && (nearby==iTr
296b0 75 6e 6b 20 7c 7c 20 28 69 54 72 75 6e 6b 3c 6e unk || (iTrunk<n
296c0 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d earby && eMode==
296d0 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 BTALLOC_LE)) .
296e0 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ){. /
296f0 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 62 65 * The list is be
29700 69 6e 67 20 73 65 61 72 63 68 65 64 20 61 6e 64 ing searched and
29710 20 74 68 69 73 20 74 72 75 6e 6b 20 70 61 67 65 this trunk page
29720 20 69 73 20 74 68 65 20 70 61 67 65 0a 20 20 20 is the page.
29730 20 20 20 20 20 2a 2a 20 74 6f 20 61 6c 6c 6f 63 ** to alloc
29740 61 74 65 2c 20 72 65 67 61 72 64 6c 65 73 73 20 ate, regardless
29750 6f 66 20 77 68 65 74 68 65 72 20 69 74 20 68 61 of whether it ha
29760 73 20 6c 65 61 76 65 73 2e 0a 20 20 20 20 20 20 s leaves..
29770 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 2a 70 50 */. *pP
29780 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 gno = iTrunk;.
29790 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 *ppPage =
297a0 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 pTrunk;.
297b0 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 0a searchList = 0;.
297c0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
297d0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
297e0 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
297f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 . if( rc
29800 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 ){. got
29810 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
29820 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 age;. }.
29830 20 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 if( k==0
29840 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 ){. if(
29850 20 21 70 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a !pPrevTrunk ){.
29860 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 memc
29870 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 py(&pPage1->aDat
29880 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e a[32], &pTrunk->
29890 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
298a0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
298b0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
298c0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
298d0 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 e(pPrevTrunk->pD
298e0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
298f0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
29900 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
29910 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
29920 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
29930 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
29940 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 memcpy(
29950 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 &pPrevTrunk->aDa
29960 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e ta[0], &pTrunk->
29970 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
29980 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
29990 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
299a0 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b 20 /* The trunk
299b0 70 61 67 65 20 69 73 20 72 65 71 75 69 72 65 64 page is required
299c0 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 20 62 by the caller b
299d0 75 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 0a ut it contains .
299e0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 6f 69 ** poi
299f0 6e 74 65 72 73 20 74 6f 20 66 72 65 65 2d 6c 69 nters to free-li
29a00 73 74 20 6c 65 61 76 65 73 2e 20 54 68 65 20 66 st leaves. The f
29a10 69 72 73 74 20 6c 65 61 66 20 62 65 63 6f 6d 65 irst leaf become
29a20 73 20 61 20 74 72 75 6e 6b 0a 20 20 20 20 20 20 s a trunk.
29a30 20 20 20 20 2a 2a 20 70 61 67 65 20 69 6e 20 74 ** page in t
29a40 68 69 73 20 63 61 73 65 2e 0a 20 20 20 20 20 20 his case..
29a50 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 */.
29a60 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 54 72 MemPage *pNewTr
29a70 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 50 unk;. P
29a80 67 6e 6f 20 69 4e 65 77 54 72 75 6e 6b 20 3d 20 gno iNewTrunk =
29a90 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b get4byte(&pTrunk
29aa0 2d 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 20 20 ->aData[8]);.
29ab0 20 20 20 20 20 20 20 69 66 28 20 69 4e 65 77 54 if( iNewT
29ac0 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b 20 0a runk>mxPage ){ .
29ad0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
29ae0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
29af0 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 BKPT;.
29b00 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
29b10 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
29b20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
29b30 74 65 73 74 63 61 73 65 28 20 69 4e 65 77 54 72 testcase( iNewTr
29b40 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 unk==mxPage );.
29b50 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 rc = bt
29b60 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 reeGetPage(pBt,
29b70 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 4e 65 77 iNewTrunk, &pNew
29b80 54 72 75 6e 6b 2c 20 30 2c 20 30 29 3b 0a 20 20 Trunk, 0, 0);.
29b90 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
29ba0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
29bb0 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
29bc0 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
29bd0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
29be0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
29bf0 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 4e te3PagerWrite(pN
29c00 65 77 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 ewTrunk->pDbPage
29c10 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
29c20 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
29c30 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 {. re
29c40 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 54 72 leasePage(pNewTr
29c50 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 unk);.
29c60 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
29c70 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
29c80 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
29c90 6d 65 6d 63 70 79 28 26 70 4e 65 77 54 72 75 6e memcpy(&pNewTrun
29ca0 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 k->aData[0], &pT
29cb0 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 runk->aData[0],
29cc0 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 75 4);. pu
29cd0 74 34 62 79 74 65 28 26 70 4e 65 77 54 72 75 6e t4byte(&pNewTrun
29ce0 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 k->aData[4], k-1
29cf0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d );. mem
29d00 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e cpy(&pNewTrunk->
29d10 61 44 61 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e aData[8], &pTrun
29d20 6b 2d 3e 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b k->aData[12], (k
29d30 2d 31 29 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 -1)*4);.
29d40 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e releasePage(pN
29d50 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
29d60 20 20 20 20 69 66 28 20 21 70 50 72 65 76 54 72 if( !pPrevTr
29d70 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 unk ){.
29d80 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
29d90 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
29da0 6c 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 le(pPage1->pDbPa
29db0 67 65 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 ge) );.
29dc0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
29dd0 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 ge1->aData[32],
29de0 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 iNewTrunk);.
29df0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
29e00 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
29e10 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
29e20 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 pPrevTrunk->pDbP
29e30 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
29e40 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
29e50 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
29e60 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
29e70 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a ;. }.
29e80 20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 put4
29e90 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b byte(&pPrevTrunk
29ea0 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 ->aData[0], iNew
29eb0 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 Trunk);.
29ec0 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
29ed0 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 pTrunk = 0
29ee0 3b 0a 20 20 20 20 20 20 20 20 54 52 41 43 45 28 ;. TRACE(
29ef0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 ("ALLOCATE: %d t
29f00 72 75 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 runk - %d free p
29f10 61 67 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 ages left\n", *p
29f20 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e Pgno, n-1));.#en
29f30 64 69 66 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 dif. }else
29f40 69 66 28 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 if( k>0 ){.
29f50 20 20 20 2f 2a 20 45 78 74 72 61 63 74 20 61 20 /* Extract a
29f60 6c 65 61 66 20 66 72 6f 6d 20 74 68 65 20 74 72 leaf from the tr
29f70 75 6e 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 unk */. u
29f80 33 32 20 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 32 closest;.
29f90 20 20 20 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a Pgno iPage;.
29fa0 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 unsigned
29fb0 20 63 68 61 72 20 2a 61 44 61 74 61 20 3d 20 70 char *aData = p
29fc0 54 72 75 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 Trunk->aData;.
29fd0 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 if( nearby
29fe0 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 >0 ){.
29ff0 75 33 32 20 69 3b 0a 20 20 20 20 20 20 20 20 20 u32 i;.
2a000 20 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 closest = 0;.
2a010 20 20 20 20 20 20 20 20 69 66 28 20 65 4d 6f 64 if( eMod
2a020 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b e==BTALLOC_LE ){
2a030 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 . for
2a040 28 69 3d 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b (i=0; i<k; i++){
2a050 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 . i
2a060 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
2a070 26 61 44 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a &aData[8+i*4]);.
2a080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 if
2a090 28 20 69 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 ( iPage<=nearby
2a0a0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2a0b0 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a closest = i;.
2a0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a0d0 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 break;.
2a0e0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2a0f0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d }. }
2a100 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
2a110 20 20 69 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 int dist;.
2a120 20 20 20 20 20 20 20 20 64 69 73 74 20 3d 20 73 dist = s
2a130 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 67 qlite3AbsInt32(g
2a140 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 et4byte(&aData[8
2a150 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 ]) - nearby);.
2a160 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
2a170 31 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 1; i<k; i++){.
2a180 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
2a190 64 32 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 d2 = sqlite3AbsI
2a1a0 6e 74 33 32 28 67 65 74 34 62 79 74 65 28 26 61 nt32(get4byte(&a
2a1b0 44 61 74 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e Data[8+i*4]) - n
2a1c0 65 61 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 earby);.
2a1d0 20 20 20 20 20 20 69 66 28 20 64 32 3c 64 69 73 if( d2<dis
2a1e0 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
2a1f0 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 closest = i
2a200 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;.
2a210 20 20 64 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 dist = d2;.
2a220 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
2a230 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2a240 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
2a250 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
2a260 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 closest = 0;.
2a270 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 }..
2a280 69 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 iPage = get4byte
2a290 28 26 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 (&aData[8+closes
2a2a0 74 2a 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 t*4]);. t
2a2b0 65 73 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d estcase( iPage==
2a2c0 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
2a2d0 20 20 69 66 28 20 69 50 61 67 65 3e 6d 78 50 61 if( iPage>mxPa
2a2e0 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ge ){.
2a2f0 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
2a300 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
2a310 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
2a320 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
2a330 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 74 65 }. te
2a340 73 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d stcase( iPage==m
2a350 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 xPage );.
2a360 20 69 66 28 20 21 73 65 61 72 63 68 4c 69 73 74 if( !searchList
2a370 20 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 28 69 . || (i
2a380 50 61 67 65 3d 3d 6e 65 61 72 62 79 20 7c 7c 20 Page==nearby ||
2a390 28 69 50 61 67 65 3c 6e 65 61 72 62 79 20 26 26 (iPage<nearby &&
2a3a0 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f eMode==BTALLOC_
2a3b0 4c 45 29 29 20 0a 20 20 20 20 20 20 20 20 29 7b LE)) . ){
2a3c0 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6e . int n
2a3d0 6f 43 6f 6e 74 65 6e 74 3b 0a 20 20 20 20 20 20 oContent;.
2a3e0 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 69 50 61 *pPgno = iPa
2a3f0 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 54 52 ge;. TR
2a400 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 ACE(("ALLOCATE:
2a410 25 64 20 77 61 73 20 6c 65 61 66 20 25 64 20 6f %d was leaf %d o
2a420 66 20 25 64 20 6f 6e 20 74 72 75 6e 6b 20 25 64 f %d on trunk %d
2a430 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ".
2a440 20 20 20 22 3a 20 25 64 20 6d 6f 72 65 20 66 72 ": %d more fr
2a450 65 65 20 70 61 67 65 73 5c 6e 22 2c 0a 20 20 20 ee pages\n",.
2a460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 *p
2a470 50 67 6e 6f 2c 20 63 6c 6f 73 65 73 74 2b 31 2c Pgno, closest+1,
2a480 20 6b 2c 20 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f k, pTrunk->pgno
2a490 2c 20 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 , n-1));.
2a4a0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
2a4b0 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b agerWrite(pTrunk
2a4c0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2a4d0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 if( rc ) g
2a4e0 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
2a4f0 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
2a500 20 69 66 28 20 63 6c 6f 73 65 73 74 3c 6b 2d 31 if( closest<k-1
2a510 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2a520 6d 65 6d 63 70 79 28 26 61 44 61 74 61 5b 38 2b memcpy(&aData[8+
2a530 63 6c 6f 73 65 73 74 2a 34 5d 2c 20 26 61 44 61 closest*4], &aDa
2a540 74 61 5b 34 2b 6b 2a 34 5d 2c 20 34 29 3b 0a 20 ta[4+k*4], 4);.
2a550 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2a560 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 61 put4byte(&a
2a570 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 Data[4], k-1);.
2a580 20 20 20 20 20 20 20 20 20 6e 6f 43 6f 6e 74 65 noConte
2a590 6e 74 20 3d 20 21 62 74 72 65 65 47 65 74 48 61 nt = !btreeGetHa
2a5a0 73 43 6f 6e 74 65 6e 74 28 70 42 74 2c 20 2a 70 sContent(pBt, *p
2a5b0 50 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 Pgno);.
2a5c0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
2a5d0 67 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 ge(pBt, *pPgno,
2a5e0 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e ppPage, noConten
2a5f0 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 t, 0);.
2a600 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2a610 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
2a620 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
2a630 67 65 72 57 72 69 74 65 28 28 2a 70 70 50 61 67 gerWrite((*ppPag
2a640 65 29 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e)->pDbPage);.
2a650 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
2a660 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
2a670 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c rel
2a680 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 easePage(*ppPage
2a690 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d );. }
2a6a0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
2a6b0 20 20 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 searchLis
2a6c0 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d t = 0;. }
2a6d0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 . }. r
2a6e0 65 6c 65 61 73 65 50 61 67 65 28 70 50 72 65 76 eleasePage(pPrev
2a6f0 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 70 50 Trunk);. pP
2a700 72 65 76 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 revTrunk = 0;.
2a710 20 20 7d 77 68 69 6c 65 28 20 73 65 61 72 63 68 }while( search
2a720 4c 69 73 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b List );. }else{
2a730 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 . /* There ar
2a740 65 20 6e 6f 20 70 61 67 65 73 20 6f 6e 20 74 68 e no pages on th
2a750 65 20 66 72 65 65 6c 69 73 74 2c 20 73 6f 20 61 e freelist, so a
2a760 70 70 65 6e 64 20 61 20 6e 65 77 20 70 61 67 65 ppend a new page
2a770 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 to the. ** d
2a780 61 74 61 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 atabase image..
2a790 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 72 **. ** Nor
2a7a0 6d 61 6c 6c 79 2c 20 6e 65 77 20 70 61 67 65 73 mally, new pages
2a7b0 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 allocated by th
2a7c0 69 73 20 62 6c 6f 63 6b 20 63 61 6e 20 62 65 20 is block can be
2a7d0 72 65 71 75 65 73 74 65 64 20 66 72 6f 6d 20 74 requested from t
2a7e0 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 he. ** pager
2a7f0 6c 61 79 65 72 20 77 69 74 68 20 74 68 65 20 27 layer with the '
2a800 6e 6f 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 no-content' flag
2a810 20 73 65 74 2e 20 54 68 69 73 20 70 72 65 76 65 set. This preve
2a820 6e 74 73 20 74 68 65 20 70 61 67 65 72 0a 20 20 nts the pager.
2a830 20 20 2a 2a 20 66 72 6f 6d 20 74 72 79 69 6e 67 ** from trying
2a840 20 74 6f 20 72 65 61 64 20 74 68 65 20 70 61 67 to read the pag
2a850 65 73 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 es content from
2a860 64 69 73 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 disk. However, i
2a870 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 75 72 f the. ** cur
2a880 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e rent transaction
2a890 20 68 61 73 20 61 6c 72 65 61 64 79 20 72 75 6e has already run
2a8a0 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 69 6e 63 one or more inc
2a8b0 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 75 6d 0a remental-vacuum.
2a8c0 20 20 20 20 2a 2a 20 73 74 65 70 73 2c 20 74 68 ** steps, th
2a8d0 65 6e 20 74 68 65 20 70 61 67 65 20 77 65 20 61 en the page we a
2a8e0 72 65 20 61 62 6f 75 74 20 74 6f 20 61 6c 6c 6f re about to allo
2a8f0 63 61 74 65 20 6d 61 79 20 63 6f 6e 74 61 69 6e cate may contain
2a900 20 63 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 content. **
2a910 74 68 61 74 20 69 73 20 72 65 71 75 69 72 65 64 that is required
2a920 20 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 in the event of
2a930 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 6e 20 a rollback. In
2a940 74 68 69 73 20 63 61 73 65 2c 20 64 6f 0a 20 20 this case, do.
2a950 20 20 2a 2a 20 6e 6f 74 20 73 65 74 20 74 68 65 ** not set the
2a960 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 66 6c 61 67 no-content flag
2a970 2e 20 54 68 69 73 20 63 61 75 73 65 73 20 74 68 . This causes th
2a980 65 20 70 61 67 65 72 20 74 6f 20 6c 6f 61 64 20 e pager to load
2a990 61 6e 64 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 and journal.
2a9a0 2a 2a 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 ** the current p
2a9b0 61 67 65 20 63 6f 6e 74 65 6e 74 20 62 65 66 6f age content befo
2a9c0 72 65 20 6f 76 65 72 77 72 69 74 69 6e 67 20 69 re overwriting i
2a9d0 74 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a t.. **. **
2a9e0 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 70 Note that the p
2a9f0 61 67 65 72 20 77 69 6c 6c 20 6e 6f 74 20 61 63 ager will not ac
2aa00 74 75 61 6c 6c 79 20 61 74 74 65 6d 70 74 20 74 tually attempt t
2aa10 6f 20 6c 6f 61 64 20 6f 72 20 6a 6f 75 72 6e 61 o load or journa
2aa20 6c 20 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 65 6e l . ** conten
2aa30 74 20 66 6f 72 20 61 6e 79 20 70 61 67 65 20 74 t for any page t
2aa40 68 61 74 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 hat really does
2aa50 6c 69 65 20 70 61 73 74 20 74 68 65 20 65 6e 64 lie past the end
2aa60 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
2aa70 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 6f 6e 20 . ** file on
2aa80 64 69 73 6b 2e 20 53 6f 20 74 68 65 20 65 66 66 disk. So the eff
2aa90 65 63 74 73 20 6f 66 20 64 69 73 61 62 6c 69 6e ects of disablin
2aaa0 67 20 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 g the no-content
2aab0 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 optimization.
2aac0 20 20 2a 2a 20 68 65 72 65 20 61 72 65 20 63 6f ** here are co
2aad0 6e 66 69 6e 65 64 20 74 6f 20 74 68 6f 73 65 20 nfined to those
2aae0 70 61 67 65 73 20 74 68 61 74 20 6c 69 65 20 62 pages that lie b
2aaf0 65 74 77 65 65 6e 20 74 68 65 20 65 6e 64 20 6f etween the end o
2ab00 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 f the. ** dat
2ab10 61 62 61 73 65 20 69 6d 61 67 65 20 61 6e 64 20 abase image and
2ab20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 the end of the d
2ab30 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 atabase file..
2ab40 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 62 4e 6f */. int bNo
2ab50 43 6f 6e 74 65 6e 74 20 3d 20 28 30 3d 3d 49 66 Content = (0==If
2ab60 4e 6f 74 4f 6d 69 74 41 56 28 70 42 74 2d 3e 62 NotOmitAV(pBt->b
2ab70 44 6f 54 72 75 6e 63 61 74 65 29 29 3b 0a 0a 20 DoTruncate));..
2ab80 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
2ab90 61 67 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 agerWrite(pBt->p
2aba0 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b Page1->pDbPage);
2abb0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
2abc0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 70 42 74 turn rc;. pBt
2abd0 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 69 ->nPage++;. i
2abe0 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 50 f( pBt->nPage==P
2abf0 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
2ac00 28 70 42 74 29 20 29 20 70 42 74 2d 3e 6e 50 61 (pBt) ) pBt->nPa
2ac10 67 65 2b 2b 3b 0a 0a 23 69 66 6e 64 65 66 20 53 ge++;..#ifndef S
2ac20 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
2ac30 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 ACUUM. if( pB
2ac40 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 26 t->autoVacuum &&
2ac50 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 PTRMAP_ISPAGE(p
2ac60 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 20 Bt, pBt->nPage)
2ac70 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 2a ){. /* If *
2ac80 70 50 67 6e 6f 20 72 65 66 65 72 73 20 74 6f 20 pPgno refers to
2ac90 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 a pointer-map pa
2aca0 67 65 2c 20 61 6c 6c 6f 63 61 74 65 20 74 77 6f ge, allocate two
2acb0 20 6e 65 77 20 70 61 67 65 73 0a 20 20 20 20 20 new pages.
2acc0 20 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f ** at the end o
2acd0 66 20 74 68 65 20 66 69 6c 65 20 69 6e 73 74 65 f the file inste
2ace0 61 64 20 6f 66 20 6f 6e 65 2e 20 54 68 65 20 66 ad of one. The f
2acf0 69 72 73 74 20 61 6c 6c 6f 63 61 74 65 64 20 70 irst allocated p
2ad00 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 65 63 age. ** bec
2ad10 6f 6d 65 73 20 61 20 6e 65 77 20 70 6f 69 6e 74 omes a new point
2ad20 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 74 68 65 er-map page, the
2ad30 20 73 65 63 6f 6e 64 20 69 73 20 75 73 65 64 20 second is used
2ad40 62 79 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 20 by the caller..
2ad50 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 4d 65 */. Me
2ad60 6d 50 61 67 65 20 2a 70 50 67 20 3d 20 30 3b 0a mPage *pPg = 0;.
2ad70 20 20 20 20 20 20 54 52 41 43 45 28 28 22 41 4c TRACE(("AL
2ad80 4c 4f 43 41 54 45 3a 20 25 64 20 66 72 6f 6d 20 LOCATE: %d from
2ad90 65 6e 64 20 6f 66 20 66 69 6c 65 20 28 70 6f 69 end of file (poi
2ada0 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 29 5c 6e nter-map page)\n
2adb0 22 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 29 3b ", pBt->nPage));
2adc0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
2add0 42 74 2d 3e 6e 50 61 67 65 21 3d 50 45 4e 44 49 Bt->nPage!=PENDI
2ade0 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
2adf0 29 20 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 ) );. rc =
2ae00 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
2ae10 2c 20 70 42 74 2d 3e 6e 50 61 67 65 2c 20 26 70 , pBt->nPage, &p
2ae20 50 67 2c 20 62 4e 6f 43 6f 6e 74 65 6e 74 2c 20 Pg, bNoContent,
2ae30 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 0);. if( rc
2ae40 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2ae50 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
2ae60 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
2ae70 67 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 g->pDbPage);.
2ae80 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
2ae90 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 (pPg);. }.
2aea0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
2aeb0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 70 turn rc;. p
2aec0 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 Bt->nPage++;.
2aed0 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 if( pBt->nPag
2aee0 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f e==PENDING_BYTE_
2aef0 50 41 47 45 28 70 42 74 29 20 29 7b 20 70 42 74 PAGE(pBt) ){ pBt
2af00 2d 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 20 20 ->nPage++; }.
2af10 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 75 }.#endif. pu
2af20 74 34 62 79 74 65 28 32 38 20 2b 20 28 75 38 2a t4byte(28 + (u8*
2af30 29 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 )pBt->pPage1->aD
2af40 61 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 ata, pBt->nPage)
2af50 3b 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 70 ;. *pPgno = p
2af60 42 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 20 20 Bt->nPage;..
2af70 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 3d assert( *pPgno!=
2af80 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
2af90 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 72 63 E(pBt) );. rc
2afa0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
2afb0 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 50 pBt, *pPgno, ppP
2afc0 61 67 65 2c 20 62 4e 6f 43 6f 6e 74 65 6e 74 2c age, bNoContent,
2afd0 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 0);. if( rc
2afe0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
2aff0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
2b000 65 72 57 72 69 74 65 28 28 2a 70 70 50 61 67 65 erWrite((*ppPage
2b010 29 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 )->pDbPage);.
2b020 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
2b030 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 OK ){. rele
2b040 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 asePage(*ppPage)
2b050 3b 0a 20 20 20 20 7d 0a 20 20 20 20 54 52 41 43 ;. }. TRAC
2b060 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 E(("ALLOCATE: %d
2b070 20 66 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c from end of fil
2b080 65 5c 6e 22 2c 20 2a 70 50 67 6e 6f 29 29 3b 0a e\n", *pPgno));.
2b090 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 2a }.. assert( *
2b0a0 70 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 pPgno!=PENDING_B
2b0b0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b YTE_PAGE(pBt) );
2b0c0 0a 0a 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 ..end_allocate_p
2b0d0 61 67 65 3a 0a 20 20 72 65 6c 65 61 73 65 50 61 age:. releasePa
2b0e0 67 65 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 ge(pTrunk);. re
2b0f0 6c 65 61 73 65 50 61 67 65 28 70 50 72 65 76 54 leasePage(pPrevT
2b100 72 75 6e 6b 29 3b 0a 20 20 69 66 28 20 72 63 3d runk);. if( rc=
2b110 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2b120 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 if( sqlite3Pag
2b130 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 28 erPageRefcount((
2b140 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 61 67 *ppPage)->pDbPag
2b150 65 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 72 65 e)>1 ){. re
2b160 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 leasePage(*ppPag
2b170 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e e);. return
2b180 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2b190 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 BKPT;. }.
2b1a0 28 2a 70 70 50 61 67 65 29 2d 3e 69 73 49 6e 69 (*ppPage)->isIni
2b1b0 74 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a t = 0;. }else{.
2b1c0 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b *ppPage = 0;
2b1d0 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 72 . }. assert( r
2b1e0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c!=SQLITE_OK ||
2b1f0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
2b200 69 74 65 61 62 6c 65 28 28 2a 70 70 50 61 67 65 iteable((*ppPage
2b210 29 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 )->pDbPage) );.
2b220 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
2b230 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
2b240 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 on is used to ad
2b250 64 20 70 61 67 65 20 69 50 61 67 65 20 74 6f 20 d page iPage to
2b260 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
2b270 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 0a 2a 2a e free-list. .**
2b280 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 It is assumed t
2b290 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 hat the page is
2b2a0 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 70 61 not already a pa
2b2b0 72 74 20 6f 66 20 74 68 65 20 66 72 65 65 2d 6c rt of the free-l
2b2c0 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 ist..**.** The v
2b2d0 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 20 74 alue passed as t
2b2e0 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
2b2f0 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 nt to this funct
2b300 69 6f 6e 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e ion is optional.
2b310 0a 2a 2a 20 49 66 20 74 68 65 20 63 61 6c 6c 65 .** If the calle
2b320 72 20 68 61 70 70 65 6e 73 20 74 6f 20 68 61 76 r happens to hav
2b330 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 e a pointer to t
2b340 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 63 he MemPage objec
2b350 74 20 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 t .** correspond
2b360 69 6e 67 20 74 6f 20 70 61 67 65 20 69 50 61 67 ing to page iPag
2b370 65 20 68 61 6e 64 79 2c 20 69 74 20 6d 61 79 20 e handy, it may
2b380 70 61 73 73 20 69 74 20 61 73 20 74 68 65 20 73 pass it as the s
2b390 65 63 6f 6e 64 20 76 61 6c 75 65 2e 20 0a 2a 2a econd value. .**
2b3a0 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 6d Otherwise, it m
2b3b0 61 79 20 70 61 73 73 20 4e 55 4c 4c 2e 0a 2a 2a ay pass NULL..**
2b3c0 0a 2a 2a 20 49 66 20 61 20 70 6f 69 6e 74 65 72 .** If a pointer
2b3d0 20 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 6f 62 to a MemPage ob
2b3e0 6a 65 63 74 20 69 73 20 70 61 73 73 65 64 20 61 ject is passed a
2b3f0 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 s the second arg
2b400 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 73 20 72 65 ument,.** its re
2b410 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 69 73 ference count is
2b420 20 6e 6f 74 20 61 6c 74 65 72 65 64 20 62 79 20 not altered by
2b430 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a this function..*
2b440 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 /.static int fre
2b450 65 50 61 67 65 32 28 42 74 53 68 61 72 65 64 20 ePage2(BtShared
2b460 2a 70 42 74 2c 20 4d 65 6d 50 61 67 65 20 2a 70 *pBt, MemPage *p
2b470 4d 65 6d 50 61 67 65 2c 20 50 67 6e 6f 20 69 50 MemPage, Pgno iP
2b480 61 67 65 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 age){. MemPage
2b490 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 *pTrunk = 0;
2b4a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
2b4b0 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
2b4c0 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 54 age */. Pgno iT
2b4d0 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 runk = 0;
2b4e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2b4f0 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 Page number of f
2b500 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
2b510 61 67 65 20 2a 2f 20 0a 20 20 4d 65 6d 50 61 67 age */ . MemPag
2b520 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 2d e *pPage1 = pBt-
2b530 3e 70 50 61 67 65 31 3b 20 20 20 20 20 20 2f 2a >pPage1; /*
2b540 20 4c 6f 63 61 6c 20 72 65 66 65 72 65 6e 63 65 Local reference
2b550 20 74 6f 20 70 61 67 65 20 31 20 2a 2f 0a 20 20 to page 1 */.
2b560 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 20 MemPage *pPage;
2b570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b580 20 20 20 20 2f 2a 20 50 61 67 65 20 62 65 69 6e /* Page bein
2b590 67 20 66 72 65 65 64 2e 20 4d 61 79 20 62 65 20 g freed. May be
2b5a0 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 6e 74 20 72 NULL. */. int r
2b5b0 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
2b5c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2b5d0 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f * Return Code */
2b5e0 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b 20 20 20 . int nFree;
2b5f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b600 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 /* Initia
2b610 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 l number of page
2b620 73 20 6f 6e 20 66 72 65 65 2d 6c 69 73 74 20 2a s on free-list *
2b630 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c /.. assert( sql
2b640 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
2b650 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
2b660 20 61 73 73 65 72 74 28 20 69 50 61 67 65 3e 31 assert( iPage>1
2b670 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 );. assert( !p
2b680 4d 65 6d 50 61 67 65 20 7c 7c 20 70 4d 65 6d 50 MemPage || pMemP
2b690 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 67 65 age->pgno==iPage
2b6a0 20 29 3b 0a 0a 20 20 69 66 28 20 70 4d 65 6d 50 );.. if( pMemP
2b6b0 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 age ){. pPage
2b6c0 20 3d 20 70 4d 65 6d 50 61 67 65 3b 0a 20 20 20 = pMemPage;.
2b6d0 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 sqlite3PagerRef
2b6e0 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
2b6f0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
2b700 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 Page = btreePage
2b710 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 69 50 61 67 Lookup(pBt, iPag
2b720 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e e);. }.. /* In
2b730 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 65 65 crement the free
2b740 20 70 61 67 65 20 63 6f 75 6e 74 20 6f 6e 20 70 page count on p
2b750 50 61 67 65 31 20 2a 2f 0a 20 20 72 63 20 3d 20 Page1 */. rc =
2b760 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2b770 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 e(pPage1->pDbPag
2b780 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 67 e);. if( rc ) g
2b790 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
2b7a0 3b 0a 20 20 6e 46 72 65 65 20 3d 20 67 65 74 34 ;. nFree = get4
2b7b0 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 byte(&pPage1->aD
2b7c0 61 74 61 5b 33 36 5d 29 3b 0a 20 20 70 75 74 34 ata[36]);. put4
2b7d0 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 byte(&pPage1->aD
2b7e0 61 74 61 5b 33 36 5d 2c 20 6e 46 72 65 65 2b 31 ata[36], nFree+1
2b7f0 29 3b 0a 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 );.. if( pBt->b
2b800 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 tsFlags & BTS_SE
2b810 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 CURE_DELETE ){.
2b820 20 20 20 2f 2a 20 49 66 20 74 68 65 20 73 65 63 /* If the sec
2b830 75 72 65 5f 64 65 6c 65 74 65 20 6f 70 74 69 6f ure_delete optio
2b840 6e 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 n is enabled, th
2b850 65 6e 0a 20 20 20 20 2a 2a 20 61 6c 77 61 79 73 en. ** always
2b860 20 66 75 6c 6c 79 20 6f 76 65 72 77 72 69 74 65 fully overwrite
2b870 20 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 6d 61 deleted informa
2b880 74 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 2e tion with zeros.
2b890 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
2b8a0 28 21 70 50 61 67 65 20 26 26 20 28 28 72 63 20 (!pPage && ((rc
2b8b0 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 = btreeGetPage(p
2b8c0 42 74 2c 20 69 50 61 67 65 2c 20 26 70 50 61 67 Bt, iPage, &pPag
2b8d0 65 2c 20 30 2c 20 30 29 29 21 3d 30 29 20 29 0a e, 0, 0))!=0) ).
2b8e0 20 20 20 20 20 7c 7c 20 20 20 20 20 20 20 20 20 ||
2b8f0 20 20 20 28 28 72 63 20 3d 20 73 71 6c 69 74 65 ((rc = sqlite
2b900 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 3PagerWrite(pPag
2b910 65 2d 3e 70 44 62 50 61 67 65 29 29 21 3d 30 29 e->pDbPage))!=0)
2b920 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f . ){. go
2b930 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b to freepage_out;
2b940 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 . }. memse
2b950 74 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 t(pPage->aData,
2b960 30 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 0, pPage->pBt->p
2b970 61 67 65 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 ageSize);. }..
2b980 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 /* If the datab
2b990 61 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 ase supports aut
2b9a0 6f 2d 76 61 63 75 75 6d 2c 20 77 72 69 74 65 20 o-vacuum, write
2b9b0 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 an entry in the
2b9c0 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 2a 2a pointer-map. **
2b9d0 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 to indicate tha
2b9e0 74 20 74 68 65 20 70 61 67 65 20 69 73 20 66 72 t the page is fr
2b9f0 65 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 49 ee.. */. if( I
2ba00 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 SAUTOVACUUM ){.
2ba10 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 ptrmapPut(pBt
2ba20 2c 20 69 50 61 67 65 2c 20 50 54 52 4d 41 50 5f , iPage, PTRMAP_
2ba30 46 52 45 45 50 41 47 45 2c 20 30 2c 20 26 72 63 FREEPAGE, 0, &rc
2ba40 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
2ba50 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 goto freepage_ou
2ba60 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 t;. }.. /* Now
2ba70 20 6d 61 6e 69 70 75 6c 61 74 65 20 74 68 65 20 manipulate the
2ba80 61 63 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 actual database
2ba90 66 72 65 65 2d 6c 69 73 74 20 73 74 72 75 63 74 free-list struct
2baa0 75 72 65 2e 20 54 68 65 72 65 20 61 72 65 20 74 ure. There are t
2bab0 77 6f 0a 20 20 2a 2a 20 70 6f 73 73 69 62 69 6c wo. ** possibil
2bac0 69 74 69 65 73 2e 20 49 66 20 74 68 65 20 66 72 ities. If the fr
2bad0 65 65 2d 6c 69 73 74 20 69 73 20 63 75 72 72 65 ee-list is curre
2bae0 6e 74 6c 79 20 65 6d 70 74 79 2c 20 6f 72 20 69 ntly empty, or i
2baf0 66 20 74 68 65 20 66 69 72 73 74 0a 20 20 2a 2a f the first. **
2bb00 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 trunk page in t
2bb10 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 he free-list is
2bb20 66 75 6c 6c 2c 20 74 68 65 6e 20 74 68 69 73 20 full, then this
2bb30 70 61 67 65 20 77 69 6c 6c 20 62 65 63 6f 6d 65 page will become
2bb40 20 61 0a 20 20 2a 2a 20 6e 65 77 20 66 72 65 65 a. ** new free
2bb50 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 -list trunk page
2bb60 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 . Otherwise, it
2bb70 77 69 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6c 65 will become a le
2bb80 61 66 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 66 af of the. ** f
2bb90 69 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 irst trunk page
2bba0 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 in the current f
2bbb0 72 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 62 ree-list. This b
2bbc0 6c 6f 63 6b 20 74 65 73 74 73 20 69 66 20 69 74 lock tests if it
2bbd0 0a 20 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 6c . ** is possibl
2bbe0 65 20 74 6f 20 61 64 64 20 74 68 65 20 70 61 67 e to add the pag
2bbf0 65 20 61 73 20 61 20 6e 65 77 20 66 72 65 65 2d e as a new free-
2bc00 6c 69 73 74 20 6c 65 61 66 2e 0a 20 20 2a 2f 0a list leaf.. */.
2bc10 20 20 69 66 28 20 6e 46 72 65 65 21 3d 30 20 29 if( nFree!=0 )
2bc20 7b 0a 20 20 20 20 75 33 32 20 6e 4c 65 61 66 3b {. u32 nLeaf;
2bc30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bc40 2f 2a 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 /* Initial numbe
2bc50 72 20 6f 66 20 6c 65 61 66 20 63 65 6c 6c 73 20 r of leaf cells
2bc60 6f 6e 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f on trunk page */
2bc70 0a 0a 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 .. iTrunk = g
2bc80 65 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d et4byte(&pPage1-
2bc90 3e 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 >aData[32]);.
2bca0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
2bcb0 67 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 ge(pBt, iTrunk,
2bcc0 26 70 54 72 75 6e 6b 2c 20 30 2c 20 30 29 3b 0a &pTrunk, 0, 0);.
2bcd0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
2bce0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 TE_OK ){. g
2bcf0 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
2bd00 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e 4c 65 ;. }.. nLe
2bd10 61 66 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 af = get4byte(&p
2bd20 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 Trunk->aData[4])
2bd30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 ;. assert( pB
2bd40 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3e 33 32 t->usableSize>32
2bd50 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 4c 65 61 );. if( nLea
2bd60 66 20 3e 20 28 75 33 32 29 70 42 74 2d 3e 75 73 f > (u32)pBt->us
2bd70 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 20 29 ableSize/4 - 2 )
2bd80 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
2bd90 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
2bda0 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 65 ;. goto fre
2bdb0 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d epage_out;. }
2bdc0 0a 20 20 20 20 69 66 28 20 6e 4c 65 61 66 20 3c . if( nLeaf <
2bdd0 20 28 75 33 32 29 70 42 74 2d 3e 75 73 61 62 6c (u32)pBt->usabl
2bde0 65 53 69 7a 65 2f 34 20 2d 20 38 20 29 7b 0a 20 eSize/4 - 8 ){.
2bdf0 20 20 20 20 20 2f 2a 20 49 6e 20 74 68 69 73 20 /* In this
2be00 63 61 73 65 20 74 68 65 72 65 20 69 73 20 72 6f case there is ro
2be10 6f 6d 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 om on the trunk
2be20 70 61 67 65 20 74 6f 20 69 6e 73 65 72 74 20 74 page to insert t
2be30 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a he page. **
2be40 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 20 being freed as
2be50 61 20 6e 65 77 20 6c 65 61 66 2e 0a 20 20 20 20 a new leaf..
2be60 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4e 6f **. ** No
2be70 74 65 20 74 68 61 74 20 74 68 65 20 74 72 75 6e te that the trun
2be80 6b 20 70 61 67 65 20 69 73 20 6e 6f 74 20 72 65 k page is not re
2be90 61 6c 6c 79 20 66 75 6c 6c 20 75 6e 74 69 6c 20 ally full until
2bea0 69 74 20 63 6f 6e 74 61 69 6e 73 0a 20 20 20 20 it contains.
2beb0 20 20 2a 2a 20 75 73 61 62 6c 65 53 69 7a 65 2f ** usableSize/
2bec0 34 20 2d 20 32 20 65 6e 74 72 69 65 73 2c 20 6e 4 - 2 entries, n
2bed0 6f 74 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 ot usableSize/4
2bee0 2d 20 38 20 65 6e 74 72 69 65 73 20 61 73 20 77 - 8 entries as w
2bef0 65 20 68 61 76 65 0a 20 20 20 20 20 20 2a 2a 20 e have. **
2bf00 63 6f 64 65 64 2e 20 20 42 75 74 20 64 75 65 20 coded. But due
2bf10 74 6f 20 61 20 63 6f 64 69 6e 67 20 65 72 72 6f to a coding erro
2bf20 72 20 69 6e 20 76 65 72 73 69 6f 6e 73 20 6f 66 r in versions of
2bf30 20 53 51 4c 69 74 65 20 70 72 69 6f 72 20 74 6f SQLite prior to
2bf40 0a 20 20 20 20 20 20 2a 2a 20 33 2e 36 2e 30 2c . ** 3.6.0,
2bf50 20 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 databases with
2bf60 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 freelist trunk p
2bf70 61 67 65 73 20 68 6f 6c 64 69 6e 67 20 6d 6f 72 ages holding mor
2bf80 65 20 74 68 61 6e 0a 20 20 20 20 20 20 2a 2a 20 e than. **
2bf90 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 usableSize/4 - 8
2bfa0 20 65 6e 74 72 69 65 73 20 77 69 6c 6c 20 62 65 entries will be
2bfb0 20 72 65 70 6f 72 74 65 64 20 61 73 20 63 6f 72 reported as cor
2bfc0 72 75 70 74 2e 20 20 49 6e 20 6f 72 64 65 72 0a rupt. In order.
2bfd0 20 20 20 20 20 20 2a 2a 20 74 6f 20 6d 61 69 6e ** to main
2bfe0 74 61 69 6e 20 62 61 63 6b 77 61 72 64 73 20 63 tain backwards c
2bff0 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 ompatibility wit
2c000 68 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 h older versions
2c010 20 6f 66 20 53 51 4c 69 74 65 2c 0a 20 20 20 20 of SQLite,.
2c020 20 20 2a 2a 20 77 65 20 77 69 6c 6c 20 63 6f 6e ** we will con
2c030 74 69 6e 75 65 20 74 6f 20 72 65 73 74 72 69 63 tinue to restric
2c040 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 t the number of
2c050 65 6e 74 72 69 65 73 20 74 6f 20 75 73 61 62 6c entries to usabl
2c060 65 53 69 7a 65 2f 34 20 2d 20 38 0a 20 20 20 20 eSize/4 - 8.
2c070 20 20 2a 2a 20 66 6f 72 20 6e 6f 77 2e 20 20 41 ** for now. A
2c080 74 20 73 6f 6d 65 20 70 6f 69 6e 74 20 69 6e 20 t some point in
2c090 74 68 65 20 66 75 74 75 72 65 20 28 6f 6e 63 65 the future (once
2c0a0 20 65 76 65 72 79 6f 6e 65 20 68 61 73 20 75 70 everyone has up
2c0b0 67 72 61 64 65 64 0a 20 20 20 20 20 20 2a 2a 20 graded. **
2c0c0 74 6f 20 33 2e 36 2e 30 20 6f 72 20 6c 61 74 65 to 3.6.0 or late
2c0d0 72 29 20 77 65 20 73 68 6f 75 6c 64 20 63 6f 6e r) we should con
2c0e0 73 69 64 65 72 20 66 69 78 69 6e 67 20 74 68 65 sider fixing the
2c0f0 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 62 6f conditional abo
2c100 76 65 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 72 ve. ** to r
2c110 65 61 64 20 22 75 73 61 62 6c 65 53 69 7a 65 2f ead "usableSize/
2c120 34 2d 32 22 20 69 6e 73 74 65 61 64 20 6f 66 20 4-2" instead of
2c130 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d 38 22 "usableSize/4-8"
2c140 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
2c150 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
2c160 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e erWrite(pTrunk->
2c170 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
2c180 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2c190 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 75 74 K ){. put
2c1a0 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
2c1b0 44 61 74 61 5b 34 5d 2c 20 6e 4c 65 61 66 2b 31 Data[4], nLeaf+1
2c1c0 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 );. put4b
2c1d0 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
2c1e0 74 61 5b 38 2b 6e 4c 65 61 66 2a 34 5d 2c 20 69 ta[8+nLeaf*4], i
2c1f0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 Page);. i
2c200 66 28 20 70 50 61 67 65 20 26 26 20 28 70 42 74 f( pPage && (pBt
2c210 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
2c220 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 3d _SECURE_DELETE)=
2c230 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
2c240 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 sqlite3PagerDont
2c250 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 Write(pPage->pDb
2c260 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d Page);. }
2c270 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 . rc = bt
2c280 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 6e 74 reeSetHasContent
2c290 28 70 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 (pBt, iPage);.
2c2a0 20 20 20 20 7d 0a 20 20 20 20 20 20 54 52 41 43 }. TRAC
2c2b0 45 28 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 E(("FREE-PAGE: %
2c2c0 64 20 6c 65 61 66 20 6f 6e 20 74 72 75 6e 6b 20 d leaf on trunk
2c2d0 70 61 67 65 20 25 64 5c 6e 22 2c 70 50 61 67 65 page %d\n",pPage
2c2e0 2d 3e 70 67 6e 6f 2c 70 54 72 75 6e 6b 2d 3e 70 ->pgno,pTrunk->p
2c2f0 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 67 6f 74 gno));. got
2c300 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
2c310 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
2c320 49 66 20 63 6f 6e 74 72 6f 6c 20 66 6c 6f 77 73 If control flows
2c330 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 to this point,
2c340 74 68 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 20 then it was not
2c350 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 possible to add
2c360 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 the. ** the pag
2c370 65 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 e being freed as
2c380 20 61 20 6c 65 61 66 20 70 61 67 65 20 6f 66 20 a leaf page of
2c390 74 68 65 20 66 69 72 73 74 20 74 72 75 6e 6b 20 the first trunk
2c3a0 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 in the free-list
2c3b0 2e 0a 20 20 2a 2a 20 50 6f 73 73 69 62 6c 79 20 .. ** Possibly
2c3c0 62 65 63 61 75 73 65 20 74 68 65 20 66 72 65 65 because the free
2c3d0 2d 6c 69 73 74 20 69 73 20 65 6d 70 74 79 2c 20 -list is empty,
2c3e0 6f 72 20 70 6f 73 73 69 62 6c 79 20 62 65 63 61 or possibly beca
2c3f0 75 73 65 20 74 68 65 20 0a 20 20 2a 2a 20 66 69 use the . ** fi
2c400 72 73 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 rst trunk in the
2c410 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 75 free-list is fu
2c420 6c 6c 2e 20 45 69 74 68 65 72 20 77 61 79 2c 20 ll. Either way,
2c430 74 68 65 20 70 61 67 65 20 62 65 69 6e 67 20 66 the page being f
2c440 72 65 65 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 reed. ** will b
2c450 65 63 6f 6d 65 20 74 68 65 20 6e 65 77 20 66 69 ecome the new fi
2c460 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 rst trunk page i
2c470 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e n the free-list.
2c480 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 . */. if( pPag
2c490 65 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f e==0 && SQLITE_O
2c4a0 4b 21 3d 28 72 63 20 3d 20 62 74 72 65 65 47 65 K!=(rc = btreeGe
2c4b0 74 50 61 67 65 28 70 42 74 2c 20 69 50 61 67 65 tPage(pBt, iPage
2c4c0 2c 20 26 70 50 61 67 65 2c 20 30 2c 20 30 29 29 , &pPage, 0, 0))
2c4d0 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 ){. goto fre
2c4e0 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 epage_out;. }.
2c4f0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
2c500 65 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 erWrite(pPage->p
2c510 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 DbPage);. if( r
2c520 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
2c530 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 goto freepag
2c540 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 70 75 74 e_out;. }. put
2c550 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 4byte(pPage->aDa
2c560 74 61 2c 20 69 54 72 75 6e 6b 29 3b 0a 20 20 70 ta, iTrunk);. p
2c570 75 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e ut4byte(&pPage->
2c580 61 44 61 74 61 5b 34 5d 2c 20 30 29 3b 0a 20 20 aData[4], 0);.
2c590 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
2c5a0 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 50 61 ->aData[32], iPa
2c5b0 67 65 29 3b 0a 20 20 54 52 41 43 45 28 28 22 46 ge);. TRACE(("F
2c5c0 52 45 45 2d 50 41 47 45 3a 20 25 64 20 6e 65 77 REE-PAGE: %d new
2c5d0 20 74 72 75 6e 6b 20 70 61 67 65 20 72 65 70 6c trunk page repl
2c5e0 61 63 69 6e 67 20 25 64 5c 6e 22 2c 20 70 50 61 acing %d\n", pPa
2c5f0 67 65 2d 3e 70 67 6e 6f 2c 20 69 54 72 75 6e 6b ge->pgno, iTrunk
2c600 29 29 3b 0a 0a 66 72 65 65 70 61 67 65 5f 6f 75 ));..freepage_ou
2c610 74 3a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 t:. if( pPage )
2c620 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 {. pPage->isI
2c630 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 nit = 0;. }. r
2c640 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
2c650 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 );. releasePage
2c660 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 74 75 (pTrunk);. retu
2c670 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 rn rc;.}.static
2c680 76 6f 69 64 20 66 72 65 65 50 61 67 65 28 4d 65 void freePage(Me
2c690 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
2c6a0 74 20 2a 70 52 43 29 7b 0a 20 20 69 66 28 20 28 t *pRC){. if( (
2c6b0 2a 70 52 43 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b *pRC)==SQLITE_OK
2c6c0 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 66 ){. *pRC = f
2c6d0 72 65 65 50 61 67 65 32 28 70 50 61 67 65 2d 3e reePage2(pPage->
2c6e0 70 42 74 2c 20 70 50 61 67 65 2c 20 70 50 61 67 pBt, pPage, pPag
2c6f0 65 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a e->pgno);. }.}.
2c700 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 ./*.** Free any
2c710 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
2c720 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
2c730 68 65 20 67 69 76 65 6e 20 43 65 6c 6c 2e 0a 2a he given Cell..*
2c740 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6c 65 /.static int cle
2c750 61 72 43 65 6c 6c 28 4d 65 6d 50 61 67 65 20 2a arCell(MemPage *
2c760 70 50 61 67 65 2c 20 75 6e 73 69 67 6e 65 64 20 pPage, unsigned
2c770 63 68 61 72 20 2a 70 43 65 6c 6c 29 7b 0a 20 20 char *pCell){.
2c780 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
2c790 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 43 65 pPage->pBt;. Ce
2c7a0 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 50 llInfo info;. P
2c7b0 67 6e 6f 20 6f 76 66 6c 50 67 6e 6f 3b 0a 20 20 gno ovflPgno;.
2c7c0 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 6e 4f int rc;. int nO
2c7d0 76 66 6c 3b 0a 20 20 75 33 32 20 6f 76 66 6c 50 vfl;. u32 ovflP
2c7e0 61 67 65 53 69 7a 65 3b 0a 0a 20 20 61 73 73 65 ageSize;.. asse
2c7f0 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2c800 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
2c810 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 62 t->mutex) );. b
2c820 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
2c830 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
2c840 69 6e 66 6f 29 3b 0a 20 20 69 66 28 20 69 6e 66 info);. if( inf
2c850 6f 2e 69 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 29 o.iOverflow==0 )
2c860 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
2c870 49 54 45 5f 4f 4b 3b 20 20 2f 2a 20 4e 6f 20 6f ITE_OK; /* No o
2c880 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 52 verflow pages. R
2c890 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 64 6f eturn without do
2c8a0 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 2a 2f 0a ing anything */.
2c8b0 20 20 7d 0a 20 20 69 66 28 20 70 43 65 6c 6c 2b }. if( pCell+
2c8c0 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 2b 33 info.iOverflow+3
2c8d0 20 3e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 2b > pPage->aData+
2c8e0 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 pPage->maskPage
2c8f0 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
2c900 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2c910 54 3b 20 20 2f 2a 20 43 65 6c 6c 20 65 78 74 65 T; /* Cell exte
2c920 6e 64 73 20 70 61 73 74 20 65 6e 64 20 6f 66 20 nds past end of
2c930 70 61 67 65 20 2a 2f 0a 20 20 7d 0a 20 20 6f 76 page */. }. ov
2c940 66 6c 50 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 flPgno = get4byt
2c950 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f e(&pCell[info.iO
2c960 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 61 73 73 verflow]);. ass
2c970 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 ert( pBt->usable
2c980 53 69 7a 65 20 3e 20 34 20 29 3b 0a 20 20 6f 76 Size > 4 );. ov
2c990 66 6c 50 61 67 65 53 69 7a 65 20 3d 20 70 42 74 flPageSize = pBt
2c9a0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 ->usableSize - 4
2c9b0 3b 0a 20 20 6e 4f 76 66 6c 20 3d 20 28 69 6e 66 ;. nOvfl = (inf
2c9c0 6f 2e 6e 50 61 79 6c 6f 61 64 20 2d 20 69 6e 66 o.nPayload - inf
2c9d0 6f 2e 6e 4c 6f 63 61 6c 20 2b 20 6f 76 66 6c 50 o.nLocal + ovflP
2c9e0 61 67 65 53 69 7a 65 20 2d 20 31 29 2f 6f 76 66 ageSize - 1)/ovf
2c9f0 6c 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 73 lPageSize;. ass
2ca00 65 72 74 28 20 6f 76 66 6c 50 67 6e 6f 3d 3d 30 ert( ovflPgno==0
2ca10 20 7c 7c 20 6e 4f 76 66 6c 3e 30 20 29 3b 0a 20 || nOvfl>0 );.
2ca20 20 77 68 69 6c 65 28 20 6e 4f 76 66 6c 2d 2d 20 while( nOvfl--
2ca30 29 7b 0a 20 20 20 20 50 67 6e 6f 20 69 4e 65 78 ){. Pgno iNex
2ca40 74 20 3d 20 30 3b 0a 20 20 20 20 4d 65 6d 50 61 t = 0;. MemPa
2ca50 67 65 20 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 ge *pOvfl = 0;.
2ca60 20 20 20 69 66 28 20 6f 76 66 6c 50 67 6e 6f 3c if( ovflPgno<
2ca70 32 20 7c 7c 20 6f 76 66 6c 50 67 6e 6f 3e 62 74 2 || ovflPgno>bt
2ca80 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
2ca90 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 30 20 ) ){. /* 0
2caa0 69 73 20 6e 6f 74 20 61 20 6c 65 67 61 6c 20 70 is not a legal p
2cab0 61 67 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 age number and p
2cac0 61 67 65 20 31 20 63 61 6e 6e 6f 74 20 62 65 20 age 1 cannot be
2cad0 61 6e 20 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 an . ** ove
2cae0 72 66 6c 6f 77 20 70 61 67 65 2e 20 54 68 65 72 rflow page. Ther
2caf0 65 66 6f 72 65 20 69 66 20 6f 76 66 6c 50 67 6e efore if ovflPgn
2cb00 6f 3c 32 20 6f 72 20 70 61 73 74 20 74 68 65 20 o<2 or past the
2cb10 65 6e 64 20 6f 66 20 74 68 65 20 0a 20 20 20 20 end of the .
2cb20 20 20 2a 2a 20 66 69 6c 65 20 74 68 65 20 64 61 ** file the da
2cb30 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 63 tabase must be c
2cb40 6f 72 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 20 orrupt. */.
2cb50 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
2cb60 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
2cb70 20 7d 0a 20 20 20 20 69 66 28 20 6e 4f 76 66 6c }. if( nOvfl
2cb80 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 67 ){. rc = g
2cb90 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 70 etOverflowPage(p
2cba0 42 74 2c 20 6f 76 66 6c 50 67 6e 6f 2c 20 26 70 Bt, ovflPgno, &p
2cbb0 4f 76 66 6c 2c 20 26 69 4e 65 78 74 29 3b 0a 20 Ovfl, &iNext);.
2cbc0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
2cbd0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a turn rc;. }..
2cbe0 20 20 20 20 69 66 28 20 28 20 70 4f 76 66 6c 20 if( ( pOvfl
2cbf0 7c 7c 20 28 28 70 4f 76 66 6c 20 3d 20 62 74 72 || ((pOvfl = btr
2cc00 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 74 eePageLookup(pBt
2cc10 2c 20 6f 76 66 6c 50 67 6e 6f 29 29 21 3d 30 29 , ovflPgno))!=0)
2cc20 20 29 0a 20 20 20 20 20 26 26 20 73 71 6c 69 74 ). && sqlit
2cc30 65 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f e3PagerPageRefco
2cc40 75 6e 74 28 70 4f 76 66 6c 2d 3e 70 44 62 50 61 unt(pOvfl->pDbPa
2cc50 67 65 29 21 3d 31 0a 20 20 20 20 29 7b 0a 20 20 ge)!=1. ){.
2cc60 20 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 20 /* There is
2cc70 6e 6f 20 72 65 61 73 6f 6e 20 61 6e 79 20 63 75 no reason any cu
2cc80 72 73 6f 72 20 73 68 6f 75 6c 64 20 68 61 76 65 rsor should have
2cc90 20 61 6e 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 an outstanding
2cca0 72 65 66 65 72 65 6e 63 65 20 0a 20 20 20 20 20 reference .
2ccb0 20 2a 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c ** to an overfl
2ccc0 6f 77 20 70 61 67 65 20 62 65 6c 6f 6e 67 69 6e ow page belongin
2ccd0 67 20 74 6f 20 61 20 63 65 6c 6c 20 74 68 61 74 g to a cell that
2cce0 20 69 73 20 62 65 69 6e 67 20 64 65 6c 65 74 65 is being delete
2ccf0 64 2f 75 70 64 61 74 65 64 2e 0a 20 20 20 20 20 d/updated..
2cd00 20 2a 2a 20 53 6f 20 69 66 20 74 68 65 72 65 20 ** So if there
2cd10 65 78 69 73 74 73 20 6d 6f 72 65 20 74 68 61 6e exists more than
2cd20 20 6f 6e 65 20 72 65 66 65 72 65 6e 63 65 20 74 one reference t
2cd30 6f 20 74 68 69 73 20 70 61 67 65 2c 20 74 68 65 o this page, the
2cd40 6e 20 69 74 20 0a 20 20 20 20 20 20 2a 2a 20 6d n it . ** m
2cd50 75 73 74 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 ust not really b
2cd60 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 e an overflow pa
2cd70 67 65 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 ge and the datab
2cd80 61 73 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 ase must be corr
2cd90 75 70 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 49 upt. . ** I
2cda0 74 20 69 73 20 68 65 6c 70 66 75 6c 20 74 6f 20 t is helpful to
2cdb0 64 65 74 65 63 74 20 74 68 69 73 20 62 65 66 6f detect this befo
2cdc0 72 65 20 63 61 6c 6c 69 6e 67 20 66 72 65 65 50 re calling freeP
2cdd0 61 67 65 32 28 29 2c 20 61 73 20 0a 20 20 20 20 age2(), as .
2cde0 20 20 2a 2a 20 66 72 65 65 50 61 67 65 32 28 29 ** freePage2()
2cdf0 20 6d 61 79 20 7a 65 72 6f 20 74 68 65 20 70 61 may zero the pa
2ce00 67 65 20 63 6f 6e 74 65 6e 74 73 20 69 66 20 73 ge contents if s
2ce10 65 63 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f 64 ecure-delete mod
2ce20 65 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 65 6e e is. ** en
2ce30 61 62 6c 65 64 2e 20 49 66 20 74 68 69 73 20 27 abled. If this '
2ce40 6f 76 65 72 66 6c 6f 77 27 20 70 61 67 65 20 68 overflow' page h
2ce50 61 70 70 65 6e 73 20 74 6f 20 62 65 20 61 20 70 appens to be a p
2ce60 61 67 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 age that the.
2ce70 20 20 20 2a 2a 20 63 61 6c 6c 65 72 20 69 73 20 ** caller is
2ce80 69 74 65 72 61 74 69 6e 67 20 74 68 72 6f 75 67 iterating throug
2ce90 68 20 6f 72 20 75 73 69 6e 67 20 69 6e 20 73 6f h or using in so
2cea0 6d 65 20 6f 74 68 65 72 20 77 61 79 2c 20 74 68 me other way, th
2ceb0 69 73 0a 20 20 20 20 20 20 2a 2a 20 63 61 6e 20 is. ** can
2cec0 62 65 20 70 72 6f 62 6c 65 6d 61 74 69 63 2e 0a be problematic..
2ced0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 */. r
2cee0 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
2cef0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c PT_BKPT;. }el
2cf00 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 se{. rc = f
2cf10 72 65 65 50 61 67 65 32 28 70 42 74 2c 20 70 4f reePage2(pBt, pO
2cf20 76 66 6c 2c 20 6f 76 66 6c 50 67 6e 6f 29 3b 0a vfl, ovflPgno);.
2cf30 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 }.. if( p
2cf40 4f 76 66 6c 20 29 7b 0a 20 20 20 20 20 20 73 71 Ovfl ){. sq
2cf50 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
2cf60 70 4f 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 3b pOvfl->pDbPage);
2cf70 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
2cf80 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
2cf90 20 20 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 69 4e ovflPgno = iN
2cfa0 65 78 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ext;. }. retur
2cfb0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
2cfc0 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 74 68 65 /*.** Create the
2cfd0 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 75 byte sequence u
2cfe0 73 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 sed to represent
2cff0 20 61 20 63 65 6c 6c 20 6f 6e 20 70 61 67 65 20 a cell on page
2d000 70 50 61 67 65 0a 2a 2a 20 61 6e 64 20 77 72 69 pPage.** and wri
2d010 74 65 20 74 68 61 74 20 62 79 74 65 20 73 65 71 te that byte seq
2d020 75 65 6e 63 65 20 69 6e 74 6f 20 70 43 65 6c 6c uence into pCell
2d030 5b 5d 2e 20 20 4f 76 65 72 66 6c 6f 77 20 70 61 []. Overflow pa
2d040 67 65 73 20 61 72 65 0a 2a 2a 20 61 6c 6c 6f 63 ges are.** alloc
2d050 61 74 65 64 20 61 6e 64 20 66 69 6c 6c 65 64 20 ated and filled
2d060 69 6e 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e in as necessary.
2d070 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 The calling pr
2d080 6f 63 65 64 75 72 65 0a 2a 2a 20 69 73 20 72 65 ocedure.** is re
2d090 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 6d 61 sponsible for ma
2d0a0 6b 69 6e 67 20 73 75 72 65 20 73 75 66 66 69 63 king sure suffic
2d0b0 69 65 6e 74 20 73 70 61 63 65 20 68 61 73 20 62 ient space has b
2d0c0 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a een allocated.**
2d0d0 20 66 6f 72 20 70 43 65 6c 6c 5b 5d 2e 0a 2a 2a for pCell[]..**
2d0e0 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 70 43 .** Note that pC
2d0f0 65 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65 63 ell does not nec
2d100 65 73 73 61 72 79 20 6e 65 65 64 20 74 6f 20 70 essary need to p
2d110 6f 69 6e 74 20 74 6f 20 74 68 65 20 70 50 61 67 oint to the pPag
2d120 65 2d 3e 61 44 61 74 61 0a 2a 2a 20 61 72 65 61 e->aData.** area
2d130 2e 20 20 70 43 65 6c 6c 20 6d 69 67 68 74 20 70 . pCell might p
2d140 6f 69 6e 74 20 74 6f 20 73 6f 6d 65 20 74 65 6d oint to some tem
2d150 70 6f 72 61 72 79 20 73 74 6f 72 61 67 65 2e 20 porary storage.
2d160 20 54 68 65 20 63 65 6c 6c 20 77 69 6c 6c 0a 2a The cell will.*
2d170 2a 20 62 65 20 63 6f 6e 73 74 72 75 63 74 65 64 * be constructed
2d180 20 69 6e 20 74 68 69 73 20 74 65 6d 70 6f 72 61 in this tempora
2d190 72 79 20 61 72 65 61 20 74 68 65 6e 20 63 6f 70 ry area then cop
2d1a0 69 65 64 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e ied into pPage->
2d1b0 61 44 61 74 61 0a 2a 2a 20 6c 61 74 65 72 2e 0a aData.** later..
2d1c0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69 */.static int fi
2d1d0 6c 6c 49 6e 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 llInCell(. MemP
2d1e0 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 age *pPage,
2d1f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
2d200 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 e page that cont
2d210 61 69 6e 73 20 74 68 65 20 63 65 6c 6c 20 2a 2f ains the cell */
2d220 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
2d230 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 *pCell,
2d240 20 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 74 65 /* Complete te
2d250 78 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 2a xt of the cell *
2d260 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a /. const void *
2d270 70 4b 65 79 2c 20 69 36 34 20 6e 4b 65 79 2c 20 pKey, i64 nKey,
2d280 20 20 20 2f 2a 20 54 68 65 20 6b 65 79 20 2a 2f /* The key */
2d290 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 . const void *p
2d2a0 44 61 74 61 2c 69 6e 74 20 6e 44 61 74 61 2c 20 Data,int nData,
2d2b0 20 20 2f 2a 20 54 68 65 20 64 61 74 61 20 2a 2f /* The data */
2d2c0 0a 20 20 69 6e 74 20 6e 5a 65 72 6f 2c 20 20 20 . int nZero,
2d2d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d2e0 20 20 2f 2a 20 45 78 74 72 61 20 7a 65 72 6f 20 /* Extra zero
2d2f0 62 79 74 65 73 20 74 6f 20 61 70 70 65 6e 64 20 bytes to append
2d300 74 6f 20 70 44 61 74 61 20 2a 2f 0a 20 20 69 6e to pData */. in
2d310 74 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 t *pnSize
2d320 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2d330 57 72 69 74 65 20 63 65 6c 6c 20 73 69 7a 65 20 Write cell size
2d340 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
2d350 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 63 6f 6e nPayload;. con
2d360 73 74 20 75 38 20 2a 70 53 72 63 3b 0a 20 20 69 st u8 *pSrc;. i
2d370 6e 74 20 6e 53 72 63 2c 20 6e 2c 20 72 63 3b 0a nt nSrc, n, rc;.
2d380 20 20 69 6e 74 20 73 70 61 63 65 4c 65 66 74 3b int spaceLeft;
2d390 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 . MemPage *pOvf
2d3a0 6c 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 l = 0;. MemPage
2d3b0 20 2a 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 30 *pToRelease = 0
2d3c0 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 ;. unsigned cha
2d3d0 72 20 2a 70 50 72 69 6f 72 3b 0a 20 20 75 6e 73 r *pPrior;. uns
2d3e0 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 61 79 igned char *pPay
2d3f0 6c 6f 61 64 3b 0a 20 20 42 74 53 68 61 72 65 64 load;. BtShared
2d400 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 *pBt = pPage->p
2d410 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4f Bt;. Pgno pgnoO
2d420 76 66 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e vfl = 0;. int n
2d430 48 65 61 64 65 72 3b 0a 20 20 43 65 6c 6c 49 6e Header;. CellIn
2d440 66 6f 20 69 6e 66 6f 3b 0a 0a 20 20 61 73 73 65 fo info;.. asse
2d450 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2d460 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
2d470 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 t->mutex) );..
2d480 2f 2a 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 /* pPage is not
2d490 6e 65 63 65 73 73 61 72 69 6c 79 20 77 72 69 74 necessarily writ
2d4a0 65 61 62 6c 65 20 73 69 6e 63 65 20 70 43 65 6c eable since pCel
2d4b0 6c 20 6d 69 67 68 74 20 62 65 20 61 75 78 69 6c l might be auxil
2d4c0 69 61 72 79 0a 20 20 2a 2a 20 62 75 66 66 65 72 iary. ** buffer
2d4d0 20 73 70 61 63 65 20 74 68 61 74 20 69 73 20 73 space that is s
2d4e0 65 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68 65 eparate from the
2d4f0 20 70 50 61 67 65 20 62 75 66 66 65 72 20 61 72 pPage buffer ar
2d500 65 61 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 ea */. assert(
2d510 70 43 65 6c 6c 3c 70 50 61 67 65 2d 3e 61 44 61 pCell<pPage->aDa
2d520 74 61 20 7c 7c 20 70 43 65 6c 6c 3e 3d 26 70 50 ta || pCell>=&pP
2d530 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e age->aData[pBt->
2d540 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 pageSize].
2d550 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 || sqlite3
2d560 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
2d570 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
2d580 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 );.. /* Fill i
2d590 6e 20 74 68 65 20 68 65 61 64 65 72 2e 20 2a 2f n the header. */
2d5a0 0a 20 20 6e 48 65 61 64 65 72 20 3d 20 30 3b 0a . nHeader = 0;.
2d5b0 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 if( !pPage->le
2d5c0 61 66 20 29 7b 0a 20 20 20 20 6e 48 65 61 64 65 af ){. nHeade
2d5d0 72 20 2b 3d 20 34 3b 0a 20 20 7d 0a 20 20 69 66 r += 4;. }. if
2d5e0 28 20 70 50 61 67 65 2d 3e 68 61 73 44 61 74 61 ( pPage->hasData
2d5f0 20 29 7b 0a 20 20 20 20 6e 48 65 61 64 65 72 20 ){. nHeader
2d600 2b 3d 20 70 75 74 56 61 72 69 6e 74 28 26 70 43 += putVarint(&pC
2d610 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 6e 44 ell[nHeader], nD
2d620 61 74 61 2b 6e 5a 65 72 6f 29 3b 0a 20 20 7d 65 ata+nZero);. }e
2d630 6c 73 65 7b 0a 20 20 20 20 6e 44 61 74 61 20 3d lse{. nData =
2d640 20 6e 5a 65 72 6f 20 3d 20 30 3b 0a 20 20 7d 0a nZero = 0;. }.
2d650 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 74 nHeader += put
2d660 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e 48 Varint(&pCell[nH
2d670 65 61 64 65 72 5d 2c 20 2a 28 75 36 34 2a 29 26 eader], *(u64*)&
2d680 6e 4b 65 79 29 3b 0a 20 20 62 74 72 65 65 50 61 nKey);. btreePa
2d690 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 rseCellPtr(pPage
2d6a0 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b , pCell, &info);
2d6b0 0a 20 20 61 73 73 65 72 74 28 20 69 6e 66 6f 2e . assert( info.
2d6c0 6e 48 65 61 64 65 72 3d 3d 6e 48 65 61 64 65 72 nHeader==nHeader
2d6d0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 6e );. assert( in
2d6e0 66 6f 2e 6e 4b 65 79 3d 3d 6e 4b 65 79 20 29 3b fo.nKey==nKey );
2d6f0 0a 20 20 61 73 73 65 72 74 28 20 69 6e 66 6f 2e . assert( info.
2d700 6e 44 61 74 61 3d 3d 28 75 33 32 29 28 6e 44 61 nData==(u32)(nDa
2d710 74 61 2b 6e 5a 65 72 6f 29 20 29 3b 0a 20 20 0a ta+nZero) );. .
2d720 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 /* Fill in the
2d730 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 6e 50 payload */. nP
2d740 61 79 6c 6f 61 64 20 3d 20 6e 44 61 74 61 20 2b ayload = nData +
2d750 20 6e 5a 65 72 6f 3b 0a 20 20 69 66 28 20 70 50 nZero;. if( pP
2d760 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 age->intKey ){.
2d770 20 20 20 70 53 72 63 20 3d 20 70 44 61 74 61 3b pSrc = pData;
2d780 0a 20 20 20 20 6e 53 72 63 20 3d 20 6e 44 61 74 . nSrc = nDat
2d790 61 3b 0a 20 20 20 20 6e 44 61 74 61 20 3d 20 30 a;. nData = 0
2d7a0 3b 0a 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20 ;. }else{ .
2d7b0 69 66 28 20 4e 45 56 45 52 28 6e 4b 65 79 3e 30 if( NEVER(nKey>0
2d7c0 78 37 66 66 66 66 66 66 66 20 7c 7c 20 70 4b 65 x7fffffff || pKe
2d7d0 79 3d 3d 30 29 20 29 7b 0a 20 20 20 20 20 20 72 y==0) ){. r
2d7e0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
2d7f0 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
2d800 0a 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 2b 3d . nPayload +=
2d810 20 28 69 6e 74 29 6e 4b 65 79 3b 0a 20 20 20 20 (int)nKey;.
2d820 70 53 72 63 20 3d 20 70 4b 65 79 3b 0a 20 20 20 pSrc = pKey;.
2d830 20 6e 53 72 63 20 3d 20 28 69 6e 74 29 6e 4b 65 nSrc = (int)nKe
2d840 79 3b 0a 20 20 7d 0a 20 20 2a 70 6e 53 69 7a 65 y;. }. *pnSize
2d850 20 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 3b 0a 20 = info.nSize;.
2d860 20 73 70 61 63 65 4c 65 66 74 20 3d 20 69 6e 66 spaceLeft = inf
2d870 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 70 50 61 79 o.nLocal;. pPay
2d880 6c 6f 61 64 20 3d 20 26 70 43 65 6c 6c 5b 6e 48 load = &pCell[nH
2d890 65 61 64 65 72 5d 3b 0a 20 20 70 50 72 69 6f 72 eader];. pPrior
2d8a0 20 3d 20 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 = &pCell[info.i
2d8b0 4f 76 65 72 66 6c 6f 77 5d 3b 0a 0a 20 20 77 68 Overflow];.. wh
2d8c0 69 6c 65 28 20 6e 50 61 79 6c 6f 61 64 3e 30 20 ile( nPayload>0
2d8d0 29 7b 0a 20 20 20 20 69 66 28 20 73 70 61 63 65 ){. if( space
2d8e0 4c 65 66 74 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 Left==0 ){.#ifnd
2d8f0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
2d900 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 UTOVACUUM.
2d910 50 67 6e 6f 20 70 67 6e 6f 50 74 72 6d 61 70 20 Pgno pgnoPtrmap
2d920 3d 20 70 67 6e 6f 4f 76 66 6c 3b 20 2f 2a 20 4f = pgnoOvfl; /* O
2d930 76 65 72 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 verflow page poi
2d940 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 79 20 70 nter-map entry p
2d950 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 age */. if(
2d960 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
2d970 20 29 7b 0a 20 20 20 20 20 20 20 20 64 6f 7b 0a ){. do{.
2d980 20 20 20 20 20 20 20 20 20 20 70 67 6e 6f 4f 76 pgnoOv
2d990 66 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7d 20 fl++;. }
2d9a0 77 68 69 6c 65 28 20 0a 20 20 20 20 20 20 20 20 while( .
2d9b0 20 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 PTRMAP_ISPAGE(
2d9c0 70 42 74 2c 20 70 67 6e 6f 4f 76 66 6c 29 20 7c pBt, pgnoOvfl) |
2d9d0 7c 20 70 67 6e 6f 4f 76 66 6c 3d 3d 50 45 4e 44 | pgnoOvfl==PEND
2d9e0 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 ING_BYTE_PAGE(pB
2d9f0 74 29 20 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 t) . );.
2da00 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
2da10 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 rc = allocat
2da20 65 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 eBtreePage(pBt,
2da30 26 70 4f 76 66 6c 2c 20 26 70 67 6e 6f 4f 76 66 &pOvfl, &pgnoOvf
2da40 6c 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 30 29 3b l, pgnoOvfl, 0);
2da50 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2da60 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
2da70 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 /* If the
2da80 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 database support
2da90 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 20 61 s auto-vacuum, a
2daa0 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 6f 72 nd the second or
2dab0 20 73 75 62 73 65 71 75 65 6e 74 0a 20 20 20 20 subsequent.
2dac0 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 ** overflow pa
2dad0 67 65 20 69 73 20 62 65 69 6e 67 20 61 6c 6c 6f ge is being allo
2dae0 63 61 74 65 64 2c 20 61 64 64 20 61 6e 20 65 6e cated, add an en
2daf0 74 72 79 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 try to the point
2db00 65 72 2d 6d 61 70 0a 20 20 20 20 20 20 2a 2a 20 er-map. **
2db10 66 6f 72 20 74 68 61 74 20 70 61 67 65 20 6e 6f for that page no
2db20 77 2e 20 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 w. . **.
2db30 20 20 20 2a 2a 20 49 66 20 74 68 69 73 20 69 73 ** If this is
2db40 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 72 66 the first overf
2db50 6c 6f 77 20 70 61 67 65 2c 20 74 68 65 6e 20 77 low page, then w
2db60 72 69 74 65 20 61 20 70 61 72 74 69 61 6c 20 65 rite a partial e
2db70 6e 74 72 79 20 0a 20 20 20 20 20 20 2a 2a 20 74 ntry . ** t
2db80 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 o the pointer-ma
2db90 70 2e 20 49 66 20 77 65 20 77 72 69 74 65 20 6e p. If we write n
2dba0 6f 74 68 69 6e 67 20 74 6f 20 74 68 69 73 20 70 othing to this p
2dbb0 6f 69 6e 74 65 72 2d 6d 61 70 20 73 6c 6f 74 2c ointer-map slot,
2dbc0 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 74 . ** then t
2dbd0 68 65 20 6f 70 74 69 6d 69 73 74 69 63 20 6f 76 he optimistic ov
2dbe0 65 72 66 6c 6f 77 20 63 68 61 69 6e 20 70 72 6f erflow chain pro
2dbf0 63 65 73 73 69 6e 67 20 69 6e 20 63 6c 65 61 72 cessing in clear
2dc00 43 65 6c 6c 28 29 0a 20 20 20 20 20 20 2a 2a 20 Cell(). **
2dc10 6d 61 79 20 6d 69 73 69 6e 74 65 72 70 72 65 74 may misinterpret
2dc20 20 74 68 65 20 75 6e 69 6e 69 74 69 61 6c 69 7a the uninitializ
2dc30 65 64 20 76 61 6c 75 65 73 20 61 6e 64 20 64 65 ed values and de
2dc40 6c 65 74 65 20 74 68 65 0a 20 20 20 20 20 20 2a lete the. *
2dc50 2a 20 77 72 6f 6e 67 20 70 61 67 65 73 20 66 72 * wrong pages fr
2dc60 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e om the database.
2dc70 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
2dc80 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 if( pBt->autoVac
2dc90 75 75 6d 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 uum && rc==SQLIT
2dca0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
2dcb0 75 38 20 65 54 79 70 65 20 3d 20 28 70 67 6e 6f u8 eType = (pgno
2dcc0 50 74 72 6d 61 70 3f 50 54 52 4d 41 50 5f 4f 56 Ptrmap?PTRMAP_OV
2dcd0 45 52 46 4c 4f 57 32 3a 50 54 52 4d 41 50 5f 4f ERFLOW2:PTRMAP_O
2dce0 56 45 52 46 4c 4f 57 31 29 3b 0a 20 20 20 20 20 VERFLOW1);.
2dcf0 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 ptrmapPut(pBt
2dd00 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 65 54 79 70 , pgnoOvfl, eTyp
2dd10 65 2c 20 70 67 6e 6f 50 74 72 6d 61 70 2c 20 26 e, pgnoPtrmap, &
2dd20 72 63 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 rc);. if(
2dd30 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 rc ){.
2dd40 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4f 76 releasePage(pOv
2dd50 66 6c 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 fl);. }.
2dd60 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
2dd70 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
2dd80 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
2dd90 65 28 70 54 6f 52 65 6c 65 61 73 65 29 3b 0a 20 e(pToRelease);.
2dda0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
2ddb0 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
2ddc0 20 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 73 /* If pToReleas
2ddd0 65 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 68 e is not zero th
2dde0 61 6e 20 70 50 72 69 6f 72 20 70 6f 69 6e 74 73 an pPrior points
2ddf0 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 20 61 into the data a
2de00 72 65 61 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 rea. ** of
2de10 70 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 6b pToRelease. Mak
2de20 65 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 73 e sure pToReleas
2de30 65 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 e is still write
2de40 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 20 20 61 able. */. a
2de50 73 73 65 72 74 28 20 70 54 6f 52 65 6c 65 61 73 ssert( pToReleas
2de60 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 e==0 || sqlite3P
2de70 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
2de80 70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 pToRelease->pDbP
2de90 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 2f age) );.. /
2dea0 2a 20 49 66 20 70 50 72 69 6f 72 20 69 73 20 70 * If pPrior is p
2deb0 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 art of the data
2dec0 61 72 65 61 20 6f 66 20 70 50 61 67 65 2c 20 74 area of pPage, t
2ded0 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 70 50 hen make sure pP
2dee0 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 age. ** is
2def0 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 still writeable
2df00 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 */. assert(
2df10 20 70 50 72 69 6f 72 3c 70 50 61 67 65 2d 3e 61 pPrior<pPage->a
2df20 44 61 74 61 20 7c 7c 20 70 50 72 69 6f 72 3e 3d Data || pPrior>=
2df30 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
2df40 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 t->pageSize].
2df50 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 || sqli
2df60 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
2df70 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
2df80 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 70 75 ge) );.. pu
2df90 74 34 62 79 74 65 28 70 50 72 69 6f 72 2c 20 70 t4byte(pPrior, p
2dfa0 67 6e 6f 4f 76 66 6c 29 3b 0a 20 20 20 20 20 20 gnoOvfl);.
2dfb0 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 releasePage(pToR
2dfc0 65 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 70 elease);. p
2dfd0 54 6f 52 65 6c 65 61 73 65 20 3d 20 70 4f 76 66 ToRelease = pOvf
2dfe0 6c 3b 0a 20 20 20 20 20 20 70 50 72 69 6f 72 20 l;. pPrior
2dff0 3d 20 70 4f 76 66 6c 2d 3e 61 44 61 74 61 3b 0a = pOvfl->aData;.
2e000 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 70 put4byte(p
2e010 50 72 69 6f 72 2c 20 30 29 3b 0a 20 20 20 20 20 Prior, 0);.
2e020 20 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 4f 76 pPayload = &pOv
2e030 66 6c 2d 3e 61 44 61 74 61 5b 34 5d 3b 0a 20 20 fl->aData[4];.
2e040 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 spaceLeft =
2e050 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
2e060 2d 20 34 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e - 4;. }. n
2e070 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 = nPayload;.
2e080 20 69 66 28 20 6e 3e 73 70 61 63 65 4c 65 66 74 if( n>spaceLeft
2e090 20 29 20 6e 20 3d 20 73 70 61 63 65 4c 65 66 74 ) n = spaceLeft
2e0a0 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 70 54 6f ;.. /* If pTo
2e0b0 52 65 6c 65 61 73 65 20 69 73 20 6e 6f 74 20 7a Release is not z
2e0c0 65 72 6f 20 74 68 61 6e 20 70 50 61 79 6c 6f 61 ero than pPayloa
2e0d0 64 20 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 68 d points into th
2e0e0 65 20 64 61 74 61 20 61 72 65 61 0a 20 20 20 20 e data area.
2e0f0 2a 2a 20 6f 66 20 70 54 6f 52 65 6c 65 61 73 65 ** of pToRelease
2e100 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 70 54 6f . Make sure pTo
2e110 52 65 6c 65 61 73 65 20 69 73 20 73 74 69 6c 6c Release is still
2e120 20 77 72 69 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 writeable. */.
2e130 20 20 20 61 73 73 65 72 74 28 20 70 54 6f 52 65 assert( pToRe
2e140 6c 65 61 73 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 lease==0 || sqli
2e150 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
2e160 62 6c 65 28 70 54 6f 52 65 6c 65 61 73 65 2d 3e ble(pToRelease->
2e170 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 pDbPage) );..
2e180 20 2f 2a 20 49 66 20 70 50 61 79 6c 6f 61 64 20 /* If pPayload
2e190 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 is part of the d
2e1a0 61 74 61 20 61 72 65 61 20 6f 66 20 70 50 61 67 ata area of pPag
2e1b0 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 e, then make sur
2e1c0 65 20 70 50 61 67 65 0a 20 20 20 20 2a 2a 20 69 e pPage. ** i
2e1d0 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c s still writeabl
2e1e0 65 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 e */. assert(
2e1f0 20 70 50 61 79 6c 6f 61 64 3c 70 50 61 67 65 2d pPayload<pPage-
2e200 3e 61 44 61 74 61 20 7c 7c 20 70 50 61 79 6c 6f >aData || pPaylo
2e210 61 64 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 ad>=&pPage->aDat
2e220 61 5b 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d a[pBt->pageSize]
2e230 0a 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 . ||
2e240 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
2e250 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
2e260 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 DbPage) );..
2e270 69 66 28 20 6e 53 72 63 3e 30 20 29 7b 0a 20 20 if( nSrc>0 ){.
2e280 20 20 20 20 69 66 28 20 6e 3e 6e 53 72 63 20 29 if( n>nSrc )
2e290 20 6e 20 3d 20 6e 53 72 63 3b 0a 20 20 20 20 20 n = nSrc;.
2e2a0 20 61 73 73 65 72 74 28 20 70 53 72 63 20 29 3b assert( pSrc );
2e2b0 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 70 50 . memcpy(pP
2e2c0 61 79 6c 6f 61 64 2c 20 70 53 72 63 2c 20 6e 29 ayload, pSrc, n)
2e2d0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
2e2e0 20 20 20 6d 65 6d 73 65 74 28 70 50 61 79 6c 6f memset(pPaylo
2e2f0 61 64 2c 20 30 2c 20 6e 29 3b 0a 20 20 20 20 7d ad, 0, n);. }
2e300 0a 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 2d 3d . nPayload -=
2e310 20 6e 3b 0a 20 20 20 20 70 50 61 79 6c 6f 61 64 n;. pPayload
2e320 20 2b 3d 20 6e 3b 0a 20 20 20 20 70 53 72 63 20 += n;. pSrc
2e330 2b 3d 20 6e 3b 0a 20 20 20 20 6e 53 72 63 20 2d += n;. nSrc -
2e340 3d 20 6e 3b 0a 20 20 20 20 73 70 61 63 65 4c 65 = n;. spaceLe
2e350 66 74 20 2d 3d 20 6e 3b 0a 20 20 20 20 69 66 28 ft -= n;. if(
2e360 20 6e 53 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 nSrc==0 ){.
2e370 20 20 6e 53 72 63 20 3d 20 6e 44 61 74 61 3b 0a nSrc = nData;.
2e380 20 20 20 20 20 20 70 53 72 63 20 3d 20 70 44 61 pSrc = pDa
2e390 74 61 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 ta;. }. }.
2e3a0 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 releasePage(pToR
2e3b0 65 6c 65 61 73 65 29 3b 0a 20 20 72 65 74 75 72 elease);. retur
2e3c0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
2e3d0 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 74 68 65 /*.** Remove the
2e3e0 20 69 2d 74 68 20 63 65 6c 6c 20 66 72 6f 6d 20 i-th cell from
2e3f0 70 50 61 67 65 2e 20 20 54 68 69 73 20 72 6f 75 pPage. This rou
2e400 74 69 6e 65 20 65 66 66 65 63 74 73 20 70 50 61 tine effects pPa
2e410 67 65 20 6f 6e 6c 79 2e 0a 2a 2a 20 54 68 65 20 ge only..** The
2e420 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 73 20 cell content is
2e430 6e 6f 74 20 66 72 65 65 64 20 6f 72 20 64 65 61 not freed or dea
2e440 6c 6c 6f 63 61 74 65 64 2e 20 20 49 74 20 69 73 llocated. It is
2e450 20 61 73 73 75 6d 65 64 20 74 68 61 74 0a 2a 2a assumed that.**
2e460 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e the cell conten
2e470 74 20 68 61 73 20 62 65 65 6e 20 63 6f 70 69 65 t has been copie
2e480 64 20 73 6f 6d 65 70 6c 61 63 65 20 65 6c 73 65 d someplace else
2e490 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
2e4a0 6a 75 73 74 0a 2a 2a 20 72 65 6d 6f 76 65 73 20 just.** removes
2e4b0 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f the reference to
2e4c0 20 74 68 65 20 63 65 6c 6c 20 66 72 6f 6d 20 70 the cell from p
2e4d0 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 22 73 7a 22 Page..**.** "sz"
2e4e0 20 6d 75 73 74 20 62 65 20 74 68 65 20 6e 75 6d must be the num
2e4f0 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
2e500 74 68 65 20 63 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 the cell..*/.sta
2e510 74 69 63 20 76 6f 69 64 20 64 72 6f 70 43 65 6c tic void dropCel
2e520 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 l(MemPage *pPage
2e530 2c 20 69 6e 74 20 69 64 78 2c 20 69 6e 74 20 73 , int idx, int s
2e540 7a 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 z, int *pRC){.
2e550 75 33 32 20 70 63 3b 20 20 20 20 20 20 20 20 20 u32 pc;
2e560 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 63 65 6c /* Offset to cel
2e570 6c 20 63 6f 6e 74 65 6e 74 20 6f 66 20 63 65 6c l content of cel
2e580 6c 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 l being deleted
2e590 2a 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 */. u8 *data;
2e5a0 20 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e 61 /* pPage->a
2e5b0 44 61 74 61 20 2a 2f 0a 20 20 75 38 20 2a 70 74 Data */. u8 *pt
2e5c0 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 r; /* Use
2e5d0 64 20 74 6f 20 6d 6f 76 65 20 62 79 74 65 73 20 d to move bytes
2e5e0 61 72 6f 75 6e 64 20 77 69 74 68 69 6e 20 64 61 around within da
2e5f0 74 61 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a 65 6e ta[] */. u8 *en
2e600 64 50 74 72 3b 20 20 20 20 20 2f 2a 20 45 6e 64 dPtr; /* End
2e610 20 6f 66 20 6c 6f 6f 70 20 2a 2f 0a 20 20 69 6e of loop */. in
2e620 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 2f 2a t rc; /*
2e630 20 54 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 The return code
2e640 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 */. int hdr;
2e650 20 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 6e 69 /* Beginni
2e660 6e 67 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 ng of the header
2e670 2e 20 20 30 20 6d 6f 73 74 20 70 61 67 65 73 2e . 0 most pages.
2e680 20 20 31 30 30 20 70 61 67 65 20 31 20 2a 2f 0a 100 page 1 */.
2e690 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 . if( *pRC ) re
2e6a0 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 turn;.. assert(
2e6b0 20 69 64 78 3e 3d 30 20 26 26 20 69 64 78 3c 70 idx>=0 && idx<p
2e6c0 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 Page->nCell );.
2e6d0 20 61 73 73 65 72 74 28 20 73 7a 3d 3d 63 65 6c assert( sz==cel
2e6e0 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 69 64 78 lSize(pPage, idx
2e6f0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2e700 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
2e710 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 teable(pPage->pD
2e720 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 65 bPage) );. asse
2e730 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2e740 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
2e750 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 64 t->mutex) );. d
2e760 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 ata = pPage->aDa
2e770 74 61 3b 0a 20 20 70 74 72 20 3d 20 26 70 50 61 ta;. ptr = &pPa
2e780 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 69 ge->aCellIdx[2*i
2e790 64 78 5d 3b 0a 20 20 70 63 20 3d 20 67 65 74 32 dx];. pc = get2
2e7a0 62 79 74 65 28 70 74 72 29 3b 0a 20 20 68 64 72 byte(ptr);. hdr
2e7b0 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 = pPage->hdrOff
2e7c0 73 65 74 3b 0a 20 20 74 65 73 74 63 61 73 65 28 set;. testcase(
2e7d0 20 70 63 3d 3d 67 65 74 32 62 79 74 65 28 26 64 pc==get2byte(&d
2e7e0 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 3b 0a 20 ata[hdr+5]) );.
2e7f0 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 7a testcase( pc+sz
2e800 3d 3d 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 ==pPage->pBt->us
2e810 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 69 66 ableSize );. if
2e820 28 20 70 63 20 3c 20 28 75 33 32 29 67 65 74 32 ( pc < (u32)get2
2e830 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
2e840 5d 29 20 7c 7c 20 70 63 2b 73 7a 20 3e 20 70 50 ]) || pc+sz > pP
2e850 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
2e860 53 69 7a 65 20 29 7b 0a 20 20 20 20 2a 70 52 43 Size ){. *pRC
2e870 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
2e880 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 T_BKPT;. retu
2e890 72 6e 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 66 rn;. }. rc = f
2e8a0 72 65 65 53 70 61 63 65 28 70 50 61 67 65 2c 20 reeSpace(pPage,
2e8b0 70 63 2c 20 73 7a 29 3b 0a 20 20 69 66 28 20 72 pc, sz);. if( r
2e8c0 63 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 c ){. *pRC =
2e8d0 72 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a rc;. return;.
2e8e0 20 20 7d 0a 20 20 65 6e 64 50 74 72 20 3d 20 26 }. endPtr = &
2e8f0 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b pPage->aCellIdx[
2e900 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 2*pPage->nCell -
2e910 20 32 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 28 2];. assert( (
2e920 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e SQLITE_PTR_TO_IN
2e930 54 28 70 74 72 29 26 31 29 3d 3d 30 20 29 3b 20 T(ptr)&1)==0 );
2e940 20 2f 2a 20 70 74 72 20 69 73 20 61 6c 77 61 79 /* ptr is alway
2e950 73 20 32 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 s 2-byte aligned
2e960 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 70 74 72 */. while( ptr
2e970 3c 65 6e 64 50 74 72 20 29 7b 0a 20 20 20 20 2a <endPtr ){. *
2e980 28 75 31 36 2a 29 70 74 72 20 3d 20 2a 28 75 31 (u16*)ptr = *(u1
2e990 36 2a 29 26 70 74 72 5b 32 5d 3b 0a 20 20 20 20 6*)&ptr[2];.
2e9a0 70 74 72 20 2b 3d 20 32 3b 0a 20 20 7d 0a 20 20 ptr += 2;. }.
2e9b0 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d 2d 3b 0a pPage->nCell--;.
2e9c0 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
2e9d0 5b 68 64 72 2b 33 5d 2c 20 70 50 61 67 65 2d 3e [hdr+3], pPage->
2e9e0 6e 43 65 6c 6c 29 3b 0a 20 20 70 50 61 67 65 2d nCell);. pPage-
2e9f0 3e 6e 46 72 65 65 20 2b 3d 20 32 3b 0a 7d 0a 0a >nFree += 2;.}..
2ea00 2f 2a 0a 2a 2a 20 49 6e 73 65 72 74 20 61 20 6e /*.** Insert a n
2ea10 65 77 20 63 65 6c 6c 20 6f 6e 20 70 50 61 67 65 ew cell on pPage
2ea20 20 61 74 20 63 65 6c 6c 20 69 6e 64 65 78 20 22 at cell index "
2ea30 69 22 2e 20 20 70 43 65 6c 6c 20 70 6f 69 6e 74 i". pCell point
2ea40 73 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 s to the.** cont
2ea50 65 6e 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e ent of the cell.
2ea60 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 65 .**.** If the ce
2ea70 6c 6c 20 63 6f 6e 74 65 6e 74 20 77 69 6c 6c 20 ll content will
2ea80 66 69 74 20 6f 6e 20 74 68 65 20 70 61 67 65 2c fit on the page,
2ea90 20 74 68 65 6e 20 70 75 74 20 69 74 20 74 68 65 then put it the
2eaa0 72 65 2e 20 20 49 66 20 69 74 0a 2a 2a 20 77 69 re. If it.** wi
2eab0 6c 6c 20 6e 6f 74 20 66 69 74 2c 20 74 68 65 6e ll not fit, then
2eac0 20 6d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 make a copy of
2ead0 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
2eae0 20 69 6e 74 6f 20 70 54 65 6d 70 20 69 66 0a 2a into pTemp if.*
2eaf0 2a 20 70 54 65 6d 70 20 69 73 20 6e 6f 74 20 6e * pTemp is not n
2eb00 75 6c 6c 2e 20 20 52 65 67 61 72 64 6c 65 73 73 ull. Regardless
2eb10 20 6f 66 20 70 54 65 6d 70 2c 20 61 6c 6c 6f 63 of pTemp, alloc
2eb20 61 74 65 20 61 20 6e 65 77 20 65 6e 74 72 79 0a ate a new entry.
2eb30 2a 2a 20 69 6e 20 70 50 61 67 65 2d 3e 61 70 4f ** in pPage->apO
2eb40 76 66 6c 5b 5d 20 61 6e 64 20 6d 61 6b 65 20 69 vfl[] and make i
2eb50 74 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 63 t point to the c
2eb60 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 28 65 69 74 ell content (eit
2eb70 68 65 72 0a 2a 2a 20 69 6e 20 70 54 65 6d 70 20 her.** in pTemp
2eb80 6f 72 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 or the original
2eb90 70 43 65 6c 6c 29 20 61 6e 64 20 61 6c 73 6f 20 pCell) and also
2eba0 72 65 63 6f 72 64 20 69 74 73 20 69 6e 64 65 78 record its index
2ebb0 2e 20 0a 2a 2a 20 41 6c 6c 6f 63 61 74 69 6e 67 . .** Allocating
2ebc0 20 61 20 6e 65 77 20 65 6e 74 72 79 20 69 6e 20 a new entry in
2ebd0 70 50 61 67 65 2d 3e 61 43 65 6c 6c 5b 5d 20 69 pPage->aCell[] i
2ebe0 6d 70 6c 69 65 73 20 74 68 61 74 20 0a 2a 2a 20 mplies that .**
2ebf0 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
2ec00 20 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 2e is incremented.
2ec10 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 53 6b 69 70 20 .**.** If nSkip
2ec20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 is non-zero, the
2ec30 6e 20 64 6f 20 6e 6f 74 20 63 6f 70 79 20 74 68 n do not copy th
2ec40 65 20 66 69 72 73 74 20 6e 53 6b 69 70 20 62 79 e first nSkip by
2ec50 74 65 73 20 6f 66 20 74 68 65 0a 2a 2a 20 63 65 tes of the.** ce
2ec60 6c 6c 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 ll. The caller w
2ec70 69 6c 6c 20 6f 76 65 72 77 72 69 74 65 20 74 68 ill overwrite th
2ec80 65 6d 20 61 66 74 65 72 20 74 68 69 73 20 66 75 em after this fu
2ec90 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 nction returns.
2eca0 49 66 0a 2a 2a 20 6e 53 6b 69 70 20 69 73 20 6e If.** nSkip is n
2ecb0 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 70 43 on-zero, then pC
2ecc0 65 6c 6c 20 6d 61 79 20 6e 6f 74 20 70 6f 69 6e ell may not poin
2ecd0 74 20 74 6f 20 61 6e 20 69 6e 76 61 6c 69 64 20 t to an invalid
2ece0 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 20 memory location
2ecf0 0a 2a 2a 20 28 62 75 74 20 70 43 65 6c 6c 2b 6e .** (but pCell+n
2ed00 53 6b 69 70 20 69 73 20 61 6c 77 61 79 73 20 76 Skip is always v
2ed10 61 6c 69 64 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 alid)..*/.static
2ed20 20 76 6f 69 64 20 69 6e 73 65 72 74 43 65 6c 6c void insertCell
2ed30 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
2ed40 67 65 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 6e ge, /* Page in
2ed50 74 6f 20 77 68 69 63 68 20 77 65 20 61 72 65 20 to which we are
2ed60 63 6f 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 copying */. int
2ed70 20 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f i, /
2ed80 2a 20 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f 6d * New cell becom
2ed90 65 73 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c es the i-th cell
2eda0 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a of the page */.
2edb0 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 u8 *pCell,
2edc0 20 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 6f /* Content o
2edd0 66 20 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 2a f the new cell *
2ede0 2f 0a 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 20 /. int sz,
2edf0 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f /* Bytes o
2ee00 66 20 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 65 f content in pCe
2ee10 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 6d ll */. u8 *pTem
2ee20 70 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d p, /* Tem
2ee30 70 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 p storage space
2ee40 66 6f 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e 65 for pCell, if ne
2ee50 65 64 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 eded */. Pgno i
2ee60 43 68 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 49 Child, /* I
2ee70 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 6c f non-zero, repl
2ee80 61 63 65 20 66 69 72 73 74 20 34 20 62 79 74 65 ace first 4 byte
2ee90 73 20 77 69 74 68 20 74 68 69 73 20 76 61 6c 75 s with this valu
2eea0 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 20 e */. int *pRC
2eeb0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 /* Read
2eec0 20 61 6e 64 20 77 72 69 74 65 20 72 65 74 75 72 and write retur
2eed0 6e 20 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 65 n code from here
2eee0 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 78 */.){. int idx
2eef0 20 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 68 = 0; /* Wh
2ef00 65 72 65 20 74 6f 20 77 72 69 74 65 20 6e 65 77 ere to write new
2ef10 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e cell content in
2ef20 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 data[] */. int
2ef30 20 6a 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f j; /
2ef40 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
2ef50 2f 0a 20 20 69 6e 74 20 65 6e 64 3b 20 20 20 20 /. int end;
2ef60 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 /* First b
2ef70 79 74 65 20 70 61 73 74 20 74 68 65 20 6c 61 73 yte past the las
2ef80 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 t cell pointer i
2ef90 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e n data[] */. in
2efa0 74 20 69 6e 73 3b 20 20 20 20 20 20 20 20 20 20 t ins;
2efb0 2f 2a 20 49 6e 64 65 78 20 69 6e 20 64 61 74 61 /* Index in data
2efc0 5b 5d 20 77 68 65 72 65 20 6e 65 77 20 63 65 6c [] where new cel
2efd0 6c 20 70 6f 69 6e 74 65 72 20 69 73 20 69 6e 73 l pointer is ins
2efe0 65 72 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 63 erted */. int c
2eff0 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 2f 2a 20 ellOffset; /*
2f000 41 64 64 72 65 73 73 20 6f 66 20 66 69 72 73 74 Address of first
2f010 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 6e cell pointer in
2f020 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 75 38 20 data[] */. u8
2f030 2a 64 61 74 61 3b 20 20 20 20 20 20 20 20 20 2f *data; /
2f040 2a 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 * The content of
2f050 20 74 68 65 20 77 68 6f 6c 65 20 70 61 67 65 20 the whole page
2f060 2a 2f 0a 20 20 75 38 20 2a 70 74 72 3b 20 20 20 */. u8 *ptr;
2f070 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 66 /* Used f
2f080 6f 72 20 6d 6f 76 69 6e 67 20 69 6e 66 6f 72 6d or moving inform
2f090 61 74 69 6f 6e 20 61 72 6f 75 6e 64 20 69 6e 20 ation around in
2f0a0 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a data[] */. u8 *
2f0b0 65 6e 64 50 74 72 3b 20 20 20 20 20 20 20 2f 2a endPtr; /*
2f0c0 20 45 6e 64 20 6f 66 20 74 68 65 20 6c 6f 6f 70 End of the loop
2f0d0 20 2a 2f 0a 0a 20 20 69 6e 74 20 6e 53 6b 69 70 */.. int nSkip
2f0e0 20 3d 20 28 69 43 68 69 6c 64 20 3f 20 34 20 3a = (iChild ? 4 :
2f0f0 20 30 29 3b 0a 0a 20 20 69 66 28 20 2a 70 52 43 0);.. if( *pRC
2f100 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 ) return;.. as
2f110 73 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69 3c sert( i>=0 && i<
2f120 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 70 50 =pPage->nCell+pP
2f130 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 age->nOverflow )
2f140 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
2f150 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d 58 5f 43 45 4c e->nCell<=MX_CEL
2f160 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 20 26 26 L(pPage->pBt) &&
2f170 20 4d 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e MX_CELL(pPage->
2f180 70 42 74 29 3c 3d 31 30 39 32 31 20 29 3b 0a 20 pBt)<=10921 );.
2f190 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
2f1a0 6e 4f 76 65 72 66 6c 6f 77 3c 3d 41 72 72 61 79 nOverflow<=Array
2f1b0 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 4f 76 Size(pPage->apOv
2f1c0 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 fl) );. assert(
2f1d0 20 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 ArraySize(pPage
2f1e0 2d 3e 61 70 4f 76 66 6c 29 3d 3d 41 72 72 61 79 ->apOvfl)==Array
2f1f0 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 69 4f 76 Size(pPage->aiOv
2f200 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 fl) );. assert(
2f210 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2f220 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
2f230 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 mutex) );. /* T
2f240 68 65 20 63 65 6c 6c 20 73 68 6f 75 6c 64 20 6e he cell should n
2f250 6f 72 6d 61 6c 6c 79 20 62 65 20 73 69 7a 65 64 ormally be sized
2f260 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 48 6f 77 correctly. How
2f270 65 76 65 72 2c 20 77 68 65 6e 20 6d 6f 76 69 6e ever, when movin
2f280 67 20 61 0a 20 20 2a 2a 20 6d 61 6c 66 6f 72 6d g a. ** malform
2f290 65 64 20 63 65 6c 6c 20 66 72 6f 6d 20 61 20 6c ed cell from a l
2f2a0 65 61 66 20 70 61 67 65 20 74 6f 20 61 6e 20 69 eaf page to an i
2f2b0 6e 74 65 72 69 6f 72 20 70 61 67 65 2c 20 69 66 nterior page, if
2f2c0 20 74 68 65 20 63 65 6c 6c 20 73 69 7a 65 0a 20 the cell size.
2f2d0 20 2a 2a 20 77 61 6e 74 65 64 20 74 6f 20 62 65 ** wanted to be
2f2e0 20 6c 65 73 73 20 74 68 61 6e 20 34 20 62 75 74 less than 4 but
2f2f0 20 67 6f 74 20 72 6f 75 6e 64 65 64 20 75 70 20 got rounded up
2f300 74 6f 20 34 20 6f 6e 20 74 68 65 20 6c 65 61 66 to 4 on the leaf
2f310 2c 20 74 68 65 6e 20 73 69 7a 65 0a 20 20 2a 2a , then size. **
2f320 20 6d 69 67 68 74 20 62 65 20 6c 65 73 73 20 74 might be less t
2f330 68 61 6e 20 38 20 28 6c 65 61 66 2d 73 69 7a 65 han 8 (leaf-size
2f340 20 2b 20 70 6f 69 6e 74 65 72 29 20 6f 6e 20 74 + pointer) on t
2f350 68 65 20 69 6e 74 65 72 69 6f 72 20 6e 6f 64 65 he interior node
2f360 2e 20 20 48 65 6e 63 65 0a 20 20 2a 2a 20 74 68 . Hence. ** th
2f370 65 20 74 65 72 6d 20 61 66 74 65 72 20 74 68 65 e term after the
2f380 20 7c 7c 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f || in the follo
2f390 77 69 6e 67 20 61 73 73 65 72 74 28 29 2e 20 2a wing assert(). *
2f3a0 2f 0a 20 20 61 73 73 65 72 74 28 20 73 7a 3d 3d /. assert( sz==
2f3b0 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 67 cellSizePtr(pPag
2f3c0 65 2c 20 70 43 65 6c 6c 29 20 7c 7c 20 28 73 7a e, pCell) || (sz
2f3d0 3d 3d 38 20 26 26 20 69 43 68 69 6c 64 3e 30 29 ==8 && iChild>0)
2f3e0 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d );. if( pPage-
2f3f0 3e 6e 4f 76 65 72 66 6c 6f 77 20 7c 7c 20 73 7a >nOverflow || sz
2f400 2b 32 3e 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 +2>pPage->nFree
2f410 29 7b 0a 20 20 20 20 69 66 28 20 70 54 65 6d 70 ){. if( pTemp
2f420 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 ){. memcpy
2f430 28 70 54 65 6d 70 2b 6e 53 6b 69 70 2c 20 70 43 (pTemp+nSkip, pC
2f440 65 6c 6c 2b 6e 53 6b 69 70 2c 20 73 7a 2d 6e 53 ell+nSkip, sz-nS
2f450 6b 69 70 29 3b 0a 20 20 20 20 20 20 70 43 65 6c kip);. pCel
2f460 6c 20 3d 20 70 54 65 6d 70 3b 0a 20 20 20 20 7d l = pTemp;. }
2f470 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 20 . if( iChild
2f480 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 ){. put4byt
2f490 65 28 70 43 65 6c 6c 2c 20 69 43 68 69 6c 64 29 e(pCell, iChild)
2f4a0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6a 20 3d 20 ;. }. j =
2f4b0 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
2f4c0 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ++;. assert(
2f4d0 6a 3c 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 70 j<(int)(sizeof(p
2f4e0 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 2f 73 69 Page->apOvfl)/si
2f4f0 7a 65 6f 66 28 70 50 61 67 65 2d 3e 61 70 4f 76 zeof(pPage->apOv
2f500 66 6c 5b 30 5d 29 29 20 29 3b 0a 20 20 20 20 70 fl[0])) );. p
2f510 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 6a 5d 20 Page->apOvfl[j]
2f520 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 20 70 50 61 = pCell;. pPa
2f530 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 5d 20 3d 20 ge->aiOvfl[j] =
2f540 28 75 31 36 29 69 3b 0a 20 20 7d 65 6c 73 65 7b (u16)i;. }else{
2f550 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71 . int rc = sq
2f560 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
2f570 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b pPage->pDbPage);
2f580 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
2f590 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2f5a0 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 20 *pRC = rc;.
2f5b0 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 return;. }.
2f5c0 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
2f5d0 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
2f5e0 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
2f5f0 65 29 20 29 3b 0a 20 20 20 20 64 61 74 61 20 3d e) );. data =
2f600 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 pPage->aData;.
2f610 20 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 cellOffset =
2f620 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
2f630 74 3b 0a 20 20 20 20 65 6e 64 20 3d 20 63 65 6c t;. end = cel
2f640 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 61 67 lOffset + 2*pPag
2f650 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e e->nCell;. in
2f660 73 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b s = cellOffset +
2f670 20 32 2a 69 3b 0a 20 20 20 20 72 63 20 3d 20 61 2*i;. rc = a
2f680 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 70 50 61 llocateSpace(pPa
2f690 67 65 2c 20 73 7a 2c 20 26 69 64 78 29 3b 0a 20 ge, sz, &idx);.
2f6a0 20 20 20 69 66 28 20 72 63 20 29 7b 20 2a 70 52 if( rc ){ *pR
2f6b0 43 20 3d 20 72 63 3b 20 72 65 74 75 72 6e 3b 20 C = rc; return;
2f6c0 7d 0a 20 20 20 20 2f 2a 20 54 68 65 20 61 6c 6c }. /* The all
2f6d0 6f 63 61 74 65 53 70 61 63 65 28 29 20 72 6f 75 ocateSpace() rou
2f6e0 74 69 6e 65 20 67 75 61 72 61 6e 74 65 65 73 20 tine guarantees
2f6f0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 the following tw
2f700 6f 20 70 72 6f 70 65 72 74 69 65 73 0a 20 20 20 o properties.
2f710 20 2a 2a 20 69 66 20 69 74 20 72 65 74 75 72 6e ** if it return
2f720 73 20 73 75 63 63 65 73 73 20 2a 2f 0a 20 20 20 s success */.
2f730 20 61 73 73 65 72 74 28 20 69 64 78 20 3e 3d 20 assert( idx >=
2f740 65 6e 64 2b 32 20 29 3b 0a 20 20 20 20 61 73 73 end+2 );. ass
2f750 65 72 74 28 20 69 64 78 2b 73 7a 20 3c 3d 20 28 ert( idx+sz <= (
2f760 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e int)pPage->pBt->
2f770 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
2f780 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 2b pPage->nCell++
2f790 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 ;. pPage->nFr
2f7a0 65 65 20 2d 3d 20 28 75 31 36 29 28 32 20 2b 20 ee -= (u16)(2 +
2f7b0 73 7a 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 sz);. memcpy(
2f7c0 26 64 61 74 61 5b 69 64 78 2b 6e 53 6b 69 70 5d &data[idx+nSkip]
2f7d0 2c 20 70 43 65 6c 6c 2b 6e 53 6b 69 70 2c 20 73 , pCell+nSkip, s
2f7e0 7a 2d 6e 53 6b 69 70 29 3b 0a 20 20 20 20 69 66 z-nSkip);. if
2f7f0 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 20 ( iChild ){.
2f800 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 61 put4byte(&data
2f810 5b 69 64 78 5d 2c 20 69 43 68 69 6c 64 29 3b 0a [idx], iChild);.
2f820 20 20 20 20 7d 0a 20 20 20 20 70 74 72 20 3d 20 }. ptr =
2f830 26 64 61 74 61 5b 65 6e 64 5d 3b 0a 20 20 20 20 &data[end];.
2f840 65 6e 64 50 74 72 20 3d 20 26 64 61 74 61 5b 69 endPtr = &data[i
2f850 6e 73 5d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ns];. assert(
2f860 20 28 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f (SQLITE_PTR_TO_
2f870 49 4e 54 28 70 74 72 29 26 31 29 3d 3d 30 20 29 INT(ptr)&1)==0 )
2f880 3b 20 20 2f 2a 20 70 74 72 20 69 73 20 61 6c 77 ; /* ptr is alw
2f890 61 79 73 20 32 2d 62 79 74 65 20 61 6c 69 67 6e ays 2-byte align
2f8a0 65 64 20 2a 2f 0a 20 20 20 20 77 68 69 6c 65 28 ed */. while(
2f8b0 20 70 74 72 3e 65 6e 64 50 74 72 20 29 7b 0a 20 ptr>endPtr ){.
2f8c0 20 20 20 20 20 2a 28 75 31 36 2a 29 70 74 72 20 *(u16*)ptr
2f8d0 3d 20 2a 28 75 31 36 2a 29 26 70 74 72 5b 2d 32 = *(u16*)&ptr[-2
2f8e0 5d 3b 0a 20 20 20 20 20 20 70 74 72 20 2d 3d 20 ];. ptr -=
2f8f0 32 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 75 74 2;. }. put
2f900 32 62 79 74 65 28 26 64 61 74 61 5b 69 6e 73 5d 2byte(&data[ins]
2f910 2c 20 69 64 78 29 3b 0a 20 20 20 20 70 75 74 32 , idx);. put2
2f920 62 79 74 65 28 26 64 61 74 61 5b 70 50 61 67 65 byte(&data[pPage
2f930 2d 3e 68 64 72 4f 66 66 73 65 74 2b 33 5d 2c 20 ->hdrOffset+3],
2f940 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 23 pPage->nCell);.#
2f950 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2f960 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
2f970 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 42 74 if( pPage->pBt
2f980 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a ->autoVacuum ){.
2f990 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 65 6c /* The cel
2f9a0 6c 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 61 20 l may contain a
2f9b0 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 6f 76 pointer to an ov
2f9c0 65 72 66 6c 6f 77 20 70 61 67 65 2e 20 49 66 20 erflow page. If
2f9d0 73 6f 2c 20 77 72 69 74 65 0a 20 20 20 20 20 20 so, write.
2f9e0 2a 2a 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 ** the entry for
2f9f0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
2fa00 67 65 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e ge into the poin
2fa10 74 65 72 20 6d 61 70 2e 0a 20 20 20 20 20 20 2a ter map.. *
2fa20 2f 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 /. ptrmapPu
2fa30 74 4f 76 66 6c 50 74 72 28 70 50 61 67 65 2c 20 tOvflPtr(pPage,
2fa40 70 43 65 6c 6c 2c 20 70 52 43 29 3b 0a 20 20 20 pCell, pRC);.
2fa50 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 7d 0a }.#endif. }.}.
2fa60 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6c 69 73 ./*.** Add a lis
2fa70 74 20 6f 66 20 63 65 6c 6c 73 20 74 6f 20 61 20 t of cells to a
2fa80 70 61 67 65 2e 20 20 54 68 65 20 70 61 67 65 20 page. The page
2fa90 73 68 6f 75 6c 64 20 62 65 20 69 6e 69 74 69 61 should be initia
2faa0 6c 6c 79 20 65 6d 70 74 79 2e 0a 2a 2a 20 54 68 lly empty..** Th
2fab0 65 20 63 65 6c 6c 73 20 61 72 65 20 67 75 61 72 e cells are guar
2fac0 61 6e 74 65 65 64 20 74 6f 20 66 69 74 20 6f 6e anteed to fit on
2fad0 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 the page..*/.st
2fae0 61 74 69 63 20 76 6f 69 64 20 61 73 73 65 6d 62 atic void assemb
2faf0 6c 65 50 61 67 65 28 0a 20 20 4d 65 6d 50 61 67 lePage(. MemPag
2fb00 65 20 2a 70 50 61 67 65 2c 20 20 20 2f 2a 20 54 e *pPage, /* T
2fb10 68 65 20 70 61 67 65 20 74 6f 20 62 65 20 61 73 he page to be as
2fb20 73 65 6d 62 6c 69 65 64 20 2a 2f 0a 20 20 69 6e semblied */. in
2fb30 74 20 6e 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 t nCell,
2fb40 2f 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 /* The number of
2fb50 20 63 65 6c 6c 73 20 74 6f 20 61 64 64 20 74 6f cells to add to
2fb60 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a 20 20 this page */.
2fb70 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 u8 **apCell,
2fb80 20 20 2f 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f /* Pointers to
2fb90 20 63 65 6c 6c 20 62 6f 64 69 65 73 20 2a 2f 0a cell bodies */.
2fba0 20 20 75 31 36 20 2a 61 53 69 7a 65 20 20 20 20 u16 *aSize
2fbb0 20 20 20 20 2f 2a 20 53 69 7a 65 73 20 6f 66 20 /* Sizes of
2fbc0 74 68 65 20 63 65 6c 6c 73 20 2a 2f 0a 29 7b 0a the cells */.){.
2fbd0 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 int i;
2fbe0 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
2fbf0 74 65 72 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 ter */. u8 *pCe
2fc00 6c 6c 70 74 72 3b 20 20 20 20 20 2f 2a 20 41 64 llptr; /* Ad
2fc10 64 72 65 73 73 20 6f 66 20 6e 65 78 74 20 63 65 dress of next ce
2fc20 6c 6c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 ll pointer */.
2fc30 69 6e 74 20 63 65 6c 6c 62 6f 64 79 3b 20 20 20 int cellbody;
2fc40 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 /* Address of
2fc50 6e 65 78 74 20 63 65 6c 6c 20 62 6f 64 79 20 2a next cell body *
2fc60 2f 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 64 /. u8 * const d
2fc70 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 ata = pPage->aDa
2fc80 74 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ta;
2fc90 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 64 61 /* Pointer to da
2fca0 74 61 20 66 6f 72 20 70 50 61 67 65 20 2a 2f 0a ta for pPage */.
2fcb0 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 64 72 20 const int hdr
2fcc0 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 = pPage->hdrOffs
2fcd0 65 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a et; /*
2fce0 20 4f 66 66 73 65 74 20 6f 66 20 68 65 61 64 65 Offset of heade
2fcf0 72 20 6f 6e 20 70 50 61 67 65 20 2a 2f 0a 20 20 r on pPage */.
2fd00 63 6f 6e 73 74 20 69 6e 74 20 6e 55 73 61 62 6c const int nUsabl
2fd10 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e e = pPage->pBt->
2fd20 75 73 61 62 6c 65 53 69 7a 65 3b 20 2f 2a 20 55 usableSize; /* U
2fd30 73 61 62 6c 65 20 73 69 7a 65 20 6f 66 20 70 61 sable size of pa
2fd40 67 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 ge */.. assert(
2fd50 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
2fd60 77 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 w==0 );. assert
2fd70 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2fd80 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
2fd90 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
2fda0 65 72 74 28 20 6e 43 65 6c 6c 3e 3d 30 20 26 26 ert( nCell>=0 &&
2fdb0 20 6e 43 65 6c 6c 3c 3d 28 69 6e 74 29 4d 58 5f nCell<=(int)MX_
2fdc0 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 CELL(pPage->pBt)
2fdd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 . &&
2fde0 28 69 6e 74 29 4d 58 5f 43 45 4c 4c 28 70 50 61 (int)MX_CELL(pPa
2fdf0 67 65 2d 3e 70 42 74 29 3c 3d 31 30 39 32 31 29 ge->pBt)<=10921)
2fe00 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
2fe10 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
2fe20 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
2fe30 67 65 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 ge) );.. /* Che
2fe40 63 6b 20 74 68 61 74 20 74 68 65 20 70 61 67 65 ck that the page
2fe50 20 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 7a has just been z
2fe60 65 72 6f 65 64 20 62 79 20 7a 65 72 6f 50 61 67 eroed by zeroPag
2fe70 65 28 29 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 e() */. assert(
2fe80 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 pPage->nCell==0
2fe90 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 67 65 );. assert( ge
2fea0 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 64 t2byteNotZero(&d
2feb0 61 74 61 5b 68 64 72 2b 35 5d 29 3d 3d 6e 55 73 ata[hdr+5])==nUs
2fec0 61 62 6c 65 20 29 3b 0a 0a 20 20 70 43 65 6c 6c able );.. pCell
2fed0 70 74 72 20 3d 20 26 70 50 61 67 65 2d 3e 61 43 ptr = &pPage->aC
2fee0 65 6c 6c 49 64 78 5b 6e 43 65 6c 6c 2a 32 5d 3b ellIdx[nCell*2];
2fef0 0a 20 20 63 65 6c 6c 62 6f 64 79 20 3d 20 6e 55 . cellbody = nU
2ff00 73 61 62 6c 65 3b 0a 20 20 66 6f 72 28 69 3d 6e sable;. for(i=n
2ff10 43 65 6c 6c 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d Cell-1; i>=0; i-
2ff20 2d 29 7b 0a 20 20 20 20 75 31 36 20 73 7a 20 3d -){. u16 sz =
2ff30 20 61 53 69 7a 65 5b 69 5d 3b 0a 20 20 20 20 70 aSize[i];. p
2ff40 43 65 6c 6c 70 74 72 20 2d 3d 20 32 3b 0a 20 20 Cellptr -= 2;.
2ff50 20 20 63 65 6c 6c 62 6f 64 79 20 2d 3d 20 73 7a cellbody -= sz
2ff60 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 70 ;. put2byte(p
2ff70 43 65 6c 6c 70 74 72 2c 20 63 65 6c 6c 62 6f 64 Cellptr, cellbod
2ff80 79 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 y);. memcpy(&
2ff90 64 61 74 61 5b 63 65 6c 6c 62 6f 64 79 5d 2c 20 data[cellbody],
2ffa0 61 70 43 65 6c 6c 5b 69 5d 2c 20 73 7a 29 3b 0a apCell[i], sz);.
2ffb0 20 20 7d 0a 20 20 70 75 74 32 62 79 74 65 28 26 }. put2byte(&
2ffc0 64 61 74 61 5b 68 64 72 2b 33 5d 2c 20 6e 43 65 data[hdr+3], nCe
2ffd0 6c 6c 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 ll);. put2byte(
2ffe0 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 63 65 &data[hdr+5], ce
2fff0 6c 6c 62 6f 64 79 29 3b 0a 20 20 70 50 61 67 65 llbody);. pPage
30000 2d 3e 6e 46 72 65 65 20 2d 3d 20 28 6e 43 65 6c ->nFree -= (nCel
30010 6c 2a 32 20 2b 20 6e 55 73 61 62 6c 65 20 2d 20 l*2 + nUsable -
30020 63 65 6c 6c 62 6f 64 79 29 3b 0a 20 20 70 50 61 cellbody);. pPa
30030 67 65 2d 3e 6e 43 65 6c 6c 20 3d 20 28 75 31 36 ge->nCell = (u16
30040 29 6e 43 65 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a )nCell;.}../*.**
30050 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 The following p
30060 61 72 61 6d 65 74 65 72 73 20 64 65 74 65 72 6d arameters determ
30070 69 6e 65 20 68 6f 77 20 6d 61 6e 79 20 61 64 6a ine how many adj
30080 61 63 65 6e 74 20 70 61 67 65 73 20 67 65 74 20 acent pages get
30090 69 6e 76 6f 6c 76 65 64 0a 2a 2a 20 69 6e 20 61 involved.** in a
300a0 20 62 61 6c 61 6e 63 69 6e 67 20 6f 70 65 72 61 balancing opera
300b0 74 69 6f 6e 2e 20 20 4e 4e 20 69 73 20 74 68 65 tion. NN is the
300c0 20 6e 75 6d 62 65 72 20 6f 66 20 6e 65 69 67 68 number of neigh
300d0 62 6f 72 73 20 6f 6e 20 65 69 74 68 65 72 20 73 bors on either s
300e0 69 64 65 0a 2a 2a 20 6f 66 20 74 68 65 20 70 61 ide.** of the pa
300f0 67 65 20 74 68 61 74 20 70 61 72 74 69 63 69 70 ge that particip
30100 61 74 65 20 69 6e 20 74 68 65 20 62 61 6c 61 6e ate in the balan
30110 63 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 2e 20 cing operation.
30120 20 4e 42 20 69 73 20 74 68 65 0a 2a 2a 20 74 6f NB is the.** to
30130 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 tal number of pa
30140 67 65 73 20 74 68 61 74 20 70 61 72 74 69 63 69 ges that partici
30150 70 61 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20 pate, including
30160 74 68 65 20 74 61 72 67 65 74 20 70 61 67 65 20 the target page
30170 61 6e 64 0a 2a 2a 20 4e 4e 20 6e 65 69 67 68 62 and.** NN neighb
30180 6f 72 73 20 6f 6e 20 65 69 74 68 65 72 20 73 69 ors on either si
30190 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 69 de..**.** The mi
301a0 6e 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 4e nimum value of N
301b0 4e 20 69 73 20 31 20 28 6f 66 20 63 6f 75 72 73 N is 1 (of cours
301c0 65 29 2e 20 20 49 6e 63 72 65 61 73 69 6e 67 20 e). Increasing
301d0 4e 4e 20 61 62 6f 76 65 20 31 0a 2a 2a 20 28 74 NN above 1.** (t
301e0 6f 20 32 20 6f 72 20 33 29 20 67 69 76 65 73 20 o 2 or 3) gives
301f0 61 20 6d 6f 64 65 73 74 20 69 6d 70 72 6f 76 65 a modest improve
30200 6d 65 6e 74 20 69 6e 20 53 45 4c 45 43 54 20 61 ment in SELECT a
30210 6e 64 20 44 45 4c 45 54 45 20 70 65 72 66 6f 72 nd DELETE perfor
30220 6d 61 6e 63 65 0a 2a 2a 20 69 6e 20 65 78 63 68 mance.** in exch
30230 61 6e 67 65 20 66 6f 72 20 61 20 6c 61 72 67 65 ange for a large
30240 72 20 64 65 67 72 61 64 61 74 69 6f 6e 20 69 6e r degradation in
30250 20 49 4e 53 45 52 54 20 61 6e 64 20 55 50 44 41 INSERT and UPDA
30260 54 45 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a TE performance..
30270 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 ** The value of
30280 4e 4e 20 61 70 70 65 61 72 73 20 74 6f 20 67 69 NN appears to gi
30290 76 65 20 74 68 65 20 62 65 73 74 20 72 65 73 75 ve the best resu
302a0 6c 74 73 20 6f 76 65 72 61 6c 6c 2e 0a 2a 2f 0a lts overall..*/.
302b0 23 64 65 66 69 6e 65 20 4e 4e 20 31 20 20 20 20 #define NN 1
302c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
302d0 65 72 20 6f 66 20 6e 65 69 67 68 62 6f 72 73 20 er of neighbors
302e0 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 20 6f on either side o
302f0 66 20 70 50 61 67 65 20 2a 2f 0a 23 64 65 66 69 f pPage */.#defi
30300 6e 65 20 4e 42 20 28 4e 4e 2a 32 2b 31 29 20 20 ne NB (NN*2+1)
30310 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 70 61 67 /* Total pag
30320 65 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74 es involved in t
30330 68 65 20 62 61 6c 61 6e 63 65 20 2a 2f 0a 0a 0a he balance */...
30340 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
30350 4d 49 54 5f 51 55 49 43 4b 42 41 4c 41 4e 43 45 MIT_QUICKBALANCE
30360 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 76 65 72 73 ./*.** This vers
30370 69 6f 6e 20 6f 66 20 62 61 6c 61 6e 63 65 28 29 ion of balance()
30380 20 68 61 6e 64 6c 65 73 20 74 68 65 20 63 6f 6d handles the com
30390 6d 6f 6e 20 73 70 65 63 69 61 6c 20 63 61 73 65 mon special case
303a0 20 77 68 65 72 65 0a 2a 2a 20 61 20 6e 65 77 20 where.** a new
303b0 65 6e 74 72 79 20 69 73 20 62 65 69 6e 67 20 69 entry is being i
303c0 6e 73 65 72 74 65 64 20 6f 6e 20 74 68 65 20 65 nserted on the e
303d0 78 74 72 65 6d 65 20 72 69 67 68 74 2d 65 6e 64 xtreme right-end
303e0 20 6f 66 20 74 68 65 0a 2a 2a 20 74 72 65 65 2c of the.** tree,
303f0 20 69 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c in other words,
30400 20 77 68 65 6e 20 74 68 65 20 6e 65 77 20 65 6e when the new en
30410 74 72 79 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 try will become
30420 74 68 65 20 6c 61 72 67 65 73 74 0a 2a 2a 20 65 the largest.** e
30430 6e 74 72 79 20 69 6e 20 74 68 65 20 74 72 65 65 ntry in the tree
30440 2e 0a 2a 2a 0a 2a 2a 20 49 6e 73 74 65 61 64 20 ..**.** Instead
30450 6f 66 20 74 72 79 69 6e 67 20 74 6f 20 62 61 6c of trying to bal
30460 61 6e 63 65 20 74 68 65 20 33 20 72 69 67 68 74 ance the 3 right
30470 2d 6d 6f 73 74 20 6c 65 61 66 20 70 61 67 65 73 -most leaf pages
30480 2c 20 6a 75 73 74 20 61 64 64 0a 2a 2a 20 61 20 , just add.** a
30490 6e 65 77 20 70 61 67 65 20 74 6f 20 74 68 65 20 new page to the
304a0 72 69 67 68 74 2d 68 61 6e 64 20 73 69 64 65 20 right-hand side
304b0 61 6e 64 20 70 75 74 20 74 68 65 20 6f 6e 65 20 and put the one
304c0 6e 65 77 20 65 6e 74 72 79 20 69 6e 0a 2a 2a 20 new entry in.**
304d0 74 68 61 74 20 70 61 67 65 2e 20 20 54 68 69 73 that page. This
304e0 20 6c 65 61 76 65 73 20 74 68 65 20 72 69 67 68 leaves the righ
304f0 74 20 73 69 64 65 20 6f 66 20 74 68 65 20 74 72 t side of the tr
30500 65 65 20 73 6f 6d 65 77 68 61 74 0a 2a 2a 20 75 ee somewhat.** u
30510 6e 62 61 6c 61 6e 63 65 64 2e 20 20 42 75 74 20 nbalanced. But
30520 6f 64 64 73 20 61 72 65 20 74 68 61 74 20 77 65 odds are that we
30530 20 77 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 69 will be inserti
30540 6e 67 20 6e 65 77 20 65 6e 74 72 69 65 73 0a 2a ng new entries.*
30550 2a 20 61 74 20 74 68 65 20 65 6e 64 20 73 6f 6f * at the end soo
30560 6e 20 61 66 74 65 72 77 61 72 64 73 20 73 6f 20 n afterwards so
30570 74 68 65 20 6e 65 61 72 6c 79 20 65 6d 70 74 79 the nearly empty
30580 20 70 61 67 65 20 77 69 6c 6c 20 71 75 69 63 6b page will quick
30590 6c 79 0a 2a 2a 20 66 69 6c 6c 20 75 70 2e 20 20 ly.** fill up.
305a0 4f 6e 20 61 76 65 72 61 67 65 2e 0a 2a 2a 0a 2a On average..**.*
305b0 2a 20 70 50 61 67 65 20 69 73 20 74 68 65 20 6c * pPage is the l
305c0 65 61 66 20 70 61 67 65 20 77 68 69 63 68 20 69 eaf page which i
305d0 73 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 s the right-most
305e0 20 70 61 67 65 20 69 6e 20 74 68 65 20 74 72 65 page in the tre
305f0 65 2e 0a 2a 2a 20 70 50 61 72 65 6e 74 20 69 73 e..** pParent is
30600 20 69 74 73 20 70 61 72 65 6e 74 2e 20 20 70 50 its parent. pP
30610 61 67 65 20 6d 75 73 74 20 68 61 76 65 20 61 20 age must have a
30620 73 69 6e 67 6c 65 20 6f 76 65 72 66 6c 6f 77 20 single overflow
30630 65 6e 74 72 79 0a 2a 2a 20 77 68 69 63 68 20 69 entry.** which i
30640 73 20 61 6c 73 6f 20 74 68 65 20 72 69 67 68 74 s also the right
30650 2d 6d 6f 73 74 20 65 6e 74 72 79 20 6f 6e 20 74 -most entry on t
30660 68 65 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 he page..**.** T
30670 68 65 20 70 53 70 61 63 65 20 62 75 66 66 65 72 he pSpace buffer
30680 20 69 73 20 75 73 65 64 20 74 6f 20 73 74 6f 72 is used to stor
30690 65 20 61 20 74 65 6d 70 6f 72 61 72 79 20 63 6f e a temporary co
306a0 70 79 20 6f 66 20 74 68 65 20 64 69 76 69 64 65 py of the divide
306b0 72 0a 2a 2a 20 63 65 6c 6c 20 74 68 61 74 20 77 r.** cell that w
306c0 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 20 ill be inserted
306d0 69 6e 74 6f 20 70 50 61 72 65 6e 74 2e 20 53 75 into pParent. Su
306e0 63 68 20 61 20 63 65 6c 6c 20 63 6f 6e 73 69 73 ch a cell consis
306f0 74 73 20 6f 66 20 61 20 34 0a 2a 2a 20 62 79 74 ts of a 4.** byt
30700 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f e page number fo
30710 6c 6c 6f 77 65 64 20 62 79 20 61 20 76 61 72 69 llowed by a vari
30720 61 62 6c 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 able length inte
30730 67 65 72 2e 20 49 6e 20 6f 74 68 65 72 0a 2a 2a ger. In other.**
30740 20 77 6f 72 64 73 2c 20 61 74 20 6d 6f 73 74 20 words, at most
30750 31 33 20 62 79 74 65 73 2e 20 48 65 6e 63 65 20 13 bytes. Hence
30760 74 68 65 20 70 53 70 61 63 65 20 62 75 66 66 65 the pSpace buffe
30770 72 20 6d 75 73 74 20 62 65 20 61 74 0a 2a 2a 20 r must be at.**
30780 6c 65 61 73 74 20 31 33 20 62 79 74 65 73 20 69 least 13 bytes i
30790 6e 20 73 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 n size..*/.stati
307a0 63 20 69 6e 74 20 62 61 6c 61 6e 63 65 5f 71 75 c int balance_qu
307b0 69 63 6b 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ick(MemPage *pPa
307c0 72 65 6e 74 2c 20 4d 65 6d 50 61 67 65 20 2a 70 rent, MemPage *p
307d0 50 61 67 65 2c 20 75 38 20 2a 70 53 70 61 63 65 Page, u8 *pSpace
307e0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 63 ){. BtShared *c
307f0 6f 6e 73 74 20 70 42 74 20 3d 20 70 50 61 67 65 onst pBt = pPage
30800 2d 3e 70 42 74 3b 20 20 20 20 2f 2a 20 42 2d 54 ->pBt; /* B-T
30810 72 65 65 20 44 61 74 61 62 61 73 65 20 2a 2f 0a ree Database */.
30820 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 3b MemPage *pNew;
30830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30840 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 6c 79 20 /* Newly
30850 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 20 2a allocated page *
30860 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 /. int rc;
30870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30880 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
30890 72 6e 20 43 6f 64 65 20 2a 2f 0a 20 20 50 67 6e rn Code */. Pgn
308a0 6f 20 70 67 6e 6f 4e 65 77 3b 20 20 20 20 20 20 o pgnoNew;
308b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
308c0 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 /* Page number
308d0 20 6f 66 20 70 4e 65 77 20 2a 2f 0a 0a 20 20 61 of pNew */.. a
308e0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
308f0 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
30900 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
30910 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
30920 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
30930 65 28 70 50 61 72 65 6e 74 2d 3e 70 44 62 50 61 e(pParent->pDbPa
30940 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
30950 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
30960 77 3d 3d 31 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 w==1 );.. /* Th
30970 69 73 20 65 72 72 6f 72 20 63 6f 6e 64 69 74 69 is error conditi
30980 6f 6e 20 69 73 20 6e 6f 77 20 63 61 75 67 68 74 on is now caught
30990 20 70 72 69 6f 72 20 74 6f 20 72 65 61 63 68 69 prior to reachi
309a0 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ng this function
309b0 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 2d */. if( pPage-
309c0 3e 6e 43 65 6c 6c 3d 3d 30 20 29 20 72 65 74 75 >nCell==0 ) retu
309d0 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
309e0 54 5f 42 4b 50 54 3b 0a 0a 20 20 2f 2a 20 41 6c T_BKPT;.. /* Al
309f0 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 locate a new pag
30a00 65 2e 20 54 68 69 73 20 70 61 67 65 20 77 69 6c e. This page wil
30a10 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 72 69 67 l become the rig
30a20 68 74 2d 73 69 62 6c 69 6e 67 20 6f 66 20 0a 20 ht-sibling of .
30a30 20 2a 2a 20 70 50 61 67 65 2e 20 4d 61 6b 65 20 ** pPage. Make
30a40 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 the parent page
30a50 77 72 69 74 61 62 6c 65 2c 20 73 6f 20 74 68 61 writable, so tha
30a60 74 20 74 68 65 20 6e 65 77 20 64 69 76 69 64 65 t the new divide
30a70 72 20 63 65 6c 6c 0a 20 20 2a 2a 20 6d 61 79 20 r cell. ** may
30a80 62 65 20 69 6e 73 65 72 74 65 64 2e 20 49 66 20 be inserted. If
30a90 62 6f 74 68 20 74 68 65 73 65 20 6f 70 65 72 61 both these opera
30aa0 74 69 6f 6e 73 20 61 72 65 20 73 75 63 63 65 73 tions are succes
30ab0 73 66 75 6c 2c 20 70 72 6f 63 65 65 64 2e 0a 20 sful, proceed..
30ac0 20 2a 2f 0a 20 20 72 63 20 3d 20 61 6c 6c 6f 63 */. rc = alloc
30ad0 61 74 65 42 74 72 65 65 50 61 67 65 28 70 42 74 ateBtreePage(pBt
30ae0 2c 20 26 70 4e 65 77 2c 20 26 70 67 6e 6f 4e 65 , &pNew, &pgnoNe
30af0 77 2c 20 30 2c 20 30 29 3b 0a 0a 20 20 69 66 28 w, 0, 0);.. if(
30b00 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
30b10 7b 0a 0a 20 20 20 20 75 38 20 2a 70 4f 75 74 20 {.. u8 *pOut
30b20 3d 20 26 70 53 70 61 63 65 5b 34 5d 3b 0a 20 20 = &pSpace[4];.
30b30 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 70 50 u8 *pCell = pP
30b40 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 30 5d 3b 0a age->apOvfl[0];.
30b50 20 20 20 20 75 31 36 20 73 7a 43 65 6c 6c 20 3d u16 szCell =
30b60 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 cellSizePtr(pPa
30b70 67 65 2c 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 ge, pCell);.
30b80 75 38 20 2a 70 53 74 6f 70 3b 0a 0a 20 20 20 20 u8 *pStop;..
30b90 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
30ba0 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
30bb0 70 4e 65 77 2d 3e 70 44 62 50 61 67 65 29 20 29 pNew->pDbPage) )
30bc0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
30bd0 61 67 65 2d 3e 61 44 61 74 61 5b 30 5d 3d 3d 28 age->aData[0]==(
30be0 50 54 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c PTF_INTKEY|PTF_L
30bf0 45 41 46 44 41 54 41 7c 50 54 46 5f 4c 45 41 46 EAFDATA|PTF_LEAF
30c00 29 20 29 3b 0a 20 20 20 20 7a 65 72 6f 50 61 67 ) );. zeroPag
30c10 65 28 70 4e 65 77 2c 20 50 54 46 5f 49 4e 54 4b e(pNew, PTF_INTK
30c20 45 59 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 7c EY|PTF_LEAFDATA|
30c30 50 54 46 5f 4c 45 41 46 29 3b 0a 20 20 20 20 61 PTF_LEAF);. a
30c40 73 73 65 6d 62 6c 65 50 61 67 65 28 70 4e 65 77 ssemblePage(pNew
30c50 2c 20 31 2c 20 26 70 43 65 6c 6c 2c 20 26 73 7a , 1, &pCell, &sz
30c60 43 65 6c 6c 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 Cell);.. /* I
30c70 66 20 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 f this is an aut
30c80 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 o-vacuum databas
30c90 65 2c 20 75 70 64 61 74 65 20 74 68 65 20 70 6f e, update the po
30ca0 69 6e 74 65 72 20 6d 61 70 0a 20 20 20 20 2a 2a inter map. **
30cb0 20 77 69 74 68 20 65 6e 74 72 69 65 73 20 66 6f with entries fo
30cc0 72 20 74 68 65 20 6e 65 77 20 70 61 67 65 2c 20 r the new page,
30cd0 61 6e 64 20 61 6e 79 20 70 6f 69 6e 74 65 72 20 and any pointer
30ce0 66 72 6f 6d 20 74 68 65 20 0a 20 20 20 20 2a 2a from the . **
30cf0 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 70 61 67 cell on the pag
30d00 65 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 e to an overflow
30d10 20 70 61 67 65 2e 20 49 66 20 65 69 74 68 65 72 page. If either
30d20 20 6f 66 20 74 68 65 73 65 0a 20 20 20 20 2a 2a of these. **
30d30 20 6f 70 65 72 61 74 69 6f 6e 73 20 66 61 69 6c operations fail
30d40 73 2c 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f s, the return co
30d50 64 65 20 69 73 20 73 65 74 2c 20 62 75 74 20 74 de is set, but t
30d60 68 65 20 63 6f 6e 74 65 6e 74 73 0a 20 20 20 20 he contents.
30d70 2a 2a 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 ** of the parent
30d80 20 70 61 67 65 20 61 72 65 20 73 74 69 6c 6c 20 page are still
30d90 6d 61 6e 69 70 75 6c 61 74 65 64 20 62 79 20 74 manipulated by t
30da0 68 68 20 63 6f 64 65 20 62 65 6c 6f 77 2e 0a 20 hh code below..
30db0 20 20 20 2a 2a 20 54 68 61 74 20 69 73 20 4f 6b ** That is Ok
30dc0 2c 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 , at this point
30dd0 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 the parent page
30de0 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f is guaranteed to
30df0 0a 20 20 20 20 2a 2a 20 62 65 20 6d 61 72 6b 65 . ** be marke
30e00 64 20 61 73 20 64 69 72 74 79 2e 20 52 65 74 75 d as dirty. Retu
30e10 72 6e 69 6e 67 20 61 6e 20 65 72 72 6f 72 20 63 rning an error c
30e20 6f 64 65 20 77 69 6c 6c 20 63 61 75 73 65 20 61 ode will cause a
30e30 0a 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b . ** rollback
30e40 2c 20 75 6e 64 6f 69 6e 67 20 61 6e 79 20 63 68 , undoing any ch
30e50 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20 74 68 anges made to th
30e60 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 0a 20 e parent page..
30e70 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 */. if( IS
30e80 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 AUTOVACUUM ){.
30e90 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 ptrmapPut(pB
30ea0 74 2c 20 70 67 6e 6f 4e 65 77 2c 20 50 54 52 4d t, pgnoNew, PTRM
30eb0 41 50 5f 42 54 52 45 45 2c 20 70 50 61 72 65 6e AP_BTREE, pParen
30ec0 74 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 t->pgno, &rc);.
30ed0 20 20 20 20 20 69 66 28 20 73 7a 43 65 6c 6c 3e if( szCell>
30ee0 70 4e 65 77 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 29 pNew->minLocal )
30ef0 7b 0a 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 {. ptrmap
30f00 50 75 74 4f 76 66 6c 50 74 72 28 70 4e 65 77 2c PutOvflPtr(pNew,
30f10 20 70 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 20 20 pCell, &rc);.
30f20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 }. }. .
30f30 20 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 64 /* Create a d
30f40 69 76 69 64 65 72 20 63 65 6c 6c 20 74 6f 20 69 ivider cell to i
30f50 6e 73 65 72 74 20 69 6e 74 6f 20 70 50 61 72 65 nsert into pPare
30f60 6e 74 2e 20 54 68 65 20 64 69 76 69 64 65 72 20 nt. The divider
30f70 63 65 6c 6c 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 cell. ** cons
30f80 69 73 74 73 20 6f 66 20 61 20 34 2d 62 79 74 65 ists of a 4-byte
30f90 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 74 68 page number (th
30fa0 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
30fb0 20 70 50 61 67 65 29 20 61 6e 64 0a 20 20 20 20 pPage) and.
30fc0 2a 2a 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 ** a variable le
30fd0 6e 67 74 68 20 6b 65 79 20 76 61 6c 75 65 20 28 ngth key value (
30fe0 77 68 69 63 68 20 6d 75 73 74 20 62 65 20 74 68 which must be th
30ff0 65 20 73 61 6d 65 20 76 61 6c 75 65 20 61 73 20 e same value as
31000 74 68 65 0a 20 20 20 20 2a 2a 20 6c 61 72 67 65 the. ** large
31010 73 74 20 6b 65 79 20 6f 6e 20 70 50 61 67 65 29 st key on pPage)
31020 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
31030 54 6f 20 66 69 6e 64 20 74 68 65 20 6c 61 72 67 To find the larg
31040 65 73 74 20 6b 65 79 20 76 61 6c 75 65 20 6f 6e est key value on
31050 20 70 50 61 67 65 2c 20 66 69 72 73 74 20 66 69 pPage, first fi
31060 6e 64 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 nd the right-mos
31070 74 20 0a 20 20 20 20 2a 2a 20 63 65 6c 6c 20 6f t . ** cell o
31080 6e 20 70 50 61 67 65 2e 20 54 68 65 20 66 69 72 n pPage. The fir
31090 73 74 20 74 77 6f 20 66 69 65 6c 64 73 20 6f 66 st two fields of
310a0 20 74 68 69 73 20 63 65 6c 6c 20 61 72 65 20 74 this cell are t
310b0 68 65 20 0a 20 20 20 20 2a 2a 20 72 65 63 6f 72 he . ** recor
310c0 64 2d 6c 65 6e 67 74 68 20 28 61 20 76 61 72 69 d-length (a vari
310d0 61 62 6c 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 able length inte
310e0 67 65 72 20 61 74 20 6d 6f 73 74 20 33 32 2d 62 ger at most 32-b
310f0 69 74 73 20 69 6e 20 73 69 7a 65 29 0a 20 20 20 its in size).
31100 20 2a 2a 20 61 6e 64 20 74 68 65 20 6b 65 79 20 ** and the key
31110 76 61 6c 75 65 20 28 61 20 76 61 72 69 61 62 6c value (a variabl
31120 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 e length integer
31130 2c 20 6d 61 79 20 68 61 76 65 20 61 6e 79 20 76 , may have any v
31140 61 6c 75 65 29 2e 0a 20 20 20 20 2a 2a 20 54 68 alue).. ** Th
31150 65 20 66 69 72 73 74 20 6f 66 20 74 68 65 20 77 e first of the w
31160 68 69 6c 65 28 2e 2e 2e 29 20 6c 6f 6f 70 73 20 hile(...) loops
31170 62 65 6c 6f 77 20 73 6b 69 70 73 20 6f 76 65 72 below skips over
31180 20 74 68 65 20 72 65 63 6f 72 64 2d 6c 65 6e 67 the record-leng
31190 74 68 0a 20 20 20 20 2a 2a 20 66 69 65 6c 64 2e th. ** field.
311a0 20 54 68 65 20 73 65 63 6f 6e 64 20 77 68 69 6c The second whil
311b0 65 28 2e 2e 2e 29 20 6c 6f 6f 70 20 63 6f 70 69 e(...) loop copi
311c0 65 73 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 es the key value
311d0 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 2a 2a from the. **
311e0 20 63 65 6c 6c 20 6f 6e 20 70 50 61 67 65 20 69 cell on pPage i
311f0 6e 74 6f 20 74 68 65 20 70 53 70 61 63 65 20 62 nto the pSpace b
31200 75 66 66 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 uffer.. */.
31210 20 20 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 pCell = findCe
31220 6c 6c 28 70 50 61 67 65 2c 20 70 50 61 67 65 2d ll(pPage, pPage-
31230 3e 6e 43 65 6c 6c 2d 31 29 3b 0a 20 20 20 20 70 >nCell-1);. p
31240 53 74 6f 70 20 3d 20 26 70 43 65 6c 6c 5b 39 5d Stop = &pCell[9]
31250 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 2a 28 ;. while( (*(
31260 70 43 65 6c 6c 2b 2b 29 26 30 78 38 30 29 20 26 pCell++)&0x80) &
31270 26 20 70 43 65 6c 6c 3c 70 53 74 6f 70 20 29 3b & pCell<pStop );
31280 0a 20 20 20 20 70 53 74 6f 70 20 3d 20 26 70 43 . pStop = &pC
31290 65 6c 6c 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c ell[9];. whil
312a0 65 28 20 28 28 2a 28 70 4f 75 74 2b 2b 29 20 3d e( ((*(pOut++) =
312b0 20 2a 28 70 43 65 6c 6c 2b 2b 29 29 26 30 78 38 *(pCell++))&0x8
312c0 30 29 20 26 26 20 70 43 65 6c 6c 3c 70 53 74 6f 0) && pCell<pSto
312d0 70 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 6e 73 p );.. /* Ins
312e0 65 72 74 20 74 68 65 20 6e 65 77 20 64 69 76 69 ert the new divi
312f0 64 65 72 20 63 65 6c 6c 20 69 6e 74 6f 20 70 50 der cell into pP
31300 61 72 65 6e 74 2e 20 2a 2f 0a 20 20 20 20 69 6e arent. */. in
31310 73 65 72 74 43 65 6c 6c 28 70 50 61 72 65 6e 74 sertCell(pParent
31320 2c 20 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c , pParent->nCell
31330 2c 20 70 53 70 61 63 65 2c 20 28 69 6e 74 29 28 , pSpace, (int)(
31340 70 4f 75 74 2d 70 53 70 61 63 65 29 2c 0a 20 20 pOut-pSpace),.
31350 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 0,
31360 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 26 72 63 pPage->pgno, &rc
31370 29 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 );.. /* Set t
31380 68 65 20 72 69 67 68 74 2d 63 68 69 6c 64 20 70 he right-child p
31390 6f 69 6e 74 65 72 20 6f 66 20 70 50 61 72 65 6e ointer of pParen
313a0 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 t to point to th
313b0 65 20 6e 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 e new page. */.
313c0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
313d0 72 65 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 rent->aData[pPar
313e0 65 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 ent->hdrOffset+8
313f0 5d 2c 20 70 67 6e 6f 4e 65 77 29 3b 0a 20 20 0a ], pgnoNew);. .
31400 20 20 20 20 2f 2a 20 52 65 6c 65 61 73 65 20 74 /* Release t
31410 68 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 he reference to
31420 74 68 65 20 6e 65 77 20 70 61 67 65 2e 20 2a 2f the new page. */
31430 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 . releasePage
31440 28 70 4e 65 77 29 3b 0a 20 20 7d 0a 0a 20 20 72 (pNew);. }.. r
31450 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 eturn rc;.}.#end
31460 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
31470 54 5f 51 55 49 43 4b 42 41 4c 41 4e 43 45 20 2a T_QUICKBALANCE *
31480 2f 0a 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 54 /..#if 0./*.** T
31490 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 his function doe
314a0 73 20 6e 6f 74 20 63 6f 6e 74 72 69 62 75 74 65 s not contribute
314b0 20 61 6e 79 74 68 69 6e 67 20 74 6f 20 74 68 65 anything to the
314c0 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 53 51 operation of SQ
314d0 4c 69 74 65 2e 0a 2a 2a 20 69 74 20 69 73 20 73 Lite..** it is s
314e0 6f 6d 65 74 69 6d 65 73 20 61 63 74 69 76 61 74 ometimes activat
314f0 65 64 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 77 ed temporarily w
31500 68 69 6c 65 20 64 65 62 75 67 67 69 6e 67 20 63 hile debugging c
31510 6f 64 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 ode responsible
31520 0a 2a 2a 20 66 6f 72 20 73 65 74 74 69 6e 67 20 .** for setting
31530 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 pointer-map entr
31540 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ies..*/.static i
31550 6e 74 20 70 74 72 6d 61 70 43 68 65 63 6b 50 61 nt ptrmapCheckPa
31560 67 65 73 28 4d 65 6d 50 61 67 65 20 2a 2a 61 70 ges(MemPage **ap
31570 50 61 67 65 2c 20 69 6e 74 20 6e 50 61 67 65 29 Page, int nPage)
31580 7b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 {. int i, j;.
31590 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 50 61 67 65 for(i=0; i<nPage
315a0 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 50 67 6e 6f ; i++){. Pgno
315b0 20 6e 3b 0a 20 20 20 20 75 38 20 65 3b 0a 20 20 n;. u8 e;.
315c0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
315d0 20 3d 20 61 70 50 61 67 65 5b 69 5d 3b 0a 20 20 = apPage[i];.
315e0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
315f0 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
31600 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
31610 3e 69 73 49 6e 69 74 20 29 3b 0a 0a 20 20 20 20 >isInit );..
31620 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 50 61 67 65 for(j=0; j<pPage
31630 2d 3e 6e 43 65 6c 6c 3b 20 6a 2b 2b 29 7b 0a 20 ->nCell; j++){.
31640 20 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e CellInfo in
31650 66 6f 3b 0a 20 20 20 20 20 20 75 38 20 2a 7a 3b fo;. u8 *z;
31660 0a 20 20 20 20 20 0a 20 20 20 20 20 20 7a 20 3d . . z =
31670 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c findCell(pPage,
31680 20 6a 29 3b 0a 20 20 20 20 20 20 62 74 72 65 65 j);. btree
31690 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 ParseCellPtr(pPa
316a0 67 65 2c 20 7a 2c 20 26 69 6e 66 6f 29 3b 0a 20 ge, z, &info);.
316b0 20 20 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f if( info.iO
316c0 76 65 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 verflow ){.
316d0 20 20 20 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 Pgno ovfl = g
316e0 65 74 34 62 79 74 65 28 26 7a 5b 69 6e 66 6f 2e et4byte(&z[info.
316f0 69 4f 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 20 iOverflow]);.
31700 20 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 ptrmapGet(p
31710 42 74 2c 20 6f 76 66 6c 2c 20 26 65 2c 20 26 6e Bt, ovfl, &e, &n
31720 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
31730 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e t( n==pPage->pgn
31740 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 4f o && e==PTRMAP_O
31750 56 45 52 46 4c 4f 57 31 20 29 3b 0a 20 20 20 20 VERFLOW1 );.
31760 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 }. if( !p
31770 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
31780 20 20 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 Pgno child
31790 20 3d 20 67 65 74 34 62 79 74 65 28 7a 29 3b 0a = get4byte(z);.
317a0 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 ptrmapGe
317b0 74 28 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 t(pBt, child, &e
317c0 2c 20 26 6e 29 3b 0a 20 20 20 20 20 20 20 20 61 , &n);. a
317d0 73 73 65 72 74 28 20 6e 3d 3d 70 50 61 67 65 2d ssert( n==pPage-
317e0 3e 70 67 6e 6f 20 26 26 20 65 3d 3d 50 54 52 4d >pgno && e==PTRM
317f0 41 50 5f 42 54 52 45 45 20 29 3b 0a 20 20 20 20 AP_BTREE );.
31800 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
31810 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 ( !pPage->leaf )
31820 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 63 68 69 {. Pgno chi
31830 6c 64 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 ld = get4byte(&p
31840 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
31850 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
31860 3b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 ;. ptrmapGe
31870 74 28 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 t(pBt, child, &e
31880 2c 20 26 6e 29 3b 0a 20 20 20 20 20 20 61 73 73 , &n);. ass
31890 65 72 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 ert( n==pPage->p
318a0 67 6e 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 gno && e==PTRMAP
318b0 5f 42 54 52 45 45 20 29 3b 0a 20 20 20 20 7d 0a _BTREE );. }.
318c0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a }. return 1;.
318d0 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
318e0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
318f0 20 75 73 65 64 20 74 6f 20 63 6f 70 79 20 74 68 used to copy th
31900 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
31910 65 20 62 2d 74 72 65 65 20 6e 6f 64 65 20 73 74 e b-tree node st
31920 6f 72 65 64 20 0a 2a 2a 20 6f 6e 20 70 61 67 65 ored .** on page
31930 20 70 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 70 pFrom to page p
31940 54 6f 2e 20 49 66 20 70 61 67 65 20 70 46 72 6f To. If page pFro
31950 6d 20 77 61 73 20 6e 6f 74 20 61 20 6c 65 61 66 m was not a leaf
31960 20 70 61 67 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 page, then.** t
31970 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 he pointer-map e
31980 6e 74 72 69 65 73 20 66 6f 72 20 65 61 63 68 20 ntries for each
31990 63 68 69 6c 64 20 70 61 67 65 20 61 72 65 20 75 child page are u
319a0 70 64 61 74 65 64 20 73 6f 20 74 68 61 74 20 74 pdated so that t
319b0 68 65 0a 2a 2a 20 70 61 72 65 6e 74 20 70 61 67 he.** parent pag
319c0 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e stored in the
319d0 70 6f 69 6e 74 65 72 20 6d 61 70 20 69 73 20 70 pointer map is p
319e0 61 67 65 20 70 54 6f 2e 20 49 66 20 70 46 72 6f age pTo. If pFro
319f0 6d 20 63 6f 6e 74 61 69 6e 65 64 0a 2a 2a 20 61 m contained.** a
31a00 6e 79 20 63 65 6c 6c 73 20 77 69 74 68 20 6f 76 ny cells with ov
31a10 65 72 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e erflow page poin
31a20 74 65 72 73 2c 20 74 68 65 6e 20 74 68 65 20 63 ters, then the c
31a30 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 70 6f 69 orresponding poi
31a40 6e 74 65 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 nter.** map entr
31a50 69 65 73 20 61 72 65 20 61 6c 73 6f 20 75 70 64 ies are also upd
31a60 61 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 ated so that the
31a70 20 70 61 72 65 6e 74 20 70 61 67 65 20 69 73 20 parent page is
31a80 70 61 67 65 20 70 54 6f 2e 0a 2a 2a 0a 2a 2a 20 page pTo..**.**
31a90 49 66 20 70 46 72 6f 6d 20 69 73 20 63 75 72 72 If pFrom is curr
31aa0 65 6e 74 6c 79 20 63 61 72 72 79 69 6e 67 20 61 ently carrying a
31ab0 6e 79 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c ny overflow cell
31ac0 73 20 28 65 6e 74 72 69 65 73 20 69 6e 20 74 68 s (entries in th
31ad0 65 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 70 4f e.** MemPage.apO
31ae0 76 66 6c 5b 5d 20 61 72 72 61 79 29 2c 20 74 68 vfl[] array), th
31af0 65 79 20 61 72 65 20 6e 6f 74 20 63 6f 70 69 65 ey are not copie
31b00 64 20 74 6f 20 70 54 6f 2e 20 0a 2a 2a 0a 2a 2a d to pTo. .**.**
31b10 20 42 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e Before returnin
31b20 67 2c 20 70 61 67 65 20 70 54 6f 20 69 73 20 72 g, page pTo is r
31b30 65 69 6e 69 74 69 61 6c 69 7a 65 64 20 75 73 69 einitialized usi
31b40 6e 67 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 ng btreeInitPage
31b50 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 65 ()..**.** The pe
31b60 72 66 6f 72 6d 61 6e 63 65 20 6f 66 20 74 68 69 rformance of thi
31b70 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f s function is no
31b80 74 20 63 72 69 74 69 63 61 6c 2e 20 49 74 20 69 t critical. It i
31b90 73 20 6f 6e 6c 79 20 75 73 65 64 20 62 79 20 0a s only used by .
31ba0 2a 2a 20 74 68 65 20 62 61 6c 61 6e 63 65 5f 73 ** the balance_s
31bb0 68 61 6c 6c 6f 77 65 72 28 29 20 61 6e 64 20 62 hallower() and b
31bc0 61 6c 61 6e 63 65 5f 64 65 65 70 65 72 28 29 20 alance_deeper()
31bd0 70 72 6f 63 65 64 75 72 65 73 2c 20 6e 65 69 74 procedures, neit
31be0 68 65 72 20 6f 66 0a 2a 2a 20 77 68 69 63 68 20 her of.** which
31bf0 61 72 65 20 63 61 6c 6c 65 64 20 6f 66 74 65 6e are called often
31c00 20 75 6e 64 65 72 20 6e 6f 72 6d 61 6c 20 63 69 under normal ci
31c10 72 63 75 6d 73 74 61 6e 63 65 73 2e 0a 2a 2f 0a rcumstances..*/.
31c20 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 70 79 static void copy
31c30 4e 6f 64 65 43 6f 6e 74 65 6e 74 28 4d 65 6d 50 NodeContent(MemP
31c40 61 67 65 20 2a 70 46 72 6f 6d 2c 20 4d 65 6d 50 age *pFrom, MemP
31c50 61 67 65 20 2a 70 54 6f 2c 20 69 6e 74 20 2a 70 age *pTo, int *p
31c60 52 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 RC){. if( (*pRC
31c70 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a )==SQLITE_OK ){.
31c80 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 20 63 BtShared * c
31c90 6f 6e 73 74 20 70 42 74 20 3d 20 70 46 72 6f 6d onst pBt = pFrom
31ca0 2d 3e 70 42 74 3b 0a 20 20 20 20 75 38 20 2a 20 ->pBt;. u8 *
31cb0 63 6f 6e 73 74 20 61 46 72 6f 6d 20 3d 20 70 46 const aFrom = pF
31cc0 72 6f 6d 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 rom->aData;.
31cd0 75 38 20 2a 20 63 6f 6e 73 74 20 61 54 6f 20 3d u8 * const aTo =
31ce0 20 70 54 6f 2d 3e 61 44 61 74 61 3b 0a 20 20 20 pTo->aData;.
31cf0 20 69 6e 74 20 63 6f 6e 73 74 20 69 46 72 6f 6d int const iFrom
31d00 48 64 72 20 3d 20 70 46 72 6f 6d 2d 3e 68 64 72 Hdr = pFrom->hdr
31d10 4f 66 66 73 65 74 3b 0a 20 20 20 20 69 6e 74 20 Offset;. int
31d20 63 6f 6e 73 74 20 69 54 6f 48 64 72 20 3d 20 28 const iToHdr = (
31d30 28 70 54 6f 2d 3e 70 67 6e 6f 3d 3d 31 29 20 3f (pTo->pgno==1) ?
31d40 20 31 30 30 20 3a 20 30 29 3b 0a 20 20 20 20 69 100 : 0);. i
31d50 6e 74 20 72 63 3b 0a 20 20 20 20 69 6e 74 20 69 nt rc;. int i
31d60 44 61 74 61 3b 0a 20 20 0a 20 20 0a 20 20 20 20 Data;. . .
31d70 61 73 73 65 72 74 28 20 70 46 72 6f 6d 2d 3e 69 assert( pFrom->i
31d80 73 49 6e 69 74 20 29 3b 0a 20 20 20 20 61 73 73 sInit );. ass
31d90 65 72 74 28 20 70 46 72 6f 6d 2d 3e 6e 46 72 65 ert( pFrom->nFre
31da0 65 3e 3d 69 54 6f 48 64 72 20 29 3b 0a 20 20 20 e>=iToHdr );.
31db0 20 61 73 73 65 72 74 28 20 67 65 74 32 62 79 74 assert( get2byt
31dc0 65 28 26 61 46 72 6f 6d 5b 69 46 72 6f 6d 48 64 e(&aFrom[iFromHd
31dd0 72 2b 35 5d 29 20 3c 3d 20 28 69 6e 74 29 70 42 r+5]) <= (int)pB
31de0 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b t->usableSize );
31df0 0a 20 20 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 . . /* Copy
31e00 74 68 65 20 62 2d 74 72 65 65 20 6e 6f 64 65 20 the b-tree node
31e10 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 70 61 67 content from pag
31e20 65 20 70 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 e pFrom to page
31e30 70 54 6f 2e 20 2a 2f 0a 20 20 20 20 69 44 61 74 pTo. */. iDat
31e40 61 20 3d 20 67 65 74 32 62 79 74 65 28 26 61 46 a = get2byte(&aF
31e50 72 6f 6d 5b 69 46 72 6f 6d 48 64 72 2b 35 5d 29 rom[iFromHdr+5])
31e60 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 61 54 ;. memcpy(&aT
31e70 6f 5b 69 44 61 74 61 5d 2c 20 26 61 46 72 6f 6d o[iData], &aFrom
31e80 5b 69 44 61 74 61 5d 2c 20 70 42 74 2d 3e 75 73 [iData], pBt->us
31e90 61 62 6c 65 53 69 7a 65 2d 69 44 61 74 61 29 3b ableSize-iData);
31ea0 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 61 54 6f . memcpy(&aTo
31eb0 5b 69 54 6f 48 64 72 5d 2c 20 26 61 46 72 6f 6d [iToHdr], &aFrom
31ec0 5b 69 46 72 6f 6d 48 64 72 5d 2c 20 70 46 72 6f [iFromHdr], pFro
31ed0 6d 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 m->cellOffset +
31ee0 32 2a 70 46 72 6f 6d 2d 3e 6e 43 65 6c 6c 29 3b 2*pFrom->nCell);
31ef0 0a 20 20 0a 20 20 20 20 2f 2a 20 52 65 69 6e 69 . . /* Reini
31f00 74 69 61 6c 69 7a 65 20 70 61 67 65 20 70 54 6f tialize page pTo
31f10 20 73 6f 20 74 68 61 74 20 74 68 65 20 63 6f 6e so that the con
31f20 74 65 6e 74 73 20 6f 66 20 74 68 65 20 4d 65 6d tents of the Mem
31f30 50 61 67 65 20 73 74 72 75 63 74 75 72 65 0a 20 Page structure.
31f40 20 20 20 2a 2a 20 6d 61 74 63 68 20 74 68 65 20 ** match the
31f50 6e 65 77 20 64 61 74 61 2e 20 54 68 65 20 69 6e new data. The in
31f60 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 itialization of
31f70 70 54 6f 20 63 61 6e 20 61 63 74 75 61 6c 6c 79 pTo can actually
31f80 20 66 61 69 6c 20 75 6e 64 65 72 0a 20 20 20 20 fail under.
31f90 2a 2a 20 66 61 69 72 6c 79 20 6f 62 73 63 75 72 ** fairly obscur
31fa0 65 20 63 69 72 63 75 6d 73 74 61 6e 63 65 73 2c e circumstances,
31fb0 20 65 76 65 6e 20 74 68 6f 75 67 68 20 69 74 20 even though it
31fc0 69 73 20 61 20 63 6f 70 79 20 6f 66 20 69 6e 69 is a copy of ini
31fd0 74 69 61 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a tialized . **
31fe0 20 70 61 67 65 20 70 46 72 6f 6d 2e 0a 20 20 20 page pFrom..
31ff0 20 2a 2f 0a 20 20 20 20 70 54 6f 2d 3e 69 73 49 */. pTo->isI
32000 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 nit = 0;. rc
32010 3d 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 = btreeInitPage(
32020 70 54 6f 29 3b 0a 20 20 20 20 69 66 28 20 72 63 pTo);. if( rc
32030 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
32040 20 20 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a *pRC = rc;.
32050 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 return;.
32060 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 }. . /* If
32070 20 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 6f this is an auto
32080 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 -vacuum database
32090 2c 20 75 70 64 61 74 65 20 74 68 65 20 70 6f 69 , update the poi
320a0 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 nter-map entries
320b0 0a 20 20 20 20 2a 2a 20 66 6f 72 20 61 6e 79 20 . ** for any
320c0 62 2d 74 72 65 65 20 6f 72 20 6f 76 65 72 66 6c b-tree or overfl
320d0 6f 77 20 70 61 67 65 73 20 74 68 61 74 20 70 54 ow pages that pT
320e0 6f 20 6e 6f 77 20 63 6f 6e 74 61 69 6e 73 20 74 o now contains t
320f0 68 65 20 70 6f 69 6e 74 65 72 73 20 74 6f 2e 0a he pointers to..
32100 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 */. if( I
32110 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 SAUTOVACUUM ){.
32120 20 20 20 20 20 2a 70 52 43 20 3d 20 73 65 74 43 *pRC = setC
32130 68 69 6c 64 50 74 72 6d 61 70 73 28 70 54 6f 29 hildPtrmaps(pTo)
32140 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
32150 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
32160 65 20 72 65 64 69 73 74 72 69 62 75 74 65 73 20 e redistributes
32170 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 69 50 61 cells on the iPa
32180 72 65 6e 74 49 64 78 27 74 68 20 63 68 69 6c 64 rentIdx'th child
32190 20 6f 66 20 70 50 61 72 65 6e 74 0a 2a 2a 20 28 of pParent.** (
321a0 68 65 72 65 61 66 74 65 72 20 22 74 68 65 20 70 hereafter "the p
321b0 61 67 65 22 29 20 61 6e 64 20 75 70 20 74 6f 20 age") and up to
321c0 32 20 73 69 62 6c 69 6e 67 73 20 73 6f 20 74 68 2 siblings so th
321d0 61 74 20 61 6c 6c 20 70 61 67 65 73 20 68 61 76 at all pages hav
321e0 65 20 61 62 6f 75 74 20 74 68 65 0a 2a 2a 20 73 e about the.** s
321f0 61 6d 65 20 61 6d 6f 75 6e 74 20 6f 66 20 66 72 ame amount of fr
32200 65 65 20 73 70 61 63 65 2e 20 55 73 75 61 6c 6c ee space. Usuall
32210 79 20 61 20 73 69 6e 67 6c 65 20 73 69 62 6c 69 y a single sibli
32220 6e 67 20 6f 6e 20 65 69 74 68 65 72 20 73 69 64 ng on either sid
32230 65 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 67 65 e of the.** page
32240 20 61 72 65 20 75 73 65 64 20 69 6e 20 74 68 65 are used in the
32250 20 62 61 6c 61 6e 63 69 6e 67 2c 20 74 68 6f 75 balancing, thou
32260 67 68 20 62 6f 74 68 20 73 69 62 6c 69 6e 67 73 gh both siblings
32270 20 6d 69 67 68 74 20 63 6f 6d 65 20 66 72 6f 6d might come from
32280 20 6f 6e 65 0a 2a 2a 20 73 69 64 65 20 69 66 20 one.** side if
32290 74 68 65 20 70 61 67 65 20 69 73 20 74 68 65 20 the page is the
322a0 66 69 72 73 74 20 6f 72 20 6c 61 73 74 20 63 68 first or last ch
322b0 69 6c 64 20 6f 66 20 69 74 73 20 70 61 72 65 6e ild of its paren
322c0 74 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 0a t. If the page .
322d0 2a 2a 20 68 61 73 20 66 65 77 65 72 20 74 68 61 ** has fewer tha
322e0 6e 20 32 20 73 69 62 6c 69 6e 67 73 20 28 73 6f n 2 siblings (so
322f0 6d 65 74 68 69 6e 67 20 77 68 69 63 68 20 63 61 mething which ca
32300 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 n only happen if
32310 20 74 68 65 20 70 61 67 65 0a 2a 2a 20 69 73 20 the page.** is
32320 61 20 72 6f 6f 74 20 70 61 67 65 20 6f 72 20 61 a root page or a
32330 20 63 68 69 6c 64 20 6f 66 20 61 20 72 6f 6f 74 child of a root
32340 20 70 61 67 65 29 20 74 68 65 6e 20 61 6c 6c 20 page) then all
32350 61 76 61 69 6c 61 62 6c 65 20 73 69 62 6c 69 6e available siblin
32360 67 73 0a 2a 2a 20 70 61 72 74 69 63 69 70 61 74 gs.** participat
32370 65 20 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 e in the balanci
32380 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 75 ng..**.** The nu
32390 6d 62 65 72 20 6f 66 20 73 69 62 6c 69 6e 67 73 mber of siblings
323a0 20 6f 66 20 74 68 65 20 70 61 67 65 20 6d 69 67 of the page mig
323b0 68 74 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 ht be increased
323c0 6f 72 20 64 65 63 72 65 61 73 65 64 20 62 79 20 or decreased by
323d0 0a 2a 2a 20 6f 6e 65 20 6f 72 20 74 77 6f 20 69 .** one or two i
323e0 6e 20 61 6e 20 65 66 66 6f 72 74 20 74 6f 20 6b n an effort to k
323f0 65 65 70 20 70 61 67 65 73 20 6e 65 61 72 6c 79 eep pages nearly
32400 20 66 75 6c 6c 20 62 75 74 20 6e 6f 74 20 6f 76 full but not ov
32410 65 72 20 66 75 6c 6c 2e 20 0a 2a 2a 0a 2a 2a 20 er full. .**.**
32420 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 74 Note that when t
32430 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
32440 61 6c 6c 65 64 2c 20 73 6f 6d 65 20 6f 66 20 74 alled, some of t
32450 68 65 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 he cells on the
32460 70 61 67 65 0a 2a 2a 20 6d 69 67 68 74 20 6e 6f page.** might no
32470 74 20 61 63 74 75 61 6c 6c 79 20 62 65 20 73 74 t actually be st
32480 6f 72 65 64 20 69 6e 20 4d 65 6d 50 61 67 65 2e ored in MemPage.
32490 61 44 61 74 61 5b 5d 2e 20 54 68 69 73 20 63 61 aData[]. This ca
324a0 6e 20 68 61 70 70 65 6e 0a 2a 2a 20 69 66 20 74 n happen.** if t
324b0 68 65 20 70 61 67 65 20 69 73 20 6f 76 65 72 66 he page is overf
324c0 75 6c 6c 2e 20 54 68 69 73 20 72 6f 75 74 69 6e ull. This routin
324d0 65 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 61 e ensures that a
324e0 6c 6c 20 63 65 6c 6c 73 20 61 6c 6c 6f 63 61 74 ll cells allocat
324f0 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 ed.** to the pag
32500 65 20 61 6e 64 20 69 74 73 20 73 69 62 6c 69 6e e and its siblin
32510 67 73 20 66 69 74 20 69 6e 74 6f 20 4d 65 6d 50 gs fit into MemP
32520 61 67 65 2e 61 44 61 74 61 5b 5d 20 62 65 66 6f age.aData[] befo
32530 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a re returning..**
32540 0a 2a 2a 20 49 6e 20 74 68 65 20 63 6f 75 72 73 .** In the cours
32550 65 20 6f 66 20 62 61 6c 61 6e 63 69 6e 67 20 74 e of balancing t
32560 68 65 20 70 61 67 65 20 61 6e 64 20 69 74 73 20 he page and its
32570 73 69 62 6c 69 6e 67 73 2c 20 63 65 6c 6c 73 20 siblings, cells
32580 6d 61 79 20 62 65 0a 2a 2a 20 69 6e 73 65 72 74 may be.** insert
32590 65 64 20 69 6e 74 6f 20 6f 72 20 72 65 6d 6f 76 ed into or remov
325a0 65 64 20 66 72 6f 6d 20 74 68 65 20 70 61 72 65 ed from the pare
325b0 6e 74 20 70 61 67 65 20 28 70 50 61 72 65 6e 74 nt page (pParent
325c0 29 2e 20 44 6f 69 6e 67 20 73 6f 0a 2a 2a 20 6d ). Doing so.** m
325d0 61 79 20 63 61 75 73 65 20 74 68 65 20 70 61 72 ay cause the par
325e0 65 6e 74 20 70 61 67 65 20 74 6f 20 62 65 63 6f ent page to beco
325f0 6d 65 20 6f 76 65 72 66 75 6c 6c 20 6f 72 20 75 me overfull or u
32600 6e 64 65 72 66 75 6c 6c 2e 20 49 66 20 74 68 69 nderfull. If thi
32610 73 0a 2a 2a 20 68 61 70 70 65 6e 73 2c 20 69 74 s.** happens, it
32620 20 69 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 is the responsi
32630 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 bility of the ca
32640 6c 6c 65 72 20 74 6f 20 69 6e 76 6f 6b 65 20 74 ller to invoke t
32650 68 65 20 63 6f 72 72 65 63 74 0a 2a 2a 20 62 61 he correct.** ba
32660 6c 61 6e 63 69 6e 67 20 72 6f 75 74 69 6e 65 20 lancing routine
32670 74 6f 20 66 69 78 20 74 68 69 73 20 70 72 6f 62 to fix this prob
32680 6c 65 6d 20 28 73 65 65 20 74 68 65 20 62 61 6c lem (see the bal
32690 61 6e 63 65 28 29 20 72 6f 75 74 69 6e 65 29 2e ance() routine).
326a0 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 .**.** If this
326b0 72 6f 75 74 69 6e 65 20 66 61 69 6c 73 20 66 6f routine fails fo
326c0 72 20 61 6e 79 20 72 65 61 73 6f 6e 2c 20 69 74 r any reason, it
326d0 20 6d 69 67 68 74 20 6c 65 61 76 65 20 74 68 65 might leave the
326e0 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 6e 20 database.** in
326f0 61 20 63 6f 72 72 75 70 74 65 64 20 73 74 61 74 a corrupted stat
32700 65 2e 20 53 6f 20 69 66 20 74 68 69 73 20 72 6f e. So if this ro
32710 75 74 69 6e 65 20 66 61 69 6c 73 2c 20 74 68 65 utine fails, the
32720 20 64 61 74 61 62 61 73 65 20 73 68 6f 75 6c 64 database should
32730 0a 2a 2a 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 .** be rolled ba
32740 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74 68 ck..**.** The th
32750 69 72 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 ird argument to
32760 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 61 this function, a
32770 4f 76 66 6c 53 70 61 63 65 2c 20 69 73 20 61 20 OvflSpace, is a
32780 70 6f 69 6e 74 65 72 20 74 6f 20 61 0a 2a 2a 20 pointer to a.**
32790 62 75 66 66 65 72 20 62 69 67 20 65 6e 6f 75 67 buffer big enoug
327a0 68 20 74 6f 20 68 6f 6c 64 20 6f 6e 65 20 70 61 h to hold one pa
327b0 67 65 2e 20 49 66 20 77 68 69 6c 65 20 69 6e 73 ge. If while ins
327c0 65 72 74 69 6e 67 20 63 65 6c 6c 73 20 69 6e 74 erting cells int
327d0 6f 20 74 68 65 20 70 61 72 65 6e 74 0a 2a 2a 20 o the parent.**
327e0 70 61 67 65 20 28 70 50 61 72 65 6e 74 29 20 74 page (pParent) t
327f0 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 62 he parent page b
32800 65 63 6f 6d 65 73 20 6f 76 65 72 66 75 6c 6c 2c ecomes overfull,
32810 20 74 68 69 73 20 62 75 66 66 65 72 20 69 73 0a this buffer is.
32820 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 ** used to store
32830 20 74 68 65 20 70 61 72 65 6e 74 27 73 20 6f 76 the parent's ov
32840 65 72 66 6c 6f 77 20 63 65 6c 6c 73 2e 20 42 65 erflow cells. Be
32850 63 61 75 73 65 20 74 68 69 73 20 66 75 6e 63 74 cause this funct
32860 69 6f 6e 20 69 6e 73 65 72 74 73 0a 2a 2a 20 61 ion inserts.** a
32870 20 6d 61 78 69 6d 75 6d 20 6f 66 20 66 6f 75 72 maximum of four
32880 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 20 69 divider cells i
32890 6e 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 nto the parent p
328a0 61 67 65 2c 20 61 6e 64 20 74 68 65 20 6d 61 78 age, and the max
328b0 69 6d 75 6d 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 imum.** size of
328c0 61 20 63 65 6c 6c 20 73 74 6f 72 65 64 20 77 69 a cell stored wi
328d0 74 68 69 6e 20 61 6e 20 69 6e 74 65 72 6e 61 6c thin an internal
328e0 20 6e 6f 64 65 20 69 73 20 61 6c 77 61 79 73 20 node is always
328f0 6c 65 73 73 20 74 68 61 6e 20 31 2f 34 0a 2a 2a less than 1/4.**
32900 20 6f 66 20 74 68 65 20 70 61 67 65 2d 73 69 7a of the page-siz
32910 65 2c 20 74 68 65 20 61 4f 76 66 6c 53 70 61 63 e, the aOvflSpac
32920 65 5b 5d 20 62 75 66 66 65 72 20 69 73 20 67 75 e[] buffer is gu
32930 61 72 61 6e 74 65 65 64 20 74 6f 20 62 65 20 6c aranteed to be l
32940 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 66 arge.** enough f
32950 6f 72 20 61 6c 6c 20 6f 76 65 72 66 6c 6f 77 20 or all overflow
32960 63 65 6c 6c 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 cells..**.** If
32970 61 4f 76 66 6c 53 70 61 63 65 20 69 73 20 73 65 aOvflSpace is se
32980 74 20 74 6f 20 61 20 6e 75 6c 6c 20 70 6f 69 6e t to a null poin
32990 74 65 72 2c 20 74 68 69 73 20 66 75 6e 63 74 69 ter, this functi
329a0 6f 6e 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 53 on returns .** S
329b0 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f 0a QLITE_NOMEM..*/.
329c0 23 69 66 20 64 65 66 69 6e 65 64 28 5f 4d 53 43 #if defined(_MSC
329d0 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 5f 56 45 _VER) && _MSC_VE
329e0 52 20 3e 3d 20 31 37 30 30 20 26 26 20 64 65 66 R >= 1700 && def
329f0 69 6e 65 64 28 5f 4d 5f 41 52 4d 29 0a 23 70 72 ined(_M_ARM).#pr
32a00 61 67 6d 61 20 6f 70 74 69 6d 69 7a 65 28 22 22 agma optimize(""
32a10 2c 20 6f 66 66 29 0a 23 65 6e 64 69 66 0a 73 74 , off).#endif.st
32a20 61 74 69 63 20 69 6e 74 20 62 61 6c 61 6e 63 65 atic int balance
32a30 5f 6e 6f 6e 72 6f 6f 74 28 0a 20 20 4d 65 6d 50 _nonroot(. MemP
32a40 61 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 20 20 age *pParent,
32a50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
32a60 61 72 65 6e 74 20 70 61 67 65 20 6f 66 20 73 69 arent page of si
32a70 62 6c 69 6e 67 73 20 62 65 69 6e 67 20 62 61 6c blings being bal
32a80 61 6e 63 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 anced */. int i
32a90 50 61 72 65 6e 74 49 64 78 2c 20 20 20 20 20 20 ParentIdx,
32aa0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
32ab0 64 65 78 20 6f 66 20 22 74 68 65 20 70 61 67 65 dex of "the page
32ac0 22 20 69 6e 20 70 50 61 72 65 6e 74 20 2a 2f 0a " in pParent */.
32ad0 20 20 75 38 20 2a 61 4f 76 66 6c 53 70 61 63 65 u8 *aOvflSpace
32ae0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
32af0 20 20 2f 2a 20 70 61 67 65 2d 73 69 7a 65 20 62 /* page-size b
32b00 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 66 6f ytes of space fo
32b10 72 20 70 61 72 65 6e 74 20 6f 76 66 6c 20 2a 2f r parent ovfl */
32b20 0a 20 20 69 6e 74 20 69 73 52 6f 6f 74 2c 20 20 . int isRoot,
32b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32b40 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 50 /* True if pP
32b50 61 72 65 6e 74 20 69 73 20 61 20 72 6f 6f 74 2d arent is a root-
32b60 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 62 42 page */. int bB
32b70 75 6c 6b 20 20 20 20 20 20 20 20 20 20 20 20 20 ulk
32b80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
32b90 65 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 69 e if this call i
32ba0 73 20 70 61 72 74 20 6f 66 20 61 20 62 75 6c 6b s part of a bulk
32bb0 20 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 load */.){. Bt
32bc0 53 68 61 72 65 64 20 2a 70 42 74 3b 20 20 20 20 Shared *pBt;
32bd0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
32be0 65 20 77 68 6f 6c 65 20 64 61 74 61 62 61 73 65 e whole database
32bf0 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 20 */. int nCell
32c00 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 0;
32c10 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
32c20 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b cells in apCell[
32c30 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 43 ] */. int nMaxC
32c40 65 6c 6c 73 20 3d 20 30 3b 20 20 20 20 20 20 20 ells = 0;
32c50 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 /* Allocated
32c60 20 73 69 7a 65 20 6f 66 20 61 70 43 65 6c 6c 2c size of apCell,
32c70 20 73 7a 43 65 6c 6c 2c 20 61 46 72 6f 6d 2e 20 szCell, aFrom.
32c80 2a 2f 0a 20 20 69 6e 74 20 6e 4e 65 77 20 3d 20 */. int nNew =
32c90 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
32ca0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
32cb0 61 67 65 73 20 69 6e 20 61 70 4e 65 77 5b 5d 20 ages in apNew[]
32cc0 2a 2f 0a 20 20 69 6e 74 20 6e 4f 6c 64 3b 20 20 */. int nOld;
32cd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32ce0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
32cf0 61 67 65 73 20 69 6e 20 61 70 4f 6c 64 5b 5d 20 ages in apOld[]
32d00 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 6a 2c 20 6b */. int i, j, k
32d10 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
32d20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 /* Loop counte
32d30 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 78 44 69 rs */. int nxDi
32d40 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 v;
32d50 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 64 69 76 /* Next div
32d60 69 64 65 72 20 73 6c 6f 74 20 69 6e 20 70 50 61 ider slot in pPa
32d70 72 65 6e 74 2d 3e 61 43 65 6c 6c 5b 5d 20 2a 2f rent->aCell[] */
32d80 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
32d90 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 TE_OK;
32da0 2f 2a 20 54 68 65 20 72 65 74 75 72 6e 20 63 6f /* The return co
32db0 64 65 20 2a 2f 0a 20 20 75 31 36 20 6c 65 61 66 de */. u16 leaf
32dc0 43 6f 72 72 65 63 74 69 6f 6e 3b 20 20 20 20 20 Correction;
32dd0 20 20 20 20 20 2f 2a 20 34 20 69 66 20 70 50 61 /* 4 if pPa
32de0 67 65 20 69 73 20 61 20 6c 65 61 66 2e 20 20 30 ge is a leaf. 0
32df0 20 69 66 20 6e 6f 74 20 2a 2f 0a 20 20 69 6e 74 if not */. int
32e00 20 6c 65 61 66 44 61 74 61 3b 20 20 20 20 20 20 leafData;
32e10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
32e20 65 20 69 66 20 70 50 61 67 65 20 69 73 20 61 20 e if pPage is a
32e30 6c 65 61 66 20 6f 66 20 61 20 4c 45 41 46 44 41 leaf of a LEAFDA
32e40 54 41 20 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 TA tree */. int
32e50 20 75 73 61 62 6c 65 53 70 61 63 65 3b 20 20 20 usableSpace;
32e60 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 /* Byt
32e70 65 73 20 69 6e 20 70 50 61 67 65 20 62 65 79 6f es in pPage beyo
32e80 6e 64 20 74 68 65 20 68 65 61 64 65 72 20 2a 2f nd the header */
32e90 0a 20 20 69 6e 74 20 70 61 67 65 46 6c 61 67 73 . int pageFlags
32ea0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
32eb0 2f 2a 20 56 61 6c 75 65 20 6f 66 20 70 50 61 67 /* Value of pPag
32ec0 65 2d 3e 61 44 61 74 61 5b 30 5d 20 2a 2f 0a 20 e->aData[0] */.
32ed0 20 69 6e 74 20 73 75 62 74 6f 74 61 6c 3b 20 20 int subtotal;
32ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
32ef0 20 53 75 62 74 6f 74 61 6c 20 6f 66 20 62 79 74 Subtotal of byt
32f00 65 73 20 69 6e 20 63 65 6c 6c 73 20 6f 6e 20 6f es in cells on o
32f10 6e 65 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 ne page */. int
32f20 20 69 53 70 61 63 65 31 20 3d 20 30 3b 20 20 20 iSpace1 = 0;
32f30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
32f40 73 74 20 75 6e 75 73 65 64 20 62 79 74 65 20 6f st unused byte o
32f50 66 20 61 53 70 61 63 65 31 5b 5d 20 2a 2f 0a 20 f aSpace1[] */.
32f60 20 69 6e 74 20 69 4f 76 66 6c 53 70 61 63 65 20 int iOvflSpace
32f70 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a = 0; /*
32f80 20 46 69 72 73 74 20 75 6e 75 73 65 64 20 62 79 First unused by
32f90 74 65 20 6f 66 20 61 4f 76 66 6c 53 70 61 63 65 te of aOvflSpace
32fa0 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 63 [] */. int szSc
32fb0 72 61 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 ratch;
32fc0 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
32fd0 73 63 72 61 74 63 68 20 6d 65 6d 6f 72 79 20 72 scratch memory r
32fe0 65 71 75 65 73 74 65 64 20 2a 2f 0a 20 20 4d 65 equested */. Me
32ff0 6d 50 61 67 65 20 2a 61 70 4f 6c 64 5b 4e 42 5d mPage *apOld[NB]
33000 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 50 ; /* pP
33010 61 67 65 20 61 6e 64 20 75 70 20 74 6f 20 74 77 age and up to tw
33020 6f 20 73 69 62 6c 69 6e 67 73 20 2a 2f 0a 20 20 o siblings */.
33030 4d 65 6d 50 61 67 65 20 2a 61 70 43 6f 70 79 5b MemPage *apCopy[
33040 4e 42 5d 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 NB]; /*
33050 50 72 69 76 61 74 65 20 63 6f 70 69 65 73 20 6f Private copies o
33060 66 20 61 70 4f 6c 64 5b 5d 20 70 61 67 65 73 20 f apOld[] pages
33070 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 61 70 */. MemPage *ap
33080 4e 65 77 5b 4e 42 2b 32 5d 3b 20 20 20 20 20 20 New[NB+2];
33090 20 20 2f 2a 20 70 50 61 67 65 20 61 6e 64 20 75 /* pPage and u
330a0 70 20 74 6f 20 4e 42 20 73 69 62 6c 69 6e 67 73 p to NB siblings
330b0 20 61 66 74 65 72 20 62 61 6c 61 6e 63 69 6e 67 after balancing
330c0 20 2a 2f 0a 20 20 75 38 20 2a 70 52 69 67 68 74 */. u8 *pRight
330d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
330e0 20 20 20 2f 2a 20 4c 6f 63 61 74 69 6f 6e 20 69 /* Location i
330f0 6e 20 70 61 72 65 6e 74 20 6f 66 20 72 69 67 68 n parent of righ
33100 74 2d 73 69 62 6c 69 6e 67 20 70 6f 69 6e 74 65 t-sibling pointe
33110 72 20 2a 2f 0a 20 20 75 38 20 2a 61 70 44 69 76 r */. u8 *apDiv
33120 5b 4e 42 2d 31 5d 3b 20 20 20 20 20 20 20 20 20 [NB-1];
33130 20 20 20 20 2f 2a 20 44 69 76 69 64 65 72 20 63 /* Divider c
33140 65 6c 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 20 ells in pParent
33150 2a 2f 0a 20 20 69 6e 74 20 63 6e 74 4e 65 77 5b */. int cntNew[
33160 4e 42 2b 32 5d 3b 20 20 20 20 20 20 20 20 20 20 NB+2];
33170 20 20 2f 2a 20 49 6e 64 65 78 20 69 6e 20 61 43 /* Index in aC
33180 65 6c 6c 5b 5d 20 6f 66 20 63 65 6c 6c 20 61 66 ell[] of cell af
33190 74 65 72 20 69 2d 74 68 20 70 61 67 65 20 2a 2f ter i-th page */
331a0 0a 20 20 69 6e 74 20 73 7a 4e 65 77 5b 4e 42 2b . int szNew[NB+
331b0 32 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2];
331c0 2f 2a 20 43 6f 6d 62 69 6e 65 64 20 73 69 7a 65 /* Combined size
331d0 20 6f 66 20 63 65 6c 6c 73 20 70 6c 61 63 65 20 of cells place
331e0 6f 6e 20 69 2d 74 68 20 70 61 67 65 20 2a 2f 0a on i-th page */.
331f0 20 20 75 38 20 2a 2a 61 70 43 65 6c 6c 20 3d 20 u8 **apCell =
33200 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 0; /
33210 2a 20 41 6c 6c 20 63 65 6c 6c 73 20 62 65 67 69 * All cells begi
33220 6e 20 62 61 6c 61 6e 63 65 64 20 2a 2f 0a 20 20 n balanced */.
33230 75 31 36 20 2a 73 7a 43 65 6c 6c 3b 20 20 20 20 u16 *szCell;
33240 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
33250 4c 6f 63 61 6c 20 73 69 7a 65 20 6f 66 20 61 6c Local size of al
33260 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c l cells in apCel
33270 6c 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a 61 53 70 l[] */. u8 *aSp
33280 61 63 65 31 3b 20 20 20 20 20 20 20 20 20 20 20 ace1;
33290 20 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 66 /* Space f
332a0 6f 72 20 63 6f 70 69 65 73 20 6f 66 20 64 69 76 or copies of div
332b0 69 64 65 72 73 20 63 65 6c 6c 73 20 2a 2f 0a 20 iders cells */.
332c0 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20 20 20 Pgno pgno;
332d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
332e0 20 54 65 6d 70 20 76 61 72 20 74 6f 20 73 74 6f Temp var to sto
332f0 72 65 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72 re a page number
33300 20 69 6e 20 2a 2f 0a 0a 20 20 70 42 74 20 3d 20 in */.. pBt =
33310 70 50 61 72 65 6e 74 2d 3e 70 42 74 3b 0a 20 20 pParent->pBt;.
33320 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
33330 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
33340 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
33350 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
33360 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 72 Iswriteable(pPar
33370 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 29 3b ent->pDbPage) );
33380 0a 0a 23 69 66 20 30 0a 20 20 54 52 41 43 45 28 ..#if 0. TRACE(
33390 28 22 42 41 4c 41 4e 43 45 3a 20 62 65 67 69 6e ("BALANCE: begin
333a0 20 70 61 67 65 20 25 64 20 63 68 69 6c 64 20 6f page %d child o
333b0 66 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 2d 3e f %d\n", pPage->
333c0 70 67 6e 6f 2c 20 70 50 61 72 65 6e 74 2d 3e 70 pgno, pParent->p
333d0 67 6e 6f 29 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 gno));.#endif..
333e0 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e /* At this poin
333f0 74 20 70 50 61 72 65 6e 74 20 6d 61 79 20 68 61 t pParent may ha
33400 76 65 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 6f ve at most one o
33410 76 65 72 66 6c 6f 77 20 63 65 6c 6c 2e 20 41 6e verflow cell. An
33420 64 20 69 66 0a 20 20 2a 2a 20 74 68 69 73 20 6f d if. ** this o
33430 76 65 72 66 6c 6f 77 20 63 65 6c 6c 20 69 73 20 verflow cell is
33440 70 72 65 73 65 6e 74 2c 20 69 74 20 6d 75 73 74 present, it must
33450 20 62 65 20 74 68 65 20 63 65 6c 6c 20 77 69 74 be the cell wit
33460 68 20 0a 20 20 2a 2a 20 69 6e 64 65 78 20 69 50 h . ** index iP
33470 61 72 65 6e 74 49 64 78 2e 20 54 68 69 73 20 73 arentIdx. This s
33480 63 65 6e 61 72 69 6f 20 63 6f 6d 65 73 20 61 62 cenario comes ab
33490 6f 75 74 20 77 68 65 6e 20 74 68 69 73 20 66 75 out when this fu
334a0 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 63 nction. ** is c
334b0 61 6c 6c 65 64 20 28 69 6e 64 69 72 65 63 74 6c alled (indirectl
334c0 79 29 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 42 y) from sqlite3B
334d0 74 72 65 65 44 65 6c 65 74 65 28 29 2e 0a 20 20 treeDelete()..
334e0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 */. assert( pPa
334f0 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d rent->nOverflow=
33500 3d 30 20 7c 7c 20 70 50 61 72 65 6e 74 2d 3e 6e =0 || pParent->n
33510 4f 76 65 72 66 6c 6f 77 3d 3d 31 20 29 3b 0a 20 Overflow==1 );.
33520 20 61 73 73 65 72 74 28 20 70 50 61 72 65 6e 74 assert( pParent
33530 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 7c ->nOverflow==0 |
33540 7c 20 70 50 61 72 65 6e 74 2d 3e 61 69 4f 76 66 | pParent->aiOvf
33550 6c 5b 30 5d 3d 3d 69 50 61 72 65 6e 74 49 64 78 l[0]==iParentIdx
33560 20 29 3b 0a 0a 20 20 69 66 28 20 21 61 4f 76 66 );.. if( !aOvf
33570 6c 53 70 61 63 65 20 29 7b 0a 20 20 20 20 72 65 lSpace ){. re
33580 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
33590 4d 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 6e M;. }.. /* Fin
335a0 64 20 74 68 65 20 73 69 62 6c 69 6e 67 20 70 61 d the sibling pa
335b0 67 65 73 20 74 6f 20 62 61 6c 61 6e 63 65 2e 20 ges to balance.
335c0 41 6c 73 6f 20 6c 6f 63 61 74 65 20 74 68 65 20 Also locate the
335d0 63 65 6c 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 cells in pParent
335e0 20 0a 20 20 2a 2a 20 74 68 61 74 20 64 69 76 69 . ** that divi
335f0 64 65 20 74 68 65 20 73 69 62 6c 69 6e 67 73 2e de the siblings.
33600 20 41 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d An attempt is m
33610 61 64 65 20 74 6f 20 66 69 6e 64 20 4e 4e 20 73 ade to find NN s
33620 69 62 6c 69 6e 67 73 20 6f 6e 20 0a 20 20 2a 2a iblings on . **
33630 20 65 69 74 68 65 72 20 73 69 64 65 20 6f 66 20 either side of
33640 70 50 61 67 65 2e 20 4d 6f 72 65 20 73 69 62 6c pPage. More sibl
33650 69 6e 67 73 20 61 72 65 20 74 61 6b 65 6e 20 66 ings are taken f
33660 72 6f 6d 20 6f 6e 65 20 73 69 64 65 2c 20 68 6f rom one side, ho
33670 77 65 76 65 72 2c 20 0a 20 20 2a 2a 20 69 66 20 wever, . ** if
33680 74 68 65 72 65 20 61 72 65 20 66 65 77 65 72 20 there are fewer
33690 74 68 61 6e 20 4e 4e 20 73 69 62 6c 69 6e 67 73 than NN siblings
336a0 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 73 69 on the other si
336b0 64 65 2e 20 49 66 20 70 50 61 72 65 6e 74 0a 20 de. If pParent.
336c0 20 2a 2a 20 68 61 73 20 4e 42 20 6f 72 20 66 65 ** has NB or fe
336d0 77 65 72 20 63 68 69 6c 64 72 65 6e 20 74 68 65 wer children the
336e0 6e 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f n all children o
336f0 66 20 70 50 61 72 65 6e 74 20 61 72 65 20 74 61 f pParent are ta
33700 6b 65 6e 2e 20 20 0a 20 20 2a 2a 0a 20 20 2a 2a ken. . **. **
33710 20 54 68 69 73 20 6c 6f 6f 70 20 61 6c 73 6f 20 This loop also
33720 64 72 6f 70 73 20 74 68 65 20 64 69 76 69 64 65 drops the divide
33730 72 20 63 65 6c 6c 73 20 66 72 6f 6d 20 74 68 65 r cells from the
33740 20 70 61 72 65 6e 74 20 70 61 67 65 2e 20 54 68 parent page. Th
33750 69 73 0a 20 20 2a 2a 20 77 61 79 2c 20 74 68 65 is. ** way, the
33760 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 remainder of th
33770 65 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 e function does
33780 6e 6f 74 20 68 61 76 65 20 74 6f 20 64 65 61 6c not have to deal
33790 20 77 69 74 68 20 61 6e 79 0a 20 20 2a 2a 20 6f with any. ** o
337a0 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 69 6e verflow cells in
337b0 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 the parent page
337c0 2c 20 73 69 6e 63 65 20 69 66 20 61 6e 79 20 65 , since if any e
337d0 78 69 73 74 65 64 20 74 68 65 79 20 77 69 6c 6c xisted they will
337e0 0a 20 20 2a 2a 20 68 61 76 65 20 61 6c 72 65 61 . ** have alrea
337f0 64 79 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 2e dy been removed.
33800 0a 20 20 2a 2f 0a 20 20 69 20 3d 20 70 50 61 72 . */. i = pPar
33810 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 2b ent->nOverflow +
33820 20 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 3b pParent->nCell;
33830 0a 20 20 69 66 28 20 69 3c 32 20 29 7b 0a 20 20 . if( i<2 ){.
33840 20 20 6e 78 44 69 76 20 3d 20 30 3b 0a 20 20 7d nxDiv = 0;. }
33850 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 else{. assert
33860 28 20 62 42 75 6c 6b 3d 3d 30 20 7c 7c 20 62 42 ( bBulk==0 || bB
33870 75 6c 6b 3d 3d 31 20 29 3b 0a 20 20 20 20 69 66 ulk==1 );. if
33880 28 20 69 50 61 72 65 6e 74 49 64 78 3d 3d 30 20 ( iParentIdx==0
33890 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ){
338a0 20 20 20 0a 20 20 20 20 20 20 6e 78 44 69 76 20 . nxDiv
338b0 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 = 0;. }else i
338c0 66 28 20 69 50 61 72 65 6e 74 49 64 78 3d 3d 69 f( iParentIdx==i
338d0 20 29 7b 0a 20 20 20 20 20 20 6e 78 44 69 76 20 ){. nxDiv
338e0 3d 20 69 2d 32 2b 62 42 75 6c 6b 3b 0a 20 20 20 = i-2+bBulk;.
338f0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 }else{. as
33900 73 65 72 74 28 20 62 42 75 6c 6b 3d 3d 30 20 29 sert( bBulk==0 )
33910 3b 0a 20 20 20 20 20 20 6e 78 44 69 76 20 3d 20 ;. nxDiv =
33920 69 50 61 72 65 6e 74 49 64 78 2d 31 3b 0a 20 20 iParentIdx-1;.
33930 20 20 7d 0a 20 20 20 20 69 20 3d 20 32 2d 62 42 }. i = 2-bB
33940 75 6c 6b 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 ulk;. }. nOld
33950 3d 20 69 2b 31 3b 0a 20 20 69 66 28 20 28 69 2b = i+1;. if( (i+
33960 6e 78 44 69 76 2d 70 50 61 72 65 6e 74 2d 3e 6e nxDiv-pParent->n
33970 4f 76 65 72 66 6c 6f 77 29 3d 3d 70 50 61 72 65 Overflow)==pPare
33980 6e 74 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 nt->nCell ){.
33990 20 70 52 69 67 68 74 20 3d 20 26 70 50 61 72 65 pRight = &pPare
339a0 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e nt->aData[pParen
339b0 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 3b t->hdrOffset+8];
339c0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 52 . }else{. pR
339d0 69 67 68 74 20 3d 20 66 69 6e 64 43 65 6c 6c 28 ight = findCell(
339e0 70 50 61 72 65 6e 74 2c 20 69 2b 6e 78 44 69 76 pParent, i+nxDiv
339f0 2d 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 -pParent->nOverf
33a00 6c 6f 77 29 3b 0a 20 20 7d 0a 20 20 70 67 6e 6f low);. }. pgno
33a10 20 3d 20 67 65 74 34 62 79 74 65 28 70 52 69 67 = get4byte(pRig
33a20 68 74 29 3b 0a 20 20 77 68 69 6c 65 28 20 31 20 ht);. while( 1
33a30 29 7b 0a 20 20 20 20 72 63 20 3d 20 67 65 74 41 ){. rc = getA
33a40 6e 64 49 6e 69 74 50 61 67 65 28 70 42 74 2c 20 ndInitPage(pBt,
33a50 70 67 6e 6f 2c 20 26 61 70 4f 6c 64 5b 69 5d 2c pgno, &apOld[i],
33a60 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 0);. if( rc
33a70 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 ){. memset(
33a80 61 70 4f 6c 64 2c 20 30 2c 20 28 69 2b 31 29 2a apOld, 0, (i+1)*
33a90 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 2a 29 sizeof(MemPage*)
33aa0 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 61 );. goto ba
33ab0 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 lance_cleanup;.
33ac0 20 20 20 7d 0a 20 20 20 20 6e 4d 61 78 43 65 6c }. nMaxCel
33ad0 6c 73 20 2b 3d 20 31 2b 61 70 4f 6c 64 5b 69 5d ls += 1+apOld[i]
33ae0 2d 3e 6e 43 65 6c 6c 2b 61 70 4f 6c 64 5b 69 5d ->nCell+apOld[i]
33af0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a 20 20 20 ->nOverflow;.
33b00 20 69 66 28 20 28 69 2d 2d 29 3d 3d 30 20 29 20 if( (i--)==0 )
33b10 62 72 65 61 6b 3b 0a 0a 20 20 20 20 69 66 28 20 break;.. if(
33b20 69 2b 6e 78 44 69 76 3d 3d 70 50 61 72 65 6e 74 i+nxDiv==pParent
33b30 2d 3e 61 69 4f 76 66 6c 5b 30 5d 20 26 26 20 70 ->aiOvfl[0] && p
33b40 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f Parent->nOverflo
33b50 77 20 29 7b 0a 20 20 20 20 20 20 61 70 44 69 76 w ){. apDiv
33b60 5b 69 5d 20 3d 20 70 50 61 72 65 6e 74 2d 3e 61 [i] = pParent->a
33b70 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 20 20 20 pOvfl[0];.
33b80 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 pgno = get4byte(
33b90 61 70 44 69 76 5b 69 5d 29 3b 0a 20 20 20 20 20 apDiv[i]);.
33ba0 20 73 7a 4e 65 77 5b 69 5d 20 3d 20 63 65 6c 6c szNew[i] = cell
33bb0 53 69 7a 65 50 74 72 28 70 50 61 72 65 6e 74 2c SizePtr(pParent,
33bc0 20 61 70 44 69 76 5b 69 5d 29 3b 0a 20 20 20 20 apDiv[i]);.
33bd0 20 20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 pParent->nOver
33be0 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 20 20 7d 65 flow = 0;. }e
33bf0 6c 73 65 7b 0a 20 20 20 20 20 20 61 70 44 69 76 lse{. apDiv
33c00 5b 69 5d 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 [i] = findCell(p
33c10 50 61 72 65 6e 74 2c 20 69 2b 6e 78 44 69 76 2d Parent, i+nxDiv-
33c20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c pParent->nOverfl
33c30 6f 77 29 3b 0a 20 20 20 20 20 20 70 67 6e 6f 20 ow);. pgno
33c40 3d 20 67 65 74 34 62 79 74 65 28 61 70 44 69 76 = get4byte(apDiv
33c50 5b 69 5d 29 3b 0a 20 20 20 20 20 20 73 7a 4e 65 [i]);. szNe
33c60 77 5b 69 5d 20 3d 20 63 65 6c 6c 53 69 7a 65 50 w[i] = cellSizeP
33c70 74 72 28 70 50 61 72 65 6e 74 2c 20 61 70 44 69 tr(pParent, apDi
33c80 76 5b 69 5d 29 3b 0a 0a 20 20 20 20 20 20 2f 2a v[i]);.. /*
33c90 20 44 72 6f 70 20 74 68 65 20 63 65 6c 6c 20 66 Drop the cell f
33ca0 72 6f 6d 20 74 68 65 20 70 61 72 65 6e 74 20 70 rom the parent p
33cb0 61 67 65 2e 20 61 70 44 69 76 5b 69 5d 20 73 74 age. apDiv[i] st
33cc0 69 6c 6c 20 70 6f 69 6e 74 73 20 74 6f 0a 20 20 ill points to.
33cd0 20 20 20 20 2a 2a 20 74 68 65 20 63 65 6c 6c 20 ** the cell
33ce0 77 69 74 68 69 6e 20 74 68 65 20 70 61 72 65 6e within the paren
33cf0 74 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 20 69 t, even though i
33d00 74 20 68 61 73 20 62 65 65 6e 20 64 72 6f 70 70 t has been dropp
33d10 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68 69 ed.. ** Thi
33d20 73 20 69 73 20 73 61 66 65 20 62 65 63 61 75 73 s is safe becaus
33d30 65 20 64 72 6f 70 70 69 6e 67 20 61 20 63 65 6c e dropping a cel
33d40 6c 20 6f 6e 6c 79 20 6f 76 65 72 77 72 69 74 65 l only overwrite
33d50 73 20 74 68 65 20 66 69 72 73 74 0a 20 20 20 20 s the first.
33d60 20 20 2a 2a 20 66 6f 75 72 20 62 79 74 65 73 20 ** four bytes
33d70 6f 66 20 69 74 2c 20 61 6e 64 20 74 68 69 73 20 of it, and this
33d80 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f function does no
33d90 74 20 6e 65 65 64 20 74 68 65 20 66 69 72 73 74 t need the first
33da0 0a 20 20 20 20 20 20 2a 2a 20 66 6f 75 72 20 62 . ** four b
33db0 79 74 65 73 20 6f 66 20 74 68 65 20 64 69 76 69 ytes of the divi
33dc0 64 65 72 20 63 65 6c 6c 2e 20 53 6f 20 74 68 65 der cell. So the
33dd0 20 70 6f 69 6e 74 65 72 20 69 73 20 73 61 66 65 pointer is safe
33de0 20 74 6f 20 75 73 65 0a 20 20 20 20 20 20 2a 2a to use. **
33df0 20 6c 61 74 65 72 20 6f 6e 2e 20 20 0a 20 20 20 later on. .
33e00 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 42 **. ** B
33e10 75 74 20 6e 6f 74 20 69 66 20 77 65 20 61 72 65 ut not if we are
33e20 20 69 6e 20 73 65 63 75 72 65 2d 64 65 6c 65 74 in secure-delet
33e30 65 20 6d 6f 64 65 2e 20 49 6e 20 73 65 63 75 72 e mode. In secur
33e40 65 2d 64 65 6c 65 74 65 20 6d 6f 64 65 2c 0a 20 e-delete mode,.
33e50 20 20 20 20 20 2a 2a 20 74 68 65 20 64 72 6f 70 ** the drop
33e60 43 65 6c 6c 28 29 20 72 6f 75 74 69 6e 65 20 77 Cell() routine w
33e70 69 6c 6c 20 6f 76 65 72 77 72 69 74 65 20 74 68 ill overwrite th
33e80 65 20 65 6e 74 69 72 65 20 63 65 6c 6c 20 77 69 e entire cell wi
33e90 74 68 20 7a 65 72 6f 65 73 2e 0a 20 20 20 20 20 th zeroes..
33ea0 20 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 ** In this case
33eb0 2c 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 63 6f , temporarily co
33ec0 70 79 20 74 68 65 20 63 65 6c 6c 20 69 6e 74 6f py the cell into
33ed0 20 74 68 65 20 61 4f 76 66 6c 53 70 61 63 65 5b the aOvflSpace[
33ee0 5d 0a 20 20 20 20 20 20 2a 2a 20 62 75 66 66 65 ]. ** buffe
33ef0 72 2e 20 49 74 20 77 69 6c 6c 20 62 65 20 63 6f r. It will be co
33f00 70 69 65 64 20 6f 75 74 20 61 67 61 69 6e 20 61 pied out again a
33f10 73 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 61 53 s soon as the aS
33f20 70 61 63 65 5b 5d 20 62 75 66 66 65 72 0a 20 20 pace[] buffer.
33f30 20 20 20 20 2a 2a 20 69 73 20 61 6c 6c 6f 63 61 ** is alloca
33f40 74 65 64 2e 20 20 2a 2f 0a 20 20 20 20 20 20 69 ted. */. i
33f50 66 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 f( pBt->btsFlags
33f60 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 & BTS_SECURE_DE
33f70 4c 45 54 45 20 29 7b 0a 20 20 20 20 20 20 20 20 LETE ){.
33f80 69 6e 74 20 69 4f 66 66 3b 0a 0a 20 20 20 20 20 int iOff;..
33f90 20 20 20 69 4f 66 66 20 3d 20 53 51 4c 49 54 45 iOff = SQLITE
33fa0 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 61 70 44 69 _PTR_TO_INT(apDi
33fb0 76 5b 69 5d 29 20 2d 20 53 51 4c 49 54 45 5f 50 v[i]) - SQLITE_P
33fc0 54 52 5f 54 4f 5f 49 4e 54 28 70 50 61 72 65 6e TR_TO_INT(pParen
33fd0 74 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 20 t->aData);.
33fe0 20 20 20 69 66 28 20 28 69 4f 66 66 2b 73 7a 4e if( (iOff+szN
33ff0 65 77 5b 69 5d 29 3e 28 69 6e 74 29 70 42 74 2d ew[i])>(int)pBt-
34000 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
34010 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
34020 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
34030 54 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d T;. mem
34040 73 65 74 28 61 70 4f 6c 64 2c 20 30 2c 20 28 69 set(apOld, 0, (i
34050 2b 31 29 2a 73 69 7a 65 6f 66 28 4d 65 6d 50 61 +1)*sizeof(MemPa
34060 67 65 2a 29 29 3b 0a 20 20 20 20 20 20 20 20 20 ge*));.
34070 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c goto balance_cl
34080 65 61 6e 75 70 3b 0a 20 20 20 20 20 20 20 20 7d eanup;. }
34090 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
340a0 6d 65 6d 63 70 79 28 26 61 4f 76 66 6c 53 70 61 memcpy(&aOvflSpa
340b0 63 65 5b 69 4f 66 66 5d 2c 20 61 70 44 69 76 5b ce[iOff], apDiv[
340c0 69 5d 2c 20 73 7a 4e 65 77 5b 69 5d 29 3b 0a 20 i], szNew[i]);.
340d0 20 20 20 20 20 20 20 20 20 61 70 44 69 76 5b 69 apDiv[i
340e0 5d 20 3d 20 26 61 4f 76 66 6c 53 70 61 63 65 5b ] = &aOvflSpace[
340f0 61 70 44 69 76 5b 69 5d 2d 70 50 61 72 65 6e 74 apDiv[i]-pParent
34100 2d 3e 61 44 61 74 61 5d 3b 0a 20 20 20 20 20 20 ->aData];.
34110 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
34120 20 20 64 72 6f 70 43 65 6c 6c 28 70 50 61 72 65 dropCell(pPare
34130 6e 74 2c 20 69 2b 6e 78 44 69 76 2d 70 50 61 72 nt, i+nxDiv-pPar
34140 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2c 20 ent->nOverflow,
34150 73 7a 4e 65 77 5b 69 5d 2c 20 26 72 63 29 3b 0a szNew[i], &rc);.
34160 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
34170 4d 61 6b 65 20 6e 4d 61 78 43 65 6c 6c 73 20 61 Make nMaxCells a
34180 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 34 20 69 multiple of 4 i
34190 6e 20 6f 72 64 65 72 20 74 6f 20 70 72 65 73 65 n order to prese
341a0 72 76 65 20 38 2d 62 79 74 65 0a 20 20 2a 2a 20 rve 8-byte. **
341b0 61 6c 69 67 6e 6d 65 6e 74 20 2a 2f 0a 20 20 6e alignment */. n
341c0 4d 61 78 43 65 6c 6c 73 20 3d 20 28 6e 4d 61 78 MaxCells = (nMax
341d0 43 65 6c 6c 73 20 2b 20 33 29 26 7e 33 3b 0a 0a Cells + 3)&~3;..
341e0 20 20 2f 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 /*. ** Alloca
341f0 74 65 20 73 70 61 63 65 20 66 6f 72 20 6d 65 6d te space for mem
34200 6f 72 79 20 73 74 72 75 63 74 75 72 65 73 0a 20 ory structures.
34210 20 2a 2f 0a 20 20 6b 20 3d 20 70 42 74 2d 3e 70 */. k = pBt->p
34220 61 67 65 53 69 7a 65 20 2b 20 52 4f 55 4e 44 38 ageSize + ROUND8
34230 28 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 (sizeof(MemPage)
34240 29 3b 0a 20 20 73 7a 53 63 72 61 74 63 68 20 3d );. szScratch =
34250 0a 20 20 20 20 20 20 20 6e 4d 61 78 43 65 6c 6c . nMaxCell
34260 73 2a 73 69 7a 65 6f 66 28 75 38 2a 29 20 20 20 s*sizeof(u8*)
34270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34280 20 20 20 20 2f 2a 20 61 70 43 65 6c 6c 20 2a 2f /* apCell */
34290 0a 20 20 20 20 20 2b 20 6e 4d 61 78 43 65 6c 6c . + nMaxCell
342a0 73 2a 73 69 7a 65 6f 66 28 75 31 36 29 20 20 20 s*sizeof(u16)
342b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
342c0 20 20 20 20 2f 2a 20 73 7a 43 65 6c 6c 20 2a 2f /* szCell */
342d0 0a 20 20 20 20 20 2b 20 70 42 74 2d 3e 70 61 67 . + pBt->pag
342e0 65 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 eSize
342f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34300 20 20 20 20 2f 2a 20 61 53 70 61 63 65 31 20 2a /* aSpace1 *
34310 2f 0a 20 20 20 20 20 2b 20 6b 2a 6e 4f 6c 64 3b /. + k*nOld;
34320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34340 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 70 /* Page cop
34350 69 65 73 20 28 61 70 43 6f 70 79 29 20 2a 2f 0a ies (apCopy) */.
34360 20 20 61 70 43 65 6c 6c 20 3d 20 73 71 6c 69 74 apCell = sqlit
34370 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f 63 28 e3ScratchMalloc(
34380 20 73 7a 53 63 72 61 74 63 68 20 29 3b 20 0a 20 szScratch ); .
34390 20 69 66 28 20 61 70 43 65 6c 6c 3d 3d 30 20 29 if( apCell==0 )
343a0 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
343b0 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 67 6f 74 E_NOMEM;. got
343c0 6f 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 o balance_cleanu
343d0 70 3b 0a 20 20 7d 0a 20 20 73 7a 43 65 6c 6c 20 p;. }. szCell
343e0 3d 20 28 75 31 36 2a 29 26 61 70 43 65 6c 6c 5b = (u16*)&apCell[
343f0 6e 4d 61 78 43 65 6c 6c 73 5d 3b 0a 20 20 61 53 nMaxCells];. aS
34400 70 61 63 65 31 20 3d 20 28 75 38 2a 29 26 73 7a pace1 = (u8*)&sz
34410 43 65 6c 6c 5b 6e 4d 61 78 43 65 6c 6c 73 5d 3b Cell[nMaxCells];
34420 0a 20 20 61 73 73 65 72 74 28 20 45 49 47 48 54 . assert( EIGHT
34430 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 _BYTE_ALIGNMENT(
34440 61 53 70 61 63 65 31 29 20 29 3b 0a 0a 20 20 2f aSpace1) );.. /
34450 2a 0a 20 20 2a 2a 20 4c 6f 61 64 20 70 6f 69 6e *. ** Load poin
34460 74 65 72 73 20 74 6f 20 61 6c 6c 20 63 65 6c 6c ters to all cell
34470 73 20 6f 6e 20 73 69 62 6c 69 6e 67 20 70 61 67 s on sibling pag
34480 65 73 20 61 6e 64 20 74 68 65 20 64 69 76 69 64 es and the divid
34490 65 72 20 63 65 6c 6c 73 0a 20 20 2a 2a 20 69 6e er cells. ** in
344a0 74 6f 20 74 68 65 20 6c 6f 63 61 6c 20 61 70 43 to the local apC
344b0 65 6c 6c 5b 5d 20 61 72 72 61 79 2e 20 20 4d 61 ell[] array. Ma
344c0 6b 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 65 ke copies of the
344d0 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 0a 20 divider cells.
344e0 20 2a 2a 20 69 6e 74 6f 20 73 70 61 63 65 20 6f ** into space o
344f0 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 61 53 70 btained from aSp
34500 61 63 65 31 5b 5d 20 61 6e 64 20 72 65 6d 6f 76 ace1[] and remov
34510 65 20 74 68 65 20 64 69 76 69 64 65 72 20 63 65 e the divider ce
34520 6c 6c 73 0a 20 20 2a 2a 20 66 72 6f 6d 20 70 50 lls. ** from pP
34530 61 72 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a arent.. **. **
34540 20 49 66 20 74 68 65 20 73 69 62 6c 69 6e 67 73 If the siblings
34550 20 61 72 65 20 6f 6e 20 6c 65 61 66 20 70 61 67 are on leaf pag
34560 65 73 2c 20 74 68 65 6e 20 74 68 65 20 63 68 69 es, then the chi
34570 6c 64 20 70 6f 69 6e 74 65 72 73 20 6f 66 20 74 ld pointers of t
34580 68 65 0a 20 20 2a 2a 20 64 69 76 69 64 65 72 20 he. ** divider
34590 63 65 6c 6c 73 20 61 72 65 20 73 74 72 69 70 70 cells are stripp
345a0 65 64 20 66 72 6f 6d 20 74 68 65 20 63 65 6c 6c ed from the cell
345b0 73 20 62 65 66 6f 72 65 20 74 68 65 79 20 61 72 s before they ar
345c0 65 20 63 6f 70 69 65 64 0a 20 20 2a 2a 20 69 6e e copied. ** in
345d0 74 6f 20 61 53 70 61 63 65 31 5b 5d 2e 20 20 49 to aSpace1[]. I
345e0 6e 20 74 68 69 73 20 77 61 79 2c 20 61 6c 6c 20 n this way, all
345f0 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b cells in apCell[
34600 5d 20 61 72 65 20 77 69 74 68 6f 75 74 0a 20 20 ] are without.
34610 2a 2a 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 ** child pointer
34620 73 2e 20 20 49 66 20 73 69 62 6c 69 6e 67 73 20 s. If siblings
34630 61 72 65 20 6e 6f 74 20 6c 65 61 76 65 73 2c 20 are not leaves,
34640 74 68 65 6e 20 61 6c 6c 20 63 65 6c 6c 20 69 6e then all cell in
34650 0a 20 20 2a 2a 20 61 70 43 65 6c 6c 5b 5d 20 69 . ** apCell[] i
34660 6e 63 6c 75 64 65 20 63 68 69 6c 64 20 70 6f 69 nclude child poi
34670 6e 74 65 72 73 2e 20 20 45 69 74 68 65 72 20 77 nters. Either w
34680 61 79 2c 20 61 6c 6c 20 63 65 6c 6c 73 20 69 6e ay, all cells in
34690 20 61 70 43 65 6c 6c 5b 5d 0a 20 20 2a 2a 20 61 apCell[]. ** a
346a0 72 65 20 61 6c 69 6b 65 2e 0a 20 20 2a 2a 0a 20 re alike.. **.
346b0 20 2a 2a 20 6c 65 61 66 43 6f 72 72 65 63 74 69 ** leafCorrecti
346c0 6f 6e 3a 20 20 34 20 69 66 20 70 50 61 67 65 20 on: 4 if pPage
346d0 69 73 20 61 20 6c 65 61 66 2e 20 20 30 20 69 66 is a leaf. 0 if
346e0 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 61 20 pPage is not a
346f0 6c 65 61 66 2e 0a 20 20 2a 2a 20 20 20 20 20 20 leaf.. **
34700 20 6c 65 61 66 44 61 74 61 3a 20 20 31 20 69 66 leafData: 1 if
34710 20 70 50 61 67 65 20 68 6f 6c 64 73 20 6b 65 79 pPage holds key
34720 2b 64 61 74 61 20 61 6e 64 20 70 50 61 72 65 6e +data and pParen
34730 74 20 68 6f 6c 64 73 20 6f 6e 6c 79 20 6b 65 79 t holds only key
34740 73 2e 0a 20 20 2a 2f 0a 20 20 6c 65 61 66 43 6f s.. */. leafCo
34750 72 72 65 63 74 69 6f 6e 20 3d 20 61 70 4f 6c 64 rrection = apOld
34760 5b 30 5d 2d 3e 6c 65 61 66 2a 34 3b 0a 20 20 6c [0]->leaf*4;. l
34770 65 61 66 44 61 74 61 20 3d 20 61 70 4f 6c 64 5b eafData = apOld[
34780 30 5d 2d 3e 68 61 73 44 61 74 61 3b 0a 20 20 66 0]->hasData;. f
34790 6f 72 28 69 3d 30 3b 20 69 3c 6e 4f 6c 64 3b 20 or(i=0; i<nOld;
347a0 69 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 69 i++){. int li
347b0 6d 69 74 3b 0a 20 20 20 20 0a 20 20 20 20 2f 2a mit;. . /*
347c0 20 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 61 6e Before doing an
347d0 79 74 68 69 6e 67 20 65 6c 73 65 2c 20 74 61 6b ything else, tak
347e0 65 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 e a copy of the
347f0 69 27 74 68 20 6f 72 69 67 69 6e 61 6c 20 73 69 i'th original si
34800 62 6c 69 6e 67 0a 20 20 20 20 2a 2a 20 54 68 65 bling. ** The
34810 20 72 65 73 74 20 6f 66 20 74 68 69 73 20 66 75 rest of this fu
34820 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20 nction will use
34830 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 63 6f data from the co
34840 70 69 65 73 20 72 61 74 68 65 72 0a 20 20 20 20 pies rather.
34850 2a 2a 20 74 68 61 74 20 74 68 65 20 6f 72 69 67 ** that the orig
34860 69 6e 61 6c 20 70 61 67 65 73 20 73 69 6e 63 65 inal pages since
34870 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 the original pa
34880 67 65 73 20 77 69 6c 6c 20 62 65 20 69 6e 20 74 ges will be in t
34890 68 65 0a 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 he. ** proces
348a0 73 20 6f 66 20 62 65 69 6e 67 20 6f 76 65 72 77 s of being overw
348b0 72 69 74 74 65 6e 2e 20 20 2a 2f 0a 20 20 20 20 ritten. */.
348c0 4d 65 6d 50 61 67 65 20 2a 70 4f 6c 64 20 3d 20 MemPage *pOld =
348d0 61 70 43 6f 70 79 5b 69 5d 20 3d 20 28 4d 65 6d apCopy[i] = (Mem
348e0 50 61 67 65 2a 29 26 61 53 70 61 63 65 31 5b 70 Page*)&aSpace1[p
348f0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2b 20 6b Bt->pageSize + k
34900 2a 69 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 *i];. memcpy(
34910 70 4f 6c 64 2c 20 61 70 4f 6c 64 5b 69 5d 2c 20 pOld, apOld[i],
34920 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 29 sizeof(MemPage))
34930 3b 0a 20 20 20 20 70 4f 6c 64 2d 3e 61 44 61 74 ;. pOld->aDat
34940 61 20 3d 20 28 76 6f 69 64 2a 29 26 70 4f 6c 64 a = (void*)&pOld
34950 5b 31 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 [1];. memcpy(
34960 70 4f 6c 64 2d 3e 61 44 61 74 61 2c 20 61 70 4f pOld->aData, apO
34970 6c 64 5b 69 5d 2d 3e 61 44 61 74 61 2c 20 70 42 ld[i]->aData, pB
34980 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 0a 20 t->pageSize);..
34990 20 20 20 6c 69 6d 69 74 20 3d 20 70 4f 6c 64 2d limit = pOld-
349a0 3e 6e 43 65 6c 6c 2b 70 4f 6c 64 2d 3e 6e 4f 76 >nCell+pOld->nOv
349b0 65 72 66 6c 6f 77 3b 0a 20 20 20 20 69 66 28 20 erflow;. if(
349c0 70 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3e pOld->nOverflow>
349d0 30 20 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 6a 0 ){. for(j
349e0 3d 30 3b 20 6a 3c 6c 69 6d 69 74 3b 20 6a 2b 2b =0; j<limit; j++
349f0 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
34a00 74 28 20 6e 43 65 6c 6c 3c 6e 4d 61 78 43 65 6c t( nCell<nMaxCel
34a10 6c 73 20 29 3b 0a 20 20 20 20 20 20 20 20 61 70 ls );. ap
34a20 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 66 69 Cell[nCell] = fi
34a30 6e 64 4f 76 65 72 66 6c 6f 77 43 65 6c 6c 28 70 ndOverflowCell(p
34a40 4f 6c 64 2c 20 6a 29 3b 0a 20 20 20 20 20 20 20 Old, j);.
34a50 20 73 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d szCell[nCell] =
34a60 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 4f 6c cellSizePtr(pOl
34a70 64 2c 20 61 70 43 65 6c 6c 5b 6e 43 65 6c 6c 5d d, apCell[nCell]
34a80 29 3b 0a 20 20 20 20 20 20 20 20 6e 43 65 6c 6c );. nCell
34a90 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ++;. }.
34aa0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 75 38 20 }else{. u8
34ab0 2a 61 44 61 74 61 20 3d 20 70 4f 6c 64 2d 3e 61 *aData = pOld->a
34ac0 44 61 74 61 3b 0a 20 20 20 20 20 20 75 31 36 20 Data;. u16
34ad0 6d 61 73 6b 50 61 67 65 20 3d 20 70 4f 6c 64 2d maskPage = pOld-
34ae0 3e 6d 61 73 6b 50 61 67 65 3b 0a 20 20 20 20 20 >maskPage;.
34af0 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 20 u16 cellOffset
34b00 3d 20 70 4f 6c 64 2d 3e 63 65 6c 6c 4f 66 66 73 = pOld->cellOffs
34b10 65 74 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d et;. for(j=
34b20 30 3b 20 6a 3c 6c 69 6d 69 74 3b 20 6a 2b 2b 29 0; j<limit; j++)
34b30 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
34b40 28 20 6e 43 65 6c 6c 3c 6e 4d 61 78 43 65 6c 6c ( nCell<nMaxCell
34b50 73 20 29 3b 0a 20 20 20 20 20 20 20 20 61 70 43 s );. apC
34b60 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 66 69 6e ell[nCell] = fin
34b70 64 43 65 6c 6c 76 32 28 61 44 61 74 61 2c 20 6d dCellv2(aData, m
34b80 61 73 6b 50 61 67 65 2c 20 63 65 6c 6c 4f 66 66 askPage, cellOff
34b90 73 65 74 2c 20 6a 29 3b 0a 20 20 20 20 20 20 20 set, j);.
34ba0 20 73 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d szCell[nCell] =
34bb0 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 4f 6c cellSizePtr(pOl
34bc0 64 2c 20 61 70 43 65 6c 6c 5b 6e 43 65 6c 6c 5d d, apCell[nCell]
34bd0 29 3b 0a 20 20 20 20 20 20 20 20 6e 43 65 6c 6c );. nCell
34be0 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ++;. }.
34bf0 7d 20 20 20 20 20 20 20 0a 20 20 20 20 69 66 28 } . if(
34c00 20 69 3c 6e 4f 6c 64 2d 31 20 26 26 20 21 6c 65 i<nOld-1 && !le
34c10 61 66 44 61 74 61 29 7b 0a 20 20 20 20 20 20 75 afData){. u
34c20 31 36 20 73 7a 20 3d 20 28 75 31 36 29 73 7a 4e 16 sz = (u16)szN
34c30 65 77 5b 69 5d 3b 0a 20 20 20 20 20 20 75 38 20 ew[i];. u8
34c40 2a 70 54 65 6d 70 3b 0a 20 20 20 20 20 20 61 73 *pTemp;. as
34c50 73 65 72 74 28 20 6e 43 65 6c 6c 3c 6e 4d 61 78 sert( nCell<nMax
34c60 43 65 6c 6c 73 20 29 3b 0a 20 20 20 20 20 20 73 Cells );. s
34c70 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 73 zCell[nCell] = s
34c80 7a 3b 0a 20 20 20 20 20 20 70 54 65 6d 70 20 3d z;. pTemp =
34c90 20 26 61 53 70 61 63 65 31 5b 69 53 70 61 63 65 &aSpace1[iSpace
34ca0 31 5d 3b 0a 20 20 20 20 20 20 69 53 70 61 63 65 1];. iSpace
34cb0 31 20 2b 3d 20 73 7a 3b 0a 20 20 20 20 20 20 61 1 += sz;. a
34cc0 73 73 65 72 74 28 20 73 7a 3c 3d 70 42 74 2d 3e ssert( sz<=pBt->
34cd0 6d 61 78 4c 6f 63 61 6c 2b 32 33 20 29 3b 0a 20 maxLocal+23 );.
34ce0 20 20 20 20 20 61 73 73 65 72 74 28 20 69 53 70 assert( iSp
34cf0 61 63 65 31 20 3c 3d 20 28 69 6e 74 29 70 42 74 ace1 <= (int)pBt
34d00 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 20 20 ->pageSize );.
34d10 20 20 20 20 6d 65 6d 63 70 79 28 70 54 65 6d 70 memcpy(pTemp
34d20 2c 20 61 70 44 69 76 5b 69 5d 2c 20 73 7a 29 3b , apDiv[i], sz);
34d30 0a 20 20 20 20 20 20 61 70 43 65 6c 6c 5b 6e 43 . apCell[nC
34d40 65 6c 6c 5d 20 3d 20 70 54 65 6d 70 2b 6c 65 61 ell] = pTemp+lea
34d50 66 43 6f 72 72 65 63 74 69 6f 6e 3b 0a 20 20 20 fCorrection;.
34d60 20 20 20 61 73 73 65 72 74 28 20 6c 65 61 66 43 assert( leafC
34d70 6f 72 72 65 63 74 69 6f 6e 3d 3d 30 20 7c 7c 20 orrection==0 ||
34d80 6c 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 3d 3d leafCorrection==
34d90 34 20 29 3b 0a 20 20 20 20 20 20 73 7a 43 65 6c 4 );. szCel
34da0 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 73 7a 43 65 6c l[nCell] = szCel
34db0 6c 5b 6e 43 65 6c 6c 5d 20 2d 20 6c 65 61 66 43 l[nCell] - leafC
34dc0 6f 72 72 65 63 74 69 6f 6e 3b 0a 20 20 20 20 20 orrection;.
34dd0 20 69 66 28 20 21 70 4f 6c 64 2d 3e 6c 65 61 66 if( !pOld->leaf
34de0 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 ){. asse
34df0 72 74 28 20 6c 65 61 66 43 6f 72 72 65 63 74 69 rt( leafCorrecti
34e00 6f 6e 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 on==0 );.
34e10 20 61 73 73 65 72 74 28 20 70 4f 6c 64 2d 3e 68 assert( pOld->h
34e20 64 72 4f 66 66 73 65 74 3d 3d 30 20 29 3b 0a 20 drOffset==0 );.
34e30 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 69 /* The ri
34e40 67 68 74 20 70 6f 69 6e 74 65 72 20 6f 66 20 74 ght pointer of t
34e50 68 65 20 63 68 69 6c 64 20 70 61 67 65 20 70 4f he child page pO
34e60 6c 64 20 62 65 63 6f 6d 65 73 20 74 68 65 20 6c ld becomes the l
34e70 65 66 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 eft. ** p
34e80 6f 69 6e 74 65 72 20 6f 66 20 74 68 65 20 64 69 ointer of the di
34e90 76 69 64 65 72 20 63 65 6c 6c 20 2a 2f 0a 20 20 vider cell */.
34ea0 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 70 43 memcpy(apC
34eb0 65 6c 6c 5b 6e 43 65 6c 6c 5d 2c 20 26 70 4f 6c ell[nCell], &pOl
34ec0 64 2d 3e 61 44 61 74 61 5b 38 5d 2c 20 34 29 3b d->aData[8], 4);
34ed0 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
34ee0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 65 assert( le
34ef0 61 66 43 6f 72 72 65 63 74 69 6f 6e 3d 3d 34 20 afCorrection==4
34f00 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 73 );. if( s
34f10 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 3c 34 20 29 zCell[nCell]<4 )
34f20 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 {. /* D
34f30 6f 20 6e 6f 74 20 61 6c 6c 6f 77 20 61 6e 79 20 o not allow any
34f40 63 65 6c 6c 73 20 73 6d 61 6c 6c 65 72 20 74 68 cells smaller th
34f50 61 6e 20 34 20 62 79 74 65 73 2e 20 2a 2f 0a 20 an 4 bytes. */.
34f60 20 20 20 20 20 20 20 20 20 73 7a 43 65 6c 6c 5b szCell[
34f70 6e 43 65 6c 6c 5d 20 3d 20 34 3b 0a 20 20 20 20 nCell] = 4;.
34f80 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
34f90 20 20 20 20 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 nCell++;.
34fa0 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a }. }.. /*. *
34fb0 2a 20 46 69 67 75 72 65 20 6f 75 74 20 74 68 65 * Figure out the
34fc0 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
34fd0 20 6e 65 65 64 65 64 20 74 6f 20 68 6f 6c 64 20 needed to hold
34fe0 61 6c 6c 20 6e 43 65 6c 6c 20 63 65 6c 6c 73 2e all nCell cells.
34ff0 0a 20 20 2a 2a 20 53 74 6f 72 65 20 74 68 69 73 . ** Store this
35000 20 6e 75 6d 62 65 72 20 69 6e 20 22 6b 22 2e 20 number in "k".
35010 20 41 6c 73 6f 20 63 6f 6d 70 75 74 65 20 73 7a Also compute sz
35020 4e 65 77 5b 5d 20 77 68 69 63 68 20 69 73 20 74 New[] which is t
35030 68 65 20 74 6f 74 61 6c 0a 20 20 2a 2a 20 73 69 he total. ** si
35040 7a 65 20 6f 66 20 61 6c 6c 20 63 65 6c 6c 73 20 ze of all cells
35050 6f 6e 20 74 68 65 20 69 2d 74 68 20 70 61 67 65 on the i-th page
35060 20 61 6e 64 20 63 6e 74 4e 65 77 5b 5d 20 77 68 and cntNew[] wh
35070 69 63 68 20 69 73 20 74 68 65 20 69 6e 64 65 78 ich is the index
35080 0a 20 20 2a 2a 20 69 6e 20 61 70 43 65 6c 6c 5b . ** in apCell[
35090 5d 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 74 68 ] of the cell th
350a0 61 74 20 64 69 76 69 64 65 73 20 70 61 67 65 20 at divides page
350b0 69 20 66 72 6f 6d 20 70 61 67 65 20 69 2b 31 2e i from page i+1.
350c0 20 20 0a 20 20 2a 2a 20 63 6e 74 4e 65 77 5b 6b . ** cntNew[k
350d0 5d 20 73 68 6f 75 6c 64 20 65 71 75 61 6c 20 6e ] should equal n
350e0 43 65 6c 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 Cell.. **. **
350f0 56 61 6c 75 65 73 20 63 6f 6d 70 75 74 65 64 20 Values computed
35100 62 79 20 74 68 69 73 20 62 6c 6f 63 6b 3a 0a 20 by this block:.
35110 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 **. **
35120 20 20 20 6b 3a 20 54 68 65 20 74 6f 74 61 6c 20 k: The total
35130 6e 75 6d 62 65 72 20 6f 66 20 73 69 62 6c 69 6e number of siblin
35140 67 20 70 61 67 65 73 0a 20 20 2a 2a 20 20 20 20 g pages. **
35150 73 7a 4e 65 77 5b 69 5d 3a 20 53 70 61 63 65 64 szNew[i]: Spaced
35160 20 75 73 65 64 20 6f 6e 20 74 68 65 20 69 2d 74 used on the i-t
35170 68 20 73 69 62 6c 69 6e 67 20 70 61 67 65 2e 0a h sibling page..
35180 20 20 2a 2a 20 20 20 63 6e 74 4e 65 77 5b 69 5d ** cntNew[i]
35190 3a 20 49 6e 64 65 78 20 69 6e 20 61 70 43 65 6c : Index in apCel
351a0 6c 5b 5d 20 61 6e 64 20 73 7a 43 65 6c 6c 5b 5d l[] and szCell[]
351b0 20 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 63 for the first c
351c0 65 6c 6c 20 74 6f 0a 20 20 2a 2a 20 20 20 20 20 ell to. **
351d0 20 20 20 20 20 20 20 20 20 74 68 65 20 72 69 67 the rig
351e0 68 74 20 6f 66 20 74 68 65 20 69 2d 74 68 20 73 ht of the i-th s
351f0 69 62 6c 69 6e 67 20 70 61 67 65 2e 0a 20 20 2a ibling page.. *
35200 2a 20 75 73 61 62 6c 65 53 70 61 63 65 3a 20 4e * usableSpace: N
35210 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f umber of bytes o
35220 66 20 73 70 61 63 65 20 61 76 61 69 6c 61 62 6c f space availabl
35230 65 20 6f 6e 20 65 61 63 68 20 73 69 62 6c 69 6e e on each siblin
35240 67 2e 0a 20 20 2a 2a 20 0a 20 20 2a 2f 0a 20 20 g.. ** . */.
35250 75 73 61 62 6c 65 53 70 61 63 65 20 3d 20 70 42 usableSpace = pB
35260 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
35270 31 32 20 2b 20 6c 65 61 66 43 6f 72 72 65 63 74 12 + leafCorrect
35280 69 6f 6e 3b 0a 20 20 66 6f 72 28 73 75 62 74 6f ion;. for(subto
35290 74 61 6c 3d 6b 3d 69 3d 30 3b 20 69 3c 6e 43 65 tal=k=i=0; i<nCe
352a0 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 61 73 ll; i++){. as
352b0 73 65 72 74 28 20 69 3c 6e 4d 61 78 43 65 6c 6c sert( i<nMaxCell
352c0 73 20 29 3b 0a 20 20 20 20 73 75 62 74 6f 74 61 s );. subtota
352d0 6c 20 2b 3d 20 73 7a 43 65 6c 6c 5b 69 5d 20 2b l += szCell[i] +
352e0 20 32 3b 0a 20 20 20 20 69 66 28 20 73 75 62 74 2;. if( subt
352f0 6f 74 61 6c 20 3e 20 75 73 61 62 6c 65 53 70 61 otal > usableSpa
35300 63 65 20 29 7b 0a 20 20 20 20 20 20 73 7a 4e 65 ce ){. szNe
35310 77 5b 6b 5d 20 3d 20 73 75 62 74 6f 74 61 6c 20 w[k] = subtotal
35320 2d 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 - szCell[i];.
35330 20 20 20 63 6e 74 4e 65 77 5b 6b 5d 20 3d 20 69 cntNew[k] = i
35340 3b 0a 20 20 20 20 20 20 69 66 28 20 6c 65 61 66 ;. if( leaf
35350 44 61 74 61 20 29 7b 20 69 2d 2d 3b 20 7d 0a 20 Data ){ i--; }.
35360 20 20 20 20 20 73 75 62 74 6f 74 61 6c 20 3d 20 subtotal =
35370 30 3b 0a 20 20 20 20 20 20 6b 2b 2b 3b 0a 20 20 0;. k++;.
35380 20 20 20 20 69 66 28 20 6b 3e 4e 42 2b 31 20 29 if( k>NB+1 )
35390 7b 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f { rc = SQLITE_CO
353a0 52 52 55 50 54 5f 42 4b 50 54 3b 20 67 6f 74 6f RRUPT_BKPT; goto
353b0 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 balance_cleanup
353c0 3b 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 ; }. }. }.
353d0 73 7a 4e 65 77 5b 6b 5d 20 3d 20 73 75 62 74 6f szNew[k] = subto
353e0 74 61 6c 3b 0a 20 20 63 6e 74 4e 65 77 5b 6b 5d tal;. cntNew[k]
353f0 20 3d 20 6e 43 65 6c 6c 3b 0a 20 20 6b 2b 2b 3b = nCell;. k++;
35400 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 .. /*. ** The
35410 70 61 63 6b 69 6e 67 20 63 6f 6d 70 75 74 65 64 packing computed
35420 20 62 79 20 74 68 65 20 70 72 65 76 69 6f 75 73 by the previous
35430 20 62 6c 6f 63 6b 20 69 73 20 62 69 61 73 65 64 block is biased
35440 20 74 6f 77 61 72 64 20 74 68 65 20 73 69 62 6c toward the sibl
35450 69 6e 67 73 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 ings. ** on the
35460 20 6c 65 66 74 20 73 69 64 65 2e 20 20 54 68 65 left side. The
35470 20 6c 65 66 74 20 73 69 62 6c 69 6e 67 73 20 61 left siblings a
35480 72 65 20 61 6c 77 61 79 73 20 6e 65 61 72 6c 79 re always nearly
35490 20 66 75 6c 6c 2c 20 77 68 69 6c 65 20 74 68 65 full, while the
354a0 0a 20 20 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 . ** right-most
354b0 20 73 69 62 6c 69 6e 67 20 6d 69 67 68 74 20 62 sibling might b
354c0 65 20 6e 65 61 72 6c 79 20 65 6d 70 74 79 2e 20 e nearly empty.
354d0 20 54 68 69 73 20 62 6c 6f 63 6b 20 6f 66 20 63 This block of c
354e0 6f 64 65 20 61 74 74 65 6d 70 74 73 0a 20 20 2a ode attempts. *
354f0 2a 20 74 6f 20 61 64 6a 75 73 74 20 74 68 65 20 * to adjust the
35500 70 61 63 6b 69 6e 67 20 6f 66 20 73 69 62 6c 69 packing of sibli
35510 6e 67 73 20 74 6f 20 67 65 74 20 61 20 62 65 74 ngs to get a bet
35520 74 65 72 20 62 61 6c 61 6e 63 65 2e 0a 20 20 2a ter balance.. *
35530 2a 0a 20 20 2a 2a 20 54 68 69 73 20 61 64 6a 75 *. ** This adju
35540 73 74 6d 65 6e 74 20 69 73 20 6d 6f 72 65 20 74 stment is more t
35550 68 61 6e 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 han an optimizat
35560 69 6f 6e 2e 20 20 54 68 65 20 70 61 63 6b 69 6e ion. The packin
35570 67 20 61 62 6f 76 65 20 6d 69 67 68 74 0a 20 20 g above might.
35580 2a 2a 20 62 65 20 73 6f 20 6f 75 74 20 6f 66 20 ** be so out of
35590 62 61 6c 61 6e 63 65 20 61 73 20 74 6f 20 62 65 balance as to be
355a0 20 69 6c 6c 65 67 61 6c 2e 20 20 46 6f 72 20 65 illegal. For e
355b0 78 61 6d 70 6c 65 2c 20 74 68 65 20 72 69 67 68 xample, the righ
355c0 74 2d 6d 6f 73 74 0a 20 20 2a 2a 20 73 69 62 6c t-most. ** sibl
355d0 69 6e 67 20 6d 69 67 68 74 20 62 65 20 63 6f 6d ing might be com
355e0 70 6c 65 74 65 6c 79 20 65 6d 70 74 79 2e 20 20 pletely empty.
355f0 54 68 69 73 20 61 64 6a 75 73 74 6d 65 6e 74 20 This adjustment
35600 69 73 20 6e 6f 74 20 6f 70 74 69 6f 6e 61 6c 2e is not optional.
35610 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 6b 2d . */. for(i=k-
35620 31 3b 20 69 3e 30 3b 20 69 2d 2d 29 7b 0a 20 20 1; i>0; i--){.
35630 20 20 69 6e 74 20 73 7a 52 69 67 68 74 20 3d 20 int szRight =
35640 73 7a 4e 65 77 5b 69 5d 3b 20 20 2f 2a 20 53 69 szNew[i]; /* Si
35650 7a 65 20 6f 66 20 73 69 62 6c 69 6e 67 20 6f 6e ze of sibling on
35660 20 74 68 65 20 72 69 67 68 74 20 2a 2f 0a 20 20 the right */.
35670 20 20 69 6e 74 20 73 7a 4c 65 66 74 20 3d 20 73 int szLeft = s
35680 7a 4e 65 77 5b 69 2d 31 5d 3b 20 2f 2a 20 53 69 zNew[i-1]; /* Si
35690 7a 65 20 6f 66 20 73 69 62 6c 69 6e 67 20 6f 6e ze of sibling on
356a0 20 74 68 65 20 6c 65 66 74 20 2a 2f 0a 20 20 20 the left */.
356b0 20 69 6e 74 20 72 3b 20 20 20 20 20 20 20 20 20 int r;
356c0 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
356d0 20 72 69 67 68 74 2d 6d 6f 73 74 20 63 65 6c 6c right-most cell
356e0 20 69 6e 20 6c 65 66 74 20 73 69 62 6c 69 6e 67 in left sibling
356f0 20 2a 2f 0a 20 20 20 20 69 6e 74 20 64 3b 20 20 */. int d;
35700 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
35710 6e 64 65 78 20 6f 66 20 66 69 72 73 74 20 63 65 ndex of first ce
35720 6c 6c 20 74 6f 20 74 68 65 20 6c 65 66 74 20 6f ll to the left o
35730 66 20 72 69 67 68 74 20 73 69 62 6c 69 6e 67 20 f right sibling
35740 2a 2f 0a 0a 20 20 20 20 72 20 3d 20 63 6e 74 4e */.. r = cntN
35750 65 77 5b 69 2d 31 5d 20 2d 20 31 3b 0a 20 20 20 ew[i-1] - 1;.
35760 20 64 20 3d 20 72 20 2b 20 31 20 2d 20 6c 65 61 d = r + 1 - lea
35770 66 44 61 74 61 3b 0a 20 20 20 20 61 73 73 65 72 fData;. asser
35780 74 28 20 64 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 t( d<nMaxCells )
35790 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 3c ;. assert( r<
357a0 6e 4d 61 78 43 65 6c 6c 73 20 29 3b 0a 20 20 20 nMaxCells );.
357b0 20 77 68 69 6c 65 28 20 73 7a 52 69 67 68 74 3d while( szRight=
357c0 3d 30 20 0a 20 20 20 20 20 20 20 7c 7c 20 28 21 =0 . || (!
357d0 62 42 75 6c 6b 20 26 26 20 73 7a 52 69 67 68 74 bBulk && szRight
357e0 2b 73 7a 43 65 6c 6c 5b 64 5d 2b 32 3c 3d 73 7a +szCell[d]+2<=sz
357f0 4c 65 66 74 2d 28 73 7a 43 65 6c 6c 5b 72 5d 2b Left-(szCell[r]+
35800 32 29 29 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 2)) . ){.
35810 20 20 73 7a 52 69 67 68 74 20 2b 3d 20 73 7a 43 szRight += szC
35820 65 6c 6c 5b 64 5d 20 2b 20 32 3b 0a 20 20 20 20 ell[d] + 2;.
35830 20 20 73 7a 4c 65 66 74 20 2d 3d 20 73 7a 43 65 szLeft -= szCe
35840 6c 6c 5b 72 5d 20 2b 20 32 3b 0a 20 20 20 20 20 ll[r] + 2;.
35850 20 63 6e 74 4e 65 77 5b 69 2d 31 5d 2d 2d 3b 0a cntNew[i-1]--;.
35860 20 20 20 20 20 20 72 20 3d 20 63 6e 74 4e 65 77 r = cntNew
35870 5b 69 2d 31 5d 20 2d 20 31 3b 0a 20 20 20 20 20 [i-1] - 1;.
35880 20 64 20 3d 20 72 20 2b 20 31 20 2d 20 6c 65 61 d = r + 1 - lea
35890 66 44 61 74 61 3b 0a 20 20 20 20 7d 0a 20 20 20 fData;. }.
358a0 20 73 7a 4e 65 77 5b 69 5d 20 3d 20 73 7a 52 69 szNew[i] = szRi
358b0 67 68 74 3b 0a 20 20 20 20 73 7a 4e 65 77 5b 69 ght;. szNew[i
358c0 2d 31 5d 20 3d 20 73 7a 4c 65 66 74 3b 0a 20 20 -1] = szLeft;.
358d0 7d 0a 0a 20 20 2f 2a 20 45 69 74 68 65 72 20 77 }.. /* Either w
358e0 65 20 66 6f 75 6e 64 20 6f 6e 65 20 6f 72 20 6d e found one or m
358f0 6f 72 65 20 63 65 6c 6c 73 20 28 63 6e 74 6e 65 ore cells (cntne
35900 77 5b 30 5d 29 3e 30 29 20 6f 72 20 70 50 61 67 w[0])>0) or pPag
35910 65 20 69 73 0a 20 20 2a 2a 20 61 20 76 69 72 74 e is. ** a virt
35920 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 20 ual root page.
35930 41 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 A virtual root p
35940 61 67 65 20 69 73 20 77 68 65 6e 20 74 68 65 20 age is when the
35950 72 65 61 6c 20 72 6f 6f 74 0a 20 20 2a 2a 20 70 real root. ** p
35960 61 67 65 20 69 73 20 70 61 67 65 20 31 20 61 6e age is page 1 an
35970 64 20 77 65 20 61 72 65 20 74 68 65 20 6f 6e 6c d we are the onl
35980 79 20 63 68 69 6c 64 20 6f 66 20 74 68 61 74 20 y child of that
35990 70 61 67 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 page.. **. **
359a0 55 50 44 41 54 45 3a 20 20 54 68 65 20 61 73 73 UPDATE: The ass
359b0 65 72 74 28 29 20 62 65 6c 6f 77 20 69 73 20 6e ert() below is n
359c0 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 74 ot necessarily t
359d0 72 75 65 20 69 66 20 74 68 65 20 64 61 74 61 62 rue if the datab
359e0 61 73 65 0a 20 20 2a 2a 20 66 69 6c 65 20 69 73 ase. ** file is
359f0 20 63 6f 72 72 75 70 74 2e 20 20 54 68 65 20 63 corrupt. The c
35a00 6f 72 72 75 70 74 69 6f 6e 20 77 69 6c 6c 20 62 orruption will b
35a10 65 20 64 65 74 65 63 74 65 64 20 61 6e 64 20 72 e detected and r
35a20 65 70 6f 72 74 65 64 20 6c 61 74 65 72 0a 20 20 eported later.
35a30 2a 2a 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65 ** in this proce
35a40 64 75 72 65 20 73 6f 20 74 68 65 72 65 20 69 73 dure so there is
35a50 20 6e 6f 20 6e 65 65 64 20 74 6f 20 61 63 74 20 no need to act
35a60 75 70 6f 6e 20 69 74 20 6e 6f 77 2e 0a 20 20 2a upon it now.. *
35a70 2f 0a 23 69 66 20 30 0a 20 20 61 73 73 65 72 74 /.#if 0. assert
35a80 28 20 63 6e 74 4e 65 77 5b 30 5d 3e 30 20 7c 7c ( cntNew[0]>0 ||
35a90 20 28 70 50 61 72 65 6e 74 2d 3e 70 67 6e 6f 3d (pParent->pgno=
35aa0 3d 31 20 26 26 20 70 50 61 72 65 6e 74 2d 3e 6e =1 && pParent->n
35ab0 43 65 6c 6c 3d 3d 30 29 20 29 3b 0a 23 65 6e 64 Cell==0) );.#end
35ac0 69 66 0a 0a 20 20 54 52 41 43 45 28 28 22 42 41 if.. TRACE(("BA
35ad0 4c 41 4e 43 45 3a 20 6f 6c 64 3a 20 25 64 20 25 LANCE: old: %d %
35ae0 64 20 25 64 20 20 22 2c 0a 20 20 20 20 61 70 4f d %d ",. apO
35af0 6c 64 5b 30 5d 2d 3e 70 67 6e 6f 2c 20 0a 20 20 ld[0]->pgno, .
35b00 20 20 6e 4f 6c 64 3e 3d 32 20 3f 20 61 70 4f 6c nOld>=2 ? apOl
35b10 64 5b 31 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 0a d[1]->pgno : 0,.
35b20 20 20 20 20 6e 4f 6c 64 3e 3d 33 20 3f 20 61 70 nOld>=3 ? ap
35b30 4f 6c 64 5b 32 5d 2d 3e 70 67 6e 6f 20 3a 20 30 Old[2]->pgno : 0
35b40 0a 20 20 29 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a . ));.. /*. *
35b50 2a 20 41 6c 6c 6f 63 61 74 65 20 6b 20 6e 65 77 * Allocate k new
35b60 20 70 61 67 65 73 2e 20 20 52 65 75 73 65 20 6f pages. Reuse o
35b70 6c 64 20 70 61 67 65 73 20 77 68 65 72 65 20 70 ld pages where p
35b80 6f 73 73 69 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 ossible.. */.
35b90 69 66 28 20 61 70 4f 6c 64 5b 30 5d 2d 3e 70 67 if( apOld[0]->pg
35ba0 6e 6f 3c 3d 31 20 29 7b 0a 20 20 20 20 72 63 20 no<=1 ){. rc
35bb0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
35bc0 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 _BKPT;. goto
35bd0 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b balance_cleanup;
35be0 0a 20 20 7d 0a 20 20 70 61 67 65 46 6c 61 67 73 . }. pageFlags
35bf0 20 3d 20 61 70 4f 6c 64 5b 30 5d 2d 3e 61 44 61 = apOld[0]->aDa
35c00 74 61 5b 30 5d 3b 0a 20 20 66 6f 72 28 69 3d 30 ta[0];. for(i=0
35c10 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 ; i<k; i++){.
35c20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 3b 0a MemPage *pNew;.
35c30 20 20 20 20 69 66 28 20 69 3c 6e 4f 6c 64 20 29 if( i<nOld )
35c40 7b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 61 {. pNew = a
35c50 70 4e 65 77 5b 69 5d 20 3d 20 61 70 4f 6c 64 5b pNew[i] = apOld[
35c60 69 5d 3b 0a 20 20 20 20 20 20 61 70 4f 6c 64 5b i];. apOld[
35c70 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 63 i] = 0;. rc
35c80 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
35c90 72 69 74 65 28 70 4e 65 77 2d 3e 70 44 62 50 61 rite(pNew->pDbPa
35ca0 67 65 29 3b 0a 20 20 20 20 20 20 6e 4e 65 77 2b ge);. nNew+
35cb0 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 +;. if( rc
35cc0 29 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 ) goto balance_c
35cd0 6c 65 61 6e 75 70 3b 0a 20 20 20 20 7d 65 6c 73 leanup;. }els
35ce0 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 e{. assert(
35cf0 20 69 3e 30 20 29 3b 0a 20 20 20 20 20 20 72 63 i>0 );. rc
35d00 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 = allocateBtree
35d10 50 61 67 65 28 70 42 74 2c 20 26 70 4e 65 77 2c Page(pBt, &pNew,
35d20 20 26 70 67 6e 6f 2c 20 28 62 42 75 6c 6b 20 3f &pgno, (bBulk ?
35d30 20 31 20 3a 20 70 67 6e 6f 29 2c 20 30 29 3b 0a 1 : pgno), 0);.
35d40 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 if( rc ) g
35d50 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 oto balance_clea
35d60 6e 75 70 3b 0a 20 20 20 20 20 20 61 70 4e 65 77 nup;. apNew
35d70 5b 69 5d 20 3d 20 70 4e 65 77 3b 0a 20 20 20 20 [i] = pNew;.
35d80 20 20 6e 4e 65 77 2b 2b 3b 0a 0a 20 20 20 20 20 nNew++;..
35d90 20 2f 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e /* Set the poin
35da0 74 65 72 2d 6d 61 70 20 65 6e 74 72 79 20 66 6f ter-map entry fo
35db0 72 20 74 68 65 20 6e 65 77 20 73 69 62 6c 69 6e r the new siblin
35dc0 67 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 g page. */.
35dd0 20 69 66 28 20 49 53 41 55 54 4f 56 41 43 55 55 if( ISAUTOVACUU
35de0 4d 20 29 7b 0a 20 20 20 20 20 20 20 20 70 74 72 M ){. ptr
35df0 6d 61 70 50 75 74 28 70 42 74 2c 20 70 4e 65 77 mapPut(pBt, pNew
35e00 2d 3e 70 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 ->pgno, PTRMAP_B
35e10 54 52 45 45 2c 20 70 50 61 72 65 6e 74 2d 3e 70 TREE, pParent->p
35e20 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 gno, &rc);.
35e30 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
35e40 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
35e50 20 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 goto balance_c
35e60 6c 65 61 6e 75 70 3b 0a 20 20 20 20 20 20 20 20 leanup;.
35e70 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a }. }. }.
35e80 20 20 7d 0a 0a 20 20 2f 2a 20 46 72 65 65 20 61 }.. /* Free a
35e90 6e 79 20 6f 6c 64 20 70 61 67 65 73 20 74 68 61 ny old pages tha
35ea0 74 20 77 65 72 65 20 6e 6f 74 20 72 65 75 73 65 t were not reuse
35eb0 64 20 61 73 20 6e 65 77 20 70 61 67 65 73 2e 0a d as new pages..
35ec0 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 69 3c */. while( i<
35ed0 6e 4f 6c 64 20 29 7b 0a 20 20 20 20 66 72 65 65 nOld ){. free
35ee0 50 61 67 65 28 61 70 4f 6c 64 5b 69 5d 2c 20 26 Page(apOld[i], &
35ef0 72 63 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 rc);. if( rc
35f00 29 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 ) goto balance_c
35f10 6c 65 61 6e 75 70 3b 0a 20 20 20 20 72 65 6c 65 leanup;. rele
35f20 61 73 65 50 61 67 65 28 61 70 4f 6c 64 5b 69 5d asePage(apOld[i]
35f30 29 3b 0a 20 20 20 20 61 70 4f 6c 64 5b 69 5d 20 );. apOld[i]
35f40 3d 20 30 3b 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 = 0;. i++;.
35f50 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50 75 74 }.. /*. ** Put
35f60 20 74 68 65 20 6e 65 77 20 70 61 67 65 73 20 69 the new pages i
35f70 6e 20 61 63 63 65 6e 64 69 6e 67 20 6f 72 64 65 n accending orde
35f80 72 2e 20 20 54 68 69 73 20 68 65 6c 70 73 20 74 r. This helps t
35f90 6f 0a 20 20 2a 2a 20 6b 65 65 70 20 65 6e 74 72 o. ** keep entr
35fa0 69 65 73 20 69 6e 20 74 68 65 20 64 69 73 6b 20 ies in the disk
35fb0 66 69 6c 65 20 69 6e 20 6f 72 64 65 72 20 73 6f file in order so
35fc0 20 74 68 61 74 20 61 20 73 63 61 6e 0a 20 20 2a that a scan. *
35fd0 2a 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 69 * of the table i
35fe0 73 20 61 20 6c 69 6e 65 61 72 20 73 63 61 6e 20 s a linear scan
35ff0 74 68 72 6f 75 67 68 20 74 68 65 20 66 69 6c 65 through the file
36000 2e 20 20 54 68 61 74 0a 20 20 2a 2a 20 69 6e 20 . That. ** in
36010 74 75 72 6e 20 68 65 6c 70 73 20 74 68 65 20 6f turn helps the o
36020 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 perating system
36030 74 6f 20 64 65 6c 69 76 65 72 20 70 61 67 65 73 to deliver pages
36040 0a 20 20 2a 2a 20 66 72 6f 6d 20 74 68 65 20 64 . ** from the d
36050 69 73 6b 20 6d 6f 72 65 20 72 61 70 69 64 6c 79 isk more rapidly
36060 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e 20 4f .. **. ** An O
36070 28 6e 5e 32 29 20 69 6e 73 65 72 74 69 6f 6e 20 (n^2) insertion
36080 73 6f 72 74 20 61 6c 67 6f 72 69 74 68 6d 20 69 sort algorithm i
36090 73 20 75 73 65 64 2c 20 62 75 74 20 73 69 6e 63 s used, but sinc
360a0 65 0a 20 20 2a 2a 20 6e 20 69 73 20 6e 65 76 65 e. ** n is neve
360b0 72 20 6d 6f 72 65 20 74 68 61 6e 20 4e 42 20 28 r more than NB (
360c0 61 20 73 6d 61 6c 6c 20 63 6f 6e 73 74 61 6e 74 a small constant
360d0 29 2c 20 74 68 61 74 20 73 68 6f 75 6c 64 0a 20 ), that should.
360e0 20 2a 2a 20 6e 6f 74 20 62 65 20 61 20 70 72 6f ** not be a pro
360f0 62 6c 65 6d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 blem.. **. **
36100 57 68 65 6e 20 4e 42 3d 3d 33 2c 20 74 68 69 73 When NB==3, this
36110 20 6f 6e 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f one optimizatio
36120 6e 20 6d 61 6b 65 73 20 74 68 65 20 64 61 74 61 n makes the data
36130 62 61 73 65 0a 20 20 2a 2a 20 61 62 6f 75 74 20 base. ** about
36140 32 35 25 20 66 61 73 74 65 72 20 66 6f 72 20 6c 25% faster for l
36150 61 72 67 65 20 69 6e 73 65 72 74 69 6f 6e 73 20 arge insertions
36160 61 6e 64 20 64 65 6c 65 74 69 6f 6e 73 2e 0a 20 and deletions..
36170 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 */. for(i=0; i
36180 3c 6b 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 <k-1; i++){.
36190 69 6e 74 20 6d 69 6e 56 20 3d 20 61 70 4e 65 77 int minV = apNew
361a0 5b 69 5d 2d 3e 70 67 6e 6f 3b 0a 20 20 20 20 69 [i]->pgno;. i
361b0 6e 74 20 6d 69 6e 49 20 3d 20 69 3b 0a 20 20 20 nt minI = i;.
361c0 20 66 6f 72 28 6a 3d 69 2b 31 3b 20 6a 3c 6b 3b for(j=i+1; j<k;
361d0 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 j++){. if(
361e0 20 61 70 4e 65 77 5b 6a 5d 2d 3e 70 67 6e 6f 3c apNew[j]->pgno<
361f0 28 75 6e 73 69 67 6e 65 64 29 6d 69 6e 56 20 29 (unsigned)minV )
36200 7b 0a 20 20 20 20 20 20 20 20 6d 69 6e 49 20 3d {. minI =
36210 20 6a 3b 0a 20 20 20 20 20 20 20 20 6d 69 6e 56 j;. minV
36220 20 3d 20 61 70 4e 65 77 5b 6a 5d 2d 3e 70 67 6e = apNew[j]->pgn
36230 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d o;. }. }
36240 0a 20 20 20 20 69 66 28 20 6d 69 6e 49 3e 69 20 . if( minI>i
36250 29 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 ){. MemPage
36260 20 2a 70 54 3b 0a 20 20 20 20 20 20 70 54 20 3d *pT;. pT =
36270 20 61 70 4e 65 77 5b 69 5d 3b 0a 20 20 20 20 20 apNew[i];.
36280 20 61 70 4e 65 77 5b 69 5d 20 3d 20 61 70 4e 65 apNew[i] = apNe
36290 77 5b 6d 69 6e 49 5d 3b 0a 20 20 20 20 20 20 61 w[minI];. a
362a0 70 4e 65 77 5b 6d 69 6e 49 5d 20 3d 20 70 54 3b pNew[minI] = pT;
362b0 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 54 52 41 . }. }. TRA
362c0 43 45 28 28 22 6e 65 77 3a 20 25 64 28 25 64 29 CE(("new: %d(%d)
362d0 20 25 64 28 25 64 29 20 25 64 28 25 64 29 20 25 %d(%d) %d(%d) %
362e0 64 28 25 64 29 20 25 64 28 25 64 29 5c 6e 22 2c d(%d) %d(%d)\n",
362f0 0a 20 20 20 20 61 70 4e 65 77 5b 30 5d 2d 3e 70 . apNew[0]->p
36300 67 6e 6f 2c 20 73 7a 4e 65 77 5b 30 5d 2c 0a 20 gno, szNew[0],.
36310 20 20 20 6e 4e 65 77 3e 3d 32 20 3f 20 61 70 4e nNew>=2 ? apN
36320 65 77 5b 31 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c ew[1]->pgno : 0,
36330 20 6e 4e 65 77 3e 3d 32 20 3f 20 73 7a 4e 65 77 nNew>=2 ? szNew
36340 5b 31 5d 20 3a 20 30 2c 0a 20 20 20 20 6e 4e 65 [1] : 0,. nNe
36350 77 3e 3d 33 20 3f 20 61 70 4e 65 77 5b 32 5d 2d w>=3 ? apNew[2]-
36360 3e 70 67 6e 6f 20 3a 20 30 2c 20 6e 4e 65 77 3e >pgno : 0, nNew>
36370 3d 33 20 3f 20 73 7a 4e 65 77 5b 32 5d 20 3a 20 =3 ? szNew[2] :
36380 30 2c 0a 20 20 20 20 6e 4e 65 77 3e 3d 34 20 3f 0,. nNew>=4 ?
36390 20 61 70 4e 65 77 5b 33 5d 2d 3e 70 67 6e 6f 20 apNew[3]->pgno
363a0 3a 20 30 2c 20 6e 4e 65 77 3e 3d 34 20 3f 20 73 : 0, nNew>=4 ? s
363b0 7a 4e 65 77 5b 33 5d 20 3a 20 30 2c 0a 20 20 20 zNew[3] : 0,.
363c0 20 6e 4e 65 77 3e 3d 35 20 3f 20 61 70 4e 65 77 nNew>=5 ? apNew
363d0 5b 34 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 20 6e [4]->pgno : 0, n
363e0 4e 65 77 3e 3d 35 20 3f 20 73 7a 4e 65 77 5b 34 New>=5 ? szNew[4
363f0 5d 20 3a 20 30 29 29 3b 0a 0a 20 20 61 73 73 65 ] : 0));.. asse
36400 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
36410 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 72 Iswriteable(pPar
36420 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 29 3b ent->pDbPage) );
36430 0a 20 20 70 75 74 34 62 79 74 65 28 70 52 69 67 . put4byte(pRig
36440 68 74 2c 20 61 70 4e 65 77 5b 6e 4e 65 77 2d 31 ht, apNew[nNew-1
36450 5d 2d 3e 70 67 6e 6f 29 3b 0a 0a 20 20 2f 2a 0a ]->pgno);.. /*.
36460 20 20 2a 2a 20 45 76 65 6e 6c 79 20 64 69 73 74 ** Evenly dist
36470 72 69 62 75 74 65 20 74 68 65 20 64 61 74 61 20 ribute the data
36480 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 61 63 72 6f in apCell[] acro
36490 73 73 20 74 68 65 20 6e 65 77 20 70 61 67 65 73 ss the new pages
364a0 2e 0a 20 20 2a 2a 20 49 6e 73 65 72 74 20 64 69 .. ** Insert di
364b0 76 69 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 6f vider cells into
364c0 20 70 50 61 72 65 6e 74 20 61 73 20 6e 65 63 65 pParent as nece
364d0 73 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 6a 20 ssary.. */. j
364e0 3d 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 = 0;. for(i=0;
364f0 69 3c 6e 4e 65 77 3b 20 69 2b 2b 29 7b 0a 20 20 i<nNew; i++){.
36500 20 20 2f 2a 20 41 73 73 65 6d 62 6c 65 20 74 68 /* Assemble th
36510 65 20 6e 65 77 20 73 69 62 6c 69 6e 67 20 70 61 e new sibling pa
36520 67 65 2e 20 2a 2f 0a 20 20 20 20 4d 65 6d 50 61 ge. */. MemPa
36530 67 65 20 2a 70 4e 65 77 20 3d 20 61 70 4e 65 77 ge *pNew = apNew
36540 5b 69 5d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 [i];. assert(
36550 20 6a 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b 0a j<nMaxCells );.
36560 20 20 20 20 7a 65 72 6f 50 61 67 65 28 70 4e 65 zeroPage(pNe
36570 77 2c 20 70 61 67 65 46 6c 61 67 73 29 3b 0a 20 w, pageFlags);.
36580 20 20 20 61 73 73 65 6d 62 6c 65 50 61 67 65 28 assemblePage(
36590 70 4e 65 77 2c 20 63 6e 74 4e 65 77 5b 69 5d 2d pNew, cntNew[i]-
365a0 6a 2c 20 26 61 70 43 65 6c 6c 5b 6a 5d 2c 20 26 j, &apCell[j], &
365b0 73 7a 43 65 6c 6c 5b 6a 5d 29 3b 0a 20 20 20 20 szCell[j]);.
365c0 61 73 73 65 72 74 28 20 70 4e 65 77 2d 3e 6e 43 assert( pNew->nC
365d0 65 6c 6c 3e 30 20 7c 7c 20 28 6e 4e 65 77 3d 3d ell>0 || (nNew==
365e0 31 20 26 26 20 63 6e 74 4e 65 77 5b 30 5d 3d 3d 1 && cntNew[0]==
365f0 30 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 0) );. assert
36600 28 20 70 4e 65 77 2d 3e 6e 4f 76 65 72 66 6c 6f ( pNew->nOverflo
36610 77 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 6a 20 3d w==0 );.. j =
36620 20 63 6e 74 4e 65 77 5b 69 5d 3b 0a 0a 20 20 20 cntNew[i];..
36630 20 2f 2a 20 49 66 20 74 68 65 20 73 69 62 6c 69 /* If the sibli
36640 6e 67 20 70 61 67 65 20 61 73 73 65 6d 62 6c 65 ng page assemble
36650 64 20 61 62 6f 76 65 20 77 61 73 20 6e 6f 74 20 d above was not
36660 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 73 the right-most s
36670 69 62 6c 69 6e 67 2c 0a 20 20 20 20 2a 2a 20 69 ibling,. ** i
36680 6e 73 65 72 74 20 61 20 64 69 76 69 64 65 72 20 nsert a divider
36690 63 65 6c 6c 20 69 6e 74 6f 20 74 68 65 20 70 61 cell into the pa
366a0 72 65 6e 74 20 70 61 67 65 2e 0a 20 20 20 20 2a rent page.. *
366b0 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 3c /. assert( i<
366c0 6e 4e 65 77 2d 31 20 7c 7c 20 6a 3d 3d 6e 43 65 nNew-1 || j==nCe
366d0 6c 6c 20 29 3b 0a 20 20 20 20 69 66 28 20 6a 3c ll );. if( j<
366e0 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 75 nCell ){. u
366f0 38 20 2a 70 43 65 6c 6c 3b 0a 20 20 20 20 20 20 8 *pCell;.
36700 75 38 20 2a 70 54 65 6d 70 3b 0a 20 20 20 20 20 u8 *pTemp;.
36710 20 69 6e 74 20 73 7a 3b 0a 0a 20 20 20 20 20 20 int sz;..
36720 61 73 73 65 72 74 28 20 6a 3c 6e 4d 61 78 43 65 assert( j<nMaxCe
36730 6c 6c 73 20 29 3b 0a 20 20 20 20 20 20 70 43 65 lls );. pCe
36740 6c 6c 20 3d 20 61 70 43 65 6c 6c 5b 6a 5d 3b 0a ll = apCell[j];.
36750 20 20 20 20 20 20 73 7a 20 3d 20 73 7a 43 65 6c sz = szCel
36760 6c 5b 6a 5d 20 2b 20 6c 65 61 66 43 6f 72 72 65 l[j] + leafCorre
36770 63 74 69 6f 6e 3b 0a 20 20 20 20 20 20 70 54 65 ction;. pTe
36780 6d 70 20 3d 20 26 61 4f 76 66 6c 53 70 61 63 65 mp = &aOvflSpace
36790 5b 69 4f 76 66 6c 53 70 61 63 65 5d 3b 0a 20 20 [iOvflSpace];.
367a0 20 20 20 20 69 66 28 20 21 70 4e 65 77 2d 3e 6c if( !pNew->l
367b0 65 61 66 20 29 7b 0a 20 20 20 20 20 20 20 20 6d eaf ){. m
367c0 65 6d 63 70 79 28 26 70 4e 65 77 2d 3e 61 44 61 emcpy(&pNew->aDa
367d0 74 61 5b 38 5d 2c 20 70 43 65 6c 6c 2c 20 34 29 ta[8], pCell, 4)
367e0 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 ;. }else if
367f0 28 20 6c 65 61 66 44 61 74 61 20 29 7b 0a 20 20 ( leafData ){.
36800 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 /* If the
36810 74 72 65 65 20 69 73 20 61 20 6c 65 61 66 2d 64 tree is a leaf-d
36820 61 74 61 20 74 72 65 65 2c 20 61 6e 64 20 74 68 ata tree, and th
36830 65 20 73 69 62 6c 69 6e 67 73 20 61 72 65 20 6c e siblings are l
36840 65 61 76 65 73 2c 20 0a 20 20 20 20 20 20 20 20 eaves, .
36850 2a 2a 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 ** then there is
36860 20 6e 6f 20 64 69 76 69 64 65 72 20 63 65 6c 6c no divider cell
36870 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 2e 20 49 6e in apCell[]. In
36880 73 74 65 61 64 2c 20 74 68 65 20 64 69 76 69 64 stead, the divid
36890 65 72 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 63 er . ** c
368a0 65 6c 6c 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 ell consists of
368b0 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 20 the integer key
368c0 66 6f 72 20 74 68 65 20 72 69 67 68 74 2d 6d 6f for the right-mo
368d0 73 74 20 63 65 6c 6c 20 6f 66 20 0a 20 20 20 20 st cell of .
368e0 20 20 20 20 2a 2a 20 74 68 65 20 73 69 62 6c 69 ** the sibli
368f0 6e 67 2d 70 61 67 65 20 61 73 73 65 6d 62 6c 65 ng-page assemble
36900 64 20 61 62 6f 76 65 20 6f 6e 6c 79 2e 0a 20 20 d above only..
36910 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
36920 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a CellInfo info;.
36930 20 20 20 20 20 20 20 20 6a 2d 2d 3b 0a 20 20 20 j--;.
36940 20 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 btreeParseC
36950 65 6c 6c 50 74 72 28 70 4e 65 77 2c 20 61 70 43 ellPtr(pNew, apC
36960 65 6c 6c 5b 6a 5d 2c 20 26 69 6e 66 6f 29 3b 0a ell[j], &info);.
36970 20 20 20 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 pCell =
36980 70 54 65 6d 70 3b 0a 20 20 20 20 20 20 20 20 73 pTemp;. s
36990 7a 20 3d 20 34 20 2b 20 70 75 74 56 61 72 69 6e z = 4 + putVarin
369a0 74 28 26 70 43 65 6c 6c 5b 34 5d 2c 20 69 6e 66 t(&pCell[4], inf
369b0 6f 2e 6e 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 o.nKey);.
369c0 20 70 54 65 6d 70 20 3d 20 30 3b 0a 20 20 20 20 pTemp = 0;.
369d0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
369e0 20 70 43 65 6c 6c 20 2d 3d 20 34 3b 0a 20 20 20 pCell -= 4;.
369f0 20 20 20 20 20 2f 2a 20 4f 62 73 63 75 72 65 20 /* Obscure
36a00 63 61 73 65 20 66 6f 72 20 6e 6f 6e 2d 6c 65 61 case for non-lea
36a10 66 2d 64 61 74 61 20 74 72 65 65 73 3a 20 49 66 f-data trees: If
36a20 20 74 68 65 20 63 65 6c 6c 20 61 74 20 70 43 65 the cell at pCe
36a30 6c 6c 20 77 61 73 0a 20 20 20 20 20 20 20 20 2a ll was. *
36a40 2a 20 70 72 65 76 69 6f 75 73 6c 79 20 73 74 6f * previously sto
36a50 72 65 64 20 6f 6e 20 61 20 6c 65 61 66 20 6e 6f red on a leaf no
36a60 64 65 2c 20 61 6e 64 20 69 74 73 20 72 65 70 6f de, and its repo
36a70 72 74 65 64 20 73 69 7a 65 20 77 61 73 20 34 0a rted size was 4.
36a80 20 20 20 20 20 20 20 20 2a 2a 20 62 79 74 65 73 ** bytes
36a90 2c 20 74 68 65 6e 20 69 74 20 6d 61 79 20 61 63 , then it may ac
36aa0 74 75 61 6c 6c 79 20 62 65 20 73 6d 61 6c 6c 65 tually be smalle
36ab0 72 20 74 68 61 6e 20 74 68 69 73 20 0a 20 20 20 r than this .
36ac0 20 20 20 20 20 2a 2a 20 28 73 65 65 20 62 74 72 ** (see btr
36ad0 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 29 eeParseCellPtr()
36ae0 2c 20 34 20 62 79 74 65 73 20 69 73 20 74 68 65 , 4 bytes is the
36af0 20 6d 69 6e 69 6d 75 6d 20 73 69 7a 65 20 6f 66 minimum size of
36b00 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 79 20 . ** any
36b10 63 65 6c 6c 29 2e 20 42 75 74 20 69 74 20 69 73 cell). But it is
36b20 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f 20 70 61 important to pa
36b30 73 73 20 74 68 65 20 63 6f 72 72 65 63 74 20 73 ss the correct s
36b40 69 7a 65 20 74 6f 20 0a 20 20 20 20 20 20 20 20 ize to .
36b50 2a 2a 20 69 6e 73 65 72 74 43 65 6c 6c 28 29 2c ** insertCell(),
36b60 20 73 6f 20 72 65 70 61 72 73 65 20 74 68 65 20 so reparse the
36b70 63 65 6c 6c 20 6e 6f 77 2e 0a 20 20 20 20 20 20 cell now..
36b80 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 **. **
36b90 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 63 Note that this c
36ba0 61 6e 20 6e 65 76 65 72 20 68 61 70 70 65 6e 20 an never happen
36bb0 69 6e 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74 in an SQLite dat
36bc0 61 20 66 69 6c 65 2c 20 61 73 20 61 6c 6c 0a 20 a file, as all.
36bd0 20 20 20 20 20 20 20 2a 2a 20 63 65 6c 6c 73 20 ** cells
36be0 61 72 65 20 61 74 20 6c 65 61 73 74 20 34 20 62 are at least 4 b
36bf0 79 74 65 73 2e 20 49 74 20 6f 6e 6c 79 20 68 61 ytes. It only ha
36c00 70 70 65 6e 73 20 69 6e 20 62 2d 74 72 65 65 73 ppens in b-trees
36c10 20 75 73 65 64 0a 20 20 20 20 20 20 20 20 2a 2a used. **
36c20 20 74 6f 20 65 76 61 6c 75 61 74 65 20 22 49 4e to evaluate "IN
36c30 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 20 61 (SELECT ...)" a
36c40 6e 64 20 73 69 6d 69 6c 61 72 20 63 6c 61 75 73 nd similar claus
36c50 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 es.. */.
36c60 20 20 20 20 20 20 20 69 66 28 20 73 7a 43 65 6c if( szCel
36c70 6c 5b 6a 5d 3d 3d 34 20 29 7b 0a 20 20 20 20 20 l[j]==4 ){.
36c80 20 20 20 20 20 61 73 73 65 72 74 28 6c 65 61 66 assert(leaf
36c90 43 6f 72 72 65 63 74 69 6f 6e 3d 3d 34 29 3b 0a Correction==4);.
36ca0 20 20 20 20 20 20 20 20 20 20 73 7a 20 3d 20 63 sz = c
36cb0 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 72 65 ellSizePtr(pPare
36cc0 6e 74 2c 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 nt, pCell);.
36cd0 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
36ce0 20 20 20 20 69 4f 76 66 6c 53 70 61 63 65 20 2b iOvflSpace +
36cf0 3d 20 73 7a 3b 0a 20 20 20 20 20 20 61 73 73 65 = sz;. asse
36d00 72 74 28 20 73 7a 3c 3d 70 42 74 2d 3e 6d 61 78 rt( sz<=pBt->max
36d10 4c 6f 63 61 6c 2b 32 33 20 29 3b 0a 20 20 20 20 Local+23 );.
36d20 20 20 61 73 73 65 72 74 28 20 69 4f 76 66 6c 53 assert( iOvflS
36d30 70 61 63 65 20 3c 3d 20 28 69 6e 74 29 70 42 74 pace <= (int)pBt
36d40 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 20 20 ->pageSize );.
36d50 20 20 20 20 69 6e 73 65 72 74 43 65 6c 6c 28 70 insertCell(p
36d60 50 61 72 65 6e 74 2c 20 6e 78 44 69 76 2c 20 70 Parent, nxDiv, p
36d70 43 65 6c 6c 2c 20 73 7a 2c 20 70 54 65 6d 70 2c Cell, sz, pTemp,
36d80 20 70 4e 65 77 2d 3e 70 67 6e 6f 2c 20 26 72 63 pNew->pgno, &rc
36d90 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
36da0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 =SQLITE_OK ) got
36db0 6f 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 o balance_cleanu
36dc0 70 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 p;. assert(
36dd0 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
36de0 72 69 74 65 61 62 6c 65 28 70 50 61 72 65 6e 74 riteable(pParent
36df0 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 ->pDbPage) );..
36e00 20 20 20 20 20 6a 2b 2b 3b 0a 20 20 20 20 20 20 j++;.
36e10 6e 78 44 69 76 2b 2b 3b 0a 20 20 20 20 7d 0a 20 nxDiv++;. }.
36e20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6a 3d 3d }. assert( j==
36e30 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 nCell );. asser
36e40 74 28 20 6e 4f 6c 64 3e 30 20 29 3b 0a 20 20 61 t( nOld>0 );. a
36e50 73 73 65 72 74 28 20 6e 4e 65 77 3e 30 20 29 3b ssert( nNew>0 );
36e60 0a 20 20 69 66 28 20 28 70 61 67 65 46 6c 61 67 . if( (pageFlag
36e70 73 20 26 20 50 54 46 5f 4c 45 41 46 29 3d 3d 30 s & PTF_LEAF)==0
36e80 20 29 7b 0a 20 20 20 20 75 38 20 2a 7a 43 68 69 ){. u8 *zChi
36e90 6c 64 20 3d 20 26 61 70 43 6f 70 79 5b 6e 4f 6c ld = &apCopy[nOl
36ea0 64 2d 31 5d 2d 3e 61 44 61 74 61 5b 38 5d 3b 0a d-1]->aData[8];.
36eb0 20 20 20 20 6d 65 6d 63 70 79 28 26 61 70 4e 65 memcpy(&apNe
36ec0 77 5b 6e 4e 65 77 2d 31 5d 2d 3e 61 44 61 74 61 w[nNew-1]->aData
36ed0 5b 38 5d 2c 20 7a 43 68 69 6c 64 2c 20 34 29 3b [8], zChild, 4);
36ee0 0a 20 20 7d 0a 0a 20 20 69 66 28 20 69 73 52 6f . }.. if( isRo
36ef0 6f 74 20 26 26 20 70 50 61 72 65 6e 74 2d 3e 6e ot && pParent->n
36f00 43 65 6c 6c 3d 3d 30 20 26 26 20 70 50 61 72 65 Cell==0 && pPare
36f10 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 3c 3d 61 nt->hdrOffset<=a
36f20 70 4e 65 77 5b 30 5d 2d 3e 6e 46 72 65 65 20 29 pNew[0]->nFree )
36f30 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 6f 6f {. /* The roo
36f40 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 62 2d t page of the b-
36f50 74 72 65 65 20 6e 6f 77 20 63 6f 6e 74 61 69 6e tree now contain
36f60 73 20 6e 6f 20 63 65 6c 6c 73 2e 20 54 68 65 20 s no cells. The
36f70 6f 6e 6c 79 20 73 69 62 6c 69 6e 67 0a 20 20 20 only sibling.
36f80 20 2a 2a 20 70 61 67 65 20 69 73 20 74 68 65 20 ** page is the
36f90 72 69 67 68 74 2d 63 68 69 6c 64 20 6f 66 20 74 right-child of t
36fa0 68 65 20 70 61 72 65 6e 74 2e 20 43 6f 70 79 20 he parent. Copy
36fb0 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
36fc0 74 68 65 0a 20 20 20 20 2a 2a 20 63 68 69 6c 64 the. ** child
36fd0 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 70 page into the p
36fe0 61 72 65 6e 74 2c 20 64 65 63 72 65 61 73 69 6e arent, decreasin
36ff0 67 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 68 65 g the overall he
37000 69 67 68 74 20 6f 66 20 74 68 65 0a 20 20 20 20 ight of the.
37010 2a 2a 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 ** b-tree struct
37020 75 72 65 20 62 79 20 6f 6e 65 2e 20 54 68 69 73 ure by one. This
37030 20 69 73 20 64 65 73 63 72 69 62 65 64 20 61 73 is described as
37040 20 74 68 65 20 22 62 61 6c 61 6e 63 65 2d 73 68 the "balance-sh
37050 61 6c 6c 6f 77 65 72 22 0a 20 20 20 20 2a 2a 20 allower". **
37060 73 75 62 2d 61 6c 67 6f 72 69 74 68 6d 20 69 6e sub-algorithm in
37070 20 73 6f 6d 65 20 64 6f 63 75 6d 65 6e 74 61 74 some documentat
37080 69 6f 6e 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ion.. **.
37090 2a 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 6e ** If this is an
370a0 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61 74 auto-vacuum dat
370b0 61 62 61 73 65 2c 20 74 68 65 20 63 61 6c 6c 20 abase, the call
370c0 74 6f 20 63 6f 70 79 4e 6f 64 65 43 6f 6e 74 65 to copyNodeConte
370d0 6e 74 28 29 20 0a 20 20 20 20 2a 2a 20 73 65 74 nt() . ** set
370e0 73 20 61 6c 6c 20 70 6f 69 6e 74 65 72 2d 6d 61 s all pointer-ma
370f0 70 20 65 6e 74 72 69 65 73 20 63 6f 72 72 65 73 p entries corres
37100 70 6f 6e 64 69 6e 67 20 74 6f 20 64 61 74 61 62 ponding to datab
37110 61 73 65 20 69 6d 61 67 65 20 70 61 67 65 73 20 ase image pages
37120 0a 20 20 20 20 2a 2a 20 66 6f 72 20 77 68 69 63 . ** for whic
37130 68 20 74 68 65 20 70 6f 69 6e 74 65 72 20 69 73 h the pointer is
37140 20 73 74 6f 72 65 64 20 77 69 74 68 69 6e 20 74 stored within t
37150 68 65 20 63 6f 6e 74 65 6e 74 20 62 65 69 6e 67 he content being
37160 20 63 6f 70 69 65 64 2e 0a 20 20 20 20 2a 2a 0a copied.. **.
37170 20 20 20 20 2a 2a 20 54 68 65 20 73 65 63 6f 6e ** The secon
37180 64 20 61 73 73 65 72 74 20 62 65 6c 6f 77 20 76 d assert below v
37190 65 72 69 66 69 65 73 20 74 68 61 74 20 74 68 65 erifies that the
371a0 20 63 68 69 6c 64 20 70 61 67 65 20 69 73 20 64 child page is d
371b0 65 66 72 61 67 6d 65 6e 74 65 64 0a 20 20 20 20 efragmented.
371c0 2a 2a 20 28 69 74 20 6d 75 73 74 20 62 65 2c 20 ** (it must be,
371d0 61 73 20 69 74 20 77 61 73 20 6a 75 73 74 20 72 as it was just r
371e0 65 63 6f 6e 73 74 72 75 63 74 65 64 20 75 73 69 econstructed usi
371f0 6e 67 20 61 73 73 65 6d 62 6c 65 50 61 67 65 28 ng assemblePage(
37200 29 29 2e 20 54 68 69 73 0a 20 20 20 20 2a 2a 20 )). This. **
37210 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 69 66 20 is important if
37220 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 the parent page
37230 68 61 70 70 65 6e 73 20 74 6f 20 62 65 20 70 61 happens to be pa
37240 67 65 20 31 20 6f 66 20 74 68 65 20 64 61 74 61 ge 1 of the data
37250 62 61 73 65 0a 20 20 20 20 2a 2a 20 69 6d 61 67 base. ** imag
37260 65 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 e. */. asser
37270 74 28 20 6e 4e 65 77 3d 3d 31 20 29 3b 0a 20 20 t( nNew==1 );.
37280 20 20 61 73 73 65 72 74 28 20 61 70 4e 65 77 5b assert( apNew[
37290 30 5d 2d 3e 6e 46 72 65 65 20 3d 3d 20 0a 20 20 0]->nFree == .
372a0 20 20 20 20 20 20 28 67 65 74 32 62 79 74 65 28 (get2byte(
372b0 26 61 70 4e 65 77 5b 30 5d 2d 3e 61 44 61 74 61 &apNew[0]->aData
372c0 5b 35 5d 29 2d 61 70 4e 65 77 5b 30 5d 2d 3e 63 [5])-apNew[0]->c
372d0 65 6c 6c 4f 66 66 73 65 74 2d 61 70 4e 65 77 5b ellOffset-apNew[
372e0 30 5d 2d 3e 6e 43 65 6c 6c 2a 32 29 20 0a 20 20 0]->nCell*2) .
372f0 20 20 29 3b 0a 20 20 20 20 63 6f 70 79 4e 6f 64 );. copyNod
37300 65 43 6f 6e 74 65 6e 74 28 61 70 4e 65 77 5b 30 eContent(apNew[0
37310 5d 2c 20 70 50 61 72 65 6e 74 2c 20 26 72 63 29 ], pParent, &rc)
37320 3b 0a 20 20 20 20 66 72 65 65 50 61 67 65 28 61 ;. freePage(a
37330 70 4e 65 77 5b 30 5d 2c 20 26 72 63 29 3b 0a 20 pNew[0], &rc);.
37340 20 7d 65 6c 73 65 20 69 66 28 20 49 53 41 55 54 }else if( ISAUT
37350 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 2f OVACUUM ){. /
37360 2a 20 46 69 78 20 74 68 65 20 70 6f 69 6e 74 65 * Fix the pointe
37370 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f r-map entries fo
37380 72 20 61 6c 6c 20 74 68 65 20 63 65 6c 6c 73 20 r all the cells
37390 74 68 61 74 20 77 65 72 65 20 73 68 69 66 74 65 that were shifte
373a0 64 20 61 72 6f 75 6e 64 2e 20 0a 20 20 20 20 2a d around. . *
373b0 2a 20 54 68 65 72 65 20 61 72 65 20 73 65 76 65 * There are seve
373c0 72 61 6c 20 64 69 66 66 65 72 65 6e 74 20 74 79 ral different ty
373d0 70 65 73 20 6f 66 20 70 6f 69 6e 74 65 72 2d 6d pes of pointer-m
373e0 61 70 20 65 6e 74 72 69 65 73 20 74 68 61 74 20 ap entries that
373f0 6e 65 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 need to. ** b
37400 65 20 64 65 61 6c 74 20 77 69 74 68 20 62 79 20 e dealt with by
37410 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 53 6f this routine. So
37420 6d 65 20 6f 66 20 74 68 65 73 65 20 68 61 76 65 me of these have
37430 20 62 65 65 6e 20 73 65 74 20 61 6c 72 65 61 64 been set alread
37440 79 2c 20 62 75 74 0a 20 20 20 20 2a 2a 20 6d 61 y, but. ** ma
37450 6e 79 20 68 61 76 65 20 6e 6f 74 2e 20 54 68 65 ny have not. The
37460 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 following is a
37470 73 75 6d 6d 61 72 79 3a 0a 20 20 20 20 2a 2a 0a summary:. **.
37480 20 20 20 20 2a 2a 20 20 20 31 29 20 54 68 65 20 ** 1) The
37490 65 6e 74 72 69 65 73 20 61 73 73 6f 63 69 61 74 entries associat
374a0 65 64 20 77 69 74 68 20 6e 65 77 20 73 69 62 6c ed with new sibl
374b0 69 6e 67 20 70 61 67 65 73 20 74 68 61 74 20 77 ing pages that w
374c0 65 72 65 20 6e 6f 74 0a 20 20 20 20 2a 2a 20 20 ere not. **
374d0 20 20 20 20 73 69 62 6c 69 6e 67 73 20 77 68 65 siblings whe
374e0 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 n this function
374f0 77 61 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 73 was called. Thes
37500 65 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 e have already.
37510 20 20 20 2a 2a 20 20 20 20 20 20 62 65 65 6e 20 ** been
37520 73 65 74 2e 20 57 65 20 64 6f 6e 27 74 20 6e 65 set. We don't ne
37530 65 64 20 74 6f 20 77 6f 72 72 79 20 61 62 6f 75 ed to worry abou
37540 74 20 6f 6c 64 20 73 69 62 6c 69 6e 67 73 20 74 t old siblings t
37550 68 61 74 20 77 65 72 65 0a 20 20 20 20 2a 2a 20 hat were. **
37560 20 20 20 20 20 6d 6f 76 65 64 20 74 6f 20 74 68 moved to th
37570 65 20 66 72 65 65 2d 6c 69 73 74 20 2d 20 74 68 e free-list - th
37580 65 20 66 72 65 65 50 61 67 65 28 29 20 63 6f 64 e freePage() cod
37590 65 20 68 61 73 20 74 61 6b 65 6e 20 63 61 72 65 e has taken care
375a0 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 6f 66 20 . ** of
375b0 74 68 6f 73 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 those.. **.
375c0 20 20 2a 2a 20 20 20 32 29 20 54 68 65 20 70 6f ** 2) The po
375d0 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 inter-map entrie
375e0 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
375f0 68 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 72 h the first over
37600 66 6c 6f 77 0a 20 20 20 20 2a 2a 20 20 20 20 20 flow. **
37610 20 70 61 67 65 20 69 6e 20 61 6e 79 20 6f 76 65 page in any ove
37620 72 66 6c 6f 77 20 63 68 61 69 6e 73 20 75 73 65 rflow chains use
37630 64 20 62 79 20 6e 65 77 20 64 69 76 69 64 65 72 d by new divider
37640 20 63 65 6c 6c 73 2e 20 54 68 65 73 65 20 0a 20 cells. These .
37650 20 20 20 2a 2a 20 20 20 20 20 20 68 61 76 65 20 ** have
37660 61 6c 73 6f 20 61 6c 72 65 61 64 79 20 62 65 65 also already bee
37670 6e 20 74 61 6b 65 6e 20 63 61 72 65 20 6f 66 20 n taken care of
37680 62 79 20 74 68 65 20 69 6e 73 65 72 74 43 65 6c by the insertCel
37690 6c 28 29 20 63 6f 64 65 2e 0a 20 20 20 20 2a 2a l() code.. **
376a0 0a 20 20 20 20 2a 2a 20 20 20 33 29 20 49 66 20 . ** 3) If
376b0 74 68 65 20 73 69 62 6c 69 6e 67 20 70 61 67 65 the sibling page
376c0 73 20 61 72 65 20 6e 6f 74 20 6c 65 61 76 65 73 s are not leaves
376d0 2c 20 74 68 65 6e 20 74 68 65 20 63 68 69 6c 64 , then the child
376e0 20 70 61 67 65 73 20 6f 66 0a 20 20 20 20 2a 2a pages of. **
376f0 20 20 20 20 20 20 63 65 6c 6c 73 20 73 74 6f 72 cells stor
37700 65 64 20 6f 6e 20 74 68 65 20 73 69 62 6c 69 6e ed on the siblin
37710 67 20 70 61 67 65 73 20 6d 61 79 20 6e 65 65 64 g pages may need
37720 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 2e 0a to be updated..
37730 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 **. **
37740 34 29 20 49 66 20 74 68 65 20 73 69 62 6c 69 6e 4) If the siblin
37750 67 20 70 61 67 65 73 20 61 72 65 20 6e 6f 74 20 g pages are not
37760 69 6e 74 65 72 6e 61 6c 20 69 6e 74 6b 65 79 20 internal intkey
37770 6e 6f 64 65 73 2c 20 74 68 65 6e 20 61 6e 79 0a nodes, then any.
37780 20 20 20 20 2a 2a 20 20 20 20 20 20 6f 76 65 72 ** over
37790 66 6c 6f 77 20 70 61 67 65 73 20 75 73 65 64 20 flow pages used
377a0 62 79 20 74 68 65 73 65 20 63 65 6c 6c 73 20 6d by these cells m
377b0 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 75 70 ay need to be up
377c0 64 61 74 65 64 0a 20 20 20 20 2a 2a 20 20 20 20 dated. **
377d0 20 20 28 69 6e 74 65 72 6e 61 6c 20 69 6e 74 6b (internal intk
377e0 65 79 20 6e 6f 64 65 73 20 6e 65 76 65 72 20 63 ey nodes never c
377f0 6f 6e 74 61 69 6e 20 70 6f 69 6e 74 65 72 73 20 ontain pointers
37800 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 to overflow page
37810 73 29 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a s).. **. *
37820 2a 20 20 20 35 29 20 49 66 20 74 68 65 20 73 69 * 5) If the si
37830 62 6c 69 6e 67 20 70 61 67 65 73 20 61 72 65 20 bling pages are
37840 6e 6f 74 20 6c 65 61 76 65 73 2c 20 74 68 65 6e not leaves, then
37850 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 the pointer-map
37860 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 65 6e 74 . ** ent
37870 72 69 65 73 20 66 6f 72 20 74 68 65 20 72 69 67 ries for the rig
37880 68 74 2d 63 68 69 6c 64 20 70 61 67 65 73 20 6f ht-child pages o
37890 66 20 65 61 63 68 20 73 69 62 6c 69 6e 67 20 6d f each sibling m
378a0 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 20 ay need. **
378b0 20 20 20 20 74 6f 20 62 65 20 75 70 64 61 74 65 to be update
378c0 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a d.. **. **
378d0 20 43 61 73 65 73 20 31 20 61 6e 64 20 32 20 61 Cases 1 and 2 a
378e0 72 65 20 64 65 61 6c 74 20 77 69 74 68 20 61 62 re dealt with ab
378f0 6f 76 65 20 62 79 20 6f 74 68 65 72 20 63 6f 64 ove by other cod
37900 65 2e 20 54 68 65 20 6e 65 78 74 0a 20 20 20 20 e. The next.
37910 2a 2a 20 62 6c 6f 63 6b 20 64 65 61 6c 73 20 77 ** block deals w
37920 69 74 68 20 63 61 73 65 73 20 33 20 61 6e 64 20 ith cases 3 and
37930 34 20 61 6e 64 20 74 68 65 20 6f 6e 65 20 61 66 4 and the one af
37940 74 65 72 20 74 68 61 74 2c 20 63 61 73 65 20 35 ter that, case 5
37950 2e 20 53 69 6e 63 65 0a 20 20 20 20 2a 2a 20 73 . Since. ** s
37960 65 74 74 69 6e 67 20 61 20 70 6f 69 6e 74 65 72 etting a pointer
37970 20 6d 61 70 20 65 6e 74 72 79 20 69 73 20 61 20 map entry is a
37980 72 65 6c 61 74 69 76 65 6c 79 20 65 78 70 65 6e relatively expen
37990 73 69 76 65 20 6f 70 65 72 61 74 69 6f 6e 2c 20 sive operation,
379a0 74 68 69 73 0a 20 20 20 20 2a 2a 20 63 6f 64 65 this. ** code
379b0 20 6f 6e 6c 79 20 73 65 74 73 20 70 6f 69 6e 74 only sets point
379c0 65 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 er map entries f
379d0 6f 72 20 63 68 69 6c 64 20 6f 72 20 6f 76 65 72 or child or over
379e0 66 6c 6f 77 20 70 61 67 65 73 20 74 68 61 74 20 flow pages that
379f0 68 61 76 65 0a 20 20 20 20 2a 2a 20 61 63 74 75 have. ** actu
37a00 61 6c 6c 79 20 6d 6f 76 65 64 20 62 65 74 77 65 ally moved betwe
37a10 65 6e 20 70 61 67 65 73 2e 20 20 2a 2f 0a 20 20 en pages. */.
37a20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 20 MemPage *pNew
37a30 3d 20 61 70 4e 65 77 5b 30 5d 3b 0a 20 20 20 20 = apNew[0];.
37a40 4d 65 6d 50 61 67 65 20 2a 70 4f 6c 64 20 3d 20 MemPage *pOld =
37a50 61 70 43 6f 70 79 5b 30 5d 3b 0a 20 20 20 20 69 apCopy[0];. i
37a60 6e 74 20 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 70 nt nOverflow = p
37a70 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a Old->nOverflow;.
37a80 20 20 20 20 69 6e 74 20 69 4e 65 78 74 4f 6c 64 int iNextOld
37a90 20 3d 20 70 4f 6c 64 2d 3e 6e 43 65 6c 6c 20 2b = pOld->nCell +
37aa0 20 6e 4f 76 65 72 66 6c 6f 77 3b 0a 20 20 20 20 nOverflow;.
37ab0 69 6e 74 20 69 4f 76 65 72 66 6c 6f 77 20 3d 20 int iOverflow =
37ac0 28 6e 4f 76 65 72 66 6c 6f 77 20 3f 20 70 4f 6c (nOverflow ? pOl
37ad0 64 2d 3e 61 69 4f 76 66 6c 5b 30 5d 20 3a 20 2d d->aiOvfl[0] : -
37ae0 31 29 3b 0a 20 20 20 20 6a 20 3d 20 30 3b 20 20 1);. j = 0;
37af0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37b00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 /* Cu
37b10 72 72 65 6e 74 20 27 6f 6c 64 27 20 73 69 62 6c rrent 'old' sibl
37b20 69 6e 67 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 ing page */.
37b30 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 k = 0;
37b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37b50 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 27 6e /* Current 'n
37b60 65 77 27 20 73 69 62 6c 69 6e 67 20 70 61 67 65 ew' sibling page
37b70 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b */. for(i=0;
37b80 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a i<nCell; i++){.
37b90 20 20 20 20 20 20 69 6e 74 20 69 73 44 69 76 69 int isDivi
37ba0 64 65 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 77 der = 0;. w
37bb0 68 69 6c 65 28 20 69 3d 3d 69 4e 65 78 74 4f 6c hile( i==iNextOl
37bc0 64 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 d ){. /*
37bd0 43 65 6c 6c 20 69 20 69 73 20 74 68 65 20 63 65 Cell i is the ce
37be0 6c 6c 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 ll immediately f
37bf0 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 6c 61 73 ollowing the las
37c00 74 20 63 65 6c 6c 20 6f 6e 20 6f 6c 64 0a 20 20 t cell on old.
37c10 20 20 20 20 20 20 2a 2a 20 73 69 62 6c 69 6e 67 ** sibling
37c20 20 70 61 67 65 20 6a 2e 20 49 66 20 74 68 65 20 page j. If the
37c30 73 69 62 6c 69 6e 67 73 20 61 72 65 20 6e 6f 74 siblings are not
37c40 20 6c 65 61 66 20 70 61 67 65 73 20 6f 66 20 61 leaf pages of a
37c50 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 6e 74 n. ** int
37c60 6b 65 79 20 62 2d 74 72 65 65 2c 20 74 68 65 6e key b-tree, then
37c70 20 63 65 6c 6c 20 69 20 77 61 73 20 61 20 64 69 cell i was a di
37c80 76 69 64 65 72 20 63 65 6c 6c 2e 20 2a 2f 0a 20 vider cell. */.
37c90 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6a assert( j
37ca0 2b 31 20 3c 20 41 72 72 61 79 53 69 7a 65 28 61 +1 < ArraySize(a
37cb0 70 43 6f 70 79 29 20 29 3b 0a 20 20 20 20 20 20 pCopy) );.
37cc0 20 20 61 73 73 65 72 74 28 20 6a 2b 31 20 3c 20 assert( j+1 <
37cd0 6e 4f 6c 64 20 29 3b 0a 20 20 20 20 20 20 20 20 nOld );.
37ce0 70 4f 6c 64 20 3d 20 61 70 43 6f 70 79 5b 2b 2b pOld = apCopy[++
37cf0 6a 5d 3b 0a 20 20 20 20 20 20 20 20 69 4e 65 78 j];. iNex
37d00 74 4f 6c 64 20 3d 20 69 20 2b 20 21 6c 65 61 66 tOld = i + !leaf
37d10 44 61 74 61 20 2b 20 70 4f 6c 64 2d 3e 6e 43 65 Data + pOld->nCe
37d20 6c 6c 20 2b 20 70 4f 6c 64 2d 3e 6e 4f 76 65 72 ll + pOld->nOver
37d30 66 6c 6f 77 3b 0a 20 20 20 20 20 20 20 20 69 66 flow;. if
37d40 28 20 70 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f ( pOld->nOverflo
37d50 77 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e w ){. n
37d60 4f 76 65 72 66 6c 6f 77 20 3d 20 70 4f 6c 64 2d Overflow = pOld-
37d70 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a 20 20 20 20 >nOverflow;.
37d80 20 20 20 20 20 20 69 4f 76 65 72 66 6c 6f 77 20 iOverflow
37d90 3d 20 69 20 2b 20 21 6c 65 61 66 44 61 74 61 20 = i + !leafData
37da0 2b 20 70 4f 6c 64 2d 3e 61 69 4f 76 66 6c 5b 30 + pOld->aiOvfl[0
37db0 5d 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 ];. }.
37dc0 20 20 20 20 20 69 73 44 69 76 69 64 65 72 20 3d isDivider =
37dd0 20 21 6c 65 61 66 44 61 74 61 3b 20 20 0a 20 20 !leafData; .
37de0 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 61 73 73 }.. ass
37df0 65 72 74 28 6e 4f 76 65 72 66 6c 6f 77 3e 30 20 ert(nOverflow>0
37e00 7c 7c 20 69 4f 76 65 72 66 6c 6f 77 3c 69 20 29 || iOverflow<i )
37e10 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 6e ;. assert(n
37e20 4f 76 65 72 66 6c 6f 77 3c 32 20 7c 7c 20 70 4f Overflow<2 || pO
37e30 6c 64 2d 3e 61 69 4f 76 66 6c 5b 30 5d 3d 3d 70 ld->aiOvfl[0]==p
37e40 4f 6c 64 2d 3e 61 69 4f 76 66 6c 5b 31 5d 2d 31 Old->aiOvfl[1]-1
37e50 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
37e60 6e 4f 76 65 72 66 6c 6f 77 3c 33 20 7c 7c 20 70 nOverflow<3 || p
37e70 4f 6c 64 2d 3e 61 69 4f 76 66 6c 5b 31 5d 3d 3d Old->aiOvfl[1]==
37e80 70 4f 6c 64 2d 3e 61 69 4f 76 66 6c 5b 32 5d 2d pOld->aiOvfl[2]-
37e90 31 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 3d 1);. if( i=
37ea0 3d 69 4f 76 65 72 66 6c 6f 77 20 29 7b 0a 20 20 =iOverflow ){.
37eb0 20 20 20 20 20 20 69 73 44 69 76 69 64 65 72 20 isDivider
37ec0 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 69 66 28 = 1;. if(
37ed0 20 28 2d 2d 6e 4f 76 65 72 66 6c 6f 77 29 3e 30 (--nOverflow)>0
37ee0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 4f ){. iO
37ef0 76 65 72 66 6c 6f 77 2b 2b 3b 0a 20 20 20 20 20 verflow++;.
37f00 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 20 }. }..
37f10 20 20 20 20 69 66 28 20 69 3d 3d 63 6e 74 4e 65 if( i==cntNe
37f20 77 5b 6b 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 w[k] ){.
37f30 2f 2a 20 43 65 6c 6c 20 69 20 69 73 20 74 68 65 /* Cell i is the
37f40 20 63 65 6c 6c 20 69 6d 6d 65 64 69 61 74 65 6c cell immediatel
37f50 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 y following the
37f60 6c 61 73 74 20 63 65 6c 6c 20 6f 6e 20 6e 65 77 last cell on new
37f70 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 69 62 6c . ** sibl
37f80 69 6e 67 20 70 61 67 65 20 6b 2e 20 49 66 20 74 ing page k. If t
37f90 68 65 20 73 69 62 6c 69 6e 67 73 20 61 72 65 20 he siblings are
37fa0 6e 6f 74 20 6c 65 61 66 20 70 61 67 65 73 20 6f not leaf pages o
37fb0 66 20 61 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 f an. **
37fc0 69 6e 74 6b 65 79 20 62 2d 74 72 65 65 2c 20 74 intkey b-tree, t
37fd0 68 65 6e 20 63 65 6c 6c 20 69 20 69 73 20 61 20 hen cell i is a
37fe0 64 69 76 69 64 65 72 20 63 65 6c 6c 2e 20 20 2a divider cell. *
37ff0 2f 0a 20 20 20 20 20 20 20 20 70 4e 65 77 20 3d /. pNew =
38000 20 61 70 4e 65 77 5b 2b 2b 6b 5d 3b 0a 20 20 20 apNew[++k];.
38010 20 20 20 20 20 69 66 28 20 21 6c 65 61 66 44 61 if( !leafDa
38020 74 61 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 ta ) continue;.
38030 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 }. ass
38040 65 72 74 28 20 6a 3c 6e 4f 6c 64 20 29 3b 0a 20 ert( j<nOld );.
38050 20 20 20 20 20 61 73 73 65 72 74 28 20 6b 3c 6e assert( k<n
38060 4e 65 77 20 29 3b 0a 0a 20 20 20 20 20 20 2f 2a New );.. /*
38070 20 49 66 20 74 68 65 20 63 65 6c 6c 20 77 61 73 If the cell was
38080 20 6f 72 69 67 69 6e 61 6c 6c 79 20 64 69 76 69 originally divi
38090 64 65 72 20 63 65 6c 6c 20 28 61 6e 64 20 69 73 der cell (and is
380a0 20 6e 6f 74 20 6e 6f 77 29 20 6f 72 0a 20 20 20 not now) or.
380b0 20 20 20 2a 2a 20 61 6e 20 6f 76 65 72 66 6c 6f ** an overflo
380c0 77 20 63 65 6c 6c 2c 20 6f 72 20 69 66 20 74 68 w cell, or if th
380d0 65 20 63 65 6c 6c 20 77 61 73 20 6c 6f 63 61 74 e cell was locat
380e0 65 64 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e ed on a differen
380f0 74 20 73 69 62 6c 69 6e 67 0a 20 20 20 20 20 20 t sibling.
38100 2a 2a 20 70 61 67 65 20 62 65 66 6f 72 65 20 74 ** page before t
38110 68 65 20 62 61 6c 61 6e 63 69 6e 67 2c 20 74 68 he balancing, th
38120 65 6e 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d en the pointer m
38130 61 70 20 65 6e 74 72 69 65 73 20 61 73 73 6f 63 ap entries assoc
38140 69 61 74 65 64 0a 20 20 20 20 20 20 2a 2a 20 77 iated. ** w
38150 69 74 68 20 61 6e 79 20 63 68 69 6c 64 20 6f 72 ith any child or
38160 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 overflow pages
38170 6e 65 65 64 20 74 6f 20 62 65 20 75 70 64 61 74 need to be updat
38180 65 64 2e 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 ed. */. if
38190 28 20 69 73 44 69 76 69 64 65 72 20 7c 7c 20 70 ( isDivider || p
381a0 4f 6c 64 2d 3e 70 67 6e 6f 21 3d 70 4e 65 77 2d Old->pgno!=pNew-
381b0 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 20 20 20 20 >pgno ){.
381c0 20 69 66 28 20 21 6c 65 61 66 43 6f 72 72 65 63 if( !leafCorrec
381d0 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 tion ){.
381e0 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
381f0 20 67 65 74 34 62 79 74 65 28 61 70 43 65 6c 6c get4byte(apCell
38200 5b 69 5d 29 2c 20 50 54 52 4d 41 50 5f 42 54 52 [i]), PTRMAP_BTR
38210 45 45 2c 20 70 4e 65 77 2d 3e 70 67 6e 6f 2c 20 EE, pNew->pgno,
38220 26 72 63 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a &rc);. }.
38230 20 20 20 20 20 20 20 20 69 66 28 20 73 7a 43 65 if( szCe
38240 6c 6c 5b 69 5d 3e 70 4e 65 77 2d 3e 6d 69 6e 4c ll[i]>pNew->minL
38250 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 ocal ){.
38260 20 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 ptrmapPutOvflP
38270 74 72 28 70 4e 65 77 2c 20 61 70 43 65 6c 6c 5b tr(pNew, apCell[
38280 69 5d 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 i], &rc);.
38290 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
382a0 7d 0a 0a 20 20 20 20 69 66 28 20 21 6c 65 61 66 }.. if( !leaf
382b0 43 6f 72 72 65 63 74 69 6f 6e 20 29 7b 0a 20 20 Correction ){.
382c0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e for(i=0; i<n
382d0 4e 65 77 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 New; i++){.
382e0 20 20 20 75 33 32 20 6b 65 79 20 3d 20 67 65 74 u32 key = get
382f0 34 62 79 74 65 28 26 61 70 4e 65 77 5b 69 5d 2d 4byte(&apNew[i]-
38300 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 20 20 20 >aData[8]);.
38310 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 ptrmapPut(pB
38320 74 2c 20 6b 65 79 2c 20 50 54 52 4d 41 50 5f 42 t, key, PTRMAP_B
38330 54 52 45 45 2c 20 61 70 4e 65 77 5b 69 5d 2d 3e TREE, apNew[i]->
38340 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 pgno, &rc);.
38350 20 20 7d 0a 20 20 20 20 7d 0a 0a 23 69 66 20 30 }. }..#if 0
38360 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 74 72 6d . /* The ptrm
38370 61 70 43 68 65 63 6b 50 61 67 65 73 28 29 20 63 apCheckPages() c
38380 6f 6e 74 61 69 6e 73 20 61 73 73 65 72 74 28 29 ontains assert()
38390 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 statements that
383a0 20 76 65 72 69 66 79 20 74 68 61 74 0a 20 20 20 verify that.
383b0 20 2a 2a 20 61 6c 6c 20 70 6f 69 6e 74 65 72 20 ** all pointer
383c0 6d 61 70 20 70 61 67 65 73 20 61 72 65 20 73 65 map pages are se
383d0 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 54 68 69 t correctly. Thi
383e0 73 20 69 73 20 68 65 6c 70 66 75 6c 20 77 68 69 s is helpful whi
383f0 6c 65 20 0a 20 20 20 20 2a 2a 20 64 65 62 75 67 le . ** debug
38400 67 69 6e 67 2e 20 54 68 69 73 20 69 73 20 75 73 ging. This is us
38410 75 61 6c 6c 79 20 64 69 73 61 62 6c 65 64 20 62 ually disabled b
38420 65 63 61 75 73 65 20 61 20 63 6f 72 72 75 70 74 ecause a corrupt
38430 20 64 61 74 61 62 61 73 65 20 6d 61 79 0a 20 20 database may.
38440 20 20 2a 2a 20 63 61 75 73 65 20 61 6e 20 61 73 ** cause an as
38450 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
38460 20 74 6f 20 66 61 69 6c 2e 20 20 2a 2f 0a 20 20 to fail. */.
38470 20 20 70 74 72 6d 61 70 43 68 65 63 6b 50 61 67 ptrmapCheckPag
38480 65 73 28 61 70 4e 65 77 2c 20 6e 4e 65 77 29 3b es(apNew, nNew);
38490 0a 20 20 20 20 70 74 72 6d 61 70 43 68 65 63 6b . ptrmapCheck
384a0 50 61 67 65 73 28 26 70 50 61 72 65 6e 74 2c 20 Pages(&pParent,
384b0 31 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 1);.#endi