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 6e 20 65 78 74 mplements an ext
0190: 65 72 6e 61 6c 20 28 64 69 73 6b 2d 62 61 73 65 ernal (disk-base
01a0: 64 29 20 64 61 74 61 62 61 73 65 20 75 73 69 6e d) database usin
01b0: 67 20 42 54 72 65 65 73 2e 0a 2a 2a 20 53 65 65 g BTrees..** See
01c0: 20 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d 6d the header comm
01d0: 65 6e 74 20 6f 6e 20 22 62 74 72 65 65 49 6e 74 ent on "btreeInt
01e0: 2e 68 22 20 66 6f 72 20 61 64 64 69 74 69 6f 6e .h" for addition
01f0: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a al information..
0200: 2a 2a 20 49 6e 63 6c 75 64 69 6e 67 20 61 20 64 ** Including a d
0210: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 66 69 escription of fi
0220: 6c 65 20 66 6f 72 6d 61 74 20 61 6e 64 20 61 6e le format and an
0230: 20 6f 76 65 72 76 69 65 77 20 6f 66 20 6f 70 65 overview of ope
0240: 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 6e 63 6c ration..*/.#incl
0250: 75 64 65 20 22 62 74 72 65 65 49 6e 74 2e 68 22 ude "btreeInt.h"
0260: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 ../*.** The head
0270: 65 72 20 73 74 72 69 6e 67 20 74 68 61 74 20 61 er string that a
0280: 70 70 65 61 72 73 20 61 74 20 74 68 65 20 62 65 ppears at the be
0290: 67 69 6e 6e 69 6e 67 20 6f 66 20 65 76 65 72 79 ginning of every
02a0: 0a 2a 2a 20 53 51 4c 69 74 65 20 64 61 74 61 62 .** SQLite datab
02b0: 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 ase..*/.static c
02c0: 6f 6e 73 74 20 63 68 61 72 20 7a 4d 61 67 69 63 onst char zMagic
02d0: 48 65 61 64 65 72 5b 5d 20 3d 20 53 51 4c 49 54 Header[] = SQLIT
02e0: 45 5f 46 49 4c 45 5f 48 45 41 44 45 52 3b 0a 0a E_FILE_HEADER;..
02f0: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 69 73 20 67 /*.** Set this g
0300: 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 74 lobal variable t
0310: 6f 20 31 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 o 1 to enable tr
0320: 61 63 69 6e 67 20 75 73 69 6e 67 20 74 68 65 20 acing using the
0330: 54 52 41 43 45 0a 2a 2a 20 6d 61 63 72 6f 2e 0a TRACE.** macro..
0340: 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 71 6c */.#if 0.int sql
0350: 69 74 65 33 42 74 72 65 65 54 72 61 63 65 3d 31 ite3BtreeTrace=1
0360: 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e ; /* True to en
0370: 61 62 6c 65 20 74 72 61 63 69 6e 67 20 2a 2f 0a able tracing */.
0380: 23 20 64 65 66 69 6e 65 20 54 52 41 43 45 28 58 # define TRACE(X
0390: 29 20 20 69 66 28 73 71 6c 69 74 65 33 42 74 72 ) if(sqlite3Btr
03a0: 65 65 54 72 61 63 65 29 7b 70 72 69 6e 74 66 20 eeTrace){printf
03b0: 58 3b 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 X;fflush(stdout)
03c0: 3b 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e ;}.#else.# defin
03d0: 65 20 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 e TRACE(X).#endi
03e0: 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 f../*.** Extract
03f0: 20 61 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e a 2-byte big-en
0400: 64 69 61 6e 20 69 6e 74 65 67 65 72 20 66 72 6f dian integer fro
0410: 6d 20 61 6e 20 61 72 72 61 79 20 6f 66 20 75 6e m an array of un
0420: 73 69 67 6e 65 64 20 62 79 74 65 73 2e 0a 2a 2a signed bytes..**
0430: 20 42 75 74 20 69 66 20 74 68 65 20 76 61 6c 75 But if the valu
0440: 65 20 69 73 20 7a 65 72 6f 2c 20 6d 61 6b 65 20 e is zero, make
0450: 69 74 20 36 35 35 33 36 2e 0a 2a 2a 0a 2a 2a 20 it 65536..**.**
0460: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
0470: 75 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 used to extract
0480: 74 68 65 20 22 6f 66 66 73 65 74 20 74 6f 20 63 the "offset to c
0490: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
04a0: 22 20 76 61 6c 75 65 0a 2a 2a 20 66 72 6f 6d 20 " value.** from
04b0: 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 the header of a
04c0: 62 74 72 65 65 20 70 61 67 65 2e 20 20 49 66 20 btree page. If
04d0: 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 the page size is
04e0: 20 36 35 35 33 36 20 61 6e 64 20 74 68 65 20 70 65536 and the p
04f0: 61 67 65 0a 2a 2a 20 69 73 20 65 6d 70 74 79 2c age.** is empty,
0500: 20 74 68 65 20 6f 66 66 73 65 74 20 73 68 6f 75 the offset shou
0510: 6c 64 20 62 65 20 36 35 35 33 36 2c 20 62 75 74 ld be 65536, but
0520: 20 74 68 65 20 32 2d 62 79 74 65 20 76 61 6c 75 the 2-byte valu
0530: 65 20 73 74 6f 72 65 73 20 7a 65 72 6f 2e 0a 2a e stores zero..*
0540: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d * This routine m
0550: 61 6b 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 akes the necessa
0560: 72 79 20 61 64 6a 75 73 74 6d 65 6e 74 20 74 6f ry adjustment to
0570: 20 36 35 35 33 36 2e 0a 2a 2f 0a 23 64 65 66 69 65536..*/.#defi
0580: 6e 65 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 ne get2byteNotZe
0590: 72 6f 28 58 29 20 20 28 28 28 28 28 69 6e 74 29 ro(X) (((((int)
05a0: 67 65 74 32 62 79 74 65 28 58 29 29 2d 31 29 26 get2byte(X))-1)&
05b0: 30 78 66 66 66 66 29 2b 31 29 0a 0a 2f 2a 0a 2a 0xffff)+1)../*.*
05c0: 2a 20 56 61 6c 75 65 73 20 70 61 73 73 65 64 20 * Values passed
05d0: 61 73 20 74 68 65 20 35 74 68 20 61 72 67 75 6d as the 5th argum
05e0: 65 6e 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 42 ent to allocateB
05f0: 74 72 65 65 50 61 67 65 28 29 0a 2a 2f 0a 23 64 treePage().*/.#d
0600: 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f 41 4e efine BTALLOC_AN
0610: 59 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 Y 0
0620: 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 79 20 /* Allocate any
0630: 70 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 page */.#define
0640: 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 31 20 BTALLOC_EXACT 1
0650: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c /* All
0660: 6f 63 61 74 65 20 65 78 61 63 74 20 70 61 67 65 ocate exact page
0670: 20 69 66 20 70 6f 73 73 69 62 6c 65 20 2a 2f 0a if possible */.
0680: 23 64 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f #define BTALLOC_
0690: 4c 45 20 20 20 20 32 20 20 20 20 20 20 20 20 20 LE 2
06a0: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e /* Allocate an
06b0: 79 20 70 61 67 65 20 3c 3d 20 74 68 65 20 70 61 y page <= the pa
06c0: 72 61 6d 65 74 65 72 20 2a 2f 0a 0a 2f 2a 0a 2a rameter */../*.*
06d0: 2a 20 4d 61 63 72 6f 20 49 66 4e 6f 74 4f 6d 69 * Macro IfNotOmi
06e0: 74 41 56 28 78 29 20 72 65 74 75 72 6e 73 20 28 tAV(x) returns (
06f0: 78 29 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 x) if SQLITE_OMI
0700: 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 T_AUTOVACUUM is
0710: 6e 6f 74 20 0a 2a 2a 20 64 65 66 69 6e 65 64 2c not .** defined,
0720: 20 6f 72 20 30 20 69 66 20 69 74 20 69 73 2e 20 or 0 if it is.
0730: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a For example:.**.
0740: 2a 2a 20 20 20 62 49 6e 63 72 56 61 63 75 75 6d ** bIncrVacuum
0750: 20 3d 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 = IfNotOmitAV(p
0760: 42 74 53 68 61 72 65 64 2d 3e 69 6e 63 72 56 61 BtShared->incrVa
0770: 63 75 75 6d 29 3b 0a 2a 2f 0a 23 69 66 6e 64 65 cuum);.*/.#ifnde
0780: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
0790: 54 4f 56 41 43 55 55 4d 0a 23 64 65 66 69 6e 65 TOVACUUM.#define
07a0: 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 65 78 70 IfNotOmitAV(exp
07b0: 72 29 20 28 65 78 70 72 29 0a 23 65 6c 73 65 0a r) (expr).#else.
07c0: 23 64 65 66 69 6e 65 20 49 66 4e 6f 74 4f 6d 69 #define IfNotOmi
07d0: 74 41 56 28 65 78 70 72 29 20 30 0a 23 65 6e 64 tAV(expr) 0.#end
07e0: 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 if..#ifndef SQLI
07f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0800: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 ACHE./*.** A lis
0810: 74 20 6f 66 20 42 74 53 68 61 72 65 64 20 6f 62 t of BtShared ob
0820: 6a 65 63 74 73 20 74 68 61 74 20 61 72 65 20 65 jects that are e
0830: 6c 69 67 69 62 6c 65 20 66 6f 72 20 70 61 72 74 ligible for part
0840: 69 63 69 70 61 74 69 6f 6e 0a 2a 2a 20 69 6e 20 icipation.** in
0850: 73 68 61 72 65 64 20 63 61 63 68 65 2e 20 20 54 shared cache. T
0860: 68 69 73 20 76 61 72 69 61 62 6c 65 20 68 61 73 his variable has
0870: 20 66 69 6c 65 20 73 63 6f 70 65 20 64 75 72 69 file scope duri
0880: 6e 67 20 6e 6f 72 6d 61 6c 20 62 75 69 6c 64 73 ng normal builds
0890: 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 65 73 ,.** but the tes
08a0: 74 20 68 61 72 6e 65 73 73 20 6e 65 65 64 73 20 t harness needs
08b0: 74 6f 20 61 63 63 65 73 73 20 69 74 20 73 6f 20 to access it so
08c0: 77 65 20 6d 61 6b 65 20 69 74 20 67 6c 6f 62 61 we make it globa
08d0: 6c 20 66 6f 72 20 0a 2a 2a 20 74 65 73 74 20 62 l for .** test b
08e0: 75 69 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 41 63 63 uilds..**.** Acc
08f0: 65 73 73 20 74 6f 20 74 68 69 73 20 76 61 72 69 ess to this vari
0900: 61 62 6c 65 20 69 73 20 70 72 6f 74 65 63 74 65 able is protecte
0910: 64 20 62 79 20 53 51 4c 49 54 45 5f 4d 55 54 45 d by SQLITE_MUTE
0920: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 2e X_STATIC_MASTER.
0930: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
0940: 45 5f 54 45 53 54 0a 42 74 53 68 61 72 65 64 20 E_TEST.BtShared
0950: 2a 53 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 *SQLITE_WSD sqli
0960: 74 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 te3SharedCacheLi
0970: 73 74 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 73 74 st = 0;.#else.st
0980: 61 74 69 63 20 42 74 53 68 61 72 65 64 20 2a 53 atic BtShared *S
0990: 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 74 65 QLITE_WSD sqlite
09a0: 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 3SharedCacheList
09b0: 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 23 65 6e = 0;.#endif.#en
09c0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
09d0: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 IT_SHARED_CACHE
09e0: 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */..#ifndef SQLI
09f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0a00: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c ACHE./*.** Enabl
0a10: 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 65 e or disable the
0a20: 20 73 68 61 72 65 64 20 70 61 67 65 72 20 61 6e shared pager an
0a30: 64 20 73 63 68 65 6d 61 20 66 65 61 74 75 72 65 d schema feature
0a40: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f s..**.** This ro
0a50: 75 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 utine has no eff
0a60: 65 63 74 20 6f 6e 20 65 78 69 73 74 69 6e 67 20 ect on existing
0a70: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
0a80: 69 6f 6e 73 2e 0a 2a 2a 20 54 68 65 20 73 68 61 ions..** The sha
0a90: 72 65 64 20 63 61 63 68 65 20 73 65 74 74 69 6e red cache settin
0aa0: 67 20 65 66 66 65 63 74 73 20 6f 6e 6c 79 20 66 g effects only f
0ab0: 75 74 75 72 65 20 63 61 6c 6c 73 20 74 6f 0a 2a uture calls to.*
0ac0: 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 * sqlite3_open()
0ad0: 2c 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 , sqlite3_open16
0ae0: 28 29 2c 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f (), or sqlite3_o
0af0: 70 65 6e 5f 76 32 28 29 2e 0a 2a 2f 0a 69 6e 74 pen_v2()..*/.int
0b00: 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f sqlite3_enable_
0b10: 73 68 61 72 65 64 5f 63 61 63 68 65 28 69 6e 74 shared_cache(int
0b20: 20 65 6e 61 62 6c 65 29 7b 0a 23 69 66 20 64 65 enable){.#if de
0b30: 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
0b40: 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c && !defined(SQL
0b50: 49 54 45 5f 54 45 53 54 29 20 26 26 20 21 64 65 ITE_TEST) && !de
0b60: 66 69 6e 65 64 28 54 48 33 5f 43 4f 4d 50 41 54 fined(TH3_COMPAT
0b70: 49 42 49 4c 49 54 59 29 0a 20 20 2f 2a 20 45 6e IBILITY). /* En
0b80: 61 62 6c 65 20 67 6c 6f 62 61 6c 20 73 68 61 72 able global shar
0b90: 65 64 20 63 61 63 68 65 20 66 75 6e 63 74 69 6f ed cache functio
0ba0: 6e 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20 n for debugging
0bb0: 61 6e 64 20 75 6e 69 74 20 74 65 73 74 73 2c 20 and unit tests,
0bc0: 0a 20 20 2a 2a 20 62 75 74 20 6e 6f 74 20 66 6f . ** but not fo
0bd0: 72 20 72 65 6c 65 61 73 65 20 2a 2f 0a 20 20 72 r release */. r
0be0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
0bf0: 55 53 45 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c USE;.#else. sql
0c00: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
0c10: 2e 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 .sharedCacheEnab
0c20: 6c 65 64 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 led = enable;.
0c30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
0c40: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 23 65 6e 64 69 ;.#endif.}.#endi
0c50: 66 0a 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 f....#ifdef SQLI
0c60: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0c70: 41 43 48 45 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 ACHE. /*. ** T
0c80: 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 71 75 65 he functions que
0c90: 72 79 53 68 61 72 65 64 43 61 63 68 65 54 61 62 rySharedCacheTab
0ca0: 6c 65 4c 6f 63 6b 28 29 2c 20 73 65 74 53 68 61 leLock(), setSha
0cb0: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
0cc0: 6b 28 29 2c 0a 20 20 2a 2a 20 61 6e 64 20 63 6c k(),. ** and cl
0cd0: 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 earAllSharedCach
0ce0: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 29 0a 20 20 eTableLocks().
0cf0: 2a 2a 20 6d 61 6e 69 70 75 6c 61 74 65 20 65 6e ** manipulate en
0d00: 74 72 69 65 73 20 69 6e 20 74 68 65 20 42 74 53 tries in the BtS
0d10: 68 61 72 65 64 2e 70 4c 6f 63 6b 20 6c 69 6e 6b hared.pLock link
0d20: 65 64 20 6c 69 73 74 20 75 73 65 64 20 74 6f 20 ed list used to
0d30: 73 74 6f 72 65 0a 20 20 2a 2a 20 73 68 61 72 65 store. ** share
0d40: 64 2d 63 61 63 68 65 20 74 61 62 6c 65 20 6c 65 d-cache table le
0d50: 76 65 6c 20 6c 6f 63 6b 73 2e 20 49 66 20 74 68 vel locks. If th
0d60: 65 20 6c 69 62 72 61 72 79 20 69 73 20 63 6f 6d e library is com
0d70: 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 0a 20 piled with the.
0d80: 20 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 ** shared-cache
0d90: 20 66 65 61 74 75 72 65 20 64 69 73 61 62 6c 65 feature disable
0da0: 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 d, then there is
0db0: 20 6f 6e 6c 79 20 65 76 65 72 20 6f 6e 65 20 75 only ever one u
0dc0: 73 65 72 0a 20 20 2a 2a 20 6f 66 20 65 61 63 68 ser. ** of each
0dd0: 20 42 74 53 68 61 72 65 64 20 73 74 72 75 63 74 BtShared struct
0de0: 75 72 65 20 61 6e 64 20 73 6f 20 74 68 69 73 20 ure and so this
0df0: 6c 6f 63 6b 69 6e 67 20 69 73 20 6e 6f 74 20 6e locking is not n
0e00: 65 63 65 73 73 61 72 79 2e 20 0a 20 20 2a 2a 20 ecessary. . **
0e10: 53 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6c 6f So define the lo
0e20: 63 6b 20 72 65 6c 61 74 65 64 20 66 75 6e 63 74 ck related funct
0e30: 69 6f 6e 73 20 61 73 20 6e 6f 2d 6f 70 73 2e 0a ions as no-ops..
0e40: 20 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 71 */. #define q
0e50: 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 54 uerySharedCacheT
0e60: 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 29 20 ableLock(a,b,c)
0e70: 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 SQLITE_OK. #def
0e80: 69 6e 65 20 73 65 74 53 68 61 72 65 64 43 61 63 ine setSharedCac
0e90: 68 65 54 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c heTableLock(a,b,
0ea0: 63 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 c) SQLITE_OK. #
0eb0: 64 65 66 69 6e 65 20 63 6c 65 61 72 41 6c 6c 53 define clearAllS
0ec0: 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
0ed0: 6f 63 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e ocks(a). #defin
0ee0: 65 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 e downgradeAllSh
0ef0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0f00: 63 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e 65 cks(a). #define
0f10: 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 hasSharedCacheT
0f20: 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 2c 64 ableLock(a,b,c,d
0f30: 29 20 31 0a 20 20 23 64 65 66 69 6e 65 20 68 61 ) 1. #define ha
0f40: 73 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 61 sReadConflicts(a
0f50: 2c 20 62 29 20 30 0a 23 65 6e 64 69 66 0a 0a 23 , b) 0.#endif..#
0f60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
0f70: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
0f80: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
0f90: 45 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 EBUG./*.**** Thi
0fa0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e s function is on
0fb0: 6c 79 20 75 73 65 64 20 61 73 20 70 61 72 74 20 ly used as part
0fc0: 6f 66 20 61 6e 20 61 73 73 65 72 74 28 29 20 73 of an assert() s
0fd0: 74 61 74 65 6d 65 6e 74 2e 20 2a 2a 2a 0a 2a 2a tatement. ***.**
0fe0: 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 .** Check to see
0ff0: 20 69 66 20 70 42 74 72 65 65 20 68 6f 6c 64 73 if pBtree holds
1000: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6c 6f the required lo
1010: 63 6b 73 20 74 6f 20 72 65 61 64 20 6f 72 20 77 cks to read or w
1020: 72 69 74 65 20 74 6f 20 74 68 65 20 0a 2a 2a 20 rite to the .**
1030: 74 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 20 table with root
1040: 70 61 67 65 20 69 52 6f 6f 74 2e 20 20 20 52 65 page iRoot. Re
1050: 74 75 72 6e 20 31 20 69 66 20 69 74 20 64 6f 65 turn 1 if it doe
1060: 73 20 61 6e 64 20 30 20 69 66 20 6e 6f 74 2e 0a s and 0 if not..
1070: 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c **.** For exampl
1080: 65 2c 20 77 68 65 6e 20 77 72 69 74 69 6e 67 20 e, when writing
1090: 74 6f 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 to a table with
10a0: 72 6f 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 20 root-page iRoot
10b0: 76 69 61 20 0a 2a 2a 20 42 74 72 65 65 20 63 6f via .** Btree co
10c0: 6e 6e 65 63 74 69 6f 6e 20 70 42 74 72 65 65 3a nnection pBtree:
10d0: 0a 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 .**.** assert
10e0: 28 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 ( hasSharedCache
10f0: 54 61 62 6c 65 4c 6f 63 6b 28 70 42 74 72 65 65 TableLock(pBtree
1100: 2c 20 69 52 6f 6f 74 2c 20 30 2c 20 57 52 49 54 , iRoot, 0, WRIT
1110: 45 5f 4c 4f 43 4b 29 20 29 3b 0a 2a 2a 0a 2a 2a E_LOCK) );.**.**
1120: 20 57 68 65 6e 20 77 72 69 74 69 6e 67 20 74 6f When writing to
1130: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 20 72 an index that r
1140: 65 73 69 64 65 73 20 69 6e 20 61 20 73 68 61 72 esides in a shar
1150: 61 62 6c 65 20 64 61 74 61 62 61 73 65 2c 20 74 able database, t
1160: 68 65 20 0a 2a 2a 20 63 61 6c 6c 65 72 20 73 68 he .** caller sh
1170: 6f 75 6c 64 20 68 61 76 65 20 66 69 72 73 74 20 ould have first
1180: 6f 62 74 61 69 6e 65 64 20 61 20 6c 6f 63 6b 20 obtained a lock
1190: 73 70 65 63 69 66 79 69 6e 67 20 74 68 65 20 72 specifying the r
11a0: 6f 6f 74 20 70 61 67 65 20 6f 66 0a 2a 2a 20 74 oot page of.** t
11b0: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
11c0: 20 74 61 62 6c 65 2e 20 54 68 69 73 20 6d 61 6b table. This mak
11d0: 65 73 20 74 68 69 6e 67 73 20 61 20 62 69 74 20 es things a bit
11e0: 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 more complicated
11f0: 2c 0a 2a 2a 20 61 73 20 74 68 69 73 20 6d 6f 64 ,.** as this mod
1200: 75 6c 65 20 74 72 65 61 74 73 20 65 61 63 68 20 ule treats each
1210: 74 61 62 6c 65 20 61 73 20 61 20 73 65 70 61 72 table as a separ
1220: 61 74 65 20 73 74 72 75 63 74 75 72 65 2e 20 54 ate structure. T
1230: 6f 20 64 65 74 65 72 6d 69 6e 65 0a 2a 2a 20 74 o determine.** t
1240: 68 65 20 74 61 62 6c 65 20 63 6f 72 72 65 73 70 he table corresp
1250: 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 69 6e onding to the in
1260: 64 65 78 20 62 65 69 6e 67 20 77 72 69 74 74 65 dex being writte
1270: 6e 2c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 n, this.** funct
1280: 69 6f 6e 20 68 61 73 20 74 6f 20 73 65 61 72 63 ion has to searc
1290: 68 20 74 68 72 6f 75 67 68 20 74 68 65 20 64 61 h through the da
12a0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a tabase schema..*
12b0: 2a 0a 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 *.** Instead of
12c0: 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 74 61 a lock on the ta
12d0: 62 6c 65 2f 69 6e 64 65 78 20 72 6f 6f 74 65 64 ble/index rooted
12e0: 20 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 at page iRoot,
12f0: 74 68 65 20 63 61 6c 6c 65 72 20 6d 61 79 0a 2a the caller may.*
1300: 2a 20 68 6f 6c 64 20 61 20 77 72 69 74 65 2d 6c * hold a write-l
1310: 6f 63 6b 20 6f 6e 20 74 68 65 20 73 63 68 65 6d ock on the schem
1320: 61 20 74 61 62 6c 65 20 28 72 6f 6f 74 20 70 61 a table (root pa
1330: 67 65 20 31 29 2e 20 54 68 69 73 20 69 73 20 61 ge 1). This is a
1340: 6c 73 6f 0a 2a 2a 20 61 63 63 65 70 74 61 62 6c lso.** acceptabl
1350: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
1360: 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 hasSharedCacheT
1370: 61 62 6c 65 4c 6f 63 6b 28 0a 20 20 42 74 72 65 ableLock(. Btre
1380: 65 20 2a 70 42 74 72 65 65 2c 20 20 20 20 20 20 e *pBtree,
1390: 20 20 20 2f 2a 20 48 61 6e 64 6c 65 20 74 68 61 /* Handle tha
13a0: 74 20 6d 75 73 74 20 68 6f 6c 64 20 6c 6f 63 6b t must hold lock
13b0: 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 */. Pgno iRoot
13c0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
13d0: 52 6f 6f 74 20 70 61 67 65 20 6f 66 20 62 2d 74 Root page of b-t
13e0: 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 ree */. int isI
13f0: 6e 64 65 78 2c 20 20 20 20 20 20 20 20 20 20 20 ndex,
1400: 2f 2a 20 54 72 75 65 20 69 66 20 69 52 6f 6f 74 /* True if iRoot
1410: 20 69 73 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 is the root of
1420: 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 an index b-tree
1430: 2a 2f 0a 20 20 69 6e 74 20 65 4c 6f 63 6b 54 79 */. int eLockTy
1440: 70 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 pe /* R
1450: 65 71 75 69 72 65 64 20 6c 6f 63 6b 20 74 79 70 equired lock typ
1460: 65 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 e (READ_LOCK or
1470: 57 52 49 54 45 5f 4c 4f 43 4b 29 20 2a 2f 0a 29 WRITE_LOCK) */.)
1480: 7b 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 {. Schema *pSch
1490: 65 6d 61 20 3d 20 28 53 63 68 65 6d 61 20 2a 29 ema = (Schema *)
14a0: 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 53 63 pBtree->pBt->pSc
14b0: 68 65 6d 61 3b 0a 20 20 50 67 6e 6f 20 69 54 61 hema;. Pgno iTa
14c0: 62 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 b = 0;. BtLock
14d0: 2a 70 4c 6f 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66 *pLock;.. /* If
14e0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 this database i
14f0: 73 20 6e 6f 74 20 73 68 61 72 65 61 62 6c 65 2c s not shareable,
1500: 20 6f 72 20 69 66 20 74 68 65 20 63 6c 69 65 6e or if the clien
1510: 74 20 69 73 20 72 65 61 64 69 6e 67 0a 20 20 2a t is reading. *
1520: 2a 20 61 6e 64 20 68 61 73 20 74 68 65 20 72 65 * and has the re
1530: 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 ad-uncommitted f
1540: 6c 61 67 20 73 65 74 2c 20 74 68 65 6e 20 6e 6f lag set, then no
1550: 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 69 72 65 lock is require
1560: 64 2e 20 0a 20 20 2a 2a 20 52 65 74 75 72 6e 20 d. . ** Return
1570: 74 72 75 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 true immediately
1580: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 70 42 .. */. if( (pB
1590: 74 72 65 65 2d 3e 73 68 61 72 61 62 6c 65 3d 3d tree->sharable==
15a0: 30 29 0a 20 20 20 7c 7c 20 28 65 4c 6f 63 6b 54 0). || (eLockT
15b0: 79 70 65 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 26 ype==READ_LOCK &
15c0: 26 20 28 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 & (pBtree->db->f
15d0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 lags & SQLITE_Re
15e0: 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 29 0a adUncommitted)).
15f0: 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1600: 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 1;. }.. /* If
1610: 74 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 the client is re
1620: 61 64 69 6e 67 20 20 6f 72 20 77 72 69 74 69 6e ading or writin
1630: 67 20 61 6e 20 69 6e 64 65 78 20 61 6e 64 20 74 g an index and t
1640: 68 65 20 73 63 68 65 6d 61 20 69 73 0a 20 20 2a he schema is. *
1650: 2a 20 6e 6f 74 20 6c 6f 61 64 65 64 2c 20 74 68 * not loaded, th
1660: 65 6e 20 69 74 20 69 73 20 74 6f 6f 20 64 69 66 en it is too dif
1670: 66 69 63 75 6c 74 20 74 6f 20 61 63 74 75 61 6c ficult to actual
1680: 6c 79 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 ly check to see
1690: 69 66 0a 20 20 2a 2a 20 74 68 65 20 63 6f 72 72 if. ** the corr
16a0: 65 63 74 20 6c 6f 63 6b 73 20 61 72 65 20 68 65 ect locks are he
16b0: 6c 64 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 62 ld. So do not b
16c0: 6f 74 68 65 72 20 2d 20 6a 75 73 74 20 72 65 74 other - just ret
16d0: 75 72 6e 20 74 72 75 65 2e 0a 20 20 2a 2a 20 54 urn true.. ** T
16e0: 68 69 73 20 63 61 73 65 20 64 6f 65 73 20 6e 6f his case does no
16f0: 74 20 63 6f 6d 65 20 75 70 20 76 65 72 79 20 6f t come up very o
1700: 66 74 65 6e 20 61 6e 79 68 6f 77 2e 0a 20 20 2a ften anyhow.. *
1710: 2f 0a 20 20 69 66 28 20 69 73 49 6e 64 65 78 20 /. if( isIndex
1720: 26 26 20 28 21 70 53 63 68 65 6d 61 20 7c 7c 20 && (!pSchema ||
1730: 28 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 (pSchema->schema
1740: 46 6c 61 67 73 26 44 42 5f 53 63 68 65 6d 61 4c Flags&DB_SchemaL
1750: 6f 61 64 65 64 29 3d 3d 30 29 20 29 7b 0a 20 20 oaded)==0) ){.
1760: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a return 1;. }.
1770: 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 . /* Figure out
1780: 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 20 74 the root-page t
1790: 68 61 74 20 74 68 65 20 6c 6f 63 6b 20 73 68 6f hat the lock sho
17a0: 75 6c 64 20 62 65 20 68 65 6c 64 20 6f 6e 2e 20 uld be held on.
17b0: 46 6f 72 20 74 61 62 6c 65 0a 20 20 2a 2a 20 62 For table. ** b
17c0: 2d 74 72 65 65 73 2c 20 74 68 69 73 20 69 73 20 -trees, this is
17d0: 6a 75 73 74 20 74 68 65 20 72 6f 6f 74 20 70 61 just the root pa
17e0: 67 65 20 6f 66 20 74 68 65 20 62 2d 74 72 65 65 ge of the b-tree
17f0: 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 0a 20 being read or.
1800: 20 2a 2a 20 77 72 69 74 74 65 6e 2e 20 46 6f 72 ** written. For
1810: 20 69 6e 64 65 78 20 62 2d 74 72 65 65 73 2c 20 index b-trees,
1820: 69 74 20 69 73 20 74 68 65 20 72 6f 6f 74 20 70 it is the root p
1830: 61 67 65 20 6f 66 20 74 68 65 20 61 73 73 6f 63 age of the assoc
1840: 69 61 74 65 64 0a 20 20 2a 2a 20 74 61 62 6c 65 iated. ** table
1850: 2e 20 20 2a 2f 0a 20 20 69 66 28 20 69 73 49 6e . */. if( isIn
1860: 64 65 78 20 29 7b 0a 20 20 20 20 48 61 73 68 45 dex ){. HashE
1870: 6c 65 6d 20 2a 70 3b 0a 20 20 20 20 66 6f 72 28 lem *p;. for(
1880: 70 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 p=sqliteHashFirs
1890: 74 28 26 70 53 63 68 65 6d 61 2d 3e 69 64 78 48 t(&pSchema->idxH
18a0: 61 73 68 29 3b 20 70 3b 20 70 3d 73 71 6c 69 74 ash); p; p=sqlit
18b0: 65 48 61 73 68 4e 65 78 74 28 70 29 29 7b 0a 20 eHashNext(p)){.
18c0: 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 Index *pIdx
18d0: 20 3d 20 28 49 6e 64 65 78 20 2a 29 73 71 6c 69 = (Index *)sqli
18e0: 74 65 48 61 73 68 44 61 74 61 28 70 29 3b 0a 20 teHashData(p);.
18f0: 20 20 20 20 20 69 66 28 20 70 49 64 78 2d 3e 74 if( pIdx->t
1900: 6e 75 6d 3d 3d 28 69 6e 74 29 69 52 6f 6f 74 20 num==(int)iRoot
1910: 29 7b 0a 20 20 20 20 20 20 20 20 69 54 61 62 20 ){. iTab
1920: 3d 20 70 49 64 78 2d 3e 70 54 61 62 6c 65 2d 3e = pIdx->pTable->
1930: 74 6e 75 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 tnum;. }.
1940: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
1950: 20 69 54 61 62 20 3d 20 69 52 6f 6f 74 3b 0a 20 iTab = iRoot;.
1960: 20 7d 0a 0a 20 20 2f 2a 20 53 65 61 72 63 68 20 }.. /* Search
1970: 66 6f 72 20 74 68 65 20 72 65 71 75 69 72 65 64 for the required
1980: 20 6c 6f 63 6b 2e 20 45 69 74 68 65 72 20 61 20 lock. Either a
1990: 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 72 6f write-lock on ro
19a0: 6f 74 2d 70 61 67 65 20 69 54 61 62 2c 20 61 20 ot-page iTab, a
19b0: 0a 20 20 2a 2a 20 77 72 69 74 65 2d 6c 6f 63 6b . ** write-lock
19c0: 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 20 74 on the schema t
19d0: 61 62 6c 65 2c 20 6f 72 20 28 69 66 20 74 68 65 able, or (if the
19e0: 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 64 69 client is readi
19f0: 6e 67 29 20 61 0a 20 20 2a 2a 20 72 65 61 64 2d ng) a. ** read-
1a00: 6c 6f 63 6b 20 6f 6e 20 69 54 61 62 20 77 69 6c lock on iTab wil
1a10: 6c 20 73 75 66 66 69 63 65 2e 20 52 65 74 75 72 l suffice. Retur
1a20: 6e 20 31 20 69 66 20 61 6e 79 20 6f 66 20 74 68 n 1 if any of th
1a30: 65 73 65 20 61 72 65 20 66 6f 75 6e 64 2e 20 20 ese are found.
1a40: 2a 2f 0a 20 20 66 6f 72 28 70 4c 6f 63 6b 3d 70 */. for(pLock=p
1a50: 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 4c 6f 63 Btree->pBt->pLoc
1a60: 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d k; pLock; pLock=
1a70: 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 pLock->pNext){.
1a80: 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 70 42 if( pLock->pB
1a90: 74 72 65 65 3d 3d 70 42 74 72 65 65 20 0a 20 20 tree==pBtree .
1aa0: 20 20 20 26 26 20 28 70 4c 6f 63 6b 2d 3e 69 54 && (pLock->iT
1ab0: 61 62 6c 65 3d 3d 69 54 61 62 20 7c 7c 20 28 70 able==iTab || (p
1ac0: 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 49 Lock->eLock==WRI
1ad0: 54 45 5f 4c 4f 43 4b 20 26 26 20 70 4c 6f 63 6b TE_LOCK && pLock
1ae0: 2d 3e 69 54 61 62 6c 65 3d 3d 31 29 29 0a 20 20 ->iTable==1)).
1af0: 20 20 20 26 26 20 70 4c 6f 63 6b 2d 3e 65 4c 6f && pLock->eLo
1b00: 63 6b 3e 3d 65 4c 6f 63 6b 54 79 70 65 20 0a 20 ck>=eLockType .
1b10: 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ){. retu
1b20: 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a rn 1;. }. }.
1b30: 0a 20 20 2f 2a 20 46 61 69 6c 65 64 20 74 6f 20 . /* Failed to
1b40: 66 69 6e 64 20 74 68 65 20 72 65 71 75 69 72 65 find the require
1b50: 64 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 72 65 74 d lock. */. ret
1b60: 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 urn 0;.}.#endif
1b70: 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 /* SQLITE_DEBUG
1b80: 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
1b90: 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a 20 E_DEBUG./*.****
1ba0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 This function ma
1bb0: 79 20 62 65 20 75 73 65 64 20 61 73 20 70 61 72 y be used as par
1bc0: 74 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 t of assert() st
1bd0: 61 74 65 6d 65 6e 74 73 20 6f 6e 6c 79 2e 20 2a atements only. *
1be0: 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e ***.**.** Return
1bf0: 20 74 72 75 65 20 69 66 20 69 74 20 77 6f 75 6c true if it woul
1c00: 64 20 62 65 20 69 6c 6c 65 67 61 6c 20 66 6f 72 d be illegal for
1c10: 20 70 42 74 72 65 65 20 74 6f 20 77 72 69 74 65 pBtree to write
1c20: 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 74 61 62 into the.** tab
1c30: 6c 65 20 6f 72 20 69 6e 64 65 78 20 72 6f 6f 74 le or index root
1c40: 65 64 20 61 74 20 69 52 6f 6f 74 20 62 65 63 61 ed at iRoot beca
1c50: 75 73 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 use other shared
1c60: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 72 65 connections are
1c70: 0a 2a 2a 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 .** simultaneous
1c80: 6c 79 20 72 65 61 64 69 6e 67 20 74 68 61 74 20 ly reading that
1c90: 73 61 6d 65 20 74 61 62 6c 65 20 6f 72 20 69 6e same table or in
1ca0: 64 65 78 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 dex..**.** It is
1cb0: 20 69 6c 6c 65 67 61 6c 20 66 6f 72 20 70 42 74 illegal for pBt
1cc0: 72 65 65 20 74 6f 20 77 72 69 74 65 20 69 66 20 ree to write if
1cd0: 73 6f 6d 65 20 6f 74 68 65 72 20 42 74 72 65 65 some other Btree
1ce0: 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a 2a 20 object that.**
1cf0: 73 68 61 72 65 73 20 74 68 65 20 73 61 6d 65 20 shares the same
1d00: 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 20 BtShared object
1d10: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 72 65 61 is currently rea
1d20: 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 0a ding or writing.
1d30: 2a 2a 20 74 68 65 20 69 52 6f 6f 74 20 74 61 62 ** the iRoot tab
1d40: 6c 65 2e 20 20 45 78 63 65 70 74 2c 20 69 66 20 le. Except, if
1d50: 74 68 65 20 6f 74 68 65 72 20 42 74 72 65 65 20 the other Btree
1d60: 6f 62 6a 65 63 74 20 68 61 73 20 74 68 65 0a 2a object has the.*
1d70: 2a 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 * read-uncommitt
1d80: 65 64 20 66 6c 61 67 20 73 65 74 2c 20 74 68 65 ed flag set, the
1d90: 6e 20 69 74 20 69 73 20 4f 4b 20 66 6f 72 20 74 n it is OK for t
1da0: 68 65 20 6f 74 68 65 72 20 6f 62 6a 65 63 74 20 he other object
1db0: 74 6f 0a 2a 2a 20 68 61 76 65 20 61 20 72 65 61 to.** have a rea
1dc0: 64 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 d cursor..**.**
1dd0: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 62 65 66 For example, bef
1de0: 6f 72 65 20 77 72 69 74 69 6e 67 20 74 6f 20 61 ore writing to a
1df0: 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 74 ny part of the t
1e00: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a 2a 2a able or index.**
1e10: 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 rooted at page
1e20: 69 52 6f 6f 74 2c 20 6f 6e 65 20 73 68 6f 75 6c iRoot, one shoul
1e30: 64 20 63 61 6c 6c 3a 0a 2a 2a 0a 2a 2a 20 20 20 d call:.**.**
1e40: 20 61 73 73 65 72 74 28 20 21 68 61 73 52 65 61 assert( !hasRea
1e50: 64 43 6f 6e 66 6c 69 63 74 73 28 70 42 74 72 65 dConflicts(pBtre
1e60: 65 2c 20 69 52 6f 6f 74 29 20 29 3b 0a 2a 2f 0a e, iRoot) );.*/.
1e70: 73 74 61 74 69 63 20 69 6e 74 20 68 61 73 52 65 static int hasRe
1e80: 61 64 43 6f 6e 66 6c 69 63 74 73 28 42 74 72 65 adConflicts(Btre
1e90: 65 20 2a 70 42 74 72 65 65 2c 20 50 67 6e 6f 20 e *pBtree, Pgno
1ea0: 69 52 6f 6f 74 29 7b 0a 20 20 42 74 43 75 72 73 iRoot){. BtCurs
1eb0: 6f 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70 or *p;. for(p=p
1ec0: 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 Btree->pBt->pCur
1ed0: 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 sor; p; p=p->pNe
1ee0: 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e xt){. if( p->
1ef0: 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 20 pgnoRoot==iRoot
1f00: 0a 20 20 20 20 20 26 26 20 70 2d 3e 70 42 74 72 . && p->pBtr
1f10: 65 65 21 3d 70 42 74 72 65 65 0a 20 20 20 20 20 ee!=pBtree.
1f20: 26 26 20 30 3d 3d 28 70 2d 3e 70 42 74 72 65 65 && 0==(p->pBtree
1f30: 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 ->db->flags & SQ
1f40: 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 LITE_ReadUncommi
1f50: 74 74 65 64 29 0a 20 20 20 20 29 7b 0a 20 20 20 tted). ){.
1f60: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 return 1;.
1f70: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
1f80: 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 20 20 20 2f 0;.}.#endif /
1f90: 2a 20 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f * #ifdef SQLITE_
1fa0: 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 DEBUG */../*.**
1fb0: 51 75 65 72 79 20 74 6f 20 73 65 65 20 69 66 20 Query to see if
1fc0: 42 74 72 65 65 20 68 61 6e 64 6c 65 20 70 20 6d Btree handle p m
1fd0: 61 79 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b ay obtain a lock
1fe0: 20 6f 66 20 74 79 70 65 20 65 4c 6f 63 6b 20 0a of type eLock .
1ff0: 2a 2a 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 ** (READ_LOCK or
2000: 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 6f 6e 20 WRITE_LOCK) on
2010: 74 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 the table with r
2020: 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 2e 20 52 oot-page iTab. R
2030: 65 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f eturn.** SQLITE_
2040: 4f 4b 20 69 66 20 74 68 65 20 6c 6f 63 6b 20 6d OK if the lock m
2050: 61 79 20 62 65 20 6f 62 74 61 69 6e 65 64 20 28 ay be obtained (
2060: 62 79 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 73 65 by calling.** se
2070: 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c tSharedCacheTabl
2080: 65 4c 6f 63 6b 28 29 29 2c 20 6f 72 20 53 51 4c eLock()), or SQL
2090: 49 54 45 5f 4c 4f 43 4b 45 44 20 69 66 20 6e 6f ITE_LOCKED if no
20a0: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
20b0: 20 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 querySharedCach
20c0: 65 54 61 62 6c 65 4c 6f 63 6b 28 42 74 72 65 65 eTableLock(Btree
20d0: 20 2a 70 2c 20 50 67 6e 6f 20 69 54 61 62 2c 20 *p, Pgno iTab,
20e0: 75 38 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 u8 eLock){. BtS
20f0: 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
2100: 70 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 pBt;. BtLock *p
2110: 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 Iter;.. assert(
2120: 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
2130: 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 dsMutex(p) );.
2140: 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 assert( eLock==R
2150: 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 EAD_LOCK || eLoc
2160: 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 3b k==WRITE_LOCK );
2170: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64 62 . assert( p->db
2180: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
2190: 20 21 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 !(p->db->flags&
21a0: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d SQLITE_ReadUncom
21b0: 6d 69 74 74 65 64 29 7c 7c 65 4c 6f 63 6b 3d 3d mitted)||eLock==
21c0: 57 52 49 54 45 5f 4c 4f 43 4b 7c 7c 69 54 61 62 WRITE_LOCK||iTab
21d0: 3d 3d 31 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 ==1 );. . /* I
21e0: 66 20 72 65 71 75 65 73 74 69 6e 67 20 61 20 77 f requesting a w
21f0: 72 69 74 65 2d 6c 6f 63 6b 2c 20 74 68 65 6e 20 rite-lock, then
2200: 74 68 65 20 42 74 72 65 65 20 6d 75 73 74 20 68 the Btree must h
2210: 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 74 ave an open writ
2220: 65 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 e. ** transacti
2230: 6f 6e 20 6f 6e 20 74 68 69 73 20 66 69 6c 65 2e on on this file.
2240: 20 41 6e 64 2c 20 6f 62 76 69 6f 75 73 6c 79 2c And, obviously,
2250: 20 66 6f 72 20 74 68 69 73 20 74 6f 20 62 65 20 for this to be
2260: 73 6f 20 74 68 65 72 65 20 0a 20 20 2a 2a 20 6d so there . ** m
2270: 75 73 74 20 62 65 20 61 6e 20 6f 70 65 6e 20 77 ust be an open w
2280: 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
2290: 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 74 73 on the file its
22a0: 65 6c 66 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 elf.. */. asse
22b0: 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f rt( eLock==READ_
22c0: 4c 4f 43 4b 20 7c 7c 20 28 70 3d 3d 70 42 74 2d LOCK || (p==pBt-
22d0: 3e 70 57 72 69 74 65 72 20 26 26 20 70 2d 3e 69 >pWriter && p->i
22e0: 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 nTrans==TRANS_WR
22f0: 49 54 45 29 20 29 3b 0a 20 20 61 73 73 65 72 74 ITE) );. assert
2300: 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f ( eLock==READ_LO
2310: 43 4b 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 61 CK || pBt->inTra
2320: 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
2330: 57 52 49 54 45 20 29 3b 0a 20 20 0a 20 20 2f 2a WRITE );. . /*
2340: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
2350: 20 61 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 a no-op if the
2360: 73 68 61 72 65 64 2d 63 61 63 68 65 20 69 73 20 shared-cache is
2370: 6e 6f 74 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 not enabled */.
2380: 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 6c if( !p->sharabl
2390: 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 e ){. return
23a0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a SQLITE_OK;. }..
23b0: 20 20 2f 2a 20 49 66 20 73 6f 6d 65 20 6f 74 68 /* If some oth
23c0: 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 er connection is
23d0: 20 68 6f 6c 64 69 6e 67 20 61 6e 20 65 78 63 6c holding an excl
23e0: 75 73 69 76 65 20 6c 6f 63 6b 2c 20 74 68 65 0a usive lock, the.
23f0: 20 20 2a 2a 20 72 65 71 75 65 73 74 65 64 20 6c ** requested l
2400: 6f 63 6b 20 6d 61 79 20 6e 6f 74 20 62 65 20 6f ock may not be o
2410: 62 74 61 69 6e 65 64 2e 0a 20 20 2a 2f 0a 20 20 btained.. */.
2420: 69 66 28 20 70 42 74 2d 3e 70 57 72 69 74 65 72 if( pBt->pWriter
2430: 21 3d 70 20 26 26 20 28 70 42 74 2d 3e 62 74 73 !=p && (pBt->bts
2440: 46 6c 61 67 73 20 26 20 42 54 53 5f 45 58 43 4c Flags & BTS_EXCL
2450: 55 53 49 56 45 29 21 3d 30 20 29 7b 0a 20 20 20 USIVE)!=0 ){.
2460: 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
2470: 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 2c onBlocked(p->db,
2480: 20 70 42 74 2d 3e 70 57 72 69 74 65 72 2d 3e 64 pBt->pWriter->d
2490: 62 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 b);. return S
24a0: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 QLITE_LOCKED_SHA
24b0: 52 45 44 43 41 43 48 45 3b 0a 20 20 7d 0a 0a 20 REDCACHE;. }..
24c0: 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 2d 3e for(pIter=pBt->
24d0: 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 70 49 pLock; pIter; pI
24e0: 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 78 74 ter=pIter->pNext
24f0: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 6f ){. /* The co
2500: 6e 64 69 74 69 6f 6e 20 28 70 49 74 65 72 2d 3e ndition (pIter->
2510: 65 4c 6f 63 6b 21 3d 65 4c 6f 63 6b 29 20 69 6e eLock!=eLock) in
2520: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 the following i
2530: 66 28 2e 2e 2e 29 20 0a 20 20 20 20 2a 2a 20 73 f(...) . ** s
2540: 74 61 74 65 6d 65 6e 74 20 69 73 20 61 20 73 69 tatement is a si
2550: 6d 70 6c 69 66 69 63 61 74 69 6f 6e 20 6f 66 3a mplification of:
2560: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 . **. **
2570: 20 28 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c (eLock==WRITE_L
2580: 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 65 4c OCK || pIter->eL
2590: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 29 ock==WRITE_LOCK)
25a0: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 73 . **. ** s
25b0: 69 6e 63 65 20 77 65 20 6b 6e 6f 77 20 74 68 61 ince we know tha
25c0: 74 20 69 66 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 t if eLock==WRIT
25d0: 45 5f 4c 4f 43 4b 2c 20 74 68 65 6e 20 6e 6f 20 E_LOCK, then no
25e0: 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
25f0: 0a 20 20 20 20 2a 2a 20 6d 61 79 20 68 6f 6c 64 . ** may hold
2600: 20 61 20 57 52 49 54 45 5f 4c 4f 43 4b 20 6f 6e a WRITE_LOCK on
2610: 20 61 6e 79 20 74 61 62 6c 65 20 69 6e 20 74 68 any table in th
2620: 69 73 20 66 69 6c 65 20 28 73 69 6e 63 65 20 74 is file (since t
2630: 68 65 72 65 20 63 61 6e 0a 20 20 20 20 2a 2a 20 here can. **
2640: 6f 6e 6c 79 20 62 65 20 61 20 73 69 6e 67 6c 65 only be a single
2650: 20 77 72 69 74 65 72 29 2e 0a 20 20 20 20 2a 2f writer).. */
2660: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 74 . assert( pIt
2670: 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f er->eLock==READ_
2680: 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 65 LOCK || pIter->e
2690: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
26a0: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
26b0: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
26c0: 20 7c 7c 20 70 49 74 65 72 2d 3e 70 42 74 72 65 || pIter->pBtre
26d0: 65 3d 3d 70 20 7c 7c 20 70 49 74 65 72 2d 3e 65 e==p || pIter->e
26e0: 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 29 Lock==READ_LOCK)
26f0: 3b 0a 20 20 20 20 69 66 28 20 70 49 74 65 72 2d ;. if( pIter-
2700: 3e 70 42 74 72 65 65 21 3d 70 20 26 26 20 70 49 >pBtree!=p && pI
2710: 74 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 ter->iTable==iTa
2720: 62 20 26 26 20 70 49 74 65 72 2d 3e 65 4c 6f 63 b && pIter->eLoc
2730: 6b 21 3d 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 k!=eLock ){.
2740: 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 sqlite3Connect
2750: 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 ionBlocked(p->db
2760: 2c 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 2d , pIter->pBtree-
2770: 3e 64 62 29 3b 0a 20 20 20 20 20 20 69 66 28 20 >db);. if(
2780: 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 eLock==WRITE_LOC
2790: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 K ){. ass
27a0: 65 72 74 28 20 70 3d 3d 70 42 74 2d 3e 70 57 72 ert( p==pBt->pWr
27b0: 69 74 65 72 20 29 3b 0a 20 20 20 20 20 20 20 20 iter );.
27c0: 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
27d0: 20 42 54 53 5f 50 45 4e 44 49 4e 47 3b 0a 20 20 BTS_PENDING;.
27e0: 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 }. retu
27f0: 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 rn SQLITE_LOCKED
2800: 5f 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 _SHAREDCACHE;.
2810: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
2820: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
2830: 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 5f ndif /* !SQLITE_
2840: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
2850: 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 E */..#ifndef SQ
2860: 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
2870: 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 64 64 _CACHE./*.** Add
2880: 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 74 a lock on the t
2890: 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 able with root-p
28a0: 61 67 65 20 69 54 61 62 6c 65 20 74 6f 20 74 68 age iTable to th
28b0: 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 75 e shared-btree u
28c0: 73 65 64 0a 2a 2a 20 62 79 20 42 74 72 65 65 20 sed.** by Btree
28d0: 68 61 6e 64 6c 65 20 70 2e 20 50 61 72 61 6d 65 handle p. Parame
28e0: 74 65 72 20 65 4c 6f 63 6b 20 6d 75 73 74 20 62 ter eLock must b
28f0: 65 20 65 69 74 68 65 72 20 52 45 41 44 5f 4c 4f e either READ_LO
2900: 43 4b 20 6f 72 20 0a 2a 2a 20 57 52 49 54 45 5f CK or .** WRITE_
2910: 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 LOCK..**.** This
2920: 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 function assume
2930: 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a s the following:
2940: 0a 2a 2a 0a 2a 2a 20 20 20 28 61 29 20 54 68 65 .**.** (a) The
2950: 20 73 70 65 63 69 66 69 65 64 20 42 74 72 65 65 specified Btree
2960: 20 6f 62 6a 65 63 74 20 70 20 69 73 20 63 6f 6e object p is con
2970: 6e 65 63 74 65 64 20 74 6f 20 61 20 73 68 61 72 nected to a shar
2980: 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 64 61 able.** da
2990: 74 61 62 61 73 65 20 28 6f 6e 65 20 77 69 74 68 tabase (one with
29a0: 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 73 68 the BtShared.sh
29b0: 61 72 61 62 6c 65 20 66 6c 61 67 20 73 65 74 29 arable flag set)
29c0: 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 28 62 , and.**.** (b
29d0: 29 20 4e 6f 20 6f 74 68 65 72 20 42 74 72 65 65 ) No other Btree
29e0: 20 6f 62 6a 65 63 74 73 20 68 6f 6c 64 20 61 20 objects hold a
29f0: 6c 6f 63 6b 20 74 68 61 74 20 63 6f 6e 66 6c 69 lock that confli
2a00: 63 74 73 0a 2a 2a 20 20 20 20 20 20 20 77 69 74 cts.** wit
2a10: 68 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 h the requested
2a20: 6c 6f 63 6b 20 28 69 2e 65 2e 20 71 75 65 72 79 lock (i.e. query
2a30: 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
2a40: 4c 6f 63 6b 28 29 20 68 61 73 0a 2a 2a 20 20 20 Lock() has.**
2a50: 20 20 20 20 61 6c 72 65 61 64 79 20 62 65 65 6e already been
2a60: 20 63 61 6c 6c 65 64 20 61 6e 64 20 72 65 74 75 called and retu
2a70: 72 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4b 29 2e rned SQLITE_OK).
2a80: 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
2a90: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
2aa0: 74 68 65 20 6c 6f 63 6b 20 69 73 20 61 64 64 65 the lock is adde
2ab0: 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e 20 d successfully.
2ac0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 0a 2a 2a SQLITE_NOMEM .**
2ad0: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
2ae0: 61 20 6d 61 6c 6c 6f 63 20 61 74 74 65 6d 70 74 a malloc attempt
2af0: 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 fails..*/.stati
2b00: 63 20 69 6e 74 20 73 65 74 53 68 61 72 65 64 43 c int setSharedC
2b10: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 42 74 acheTableLock(Bt
2b20: 72 65 65 20 2a 70 2c 20 50 67 6e 6f 20 69 54 61 ree *p, Pgno iTa
2b30: 62 6c 65 2c 20 75 38 20 65 4c 6f 63 6b 29 7b 0a ble, u8 eLock){.
2b40: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
2b50: 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 4c 6f = p->pBt;. BtLo
2b60: 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 30 3b 0a 20 ck *pLock = 0;.
2b70: 20 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a BtLock *pIter;.
2b80: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
2b90: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
2ba0: 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
2bb0: 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f ( eLock==READ_LO
2bc0: 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 CK || eLock==WRI
2bd0: 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 TE_LOCK );. ass
2be0: 65 72 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b ert( p->db!=0 );
2bf0: 0a 0a 20 20 2f 2a 20 41 20 63 6f 6e 6e 65 63 74 .. /* A connect
2c00: 69 6f 6e 20 77 69 74 68 20 74 68 65 20 72 65 61 ion with the rea
2c10: 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c d-uncommitted fl
2c20: 61 67 20 73 65 74 20 77 69 6c 6c 20 6e 65 76 65 ag set will neve
2c30: 72 20 74 72 79 20 74 6f 0a 20 20 2a 2a 20 6f 62 r try to. ** ob
2c40: 74 61 69 6e 20 61 20 72 65 61 64 2d 6c 6f 63 6b tain a read-lock
2c50: 20 75 73 69 6e 67 20 74 68 69 73 20 66 75 6e 63 using this func
2c60: 74 69 6f 6e 2e 20 54 68 65 20 6f 6e 6c 79 20 72 tion. The only r
2c70: 65 61 64 2d 6c 6f 63 6b 20 6f 62 74 61 69 6e 65 ead-lock obtaine
2c80: 64 0a 20 20 2a 2a 20 62 79 20 61 20 63 6f 6e 6e d. ** by a conn
2c90: 65 63 74 69 6f 6e 20 69 6e 20 72 65 61 64 2d 75 ection in read-u
2ca0: 6e 63 6f 6d 6d 69 74 74 65 64 20 6d 6f 64 65 20 ncommitted mode
2cb0: 69 73 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 is on the sqlite
2cc0: 5f 6d 61 73 74 65 72 20 0a 20 20 2a 2a 20 74 61 _master . ** ta
2cd0: 62 6c 65 2c 20 61 6e 64 20 74 68 61 74 20 6c 6f ble, and that lo
2ce0: 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 69 ck is obtained i
2cf0: 6e 20 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e n BtreeBeginTran
2d00: 73 28 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 s(). */. asser
2d10: 74 28 20 30 3d 3d 28 70 2d 3e 64 62 2d 3e 66 6c t( 0==(p->db->fl
2d20: 61 67 73 26 53 51 4c 49 54 45 5f 52 65 61 64 55 ags&SQLITE_ReadU
2d30: 6e 63 6f 6d 6d 69 74 74 65 64 29 20 7c 7c 20 65 ncommitted) || e
2d40: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
2d50: 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 66 );.. /* This f
2d60: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6f unction should o
2d70: 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e nly be called on
2d80: 20 61 20 73 68 61 72 61 62 6c 65 20 62 2d 74 72 a sharable b-tr
2d90: 65 65 20 61 66 74 65 72 20 69 74 20 0a 20 20 2a ee after it . *
2da0: 2a 20 68 61 73 20 62 65 65 6e 20 64 65 74 65 72 * has been deter
2db0: 6d 69 6e 65 64 20 74 68 61 74 20 6e 6f 20 6f 74 mined that no ot
2dc0: 68 65 72 20 62 2d 74 72 65 65 20 68 6f 6c 64 73 her b-tree holds
2dd0: 20 61 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 6c a conflicting l
2de0: 6f 63 6b 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 ock. */. asser
2df0: 74 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 t( p->sharable )
2e00: 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 ;. assert( SQLI
2e10: 54 45 5f 4f 4b 3d 3d 71 75 65 72 79 53 68 61 72 TE_OK==queryShar
2e20: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
2e30: 28 70 2c 20 69 54 61 62 6c 65 2c 20 65 4c 6f 63 (p, iTable, eLoc
2e40: 6b 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 72 73 k) );.. /* Firs
2e50: 74 20 73 65 61 72 63 68 20 74 68 65 20 6c 69 73 t search the lis
2e60: 74 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e t for an existin
2e70: 67 20 6c 6f 63 6b 20 6f 6e 20 74 68 69 73 20 74 g lock on this t
2e80: 61 62 6c 65 2e 20 2a 2f 0a 20 20 66 6f 72 28 70 able. */. for(p
2e90: 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b Iter=pBt->pLock;
2ea0: 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 pIter; pIter=pI
2eb0: 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 ter->pNext){.
2ec0: 20 69 66 28 20 70 49 74 65 72 2d 3e 69 54 61 62 if( pIter->iTab
2ed0: 6c 65 3d 3d 69 54 61 62 6c 65 20 26 26 20 70 49 le==iTable && pI
2ee0: 74 65 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 ter->pBtree==p )
2ef0: 7b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 20 3d 20 {. pLock =
2f00: 70 49 74 65 72 3b 0a 20 20 20 20 20 20 62 72 65 pIter;. bre
2f10: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 ak;. }. }..
2f20: 20 2f 2a 20 49 66 20 74 68 65 20 61 62 6f 76 65 /* If the above
2f30: 20 73 65 61 72 63 68 20 64 69 64 20 6e 6f 74 20 search did not
2f40: 66 69 6e 64 20 61 20 42 74 4c 6f 63 6b 20 73 74 find a BtLock st
2f50: 72 75 63 74 20 61 73 73 6f 63 69 61 74 69 6e 67 ruct associating
2f60: 20 42 74 72 65 65 20 70 0a 20 20 2a 2a 20 77 69 Btree p. ** wi
2f70: 74 68 20 74 61 62 6c 65 20 69 54 61 62 6c 65 2c th table iTable,
2f80: 20 61 6c 6c 6f 63 61 74 65 20 6f 6e 65 20 61 6e allocate one an
2f90: 64 20 6c 69 6e 6b 20 69 74 20 69 6e 74 6f 20 74 d link it into t
2fa0: 68 65 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 he list.. */.
2fb0: 69 66 28 20 21 70 4c 6f 63 6b 20 29 7b 0a 20 20 if( !pLock ){.
2fc0: 20 20 70 4c 6f 63 6b 20 3d 20 28 42 74 4c 6f 63 pLock = (BtLoc
2fd0: 6b 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f k *)sqlite3Mallo
2fe0: 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 42 74 4c cZero(sizeof(BtL
2ff0: 6f 63 6b 29 29 3b 0a 20 20 20 20 69 66 28 20 21 ock));. if( !
3000: 70 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 72 pLock ){. r
3010: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
3020: 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4c EM;. }. pL
3030: 6f 63 6b 2d 3e 69 54 61 62 6c 65 20 3d 20 69 54 ock->iTable = iT
3040: 61 62 6c 65 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d able;. pLock-
3050: 3e 70 42 74 72 65 65 20 3d 20 70 3b 0a 20 20 20 >pBtree = p;.
3060: 20 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 20 3d 20 pLock->pNext =
3070: 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 20 pBt->pLock;.
3080: 70 42 74 2d 3e 70 4c 6f 63 6b 20 3d 20 70 4c 6f pBt->pLock = pLo
3090: 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 ck;. }.. /* Se
30a0: 74 20 74 68 65 20 42 74 4c 6f 63 6b 2e 65 4c 6f t the BtLock.eLo
30b0: 63 6b 20 76 61 72 69 61 62 6c 65 20 74 6f 20 74 ck variable to t
30c0: 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 20 74 68 he maximum of th
30d0: 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 6b 0a 20 e current lock.
30e0: 20 2a 2a 20 61 6e 64 20 74 68 65 20 72 65 71 75 ** and the requ
30f0: 65 73 74 65 64 20 6c 6f 63 6b 2e 20 54 68 69 73 ested lock. This
3100: 20 6d 65 61 6e 73 20 69 66 20 61 20 77 72 69 74 means if a writ
3110: 65 2d 6c 6f 63 6b 20 77 61 73 20 61 6c 72 65 61 e-lock was alrea
3120: 64 79 20 68 65 6c 64 0a 20 20 2a 2a 20 61 6e 64 dy held. ** and
3130: 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 72 65 71 a read-lock req
3140: 75 65 73 74 65 64 2c 20 77 65 20 64 6f 6e 27 74 uested, we don't
3150: 20 69 6e 63 6f 72 72 65 63 74 6c 79 20 64 6f 77 incorrectly dow
3160: 6e 67 72 61 64 65 20 74 68 65 20 6c 6f 63 6b 2e ngrade the lock.
3170: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
3180: 57 52 49 54 45 5f 4c 4f 43 4b 3e 52 45 41 44 5f WRITE_LOCK>READ_
3190: 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 65 4c LOCK );. if( eL
31a0: 6f 63 6b 3e 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b ock>pLock->eLock
31b0: 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 65 ){. pLock->e
31c0: 4c 6f 63 6b 20 3d 20 65 4c 6f 63 6b 3b 0a 20 20 Lock = eLock;.
31d0: 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }.. return SQLI
31e0: 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 TE_OK;.}.#endif
31f0: 2f 2a 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* !SQLITE_OMIT_
3200: 53 48 41 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a SHARED_CACHE */.
3210: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
3220: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
3230: 45 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 E./*.** Release
3240: 61 6c 6c 20 74 68 65 20 74 61 62 6c 65 20 6c 6f all the table lo
3250: 63 6b 73 20 28 6c 6f 63 6b 73 20 6f 62 74 61 69 cks (locks obtai
3260: 6e 65 64 20 76 69 61 20 63 61 6c 6c 73 20 74 6f ned via calls to
3270: 0a 2a 2a 20 74 68 65 20 73 65 74 53 68 61 72 65 .** the setShare
3280: 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 dCacheTableLock(
3290: 29 20 70 72 6f 63 65 64 75 72 65 29 20 68 65 6c ) procedure) hel
32a0: 64 20 62 79 20 42 74 72 65 65 20 6f 62 6a 65 63 d by Btree objec
32b0: 74 20 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 t p..**.** This
32c0: 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 function assumes
32d0: 20 74 68 61 74 20 42 74 72 65 65 20 70 20 68 61 that Btree p ha
32e0: 73 20 61 6e 20 6f 70 65 6e 20 72 65 61 64 20 6f s an open read o
32f0: 72 20 77 72 69 74 65 20 0a 2a 2a 20 74 72 61 6e r write .** tran
3300: 73 61 63 74 69 6f 6e 2e 20 49 66 20 69 74 20 64 saction. If it d
3310: 6f 65 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 oes not, then th
3320: 65 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 66 6c e BTS_PENDING fl
3330: 61 67 0a 2a 2a 20 6d 61 79 20 62 65 20 69 6e 63 ag.** may be inc
3340: 6f 72 72 65 63 74 6c 79 20 63 6c 65 61 72 65 64 orrectly cleared
3350: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
3360: 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 43 clearAllSharedC
3370: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 acheTableLocks(B
3380: 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 tree *p){. BtSh
3390: 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
33a0: 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 2a 70 Bt;. BtLock **p
33b0: 70 49 74 65 72 20 3d 20 26 70 42 74 2d 3e 70 4c pIter = &pBt->pL
33c0: 6f 63 6b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ock;.. assert(
33d0: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 sqlite3BtreeHold
33e0: 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 61 sMutex(p) );. a
33f0: 73 73 65 72 74 28 20 70 2d 3e 73 68 61 72 61 62 ssert( p->sharab
3400: 6c 65 20 7c 7c 20 30 3d 3d 2a 70 70 49 74 65 72 le || 0==*ppIter
3410: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d );. assert( p-
3420: 3e 69 6e 54 72 61 6e 73 3e 30 20 29 3b 0a 0a 20 >inTrans>0 );..
3430: 20 77 68 69 6c 65 28 20 2a 70 70 49 74 65 72 20 while( *ppIter
3440: 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 ){. BtLock *p
3450: 4c 6f 63 6b 20 3d 20 2a 70 70 49 74 65 72 3b 0a Lock = *ppIter;.
3460: 20 20 20 20 61 73 73 65 72 74 28 20 28 70 42 74 assert( (pBt
3470: 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
3480: 5f 45 58 43 4c 55 53 49 56 45 29 3d 3d 30 20 7c _EXCLUSIVE)==0 |
3490: 7c 20 70 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d | pBt->pWriter==
34a0: 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 20 29 3b pLock->pBtree );
34b0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f . assert( pLo
34c0: 63 6b 2d 3e 70 42 74 72 65 65 2d 3e 69 6e 54 72 ck->pBtree->inTr
34d0: 61 6e 73 3e 3d 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 ans>=pLock->eLoc
34e0: 6b 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4c 6f k );. if( pLo
34f0: 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 7b ck->pBtree==p ){
3500: 0a 20 20 20 20 20 20 2a 70 70 49 74 65 72 20 3d . *ppIter =
3510: 20 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a 20 pLock->pNext;.
3520: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f assert( pLo
3530: 63 6b 2d 3e 69 54 61 62 6c 65 21 3d 31 20 7c 7c ck->iTable!=1 ||
3540: 20 70 4c 6f 63 6b 3d 3d 26 70 2d 3e 6c 6f 63 6b pLock==&p->lock
3550: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4c );. if( pL
3560: 6f 63 6b 2d 3e 69 54 61 62 6c 65 21 3d 31 20 29 ock->iTable!=1 )
3570: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
3580: 33 5f 66 72 65 65 28 70 4c 6f 63 6b 29 3b 0a 20 3_free(pLock);.
3590: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 }. }else
35a0: 7b 0a 20 20 20 20 20 20 70 70 49 74 65 72 20 3d {. ppIter =
35b0: 20 26 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a &pLock->pNext;.
35c0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 73 }. }.. ass
35d0: 65 72 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c ert( (pBt->btsFl
35e0: 61 67 73 20 26 20 42 54 53 5f 50 45 4e 44 49 4e ags & BTS_PENDIN
35f0: 47 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 57 G)==0 || pBt->pW
3600: 72 69 74 65 72 20 29 3b 0a 20 20 69 66 28 20 70 riter );. if( p
3610: 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 20 29 Bt->pWriter==p )
3620: 7b 0a 20 20 20 20 70 42 74 2d 3e 70 57 72 69 74 {. pBt->pWrit
3630: 65 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d er = 0;. pBt-
3640: 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 28 42 >btsFlags &= ~(B
3650: 54 53 5f 45 58 43 4c 55 53 49 56 45 7c 42 54 53 TS_EXCLUSIVE|BTS
3660: 5f 50 45 4e 44 49 4e 47 29 3b 0a 20 20 7d 65 6c _PENDING);. }el
3670: 73 65 20 69 66 28 20 70 42 74 2d 3e 6e 54 72 61 se if( pBt->nTra
3680: 6e 73 61 63 74 69 6f 6e 3d 3d 32 20 29 7b 0a 20 nsaction==2 ){.
3690: 20 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 /* This funct
36a0: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 ion is called wh
36b0: 65 6e 20 42 74 72 65 65 20 70 20 69 73 20 63 6f en Btree p is co
36c0: 6e 63 6c 75 64 69 6e 67 20 69 74 73 20 0a 20 20 ncluding its .
36d0: 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e ** transaction
36e0: 2e 20 49 66 20 74 68 65 72 65 20 63 75 72 72 65 . If there curre
36f0: 6e 74 6c 79 20 65 78 69 73 74 73 20 61 20 77 72 ntly exists a wr
3700: 69 74 65 72 2c 20 61 6e 64 20 70 20 69 73 20 6e iter, and p is n
3710: 6f 74 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 77 ot. ** that w
3720: 72 69 74 65 72 2c 20 74 68 65 6e 20 74 68 65 20 riter, then the
3730: 6e 75 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 number of locks
3740: 68 65 6c 64 20 62 79 20 63 6f 6e 6e 65 63 74 69 held by connecti
3750: 6f 6e 73 20 6f 74 68 65 72 0a 20 20 20 20 2a 2a ons other. **
3760: 20 74 68 61 6e 20 74 68 65 20 77 72 69 74 65 72 than the writer
3770: 20 6d 75 73 74 20 62 65 20 61 62 6f 75 74 20 74 must be about t
3780: 6f 20 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2e 20 o drop to zero.
3790: 49 6e 20 74 68 69 73 20 63 61 73 65 0a 20 20 20 In this case.
37a0: 20 2a 2a 20 73 65 74 20 74 68 65 20 42 54 53 5f ** set the BTS_
37b0: 50 45 4e 44 49 4e 47 20 66 6c 61 67 20 74 6f 20 PENDING flag to
37c0: 30 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 0.. **. **
37d0: 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 If there is not
37e0: 20 63 75 72 72 65 6e 74 6c 79 20 61 20 77 72 69 currently a wri
37f0: 74 65 72 2c 20 74 68 65 6e 20 42 54 53 5f 50 45 ter, then BTS_PE
3800: 4e 44 49 4e 47 20 6d 75 73 74 0a 20 20 20 20 2a NDING must. *
3810: 2a 20 62 65 20 7a 65 72 6f 20 61 6c 72 65 61 64 * be zero alread
3820: 79 2e 20 53 6f 20 74 68 69 73 20 6e 65 78 74 20 y. So this next
3830: 6c 69 6e 65 20 69 73 20 68 61 72 6d 6c 65 73 73 line is harmless
3840: 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e 0a 20 in that case..
3850: 20 20 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 62 */. pBt->b
3860: 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f tsFlags &= ~BTS_
3870: 50 45 4e 44 49 4e 47 3b 0a 20 20 7d 0a 7d 0a 0a PENDING;. }.}..
3880: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
3890: 69 6f 6e 20 63 68 61 6e 67 65 73 20 61 6c 6c 20 ion changes all
38a0: 77 72 69 74 65 2d 6c 6f 63 6b 73 20 68 65 6c 64 write-locks held
38b0: 20 62 79 20 42 74 72 65 65 20 70 20 69 6e 74 6f by Btree p into
38c0: 20 72 65 61 64 2d 6c 6f 63 6b 73 2e 0a 2a 2f 0a read-locks..*/.
38d0: 73 74 61 74 69 63 20 76 6f 69 64 20 64 6f 77 6e static void down
38e0: 67 72 61 64 65 41 6c 6c 53 68 61 72 65 64 43 61 gradeAllSharedCa
38f0: 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 74 cheTableLocks(Bt
3900: 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 ree *p){. BtSha
3910: 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
3920: 74 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 57 t;. if( pBt->pW
3930: 72 69 74 65 72 3d 3d 70 20 29 7b 0a 20 20 20 20 riter==p ){.
3940: 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a 20 BtLock *pLock;.
3950: 20 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 pBt->pWriter
3960: 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d 3e 62 74 = 0;. pBt->bt
3970: 73 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 53 5f sFlags &= ~(BTS_
3980: 45 58 43 4c 55 53 49 56 45 7c 42 54 53 5f 50 45 EXCLUSIVE|BTS_PE
3990: 4e 44 49 4e 47 29 3b 0a 20 20 20 20 66 6f 72 28 NDING);. for(
39a0: 70 4c 6f 63 6b 3d 70 42 74 2d 3e 70 4c 6f 63 6b pLock=pBt->pLock
39b0: 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d 70 ; pLock; pLock=p
39c0: 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 Lock->pNext){.
39d0: 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 assert( pLoc
39e0: 6b 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c k->eLock==READ_L
39f0: 4f 43 4b 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 70 42 OCK || pLock->pB
3a00: 74 72 65 65 3d 3d 70 20 29 3b 0a 20 20 20 20 20 tree==p );.
3a10: 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 pLock->eLock =
3a20: 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d READ_LOCK;. }
3a30: 0a 20 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f . }.}..#endif /
3a40: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 * SQLITE_OMIT_SH
3a50: 41 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 73 ARED_CACHE */..s
3a60: 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 tatic void relea
3a70: 73 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a sePage(MemPage *
3a80: 70 50 61 67 65 29 3b 20 20 2f 2a 20 46 6f 72 77 pPage); /* Forw
3a90: 61 72 64 20 72 65 66 65 72 65 6e 63 65 20 2a 2f ard reference */
3aa0: 0a 0a 2f 2a 0a 2a 2a 2a 2a 2a 20 54 68 69 73 20 ../*.***** This
3ab0: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 routine is used
3ac0: 69 6e 73 69 64 65 20 6f 66 20 61 73 73 65 72 74 inside of assert
3ad0: 28 29 20 6f 6e 6c 79 20 2a 2a 2a 2a 0a 2a 2a 0a () only ****.**.
3ae0: 2a 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 74 ** Verify that t
3af0: 68 65 20 63 75 72 73 6f 72 20 68 6f 6c 64 73 20 he cursor holds
3b00: 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 69 74 73 the mutex on its
3b10: 20 42 74 53 68 61 72 65 64 0a 2a 2f 0a 23 69 66 BtShared.*/.#if
3b20: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
3b30: 0a 73 74 61 74 69 63 20 69 6e 74 20 63 75 72 73 .static int curs
3b40: 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 42 74 43 orHoldsMutex(BtC
3b50: 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 72 65 74 ursor *p){. ret
3b60: 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 urn sqlite3_mute
3b70: 78 5f 68 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d x_held(p->pBt->m
3b80: 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a utex);.}.#endif.
3b90: 0a 2f 2a 0a 2a 2a 20 49 6e 76 61 6c 69 64 61 74 ./*.** Invalidat
3ba0: 65 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 e the overflow c
3bb0: 61 63 68 65 20 6f 66 20 74 68 65 20 63 75 72 73 ache of the curs
3bc0: 6f 72 20 70 61 73 73 65 64 20 61 73 20 74 68 65 or passed as the
3bd0: 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e first argument.
3be0: 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 72 65 .** on the share
3bf0: 64 20 62 74 72 65 65 20 73 74 72 75 63 74 75 72 d btree structur
3c00: 65 20 70 42 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e e pBt..*/.#defin
3c10: 65 20 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 e invalidateOver
3c20: 66 6c 6f 77 43 61 63 68 65 28 70 43 75 72 29 20 flowCache(pCur)
3c30: 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
3c40: 26 3d 20 7e 42 54 43 46 5f 56 61 6c 69 64 4f 76 &= ~BTCF_ValidOv
3c50: 66 6c 29 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 61 6c fl)../*.** Inval
3c60: 69 64 61 74 65 20 74 68 65 20 6f 76 65 72 66 6c idate the overfl
3c70: 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ow page-list cac
3c80: 68 65 20 66 6f 72 20 61 6c 6c 20 63 75 72 73 6f he for all curso
3c90: 72 73 20 6f 70 65 6e 65 64 0a 2a 2a 20 6f 6e 20 rs opened.** on
3ca0: 74 68 65 20 73 68 61 72 65 64 20 62 74 72 65 65 the shared btree
3cb0: 20 73 74 72 75 63 74 75 72 65 20 70 42 74 2e 0a structure pBt..
3cc0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 */.static void i
3cd0: 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 nvalidateAllOver
3ce0: 66 6c 6f 77 43 61 63 68 65 28 42 74 53 68 61 72 flowCache(BtShar
3cf0: 65 64 20 2a 70 42 74 29 7b 0a 20 20 42 74 43 75 ed *pBt){. BtCu
3d00: 72 73 6f 72 20 2a 70 3b 0a 20 20 61 73 73 65 72 rsor *p;. asser
3d10: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
3d20: 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
3d30: 29 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 ) );. for(p=pBt
3d40: 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d ->pCursor; p; p=
3d50: 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 p->pNext){. i
3d60: 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c 6f nvalidateOverflo
3d70: 77 43 61 63 68 65 28 70 29 3b 0a 20 20 7d 0a 7d wCache(p);. }.}
3d80: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
3d90: 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 2f _OMIT_INCRBLOB./
3da0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
3db0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 65 66 on is called bef
3dc0: 6f 72 65 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 ore modifying th
3dd0: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 e contents of a
3de0: 74 61 62 6c 65 0a 2a 2a 20 74 6f 20 69 6e 76 61 table.** to inva
3df0: 6c 69 64 61 74 65 20 61 6e 79 20 69 6e 63 72 62 lidate any incrb
3e00: 6c 6f 62 20 63 75 72 73 6f 72 73 20 74 68 61 74 lob cursors that
3e10: 20 61 72 65 20 6f 70 65 6e 20 6f 6e 20 74 68 65 are open on the
3e20: 0a 2a 2a 20 72 6f 77 20 6f 72 20 6f 6e 65 20 6f .** row or one o
3e30: 66 20 74 68 65 20 72 6f 77 73 20 62 65 69 6e 67 f the rows being
3e40: 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a modified..**.**
3e50: 20 49 66 20 61 72 67 75 6d 65 6e 74 20 69 73 43 If argument isC
3e60: 6c 65 61 72 54 61 62 6c 65 20 69 73 20 74 72 75 learTable is tru
3e70: 65 2c 20 74 68 65 6e 20 74 68 65 20 65 6e 74 69 e, then the enti
3e80: 72 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 re contents of t
3e90: 68 65 0a 2a 2a 20 74 61 62 6c 65 20 69 73 20 61 he.** table is a
3ea0: 62 6f 75 74 20 74 6f 20 62 65 20 64 65 6c 65 74 bout to be delet
3eb0: 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ed. In this case
3ec0: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 invalidate all
3ed0: 69 6e 63 72 62 6c 6f 62 0a 2a 2a 20 63 75 72 73 incrblob.** curs
3ee0: 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 61 6e 79 20 ors open on any
3ef0: 72 6f 77 20 77 69 74 68 69 6e 20 74 68 65 20 74 row within the t
3f00: 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 able with root-p
3f10: 61 67 65 20 70 67 6e 6f 52 6f 6f 74 2e 0a 2a 2a age pgnoRoot..**
3f20: 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 .** Otherwise, i
3f30: 66 20 61 72 67 75 6d 65 6e 74 20 69 73 43 6c 65 f argument isCle
3f40: 61 72 54 61 62 6c 65 20 69 73 20 66 61 6c 73 65 arTable is false
3f50: 2c 20 74 68 65 6e 20 74 68 65 20 72 6f 77 20 77 , then the row w
3f60: 69 74 68 0a 2a 2a 20 72 6f 77 69 64 20 69 52 6f ith.** rowid iRo
3f70: 77 20 69 73 20 62 65 69 6e 67 20 72 65 70 6c 61 w is being repla
3f80: 63 65 64 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 ced or deleted.
3f90: 49 6e 20 74 68 69 73 20 63 61 73 65 20 69 6e 76 In this case inv
3fa0: 61 6c 69 64 61 74 65 0a 2a 2a 20 6f 6e 6c 79 20 alidate.** only
3fb0: 74 68 6f 73 65 20 69 6e 63 72 62 6c 6f 62 20 63 those incrblob c
3fc0: 75 72 73 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 74 ursors open on t
3fd0: 68 61 74 20 73 70 65 63 69 66 69 63 20 72 6f 77 hat specific row
3fe0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
3ff0: 20 69 6e 76 61 6c 69 64 61 74 65 49 6e 63 72 62 invalidateIncrb
4000: 6c 6f 62 43 75 72 73 6f 72 73 28 0a 20 20 42 74 lobCursors(. Bt
4010: 72 65 65 20 2a 70 42 74 72 65 65 2c 20 20 20 20 ree *pBtree,
4020: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
4030: 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 68 abase file to ch
4040: 65 63 6b 20 2a 2f 0a 20 20 69 36 34 20 69 52 6f eck */. i64 iRo
4050: 77 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 w,
4060: 20 2f 2a 20 54 68 65 20 72 6f 77 69 64 20 74 68 /* The rowid th
4070: 61 74 20 6d 69 67 68 74 20 62 65 20 63 68 61 6e at might be chan
4080: 67 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ging */. int is
4090: 43 6c 65 61 72 54 61 62 6c 65 20 20 20 20 20 20 ClearTable
40a0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6c 6c /* True if all
40b0: 20 72 6f 77 73 20 61 72 65 20 62 65 69 6e 67 20 rows are being
40c0: 64 65 6c 65 74 65 64 20 2a 2f 0a 29 7b 0a 20 20 deleted */.){.
40d0: 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 42 BtCursor *p;. B
40e0: 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
40f0: 42 74 72 65 65 2d 3e 70 42 74 3b 0a 20 20 61 73 Btree->pBt;. as
4100: 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 sert( sqlite3Btr
4110: 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 42 74 eeHoldsMutex(pBt
4120: 72 65 65 29 20 29 3b 0a 20 20 66 6f 72 28 70 3d ree) );. for(p=
4130: 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b pBt->pCursor; p;
4140: 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 p=p->pNext){.
4150: 20 20 69 66 28 20 28 70 2d 3e 63 75 72 46 6c 61 if( (p->curFla
4160: 67 73 20 26 20 42 54 43 46 5f 49 6e 63 72 62 6c gs & BTCF_Incrbl
4170: 6f 62 29 21 3d 30 0a 20 20 20 20 20 26 26 20 28 ob)!=0. && (
4180: 69 73 43 6c 65 61 72 54 61 62 6c 65 20 7c 7c 20 isClearTable ||
4190: 70 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 52 p->info.nKey==iR
41a0: 6f 77 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 ow). ){.
41b0: 20 70 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 p->eState = CUR
41c0: 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 SOR_INVALID;.
41d0: 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6c 73 65 0a }. }.}..#else.
41e0: 20 20 2f 2a 20 53 74 75 62 20 66 75 6e 63 74 69 /* Stub functi
41f0: 6f 6e 20 77 68 65 6e 20 49 4e 43 52 42 4c 4f 42 on when INCRBLOB
4200: 20 69 73 20 6f 6d 69 74 74 65 64 20 2a 2f 0a 20 is omitted */.
4210: 20 23 64 65 66 69 6e 65 20 69 6e 76 61 6c 69 64 #define invalid
4220: 61 74 65 49 6e 63 72 62 6c 6f 62 43 75 72 73 6f ateIncrblobCurso
4230: 72 73 28 78 2c 79 2c 7a 29 0a 23 65 6e 64 69 66 rs(x,y,z).#endif
4240: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
4250: 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a 0a 2f 2a 0a INCRBLOB */../*.
4260: 2a 2a 20 53 65 74 20 62 69 74 20 70 67 6e 6f 20 ** Set bit pgno
4270: 6f 66 20 74 68 65 20 42 74 53 68 61 72 65 64 2e of the BtShared.
4280: 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 76 pHasContent bitv
4290: 65 63 2e 20 54 68 69 73 20 69 73 20 63 61 6c 6c ec. This is call
42a0: 65 64 20 0a 2a 2a 20 77 68 65 6e 20 61 20 70 61 ed .** when a pa
42b0: 67 65 20 74 68 61 74 20 70 72 65 76 69 6f 75 73 ge that previous
42c0: 6c 79 20 63 6f 6e 74 61 69 6e 65 64 20 64 61 74 ly contained dat
42d0: 61 20 62 65 63 6f 6d 65 73 20 61 20 66 72 65 65 a becomes a free
42e0: 2d 6c 69 73 74 20 6c 65 61 66 20 0a 2a 2a 20 70 -list leaf .** p
42f0: 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 age..**.** The B
4300: 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 tShared.pHasCont
4310: 65 6e 74 20 62 69 74 76 65 63 20 65 78 69 73 74 ent bitvec exist
4320: 73 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 s to work around
4330: 20 61 6e 20 6f 62 73 63 75 72 65 0a 2a 2a 20 62 an obscure.** b
4340: 75 67 20 63 61 75 73 65 64 20 62 79 20 74 68 65 ug caused by the
4350: 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 6f 66 20 interaction of
4360: 74 77 6f 20 75 73 65 66 75 6c 20 49 4f 20 6f 70 two useful IO op
4370: 74 69 6d 69 7a 61 74 69 6f 6e 73 20 73 75 72 72 timizations surr
4380: 6f 75 6e 64 69 6e 67 0a 2a 2a 20 66 72 65 65 2d ounding.** free-
4390: 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 73 3a list leaf pages:
43a0: 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 57 68 65 6e .**.** 1) When
43b0: 20 61 6c 6c 20 64 61 74 61 20 69 73 20 64 65 6c all data is del
43c0: 65 74 65 64 20 66 72 6f 6d 20 61 20 70 61 67 65 eted from a page
43d0: 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 62 65 and the page be
43e0: 63 6f 6d 65 73 0a 2a 2a 20 20 20 20 20 20 61 20 comes.** a
43f0: 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 free-list leaf p
4400: 61 67 65 2c 20 74 68 65 20 70 61 67 65 20 69 73 age, the page is
4410: 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 74 6f 20 not written to
4420: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
4430: 20 20 20 20 20 28 61 73 20 66 72 65 65 2d 6c 69 (as free-li
4440: 73 74 20 6c 65 61 66 20 70 61 67 65 73 20 63 6f st leaf pages co
4450: 6e 74 61 69 6e 20 6e 6f 20 6d 65 61 6e 69 6e 67 ntain no meaning
4460: 66 75 6c 20 64 61 74 61 29 2e 20 53 6f 6d 65 74 ful data). Somet
4470: 69 6d 65 73 0a 2a 2a 20 20 20 20 20 20 73 75 63 imes.** suc
4480: 68 20 61 20 70 61 67 65 20 69 73 20 6e 6f 74 20 h a page is not
4490: 65 76 65 6e 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 even journalled
44a0: 28 61 73 20 69 74 20 77 69 6c 6c 20 6e 6f 74 20 (as it will not
44b0: 62 65 20 6d 6f 64 69 66 69 65 64 2c 0a 2a 2a 20 be modified,.**
44c0: 20 20 20 20 20 77 68 79 20 62 6f 74 68 65 72 20 why bother
44d0: 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 69 74 3f 29 journalling it?)
44e0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 29 20 57 68 65 ..**.** 2) Whe
44f0: 6e 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 n a free-list le
4500: 61 66 20 70 61 67 65 20 69 73 20 72 65 75 73 65 af page is reuse
4510: 64 2c 20 69 74 73 20 63 6f 6e 74 65 6e 74 20 69 d, its content i
4520: 73 20 6e 6f 74 20 72 65 61 64 0a 2a 2a 20 20 20 s not read.**
4530: 20 20 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 from the data
4540: 62 61 73 65 20 6f 72 20 77 72 69 74 74 65 6e 20 base or written
4550: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 to the journal f
4560: 69 6c 65 20 28 77 68 79 20 73 68 6f 75 6c 64 20 ile (why should
4570: 69 74 0a 2a 2a 20 20 20 20 20 20 62 65 2c 20 69 it.** be, i
4580: 66 20 69 74 20 69 73 20 6e 6f 74 20 61 74 20 61 f it is not at a
4590: 6c 6c 20 6d 65 61 6e 69 6e 67 66 75 6c 3f 29 2e ll meaningful?).
45a0: 0a 2a 2a 0a 2a 2a 20 42 79 20 74 68 65 6d 73 65 .**.** By themse
45b0: 6c 76 65 73 2c 20 74 68 65 73 65 20 6f 70 74 69 lves, these opti
45c0: 6d 69 7a 61 74 69 6f 6e 73 20 77 6f 72 6b 20 66 mizations work f
45d0: 69 6e 65 20 61 6e 64 20 70 72 6f 76 69 64 65 20 ine and provide
45e0: 61 20 68 61 6e 64 79 0a 2a 2a 20 70 65 72 66 6f a handy.** perfo
45f0: 72 6d 61 6e 63 65 20 62 6f 6f 73 74 20 74 6f 20 rmance boost to
4600: 62 75 6c 6b 20 64 65 6c 65 74 65 20 6f 72 20 69 bulk delete or i
4610: 6e 73 65 72 74 20 6f 70 65 72 61 74 69 6f 6e 73 nsert operations
4620: 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 0a 2a 2a . However, if.**
4630: 20 61 20 70 61 67 65 20 69 73 20 6d 6f 76 65 64 a page is moved
4640: 20 74 6f 20 74 68 65 20 66 72 65 65 2d 6c 69 73 to the free-lis
4650: 74 20 61 6e 64 20 74 68 65 6e 20 72 65 75 73 65 t and then reuse
4660: 64 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d d within the sam
4670: 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e e.** transaction
4680: 2c 20 61 20 70 72 6f 62 6c 65 6d 20 63 6f 6d 65 , a problem come
4690: 73 20 75 70 2e 20 49 66 20 74 68 65 20 70 61 67 s up. If the pag
46a0: 65 20 69 73 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c e is not journal
46b0: 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 69 74 20 69 led when.** it i
46c0: 73 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 20 66 s moved to the f
46d0: 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 69 74 20 ree-list and it
46e0: 69 73 20 61 6c 73 6f 20 6e 6f 74 20 6a 6f 75 72 is also not jour
46f0: 6e 61 6c 6c 65 64 20 77 68 65 6e 20 69 74 0a 2a nalled when it.*
4700: 2a 20 69 73 20 65 78 74 72 61 63 74 65 64 20 66 * is extracted f
4710: 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 73 rom the free-lis
4720: 74 20 61 6e 64 20 72 65 75 73 65 64 2c 20 74 68 t and reused, th
4730: 65 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 en the original
4740: 64 61 74 61 0a 2a 2a 20 6d 61 79 20 62 65 20 6c data.** may be l
4750: 6f 73 74 2e 20 49 6e 20 74 68 65 20 65 76 65 6e ost. In the even
4760: 74 20 6f 66 20 61 20 72 6f 6c 6c 62 61 63 6b 2c t of a rollback,
4770: 20 69 74 20 6d 61 79 20 6e 6f 74 20 62 65 20 70 it may not be p
4780: 6f 73 73 69 62 6c 65 0a 2a 2a 20 74 6f 20 72 65 ossible.** to re
4790: 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 62 61 store the databa
47a0: 73 65 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e se to its origin
47b0: 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration
47c0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 6f 6c 75 ..**.** The solu
47d0: 74 69 6f 6e 20 69 73 20 74 68 65 20 42 74 53 68 tion is the BtSh
47e0: 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 ared.pHasContent
47f0: 20 62 69 74 76 65 63 2e 20 57 68 65 6e 65 76 65 bitvec. Wheneve
4800: 72 20 61 20 70 61 67 65 20 69 73 20 0a 2a 2a 20 r a page is .**
4810: 6d 6f 76 65 64 20 74 6f 20 62 65 63 6f 6d 65 20 moved to become
4820: 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 a free-list leaf
4830: 20 70 61 67 65 2c 20 74 68 65 20 63 6f 72 72 65 page, the corre
4840: 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 73 0a sponding bit is.
4850: 2a 2a 20 73 65 74 20 69 6e 20 74 68 65 20 62 69 ** set in the bi
4860: 74 76 65 63 2e 20 57 68 65 6e 65 76 65 72 20 61 tvec. Whenever a
4870: 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 65 78 leaf page is ex
4880: 74 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65 tracted from the
4890: 20 66 72 65 65 2d 6c 69 73 74 2c 0a 2a 2a 20 6f free-list,.** o
48a0: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 32 20 61 62 ptimization 2 ab
48b0: 6f 76 65 20 69 73 20 6f 6d 69 74 74 65 64 20 69 ove is omitted i
48c0: 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 f the correspond
48d0: 69 6e 67 20 62 69 74 20 69 73 20 61 6c 72 65 61 ing bit is alrea
48e0: 64 79 0a 2a 2a 20 73 65 74 20 69 6e 20 42 74 53 dy.** set in BtS
48f0: 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e hared.pHasConten
4900: 74 2e 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 t. The contents
4910: 6f 66 20 74 68 65 20 62 69 74 76 65 63 20 61 72 of the bitvec ar
4920: 65 20 63 6c 65 61 72 65 64 0a 2a 2a 20 61 74 20 e cleared.** at
4930: 74 68 65 20 65 6e 64 20 6f 66 20 65 76 65 72 79 the end of every
4940: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f transaction..*/
4950: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
4960: 65 53 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 42 eSetHasContent(B
4970: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
4980: 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 no pgno){. int
4990: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
49a0: 20 20 69 66 28 20 21 70 42 74 2d 3e 70 48 61 73 if( !pBt->pHas
49b0: 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 61 Content ){. a
49c0: 73 73 65 72 74 28 20 70 67 6e 6f 3c 3d 70 42 74 ssert( pgno<=pBt
49d0: 2d 3e 6e 50 61 67 65 20 29 3b 0a 20 20 20 20 70 ->nPage );. p
49e0: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 Bt->pHasContent
49f0: 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 = sqlite3BitvecC
4a00: 72 65 61 74 65 28 70 42 74 2d 3e 6e 50 61 67 65 reate(pBt->nPage
4a10: 29 3b 0a 20 20 20 20 69 66 28 20 21 70 42 74 2d );. if( !pBt-
4a20: 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 29 7b 0a >pHasContent ){.
4a30: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
4a40: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 E_NOMEM;. }.
4a50: 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }. if( rc==SQL
4a60: 49 54 45 5f 4f 4b 20 26 26 20 70 67 6e 6f 3c 3d ITE_OK && pgno<=
4a70: 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 69 7a sqlite3BitvecSiz
4a80: 65 28 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 e(pBt->pHasConte
4a90: 6e 74 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 nt) ){. rc =
4aa0: 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 74 sqlite3BitvecSet
4ab0: 28 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e (pBt->pHasConten
4ac0: 74 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 t, pgno);. }.
4ad0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
4ae0: 0a 2a 2a 20 51 75 65 72 79 20 74 68 65 20 42 74 .** Query the Bt
4af0: 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 Shared.pHasConte
4b00: 6e 74 20 76 65 63 74 6f 72 2e 0a 2a 2a 0a 2a 2a nt vector..**.**
4b10: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
4b20: 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 s called when a
4b30: 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 free-list leaf p
4b40: 61 67 65 20 69 73 20 72 65 6d 6f 76 65 64 20 66 age is removed f
4b50: 72 6f 6d 20 74 68 65 0a 2a 2a 20 66 72 65 65 2d rom the.** free-
4b60: 6c 69 73 74 20 66 6f 72 20 72 65 75 73 65 2e 20 list for reuse.
4b70: 49 74 20 72 65 74 75 72 6e 73 20 66 61 6c 73 65 It returns false
4b80: 20 69 66 20 69 74 20 69 73 20 73 61 66 65 20 74 if it is safe t
4b90: 6f 20 72 65 74 72 69 65 76 65 20 74 68 65 0a 2a o retrieve the.*
4ba0: 2a 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 * page from the
4bb0: 70 61 67 65 72 20 6c 61 79 65 72 20 77 69 74 68 pager layer with
4bc0: 20 74 68 65 20 27 6e 6f 2d 63 6f 6e 74 65 6e 74 the 'no-content
4bd0: 27 20 66 6c 61 67 20 73 65 74 2e 20 54 72 75 65 ' flag set. True
4be0: 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 otherwise..*/.s
4bf0: 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 47 tatic int btreeG
4c00: 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 42 74 53 etHasContent(BtS
4c10: 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f hared *pBt, Pgno
4c20: 20 70 67 6e 6f 29 7b 0a 20 20 42 69 74 76 65 63 pgno){. Bitvec
4c30: 20 2a 70 20 3d 20 70 42 74 2d 3e 70 48 61 73 43 *p = pBt->pHasC
4c40: 6f 6e 74 65 6e 74 3b 0a 20 20 72 65 74 75 72 6e ontent;. return
4c50: 20 28 70 20 26 26 20 28 70 67 6e 6f 3e 73 71 6c (p && (pgno>sql
4c60: 69 74 65 33 42 69 74 76 65 63 53 69 7a 65 28 70 ite3BitvecSize(p
4c70: 29 20 7c 7c 20 73 71 6c 69 74 65 33 42 69 74 76 ) || sqlite3Bitv
4c80: 65 63 54 65 73 74 28 70 2c 20 70 67 6e 6f 29 29 ecTest(p, pgno))
4c90: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 );.}../*.** Clea
4ca0: 72 20 28 64 65 73 74 72 6f 79 29 20 74 68 65 20 r (destroy) the
4cb0: 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e BtShared.pHasCon
4cc0: 74 65 6e 74 20 62 69 74 76 65 63 2e 20 54 68 69 tent bitvec. Thi
4cd0: 73 20 73 68 6f 75 6c 64 20 62 65 0a 2a 2a 20 69 s should be.** i
4ce0: 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f nvoked at the co
4cf0: 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 65 61 63 68 nclusion of each
4d00: 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
4d10: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f on..*/.static vo
4d20: 69 64 20 62 74 72 65 65 43 6c 65 61 72 48 61 73 id btreeClearHas
4d30: 43 6f 6e 74 65 6e 74 28 42 74 53 68 61 72 65 64 Content(BtShared
4d40: 20 2a 70 42 74 29 7b 0a 20 20 73 71 6c 69 74 65 *pBt){. sqlite
4d50: 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 70 3BitvecDestroy(p
4d60: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 29 Bt->pHasContent)
4d70: 3b 0a 20 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e ;. pBt->pHasCon
4d80: 74 65 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a tent = 0;.}../*.
4d90: 2a 2a 20 52 65 6c 65 61 73 65 20 61 6c 6c 20 6f ** Release all o
4da0: 66 20 74 68 65 20 61 70 50 61 67 65 5b 5d 20 70 f the apPage[] p
4db0: 61 67 65 73 20 66 6f 72 20 61 20 63 75 72 73 6f ages for a curso
4dc0: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 r..*/.static voi
4dd0: 64 20 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c d btreeReleaseAl
4de0: 6c 43 75 72 73 6f 72 50 61 67 65 73 28 42 74 43 lCursorPages(BtC
4df0: 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
4e00: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 int i;. for(i=0
4e10: 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 65 ; i<=pCur->iPage
4e20: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 72 65 6c 65 ; i++){. rele
4e30: 61 73 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 asePage(pCur->ap
4e40: 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 20 70 43 Page[i]);. pC
4e50: 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 20 3d 20 ur->apPage[i] =
4e60: 30 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 69 0;. }. pCur->i
4e70: 50 61 67 65 20 3d 20 2d 31 3b 0a 7d 0a 0a 0a 2f Page = -1;.}.../
4e80: 2a 0a 2a 2a 20 53 61 76 65 20 74 68 65 20 63 75 *.** Save the cu
4e90: 72 72 65 6e 74 20 63 75 72 73 6f 72 20 70 6f 73 rrent cursor pos
4ea0: 69 74 69 6f 6e 20 69 6e 20 74 68 65 20 76 61 72 ition in the var
4eb0: 69 61 62 6c 65 73 20 42 74 43 75 72 73 6f 72 2e iables BtCursor.
4ec0: 6e 4b 65 79 20 0a 2a 2a 20 61 6e 64 20 42 74 43 nKey .** and BtC
4ed0: 75 72 73 6f 72 2e 70 4b 65 79 2e 20 54 68 65 20 ursor.pKey. The
4ee0: 63 75 72 73 6f 72 27 73 20 73 74 61 74 65 20 69 cursor's state i
4ef0: 73 20 73 65 74 20 74 6f 20 43 55 52 53 4f 52 5f s set to CURSOR_
4f00: 52 45 51 55 49 52 45 53 45 45 4b 2e 0a 2a 2a 0a REQUIRESEEK..**.
4f10: 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 ** The caller mu
4f20: 73 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 74 st ensure that t
4f30: 68 65 20 63 75 72 73 6f 72 20 69 73 20 76 61 6c he cursor is val
4f40: 69 64 20 28 68 61 73 20 65 53 74 61 74 65 3d 3d id (has eState==
4f50: 43 55 52 53 4f 52 5f 56 41 4c 49 44 29 0a 2a 2a CURSOR_VALID).**
4f60: 20 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e prior to callin
4f70: 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 g this routine.
4f80: 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 .*/.static int
4f90: 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 saveCursorPositi
4fa0: 6f 6e 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 on(BtCursor *pCu
4fb0: 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 r){. int rc;..
4fc0: 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f assert( CURSOR_
4fd0: 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 VALID==pCur->eSt
4fe0: 61 74 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ate );. assert(
4ff0: 20 30 3d 3d 70 43 75 72 2d 3e 70 4b 65 79 20 29 0==pCur->pKey )
5000: 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
5010: 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
5020: 72 29 20 29 3b 0a 0a 20 20 72 63 20 3d 20 73 71 r) );.. rc = sq
5030: 6c 69 74 65 33 42 74 72 65 65 4b 65 79 53 69 7a lite3BtreeKeySiz
5040: 65 28 70 43 75 72 2c 20 26 70 43 75 72 2d 3e 6e e(pCur, &pCur->n
5050: 4b 65 79 29 3b 0a 20 20 61 73 73 65 72 74 28 20 Key);. assert(
5060: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b rc==SQLITE_OK );
5070: 20 20 2f 2a 20 4b 65 79 53 69 7a 65 28 29 20 63 /* KeySize() c
5080: 61 6e 6e 6f 74 20 66 61 69 6c 20 2a 2f 0a 0a 20 annot fail */..
5090: 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 /* If this is a
50a0: 6e 20 69 6e 74 4b 65 79 20 74 61 62 6c 65 2c 20 n intKey table,
50b0: 74 68 65 6e 20 74 68 65 20 61 62 6f 76 65 20 63 then the above c
50c0: 61 6c 6c 20 74 6f 20 42 74 72 65 65 4b 65 79 53 all to BtreeKeyS
50d0: 69 7a 65 28 29 0a 20 20 2a 2a 20 73 74 6f 72 65 ize(). ** store
50e0: 73 20 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65 s the integer ke
50f0: 79 20 69 6e 20 70 43 75 72 2d 3e 6e 4b 65 79 2e y in pCur->nKey.
5100: 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 In this case th
5110: 69 73 20 76 61 6c 75 65 20 69 73 0a 20 20 2a 2a is value is. **
5120: 20 61 6c 6c 20 74 68 61 74 20 69 73 20 72 65 71 all that is req
5130: 75 69 72 65 64 2e 20 4f 74 68 65 72 77 69 73 65 uired. Otherwise
5140: 2c 20 69 66 20 70 43 75 72 20 69 73 20 6e 6f 74 , if pCur is not
5150: 20 6f 70 65 6e 20 6f 6e 20 61 6e 20 69 6e 74 4b open on an intK
5160: 65 79 0a 20 20 2a 2a 20 74 61 62 6c 65 2c 20 74 ey. ** table, t
5170: 68 65 6e 20 6d 61 6c 6c 6f 63 20 73 70 61 63 65 hen malloc space
5180: 20 66 6f 72 20 61 6e 64 20 73 74 6f 72 65 20 74 for and store t
5190: 68 65 20 70 43 75 72 2d 3e 6e 4b 65 79 20 62 79 he pCur->nKey by
51a0: 74 65 73 20 6f 66 20 6b 65 79 20 0a 20 20 2a 2a tes of key . **
51b0: 20 64 61 74 61 2e 0a 20 20 2a 2f 0a 20 20 69 66 data.. */. if
51c0: 28 20 30 3d 3d 70 43 75 72 2d 3e 61 70 50 61 67 ( 0==pCur->apPag
51d0: 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a e[0]->intKey ){.
51e0: 20 20 20 20 76 6f 69 64 20 2a 70 4b 65 79 20 3d void *pKey =
51f0: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 sqlite3Malloc(
5200: 70 43 75 72 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 pCur->nKey );.
5210: 20 20 69 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 if( pKey ){.
5220: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
5230: 42 74 72 65 65 4b 65 79 28 70 43 75 72 2c 20 30 BtreeKey(pCur, 0
5240: 2c 20 28 69 6e 74 29 70 43 75 72 2d 3e 6e 4b 65 , (int)pCur->nKe
5250: 79 2c 20 70 4b 65 79 29 3b 0a 20 20 20 20 20 20 y, pKey);.
5260: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
5270: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 K ){. pCu
5280: 72 2d 3e 70 4b 65 79 20 3d 20 70 4b 65 79 3b 0a r->pKey = pKey;.
5290: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
52a0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
52b0: 65 28 70 4b 65 79 29 3b 0a 20 20 20 20 20 20 7d e(pKey);. }
52c0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
52d0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
52e0: 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 MEM;. }. }.
52f0: 20 61 73 73 65 72 74 28 20 21 70 43 75 72 2d 3e assert( !pCur->
5300: 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 apPage[0]->intKe
5310: 79 20 7c 7c 20 21 70 43 75 72 2d 3e 70 4b 65 79 y || !pCur->pKey
5320: 20 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 );.. if( rc==S
5330: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
5340: 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c 43 btreeReleaseAllC
5350: 75 72 73 6f 72 50 61 67 65 73 28 70 43 75 72 29 ursorPages(pCur)
5360: 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 ;. pCur->eSta
5370: 74 65 20 3d 20 43 55 52 53 4f 52 5f 52 45 51 55 te = CURSOR_REQU
5380: 49 52 45 53 45 45 4b 3b 0a 20 20 7d 0a 0a 20 20 IRESEEK;. }..
5390: 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c invalidateOverfl
53a0: 6f 77 43 61 63 68 65 28 70 43 75 72 29 3b 0a 20 owCache(pCur);.
53b0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
53c0: 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 * Forward refere
53d0: 6e 63 65 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e nce */.static in
53e0: 74 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e t SQLITE_NOINLIN
53f0: 45 20 73 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c E saveCursorsOnL
5400: 69 73 74 28 42 74 43 75 72 73 6f 72 2a 2c 50 67 ist(BtCursor*,Pg
5410: 6e 6f 2c 42 74 43 75 72 73 6f 72 2a 29 3b 0a 0a no,BtCursor*);..
5420: 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 65 20 70 /*.** Save the p
5430: 6f 73 69 74 69 6f 6e 73 20 6f 66 20 61 6c 6c 20 ositions of all
5440: 63 75 72 73 6f 72 73 20 28 65 78 63 65 70 74 20 cursors (except
5450: 70 45 78 63 65 70 74 29 20 74 68 61 74 20 61 72 pExcept) that ar
5460: 65 20 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 74 68 65 e open on.** the
5470: 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 table with root
5480: 2d 70 61 67 65 20 69 52 6f 6f 74 2e 20 20 22 53 -page iRoot. "S
5490: 61 76 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 aving the cursor
54a0: 20 70 6f 73 69 74 69 6f 6e 22 20 6d 65 61 6e 73 position" means
54b0: 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 6c 6f 63 that.** the loc
54c0: 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 62 74 72 ation in the btr
54d0: 65 65 20 69 73 20 72 65 6d 65 6d 62 65 72 65 64 ee is remembered
54e0: 20 69 6e 20 73 75 63 68 20 61 20 77 61 79 20 74 in such a way t
54f0: 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a 2a 2a hat it can be.**
5500: 20 6d 6f 76 65 64 20 62 61 63 6b 20 74 6f 20 74 moved back to t
5510: 68 65 20 73 61 6d 65 20 73 70 6f 74 20 61 66 74 he same spot aft
5520: 65 72 20 74 68 65 20 62 74 72 65 65 20 68 61 73 er the btree has
5530: 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e 20 been modified.
5540: 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 This.** routine
5550: 20 69 73 20 63 61 6c 6c 65 64 20 6a 75 73 74 20 is called just
5560: 62 65 66 6f 72 65 20 63 75 72 73 6f 72 20 70 45 before cursor pE
5570: 78 63 65 70 74 20 69 73 20 75 73 65 64 20 74 6f xcept is used to
5580: 20 6d 6f 64 69 66 79 20 74 68 65 0a 2a 2a 20 74 modify the.** t
5590: 61 62 6c 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c able, for exampl
55a0: 65 20 69 6e 20 42 74 72 65 65 44 65 6c 65 74 65 e in BtreeDelete
55b0: 28 29 20 6f 72 20 42 74 72 65 65 49 6e 73 65 72 () or BtreeInser
55c0: 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 6d 70 6c 65 t()..**.** Imple
55d0: 6d 65 6e 74 61 74 69 6f 6e 20 6e 6f 74 65 3a 20 mentation note:
55e0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 65 This routine me
55f0: 72 65 6c 79 20 63 68 65 63 6b 73 20 74 6f 20 73 rely checks to s
5600: 65 65 20 69 66 20 61 6e 79 20 63 75 72 73 6f 72 ee if any cursor
5610: 73 0a 2a 2a 20 6e 65 65 64 20 74 6f 20 62 65 20 s.** need to be
5620: 73 61 76 65 64 2e 20 20 49 74 20 63 61 6c 6c 73 saved. It calls
5630: 20 6f 75 74 20 74 6f 20 73 61 76 65 43 75 72 73 out to saveCurs
5640: 6f 72 73 4f 6e 4c 69 73 74 28 29 20 69 6e 20 74 orsOnList() in t
5650: 68 65 20 28 75 6e 75 73 75 61 6c 29 0a 2a 2a 20 he (unusual).**
5660: 65 76 65 6e 74 20 74 68 61 74 20 63 75 72 73 6f event that curso
5670: 72 73 20 61 72 65 20 69 6e 20 6e 65 65 64 20 74 rs are in need t
5680: 6f 20 62 65 69 6e 67 20 73 61 76 65 64 2e 0a 2a o being saved..*
5690: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 76 /.static int sav
56a0: 65 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 53 68 eAllCursors(BtSh
56b0: 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 ared *pBt, Pgno
56c0: 69 52 6f 6f 74 2c 20 42 74 43 75 72 73 6f 72 20 iRoot, BtCursor
56d0: 2a 70 45 78 63 65 70 74 29 7b 0a 20 20 42 74 43 *pExcept){. BtC
56e0: 75 72 73 6f 72 20 2a 70 3b 0a 20 20 61 73 73 65 ursor *p;. asse
56f0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
5700: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
5710: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
5720: 70 45 78 63 65 70 74 3d 3d 30 20 7c 7c 20 70 45 pExcept==0 || pE
5730: 78 63 65 70 74 2d 3e 70 42 74 3d 3d 70 42 74 20 xcept->pBt==pBt
5740: 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 2d 3e );. for(p=pBt->
5750: 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d pCursor; p; p=p-
5760: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 >pNext){. if(
5770: 20 70 21 3d 70 45 78 63 65 70 74 20 26 26 20 28 p!=pExcept && (
5780: 30 3d 3d 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e 70 0==iRoot || p->p
5790: 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 20 gnoRoot==iRoot)
57a0: 29 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 72 ) break;. }. r
57b0: 65 74 75 72 6e 20 70 20 3f 20 73 61 76 65 43 75 eturn p ? saveCu
57c0: 72 73 6f 72 73 4f 6e 4c 69 73 74 28 70 2c 20 69 rsorsOnList(p, i
57d0: 52 6f 6f 74 2c 20 70 45 78 63 65 70 74 29 20 3a Root, pExcept) :
57e0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
57f0: 2a 20 54 68 69 73 20 68 65 6c 70 65 72 20 72 6f * This helper ro
5800: 75 74 69 6e 65 20 74 6f 20 73 61 76 65 41 6c 6c utine to saveAll
5810: 43 75 72 73 6f 72 73 20 64 6f 65 73 20 74 68 65 Cursors does the
5820: 20 61 63 74 75 61 6c 20 77 6f 72 6b 20 6f 66 20 actual work of
5830: 73 61 76 69 6e 67 0a 2a 2a 20 74 68 65 20 63 75 saving.** the cu
5840: 72 73 6f 72 73 20 69 66 20 61 6e 64 20 77 68 65 rsors if and whe
5850: 6e 20 61 20 63 75 72 73 6f 72 20 69 73 20 66 6f n a cursor is fo
5860: 75 6e 64 20 74 68 61 74 20 61 63 74 75 61 6c 6c und that actuall
5870: 79 20 72 65 71 75 69 72 65 73 20 73 61 76 69 6e y requires savin
5880: 67 2e 0a 2a 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e g..** The common
5890: 20 63 61 73 65 20 69 73 20 74 68 61 74 20 6e 6f case is that no
58a0: 20 63 75 72 73 6f 72 73 20 6e 65 65 64 20 74 6f cursors need to
58b0: 20 62 65 20 73 61 76 65 64 2c 20 73 6f 20 74 68 be saved, so th
58c0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 0a 2a 2a is routine is.**
58d0: 20 62 72 6f 6b 65 6e 20 6f 75 74 20 66 72 6f 6d broken out from
58e0: 20 69 74 73 20 63 61 6c 6c 65 72 20 74 6f 20 61 its caller to a
58f0: 76 6f 69 64 20 75 6e 6e 65 63 65 73 73 61 72 79 void unnecessary
5900: 20 73 74 61 63 6b 20 70 6f 69 6e 74 65 72 20 6d stack pointer m
5910: 6f 76 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 ovement..*/.stat
5920: 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f 4e 4f ic int SQLITE_NO
5930: 49 4e 4c 49 4e 45 20 73 61 76 65 43 75 72 73 6f INLINE saveCurso
5940: 72 73 4f 6e 4c 69 73 74 28 0a 20 20 42 74 43 75 rsOnList(. BtCu
5950: 72 73 6f 72 20 2a 70 2c 20 20 20 20 20 20 20 20 rsor *p,
5960: 20 2f 2a 20 54 68 65 20 66 69 72 73 74 20 63 75 /* The first cu
5970: 72 73 6f 72 20 74 68 61 74 20 6e 65 65 64 73 20 rsor that needs
5980: 73 61 76 69 6e 67 20 2a 2f 0a 20 20 50 67 6e 6f saving */. Pgno
5990: 20 69 52 6f 6f 74 2c 20 20 20 20 20 20 20 20 20 iRoot,
59a0: 20 2f 2a 20 4f 6e 6c 79 20 73 61 76 65 20 63 75 /* Only save cu
59b0: 72 73 6f 72 20 77 69 74 68 20 74 68 69 73 20 69 rsor with this i
59c0: 52 6f 6f 74 2e 20 53 61 76 65 20 61 6c 6c 20 69 Root. Save all i
59d0: 66 20 7a 65 72 6f 20 2a 2f 0a 20 20 42 74 43 75 f zero */. BtCu
59e0: 72 73 6f 72 20 2a 70 45 78 63 65 70 74 20 20 20 rsor *pExcept
59f0: 20 2f 2a 20 44 6f 20 6e 6f 74 20 73 61 76 65 20 /* Do not save
5a00: 74 68 69 73 20 63 75 72 73 6f 72 20 2a 2f 0a 29 this cursor */.)
5a10: 7b 0a 20 20 64 6f 7b 0a 20 20 20 20 69 66 28 20 {. do{. if(
5a20: 70 21 3d 70 45 78 63 65 70 74 20 26 26 20 28 30 p!=pExcept && (0
5a30: 3d 3d 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e 70 67 ==iRoot || p->pg
5a40: 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 20 29 noRoot==iRoot) )
5a50: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 {. if( p->e
5a60: 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
5a70: 4c 49 44 20 29 7b 0a 20 20 20 20 20 20 20 20 69 LID ){. i
5a80: 6e 74 20 72 63 20 3d 20 73 61 76 65 43 75 72 73 nt rc = saveCurs
5a90: 6f 72 50 6f 73 69 74 69 6f 6e 28 70 29 3b 0a 20 orPosition(p);.
5aa0: 20 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 if( SQLIT
5ab0: 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 E_OK!=rc ){.
5ac0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
5ad0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
5ae0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
5af0: 74 65 73 74 63 61 73 65 28 20 70 2d 3e 69 50 61 testcase( p->iPa
5b00: 67 65 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 ge>0 );.
5b10: 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c 43 btreeReleaseAllC
5b20: 75 72 73 6f 72 50 61 67 65 73 28 70 29 3b 0a 20 ursorPages(p);.
5b30: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
5b40: 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 p = p->pNext;.
5b50: 20 7d 77 68 69 6c 65 28 20 70 20 29 3b 0a 20 20 }while( p );.
5b60: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
5b70: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 ;.}../*.** Clear
5b80: 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 72 the current cur
5b90: 73 6f 72 20 70 6f 73 69 74 69 6f 6e 2e 0a 2a 2f sor position..*/
5ba0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 .void sqlite3Btr
5bb0: 65 65 43 6c 65 61 72 43 75 72 73 6f 72 28 42 74 eeClearCursor(Bt
5bc0: 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
5bd0: 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
5be0: 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
5bf0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 );. sqlite3_fre
5c00: 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 e(pCur->pKey);.
5c10: 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 30 3b pCur->pKey = 0;
5c20: 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 . pCur->eState
5c30: 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
5c40: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 20 74 68 ;.}../*.** In th
5c50: 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 42 74 is version of Bt
5c60: 72 65 65 4d 6f 76 65 74 6f 2c 20 70 4b 65 79 20 reeMoveto, pKey
5c70: 69 73 20 61 20 70 61 63 6b 65 64 20 69 6e 64 65 is a packed inde
5c80: 78 20 72 65 63 6f 72 64 0a 2a 2a 20 73 75 63 68 x record.** such
5c90: 20 61 73 20 69 73 20 67 65 6e 65 72 61 74 65 64 as is generated
5ca0: 20 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 by the OP_MakeR
5cb0: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 20 20 55 ecord opcode. U
5cc0: 6e 70 61 63 6b 20 74 68 65 0a 2a 2a 20 72 65 63 npack the.** rec
5cd0: 6f 72 64 20 61 6e 64 20 74 68 65 6e 20 63 61 6c ord and then cal
5ce0: 6c 20 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 l BtreeMovetoUnp
5cf0: 61 63 6b 65 64 28 29 20 74 6f 20 64 6f 20 74 68 acked() to do th
5d00: 65 20 77 6f 72 6b 2e 0a 2a 2f 0a 73 74 61 74 69 e work..*/.stati
5d10: 63 20 69 6e 74 20 62 74 72 65 65 4d 6f 76 65 74 c int btreeMovet
5d20: 6f 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 o(. BtCursor *p
5d30: 43 75 72 2c 20 20 20 20 20 2f 2a 20 43 75 72 73 Cur, /* Curs
5d40: 6f 72 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 62 or open on the b
5d50: 74 72 65 65 20 74 6f 20 62 65 20 73 65 61 72 63 tree to be searc
5d60: 68 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 hed */. const v
5d70: 6f 69 64 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 oid *pKey, /*
5d80: 50 61 63 6b 65 64 20 6b 65 79 20 69 66 20 74 68 Packed key if th
5d90: 65 20 62 74 72 65 65 20 69 73 20 61 6e 20 69 6e e btree is an in
5da0: 64 65 78 20 2a 2f 0a 20 20 69 36 34 20 6e 4b 65 dex */. i64 nKe
5db0: 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 y, /*
5dc0: 49 6e 74 65 67 65 72 20 6b 65 79 20 66 6f 72 20 Integer key for
5dd0: 74 61 62 6c 65 73 2e 20 20 53 69 7a 65 20 6f 66 tables. Size of
5de0: 20 70 4b 65 79 20 66 6f 72 20 69 6e 64 69 63 65 pKey for indice
5df0: 73 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 2c s */. int bias,
5e00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 69 /* Bi
5e10: 61 73 20 73 65 61 72 63 68 20 74 6f 20 74 68 65 as search to the
5e20: 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 high end */. i
5e30: 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20 nt *pRes
5e40: 20 20 20 2f 2a 20 57 72 69 74 65 20 73 65 61 72 /* Write sear
5e50: 63 68 20 72 65 73 75 6c 74 73 20 68 65 72 65 20 ch results here
5e60: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 */.){. int rc;
5e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5e80: 20 20 20 2f 2a 20 53 74 61 74 75 73 20 63 6f 64 /* Status cod
5e90: 65 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 e */. UnpackedR
5ea0: 65 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 3b 20 ecord *pIdxKey;
5eb0: 20 20 2f 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e /* Unpacked in
5ec0: 64 65 78 20 6b 65 79 20 2a 2f 0a 20 20 63 68 61 dex key */. cha
5ed0: 72 20 61 53 70 61 63 65 5b 32 30 30 5d 3b 20 20 r aSpace[200];
5ee0: 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 /* Temp
5ef0: 73 70 61 63 65 20 66 6f 72 20 70 49 64 78 4b 65 space for pIdxKe
5f00: 79 20 2d 20 74 6f 20 61 76 6f 69 64 20 61 20 6d y - to avoid a m
5f10: 61 6c 6c 6f 63 20 2a 2f 0a 20 20 63 68 61 72 20 alloc */. char
5f20: 2a 70 46 72 65 65 20 3d 20 30 3b 0a 0a 20 20 69 *pFree = 0;.. i
5f30: 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 61 f( pKey ){. a
5f40: 73 73 65 72 74 28 20 6e 4b 65 79 3d 3d 28 69 36 ssert( nKey==(i6
5f50: 34 29 28 69 6e 74 29 6e 4b 65 79 20 29 3b 0a 20 4)(int)nKey );.
5f60: 20 20 20 70 49 64 78 4b 65 79 20 3d 20 73 71 6c pIdxKey = sql
5f70: 69 74 65 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 ite3VdbeAllocUnp
5f80: 61 63 6b 65 64 52 65 63 6f 72 64 28 0a 20 20 20 ackedRecord(.
5f90: 20 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 pCur->pKeyI
5fa0: 6e 66 6f 2c 20 61 53 70 61 63 65 2c 20 73 69 7a nfo, aSpace, siz
5fb0: 65 6f 66 28 61 53 70 61 63 65 29 2c 20 26 70 46 eof(aSpace), &pF
5fc0: 72 65 65 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 ree. );. i
5fd0: 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 20 29 20 f( pIdxKey==0 )
5fe0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
5ff0: 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 MEM;. sqlite3
6000: 56 64 62 65 52 65 63 6f 72 64 55 6e 70 61 63 6b VdbeRecordUnpack
6010: 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c (pCur->pKeyInfo,
6020: 20 28 69 6e 74 29 6e 4b 65 79 2c 20 70 4b 65 79 (int)nKey, pKey
6030: 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 , pIdxKey);.
6040: 69 66 28 20 70 49 64 78 4b 65 79 2d 3e 6e 46 69 if( pIdxKey->nFi
6050: 65 6c 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 eld==0 ){.
6060: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 70 43 sqlite3DbFree(pC
6070: 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2d 3e 64 62 ur->pKeyInfo->db
6080: 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 20 20 20 , pFree);.
6090: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
60a0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
60b0: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 }. }else{. p
60c0: 49 64 78 4b 65 79 20 3d 20 30 3b 0a 20 20 7d 0a IdxKey = 0;. }.
60d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 rc = sqlite3Bt
60e0: 72 65 65 4d 6f 76 65 74 6f 55 6e 70 61 63 6b 65 reeMovetoUnpacke
60f0: 64 28 70 43 75 72 2c 20 70 49 64 78 4b 65 79 2c d(pCur, pIdxKey,
6100: 20 6e 4b 65 79 2c 20 62 69 61 73 2c 20 70 52 65 nKey, bias, pRe
6110: 73 29 3b 0a 20 20 69 66 28 20 70 46 72 65 65 20 s);. if( pFree
6120: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 ){. sqlite3Db
6130: 46 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 49 Free(pCur->pKeyI
6140: 6e 66 6f 2d 3e 64 62 2c 20 70 46 72 65 65 29 3b nfo->db, pFree);
6150: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
6160: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 74 6f ;.}../*.** Resto
6170: 72 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f re the cursor to
6180: 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 20 69 74 the position it
6190: 20 77 61 73 20 69 6e 20 28 6f 72 20 61 73 20 63 was in (or as c
61a0: 6c 6f 73 65 20 74 6f 20 61 73 20 70 6f 73 73 69 lose to as possi
61b0: 62 6c 65 29 0a 2a 2a 20 77 68 65 6e 20 73 61 76 ble).** when sav
61c0: 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
61d0: 29 20 77 61 73 20 63 61 6c 6c 65 64 2e 20 4e 6f ) was called. No
61e0: 74 65 20 74 68 61 74 20 74 68 69 73 20 63 61 6c te that this cal
61f0: 6c 20 64 65 6c 65 74 65 73 20 74 68 65 20 0a 2a l deletes the .*
6200: 2a 20 73 61 76 65 64 20 70 6f 73 69 74 69 6f 6e * saved position
6210: 20 69 6e 66 6f 20 73 74 6f 72 65 64 20 62 79 20 info stored by
6220: 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 saveCursorPositi
6230: 6f 6e 28 29 2c 20 73 6f 20 74 68 65 72 65 20 63 on(), so there c
6240: 61 6e 20 62 65 0a 2a 2a 20 61 74 20 6d 6f 73 74 an be.** at most
6250: 20 6f 6e 65 20 65 66 66 65 63 74 69 76 65 20 72 one effective r
6260: 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 estoreCursorPosi
6270: 74 69 6f 6e 28 29 20 63 61 6c 6c 20 61 66 74 65 tion() call afte
6280: 72 20 65 61 63 68 20 0a 2a 2a 20 73 61 76 65 43 r each .** saveC
6290: 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2e ursorPosition().
62a0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 .*/.static int b
62b0: 74 72 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f treeRestoreCurso
62c0: 72 50 6f 73 69 74 69 6f 6e 28 42 74 43 75 72 73 rPosition(BtCurs
62d0: 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 or *pCur){. int
62e0: 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 63 rc;. assert( c
62f0: 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
6300: 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
6310: 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3e t( pCur->eState>
6320: 3d 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 =CURSOR_REQUIRES
6330: 45 45 4b 20 29 3b 0a 20 20 69 66 28 20 70 43 75 EEK );. if( pCu
6340: 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
6350: 52 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 20 72 R_FAULT ){. r
6360: 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 eturn pCur->skip
6370: 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 70 43 75 72 Next;. }. pCur
6380: 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f ->eState = CURSO
6390: 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 72 63 20 R_INVALID;. rc
63a0: 3d 20 62 74 72 65 65 4d 6f 76 65 74 6f 28 70 43 = btreeMoveto(pC
63b0: 75 72 2c 20 70 43 75 72 2d 3e 70 4b 65 79 2c 20 ur, pCur->pKey,
63c0: 70 43 75 72 2d 3e 6e 4b 65 79 2c 20 30 2c 20 26 pCur->nKey, 0, &
63d0: 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 29 3b pCur->skipNext);
63e0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
63f0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
6400: 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 te3_free(pCur->p
6410: 4b 65 79 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e Key);. pCur->
6420: 70 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 pKey = 0;. as
6430: 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
6440: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
6450: 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 || pCur->eState
6460: 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
6470: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 43 75 72 );. if( pCur
6480: 2d 3e 73 6b 69 70 4e 65 78 74 20 26 26 20 70 43 ->skipNext && pC
6490: 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
64a0: 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 OR_VALID ){.
64b0: 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
64c0: 20 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 CURSOR_SKIPNEXT
64d0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
64e0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 64 65 66 turn rc;.}..#def
64f0: 69 6e 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f ine restoreCurso
6500: 72 50 6f 73 69 74 69 6f 6e 28 70 29 20 5c 0a 20 rPosition(p) \.
6510: 20 28 70 2d 3e 65 53 74 61 74 65 3e 3d 43 55 52 (p->eState>=CUR
6520: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 SOR_REQUIRESEEK
6530: 3f 20 5c 0a 20 20 20 20 20 20 20 20 20 62 74 72 ? \. btr
6540: 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 eeRestoreCursorP
6550: 6f 73 69 74 69 6f 6e 28 70 29 20 3a 20 5c 0a 20 osition(p) : \.
6560: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
6570: 4b 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d K)../*.** Determ
6580: 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e ine whether or n
6590: 6f 74 20 61 20 63 75 72 73 6f 72 20 68 61 73 20 ot a cursor has
65a0: 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 moved from the p
65b0: 6f 73 69 74 69 6f 6e 20 77 68 65 72 65 0a 2a 2a osition where.**
65c0: 20 69 74 20 77 61 73 20 6c 61 73 74 20 70 6c 61 it was last pla
65d0: 63 65 64 2c 20 6f 72 20 68 61 73 20 62 65 65 6e ced, or has been
65e0: 20 69 6e 76 61 6c 69 64 61 74 65 64 20 66 6f 72 invalidated for
65f0: 20 61 6e 79 20 6f 74 68 65 72 20 72 65 61 73 6f any other reaso
6600: 6e 2e 0a 2a 2a 20 43 75 72 73 6f 72 73 20 63 61 n..** Cursors ca
6610: 6e 20 6d 6f 76 65 20 77 68 65 6e 20 74 68 65 20 n move when the
6620: 72 6f 77 20 74 68 65 79 20 61 72 65 20 70 6f 69 row they are poi
6630: 6e 74 69 6e 67 20 61 74 20 69 73 20 64 65 6c 65 nting at is dele
6640: 74 65 64 20 6f 75 74 0a 2a 2a 20 66 72 6f 6d 20 ted out.** from
6650: 75 6e 64 65 72 20 74 68 65 6d 2c 20 66 6f 72 20 under them, for
6660: 65 78 61 6d 70 6c 65 2e 20 20 43 75 72 73 6f 72 example. Cursor
6670: 20 6d 69 67 68 74 20 61 6c 73 6f 20 6d 6f 76 65 might also move
6680: 20 69 66 20 61 20 62 74 72 65 65 0a 2a 2a 20 69 if a btree.** i
6690: 73 20 72 65 62 61 6c 61 6e 63 65 64 2e 0a 2a 2a s rebalanced..**
66a0: 0a 2a 2a 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 .** Calling this
66b0: 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 61 20 routine with a
66c0: 4e 55 4c 4c 20 63 75 72 73 6f 72 20 70 6f 69 6e NULL cursor poin
66d0: 74 65 72 20 72 65 74 75 72 6e 73 20 66 61 6c 73 ter returns fals
66e0: 65 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65 e..**.** Use the
66f0: 20 73 65 70 61 72 61 74 65 20 73 71 6c 69 74 65 separate sqlite
6700: 33 42 74 72 65 65 43 75 72 73 6f 72 52 65 73 74 3BtreeCursorRest
6710: 6f 72 65 28 29 20 72 6f 75 74 69 6e 65 20 74 6f ore() routine to
6720: 20 72 65 73 74 6f 72 65 20 61 20 63 75 72 73 6f restore a curso
6730: 72 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 77 68 65 r.** back to whe
6740: 72 65 20 69 74 20 6f 75 67 68 74 20 74 6f 20 62 re it ought to b
6750: 65 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e e if this routin
6760: 65 20 72 65 74 75 72 6e 73 20 74 72 75 65 2e 0a e returns true..
6770: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
6780: 72 65 65 43 75 72 73 6f 72 48 61 73 4d 6f 76 65 reeCursorHasMove
6790: 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 d(BtCursor *pCur
67a0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 ){. return pCur
67b0: 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
67c0: 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a _VALID;.}../*.**
67d0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 This routine re
67e0: 73 74 6f 72 65 73 20 61 20 63 75 72 73 6f 72 20 stores a cursor
67f0: 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 back to its orig
6800: 69 6e 61 6c 20 70 6f 73 69 74 69 6f 6e 20 61 66 inal position af
6810: 74 65 72 20 69 74 0a 2a 2a 20 68 61 73 20 62 65 ter it.** has be
6820: 65 6e 20 6d 6f 76 65 64 20 62 79 20 73 6f 6d 65 en moved by some
6830: 20 6f 75 74 73 69 64 65 20 61 63 74 69 76 69 74 outside activit
6840: 79 20 28 73 75 63 68 20 61 73 20 61 20 62 74 72 y (such as a btr
6850: 65 65 20 72 65 62 61 6c 61 6e 63 65 20 6f 72 0a ee rebalance or.
6860: 2a 2a 20 61 20 72 6f 77 20 68 61 76 69 6e 67 20 ** a row having
6870: 62 65 65 6e 20 64 65 6c 65 74 65 64 20 6f 75 74 been deleted out
6880: 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 20 from under the
6890: 63 75 72 73 6f 72 29 2e 20 20 0a 2a 2a 0a 2a 2a cursor). .**.**
68a0: 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 65 On success, the
68b0: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
68c0: 70 61 72 61 6d 65 74 65 72 20 69 73 20 66 61 6c parameter is fal
68d0: 73 65 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 se if the cursor
68e0: 20 69 73 20 6c 65 66 74 0a 2a 2a 20 70 6f 69 6e is left.** poin
68f0: 74 69 6e 67 20 61 74 20 65 78 61 63 74 6c 79 20 ting at exactly
6900: 74 68 65 20 73 61 6d 65 20 72 6f 77 2e 20 20 2a the same row. *
6910: 70 44 69 66 66 65 72 6e 74 52 6f 77 20 69 73 20 pDifferntRow is
6920: 74 68 65 20 72 6f 77 20 74 68 65 20 63 75 72 73 the row the curs
6930: 6f 72 0a 2a 2a 20 77 61 73 20 70 6f 69 6e 74 69 or.** was pointi
6940: 6e 67 20 74 6f 20 68 61 73 20 62 65 65 6e 20 64 ng to has been d
6950: 65 6c 65 74 65 64 2c 20 66 6f 72 63 69 6e 67 20 eleted, forcing
6960: 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f the cursor to po
6970: 69 6e 74 20 74 6f 20 73 6f 6d 65 0a 2a 2a 20 6e int to some.** n
6980: 65 61 72 62 79 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a earby row..**.**
6990: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 This routine sh
69a0: 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c ould only be cal
69b0: 6c 65 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 led for a cursor
69c0: 20 74 68 61 74 20 6a 75 73 74 20 72 65 74 75 72 that just retur
69d0: 6e 65 64 0a 2a 2a 20 54 52 55 45 20 66 72 6f 6d ned.** TRUE from
69e0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 sqlite3BtreeCur
69f0: 73 6f 72 48 61 73 4d 6f 76 65 64 28 29 2e 0a 2a sorHasMoved()..*
6a00: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
6a10: 65 65 43 75 72 73 6f 72 52 65 73 74 6f 72 65 28 eeCursorRestore(
6a20: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
6a30: 69 6e 74 20 2a 70 44 69 66 66 65 72 65 6e 74 52 int *pDifferentR
6a40: 6f 77 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a ow){. int rc;..
6a50: 20 20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d assert( pCur!=
6a60: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
6a70: 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
6a80: 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 72 SOR_VALID );. r
6a90: 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f c = restoreCurso
6aa0: 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b rPosition(pCur);
6ab0: 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 . if( rc ){.
6ac0: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
6ad0: 3d 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 = 1;. return
6ae0: 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 rc;. }. if( pC
6af0: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
6b00: 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 4e 45 56 45 OR_VALID || NEVE
6b10: 52 28 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 R(pCur->skipNext
6b20: 21 3d 30 29 20 29 7b 0a 20 20 20 20 2a 70 44 69 !=0) ){. *pDi
6b30: 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a fferentRow = 1;.
6b40: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 44 }else{. *pD
6b50: 69 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 30 3b ifferentRow = 0;
6b60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
6b70: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e LITE_OK;.}..#ifn
6b80: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
6b90: 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a AUTOVACUUM./*.**
6ba0: 20 47 69 76 65 6e 20 61 20 70 61 67 65 20 6e 75 Given a page nu
6bb0: 6d 62 65 72 20 6f 66 20 61 20 72 65 67 75 6c 61 mber of a regula
6bc0: 72 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2c r database page,
6bd0: 20 72 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 return the page
6be0: 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 .** number for t
6bf0: 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 he pointer-map p
6c00: 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e age that contain
6c10: 73 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 s the entry for
6c20: 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 70 61 67 the.** input pag
6c30: 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 e number..**.**
6c40: 52 65 74 75 72 6e 20 30 20 28 6e 6f 74 20 61 20 Return 0 (not a
6c50: 76 61 6c 69 64 20 70 61 67 65 29 20 66 6f 72 20 valid page) for
6c60: 70 67 6e 6f 3d 3d 31 20 73 69 6e 63 65 20 74 68 pgno==1 since th
6c70: 65 72 65 20 69 73 0a 2a 2a 20 6e 6f 20 70 6f 69 ere is.** no poi
6c80: 6e 74 65 72 20 6d 61 70 20 61 73 73 6f 63 69 61 nter map associa
6c90: 74 65 64 20 77 69 74 68 20 70 61 67 65 20 31 2e ted with page 1.
6ca0: 20 20 54 68 65 20 69 6e 74 65 67 72 69 74 79 5f The integrity_
6cb0: 63 68 65 63 6b 20 6c 6f 67 69 63 0a 2a 2a 20 72 check logic.** r
6cc0: 65 71 75 69 72 65 73 20 74 68 61 74 20 70 74 72 equires that ptr
6cd0: 6d 61 70 50 61 67 65 6e 6f 28 2a 2c 31 29 21 3d mapPageno(*,1)!=
6ce0: 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 1..*/.static Pgn
6cf0: 6f 20 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 42 o ptrmapPageno(B
6d00: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
6d10: 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 no pgno){. int
6d20: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
6d30: 3b 0a 20 20 50 67 6e 6f 20 69 50 74 72 4d 61 70 ;. Pgno iPtrMap
6d40: 2c 20 72 65 74 3b 0a 20 20 61 73 73 65 72 74 28 , ret;. assert(
6d50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
6d60: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
6d70: 29 3b 0a 20 20 69 66 28 20 70 67 6e 6f 3c 32 20 );. if( pgno<2
6d80: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 6e 50 ) return 0;. nP
6d90: 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 20 3d agesPerMapPage =
6da0: 20 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a (pBt->usableSiz
6db0: 65 2f 35 29 2b 31 3b 0a 20 20 69 50 74 72 4d 61 e/5)+1;. iPtrMa
6dc0: 70 20 3d 20 28 70 67 6e 6f 2d 32 29 2f 6e 50 61 p = (pgno-2)/nPa
6dd0: 67 65 73 50 65 72 4d 61 70 50 61 67 65 3b 0a 20 gesPerMapPage;.
6de0: 20 72 65 74 20 3d 20 28 69 50 74 72 4d 61 70 2a ret = (iPtrMap*
6df0: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
6e00: 29 20 2b 20 32 3b 20 0a 20 20 69 66 28 20 72 65 ) + 2; . if( re
6e10: 74 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f t==PENDING_BYTE_
6e20: 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
6e30: 20 72 65 74 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 ret++;. }. re
6e40: 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a 0a turn ret;.}../*.
6e50: 2a 2a 20 57 72 69 74 65 20 61 6e 20 65 6e 74 72 ** Write an entr
6e60: 79 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 y into the point
6e70: 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 er map..**.** Th
6e80: 69 73 20 72 6f 75 74 69 6e 65 20 75 70 64 61 74 is routine updat
6e90: 65 73 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d es the pointer m
6ea0: 61 70 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 ap entry for pag
6eb0: 65 20 6e 75 6d 62 65 72 20 27 6b 65 79 27 0a 2a e number 'key'.*
6ec0: 2a 20 73 6f 20 74 68 61 74 20 69 74 20 6d 61 70 * so that it map
6ed0: 73 20 74 6f 20 74 79 70 65 20 27 65 54 79 70 65 s to type 'eType
6ee0: 27 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 67 ' and parent pag
6ef0: 65 20 6e 75 6d 62 65 72 20 27 70 67 6e 6f 27 2e e number 'pgno'.
6f00: 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 52 43 20 69 .**.** If *pRC i
6f10: 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e 6f 6e 2d s initially non-
6f20: 7a 65 72 6f 20 28 6e 6f 6e 2d 53 51 4c 49 54 45 zero (non-SQLITE
6f30: 5f 4f 4b 29 20 74 68 65 6e 20 74 68 69 73 20 72 _OK) then this r
6f40: 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 61 20 6e outine is.** a n
6f50: 6f 2d 6f 70 2e 20 20 49 66 20 61 6e 20 65 72 72 o-op. If an err
6f60: 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 20 61 or occurs, the a
6f70: 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f 72 ppropriate error
6f80: 20 63 6f 64 65 20 69 73 20 77 72 69 74 74 65 6e code is written
6f90: 0a 2a 2a 20 69 6e 74 6f 20 2a 70 52 43 2e 0a 2a .** into *pRC..*
6fa0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 74 /.static void pt
6fb0: 72 6d 61 70 50 75 74 28 42 74 53 68 61 72 65 64 rmapPut(BtShared
6fc0: 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 2c *pBt, Pgno key,
6fd0: 20 75 38 20 65 54 79 70 65 2c 20 50 67 6e 6f 20 u8 eType, Pgno
6fe0: 70 61 72 65 6e 74 2c 20 69 6e 74 20 2a 70 52 43 parent, int *pRC
6ff0: 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 ){. DbPage *pDb
7000: 50 61 67 65 3b 20 20 2f 2a 20 54 68 65 20 70 6f Page; /* The po
7010: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 2a inter map page *
7020: 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d 61 70 3b /. u8 *pPtrmap;
7030: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 /* The poi
7040: 6e 74 65 72 20 6d 61 70 20 64 61 74 61 20 2a 2f nter map data */
7050: 0a 20 20 50 67 6e 6f 20 69 50 74 72 6d 61 70 3b . Pgno iPtrmap;
7060: 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e /* The poin
7070: 74 65 72 20 6d 61 70 20 70 61 67 65 20 6e 75 6d ter map page num
7080: 62 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 ber */. int off
7090: 73 65 74 3b 20 20 20 20 20 20 20 2f 2a 20 4f 66 set; /* Of
70a0: 66 73 65 74 20 69 6e 20 70 6f 69 6e 74 65 72 20 fset in pointer
70b0: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
70c0: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
70d0: 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 66 /* Return code f
70e0: 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 rom subfunctions
70f0: 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 */.. if( *pRC
7100: 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 73 ) return;.. ass
7110: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
7120: 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
7130: 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 68 65 20 ex) );. /* The
7140: 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 master-journal p
7150: 61 67 65 20 6e 75 6d 62 65 72 20 6d 75 73 74 20 age number must
7160: 6e 65 76 65 72 20 62 65 20 75 73 65 64 20 61 73 never be used as
7170: 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 a pointer map p
7180: 61 67 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 age */. assert(
7190: 20 30 3d 3d 50 54 52 4d 41 50 5f 49 53 50 41 47 0==PTRMAP_ISPAG
71a0: 45 28 70 42 74 2c 20 50 45 4e 44 49 4e 47 5f 42 E(pBt, PENDING_B
71b0: 59 54 45 5f 50 41 47 45 28 70 42 74 29 29 20 29 YTE_PAGE(pBt)) )
71c0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 ;.. assert( pBt
71d0: 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a ->autoVacuum );.
71e0: 20 20 69 66 28 20 6b 65 79 3d 3d 30 20 29 7b 0a if( key==0 ){.
71f0: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
7200: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
7210: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a return;. }.
7220: 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 4d iPtrmap = PTRM
7230: 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 6b AP_PAGENO(pBt, k
7240: 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ey);. rc = sqli
7250: 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d te3PagerGet(pBt-
7260: 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 70 >pPager, iPtrmap
7270: 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 20 69 , &pDbPage);. i
7280: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
7290: 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 72 ){. *pRC = r
72a0: 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 c;. return;.
72b0: 20 7d 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 }. offset = PT
72c0: 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 RMAP_PTROFFSET(i
72d0: 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 Ptrmap, key);.
72e0: 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a if( offset<0 ){.
72f0: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
7300: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
7310: 20 20 20 20 67 6f 74 6f 20 70 74 72 6d 61 70 5f goto ptrmap_
7320: 65 78 69 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 exit;. }. asse
7330: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
7340: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
7350: 7a 65 2d 35 20 29 3b 0a 20 20 70 50 74 72 6d 61 ze-5 );. pPtrma
7360: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
7370: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
7380: 62 50 61 67 65 29 3b 0a 0a 20 20 69 66 28 20 65 bPage);.. if( e
7390: 54 79 70 65 21 3d 70 50 74 72 6d 61 70 5b 6f 66 Type!=pPtrmap[of
73a0: 66 73 65 74 5d 20 7c 7c 20 67 65 74 34 62 79 74 fset] || get4byt
73b0: 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 e(&pPtrmap[offse
73c0: 74 2b 31 5d 29 21 3d 70 61 72 65 6e 74 20 29 7b t+1])!=parent ){
73d0: 0a 20 20 20 20 54 52 41 43 45 28 28 22 50 54 52 . TRACE(("PTR
73e0: 4d 41 50 5f 55 50 44 41 54 45 3a 20 25 64 2d 3e MAP_UPDATE: %d->
73f0: 28 25 64 2c 25 64 29 5c 6e 22 2c 20 6b 65 79 2c (%d,%d)\n", key,
7400: 20 65 54 79 70 65 2c 20 70 61 72 65 6e 74 29 29 eType, parent))
7410: 3b 0a 20 20 20 20 2a 70 52 43 3d 20 72 63 20 3d ;. *pRC= rc =
7420: 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
7430: 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
7440: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
7450: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 74 72 OK ){. pPtr
7460: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 3d 20 65 54 map[offset] = eT
7470: 79 70 65 3b 0a 20 20 20 20 20 20 70 75 74 34 62 ype;. put4b
7480: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
7490: 73 65 74 2b 31 5d 2c 20 70 61 72 65 6e 74 29 3b set+1], parent);
74a0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 70 74 72 6d . }. }..ptrm
74b0: 61 70 5f 65 78 69 74 3a 0a 20 20 73 71 6c 69 74 ap_exit:. sqlit
74c0: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
74d0: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
74e0: 52 65 61 64 20 61 6e 20 65 6e 74 72 79 20 66 72 Read an entry fr
74f0: 6f 6d 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d om the pointer m
7500: 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ap..**.** This r
7510: 6f 75 74 69 6e 65 20 72 65 74 72 69 65 76 65 73 outine retrieves
7520: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
7530: 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 entry for page
7540: 27 6b 65 79 27 2c 20 77 72 69 74 69 6e 67 0a 2a 'key', writing.*
7550: 2a 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 70 * the type and p
7560: 61 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 arent page numbe
7570: 72 20 74 6f 20 2a 70 45 54 79 70 65 20 61 6e 64 r to *pEType and
7580: 20 2a 70 50 67 6e 6f 20 72 65 73 70 65 63 74 69 *pPgno respecti
7590: 76 65 6c 79 2e 0a 2a 2a 20 41 6e 20 65 72 72 6f vely..** An erro
75a0: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
75b0: 65 64 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 ed if something
75c0: 67 6f 65 73 20 77 72 6f 6e 67 2c 20 6f 74 68 65 goes wrong, othe
75d0: 72 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b 2e rwise SQLITE_OK.
75e0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
75f0: 74 72 6d 61 70 47 65 74 28 42 74 53 68 61 72 65 trmapGet(BtShare
7600: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 d *pBt, Pgno key
7610: 2c 20 75 38 20 2a 70 45 54 79 70 65 2c 20 50 67 , u8 *pEType, Pg
7620: 6e 6f 20 2a 70 50 67 6e 6f 29 7b 0a 20 20 44 62 no *pPgno){. Db
7630: 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 Page *pDbPage;
7640: 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
7650: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
7660: 74 20 69 50 74 72 6d 61 70 3b 20 20 20 20 20 20 t iPtrmap;
7670: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
7680: 70 61 67 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 page index */.
7690: 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 20 u8 *pPtrmap;
76a0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 /* Pointer ma
76b0: 70 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 p page data */.
76c0: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
76d0: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
76e0: 20 65 6e 74 72 79 20 69 6e 20 70 6f 69 6e 74 65 entry in pointe
76f0: 72 20 6d 61 70 20 2a 2f 0a 20 20 69 6e 74 20 72 r map */. int r
7700: 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 c;.. assert( sq
7710: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
7720: 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
7730: 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 . iPtrmap = PTR
7740: 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
7750: 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c key);. rc = sql
7760: 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 ite3PagerGet(pBt
7770: 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 ->pPager, iPtrma
7780: 70 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 20 p, &pDbPage);.
7790: 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20 20 20 if( rc!=0 ){.
77a0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
77b0: 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 pPtrmap = (u8
77c0: 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 *)sqlite3PagerGe
77d0: 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a tData(pDbPage);.
77e0: 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 52 4d . offset = PTRM
77f0: 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 50 74 AP_PTROFFSET(iPt
7800: 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 69 66 rmap, key);. if
7810: 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a 20 20 ( offset<0 ){.
7820: 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e sqlite3PagerUn
7830: 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 20 20 ref(pDbPage);.
7840: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
7850: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
7860: 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 }. assert( offs
7870: 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e et <= (int)pBt->
7880: 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a usableSize-5 );.
7890: 20 20 61 73 73 65 72 74 28 20 70 45 54 79 70 65 assert( pEType
78a0: 21 3d 30 20 29 3b 0a 20 20 2a 70 45 54 79 70 65 !=0 );. *pEType
78b0: 20 3d 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 = pPtrmap[offse
78c0: 74 5d 3b 0a 20 20 69 66 28 20 70 50 67 6e 6f 20 t];. if( pPgno
78d0: 29 20 2a 70 50 67 6e 6f 20 3d 20 67 65 74 34 62 ) *pPgno = get4b
78e0: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
78f0: 73 65 74 2b 31 5d 29 3b 0a 0a 20 20 73 71 6c 69 set+1]);.. sqli
7900: 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 te3PagerUnref(pD
7910: 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 2a 70 bPage);. if( *p
7920: 45 54 79 70 65 3c 31 20 7c 7c 20 2a 70 45 54 79 EType<1 || *pETy
7930: 70 65 3e 35 20 29 20 72 65 74 75 72 6e 20 53 51 pe>5 ) return SQ
7940: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
7950: 54 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 T;. return SQLI
7960: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6c 73 65 20 TE_OK;.}..#else
7970: 2f 2a 20 69 66 20 64 65 66 69 6e 65 64 20 53 51 /* if defined SQ
7980: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
7990: 43 55 55 4d 20 2a 2f 0a 20 20 23 64 65 66 69 6e CUUM */. #defin
79a0: 65 20 70 74 72 6d 61 70 50 75 74 28 77 2c 78 2c e ptrmapPut(w,x,
79b0: 79 2c 7a 2c 72 63 29 0a 20 20 23 64 65 66 69 6e y,z,rc). #defin
79c0: 65 20 70 74 72 6d 61 70 47 65 74 28 77 2c 78 2c e ptrmapGet(w,x,
79d0: 79 2c 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 y,z) SQLITE_OK.
79e0: 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 50 #define ptrmapP
79f0: 75 74 4f 76 66 6c 50 74 72 28 78 2c 20 79 2c 20 utOvflPtr(x, y,
7a00: 72 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a rc).#endif../*.*
7a10: 2a 20 47 69 76 65 6e 20 61 20 62 74 72 65 65 20 * Given a btree
7a20: 70 61 67 65 20 61 6e 64 20 61 20 63 65 6c 6c 20 page and a cell
7a30: 69 6e 64 65 78 20 28 30 20 6d 65 61 6e 73 20 74 index (0 means t
7a40: 68 65 20 66 69 72 73 74 20 63 65 6c 6c 20 6f 6e he first cell on
7a50: 0a 2a 2a 20 74 68 65 20 70 61 67 65 2c 20 31 20 .** the page, 1
7a60: 6d 65 61 6e 73 20 74 68 65 20 73 65 63 6f 6e 64 means the second
7a70: 20 63 65 6c 6c 2c 20 61 6e 64 20 73 6f 20 66 6f cell, and so fo
7a80: 72 74 68 29 20 72 65 74 75 72 6e 20 61 20 70 6f rth) return a po
7a90: 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 inter.** to the
7aa0: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e 0a 2a 2a cell content..**
7ab0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
7ac0: 20 77 6f 72 6b 73 20 6f 6e 6c 79 20 66 6f 72 20 works only for
7ad0: 70 61 67 65 73 20 74 68 61 74 20 64 6f 20 6e 6f pages that do no
7ae0: 74 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 66 6c t contain overfl
7af0: 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 23 64 65 ow cells..*/.#de
7b00: 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c 28 50 2c fine findCell(P,
7b10: 49 29 20 5c 0a 20 20 28 28 50 29 2d 3e 61 44 61 I) \. ((P)->aDa
7b20: 74 61 20 2b 20 28 28 50 29 2d 3e 6d 61 73 6b 50 ta + ((P)->maskP
7b30: 61 67 65 20 26 20 67 65 74 32 62 79 74 65 28 26 age & get2byte(&
7b40: 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a (P)->aCellIdx[2*
7b50: 28 49 29 5d 29 29 29 0a 23 64 65 66 69 6e 65 20 (I)]))).#define
7b60: 66 69 6e 64 43 65 6c 6c 76 32 28 44 2c 4d 2c 4f findCellv2(D,M,O
7b70: 2c 49 29 20 28 44 2b 28 4d 26 67 65 74 32 62 79 ,I) (D+(M&get2by
7b80: 74 65 28 44 2b 28 4f 2b 32 2a 28 49 29 29 29 29 te(D+(O+2*(I))))
7b90: 29 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 61 ).../*.** This a
7ba0: 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 76 65 more complex ve
7bb0: 72 73 69 6f 6e 20 6f 66 20 66 69 6e 64 43 65 6c rsion of findCel
7bc0: 6c 28 29 20 74 68 61 74 20 77 6f 72 6b 73 20 66 l() that works f
7bd0: 6f 72 0a 2a 2a 20 70 61 67 65 73 20 74 68 61 74 or.** pages that
7be0: 20 64 6f 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 do contain over
7bf0: 66 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 73 flow cells..*/.s
7c00: 74 61 74 69 63 20 75 38 20 2a 66 69 6e 64 4f 76 tatic u8 *findOv
7c10: 65 72 66 6c 6f 77 43 65 6c 6c 28 4d 65 6d 50 61 erflowCell(MemPa
7c20: 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 ge *pPage, int i
7c30: 43 65 6c 6c 29 7b 0a 20 20 69 6e 74 20 69 3b 0a Cell){. int i;.
7c40: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
7c50: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
7c60: 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
7c70: 29 3b 0a 20 20 66 6f 72 28 69 3d 70 50 61 67 65 );. for(i=pPage
7c80: 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2d 31 3b 20 69 ->nOverflow-1; i
7c90: 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 69 >=0; i--){. i
7ca0: 6e 74 20 6b 3b 0a 20 20 20 20 6b 20 3d 20 70 50 nt k;. k = pP
7cb0: 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 69 5d 3b 0a age->aiOvfl[i];.
7cc0: 20 20 20 20 69 66 28 20 6b 3c 3d 69 43 65 6c 6c if( k<=iCell
7cd0: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6b 3d ){. if( k=
7ce0: 3d 69 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 =iCell ){.
7cf0: 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 2d 3e return pPage->
7d00: 61 70 4f 76 66 6c 5b 69 5d 3b 0a 20 20 20 20 20 apOvfl[i];.
7d10: 20 7d 0a 20 20 20 20 20 20 69 43 65 6c 6c 2d 2d }. iCell--
7d20: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
7d30: 74 75 72 6e 20 66 69 6e 64 43 65 6c 6c 28 70 50 turn findCell(pP
7d40: 61 67 65 2c 20 69 43 65 6c 6c 29 3b 0a 7d 0a 0a age, iCell);.}..
7d50: 2f 2a 0a 2a 2a 20 50 61 72 73 65 20 61 20 63 65 /*.** Parse a ce
7d60: 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 6c 6f 63 6b ll content block
7d70: 20 61 6e 64 20 66 69 6c 6c 20 69 6e 20 74 68 65 and fill in the
7d80: 20 43 65 6c 6c 49 6e 66 6f 20 73 74 72 75 63 74 CellInfo struct
7d90: 75 72 65 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 ure. There.** a
7da0: 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73 20 re two versions
7db0: 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e of this function
7dc0: 2e 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c . btreeParseCel
7dd0: 6c 28 29 20 74 61 6b 65 73 20 61 20 0a 2a 2a 20 l() takes a .**
7de0: 63 65 6c 6c 20 69 6e 64 65 78 20 61 73 20 74 68 cell index as th
7df0: 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
7e00: 74 20 61 6e 64 20 62 74 72 65 65 50 61 72 73 65 t and btreeParse
7e10: 43 65 6c 6c 50 74 72 28 29 20 0a 2a 2a 20 74 61 CellPtr() .** ta
7e20: 6b 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f kes a pointer to
7e30: 20 74 68 65 20 62 6f 64 79 20 6f 66 20 74 68 65 the body of the
7e40: 20 63 65 6c 6c 20 61 73 20 69 74 73 20 73 65 63 cell as its sec
7e50: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f ond argument..*/
7e60: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 .static void btr
7e70: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 0a eeParseCellPtr(.
7e80: 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
7e90: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 , /* Pag
7ea0: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
7eb0: 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 cell */. u8 *p
7ec0: 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Cell,
7ed0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
7ee0: 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 the cell text.
7ef0: 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 */. CellInfo *p
7f00: 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 Info /*
7f10: 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 Fill in this str
7f20: 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 ucture */.){. u
7f30: 38 20 2a 70 49 74 65 72 3b 20 20 20 20 20 20 20 8 *pIter;
7f40: 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 73 63 /* For sc
7f50: 61 6e 6e 69 6e 67 20 74 68 72 6f 75 67 68 20 70 anning through p
7f60: 43 65 6c 6c 20 2a 2f 0a 20 20 75 33 32 20 6e 50 Cell */. u32 nP
7f70: 61 79 6c 6f 61 64 3b 20 20 20 20 20 20 20 20 20 ayload;
7f80: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 /* Number of b
7f90: 79 74 65 73 20 6f 66 20 63 65 6c 6c 20 70 61 79 ytes of cell pay
7fa0: 6c 6f 61 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 load */.. asser
7fb0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
7fc0: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
7fd0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
7fe0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 sert( pPage->lea
7ff0: 66 3d 3d 30 20 7c 7c 20 70 50 61 67 65 2d 3e 6c f==0 || pPage->l
8000: 65 61 66 3d 3d 31 20 29 3b 0a 20 20 69 66 28 20 eaf==1 );. if(
8010: 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 pPage->intKeyLea
8020: 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 f ){. assert(
8030: 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
8040: 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 70 Size==0 );. p
8050: 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b 20 67 Iter = pCell + g
8060: 65 74 56 61 72 69 6e 74 33 32 28 70 43 65 6c 6c etVarint32(pCell
8070: 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 , nPayload);.
8080: 20 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 72 pIter += getVar
8090: 69 6e 74 28 70 49 74 65 72 2c 20 28 75 36 34 2a int(pIter, (u64*
80a0: 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a )&pInfo->nKey);.
80b0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 50 61 67 }else if( pPag
80c0: 65 2d 3e 6e 6f 50 61 79 6c 6f 61 64 20 29 7b 0a e->noPayload ){.
80d0: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
80e0: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
80f0: 3d 34 20 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d =4 );. pInfo-
8100: 3e 6e 53 69 7a 65 20 3d 20 34 20 2b 20 67 65 74 >nSize = 4 + get
8110: 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 34 5d Varint(&pCell[4]
8120: 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d 3e , (u64*)&pInfo->
8130: 6e 4b 65 79 29 3b 0a 20 20 20 20 70 49 6e 66 6f nKey);. pInfo
8140: 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 30 3b 0a ->nPayload = 0;.
8150: 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 pInfo->nLoca
8160: 6c 20 3d 20 30 3b 0a 20 20 20 20 70 49 6e 66 6f l = 0;. pInfo
8170: 2d 3e 69 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b ->iOverflow = 0;
8180: 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 . pInfo->pPay
8190: 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 20 20 72 65 load = 0;. re
81a0: 74 75 72 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 turn;. }else{.
81b0: 20 20 20 70 49 74 65 72 20 3d 20 70 43 65 6c 6c pIter = pCell
81c0: 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 + pPage->childP
81d0: 74 72 53 69 7a 65 3b 0a 20 20 20 20 70 49 74 65 trSize;. pIte
81e0: 72 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 32 r += getVarint32
81f0: 28 70 49 74 65 72 2c 20 6e 50 61 79 6c 6f 61 64 (pIter, nPayload
8200: 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4b );. pInfo->nK
8210: 65 79 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 ey = nPayload;.
8220: 20 7d 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 }. pInfo->nPay
8230: 6c 6f 61 64 20 3d 20 6e 50 61 79 6c 6f 61 64 3b load = nPayload;
8240: 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f . pInfo->pPaylo
8250: 61 64 20 3d 20 70 49 74 65 72 3b 0a 20 20 74 65 ad = pIter;. te
8260: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
8270: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
8280: 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 l );. testcase(
8290: 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 nPayload==pPage
82a0: 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a ->maxLocal+1 );.
82b0: 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d if( nPayload<=
82c0: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
82d0: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 ){. /* This i
82e0: 73 20 74 68 65 20 28 65 61 73 79 29 20 63 6f 6d s the (easy) com
82f0: 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 mon case where t
8300: 68 65 20 65 6e 74 69 72 65 20 70 61 79 6c 6f 61 he entire payloa
8310: 64 20 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f 6e d fits. ** on
8320: 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2e the local page.
8330: 20 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 73 No overflow is
8340: 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 2a required.. *
8350: 2f 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 /. pInfo->nSi
8360: 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 64 20 2b 20 ze = nPayload +
8370: 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 (u16)(pIter - pC
8380: 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 70 49 ell);. if( pI
8390: 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 20 29 20 70 nfo->nSize<4 ) p
83a0: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 3b Info->nSize = 4;
83b0: 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 . pInfo->nLoc
83c0: 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 79 6c 6f al = (u16)nPaylo
83d0: 61 64 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 69 ad;. pInfo->i
83e0: 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 Overflow = 0;.
83f0: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 }else{. /* If
8400: 20 74 68 65 20 70 61 79 6c 6f 61 64 20 77 69 6c the payload wil
8410: 6c 20 6e 6f 74 20 66 69 74 20 63 6f 6d 70 6c 65 l not fit comple
8420: 74 65 6c 79 20 6f 6e 20 74 68 65 20 6c 6f 63 61 tely on the loca
8430: 6c 20 70 61 67 65 2c 20 77 65 20 68 61 76 65 0a l page, we have.
8440: 20 20 20 20 2a 2a 20 74 6f 20 64 65 63 69 64 65 ** to decide
8450: 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 74 6f how much to sto
8460: 72 65 20 6c 6f 63 61 6c 6c 79 20 61 6e 64 20 68 re locally and h
8470: 6f 77 20 6d 75 63 68 20 74 6f 20 73 70 69 6c 6c ow much to spill
8480: 20 6f 6e 74 6f 0a 20 20 20 20 2a 2a 20 6f 76 65 onto. ** ove
8490: 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 68 rflow pages. Th
84a0: 65 20 73 74 72 61 74 65 67 79 20 69 73 20 74 6f e strategy is to
84b0: 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 20 61 6d minimize the am
84c0: 6f 75 6e 74 20 6f 66 20 75 6e 75 73 65 64 0a 20 ount of unused.
84d0: 20 20 20 2a 2a 20 73 70 61 63 65 20 6f 6e 20 6f ** space on o
84e0: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 77 68 verflow pages wh
84f0: 69 6c 65 20 6b 65 65 70 69 6e 67 20 74 68 65 20 ile keeping the
8500: 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 63 61 6c 20 amount of local
8510: 73 74 6f 72 61 67 65 0a 20 20 20 20 2a 2a 20 69 storage. ** i
8520: 6e 20 62 65 74 77 65 65 6e 20 6d 69 6e 4c 6f 63 n between minLoc
8530: 61 6c 20 61 6e 64 20 6d 61 78 4c 6f 63 61 6c 2e al and maxLocal.
8540: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 . **. ** W
8550: 61 72 6e 69 6e 67 3a 20 20 63 68 61 6e 67 69 6e arning: changin
8560: 67 20 74 68 65 20 77 61 79 20 6f 76 65 72 66 6c g the way overfl
8570: 6f 77 20 70 61 79 6c 6f 61 64 20 69 73 20 64 69 ow payload is di
8580: 73 74 72 69 62 75 74 65 64 20 69 6e 20 61 6e 79 stributed in any
8590: 0a 20 20 20 20 2a 2a 20 77 61 79 20 77 69 6c 6c . ** way will
85a0: 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 69 6e result in an in
85b0: 63 6f 6d 70 61 74 69 62 6c 65 20 66 69 6c 65 20 compatible file
85c0: 66 6f 72 6d 61 74 2e 0a 20 20 20 20 2a 2f 0a 20 format.. */.
85d0: 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 3b int minLocal;
85e0: 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 61 6d 6f /* Minimum amo
85f0: 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 unt of payload h
8600: 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 eld locally */.
8610: 20 20 20 69 6e 74 20 6d 61 78 4c 6f 63 61 6c 3b int maxLocal;
8620: 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f /* Maximum amo
8630: 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 unt of payload h
8640: 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 eld locally */.
8650: 20 20 20 69 6e 74 20 73 75 72 70 6c 75 73 3b 20 int surplus;
8660: 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 61 /* Overflow pa
8670: 79 6c 6f 61 64 20 61 76 61 69 6c 61 62 6c 65 20 yload available
8680: 66 6f 72 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 for local storag
8690: 65 20 2a 2f 0a 0a 20 20 20 20 6d 69 6e 4c 6f 63 e */.. minLoc
86a0: 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c al = pPage->minL
86b0: 6f 63 61 6c 3b 0a 20 20 20 20 6d 61 78 4c 6f 63 ocal;. maxLoc
86c0: 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 61 78 4c al = pPage->maxL
86d0: 6f 63 61 6c 3b 0a 20 20 20 20 73 75 72 70 6c 75 ocal;. surplu
86e0: 73 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 s = minLocal + (
86f0: 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c 6f nPayload - minLo
8700: 63 61 6c 29 25 28 70 50 61 67 65 2d 3e 70 42 74 cal)%(pPage->pBt
8710: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 ->usableSize - 4
8720: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
8730: 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 surplus==maxLoc
8740: 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 al );. testca
8750: 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 se( surplus==max
8760: 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 69 Local+1 );. i
8770: 66 28 20 73 75 72 70 6c 75 73 20 3c 3d 20 6d 61 f( surplus <= ma
8780: 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 xLocal ){.
8790: 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 pInfo->nLocal =
87a0: 28 75 31 36 29 73 75 72 70 6c 75 73 3b 0a 20 20 (u16)surplus;.
87b0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
87c0: 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 Info->nLocal = (
87d0: 75 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 u16)minLocal;.
87e0: 20 20 7d 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 69 }. pInfo->i
87f0: 4f 76 65 72 66 6c 6f 77 20 3d 20 28 75 31 36 29 Overflow = (u16)
8800: 28 26 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 (&pInfo->pPayloa
8810: 64 5b 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 5d d[pInfo->nLocal]
8820: 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 70 - pCell);. p
8830: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 70 49 Info->nSize = pI
8840: 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f 77 20 2b nfo->iOverflow +
8850: 20 34 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 4;. }.}.static
8860: 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 void btreeParse
8870: 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 Cell(. MemPage
8880: 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 *pPage,
8890: 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 /* Page containi
88a0: 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 ng the cell */.
88b0: 20 69 6e 74 20 69 43 65 6c 6c 2c 20 20 20 20 20 int iCell,
88c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
88d0: 63 65 6c 6c 20 69 6e 64 65 78 2e 20 20 46 69 72 cell index. Fir
88e0: 73 74 20 63 65 6c 6c 20 69 73 20 30 20 2a 2f 0a st cell is 0 */.
88f0: 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 CellInfo *pInf
8900: 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c o /* Fil
8910: 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 l in this struct
8920: 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 62 74 72 65 ure */.){. btre
8930: 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 eParseCellPtr(pP
8940: 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 50 age, findCell(pP
8950: 61 67 65 2c 20 69 43 65 6c 6c 29 2c 20 70 49 6e age, iCell), pIn
8960: 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f fo);.}../*.** Co
8970: 6d 70 75 74 65 20 74 68 65 20 74 6f 74 61 6c 20 mpute the total
8980: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
8990: 74 68 61 74 20 61 20 43 65 6c 6c 20 6e 65 65 64 that a Cell need
89a0: 73 20 69 6e 20 74 68 65 20 63 65 6c 6c 0a 2a 2a s in the cell.**
89b0: 20 64 61 74 61 20 61 72 65 61 20 6f 66 20 74 68 data area of th
89c0: 65 20 62 74 72 65 65 2d 70 61 67 65 2e 20 20 54 e btree-page. T
89d0: 68 65 20 72 65 74 75 72 6e 20 6e 75 6d 62 65 72 he return number
89e0: 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 63 65 includes the ce
89f0: 6c 6c 0a 2a 2a 20 64 61 74 61 20 68 65 61 64 65 ll.** data heade
8a00: 72 20 61 6e 64 20 74 68 65 20 6c 6f 63 61 6c 20 r and the local
8a10: 70 61 79 6c 6f 61 64 2c 20 62 75 74 20 6e 6f 74 payload, but not
8a20: 20 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 any overflow pa
8a30: 67 65 20 6f 72 0a 2a 2a 20 74 68 65 20 73 70 61 ge or.** the spa
8a40: 63 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 ce used by the c
8a50: 65 6c 6c 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a ell pointer..*/.
8a60: 73 74 61 74 69 63 20 75 31 36 20 63 65 6c 6c 53 static u16 cellS
8a70: 69 7a 65 50 74 72 28 4d 65 6d 50 61 67 65 20 2a izePtr(MemPage *
8a80: 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c pPage, u8 *pCell
8a90: 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 20 3d ){. u8 *pIter =
8aa0: 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 2d 3e pCell + pPage->
8ab0: 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 20 2f 2a childPtrSize; /*
8ac0: 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 For looping ove
8ad0: 72 20 62 79 74 65 73 20 6f 66 20 70 43 65 6c 6c r bytes of pCell
8ae0: 20 2a 2f 0a 20 20 75 38 20 2a 70 45 6e 64 3b 20 */. u8 *pEnd;
8af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8b10: 2a 20 45 6e 64 20 6d 61 72 6b 20 66 6f 72 20 61 * End mark for a
8b20: 20 76 61 72 69 6e 74 20 2a 2f 0a 20 20 75 33 32 varint */. u32
8b30: 20 6e 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 nSize;
8b40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b50: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 76 61 /* Size va
8b60: 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f lue to return */
8b70: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
8b80: 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 DEBUG. /* The v
8b90: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
8ba0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 this function s
8bb0: 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 hould always be
8bc0: 74 68 65 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a the same as. **
8bd0: 20 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e the (CellInfo.n
8be0: 53 69 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 6e Size) value foun
8bf0: 64 20 62 79 20 64 6f 69 6e 67 20 61 20 66 75 6c d by doing a ful
8c00: 6c 20 70 61 72 73 65 20 6f 66 20 74 68 65 0a 20 l parse of the.
8c10: 20 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c ** cell. If SQL
8c20: 49 54 45 5f 44 45 42 55 47 20 69 73 20 64 65 66 ITE_DEBUG is def
8c30: 69 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 ined, an assert(
8c40: 29 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 ) at the bottom
8c50: 6f 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 6e of. ** this fun
8c60: 63 74 69 6f 6e 20 76 65 72 69 66 69 65 73 20 74 ction verifies t
8c70: 68 61 74 20 74 68 69 73 20 69 6e 76 61 72 69 61 hat this invaria
8c80: 6e 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 nt is not violat
8c90: 65 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 ed. */. CellInf
8ca0: 6f 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 62 o debuginfo;. b
8cb0: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
8cc0: 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
8cd0: 64 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6e 64 debuginfo);.#end
8ce0: 69 66 0a 0a 20 20 69 66 28 20 70 50 61 67 65 2d if.. if( pPage-
8cf0: 3e 6e 6f 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 >noPayload ){.
8d00: 20 20 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b pEnd = &pIter[
8d10: 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 9];. while( (
8d20: 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 30 20 26 *pIter++)&0x80 &
8d30: 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a & pIter<pEnd );.
8d40: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
8d50: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
8d60: 3d 34 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e =4 );. return
8d70: 20 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 (u16)(pIter - p
8d80: 43 65 6c 6c 29 3b 0a 20 20 7d 0a 20 20 6e 53 69 Cell);. }. nSi
8d90: 7a 65 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 ze = *pIter;. i
8da0: 66 28 20 6e 53 69 7a 65 3e 3d 30 78 38 30 20 29 f( nSize>=0x80 )
8db0: 7b 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 {. pEnd = &pI
8dc0: 74 65 72 5b 39 5d 3b 0a 20 20 20 20 6e 53 69 7a ter[9];. nSiz
8dd0: 65 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 64 e &= 0x7f;. d
8de0: 6f 7b 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d o{. nSize =
8df0: 20 28 6e 53 69 7a 65 3c 3c 37 29 20 7c 20 28 2a (nSize<<7) | (*
8e00: 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b ++pIter & 0x7f);
8e10: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 . }while( *(p
8e20: 49 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 Iter)>=0x80 && p
8e30: 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d Iter<pEnd );. }
8e40: 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 20 20 69 66 . pIter++;. if
8e50: 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 ( pPage->intKey
8e60: 29 7b 0a 20 20 20 20 2f 2a 20 70 49 74 65 72 20 ){. /* pIter
8e70: 6e 6f 77 20 70 6f 69 6e 74 73 20 61 74 20 74 68 now points at th
8e80: 65 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 e 64-bit integer
8e90: 20 6b 65 79 20 76 61 6c 75 65 2c 20 61 20 76 61 key value, a va
8ea0: 72 69 61 62 6c 65 20 6c 65 6e 67 74 68 20 0a 20 riable length .
8eb0: 20 20 20 2a 2a 20 69 6e 74 65 67 65 72 2e 20 54 ** integer. T
8ec0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f he following blo
8ed0: 63 6b 20 6d 6f 76 65 73 20 70 49 74 65 72 20 74 ck moves pIter t
8ee0: 6f 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 66 o point at the f
8ef0: 69 72 73 74 20 62 79 74 65 0a 20 20 20 20 2a 2a irst byte. **
8f00: 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
8f10: 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 2e 20 the key value.
8f20: 2a 2f 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 */. pEnd = &p
8f30: 49 74 65 72 5b 39 5d 3b 0a 20 20 20 20 77 68 69 Iter[9];. whi
8f40: 6c 65 28 20 28 2a 70 49 74 65 72 2b 2b 29 26 30 le( (*pIter++)&0
8f50: 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e x80 && pIter<pEn
8f60: 64 20 29 3b 0a 20 20 7d 0a 20 20 74 65 73 74 63 d );. }. testc
8f70: 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 ase( nSize==pPag
8f80: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 e->maxLocal );.
8f90: 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 testcase( nSize
8fa0: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
8fb0: 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 53 69 l+1 );. if( nSi
8fc0: 7a 65 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f ze<=pPage->maxLo
8fd0: 63 61 6c 20 29 7b 0a 20 20 20 20 6e 53 69 7a 65 cal ){. nSize
8fe0: 20 2b 3d 20 28 75 33 32 29 28 70 49 74 65 72 20 += (u32)(pIter
8ff0: 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 - pCell);. if
9000: 28 20 6e 53 69 7a 65 3c 34 20 29 20 6e 53 69 7a ( nSize<4 ) nSiz
9010: 65 20 3d 20 34 3b 0a 20 20 7d 65 6c 73 65 7b 0a e = 4;. }else{.
9020: 20 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c int minLocal
9030: 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 = pPage->minLoc
9040: 61 6c 3b 0a 20 20 20 20 6e 53 69 7a 65 20 3d 20 al;. nSize =
9050: 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 6e 53 69 7a minLocal + (nSiz
9060: 65 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 20 25 20 e - minLocal) %
9070: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 (pPage->pBt->usa
9080: 62 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 bleSize - 4);.
9090: 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a testcase( nSiz
90a0: 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 e==pPage->maxLoc
90b0: 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 al );. testca
90c0: 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 se( nSize==pPage
90d0: 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a ->maxLocal+1 );.
90e0: 20 20 20 20 69 66 28 20 6e 53 69 7a 65 3e 70 50 if( nSize>pP
90f0: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b age->maxLocal ){
9100: 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d . nSize = m
9110: 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 inLocal;. }.
9120: 20 20 20 6e 53 69 7a 65 20 2b 3d 20 34 20 2b 20 nSize += 4 +
9130: 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 (u16)(pIter - pC
9140: 65 6c 6c 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 ell);. }. asse
9150: 72 74 28 20 6e 53 69 7a 65 3d 3d 64 65 62 75 67 rt( nSize==debug
9160: 69 6e 66 6f 2e 6e 53 69 7a 65 20 7c 7c 20 43 4f info.nSize || CO
9170: 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 72 65 RRUPT_DB );. re
9180: 74 75 72 6e 20 28 75 31 36 29 6e 53 69 7a 65 3b turn (u16)nSize;
9190: 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .}..#ifdef SQLIT
91a0: 45 5f 44 45 42 55 47 0a 2f 2a 20 54 68 69 73 20 E_DEBUG./* This
91b0: 76 61 72 69 61 74 69 6f 6e 20 6f 6e 20 63 65 6c variation on cel
91c0: 6c 53 69 7a 65 50 74 72 28 29 20 69 73 20 75 73 lSizePtr() is us
91d0: 65 64 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 ed inside of ass
91e0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
91f0: 0a 2a 2a 20 6f 6e 6c 79 2e 20 2a 2f 0a 73 74 61 .** only. */.sta
9200: 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 tic u16 cellSize
9210: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
9220: 20 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 20 72 int iCell){. r
9230: 65 74 75 72 6e 20 63 65 6c 6c 53 69 7a 65 50 74 eturn cellSizePt
9240: 72 28 70 50 61 67 65 2c 20 66 69 6e 64 43 65 6c r(pPage, findCel
9250: 6c 28 70 50 61 67 65 2c 20 69 43 65 6c 6c 29 29 l(pPage, iCell))
9260: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e ;.}.#endif..#ifn
9270: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
9280: 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a AUTOVACUUM./*.**
9290: 20 49 66 20 74 68 65 20 63 65 6c 6c 20 70 43 65 If the cell pCe
92a0: 6c 6c 2c 20 70 61 72 74 20 6f 66 20 70 61 67 65 ll, part of page
92b0: 20 70 50 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 pPage contains
92c0: 61 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 a pointer.** to
92d0: 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
92e0: 2c 20 69 6e 73 65 72 74 20 61 6e 20 65 6e 74 72 , insert an entr
92f0: 79 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 y into the point
9300: 65 72 2d 6d 61 70 0a 2a 2a 20 66 6f 72 20 74 68 er-map.** for th
9310: 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e e overflow page.
9320: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
9330: 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 ptrmapPutOvflPtr
9340: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
9350: 20 75 38 20 2a 70 43 65 6c 6c 2c 20 69 6e 74 20 u8 *pCell, int
9360: 2a 70 52 43 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 *pRC){. CellInf
9370: 6f 20 69 6e 66 6f 3b 0a 20 20 69 66 28 20 2a 70 o info;. if( *p
9380: 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 RC ) return;. a
9390: 73 73 65 72 74 28 20 70 43 65 6c 6c 21 3d 30 20 ssert( pCell!=0
93a0: 29 3b 0a 20 20 62 74 72 65 65 50 61 72 73 65 43 );. btreeParseC
93b0: 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 ellPtr(pPage, pC
93c0: 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 69 ell, &info);. i
93d0: 66 28 20 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f f( info.iOverflo
93e0: 77 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6f 76 w ){. Pgno ov
93f0: 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 fl = get4byte(&p
9400: 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 Cell[info.iOverf
9410: 6c 6f 77 5d 29 3b 0a 20 20 20 20 70 74 72 6d 61 low]);. ptrma
9420: 70 50 75 74 28 70 50 61 67 65 2d 3e 70 42 74 2c pPut(pPage->pBt,
9430: 20 6f 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 ovfl, PTRMAP_OV
9440: 45 52 46 4c 4f 57 31 2c 20 70 50 61 67 65 2d 3e ERFLOW1, pPage->
9450: 70 67 6e 6f 2c 20 70 52 43 29 3b 0a 20 20 7d 0a pgno, pRC);. }.
9460: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a }.#endif.../*.**
9470: 20 44 65 66 72 61 67 6d 65 6e 74 20 74 68 65 20 Defragment the
9480: 70 61 67 65 20 67 69 76 65 6e 2e 20 20 41 6c 6c page given. All
9490: 20 43 65 6c 6c 73 20 61 72 65 20 6d 6f 76 65 64 Cells are moved
94a0: 20 74 6f 20 74 68 65 0a 2a 2a 20 65 6e 64 20 6f to the.** end o
94b0: 66 20 74 68 65 20 70 61 67 65 20 61 6e 64 20 61 f the page and a
94c0: 6c 6c 20 66 72 65 65 20 73 70 61 63 65 20 69 73 ll free space is
94d0: 20 63 6f 6c 6c 65 63 74 65 64 20 69 6e 74 6f 20 collected into
94e0: 6f 6e 65 0a 2a 2a 20 62 69 67 20 46 72 65 65 42 one.** big FreeB
94f0: 6c 6b 20 74 68 61 74 20 6f 63 63 75 72 73 20 69 lk that occurs i
9500: 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 68 65 n between the he
9510: 61 64 65 72 20 61 6e 64 20 63 65 6c 6c 0a 2a 2a ader and cell.**
9520: 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 20 61 pointer array a
9530: 6e 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 nd the cell cont
9540: 65 6e 74 20 61 72 65 61 2e 0a 2a 2f 0a 73 74 61 ent area..*/.sta
9550: 74 69 63 20 69 6e 74 20 64 65 66 72 61 67 6d 65 tic int defragme
9560: 6e 74 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a ntPage(MemPage *
9570: 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 69 3b pPage){. int i;
9580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9590: 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 /* Loop cou
95a0: 6e 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 70 63 nter */. int pc
95b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
95c0: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
95d0: 6f 66 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c of the i-th cell
95e0: 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 */. int hdr;
95f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9600: 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 68 /* Offset to th
9610: 65 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f e page header */
9620: 0a 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 20 20 . int size;
9630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9640: 20 53 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 Size of a cell
9650: 2a 2f 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 53 */. int usableS
9660: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ize;
9670: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 61 /* Number of usa
9680: 62 6c 65 20 62 79 74 65 73 20 6f 6e 20 61 20 70 ble bytes on a p
9690: 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 63 65 6c age */. int cel
96a0: 6c 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 lOffset;
96b0: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f /* Offset to
96c0: 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 the cell pointe
96d0: 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 69 6e 74 r array */. int
96e0: 20 63 62 72 6b 3b 20 20 20 20 20 20 20 20 20 20 cbrk;
96f0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
9700: 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f t to the cell co
9710: 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 ntent area */.
9720: 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 20 20 int nCell;
9730: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
9740: 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 6f 6e mber of cells on
9750: 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 the page */. u
9760: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 nsigned char *da
9770: 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ta; /* The
9780: 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 20 page data */.
9790: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 74 unsigned char *t
97a0: 65 6d 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 65 emp; /* Te
97b0: 6d 70 20 61 72 65 61 20 66 6f 72 20 63 65 6c 6c mp area for cell
97c0: 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 75 6e content */. un
97d0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 73 72 63 signed char *src
97e0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 6f 75 72 ; /* Sour
97f0: 63 65 20 6f 66 20 63 6f 6e 74 65 6e 74 20 2a 2f ce of content */
9800: 0a 20 20 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 . int iCellFirs
9810: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t; /*
9820: 20 46 69 72 73 74 20 61 6c 6c 6f 77 61 62 6c 65 First allowable
9830: 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 20 cell index */.
9840: 20 69 6e 74 20 69 43 65 6c 6c 4c 61 73 74 3b 20 int iCellLast;
9850: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c /* L
9860: 61 73 74 20 70 6f 73 73 69 62 6c 65 20 63 65 6c ast possible cel
9870: 6c 20 69 6e 64 65 78 20 2a 2f 0a 0a 0a 20 20 61 l index */... a
9880: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
9890: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
98a0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
98b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
98c0: 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 61 e->pBt!=0 );. a
98d0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 ssert( pPage->pB
98e0: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3c 3d t->usableSize <=
98f0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 SQLITE_MAX_PAGE
9900: 5f 53 49 5a 45 20 29 3b 0a 20 20 61 73 73 65 72 _SIZE );. asser
9910: 74 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 t( pPage->nOverf
9920: 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 low==0 );. asse
9930: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
9940: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
9950: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 74 t->mutex) );. t
9960: 65 6d 70 20 3d 20 30 3b 0a 20 20 73 72 63 20 3d emp = 0;. src =
9970: 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 data = pPage->a
9980: 44 61 74 61 3b 0a 20 20 68 64 72 20 3d 20 70 50 Data;. hdr = pP
9990: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
99a0: 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 70 cellOffset = p
99b0: 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 Page->cellOffset
99c0: 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 ;. nCell = pPag
99d0: 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 61 73 73 65 e->nCell;. asse
99e0: 72 74 28 20 6e 43 65 6c 6c 3d 3d 67 65 74 32 62 rt( nCell==get2b
99f0: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d yte(&data[hdr+3]
9a00: 29 20 29 3b 0a 20 20 75 73 61 62 6c 65 53 69 7a ) );. usableSiz
9a10: 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e e = pPage->pBt->
9a20: 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 63 62 usableSize;. cb
9a30: 72 6b 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b rk = usableSize;
9a40: 0a 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d 20 . iCellFirst =
9a50: 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 6e cellOffset + 2*n
9a60: 43 65 6c 6c 3b 0a 20 20 69 43 65 6c 6c 4c 61 73 Cell;. iCellLas
9a70: 74 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 20 2d t = usableSize -
9a80: 20 34 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 4;. for(i=0; i
9a90: 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 <nCell; i++){.
9aa0: 20 20 75 38 20 2a 70 41 64 64 72 3b 20 20 20 20 u8 *pAddr;
9ab0: 20 2f 2a 20 54 68 65 20 69 2d 74 68 20 63 65 6c /* The i-th cel
9ac0: 6c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 l pointer */.
9ad0: 20 70 41 64 64 72 20 3d 20 26 64 61 74 61 5b 63 pAddr = &data[c
9ae0: 65 6c 6c 4f 66 66 73 65 74 20 2b 20 69 2a 32 5d ellOffset + i*2]
9af0: 3b 0a 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 ;. pc = get2b
9b00: 79 74 65 28 70 41 64 64 72 29 3b 0a 20 20 20 20 yte(pAddr);.
9b10: 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 testcase( pc==iC
9b20: 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 20 20 ellFirst );.
9b30: 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 testcase( pc==iC
9b40: 65 6c 6c 4c 61 73 74 20 29 3b 0a 23 69 66 20 21 ellLast );.#if !
9b50: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
9b60: 4e 41 42 4c 45 5f 4f 56 45 52 53 49 5a 45 5f 43 NABLE_OVERSIZE_C
9b70: 45 4c 4c 5f 43 48 45 43 4b 29 0a 20 20 20 20 2f ELL_CHECK). /
9b80: 2a 20 54 68 65 73 65 20 63 6f 6e 64 69 74 69 6f * These conditio
9b90: 6e 73 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 ns have already
9ba0: 62 65 65 6e 20 76 65 72 69 66 69 65 64 20 69 6e been verified in
9bb0: 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 btreeInitPage()
9bc0: 0a 20 20 20 20 2a 2a 20 69 66 20 53 51 4c 49 54 . ** if SQLIT
9bd0: 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 5a E_ENABLE_OVERSIZ
9be0: 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 20 69 73 20 E_CELL_CHECK is
9bf0: 64 65 66 69 6e 65 64 20 0a 20 20 20 20 2a 2f 0a defined . */.
9c00: 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c if( pc<iCell
9c10: 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c First || pc>iCel
9c20: 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 72 lLast ){. r
9c30: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
9c40: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
9c50: 0a 23 65 6e 64 69 66 0a 20 20 20 20 61 73 73 65 .#endif. asse
9c60: 72 74 28 20 70 63 3e 3d 69 43 65 6c 6c 46 69 72 rt( pc>=iCellFir
9c70: 73 74 20 26 26 20 70 63 3c 3d 69 43 65 6c 6c 4c st && pc<=iCellL
9c80: 61 73 74 20 29 3b 0a 20 20 20 20 73 69 7a 65 20 ast );. size
9c90: 3d 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 = cellSizePtr(pP
9ca0: 61 67 65 2c 20 26 73 72 63 5b 70 63 5d 29 3b 0a age, &src[pc]);.
9cb0: 20 20 20 20 63 62 72 6b 20 2d 3d 20 73 69 7a 65 cbrk -= size
9cc0: 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 ;.#if defined(SQ
9cd0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 LITE_ENABLE_OVER
9ce0: 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 SIZE_CELL_CHECK)
9cf0: 0a 20 20 20 20 69 66 28 20 63 62 72 6b 3c 69 43 . if( cbrk<iC
9d00: 65 6c 6c 46 69 72 73 74 20 29 7b 0a 20 20 20 20 ellFirst ){.
9d10: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
9d20: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
9d30: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 69 66 }.#else. if
9d40: 28 20 63 62 72 6b 3c 69 43 65 6c 6c 46 69 72 73 ( cbrk<iCellFirs
9d50: 74 20 7c 7c 20 70 63 2b 73 69 7a 65 3e 75 73 61 t || pc+size>usa
9d60: 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 bleSize ){.
9d70: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
9d80: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
9d90: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 61 73 }.#endif. as
9da0: 73 65 72 74 28 20 63 62 72 6b 2b 73 69 7a 65 3c sert( cbrk+size<
9db0: 3d 75 73 61 62 6c 65 53 69 7a 65 20 26 26 20 63 =usableSize && c
9dc0: 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 brk>=iCellFirst
9dd0: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
9de0: 20 63 62 72 6b 2b 73 69 7a 65 3d 3d 75 73 61 62 cbrk+size==usab
9df0: 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 74 65 leSize );. te
9e00: 73 74 63 61 73 65 28 20 70 63 2b 73 69 7a 65 3d stcase( pc+size=
9e10: 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 =usableSize );.
9e20: 20 20 20 70 75 74 32 62 79 74 65 28 70 41 64 64 put2byte(pAdd
9e30: 72 2c 20 63 62 72 6b 29 3b 0a 20 20 20 20 69 66 r, cbrk);. if
9e40: 28 20 74 65 6d 70 3d 3d 30 20 29 7b 0a 20 20 20 ( temp==0 ){.
9e50: 20 20 20 69 6e 74 20 78 3b 0a 20 20 20 20 20 20 int x;.
9e60: 69 66 28 20 63 62 72 6b 3d 3d 70 63 20 29 20 63 if( cbrk==pc ) c
9e70: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 74 ontinue;. t
9e80: 65 6d 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 emp = sqlite3Pag
9e90: 65 72 54 65 6d 70 53 70 61 63 65 28 70 50 61 67 erTempSpace(pPag
9ea0: 65 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 29 3b e->pBt->pPager);
9eb0: 0a 20 20 20 20 20 20 78 20 3d 20 67 65 74 32 62 . x = get2b
9ec0: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
9ed0: 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 );. memcpy(
9ee0: 26 74 65 6d 70 5b 78 5d 2c 20 26 64 61 74 61 5b &temp[x], &data[
9ef0: 78 5d 2c 20 28 63 62 72 6b 2b 73 69 7a 65 29 20 x], (cbrk+size)
9f00: 2d 20 78 29 3b 0a 20 20 20 20 20 20 73 72 63 20 - x);. src
9f10: 3d 20 74 65 6d 70 3b 0a 20 20 20 20 7d 0a 20 20 = temp;. }.
9f20: 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b 63 memcpy(&data[c
9f30: 62 72 6b 5d 2c 20 26 73 72 63 5b 70 63 5d 2c 20 brk], &src[pc],
9f40: 73 69 7a 65 29 3b 0a 20 20 7d 0a 20 20 61 73 73 size);. }. ass
9f50: 65 72 74 28 20 63 62 72 6b 3e 3d 69 43 65 6c 6c ert( cbrk>=iCell
9f60: 46 69 72 73 74 20 29 3b 0a 20 20 70 75 74 32 62 First );. put2b
9f70: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
9f80: 2c 20 63 62 72 6b 29 3b 0a 20 20 64 61 74 61 5b , cbrk);. data[
9f90: 68 64 72 2b 31 5d 20 3d 20 30 3b 0a 20 20 64 61 hdr+1] = 0;. da
9fa0: 74 61 5b 68 64 72 2b 32 5d 20 3d 20 30 3b 0a 20 ta[hdr+2] = 0;.
9fb0: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 data[hdr+7] = 0
9fc0: 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 ;. memset(&data
9fd0: 5b 69 43 65 6c 6c 46 69 72 73 74 5d 2c 20 30 2c [iCellFirst], 0,
9fe0: 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 72 73 74 cbrk-iCellFirst
9ff0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
a000: 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 ite3PagerIswrite
a010: 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 able(pPage->pDbP
a020: 61 67 65 29 20 29 3b 0a 20 20 69 66 28 20 63 62 age) );. if( cb
a030: 72 6b 2d 69 43 65 6c 6c 46 69 72 73 74 21 3d 70 rk-iCellFirst!=p
a040: 50 61 67 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 Page->nFree ){.
a050: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a060: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
a070: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
a080: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
a090: 53 65 61 72 63 68 20 74 68 65 20 66 72 65 65 2d Search the free-
a0a0: 6c 69 73 74 20 6f 6e 20 70 61 67 65 20 70 50 67 list on page pPg
a0b0: 20 66 6f 72 20 73 70 61 63 65 20 74 6f 20 73 74 for space to st
a0c0: 6f 72 65 20 61 20 63 65 6c 6c 20 6e 42 79 74 65 ore a cell nByte
a0d0: 20 62 79 74 65 73 20 69 6e 0a 2a 2a 20 73 69 7a bytes in.** siz
a0e0: 65 2e 20 49 66 20 6f 6e 65 20 63 61 6e 20 62 65 e. If one can be
a0f0: 20 66 6f 75 6e 64 2c 20 72 65 74 75 72 6e 20 61 found, return a
a100: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
a110: 73 70 61 63 65 20 61 6e 64 20 72 65 6d 6f 76 65 space and remove
a120: 20 69 74 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 it.** from the
a130: 66 72 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a free-list..**.**
a140: 20 49 66 20 6e 6f 20 73 75 69 74 61 62 6c 65 20 If no suitable
a150: 73 70 61 63 65 20 63 61 6e 20 62 65 20 66 6f 75 space can be fou
a160: 6e 64 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c nd on the free-l
a170: 69 73 74 2c 20 72 65 74 75 72 6e 20 4e 55 4c 4c ist, return NULL
a180: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
a190: 63 74 69 6f 6e 20 6d 61 79 20 64 65 74 65 63 74 ction may detect
a1a0: 20 63 6f 72 72 75 70 74 69 6f 6e 20 77 69 74 68 corruption with
a1b0: 69 6e 20 70 50 67 2e 20 49 66 20 69 74 20 64 6f in pPg. If it do
a1c0: 65 73 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 20 es and argument
a1d0: 0a 2a 2a 20 70 52 63 20 69 73 20 6e 6f 6e 2d 4e .** pRc is non-N
a1e0: 55 4c 4c 2c 20 74 68 65 6e 20 2a 70 52 63 20 69 ULL, then *pRc i
a1f0: 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f s set to SQLITE_
a200: 43 4f 52 52 55 50 54 20 61 6e 64 20 4e 55 4c 4c CORRUPT and NULL
a210: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a is returned..**
a220: 20 4f 72 2c 20 69 66 20 63 6f 72 72 75 70 74 69 Or, if corrupti
a230: 6f 6e 20 69 73 20 64 65 74 65 63 74 65 64 20 61 on is detected a
a240: 6e 64 20 70 52 63 20 69 73 20 4e 55 4c 4c 2c 20 nd pRc is NULL,
a250: 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 NULL is returned
a260: 20 61 6e 64 20 74 68 65 0a 2a 2a 20 63 6f 72 72 and the.** corr
a270: 75 70 74 69 6f 6e 20 67 6f 65 73 20 75 6e 72 65 uption goes unre
a280: 70 6f 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 ported..**.** If
a290: 20 61 20 73 6c 6f 74 20 6f 66 20 61 74 20 6c 65 a slot of at le
a2a0: 61 73 74 20 6e 42 79 74 65 20 62 79 74 65 73 20 ast nByte bytes
a2b0: 69 73 20 66 6f 75 6e 64 20 62 75 74 20 63 61 6e is found but can
a2c0: 6e 6f 74 20 62 65 20 75 73 65 64 20 62 65 63 61 not be used beca
a2d0: 75 73 65 20 0a 2a 2a 20 74 68 65 72 65 20 61 72 use .** there ar
a2e0: 65 20 61 6c 72 65 61 64 79 20 61 74 20 6c 65 61 e already at lea
a2f0: 73 74 20 36 30 20 66 72 61 67 6d 65 6e 74 65 64 st 60 fragmented
a300: 20 62 79 74 65 73 20 6f 6e 20 74 68 65 20 70 61 bytes on the pa
a310: 67 65 2c 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e ge, return NULL.
a320: 0a 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 .** In this case
a330: 2c 20 69 66 20 70 62 44 65 66 72 61 67 20 70 61 , if pbDefrag pa
a340: 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 4e rameter is not N
a350: 55 4c 4c 2c 20 73 65 74 20 2a 70 62 44 65 66 72 ULL, set *pbDefr
a360: 61 67 20 74 6f 20 74 72 75 65 2e 0a 2a 2f 0a 73 ag to true..*/.s
a370: 74 61 74 69 63 20 75 38 20 2a 70 61 67 65 46 69 tatic u8 *pageFi
a380: 6e 64 53 6c 6f 74 28 4d 65 6d 50 61 67 65 20 2a ndSlot(MemPage *
a390: 70 50 67 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 pPg, int nByte,
a3a0: 69 6e 74 20 2a 70 52 63 2c 20 69 6e 74 20 2a 70 int *pRc, int *p
a3b0: 62 44 65 66 72 61 67 29 7b 0a 20 20 63 6f 6e 73 bDefrag){. cons
a3c0: 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 67 2d t int hdr = pPg-
a3d0: 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 75 38 >hdrOffset;. u8
a3e0: 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 61 20 3d * const aData =
a3f0: 20 70 50 67 2d 3e 61 44 61 74 61 3b 0a 20 20 69 pPg->aData;. i
a400: 6e 74 20 69 41 64 64 72 3b 0a 20 20 69 6e 74 20 nt iAddr;. int
a410: 70 63 3b 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 pc;. int usable
a420: 53 69 7a 65 20 3d 20 70 50 67 2d 3e 70 42 74 2d Size = pPg->pBt-
a430: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 0a 20 20 >usableSize;..
a440: 66 6f 72 28 69 41 64 64 72 3d 68 64 72 2b 31 3b for(iAddr=hdr+1;
a450: 20 28 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 (pc = get2byte(
a460: 26 61 44 61 74 61 5b 69 41 64 64 72 5d 29 29 3e &aData[iAddr]))>
a470: 30 3b 20 69 41 64 64 72 3d 70 63 29 7b 0a 20 20 0; iAddr=pc){.
a480: 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 int size;
a490: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
a4a0: 66 20 74 68 65 20 66 72 65 65 20 73 6c 6f 74 20 f the free slot
a4b0: 2a 2f 0a 20 20 20 20 69 66 28 20 70 63 3e 75 73 */. if( pc>us
a4c0: 61 62 6c 65 53 69 7a 65 2d 34 20 7c 7c 20 70 63 ableSize-4 || pc
a4d0: 3c 69 41 64 64 72 2b 34 20 29 7b 0a 20 20 20 20 <iAddr+4 ){.
a4e0: 20 20 69 66 28 20 70 52 63 20 29 20 2a 70 52 63 if( pRc ) *pRc
a4f0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
a500: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 72 65 T_BKPT;. re
a510: 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 turn 0;. }.
a520: 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 79 74 size = get2byt
a530: 65 28 26 61 44 61 74 61 5b 70 63 2b 32 5d 29 3b e(&aData[pc+2]);
a540: 0a 20 20 20 20 69 66 28 20 73 69 7a 65 3e 3d 6e . if( size>=n
a550: 42 79 74 65 20 29 7b 0a 20 20 20 20 20 20 69 6e Byte ){. in
a560: 74 20 78 20 3d 20 73 69 7a 65 20 2d 20 6e 42 79 t x = size - nBy
a570: 74 65 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 te;. testca
a580: 73 65 28 20 78 3d 3d 34 20 29 3b 0a 20 20 20 20 se( x==4 );.
a590: 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d 33 testcase( x==3
a5a0: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 78 3c );. if( x<
a5b0: 34 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 4 ){. if(
a5c0: 20 61 44 61 74 61 5b 68 64 72 2b 37 5d 3e 3d 36 aData[hdr+7]>=6
a5d0: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 0 ){. i
a5e0: 66 28 20 70 62 44 65 66 72 61 67 20 29 20 2a 70 f( pbDefrag ) *p
a5f0: 62 44 65 66 72 61 67 20 3d 20 31 3b 0a 20 20 20 bDefrag = 1;.
a600: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b return 0;
a610: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
a620: 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 /* Remove the
a630: 20 73 6c 6f 74 20 66 72 6f 6d 20 74 68 65 20 66 slot from the f
a640: 72 65 65 2d 6c 69 73 74 2e 20 55 70 64 61 74 65 ree-list. Update
a650: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 20 the number of.
a660: 20 20 20 20 20 20 20 2a 2a 20 66 72 61 67 6d 65 ** fragme
a670: 6e 74 65 64 20 62 79 74 65 73 20 77 69 74 68 69 nted bytes withi
a680: 6e 20 74 68 65 20 70 61 67 65 2e 20 2a 2f 0a 20 n the page. */.
a690: 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 61 memcpy(&a
a6a0: 44 61 74 61 5b 69 41 64 64 72 5d 2c 20 26 61 44 Data[iAddr], &aD
a6b0: 61 74 61 5b 70 63 5d 2c 20 32 29 3b 0a 20 20 20 ata[pc], 2);.
a6c0: 20 20 20 20 20 61 44 61 74 61 5b 68 64 72 2b 37 aData[hdr+7
a6d0: 5d 20 2b 3d 20 28 75 38 29 78 3b 0a 20 20 20 20 ] += (u8)x;.
a6e0: 20 20 7d 65 6c 73 65 20 69 66 28 20 73 69 7a 65 }else if( size
a6f0: 2b 70 63 20 3e 20 75 73 61 62 6c 65 53 69 7a 65 +pc > usableSize
a700: 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 ){. if(
a710: 70 52 63 20 29 20 2a 70 52 63 20 3d 20 53 51 4c pRc ) *pRc = SQL
a720: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
a730: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
a740: 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0;. }else{
a750: 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 . /* The
a760: 73 6c 6f 74 20 72 65 6d 61 69 6e 73 20 6f 6e 20 slot remains on
a770: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 52 the free-list. R
a780: 65 64 75 63 65 20 69 74 73 20 73 69 7a 65 20 74 educe its size t
a790: 6f 20 61 63 63 6f 75 6e 74 0a 20 20 20 20 20 20 o account.
a7a0: 20 20 20 2a 2a 20 66 6f 72 20 74 68 65 20 70 6f ** for the po
a7b0: 72 74 69 6f 6e 20 75 73 65 64 20 62 79 20 74 68 rtion used by th
a7c0: 65 20 6e 65 77 20 61 6c 6c 6f 63 61 74 69 6f 6e e new allocation
a7d0: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 75 74 . */. put
a7e0: 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 63 2b 2byte(&aData[pc+
a7f0: 32 5d 2c 20 78 29 3b 0a 20 20 20 20 20 20 7d 0a 2], x);. }.
a800: 20 20 20 20 20 20 72 65 74 75 72 6e 20 26 61 44 return &aD
a810: 61 74 61 5b 70 63 20 2b 20 78 5d 3b 0a 20 20 20 ata[pc + x];.
a820: 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e }. }.. return
a830: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 0;.}../*.** All
a840: 6f 63 61 74 65 20 6e 42 79 74 65 20 62 79 74 65 ocate nByte byte
a850: 73 20 6f 66 20 73 70 61 63 65 20 66 72 6f 6d 20 s of space from
a860: 77 69 74 68 69 6e 20 74 68 65 20 42 2d 54 72 65 within the B-Tre
a870: 65 20 70 61 67 65 20 70 61 73 73 65 64 0a 2a 2a e page passed.**
a880: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72 as the first ar
a890: 67 75 6d 65 6e 74 2e 20 57 72 69 74 65 20 69 6e gument. Write in
a8a0: 74 6f 20 2a 70 49 64 78 20 74 68 65 20 69 6e 64 to *pIdx the ind
a8b0: 65 78 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e 61 ex into pPage->a
a8c0: 44 61 74 61 5b 5d 0a 2a 2a 20 6f 66 20 74 68 65 Data[].** of the
a8d0: 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 61 first byte of a
a8e0: 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 2e 20 llocated space.
a8f0: 52 65 74 75 72 6e 20 65 69 74 68 65 72 20 53 51 Return either SQ
a900: 4c 49 54 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 61 6e LITE_OK or.** an
a910: 20 65 72 72 6f 72 20 63 6f 64 65 20 28 75 73 75 error code (usu
a920: 61 6c 6c 79 20 53 51 4c 49 54 45 5f 43 4f 52 52 ally SQLITE_CORR
a930: 55 50 54 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 UPT)..**.** The
a940: 63 61 6c 6c 65 72 20 67 75 61 72 61 6e 74 65 65 caller guarantee
a950: 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 s that there is
a960: 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 sufficient space
a970: 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a 2a 20 to make the.**
a980: 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 54 68 69 allocation. Thi
a990: 73 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 74 20 s routine might
a9a0: 6e 65 65 64 20 74 6f 20 64 65 66 72 61 67 6d 65 need to defragme
a9b0: 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 nt in order to b
a9c0: 72 69 6e 67 0a 2a 2a 20 61 6c 6c 20 74 68 65 20 ring.** all the
a9d0: 73 70 61 63 65 20 74 6f 67 65 74 68 65 72 2c 20 space together,
a9e0: 68 6f 77 65 76 65 72 2e 20 20 54 68 69 73 20 72 however. This r
a9f0: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 76 6f 69 outine will avoi
aa00: 64 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 66 d using.** the f
aa10: 69 72 73 74 20 74 77 6f 20 62 79 74 65 73 20 70 irst two bytes p
aa20: 61 73 74 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 ast the cell poi
aa30: 6e 74 65 72 20 61 72 65 61 20 73 69 6e 63 65 20 nter area since
aa40: 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69 73 0a presumably this.
aa50: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 ** allocation is
aa60: 20 62 65 69 6e 67 20 6d 61 64 65 20 69 6e 20 6f being made in o
aa70: 72 64 65 72 20 74 6f 20 69 6e 73 65 72 74 20 61 rder to insert a
aa80: 20 6e 65 77 20 63 65 6c 6c 2c 20 73 6f 20 77 65 new cell, so we
aa90: 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 65 6e will.** also en
aaa0: 64 20 75 70 20 6e 65 65 64 69 6e 67 20 61 20 6e d up needing a n
aab0: 65 77 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 2e ew cell pointer.
aac0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
aad0: 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 4d 65 6d llocateSpace(Mem
aae0: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
aaf0: 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 49 64 nByte, int *pId
ab00: 78 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 x){. const int
ab10: 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 hdr = pPage->hdr
ab20: 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4c 6f Offset; /* Lo
ab30: 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 50 61 cal cache of pPa
ab40: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 2a 2f ge->hdrOffset */
ab50: 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 64 61 . u8 * const da
ab60: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
ab70: 61 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 6c a; /* Local
ab80: 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 65 2d cache of pPage-
ab90: 3e 61 44 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 >aData */. int
aba0: 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 top;
abb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
abc0: 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f /* First byte o
abd0: 66 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 f cell content a
abe0: 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 67 61 70 rea */. int gap
abf0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 ; /* Firs
ac00: 74 20 62 79 74 65 20 6f 66 20 67 61 70 20 62 65 t byte of gap be
ac10: 74 77 65 65 6e 20 63 65 6c 6c 20 70 6f 69 6e 74 tween cell point
ac20: 65 72 73 20 61 6e 64 20 63 65 6c 6c 20 63 6f 6e ers and cell con
ac30: 74 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 72 63 tent */. int rc
ac40: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 74 ; /* Int
ac50: 65 67 65 72 20 72 65 74 75 72 6e 20 63 6f 64 65 eger return code
ac60: 20 2a 2f 0a 20 20 0a 20 20 61 73 73 65 72 74 28 */. . assert(
ac70: 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
ac80: 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
ac90: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
aca0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 sert( pPage->pBt
acb0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
acc0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
acd0: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
ace0: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
acf0: 20 6e 42 79 74 65 3e 3d 30 20 29 3b 20 20 2f 2a nByte>=0 ); /*
ad00: 20 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 73 69 Minimum cell si
ad10: 7a 65 20 69 73 20 34 20 2a 2f 0a 20 20 61 73 73 ze is 4 */. ass
ad20: 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 46 72 65 ert( pPage->nFre
ad30: 65 3e 3d 6e 42 79 74 65 20 29 3b 0a 20 20 61 73 e>=nByte );. as
ad40: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f 76 sert( pPage->nOv
ad50: 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 61 erflow==0 );. a
ad60: 73 73 65 72 74 28 20 6e 42 79 74 65 20 3c 20 70 ssert( nByte < p
ad70: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
ad80: 65 53 69 7a 65 2d 38 20 29 3b 0a 0a 20 20 61 73 eSize-8 );.. as
ad90: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 65 6c sert( pPage->cel
ada0: 6c 4f 66 66 73 65 74 20 3d 3d 20 68 64 72 20 2b lOffset == hdr +
adb0: 20 31 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 12 - 4*pPage->l
adc0: 65 61 66 20 29 3b 0a 20 20 67 61 70 20 3d 20 70 eaf );. gap = p
add0: 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 Page->cellOffset
ade0: 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c + 2*pPage->nCel
adf0: 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 67 61 70 l;. assert( gap
ae00: 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 74 6f 70 <=65536 );. top
ae10: 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 = get2byte(&dat
ae20: 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 66 28 a[hdr+5]);. if(
ae30: 20 67 61 70 3e 74 6f 70 20 29 7b 0a 20 20 20 20 gap>top ){.
ae40: 69 66 28 20 74 6f 70 3d 3d 30 20 29 7b 0a 20 20 if( top==0 ){.
ae50: 20 20 20 20 74 6f 70 20 3d 20 36 35 35 33 36 3b top = 65536;
ae60: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
ae70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
ae80: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
ae90: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 }. }.. /* If
aea0: 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 68 there is enough
aeb0: 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 67 space between g
aec0: 61 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 6f ap and top for o
aed0: 6e 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f 69 ne more cell poi
aee0: 6e 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 20 nter. ** array
aef0: 65 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 6e entry offset, an
af00: 64 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 73 d if the freelis
af10: 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c 20 t is not empty,
af20: 74 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 0a then search the.
af30: 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c 6f ** freelist lo
af40: 6f 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 65 oking for a free
af50: 20 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 68 slot big enough
af60: 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 20 to satisfy the
af70: 72 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 20 request.. */.
af80: 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 3d testcase( gap+2=
af90: 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 61 =top );. testca
afa0: 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 29 se( gap+1==top )
afb0: 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 ;. testcase( ga
afc0: 70 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 p==top );. if(
afd0: 67 61 70 2b 32 3c 3d 74 6f 70 20 26 26 20 28 64 gap+2<=top && (d
afe0: 61 74 61 5b 68 64 72 2b 31 5d 20 7c 7c 20 64 61 ata[hdr+1] || da
aff0: 74 61 5b 68 64 72 2b 32 5d 29 20 29 7b 0a 20 20 ta[hdr+2]) ){.
b000: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
b010: 45 5f 4f 4b 3b 0a 20 20 20 20 69 6e 74 20 62 44 E_OK;. int bD
b020: 65 66 72 61 67 20 3d 20 30 3b 0a 20 20 20 20 75 efrag = 0;. u
b030: 38 20 2a 70 53 70 61 63 65 20 3d 20 70 61 67 65 8 *pSpace = page
b040: 46 69 6e 64 53 6c 6f 74 28 70 50 61 67 65 2c 20 FindSlot(pPage,
b050: 6e 42 79 74 65 2c 20 26 72 63 2c 20 26 62 44 65 nByte, &rc, &bDe
b060: 66 72 61 67 29 3b 0a 20 20 20 20 69 66 28 20 72 frag);. if( r
b070: 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
b080: 20 20 20 69 66 28 20 62 44 65 66 72 61 67 20 29 if( bDefrag )
b090: 20 67 6f 74 6f 20 64 65 66 72 61 67 6d 65 6e 74 goto defragment
b0a0: 5f 70 61 67 65 3b 0a 20 20 20 20 69 66 28 20 70 _page;. if( p
b0b0: 53 70 61 63 65 20 29 7b 0a 20 20 20 20 20 20 2a Space ){. *
b0c0: 70 49 64 78 20 3d 20 70 53 70 61 63 65 20 2d 20 pIdx = pSpace -
b0d0: 64 61 74 61 3b 0a 20 20 20 20 20 20 72 65 74 75 data;. retu
b0e0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
b0f0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 }. }.. /* Th
b100: 65 20 72 65 71 75 65 73 74 20 63 6f 75 6c 64 20 e request could
b110: 6e 6f 74 20 62 65 20 66 75 6c 66 69 6c 6c 65 64 not be fulfilled
b120: 20 75 73 69 6e 67 20 61 20 66 72 65 65 6c 69 73 using a freelis
b130: 74 20 73 6c 6f 74 2e 20 20 43 68 65 63 6b 0a 20 t slot. Check.
b140: 20 2a 2a 20 74 6f 20 73 65 65 20 69 66 20 64 65 ** to see if de
b150: 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 69 73 fragmentation is
b160: 20 6e 65 63 65 73 73 61 72 79 2e 0a 20 20 2a 2f necessary.. */
b170: 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 70 . testcase( gap
b180: 2b 32 2b 6e 42 79 74 65 3d 3d 74 6f 70 20 29 3b +2+nByte==top );
b190: 0a 20 20 69 66 28 20 67 61 70 2b 32 2b 6e 42 79 . if( gap+2+nBy
b1a0: 74 65 3e 74 6f 70 20 29 7b 0a 20 64 65 66 72 61 te>top ){. defra
b1b0: 67 6d 65 6e 74 5f 70 61 67 65 3a 0a 20 20 20 20 gment_page:.
b1c0: 74 65 73 74 63 61 73 65 28 20 70 50 61 67 65 2d testcase( pPage-
b1d0: 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 >nCell==0 );.
b1e0: 20 72 63 20 3d 20 64 65 66 72 61 67 6d 65 6e 74 rc = defragment
b1f0: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 Page(pPage);.
b200: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
b210: 20 72 63 3b 0a 20 20 20 20 74 6f 70 20 3d 20 67 rc;. top = g
b220: 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 et2byteNotZero(&
b230: 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 data[hdr+5]);.
b240: 20 20 61 73 73 65 72 74 28 20 67 61 70 2b 6e 42 assert( gap+nB
b250: 79 74 65 3c 3d 74 6f 70 20 29 3b 0a 20 20 7d 0a yte<=top );. }.
b260: 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 .. /* Allocate
b270: 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65 20 memory from the
b280: 67 61 70 20 69 6e 20 62 65 74 77 65 65 6e 20 74 gap in between t
b290: 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 he cell pointer
b2a0: 61 72 72 61 79 0a 20 20 2a 2a 20 61 6e 64 20 74 array. ** and t
b2b0: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
b2c0: 61 72 65 61 2e 20 20 54 68 65 20 62 74 72 65 65 area. The btree
b2d0: 49 6e 69 74 50 61 67 65 28 29 20 63 61 6c 6c 20 InitPage() call
b2e0: 68 61 73 20 61 6c 72 65 61 64 79 0a 20 20 2a 2a has already. **
b2f0: 20 76 61 6c 69 64 61 74 65 64 20 74 68 65 20 66 validated the f
b300: 72 65 65 6c 69 73 74 2e 20 20 47 69 76 65 6e 20 reelist. Given
b310: 74 68 61 74 20 74 68 65 20 66 72 65 65 6c 69 73 that the freelis
b320: 74 20 69 73 20 76 61 6c 69 64 2c 20 74 68 65 72 t is valid, ther
b330: 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 77 61 79 e. ** is no way
b340: 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 61 that the alloca
b350: 74 69 6f 6e 20 63 61 6e 20 65 78 74 65 6e 64 20 tion can extend
b360: 6f 66 66 20 74 68 65 20 65 6e 64 20 6f 66 20 74 off the end of t
b370: 68 65 20 70 61 67 65 2e 0a 20 20 2a 2a 20 54 68 he page.. ** Th
b380: 65 20 61 73 73 65 72 74 28 29 20 62 65 6c 6f 77 e assert() below
b390: 20 76 65 72 69 66 69 65 73 20 74 68 65 20 70 72 verifies the pr
b3a0: 65 76 69 6f 75 73 20 73 65 6e 74 65 6e 63 65 2e evious sentence.
b3b0: 0a 20 20 2a 2f 0a 20 20 74 6f 70 20 2d 3d 20 6e . */. top -= n
b3c0: 42 79 74 65 3b 0a 20 20 70 75 74 32 62 79 74 65 Byte;. put2byte
b3d0: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 74 (&data[hdr+5], t
b3e0: 6f 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 74 op);. assert( t
b3f0: 6f 70 2b 6e 42 79 74 65 20 3c 3d 20 28 69 6e 74 op+nByte <= (int
b400: 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 )pPage->pBt->usa
b410: 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 2a 70 49 bleSize );. *pI
b420: 64 78 20 3d 20 74 6f 70 3b 0a 20 20 72 65 74 75 dx = top;. retu
b430: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
b440: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 ./*.** Return a
b450: 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 section of the p
b460: 50 61 67 65 2d 3e 61 44 61 74 61 20 74 6f 20 74 Page->aData to t
b470: 68 65 20 66 72 65 65 6c 69 73 74 2e 0a 2a 2a 20 he freelist..**
b480: 54 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f The first byte o
b490: 66 20 74 68 65 20 6e 65 77 20 66 72 65 65 20 62 f the new free b
b4a0: 6c 6f 63 6b 20 69 73 20 70 50 61 67 65 2d 3e 61 lock is pPage->a
b4b0: 44 61 74 61 5b 69 53 74 61 72 74 5d 0a 2a 2a 20 Data[iStart].**
b4c0: 61 6e 64 20 74 68 65 20 73 69 7a 65 20 6f 66 20 and the size of
b4d0: 74 68 65 20 62 6c 6f 63 6b 20 69 73 20 69 53 69 the block is iSi
b4e0: 7a 65 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 ze bytes..**.**
b4f0: 41 64 6a 61 63 65 6e 74 20 66 72 65 65 62 6c 6f Adjacent freeblo
b500: 63 6b 73 20 61 72 65 20 63 6f 61 6c 65 73 63 65 cks are coalesce
b510: 64 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 d..**.** Note th
b520: 61 74 20 65 76 65 6e 20 74 68 6f 75 67 68 20 74 at even though t
b530: 68 65 20 66 72 65 65 62 6c 6f 63 6b 20 6c 69 73 he freeblock lis
b540: 74 20 77 61 73 20 63 68 65 63 6b 65 64 20 62 79 t was checked by
b550: 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 btreeInitPage()
b560: 2c 0a 2a 2a 20 74 68 61 74 20 72 6f 75 74 69 6e ,.** that routin
b570: 65 20 77 69 6c 6c 20 6e 6f 74 20 64 65 74 65 63 e will not detec
b580: 74 20 6f 76 65 72 6c 61 70 20 62 65 74 77 65 65 t overlap betwee
b590: 6e 20 63 65 6c 6c 73 20 6f 72 20 66 72 65 65 62 n cells or freeb
b5a0: 6c 6f 63 6b 73 2e 20 20 4e 6f 72 0a 2a 2a 20 64 locks. Nor.** d
b5b0: 6f 65 73 20 69 74 20 64 65 74 65 63 74 20 63 65 oes it detect ce
b5c0: 6c 6c 73 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b lls or freeblock
b5d0: 73 20 74 68 61 74 20 65 6e 63 72 6f 75 63 68 20 s that encrouch
b5e0: 69 6e 74 6f 20 74 68 65 20 72 65 73 65 72 76 65 into the reserve
b5f0: 64 20 62 79 74 65 73 0a 2a 2a 20 61 74 20 74 68 d bytes.** at th
b600: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 e end of the pag
b610: 65 2e 20 20 53 6f 20 64 6f 20 61 64 64 69 74 69 e. So do additi
b620: 6f 6e 61 6c 20 63 6f 72 72 75 70 74 69 6f 6e 20 onal corruption
b630: 63 68 65 63 6b 73 20 69 6e 73 69 64 65 20 74 68 checks inside th
b640: 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 61 6e is.** routine an
b650: 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f d return SQLITE_
b660: 43 4f 52 52 55 50 54 20 69 66 20 61 6e 79 20 70 CORRUPT if any p
b670: 72 6f 62 6c 65 6d 73 20 61 72 65 20 66 6f 75 6e roblems are foun
b680: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
b690: 20 66 72 65 65 53 70 61 63 65 28 4d 65 6d 50 61 freeSpace(MemPa
b6a0: 67 65 20 2a 70 50 61 67 65 2c 20 75 31 36 20 69 ge *pPage, u16 i
b6b0: 53 74 61 72 74 2c 20 75 31 36 20 69 53 69 7a 65 Start, u16 iSize
b6c0: 29 7b 0a 20 20 75 31 36 20 69 50 74 72 3b 20 20 ){. u16 iPtr;
b6d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b6e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 /* Ad
b6f0: 64 72 65 73 73 20 6f 66 20 70 74 72 20 74 6f 20 dress of ptr to
b700: 6e 65 78 74 20 66 72 65 65 62 6c 6f 63 6b 20 2a next freeblock *
b710: 2f 0a 20 20 75 31 36 20 69 46 72 65 65 42 6c 6b /. u16 iFreeBlk
b720: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b730: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 /* Add
b740: 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78 74 ress of the next
b750: 20 66 72 65 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 freeblock */.
b760: 75 38 20 68 64 72 3b 20 20 20 20 20 20 20 20 20 u8 hdr;
b770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b780: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 68 65 /* Page he
b790: 61 64 65 72 20 73 69 7a 65 2e 20 20 30 20 6f 72 ader size. 0 or
b7a0: 20 31 30 30 20 2a 2f 0a 20 20 75 38 20 6e 46 72 100 */. u8 nFr
b7b0: 61 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 ag = 0;
b7c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b7d0: 2f 2a 20 52 65 64 75 63 74 69 6f 6e 20 69 6e 20 /* Reduction in
b7e0: 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f fragmentation */
b7f0: 0a 20 20 75 31 36 20 69 4f 72 69 67 53 69 7a 65 . u16 iOrigSize
b800: 20 3d 20 69 53 69 7a 65 3b 20 20 20 20 20 20 20 = iSize;
b810: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 67 /* Orig
b820: 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 69 53 inal value of iS
b830: 69 7a 65 20 2a 2f 0a 20 20 75 33 32 20 69 4c 61 ize */. u32 iLa
b840: 73 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d st = pPage->pBt-
b850: 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 3b 20 2f >usableSize-4; /
b860: 2a 20 4c 61 72 67 65 73 74 20 70 6f 73 73 69 62 * Largest possib
b870: 6c 65 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 le freeblock off
b880: 73 65 74 20 2a 2f 0a 20 20 75 33 32 20 69 45 6e set */. u32 iEn
b890: 64 20 3d 20 69 53 74 61 72 74 20 2b 20 69 53 69 d = iStart + iSi
b8a0: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ze; /
b8b0: 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 61 73 * First byte pas
b8c0: 74 20 74 68 65 20 69 53 74 61 72 74 20 62 75 66 t the iStart buf
b8d0: 66 65 72 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 fer */. unsigne
b8e0: 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d 20 70 d char *data = p
b8f0: 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 20 20 2f Page->aData; /
b900: 2a 20 50 61 67 65 20 63 6f 6e 74 65 6e 74 20 2a * Page content *
b910: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 /.. assert( pPa
b920: 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 ge->pBt!=0 );.
b930: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
b940: 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
b950: 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
b960: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 );. assert( iSt
b970: 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 72 4f art>=pPage->hdrO
b980: 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d 3e 63 ffset+6+pPage->c
b990: 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b 0a 20 hildPtrSize );.
b9a0: 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 assert( CORRUPT
b9b0: 5f 44 42 20 7c 7c 20 69 45 6e 64 20 3c 3d 20 70 _DB || iEnd <= p
b9c0: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
b9d0: 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 eSize );. asser
b9e0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
b9f0: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
ba00: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
ba10: 73 65 72 74 28 20 69 53 69 7a 65 3e 3d 34 20 29 sert( iSize>=4 )
ba20: 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 63 ; /* Minimum c
ba30: 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a 2f ell size is 4 */
ba40: 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 72 . assert( iStar
ba50: 74 3c 3d 69 4c 61 73 74 20 29 3b 0a 0a 20 20 2f t<=iLast );.. /
ba60: 2a 20 4f 76 65 72 77 72 69 74 65 20 64 65 6c 65 * Overwrite dele
ba70: 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ted information
ba80: 77 69 74 68 20 7a 65 72 6f 73 20 77 68 65 6e 20 with zeros when
ba90: 74 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 the secure_delet
baa0: 65 0a 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 73 e. ** option is
bab0: 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 69 66 enabled */. if
bac0: 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 62 74 ( pPage->pBt->bt
bad0: 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 sFlags & BTS_SEC
bae0: 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 URE_DELETE ){.
baf0: 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 69 memset(&data[i
bb00: 53 74 61 72 74 5d 2c 20 30 2c 20 69 53 69 7a 65 Start], 0, iSize
bb10: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 );. }.. /* The
bb20: 20 6c 69 73 74 20 6f 66 20 66 72 65 65 62 6c 6f list of freeblo
bb30: 63 6b 73 20 6d 75 73 74 20 62 65 20 69 6e 20 61 cks must be in a
bb40: 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 20 scending order.
bb50: 20 46 69 6e 64 20 74 68 65 20 0a 20 20 2a 2a 20 Find the . **
bb60: 73 70 6f 74 20 6f 6e 20 74 68 65 20 6c 69 73 74 spot on the list
bb70: 20 77 68 65 72 65 20 69 53 74 61 72 74 20 73 68 where iStart sh
bb80: 6f 75 6c 64 20 62 65 20 69 6e 73 65 72 74 65 64 ould be inserted
bb90: 2e 0a 20 20 2a 2f 0a 20 20 68 64 72 20 3d 20 70 .. */. hdr = p
bba0: 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b Page->hdrOffset;
bbb0: 0a 20 20 69 50 74 72 20 3d 20 68 64 72 20 2b 20 . iPtr = hdr +
bbc0: 31 3b 0a 20 20 69 66 28 20 64 61 74 61 5b 69 50 1;. if( data[iP
bbd0: 74 72 2b 31 5d 3d 3d 30 20 26 26 20 64 61 74 61 tr+1]==0 && data
bbe0: 5b 69 50 74 72 5d 3d 3d 30 20 29 7b 0a 20 20 20 [iPtr]==0 ){.
bbf0: 20 69 46 72 65 65 42 6c 6b 20 3d 20 30 3b 20 20 iFreeBlk = 0;
bc00: 2f 2a 20 53 68 6f 72 74 63 75 74 20 66 6f 72 20 /* Shortcut for
bc10: 74 68 65 20 63 61 73 65 20 77 68 65 6e 20 74 68 the case when th
bc20: 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 65 6d e freelist is em
bc30: 70 74 79 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b 0a pty */. }else{.
bc40: 20 20 20 20 77 68 69 6c 65 28 20 28 69 46 72 65 while( (iFre
bc50: 65 42 6c 6b 20 3d 20 67 65 74 32 62 79 74 65 28 eBlk = get2byte(
bc60: 26 64 61 74 61 5b 69 50 74 72 5d 29 29 3e 30 20 &data[iPtr]))>0
bc70: 26 26 20 69 46 72 65 65 42 6c 6b 3c 69 53 74 61 && iFreeBlk<iSta
bc80: 72 74 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 rt ){. if(
bc90: 69 46 72 65 65 42 6c 6b 3c 69 50 74 72 2b 34 20 iFreeBlk<iPtr+4
bca0: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
bcb0: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
bcc0: 20 20 20 20 69 50 74 72 20 3d 20 69 46 72 65 65 iPtr = iFree
bcd0: 42 6c 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 Blk;. }. i
bce0: 66 28 20 69 46 72 65 65 42 6c 6b 3e 69 4c 61 73 f( iFreeBlk>iLas
bcf0: 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 t ) return SQLIT
bd00: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
bd10: 20 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 assert( iFre
bd20: 65 42 6c 6b 3e 69 50 74 72 20 7c 7c 20 69 46 72 eBlk>iPtr || iFr
bd30: 65 65 42 6c 6b 3d 3d 30 20 29 3b 0a 20 20 0a 20 eeBlk==0 );. .
bd40: 20 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f /* At this po
bd50: 69 6e 74 3a 0a 20 20 20 20 2a 2a 20 20 20 20 69 int:. ** i
bd60: 46 72 65 65 42 6c 6b 3a 20 20 20 46 69 72 73 74 FreeBlk: First
bd70: 20 66 72 65 65 62 6c 6f 63 6b 20 61 66 74 65 72 freeblock after
bd80: 20 69 53 74 61 72 74 2c 20 6f 72 20 7a 65 72 6f iStart, or zero
bd90: 20 69 66 20 6e 6f 6e 65 0a 20 20 20 20 2a 2a 20 if none. **
bda0: 20 20 20 69 50 74 72 3a 20 20 20 20 20 20 20 54 iPtr: T
bdb0: 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 61 20 he address of a
bdc0: 70 6f 69 6e 74 65 72 20 69 46 72 65 65 42 6c 6b pointer iFreeBlk
bdd0: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 . **. ** C
bde0: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 69 heck to see if i
bdf0: 46 72 65 65 42 6c 6b 20 73 68 6f 75 6c 64 20 62 FreeBlk should b
be00: 65 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f e coalesced onto
be10: 20 74 68 65 20 65 6e 64 20 6f 66 20 69 53 74 61 the end of iSta
be20: 72 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 rt.. */. i
be30: 66 28 20 69 46 72 65 65 42 6c 6b 20 26 26 20 69 f( iFreeBlk && i
be40: 45 6e 64 2b 33 3e 3d 69 46 72 65 65 42 6c 6b 20 End+3>=iFreeBlk
be50: 29 7b 0a 20 20 20 20 20 20 6e 46 72 61 67 20 3d ){. nFrag =
be60: 20 69 46 72 65 65 42 6c 6b 20 2d 20 69 45 6e 64 iFreeBlk - iEnd
be70: 3b 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e 64 ;. if( iEnd
be80: 3e 69 46 72 65 65 42 6c 6b 20 29 20 72 65 74 75 >iFreeBlk ) retu
be90: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
bea0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 69 45 T_BKPT;. iE
beb0: 6e 64 20 3d 20 69 46 72 65 65 42 6c 6b 20 2b 20 nd = iFreeBlk +
bec0: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 get2byte(&data[i
bed0: 46 72 65 65 42 6c 6b 2b 32 5d 29 3b 0a 20 20 20 FreeBlk+2]);.
bee0: 20 20 20 69 53 69 7a 65 20 3d 20 69 45 6e 64 20 iSize = iEnd
bef0: 2d 20 69 53 74 61 72 74 3b 0a 20 20 20 20 20 20 - iStart;.
bf00: 69 46 72 65 65 42 6c 6b 20 3d 20 67 65 74 32 62 iFreeBlk = get2b
bf10: 79 74 65 28 26 64 61 74 61 5b 69 46 72 65 65 42 yte(&data[iFreeB
bf20: 6c 6b 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 lk]);. }. .
bf30: 20 20 20 2f 2a 20 49 66 20 69 50 74 72 20 69 73 /* If iPtr is
bf40: 20 61 6e 6f 74 68 65 72 20 66 72 65 65 62 6c 6f another freeblo
bf50: 63 6b 20 28 74 68 61 74 20 69 73 2c 20 69 66 20 ck (that is, if
bf60: 69 50 74 72 20 69 73 20 6e 6f 74 20 74 68 65 20 iPtr is not the
bf70: 66 72 65 65 6c 69 73 74 0a 20 20 20 20 2a 2a 20 freelist. **
bf80: 70 6f 69 6e 74 65 72 20 69 6e 20 74 68 65 20 70 pointer in the p
bf90: 61 67 65 20 68 65 61 64 65 72 29 20 74 68 65 6e age header) then
bfa0: 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 check to see if
bfb0: 20 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 iStart should b
bfc0: 65 0a 20 20 20 20 2a 2a 20 63 6f 61 6c 65 73 63 e. ** coalesc
bfd0: 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 20 ed onto the end
bfe0: 6f 66 20 69 50 74 72 2e 0a 20 20 20 20 2a 2f 0a of iPtr.. */.
bff0: 20 20 20 20 69 66 28 20 69 50 74 72 3e 68 64 72 if( iPtr>hdr
c000: 2b 31 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 +1 ){. int
c010: 69 50 74 72 45 6e 64 20 3d 20 69 50 74 72 20 2b iPtrEnd = iPtr +
c020: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
c030: 69 50 74 72 2b 32 5d 29 3b 0a 20 20 20 20 20 20 iPtr+2]);.
c040: 69 66 28 20 69 50 74 72 45 6e 64 2b 33 3e 3d 69 if( iPtrEnd+3>=i
c050: 53 74 61 72 74 20 29 7b 0a 20 20 20 20 20 20 20 Start ){.
c060: 20 69 66 28 20 69 50 74 72 45 6e 64 3e 69 53 74 if( iPtrEnd>iSt
c070: 61 72 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c art ) return SQL
c080: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
c090: 3b 0a 20 20 20 20 20 20 20 20 6e 46 72 61 67 20 ;. nFrag
c0a0: 2b 3d 20 69 53 74 61 72 74 20 2d 20 69 50 74 72 += iStart - iPtr
c0b0: 45 6e 64 3b 0a 20 20 20 20 20 20 20 20 69 53 69 End;. iSi
c0c0: 7a 65 20 3d 20 69 45 6e 64 20 2d 20 69 50 74 72 ze = iEnd - iPtr
c0d0: 3b 0a 20 20 20 20 20 20 20 20 69 53 74 61 72 74 ;. iStart
c0e0: 20 3d 20 69 50 74 72 3b 0a 20 20 20 20 20 20 7d = iPtr;. }
c0f0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 6e . }. if( n
c100: 46 72 61 67 3e 64 61 74 61 5b 68 64 72 2b 37 5d Frag>data[hdr+7]
c110: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
c120: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
c130: 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2d data[hdr+7] -
c140: 3d 20 6e 46 72 61 67 3b 0a 20 20 7d 0a 20 20 69 = nFrag;. }. i
c150: 66 28 20 69 53 74 61 72 74 3d 3d 67 65 74 32 62 f( iStart==get2b
c160: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
c170: 29 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 ) ){. /* The
c180: 6e 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 73 new freeblock is
c190: 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e at the beginnin
c1a0: 67 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f g of the cell co
c1b0: 6e 74 65 6e 74 20 61 72 65 61 2c 0a 20 20 20 20 ntent area,.
c1c0: 2a 2a 20 73 6f 20 6a 75 73 74 20 65 78 74 65 6e ** so just exten
c1d0: 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 d the cell conte
c1e0: 6e 74 20 61 72 65 61 20 72 61 74 68 65 72 20 74 nt area rather t
c1f0: 68 61 6e 20 63 72 65 61 74 65 20 61 6e 6f 74 68 han create anoth
c200: 65 72 0a 20 20 20 20 2a 2a 20 66 72 65 65 6c 69 er. ** freeli
c210: 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 20 20 st entry */.
c220: 69 66 28 20 69 50 74 72 21 3d 68 64 72 2b 31 20 if( iPtr!=hdr+1
c230: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
c240: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
c250: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
c260: 5b 68 64 72 2b 31 5d 2c 20 69 46 72 65 65 42 6c [hdr+1], iFreeBl
c270: 6b 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 k);. put2byte
c280: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 69 (&data[hdr+5], i
c290: 45 6e 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 End);. }else{.
c2a0: 20 20 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 65 /* Insert the
c2b0: 20 6e 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 new freeblock i
c2c0: 6e 74 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 nto the freelist
c2d0: 20 2a 2f 0a 20 20 20 20 70 75 74 32 62 79 74 65 */. put2byte
c2e0: 28 26 64 61 74 61 5b 69 50 74 72 5d 2c 20 69 53 (&data[iPtr], iS
c2f0: 74 61 72 74 29 3b 0a 20 20 20 20 70 75 74 32 62 tart);. put2b
c300: 79 74 65 28 26 64 61 74 61 5b 69 53 74 61 72 74 yte(&data[iStart
c310: 5d 2c 20 69 46 72 65 65 42 6c 6b 29 3b 0a 20 20 ], iFreeBlk);.
c320: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
c330: 5b 69 53 74 61 72 74 2b 32 5d 2c 20 69 53 69 7a [iStart+2], iSiz
c340: 65 29 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d e);. }. pPage-
c350: 3e 6e 46 72 65 65 20 2b 3d 20 69 4f 72 69 67 53 >nFree += iOrigS
c360: 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ize;. return SQ
c370: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
c380: 2a 20 44 65 63 6f 64 65 20 74 68 65 20 66 6c 61 * Decode the fla
c390: 67 73 20 62 79 74 65 20 28 74 68 65 20 66 69 72 gs byte (the fir
c3a0: 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 68 st byte of the h
c3b0: 65 61 64 65 72 29 20 66 6f 72 20 61 20 70 61 67 eader) for a pag
c3c0: 65 0a 2a 2a 20 61 6e 64 20 69 6e 69 74 69 61 6c e.** and initial
c3d0: 69 7a 65 20 66 69 65 6c 64 73 20 6f 66 20 74 68 ize fields of th
c3e0: 65 20 4d 65 6d 50 61 67 65 20 73 74 72 75 63 74 e MemPage struct
c3f0: 75 72 65 20 61 63 63 6f 72 64 69 6e 67 6c 79 2e ure accordingly.
c400: 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 74 68 65 20 .**.** Only the
c410: 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 62 69 6e following combin
c420: 61 74 69 6f 6e 73 20 61 72 65 20 73 75 70 70 6f ations are suppo
c430: 72 74 65 64 2e 20 20 41 6e 79 74 68 69 6e 67 20 rted. Anything
c440: 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20 69 6e 64 different.** ind
c450: 69 63 61 74 65 73 20 61 20 63 6f 72 72 75 70 74 icates a corrupt
c460: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 3a database files:
c470: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 .**.** P
c480: 54 46 5f 5a 45 52 4f 44 41 54 41 0a 2a 2a 20 20 TF_ZERODATA.**
c490: 20 20 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 PTF_ZEROD
c4a0: 41 54 41 20 7c 20 50 54 46 5f 4c 45 41 46 0a 2a ATA | PTF_LEAF.*
c4b0: 2a 20 20 20 20 20 20 20 20 20 50 54 46 5f 4c 45 * PTF_LE
c4c0: 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 AFDATA | PTF_INT
c4d0: 4b 45 59 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 KEY.** P
c4e0: 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 54 TF_LEAFDATA | PT
c4f0: 46 5f 49 4e 54 4b 45 59 20 7c 20 50 54 46 5f 4c F_INTKEY | PTF_L
c500: 45 41 46 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e EAF.*/.static in
c510: 74 20 64 65 63 6f 64 65 46 6c 61 67 73 28 4d 65 t decodeFlags(Me
c520: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
c530: 74 20 66 6c 61 67 42 79 74 65 29 7b 0a 20 20 42 t flagByte){. B
c540: 74 53 68 61 72 65 64 20 2a 70 42 74 3b 20 20 20 tShared *pBt;
c550: 20 20 2f 2a 20 41 20 63 6f 70 79 20 6f 66 20 70 /* A copy of p
c560: 50 61 67 65 2d 3e 70 42 74 20 2a 2f 0a 0a 20 20 Page->pBt */..
c570: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 68 assert( pPage->h
c580: 64 72 4f 66 66 73 65 74 3d 3d 28 70 50 61 67 65 drOffset==(pPage
c590: 2d 3e 70 67 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 ->pgno==1 ? 100
c5a0: 3a 20 30 29 20 29 3b 0a 20 20 61 73 73 65 72 74 : 0) );. assert
c5b0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
c5c0: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
c5d0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 >mutex) );. pPa
c5e0: 67 65 2d 3e 6c 65 61 66 20 3d 20 28 75 38 29 28 ge->leaf = (u8)(
c5f0: 66 6c 61 67 42 79 74 65 3e 3e 33 29 3b 20 20 61 flagByte>>3); a
c600: 73 73 65 72 74 28 20 50 54 46 5f 4c 45 41 46 20 ssert( PTF_LEAF
c610: 3d 3d 20 31 3c 3c 33 20 29 3b 0a 20 20 66 6c 61 == 1<<3 );. fla
c620: 67 42 79 74 65 20 26 3d 20 7e 50 54 46 5f 4c 45 gByte &= ~PTF_LE
c630: 41 46 3b 0a 20 20 70 50 61 67 65 2d 3e 63 68 69 AF;. pPage->chi
c640: 6c 64 50 74 72 53 69 7a 65 20 3d 20 34 2d 34 2a ldPtrSize = 4-4*
c650: 70 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 70 pPage->leaf;. p
c660: 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b Bt = pPage->pBt;
c670: 0a 20 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d . if( flagByte=
c680: 3d 28 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c =(PTF_LEAFDATA |
c690: 20 50 54 46 5f 49 4e 54 4b 45 59 29 20 29 7b 0a PTF_INTKEY) ){.
c6a0: 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 pPage->intKe
c6b0: 79 20 3d 20 31 3b 0a 20 20 20 20 70 50 61 67 65 y = 1;. pPage
c6c0: 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 70 ->intKeyLeaf = p
c6d0: 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 20 20 Page->leaf;.
c6e0: 70 50 61 67 65 2d 3e 6e 6f 50 61 79 6c 6f 61 64 pPage->noPayload
c6f0: 20 3d 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 3b = !pPage->leaf;
c700: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 78 4c . pPage->maxL
c710: 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 78 4c ocal = pBt->maxL
c720: 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e eaf;. pPage->
c730: 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e minLocal = pBt->
c740: 6d 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c 73 65 minLeaf;. }else
c750: 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d 3d 50 if( flagByte==P
c760: 54 46 5f 5a 45 52 4f 44 41 54 41 20 29 7b 0a 20 TF_ZERODATA ){.
c770: 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 pPage->intKey
c780: 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d = 0;. pPage-
c790: 3e 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 30 3b >intKeyLeaf = 0;
c7a0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 6f 50 61 . pPage->noPa
c7b0: 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 20 20 70 yload = 0;. p
c7c0: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d Page->maxLocal =
c7d0: 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a pBt->maxLocal;.
c7e0: 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f pPage->minLo
c7f0: 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c 6f cal = pBt->minLo
c800: 63 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 cal;. }else{.
c810: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
c820: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
c830: 7d 0a 20 20 70 50 61 67 65 2d 3e 6d 61 78 31 62 }. pPage->max1b
c840: 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 70 42 74 ytePayload = pBt
c850: 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 ->max1bytePayloa
c860: 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 d;. return SQLI
c870: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
c880: 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 61 Initialize the a
c890: 75 78 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d 61 uxiliary informa
c8a0: 74 69 6f 6e 20 66 6f 72 20 61 20 64 69 73 6b 20 tion for a disk
c8b0: 62 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 block..**.** Ret
c8c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e urn SQLITE_OK on
c8d0: 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 77 65 success. If we
c8e0: 20 73 65 65 20 74 68 61 74 20 74 68 65 20 70 61 see that the pa
c8f0: 67 65 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 63 ge does.** not c
c900: 6f 6e 74 61 69 6e 20 61 20 77 65 6c 6c 2d 66 6f ontain a well-fo
c910: 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 61 rmed database pa
c920: 67 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 ge, then return
c930: 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 .** SQLITE_CORRU
c940: 50 54 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 61 PT. Note that a
c950: 20 72 65 74 75 72 6e 20 6f 66 20 53 51 4c 49 54 return of SQLIT
c960: 45 5f 4f 4b 20 64 6f 65 73 20 6e 6f 74 0a 2a 2a E_OK does not.**
c970: 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 20 guarantee that
c980: 74 68 65 20 70 61 67 65 20 69 73 20 77 65 6c 6c the page is well
c990: 2d 66 6f 72 6d 65 64 2e 20 20 49 74 20 6f 6e 6c -formed. It onl
c9a0: 79 20 73 68 6f 77 73 20 74 68 61 74 0a 2a 2a 20 y shows that.**
c9b0: 77 65 20 66 61 69 6c 65 64 20 74 6f 20 64 65 74 we failed to det
c9c0: 65 63 74 20 61 6e 79 20 63 6f 72 72 75 70 74 69 ect any corrupti
c9d0: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e on..*/.static in
c9e0: 74 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 t btreeInitPage(
c9f0: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 7b MemPage *pPage){
ca00: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
ca10: 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 61 e->pBt!=0 );. a
ca20: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
ca30: 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
ca40: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
ca50: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
ca60: 3e 70 67 6e 6f 3d 3d 73 71 6c 69 74 65 33 50 61 >pgno==sqlite3Pa
ca70: 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 50 gerPagenumber(pP
ca80: 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
ca90: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
caa0: 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 == sqlite3Pager
cab0: 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d 3e GetExtra(pPage->
cac0: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
cad0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 61 sert( pPage->aDa
cae0: 74 61 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 ta == sqlite3Pag
caf0: 65 72 47 65 74 44 61 74 61 28 70 50 61 67 65 2d erGetData(pPage-
cb00: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 >pDbPage) );..
cb10: 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73 49 6e if( !pPage->isIn
cb20: 69 74 20 29 7b 0a 20 20 20 20 75 31 36 20 70 63 it ){. u16 pc
cb30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
cb40: 41 64 64 72 65 73 73 20 6f 66 20 61 20 66 72 65 Address of a fre
cb50: 65 62 6c 6f 63 6b 20 77 69 74 68 69 6e 20 70 50 eblock within pP
cb60: 61 67 65 2d 3e 61 44 61 74 61 5b 5d 20 2a 2f 0a age->aData[] */.
cb70: 20 20 20 20 75 38 20 68 64 72 3b 20 20 20 20 20 u8 hdr;
cb80: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 /* Offset
cb90: 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 to beginning of
cba0: 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f 0a page header */.
cbb0: 20 20 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 u8 *data;
cbc0: 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c 20 /* Equal
cbd0: 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 to pPage->aData
cbe0: 2a 2f 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 */. BtShared
cbf0: 2a 70 42 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 *pBt; /*
cc00: 54 68 65 20 6d 61 69 6e 20 62 74 72 65 65 20 73 The main btree s
cc10: 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 20 tructure */.
cc20: 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b 20 int usableSize;
cc30: 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 /* Amount of
cc40: 75 73 61 62 6c 65 20 73 70 61 63 65 20 6f 6e 20 usable space on
cc50: 65 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 20 each page */.
cc60: 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 3b u16 cellOffset;
cc70: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 66 72 /* Offset fr
cc80: 6f 6d 20 73 74 61 72 74 20 6f 66 20 70 61 67 65 om start of page
cc90: 20 74 6f 20 66 69 72 73 74 20 63 65 6c 6c 20 70 to first cell p
cca0: 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 6e ointer */. in
ccb0: 74 20 6e 46 72 65 65 3b 20 20 20 20 20 20 20 20 t nFree;
ccc0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e /* Number of un
ccd0: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 74 68 used bytes on th
cce0: 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 69 6e e page */. in
ccf0: 74 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 t top;
cd00: 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f /* First byte o
cd10: 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 f the cell conte
cd20: 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 20 20 69 nt area */. i
cd30: 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 20 nt iCellFirst;
cd40: 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f 77 /* First allow
cd50: 61 62 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 65 able cell or fre
cd60: 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f eblock offset */
cd70: 0a 20 20 20 20 69 6e 74 20 69 43 65 6c 6c 4c 61 . int iCellLa
cd80: 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 st; /* Last
cd90: 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 6f 72 possible cell or
cda0: 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 freeblock offse
cdb0: 74 20 2a 2f 0a 0a 20 20 20 20 70 42 74 20 3d 20 t */.. pBt =
cdc0: 70 50 61 67 65 2d 3e 70 42 74 3b 0a 0a 20 20 20 pPage->pBt;..
cdd0: 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 hdr = pPage->hd
cde0: 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 64 61 74 rOffset;. dat
cdf0: 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 a = pPage->aData
ce00: 3b 0a 20 20 20 20 69 66 28 20 64 65 63 6f 64 65 ;. if( decode
ce10: 46 6c 61 67 73 28 70 50 61 67 65 2c 20 64 61 74 Flags(pPage, dat
ce20: 61 5b 68 64 72 5d 29 20 29 20 72 65 74 75 72 6e a[hdr]) ) return
ce30: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
ce40: 42 4b 50 54 3b 0a 20 20 20 20 61 73 73 65 72 74 BKPT;. assert
ce50: 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e ( pBt->pageSize>
ce60: 3d 35 31 32 20 26 26 20 70 42 74 2d 3e 70 61 67 =512 && pBt->pag
ce70: 65 53 69 7a 65 3c 3d 36 35 35 33 36 20 29 3b 0a eSize<=65536 );.
ce80: 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 73 6b 50 pPage->maskP
ce90: 61 67 65 20 3d 20 28 75 31 36 29 28 70 42 74 2d age = (u16)(pBt-
cea0: 3e 70 61 67 65 53 69 7a 65 20 2d 20 31 29 3b 0a >pageSize - 1);.
ceb0: 20 20 20 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 pPage->nOver
cec0: 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 20 20 75 73 flow = 0;. us
ced0: 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e ableSize = pBt->
cee0: 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 20 20 usableSize;.
cef0: 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
cf00: 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d t = cellOffset =
cf10: 20 68 64 72 20 2b 20 31 32 20 2d 20 34 2a 70 50 hdr + 12 - 4*pP
cf20: 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 20 20 70 age->leaf;. p
cf30: 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d Page->aDataEnd =
cf40: 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 69 7a &data[usableSiz
cf50: 65 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 e];. pPage->a
cf60: 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b CellIdx = &data[
cf70: 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 20 cellOffset];.
cf80: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
cf90: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
cfa0: 2b 35 5d 29 3b 0a 20 20 20 20 70 50 61 67 65 2d +5]);. pPage-
cfb0: 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 74 >nCell = get2byt
cfc0: 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 3b e(&data[hdr+3]);
cfd0: 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e . if( pPage->
cfe0: 6e 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 42 nCell>MX_CELL(pB
cff0: 74 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 t) ){. /* T
d000: 6f 20 6d 61 6e 79 20 63 65 6c 6c 73 20 66 6f 72 o many cells for
d010: 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 2e 20 a single page.
d020: 20 54 68 65 20 70 61 67 65 20 6d 75 73 74 20 62 The page must b
d030: 65 20 63 6f 72 72 75 70 74 20 2a 2f 0a 20 20 20 e corrupt */.
d040: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
d050: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
d060: 20 20 20 7d 0a 20 20 20 20 74 65 73 74 63 61 73 }. testcas
d070: 65 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d e( pPage->nCell=
d080: 3d 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 3b =MX_CELL(pBt) );
d090: 0a 0a 20 20 20 20 2f 2a 20 41 20 6d 61 6c 66 6f .. /* A malfo
d0a0: 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 61 rmed database pa
d0b0: 67 65 20 6d 69 67 68 74 20 63 61 75 73 65 20 75 ge might cause u
d0c0: 73 20 74 6f 20 72 65 61 64 20 70 61 73 74 20 74 s to read past t
d0d0: 68 65 20 65 6e 64 0a 20 20 20 20 2a 2a 20 6f 66 he end. ** of
d0e0: 20 70 61 67 65 20 77 68 65 6e 20 70 61 72 73 69 page when parsi
d0f0: 6e 67 20 61 20 63 65 6c 6c 2e 20 20 0a 20 20 20 ng a cell. .
d100: 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 **. ** The f
d110: 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6f ollowing block o
d120: 66 20 63 6f 64 65 20 63 68 65 63 6b 73 20 65 61 f code checks ea
d130: 72 6c 79 20 74 6f 20 73 65 65 20 69 66 20 61 20 rly to see if a
d140: 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a 20 20 20 cell extends.
d150: 20 2a 2a 20 70 61 73 74 20 74 68 65 20 65 6e 64 ** past the end
d160: 20 6f 66 20 61 20 70 61 67 65 20 62 6f 75 6e 64 of a page bound
d170: 61 72 79 20 61 6e 64 20 63 61 75 73 65 73 20 53 ary and causes S
d180: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 74 6f QLITE_CORRUPT to
d190: 20 62 65 20 0a 20 20 20 20 2a 2a 20 72 65 74 75 be . ** retu
d1a0: 72 6e 65 64 20 69 66 20 69 74 20 64 6f 65 73 2e rned if it does.
d1b0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 43 65 6c . */. iCel
d1c0: 6c 46 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 66 lFirst = cellOff
d1d0: 73 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e set + 2*pPage->n
d1e0: 43 65 6c 6c 3b 0a 20 20 20 20 69 43 65 6c 6c 4c Cell;. iCellL
d1f0: 61 73 74 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 ast = usableSize
d200: 20 2d 20 34 3b 0a 23 69 66 20 64 65 66 69 6e 65 - 4;.#if define
d210: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f d(SQLITE_ENABLE_
d220: 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 OVERSIZE_CELL_CH
d230: 45 43 4b 29 0a 20 20 20 20 7b 0a 20 20 20 20 20 ECK). {.
d240: 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 int i;
d250: 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 6e 74 6f /* Index into
d260: 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 the cell pointe
d270: 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 20 20 20 r array */.
d280: 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 20 int sz;
d290: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 /* Size of a
d2a0: 63 65 6c 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 69 cell */.. i
d2b0: 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 f( !pPage->leaf
d2c0: 29 20 69 43 65 6c 6c 4c 61 73 74 2d 2d 3b 0a 20 ) iCellLast--;.
d2d0: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c for(i=0; i<
d2e0: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 20 69 2b pPage->nCell; i+
d2f0: 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 63 20 3d +){. pc =
d300: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
d310: 63 65 6c 6c 4f 66 66 73 65 74 2b 69 2a 32 5d 29 cellOffset+i*2])
d320: 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
d330: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 se( pc==iCellFir
d340: 73 74 20 29 3b 0a 20 20 20 20 20 20 20 20 74 65 st );. te
d350: 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 6c stcase( pc==iCel
d360: 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 20 20 20 lLast );.
d370: 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 69 72 if( pc<iCellFir
d380: 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c 4c 61 st || pc>iCellLa
d390: 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 st ){.
d3a0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
d3b0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
d3c0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 7a }. sz
d3d0: 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 = cellSizePtr(p
d3e0: 50 61 67 65 2c 20 26 64 61 74 61 5b 70 63 5d 29 Page, &data[pc])
d3f0: 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
d400: 73 65 28 20 70 63 2b 73 7a 3d 3d 75 73 61 62 6c se( pc+sz==usabl
d410: 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 20 eSize );.
d420: 20 69 66 28 20 70 63 2b 73 7a 3e 75 73 61 62 6c if( pc+sz>usabl
d430: 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 eSize ){.
d440: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
d450: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
d460: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
d470: 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 . if( !pPag
d480: 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c 4c e->leaf ) iCellL
d490: 61 73 74 2b 2b 3b 0a 20 20 20 20 7d 20 20 0a 23 ast++;. } .#
d4a0: 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 43 6f endif.. /* Co
d4b0: 6d 70 75 74 65 20 74 68 65 20 74 6f 74 61 6c 20 mpute the total
d4c0: 66 72 65 65 20 73 70 61 63 65 20 6f 6e 20 74 68 free space on th
d4d0: 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 70 63 e page */. pc
d4e0: 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 = get2byte(&dat
d4f0: 61 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 20 6e a[hdr+1]);. n
d500: 46 72 65 65 20 3d 20 64 61 74 61 5b 68 64 72 2b Free = data[hdr+
d510: 37 5d 20 2b 20 74 6f 70 3b 0a 20 20 20 20 77 68 7] + top;. wh
d520: 69 6c 65 28 20 70 63 3e 30 20 29 7b 0a 20 20 20 ile( pc>0 ){.
d530: 20 20 20 75 31 36 20 6e 65 78 74 2c 20 73 69 7a u16 next, siz
d540: 65 3b 0a 20 20 20 20 20 20 69 66 28 20 70 63 3c e;. if( pc<
d550: 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 iCellFirst || pc
d560: 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 >iCellLast ){.
d570: 20 20 20 20 20 20 2f 2a 20 53 74 61 72 74 20 6f /* Start o
d580: 66 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 73 20 f free block is
d590: 6f 66 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a off the page */.
d5a0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
d5b0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
d5c0: 50 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20 PT; . }.
d5d0: 20 20 20 6e 65 78 74 20 3d 20 67 65 74 32 62 79 next = get2by
d5e0: 74 65 28 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 te(&data[pc]);.
d5f0: 20 20 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 size = get2
d600: 62 79 74 65 28 26 64 61 74 61 5b 70 63 2b 32 5d byte(&data[pc+2]
d610: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 28 6e 65 );. if( (ne
d620: 78 74 3e 30 20 26 26 20 6e 65 78 74 3c 3d 70 63 xt>0 && next<=pc
d630: 2b 73 69 7a 65 2b 33 29 20 7c 7c 20 70 63 2b 73 +size+3) || pc+s
d640: 69 7a 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 ize>usableSize )
d650: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 {. /* Fre
d660: 65 20 62 6c 6f 63 6b 73 20 6d 75 73 74 20 62 65 e blocks must be
d670: 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 in ascending or
d680: 64 65 72 2e 20 41 6e 64 20 74 68 65 20 6c 61 73 der. And the las
d690: 74 20 62 79 74 65 20 6f 66 0a 20 20 20 20 20 20 t byte of.
d6a0: 20 20 2a 2a 20 74 68 65 20 66 72 65 65 2d 62 6c ** the free-bl
d6b0: 6f 63 6b 20 6d 75 73 74 20 6c 69 65 20 6f 6e 20 ock must lie on
d6c0: 74 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 the database pag
d6d0: 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 e. */. r
d6e0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
d6f0: 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 20 RUPT_BKPT; .
d700: 20 20 7d 0a 20 20 20 20 20 20 6e 46 72 65 65 20 }. nFree
d710: 3d 20 6e 46 72 65 65 20 2b 20 73 69 7a 65 3b 0a = nFree + size;.
d720: 20 20 20 20 20 20 70 63 20 3d 20 6e 65 78 74 3b pc = next;
d730: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 . }.. /* A
d740: 74 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 6e 46 t this point, nF
d750: 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 ree contains the
d760: 20 73 75 6d 20 6f 66 20 74 68 65 20 6f 66 66 73 sum of the offs
d770: 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 0a et to the start.
d780: 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 63 65 ** of the ce
d790: 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 ll-content area
d7a0: 70 6c 75 73 20 74 68 65 20 6e 75 6d 62 65 72 20 plus the number
d7b0: 6f 66 20 66 72 65 65 20 62 79 74 65 73 20 77 69 of free bytes wi
d7c0: 74 68 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 thin. ** the
d7d0: 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 cell-content are
d7e0: 61 2e 20 49 66 20 74 68 69 73 20 69 73 20 67 72 a. If this is gr
d7f0: 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 75 eater than the u
d800: 73 61 62 6c 65 2d 73 69 7a 65 0a 20 20 20 20 2a sable-size. *
d810: 2a 20 6f 66 20 74 68 65 20 70 61 67 65 2c 20 74 * of the page, t
d820: 68 65 6e 20 74 68 65 20 70 61 67 65 20 6d 75 73 hen the page mus
d830: 74 20 62 65 20 63 6f 72 72 75 70 74 65 64 2e 20 t be corrupted.
d840: 54 68 69 73 20 63 68 65 63 6b 20 61 6c 73 6f 0a This check also.
d850: 20 20 20 20 2a 2a 20 73 65 72 76 65 73 20 74 6f ** serves to
d860: 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 verify that the
d870: 20 6f 66 66 73 65 74 20 74 6f 20 74 68 65 20 73 offset to the s
d880: 74 61 72 74 20 6f 66 20 74 68 65 20 63 65 6c 6c tart of the cell
d890: 2d 63 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 -content. **
d8a0: 61 72 65 61 2c 20 61 63 63 6f 72 64 69 6e 67 20 area, according
d8b0: 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 61 64 to the page head
d8c0: 65 72 2c 20 6c 69 65 73 20 77 69 74 68 69 6e 20 er, lies within
d8d0: 74 68 65 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f the page.. */
d8e0: 0a 20 20 20 20 69 66 28 20 6e 46 72 65 65 3e 75 . if( nFree>u
d8f0: 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 sableSize ){.
d900: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
d910: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a _CORRUPT_BKPT; .
d920: 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 2d }. pPage-
d930: 3e 6e 46 72 65 65 20 3d 20 28 75 31 36 29 28 6e >nFree = (u16)(n
d940: 46 72 65 65 20 2d 20 69 43 65 6c 6c 46 69 72 73 Free - iCellFirs
d950: 74 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 t);. pPage->i
d960: 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 sInit = 1;. }.
d970: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
d980: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 K;.}../*.** Set
d990: 75 70 20 61 20 72 61 77 20 70 61 67 65 20 73 6f up a raw page so
d9a0: 20 74 68 61 74 20 69 74 20 6c 6f 6f 6b 73 20 6c that it looks l
d9b0: 69 6b 65 20 61 20 64 61 74 61 62 61 73 65 20 70 ike a database p
d9c0: 61 67 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6e age holding.** n
d9d0: 6f 20 65 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 74 o entries..*/.st
d9e0: 61 74 69 63 20 76 6f 69 64 20 7a 65 72 6f 50 61 atic void zeroPa
d9f0: 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ge(MemPage *pPag
da00: 65 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 e, int flags){.
da10: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
da20: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
da30: 61 74 61 3b 0a 20 20 42 74 53 68 61 72 65 64 20 ata;. BtShared
da40: 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 *pBt = pPage->pB
da50: 74 3b 0a 20 20 75 38 20 68 64 72 20 3d 20 70 50 t;. u8 hdr = pP
da60: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
da70: 20 20 75 31 36 20 66 69 72 73 74 3b 0a 0a 20 20 u16 first;..
da80: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
da90: 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 agerPagenumber(p
daa0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d Page->pDbPage)==
dab0: 70 50 61 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a 20 pPage->pgno );.
dac0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
dad0: 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 PagerGetExtra(pP
dae0: 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d age->pDbPage) ==
daf0: 20 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b (void*)pPage );
db00: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
db10: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
db20: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d Page->pDbPage) =
db30: 3d 20 64 61 74 61 20 29 3b 0a 20 20 61 73 73 65 = data );. asse
db40: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
db50: 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
db60: 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
db70: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
db80: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
db90: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
dba0: 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
dbb0: 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
dbc0: 54 45 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 TE ){. memset
dbd0: 28 26 64 61 74 61 5b 68 64 72 5d 2c 20 30 2c 20 (&data[hdr], 0,
dbe0: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
dbf0: 2d 20 68 64 72 29 3b 0a 20 20 7d 0a 20 20 64 61 - hdr);. }. da
dc00: 74 61 5b 68 64 72 5d 20 3d 20 28 63 68 61 72 29 ta[hdr] = (char)
dc10: 66 6c 61 67 73 3b 0a 20 20 66 69 72 73 74 20 3d flags;. first =
dc20: 20 68 64 72 20 2b 20 28 28 66 6c 61 67 73 26 50 hdr + ((flags&P
dc30: 54 46 5f 4c 45 41 46 29 3d 3d 30 20 3f 20 31 32 TF_LEAF)==0 ? 12
dc40: 20 3a 20 38 29 3b 0a 20 20 6d 65 6d 73 65 74 28 : 8);. memset(
dc50: 26 64 61 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c &data[hdr+1], 0,
dc60: 20 34 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 4);. data[hdr+
dc70: 37 5d 20 3d 20 30 3b 0a 20 20 70 75 74 32 62 79 7] = 0;. put2by
dc80: 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c te(&data[hdr+5],
dc90: 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
dca0: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 );. pPage->nFre
dcb0: 65 20 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 75 e = (u16)(pBt->u
dcc0: 73 61 62 6c 65 53 69 7a 65 20 2d 20 66 69 72 73 sableSize - firs
dcd0: 74 29 3b 0a 20 20 64 65 63 6f 64 65 46 6c 61 67 t);. decodeFlag
dce0: 73 28 70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b s(pPage, flags);
dcf0: 0a 20 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 . pPage->cellOf
dd00: 66 73 65 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 fset = first;.
dd10: 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
dd20: 3d 20 26 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 = &data[pBt->usa
dd30: 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 bleSize];. pPag
dd40: 65 2d 3e 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 e->aCellIdx = &d
dd50: 61 74 61 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 ata[first];. pP
dd60: 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d age->nOverflow =
dd70: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 0;. assert( pB
dd80: 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 t->pageSize>=512
dd90: 20 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a && pBt->pageSiz
dda0: 65 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 70 50 e<=65536 );. pP
ddb0: 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 age->maskPage =
ddc0: 28 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 (u16)(pBt->pageS
ddd0: 69 7a 65 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 ize - 1);. pPag
dde0: 65 2d 3e 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 e->nCell = 0;.
ddf0: 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 pPage->isInit =
de00: 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 1;.}.../*.** Con
de10: 76 65 72 74 20 61 20 44 62 50 61 67 65 20 6f 62 vert a DbPage ob
de20: 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 tained from the
de30: 70 61 67 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d pager into a Mem
de40: 50 61 67 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 Page used by.**
de50: 74 68 65 20 62 74 72 65 65 20 6c 61 79 65 72 2e the btree layer.
de60: 0a 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 .*/.static MemPa
de70: 67 65 20 2a 62 74 72 65 65 50 61 67 65 46 72 6f ge *btreePageFro
de80: 6d 44 62 50 61 67 65 28 44 62 50 61 67 65 20 2a mDbPage(DbPage *
de90: 70 44 62 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 pDbPage, Pgno pg
dea0: 6e 6f 2c 20 42 74 53 68 61 72 65 64 20 2a 70 42 no, BtShared *pB
deb0: 74 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 t){. MemPage *p
dec0: 50 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a Page = (MemPage*
ded0: 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 )sqlite3PagerGet
dee0: 45 78 74 72 61 28 70 44 62 50 61 67 65 29 3b 0a Extra(pDbPage);.
def0: 20 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 3d pPage->aData =
df00: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
df10: 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a 20 Data(pDbPage);.
df20: 20 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 20 pPage->pDbPage
df30: 3d 20 70 44 62 50 61 67 65 3b 0a 20 20 70 50 61 = pDbPage;. pPa
df40: 67 65 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 ge->pBt = pBt;.
df50: 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 70 pPage->pgno = p
df60: 67 6e 6f 3b 0a 20 20 70 50 61 67 65 2d 3e 68 64 gno;. pPage->hd
df70: 72 4f 66 66 73 65 74 20 3d 20 70 50 61 67 65 2d rOffset = pPage-
df80: 3e 70 67 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a >pgno==1 ? 100 :
df90: 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 0;. return pPa
dfa0: 67 65 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 ge; .}../*.** Ge
dfb0: 74 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 t a page from th
dfc0: 65 20 70 61 67 65 72 2e 20 20 49 6e 69 74 69 61 e pager. Initia
dfd0: 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 lize the MemPage
dfe0: 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 .pBt and.** MemP
dff0: 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e age.aData elemen
e000: 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2a ts if needed..**
e010: 0a 2a 2a 20 49 66 20 74 68 65 20 6e 6f 43 6f 6e .** If the noCon
e020: 74 65 6e 74 20 66 6c 61 67 20 69 73 20 73 65 74 tent flag is set
e030: 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 , it means that
e040: 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 65 20 61 we do not care a
e050: 62 6f 75 74 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 bout.** the cont
e060: 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 ent of the page
e070: 61 74 20 74 68 69 73 20 74 69 6d 65 2e 20 20 53 at this time. S
e080: 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 74 6f 20 74 o do not go to t
e090: 68 65 20 64 69 73 6b 0a 2a 2a 20 74 6f 20 66 65 he disk.** to fe
e0a0: 74 63 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 2e tch the content.
e0b0: 20 20 4a 75 73 74 20 66 69 6c 6c 20 69 6e 20 74 Just fill in t
e0c0: 68 65 20 63 6f 6e 74 65 6e 74 20 77 69 74 68 20 he content with
e0d0: 7a 65 72 6f 73 20 66 6f 72 20 6e 6f 77 2e 0a 2a zeros for now..*
e0e0: 2a 20 49 66 20 69 6e 20 74 68 65 20 66 75 74 75 * If in the futu
e0f0: 72 65 20 77 65 20 63 61 6c 6c 20 73 71 6c 69 74 re we call sqlit
e100: 65 33 50 61 67 65 72 57 72 69 74 65 28 29 20 6f e3PagerWrite() o
e110: 6e 20 74 68 69 73 20 70 61 67 65 2c 20 74 68 61 n this page, tha
e120: 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 65 20 68 61 t.** means we ha
e130: 76 65 20 73 74 61 72 74 65 64 20 74 6f 20 62 65 ve started to be
e140: 20 63 6f 6e 63 65 72 6e 65 64 20 61 62 6f 75 74 concerned about
e150: 20 63 6f 6e 74 65 6e 74 20 61 6e 64 20 74 68 65 content and the
e160: 20 64 69 73 6b 0a 2a 2a 20 72 65 61 64 20 73 68 disk.** read sh
e170: 6f 75 6c 64 20 6f 63 63 75 72 20 61 74 20 74 68 ould occur at th
e180: 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74 61 at point..*/.sta
e190: 74 69 63 20 69 6e 74 20 62 74 72 65 65 47 65 74 tic int btreeGet
e1a0: 50 61 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 Page(. BtShared
e1b0: 20 2a 70 42 74 2c 20 20 20 20 20 20 20 2f 2a 20 *pBt, /*
e1c0: 54 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 50 The btree */. P
e1d0: 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 gno pgno,
e1e0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
e1f0: 20 74 68 65 20 70 61 67 65 20 74 6f 20 66 65 74 the page to fet
e200: 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 ch */. MemPage
e210: 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 **ppPage, /*
e220: 52 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 20 Return the page
e230: 69 6e 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 in this paramete
e240: 72 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 r */. int flags
e250: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
e260: 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 AGER_GET_NOCONTE
e270: 4e 54 20 6f 72 20 50 41 47 45 52 5f 47 45 54 5f NT or PAGER_GET_
e280: 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 READONLY */.){.
e290: 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 50 61 67 int rc;. DbPag
e2a0: 65 20 2a 70 44 62 50 61 67 65 3b 0a 0a 20 20 61 e *pDbPage;.. a
e2b0: 73 73 65 72 74 28 20 66 6c 61 67 73 3d 3d 30 20 ssert( flags==0
e2c0: 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 45 52 5f || flags==PAGER_
e2d0: 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 7c 7c GET_NOCONTENT ||
e2e0: 20 66 6c 61 67 73 3d 3d 50 41 47 45 52 5f 47 45 flags==PAGER_GE
e2f0: 54 5f 52 45 41 44 4f 4e 4c 59 20 29 3b 0a 20 20 T_READONLY );.
e300: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
e310: 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
e320: 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d mutex) );. rc =
e330: 20 73 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 sqlite3PagerAcq
e340: 75 69 72 65 28 70 42 74 2d 3e 70 50 61 67 65 72 uire(pBt->pPager
e350: 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 2a , pgno, (DbPage*
e360: 2a 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 67 *)&pDbPage, flag
e370: 73 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 s);. if( rc ) r
e380: 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 eturn rc;. *ppP
e390: 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 age = btreePageF
e3a0: 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 romDbPage(pDbPag
e3b0: 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 e, pgno, pBt);.
e3c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
e3d0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 K;.}../*.** Retr
e3e0: 69 65 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d ieve a page from
e3f0: 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
e400: 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 74 . If the request
e410: 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a ed page is not.*
e420: 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 * already in the
e430: 20 70 61 67 65 72 20 63 61 63 68 65 20 72 65 74 pager cache ret
e440: 75 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 urn NULL. Initia
e450: 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 lize the MemPage
e460: 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 .pBt and.** MemP
e470: 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e age.aData elemen
e480: 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f ts if needed..*/
e490: 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 .static MemPage
e4a0: 2a 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 *btreePageLookup
e4b0: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
e4c0: 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 Pgno pgno){. Db
e4d0: 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 Page *pDbPage;.
e4e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
e4f0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
e500: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 >mutex) );. pDb
e510: 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 Page = sqlite3Pa
e520: 67 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 gerLookup(pBt->p
e530: 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 Pager, pgno);.
e540: 69 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 if( pDbPage ){.
e550: 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 return btreeP
e560: 61 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 ageFromDbPage(pD
e570: 62 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 bPage, pgno, pBt
e580: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
e590: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
e5a0: 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 rn the size of t
e5b0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
e5c0: 20 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 in pages. If th
e5d0: 65 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 ere is any kind
e5e0: 6f 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 of.** error, ret
e5f0: 75 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 urn ((unsigned i
e600: 6e 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 nt)-1)..*/.stati
e610: 63 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 c Pgno btreePage
e620: 63 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a count(BtShared *
e630: 70 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 pBt){. return p
e640: 42 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 Bt->nPage;.}.u32
e650: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 sqlite3BtreeLas
e660: 74 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b tPage(Btree *p){
e670: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
e680: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
e690: 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
e6a0: 28 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 ( ((p->pBt->nPag
e6b0: 65 29 26 30 78 38 30 30 30 30 30 30 29 3d 3d 30 e)&0x8000000)==0
e6c0: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 74 72 );. return btr
e6d0: 65 65 50 61 67 65 63 6f 75 6e 74 28 70 2d 3e 70 eePagecount(p->p
e6e0: 42 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 Bt);.}../*.** Ge
e6f0: 74 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 t a page from th
e700: 65 20 70 61 67 65 72 20 61 6e 64 20 69 6e 69 74 e pager and init
e710: 69 61 6c 69 7a 65 20 69 74 2e 20 20 54 68 69 73 ialize it. This
e720: 20 72 6f 75 74 69 6e 65 20 69 73 20 6a 75 73 74 routine is just
e730: 20 61 0a 2a 2a 20 63 6f 6e 76 65 6e 69 65 6e 63 a.** convenienc
e740: 65 20 77 72 61 70 70 65 72 20 61 72 6f 75 6e 64 e wrapper around
e750: 20 73 65 70 61 72 61 74 65 20 63 61 6c 6c 73 20 separate calls
e760: 74 6f 20 62 74 72 65 65 47 65 74 50 61 67 65 28 to btreeGetPage(
e770: 29 20 61 6e 64 20 0a 2a 2a 20 62 74 72 65 65 49 ) and .** btreeI
e780: 6e 69 74 50 61 67 65 28 29 2e 0a 2a 2a 0a 2a 2a nitPage()..**.**
e790: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
e7a0: 75 72 73 2c 20 74 68 65 6e 20 74 68 65 20 76 61 urs, then the va
e7b0: 6c 75 65 20 2a 70 70 50 61 67 65 20 69 73 20 73 lue *ppPage is s
e7c0: 65 74 20 74 6f 20 69 73 20 75 6e 64 65 66 69 6e et to is undefin
e7d0: 65 64 2e 20 49 74 0a 2a 2a 20 6d 61 79 20 72 65 ed. It.** may re
e7e0: 6d 61 69 6e 20 75 6e 63 68 61 6e 67 65 64 2c 20 main unchanged,
e7f0: 6f 72 20 69 74 20 6d 61 79 20 62 65 20 73 65 74 or it may be set
e800: 20 74 6f 20 61 6e 20 69 6e 76 61 6c 69 64 20 76 to an invalid v
e810: 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 alue..*/.static
e820: 69 6e 74 20 67 65 74 41 6e 64 49 6e 69 74 50 61 int getAndInitPa
e830: 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a ge(. BtShared *
e840: 70 42 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 pBt,
e850: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
e860: 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
e870: 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 Pgno pgno,
e880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e890: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 /* Number of the
e8a0: 20 70 61 67 65 20 74 6f 20 67 65 74 20 2a 2f 0a page to get */.
e8b0: 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 MemPage **ppPa
e8c0: 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ge,
e8d0: 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 70 /* Write the p
e8e0: 61 67 65 20 70 6f 69 6e 74 65 72 20 68 65 72 65 age pointer here
e8f0: 20 2a 2f 0a 20 20 69 6e 74 20 62 52 65 61 64 6f */. int bReado
e900: 6e 6c 79 20 20 20 20 20 20 20 20 20 20 20 20 20 nly
e910: 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f 47 /* PAGER_G
e920: 45 54 5f 52 45 41 44 4f 4e 4c 59 20 6f 72 20 30 ET_READONLY or 0
e930: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b */.){. int rc;
e940: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
e950: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
e960: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
e970: 73 73 65 72 74 28 20 62 52 65 61 64 6f 6e 6c 79 ssert( bReadonly
e980: 3d 3d 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 ==PAGER_GET_READ
e990: 4f 4e 4c 59 20 7c 7c 20 62 52 65 61 64 6f 6e 6c ONLY || bReadonl
e9a0: 79 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 70 y==0 );.. if( p
e9b0: 67 6e 6f 3e 62 74 72 65 65 50 61 67 65 63 6f 75 gno>btreePagecou
e9c0: 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 72 nt(pBt) ){. r
e9d0: 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
e9e0: 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 PT_BKPT;. }else
e9f0: 7b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 {. rc = btree
ea00: 47 65 74 50 61 67 65 28 70 42 74 2c 20 70 67 6e GetPage(pBt, pgn
ea10: 6f 2c 20 70 70 50 61 67 65 2c 20 62 52 65 61 64 o, ppPage, bRead
ea20: 6f 6e 6c 79 29 3b 0a 20 20 20 20 69 66 28 20 72 only);. if( r
ea30: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
ea40: 28 2a 70 70 50 61 67 65 29 2d 3e 69 73 49 6e 69 (*ppPage)->isIni
ea50: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 t==0 ){. rc
ea60: 20 3d 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 = btreeInitPage
ea70: 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 (*ppPage);.
ea80: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
ea90: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 OK ){. re
eaa0: 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 leasePage(*ppPag
eab0: 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 e);. }.
eac0: 7d 0a 20 20 7d 0a 0a 20 20 74 65 73 74 63 61 73 }. }.. testcas
ead0: 65 28 20 70 67 6e 6f 3d 3d 30 20 29 3b 0a 20 20 e( pgno==0 );.
eae0: 61 73 73 65 72 74 28 20 70 67 6e 6f 21 3d 30 20 assert( pgno!=0
eaf0: 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 43 4f || rc==SQLITE_CO
eb00: 52 52 55 50 54 20 29 3b 0a 20 20 72 65 74 75 72 RRUPT );. retur
eb10: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
eb20: 65 6c 65 61 73 65 20 61 20 4d 65 6d 50 61 67 65 elease a MemPage
eb30: 2e 20 20 54 68 69 73 20 73 68 6f 75 6c 64 20 62 . This should b
eb40: 65 20 63 61 6c 6c 65 64 20 6f 6e 63 65 20 66 6f e called once fo
eb50: 72 20 65 61 63 68 20 70 72 69 6f 72 0a 2a 2a 20 r each prior.**
eb60: 63 61 6c 6c 20 74 6f 20 62 74 72 65 65 47 65 74 call to btreeGet
eb70: 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 Page..*/.static
eb80: 76 6f 69 64 20 72 65 6c 65 61 73 65 50 61 67 65 void releasePage
eb90: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
eba0: 7b 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b {. if( pPage ){
ebb0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
ebc0: 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 20 ge->aData );.
ebd0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
ebe0: 70 42 74 20 29 3b 0a 20 20 20 20 61 73 73 65 72 pBt );. asser
ebf0: 74 28 20 70 50 61 67 65 2d 3e 70 44 62 50 61 67 t( pPage->pDbPag
ec00: 65 21 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 e!=0 );. asse
ec10: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
ec20: 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d 3e GetExtra(pPage->
ec30: 70 44 62 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 pDbPage) == (voi
ec40: 64 2a 29 70 50 61 67 65 20 29 3b 0a 20 20 20 20 d*)pPage );.
ec50: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
ec60: 61 67 65 72 47 65 74 44 61 74 61 28 70 50 61 67 agerGetData(pPag
ec70: 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 50 61 e->pDbPage)==pPa
ec80: 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 20 ge->aData );.
ec90: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
eca0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
ecb0: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
ecc0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 ;. sqlite3Pag
ecd0: 65 72 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 70 erUnrefNotNull(p
ece0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a Page->pDbPage);.
ecf0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 }.}../*.** Dur
ed00: 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 ing a rollback,
ed10: 77 68 65 6e 20 74 68 65 20 70 61 67 65 72 20 72 when the pager r
ed20: 65 6c 6f 61 64 73 20 69 6e 66 6f 72 6d 61 74 69 eloads informati
ed30: 6f 6e 20 69 6e 74 6f 20 74 68 65 20 63 61 63 68 on into the cach
ed40: 65 0a 2a 2a 20 73 6f 20 74 68 61 74 20 74 68 65 e.** so that the
ed50: 20 63 61 63 68 65 20 69 73 20 72 65 73 74 6f 72 cache is restor
ed60: 65 64 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e ed to its origin
ed70: 61 6c 20 73 74 61 74 65 20 61 74 20 74 68 65 20 al state at the
ed80: 73 74 61 72 74 20 6f 66 0a 2a 2a 20 74 68 65 20 start of.** the
ed90: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 66 6f 72 transaction, for
eda0: 20 65 61 63 68 20 70 61 67 65 20 72 65 73 74 6f each page resto
edb0: 72 65 64 20 74 68 69 73 20 72 6f 75 74 69 6e 65 red this routine
edc0: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a is called..**.*
edd0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6e * This routine n
ede0: 65 65 64 73 20 74 6f 20 72 65 73 65 74 20 74 68 eeds to reset th
edf0: 65 20 65 78 74 72 61 20 64 61 74 61 20 73 65 63 e extra data sec
ee00: 74 69 6f 6e 20 61 74 20 74 68 65 20 65 6e 64 20 tion at the end
ee10: 6f 66 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 of the.** page t
ee20: 6f 20 61 67 72 65 65 20 77 69 74 68 20 74 68 65 o agree with the
ee30: 20 72 65 73 74 6f 72 65 64 20 64 61 74 61 2e 0a restored data..
ee40: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
ee50: 61 67 65 52 65 69 6e 69 74 28 44 62 50 61 67 65 ageReinit(DbPage
ee60: 20 2a 70 44 61 74 61 29 7b 0a 20 20 4d 65 6d 50 *pData){. MemP
ee70: 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 20 70 50 age *pPage;. pP
ee80: 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 20 2a age = (MemPage *
ee90: 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 )sqlite3PagerGet
eea0: 45 78 74 72 61 28 70 44 61 74 61 29 3b 0a 20 20 Extra(pData);.
eeb0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
eec0: 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 agerPageRefcount
eed0: 28 70 44 61 74 61 29 3e 30 20 29 3b 0a 20 20 69 (pData)>0 );. i
eee0: 66 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 f( pPage->isInit
eef0: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
ef00: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
ef10: 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d ld(pPage->pBt->m
ef20: 75 74 65 78 29 20 29 3b 0a 20 20 20 20 70 50 61 utex) );. pPa
ef30: 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b 0a ge->isInit = 0;.
ef40: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 if( sqlite3P
ef50: 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 agerPageRefcount
ef60: 28 70 44 61 74 61 29 3e 31 20 29 7b 0a 20 20 20 (pData)>1 ){.
ef70: 20 20 20 2f 2a 20 70 50 61 67 65 20 6d 69 67 68 /* pPage migh
ef80: 74 20 6e 6f 74 20 62 65 20 61 20 62 74 72 65 65 t not be a btree
ef90: 20 70 61 67 65 3b 20 20 69 74 20 6d 69 67 68 74 page; it might
efa0: 20 62 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 be an overflow
efb0: 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 6f 72 page. ** or
efc0: 20 70 74 72 6d 61 70 20 70 61 67 65 20 6f 72 20 ptrmap page or
efd0: 61 20 66 72 65 65 20 70 61 67 65 2e 20 20 49 6e a free page. In
efe0: 20 74 68 6f 73 65 20 63 61 73 65 73 2c 20 74 68 those cases, th
eff0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 e following.
f000: 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 62 74 72 ** call to btr
f010: 65 65 49 6e 69 74 50 61 67 65 28 29 20 77 69 6c eeInitPage() wil
f020: 6c 20 6c 69 6b 65 6c 79 20 72 65 74 75 72 6e 20 l likely return
f030: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e 0a SQLITE_CORRUPT..
f040: 20 20 20 20 20 20 2a 2a 20 42 75 74 20 6e 6f 20 ** But no
f050: 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 62 79 20 harm is done by
f060: 74 68 69 73 2e 20 20 41 6e 64 20 69 74 20 69 73 this. And it is
f070: 20 76 65 72 79 20 69 6d 70 6f 72 74 61 6e 74 20 very important
f080: 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 62 74 that. ** bt
f090: 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 62 65 reeInitPage() be
f0a0: 20 63 61 6c 6c 65 64 20 6f 6e 20 65 76 65 72 79 called on every
f0b0: 20 62 74 72 65 65 20 70 61 67 65 20 73 6f 20 77 btree page so w
f0c0: 65 20 6d 61 6b 65 0a 20 20 20 20 20 20 2a 2a 20 e make. **
f0d0: 74 68 65 20 63 61 6c 6c 20 66 6f 72 20 65 76 65 the call for eve
f0e0: 72 79 20 70 61 67 65 20 74 68 61 74 20 63 6f 6d ry page that com
f0f0: 65 73 20 69 6e 20 66 6f 72 20 72 65 2d 69 6e 69 es in for re-ini
f100: 74 69 6e 67 2e 20 2a 2f 0a 20 20 20 20 20 20 62 ting. */. b
f110: 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 treeInitPage(pPa
f120: 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d ge);. }. }.}
f130: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 ../*.** Invoke t
f140: 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 72 20 he busy handler
f150: 66 6f 72 20 61 20 62 74 72 65 65 2e 0a 2a 2f 0a for a btree..*/.
f160: 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 static int btree
f170: 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
f180: 72 28 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 r(void *pArg){.
f190: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
f1a0: 20 28 42 74 53 68 61 72 65 64 2a 29 70 41 72 67 (BtShared*)pArg
f1b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d ;. assert( pBt-
f1c0: 3e 64 62 20 29 3b 0a 20 20 61 73 73 65 72 74 28 >db );. assert(
f1d0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
f1e0: 65 6c 64 28 70 42 74 2d 3e 64 62 2d 3e 6d 75 74 eld(pBt->db->mut
f1f0: 65 78 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 ex) );. return
f200: 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 sqlite3InvokeBus
f210: 79 48 61 6e 64 6c 65 72 28 26 70 42 74 2d 3e 64 yHandler(&pBt->d
f220: 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 29 3b b->busyHandler);
f230: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 .}../*.** Open a
f240: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a database file..
f250: 2a 2a 20 0a 2a 2a 20 7a 46 69 6c 65 6e 61 6d 65 ** .** zFilename
f260: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 is the name of
f270: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
f280: 65 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 e. If zFilename
f290: 20 69 73 20 4e 55 4c 4c 0a 2a 2a 20 74 68 65 6e is NULL.** then
f2a0: 20 61 6e 20 65 70 68 65 6d 65 72 61 6c 20 64 61 an ephemeral da
f2b0: 74 61 62 61 73 65 20 69 73 20 63 72 65 61 74 65 tabase is create
f2c0: 64 2e 20 20 54 68 65 20 65 70 68 65 6d 65 72 61 d. The ephemera
f2d0: 6c 20 64 61 74 61 62 61 73 65 20 6d 69 67 68 74 l database might
f2e0: 0a 2a 2a 20 62 65 20 65 78 63 6c 75 73 69 76 65 .** be exclusive
f2f0: 6c 79 20 69 6e 20 6d 65 6d 6f 72 79 2c 20 6f 72 ly in memory, or
f300: 20 69 74 20 6d 69 67 68 74 20 75 73 65 20 61 20 it might use a
f310: 64 69 73 6b 2d 62 61 73 65 64 20 6d 65 6d 6f 72 disk-based memor
f320: 79 20 63 61 63 68 65 2e 0a 2a 2a 20 45 69 74 68 y cache..** Eith
f330: 65 72 20 77 61 79 2c 20 74 68 65 20 65 70 68 65 er way, the ephe
f340: 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 20 77 meral database w
f350: 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 ill be automatic
f360: 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 0a 2a 2a ally deleted .**
f370: 20 77 68 65 6e 20 73 71 6c 69 74 65 33 42 74 72 when sqlite3Btr
f380: 65 65 43 6c 6f 73 65 28 29 20 69 73 20 63 61 6c eeClose() is cal
f390: 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 7a 46 led..**.** If zF
f3a0: 69 6c 65 6e 61 6d 65 20 69 73 20 22 3a 6d 65 6d ilename is ":mem
f3b0: 6f 72 79 3a 22 20 74 68 65 6e 20 61 6e 20 69 6e ory:" then an in
f3c0: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 -memory database
f3d0: 20 69 73 20 63 72 65 61 74 65 64 0a 2a 2a 20 74 is created.** t
f3e0: 68 61 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 hat is automatic
f3f0: 61 6c 6c 79 20 64 65 73 74 72 6f 79 65 64 20 77 ally destroyed w
f400: 68 65 6e 20 69 74 20 69 73 20 63 6c 6f 73 65 64 hen it is closed
f410: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 66 6c 61 ..**.** The "fla
f420: 67 73 22 20 70 61 72 61 6d 65 74 65 72 20 69 73 gs" parameter is
f430: 20 61 20 62 69 74 6d 61 73 6b 20 74 68 61 74 20 a bitmask that
f440: 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 62 69 might contain bi
f450: 74 73 20 6c 69 6b 65 0a 2a 2a 20 42 54 52 45 45 ts like.** BTREE
f460: 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 20 61 6e _OMIT_JOURNAL an
f470: 64 2f 6f 72 20 42 54 52 45 45 5f 4d 45 4d 4f 52 d/or BTREE_MEMOR
f480: 59 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 Y..**.** If the
f490: 64 61 74 61 62 61 73 65 20 69 73 20 61 6c 72 65 database is alre
f4a0: 61 64 79 20 6f 70 65 6e 65 64 20 69 6e 20 74 68 ady opened in th
f4b0: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 e same database
f4c0: 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 61 6e connection.** an
f4d0: 64 20 77 65 20 61 72 65 20 69 6e 20 73 68 61 72 d we are in shar
f4e0: 65 64 20 63 61 63 68 65 20 6d 6f 64 65 2c 20 74 ed cache mode, t
f4f0: 68 65 6e 20 74 68 65 20 6f 70 65 6e 20 77 69 6c hen the open wil
f500: 6c 20 66 61 69 6c 20 77 69 74 68 20 61 6e 0a 2a l fail with an.*
f510: 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 * SQLITE_CONSTRA
f520: 49 4e 54 20 65 72 72 6f 72 2e 20 20 57 65 20 63 INT error. We c
f530: 61 6e 6e 6f 74 20 61 6c 6c 6f 77 20 74 77 6f 20 annot allow two
f540: 6f 72 20 6d 6f 72 65 20 42 74 53 68 61 72 65 64 or more BtShared
f550: 0a 2a 2a 20 6f 62 6a 65 63 74 73 20 69 6e 20 74 .** objects in t
f560: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 he same database
f570: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 69 6e 63 connection sinc
f580: 65 20 64 6f 69 6e 67 20 73 6f 20 77 69 6c 6c 20 e doing so will
f590: 6c 65 61 64 0a 2a 2a 20 74 6f 20 70 72 6f 62 6c lead.** to probl
f5a0: 65 6d 73 20 77 69 74 68 20 6c 6f 63 6b 69 6e 67 ems with locking
f5b0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
f5c0: 42 74 72 65 65 4f 70 65 6e 28 0a 20 20 73 71 6c BtreeOpen(. sql
f5d0: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 ite3_vfs *pVfs,
f5e0: 20 20 20 20 20 2f 2a 20 56 46 53 20 74 6f 20 75 /* VFS to u
f5f0: 73 65 20 66 6f 72 20 74 68 69 73 20 62 2d 74 72 se for this b-tr
f600: 65 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 ee */. const ch
f610: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
f620: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 /* Name of the f
f630: 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ile containing t
f640: 68 65 20 42 54 72 65 65 20 64 61 74 61 62 61 73 he BTree databas
f650: 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a e */. sqlite3 *
f660: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f db, /
f670: 2a 20 41 73 73 6f 63 69 61 74 65 64 20 64 61 74 * Associated dat
f680: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a abase handle */.
f690: 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74 72 65 Btree **ppBtre
f6a0: 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 e, /* Poi
f6b0: 6e 74 65 72 20 74 6f 20 6e 65 77 20 42 74 72 65 nter to new Btre
f6c0: 65 20 6f 62 6a 65 63 74 20 77 72 69 74 74 65 6e e object written
f6d0: 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 66 here */. int f
f6e0: 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 lags,
f6f0: 20 20 20 2f 2a 20 4f 70 74 69 6f 6e 73 20 2a 2f /* Options */
f700: 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 73 20 . int vfsFlags
f710: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c /* Fl
f720: 61 67 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 ags passed throu
f730: 67 68 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 66 gh to sqlite3_vf
f740: 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 29 7b 0a s.xOpen() */.){.
f750: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
f760: 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 0;
f770: 20 2f 2a 20 53 68 61 72 65 64 20 70 61 72 74 20 /* Shared part
f780: 6f 66 20 62 74 72 65 65 20 73 74 72 75 63 74 75 of btree structu
f790: 72 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 re */. Btree *p
f7a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
f7b0: 20 20 20 20 20 20 20 2f 2a 20 48 61 6e 64 6c 65 /* Handle
f7c0: 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 to return */.
f7d0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
f7e0: 75 74 65 78 4f 70 65 6e 20 3d 20 30 3b 20 20 2f utexOpen = 0; /
f7f0: 2a 20 50 72 65 76 65 6e 74 73 20 61 20 72 61 63 * Prevents a rac
f800: 65 20 63 6f 6e 64 69 74 69 6f 6e 2e 20 54 69 63 e condition. Tic
f810: 6b 65 74 20 23 33 35 33 37 20 2a 2f 0a 20 20 69 ket #3537 */. i
f820: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
f830: 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a K; /*
f840: 20 52 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f Result code fro
f850: 6d 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 m this function
f860: 2a 2f 0a 20 20 75 38 20 6e 52 65 73 65 72 76 65 */. u8 nReserve
f870: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
f880: 20 20 20 20 2f 2a 20 42 79 74 65 20 6f 66 20 75 /* Byte of u
f890: 6e 75 73 65 64 20 73 70 61 63 65 20 6f 6e 20 65 nused space on e
f8a0: 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 75 6e ach page */. un
f8b0: 73 69 67 6e 65 64 20 63 68 61 72 20 7a 44 62 48 signed char zDbH
f8c0: 65 61 64 65 72 5b 31 30 30 5d 3b 20 20 2f 2a 20 eader[100]; /*
f8d0: 44 61 74 61 62 61 73 65 20 68 65 61 64 65 72 20 Database header
f8e0: 63 6f 6e 74 65 6e 74 20 2a 2f 0a 0a 20 20 2f 2a content */.. /*
f8f0: 20 54 72 75 65 20 69 66 20 6f 70 65 6e 69 6e 67 True if opening
f900: 20 61 6e 20 65 70 68 65 6d 65 72 61 6c 2c 20 74 an ephemeral, t
f910: 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 emporary databas
f920: 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 e */. const int
f930: 20 69 73 54 65 6d 70 44 62 20 3d 20 7a 46 69 6c isTempDb = zFil
f940: 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 7a 46 69 6c ename==0 || zFil
f950: 65 6e 61 6d 65 5b 30 5d 3d 3d 30 3b 0a 0a 20 20 ename[0]==0;..
f960: 2f 2a 20 53 65 74 20 74 68 65 20 76 61 72 69 61 /* Set the varia
f970: 62 6c 65 20 69 73 4d 65 6d 64 62 20 74 6f 20 74 ble isMemdb to t
f980: 72 75 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 rue for an in-me
f990: 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 6f mory database, o
f9a0: 72 20 0a 20 20 2a 2a 20 66 61 6c 73 65 20 66 6f r . ** false fo
f9b0: 72 20 61 20 66 69 6c 65 2d 62 61 73 65 64 20 64 r a file-based d
f9c0: 61 74 61 62 61 73 65 2e 0a 20 20 2a 2f 0a 23 69 atabase.. */.#i
f9d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
f9e0: 5f 4d 45 4d 4f 52 59 44 42 0a 20 20 63 6f 6e 73 _MEMORYDB. cons
f9f0: 74 20 69 6e 74 20 69 73 4d 65 6d 64 62 20 3d 20 t int isMemdb =
fa00: 30 3b 0a 23 65 6c 73 65 0a 20 20 63 6f 6e 73 74 0;.#else. const
fa10: 20 69 6e 74 20 69 73 4d 65 6d 64 62 20 3d 20 28 int isMemdb = (
fa20: 7a 46 69 6c 65 6e 61 6d 65 20 26 26 20 73 74 72 zFilename && str
fa30: 63 6d 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 22 cmp(zFilename, "
fa40: 3a 6d 65 6d 6f 72 79 3a 22 29 3d 3d 30 29 0a 20 :memory:")==0).
fa50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
fa60: 20 20 20 20 20 20 7c 7c 20 28 69 73 54 65 6d 70 || (isTemp
fa70: 44 62 20 26 26 20 73 71 6c 69 74 65 33 54 65 6d Db && sqlite3Tem
fa80: 70 49 6e 4d 65 6d 6f 72 79 28 64 62 29 29 0a 20 pInMemory(db)).
fa90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
faa0: 20 20 20 20 20 20 7c 7c 20 28 76 66 73 46 6c 61 || (vfsFla
fab0: 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e gs & SQLITE_OPEN
fac0: 5f 4d 45 4d 4f 52 59 29 21 3d 30 3b 0a 23 65 6e _MEMORY)!=0;.#en
fad0: 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 64 dif.. assert( d
fae0: 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 b!=0 );. assert
faf0: 28 20 70 56 66 73 21 3d 30 20 29 3b 0a 20 20 61 ( pVfs!=0 );. a
fb00: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
fb10: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
fb20: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
fb30: 28 20 28 66 6c 61 67 73 26 30 78 66 66 29 3d 3d ( (flags&0xff)==
fb40: 66 6c 61 67 73 20 29 3b 20 20 20 2f 2a 20 66 6c flags ); /* fl
fb50: 61 67 73 20 66 69 74 20 69 6e 20 38 20 62 69 74 ags fit in 8 bit
fb60: 73 20 2a 2f 0a 0a 20 20 2f 2a 20 4f 6e 6c 79 20 s */.. /* Only
fb70: 61 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 20 64 a BTREE_SINGLE d
fb80: 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 20 42 atabase can be B
fb90: 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 20 2a TREE_UNORDERED *
fba0: 2f 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 /. assert( (fla
fbb0: 67 73 20 26 20 42 54 52 45 45 5f 55 4e 4f 52 44 gs & BTREE_UNORD
fbc0: 45 52 45 44 29 3d 3d 30 20 7c 7c 20 28 66 6c 61 ERED)==0 || (fla
fbd0: 67 73 20 26 20 42 54 52 45 45 5f 53 49 4e 47 4c gs & BTREE_SINGL
fbe0: 45 29 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 41 E)!=0 );.. /* A
fbf0: 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 20 64 61 BTREE_SINGLE da
fc00: 74 61 62 61 73 65 20 69 73 20 61 6c 77 61 79 73 tabase is always
fc10: 20 61 20 74 65 6d 70 6f 72 61 72 79 20 61 6e 64 a temporary and
fc20: 2f 6f 72 20 65 70 68 65 6d 65 72 61 6c 20 2a 2f /or ephemeral */
fc30: 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 67 . assert( (flag
fc40: 73 20 26 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 s & BTREE_SINGLE
fc50: 29 3d 3d 30 20 7c 7c 20 69 73 54 65 6d 70 44 62 )==0 || isTempDb
fc60: 20 29 3b 0a 0a 20 20 69 66 28 20 69 73 4d 65 6d );.. if( isMem
fc70: 64 62 20 29 7b 0a 20 20 20 20 66 6c 61 67 73 20 db ){. flags
fc80: 7c 3d 20 42 54 52 45 45 5f 4d 45 4d 4f 52 59 3b |= BTREE_MEMORY;
fc90: 0a 20 20 7d 0a 20 20 69 66 28 20 28 76 66 73 46 . }. if( (vfsF
fca0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
fcb0: 45 4e 5f 4d 41 49 4e 5f 44 42 29 21 3d 30 20 26 EN_MAIN_DB)!=0 &
fcc0: 26 20 28 69 73 4d 65 6d 64 62 20 7c 7c 20 69 73 & (isMemdb || is
fcd0: 54 65 6d 70 44 62 29 20 29 7b 0a 20 20 20 20 76 TempDb) ){. v
fce0: 66 73 46 6c 61 67 73 20 3d 20 28 76 66 73 46 6c fsFlags = (vfsFl
fcf0: 61 67 73 20 26 20 7e 53 51 4c 49 54 45 5f 4f 50 ags & ~SQLITE_OP
fd00: 45 4e 5f 4d 41 49 4e 5f 44 42 29 20 7c 20 53 51 EN_MAIN_DB) | SQ
fd10: 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 LITE_OPEN_TEMP_D
fd20: 42 3b 0a 20 20 7d 0a 20 20 70 20 3d 20 73 71 6c B;. }. p = sql
fd30: 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 ite3MallocZero(s
fd40: 69 7a 65 6f 66 28 42 74 72 65 65 29 29 3b 0a 20 izeof(Btree));.
fd50: 20 69 66 28 20 21 70 20 29 7b 0a 20 20 20 20 72 if( !p ){. r
fd60: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
fd70: 45 4d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 EM;. }. p->inT
fd80: 72 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e rans = TRANS_NON
fd90: 45 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62 3b E;. p->db = db;
fda0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
fdb0: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
fdc0: 45 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 E. p->lock.pBtr
fdd0: 65 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 ee = p;. p->loc
fde0: 6b 2e 69 54 61 62 6c 65 20 3d 20 31 3b 0a 23 65 k.iTable = 1;.#e
fdf0: 6e 64 69 66 0a 0a 23 69 66 20 21 64 65 66 69 6e ndif..#if !defin
fe00: 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ed(SQLITE_OMIT_S
fe10: 48 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 HARED_CACHE) &&
fe20: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
fe30: 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f OMIT_DISKIO). /
fe40: 2a 0a 20 20 2a 2a 20 49 66 20 74 68 69 73 20 42 *. ** If this B
fe50: 74 72 65 65 20 69 73 20 61 20 63 61 6e 64 69 64 tree is a candid
fe60: 61 74 65 20 66 6f 72 20 73 68 61 72 65 64 20 63 ate for shared c
fe70: 61 63 68 65 2c 20 74 72 79 20 74 6f 20 66 69 6e ache, try to fin
fe80: 64 20 61 6e 0a 20 20 2a 2a 20 65 78 69 73 74 69 d an. ** existi
fe90: 6e 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 ng BtShared obje
fea0: 63 74 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 ct that we can s
feb0: 68 61 72 65 20 77 69 74 68 0a 20 20 2a 2f 0a 20 hare with. */.
fec0: 20 69 66 28 20 69 73 54 65 6d 70 44 62 3d 3d 30 if( isTempDb==0
fed0: 20 26 26 20 28 69 73 4d 65 6d 64 62 3d 3d 30 20 && (isMemdb==0
fee0: 7c 7c 20 28 76 66 73 46 6c 61 67 73 26 53 51 4c || (vfsFlags&SQL
fef0: 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29 21 3d 30 ITE_OPEN_URI)!=0
ff00: 29 20 29 7b 0a 20 20 20 20 69 66 28 20 76 66 73 ) ){. if( vfs
ff10: 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f Flags & SQLITE_O
ff20: 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 PEN_SHAREDCACHE
ff30: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 75 ){. int nFu
ff40: 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 70 56 66 llPathname = pVf
ff50: 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 3b s->mxPathname+1;
ff60: 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 46 75 . char *zFu
ff70: 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c llPathname = sql
ff80: 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c ite3Malloc(nFull
ff90: 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 Pathname);.
ffa0: 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 MUTEX_LOGIC( sq
ffb0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 lite3_mutex *mut
ffc0: 65 78 53 68 61 72 65 64 3b 20 29 0a 20 20 20 20 exShared; ).
ffd0: 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 3d 20 p->sharable =
ffe0: 31 3b 0a 20 20 20 20 20 20 69 66 28 20 21 7a 46 1;. if( !zF
fff0: 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 7b 0a 20 ullPathname ){.
10000 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
10010 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 ree(p);.
10020 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
10030 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 MEM;. }.
10040 20 20 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 if( isMemdb )
10050 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 {. memcpy
10060 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 (zFullPathname,
10070 7a 46 69 6c 65 6e 61 6d 65 2c 20 73 71 6c 69 74 zFilename, sqlit
10080 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 e3Strlen30(zFile
10090 6e 61 6d 65 29 2b 31 29 3b 0a 20 20 20 20 20 20 name)+1);.
100a0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 72 }else{. r
100b0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 75 6c c = sqlite3OsFul
100c0 6c 50 61 74 68 6e 61 6d 65 28 70 56 66 73 2c 20 lPathname(pVfs,
100d0 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 zFilename,.
100e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
100f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 46 nF
10100 75 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 7a 46 75 ullPathname, zFu
10110 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 llPathname);.
10120 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 if( rc ){.
10130 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
10140 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e _free(zFullPathn
10150 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ame);.
10160 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b sqlite3_free(p);
10170 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
10180 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
10190 20 20 20 20 20 20 7d 0a 23 69 66 20 53 51 4c 49 }.#if SQLI
101a0 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 TE_THREADSAFE.
101b0 20 20 20 20 6d 75 74 65 78 4f 70 65 6e 20 3d 20 mutexOpen =
101c0 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
101d0 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
101e0 54 41 54 49 43 5f 4f 50 45 4e 29 3b 0a 20 20 20 TATIC_OPEN);.
101f0 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
10200 5f 65 6e 74 65 72 28 6d 75 74 65 78 4f 70 65 6e _enter(mutexOpen
10210 29 3b 0a 20 20 20 20 20 20 6d 75 74 65 78 53 68 );. mutexSh
10220 61 72 65 64 20 3d 20 73 71 6c 69 74 65 33 4d 75 ared = sqlite3Mu
10230 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f texAlloc(SQLITE_
10240 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 MUTEX_STATIC_MAS
10250 54 45 52 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 TER);. sqli
10260 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
10270 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 23 65 mutexShared);.#e
10280 6e 64 69 66 0a 20 20 20 20 20 20 66 6f 72 28 70 ndif. for(p
10290 42 74 3d 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 Bt=GLOBAL(BtShar
102a0 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 ed*,sqlite3Share
102b0 64 43 61 63 68 65 4c 69 73 74 29 3b 20 70 42 74 dCacheList); pBt
102c0 3b 20 70 42 74 3d 70 42 74 2d 3e 70 4e 65 78 74 ; pBt=pBt->pNext
102d0 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
102e0 74 28 20 70 42 74 2d 3e 6e 52 65 66 3e 30 20 29 t( pBt->nRef>0 )
102f0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 30 3d ;. if( 0=
10300 3d 73 74 72 63 6d 70 28 7a 46 75 6c 6c 50 61 74 =strcmp(zFullPat
10310 68 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33 50 61 hname, sqlite3Pa
10320 67 65 72 46 69 6c 65 6e 61 6d 65 28 70 42 74 2d gerFilename(pBt-
10330 3e 70 50 61 67 65 72 2c 20 30 29 29 0a 20 20 20 >pPager, 0)).
10340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 &&
10350 20 73 71 6c 69 74 65 33 50 61 67 65 72 56 66 73 sqlite3PagerVfs
10360 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d 70 (pBt->pPager)==p
10370 56 66 73 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Vfs ){.
10380 20 69 6e 74 20 69 44 62 3b 0a 20 20 20 20 20 20 int iDb;.
10390 20 20 20 20 66 6f 72 28 69 44 62 3d 64 62 2d 3e for(iDb=db->
103a0 6e 44 62 2d 31 3b 20 69 44 62 3e 3d 30 3b 20 69 nDb-1; iDb>=0; i
103b0 44 62 2d 2d 29 7b 0a 20 20 20 20 20 20 20 20 20 Db--){.
103c0 20 20 20 42 74 72 65 65 20 2a 70 45 78 69 73 74 Btree *pExist
103d0 69 6e 67 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 ing = db->aDb[iD
103e0 62 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 b].pBt;.
103f0 20 20 20 20 69 66 28 20 70 45 78 69 73 74 69 6e if( pExistin
10400 67 20 26 26 20 70 45 78 69 73 74 69 6e 67 2d 3e g && pExisting->
10410 70 42 74 3d 3d 70 42 74 20 29 7b 0a 20 20 20 20 pBt==pBt ){.
10420 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
10430 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 3_mutex_leave(mu
10440 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 texShared);.
10450 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
10460 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 3_mutex_leave(mu
10470 74 65 78 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 texOpen);.
10480 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
10490 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 free(zFullPathna
104a0 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 me);.
104b0 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
104c0 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 p);.
104d0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
104e0 43 4f 4e 53 54 52 41 49 4e 54 3b 0a 20 20 20 20 CONSTRAINT;.
104f0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
10500 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
10510 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 p->pBt = pBt;.
10520 20 20 20 20 20 20 20 20 70 42 74 2d 3e 6e 52 65 pBt->nRe
10530 66 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 62 f++;. b
10540 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a reak;. }.
10550 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 }. sq
10560 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
10570 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a e(mutexShared);.
10580 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 sqlite3_fr
10590 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 ee(zFullPathname
105a0 29 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 );. }.#ifdef
105b0 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 SQLITE_DEBUG.
105c0 20 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 else{. /*
105d0 49 6e 20 64 65 62 75 67 20 6d 6f 64 65 2c 20 77 In debug mode, w
105e0 65 20 6d 61 72 6b 20 61 6c 6c 20 70 65 72 73 69 e mark all persi
105f0 73 74 65 6e 74 20 64 61 74 61 62 61 73 65 73 20 stent databases
10600 61 73 20 73 68 61 72 61 62 6c 65 0a 20 20 20 20 as sharable.
10610 20 20 2a 2a 20 65 76 65 6e 20 77 68 65 6e 20 74 ** even when t
10620 68 65 79 20 61 72 65 20 6e 6f 74 2e 20 20 54 68 hey are not. Th
10630 69 73 20 65 78 65 72 63 69 73 65 73 20 74 68 65 is exercises the
10640 20 6c 6f 63 6b 69 6e 67 20 63 6f 64 65 20 61 6e locking code an
10650 64 0a 20 20 20 20 20 20 2a 2a 20 67 69 76 65 73 d. ** gives
10660 20 6d 6f 72 65 20 6f 70 70 6f 72 74 75 6e 69 74 more opportunit
10670 79 20 66 6f 72 20 61 73 73 65 72 74 73 28 73 71 y for asserts(sq
10680 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
10690 28 29 29 0a 20 20 20 20 20 20 2a 2a 20 73 74 61 ()). ** sta
106a0 74 65 6d 65 6e 74 73 20 74 6f 20 66 69 6e 64 20 tements to find
106b0 6c 6f 63 6b 69 6e 67 20 70 72 6f 62 6c 65 6d 73 locking problems
106c0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
106d0 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 3d 20 31 p->sharable = 1
106e0 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
106f0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 }.#endif. if(
10700 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a pBt==0 ){. /*
10710 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c . ** The foll
10720 6f 77 69 6e 67 20 61 73 73 65 72 74 73 20 6d 61 owing asserts ma
10730 6b 65 20 73 75 72 65 20 74 68 61 74 20 73 74 72 ke sure that str
10740 75 63 74 75 72 65 73 20 75 73 65 64 20 62 79 20 uctures used by
10750 74 68 65 20 62 74 72 65 65 20 61 72 65 0a 20 20 the btree are.
10760 20 20 2a 2a 20 74 68 65 20 72 69 67 68 74 20 73 ** the right s
10770 69 7a 65 2e 20 20 54 68 69 73 20 69 73 20 74 6f ize. This is to
10780 20 67 75 61 72 64 20 61 67 61 69 6e 73 74 20 73 guard against s
10790 69 7a 65 20 63 68 61 6e 67 65 73 20 74 68 61 74 ize changes that
107a0 20 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a 20 77 result. ** w
107b0 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 6f 6e hen compiling on
107c0 20 61 20 64 69 66 66 65 72 65 6e 74 20 61 72 63 a different arc
107d0 68 69 74 65 63 74 75 72 65 2e 0a 20 20 20 20 2a hitecture.. *
107e0 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 /. assert( si
107f0 7a 65 6f 66 28 69 36 34 29 3d 3d 38 20 7c 7c 20 zeof(i64)==8 ||
10800 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d 34 20 29 sizeof(i64)==4 )
10810 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 ;. assert( si
10820 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 7c 7c 20 zeof(u64)==8 ||
10830 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 34 20 29 sizeof(u64)==4 )
10840 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 ;. assert( si
10850 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 3b 0a zeof(u32)==4 );.
10860 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 assert( size
10870 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a 20 20 of(u16)==2 );.
10880 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
10890 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 20 0a (Pgno)==4 );. .
108a0 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 74 65 pBt = sqlite
108b0 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 3MallocZero( siz
108c0 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 20 20 eof(*pBt) );.
108d0 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 if( pBt==0 ){.
108e0 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
108f0 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 67 6f _NOMEM;. go
10900 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 to btree_open_ou
10910 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 t;. }. rc
10920 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 = sqlite3PagerOp
10930 65 6e 28 70 56 66 73 2c 20 26 70 42 74 2d 3e 70 en(pVfs, &pBt->p
10940 50 61 67 65 72 2c 20 7a 46 69 6c 65 6e 61 6d 65 Pager, zFilename
10950 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
10960 20 20 20 20 20 20 20 20 20 20 20 20 45 58 54 52 EXTR
10970 41 5f 53 49 5a 45 2c 20 66 6c 61 67 73 2c 20 76 A_SIZE, flags, v
10980 66 73 46 6c 61 67 73 2c 20 70 61 67 65 52 65 69 fsFlags, pageRei
10990 6e 69 74 29 3b 0a 20 20 20 20 69 66 28 20 72 63 nit);. if( rc
109a0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
109b0 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 sqlite3Page
109c0 72 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 70 42 rSetMmapLimit(pB
109d0 74 2d 3e 70 50 61 67 65 72 2c 20 64 62 2d 3e 73 t->pPager, db->s
109e0 7a 4d 6d 61 70 29 3b 0a 20 20 20 20 20 20 72 63 zMmap);. rc
109f0 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 = sqlite3PagerR
10a00 65 61 64 46 69 6c 65 68 65 61 64 65 72 28 70 42 eadFileheader(pB
10a10 74 2d 3e 70 50 61 67 65 72 2c 73 69 7a 65 6f 66 t->pPager,sizeof
10a20 28 7a 44 62 48 65 61 64 65 72 29 2c 7a 44 62 48 (zDbHeader),zDbH
10a30 65 61 64 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 eader);. }.
10a40 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
10a50 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 _OK ){. got
10a60 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 o btree_open_out
10a70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 42 74 2d ;. }. pBt-
10a80 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 28 75 38 >openFlags = (u8
10a90 29 66 6c 61 67 73 3b 0a 20 20 20 20 70 42 74 2d )flags;. pBt-
10aa0 3e 64 62 20 3d 20 64 62 3b 0a 20 20 20 20 73 71 >db = db;. sq
10ab0 6c 69 74 65 33 50 61 67 65 72 53 65 74 42 75 73 lite3PagerSetBus
10ac0 79 68 61 6e 64 6c 65 72 28 70 42 74 2d 3e 70 50 yhandler(pBt->pP
10ad0 61 67 65 72 2c 20 62 74 72 65 65 49 6e 76 6f 6b ager, btreeInvok
10ae0 65 42 75 73 79 48 61 6e 64 6c 65 72 2c 20 70 42 eBusyHandler, pB
10af0 74 29 3b 0a 20 20 20 20 70 2d 3e 70 42 74 20 3d t);. p->pBt =
10b00 20 70 42 74 3b 0a 20 20 0a 20 20 20 20 70 42 74 pBt;. . pBt
10b10 2d 3e 70 43 75 72 73 6f 72 20 3d 20 30 3b 0a 20 ->pCursor = 0;.
10b20 20 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d pBt->pPage1 =
10b30 20 30 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 0;. if( sqli
10b40 74 65 33 50 61 67 65 72 49 73 72 65 61 64 6f 6e te3PagerIsreadon
10b50 6c 79 28 70 42 74 2d 3e 70 50 61 67 65 72 29 20 ly(pBt->pPager)
10b60 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ) pBt->btsFlags
10b70 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 |= BTS_READ_ONLY
10b80 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
10b90 53 45 43 55 52 45 5f 44 45 4c 45 54 45 0a 20 20 SECURE_DELETE.
10ba0 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
10bb0 7c 3d 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 |= BTS_SECURE_DE
10bc0 4c 45 54 45 3b 0a 23 65 6e 64 69 66 0a 20 20 20 LETE;.#endif.
10bd0 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d pBt->pageSize =
10be0 20 28 7a 44 62 48 65 61 64 65 72 5b 31 36 5d 3c (zDbHeader[16]<
10bf0 3c 38 29 20 7c 20 28 7a 44 62 48 65 61 64 65 72 <8) | (zDbHeader
10c00 5b 31 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 69 [17]<<16);. i
10c10 66 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 f( pBt->pageSize
10c20 3c 35 31 32 20 7c 7c 20 70 42 74 2d 3e 70 61 67 <512 || pBt->pag
10c30 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 eSize>SQLITE_MAX
10c40 5f 50 41 47 45 5f 53 49 5a 45 0a 20 20 20 20 20 _PAGE_SIZE.
10c50 20 20 20 20 7c 7c 20 28 28 70 42 74 2d 3e 70 61 || ((pBt->pa
10c60 67 65 53 69 7a 65 2d 31 29 26 70 42 74 2d 3e 70 geSize-1)&pBt->p
10c70 61 67 65 53 69 7a 65 29 21 3d 30 20 29 7b 0a 20 ageSize)!=0 ){.
10c80 20 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 pBt->pageSi
10c90 7a 65 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 ze = 0;.#ifndef
10ca0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
10cb0 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 VACUUM. /*
10cc0 49 66 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d If the magic nam
10cd0 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 6c e ":memory:" wil
10ce0 6c 20 63 72 65 61 74 65 20 61 6e 20 69 6e 2d 6d l create an in-m
10cf0 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 emory database,
10d00 74 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 6c 65 then. ** le
10d10 61 76 65 20 74 68 65 20 61 75 74 6f 56 61 63 75 ave the autoVacu
10d20 75 6d 20 6d 6f 64 65 20 61 74 20 30 20 28 64 6f um mode at 0 (do
10d30 20 6e 6f 74 20 61 75 74 6f 2d 76 61 63 75 75 6d not auto-vacuum
10d40 29 2c 20 65 76 65 6e 20 69 66 0a 20 20 20 20 20 ), even if.
10d50 20 2a 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 55 ** SQLITE_DEFAU
10d60 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 LT_AUTOVACUUM is
10d70 20 74 72 75 65 2e 20 4f 6e 20 74 68 65 20 6f 74 true. On the ot
10d80 68 65 72 20 68 61 6e 64 2c 20 69 66 0a 20 20 20 her hand, if.
10d90 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 ** SQLITE_OMI
10da0 54 5f 4d 45 4d 4f 52 59 44 42 20 68 61 73 20 62 T_MEMORYDB has b
10db0 65 65 6e 20 64 65 66 69 6e 65 64 2c 20 74 68 65 een defined, the
10dc0 6e 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 20 n ":memory:" is
10dd0 6a 75 73 74 20 61 0a 20 20 20 20 20 20 2a 2a 20 just a. **
10de0 72 65 67 75 6c 61 72 20 66 69 6c 65 2d 6e 61 6d regular file-nam
10df0 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 e. In this case
10e00 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 the auto-vacuum
10e10 61 70 70 6c 69 65 73 20 61 73 20 70 65 72 20 6e applies as per n
10e20 6f 72 6d 61 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a ormal.. */.
10e30 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 6e if( zFilen
10e40 61 6d 65 20 26 26 20 21 69 73 4d 65 6d 64 62 20 ame && !isMemdb
10e50 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e ){. pBt->
10e60 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 53 51 autoVacuum = (SQ
10e70 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 LITE_DEFAULT_AUT
10e80 4f 56 41 43 55 55 4d 20 3f 20 31 20 3a 20 30 29 OVACUUM ? 1 : 0)
10e90 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 69 ;. pBt->i
10ea0 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 53 51 4c ncrVacuum = (SQL
10eb0 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f ITE_DEFAULT_AUTO
10ec0 56 41 43 55 55 4d 3d 3d 32 20 3f 20 31 20 3a 20 VACUUM==2 ? 1 :
10ed0 30 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 0);. }.#end
10ee0 69 66 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 if. nReserv
10ef0 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 e = 0;. }else
10f00 7b 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 {. nReserve
10f10 20 3d 20 7a 44 62 48 65 61 64 65 72 5b 32 30 5d = zDbHeader[20]
10f20 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 ;. pBt->bts
10f30 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 Flags |= BTS_PAG
10f40 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 ESIZE_FIXED;.#if
10f50 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
10f60 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
10f70 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 pBt->autoVacuu
10f80 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a m = (get4byte(&z
10f90 44 62 48 65 61 64 65 72 5b 33 36 20 2b 20 34 2a DbHeader[36 + 4*
10fa0 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 20 20 20 4])?1:0);.
10fb0 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 pBt->incrVacuum
10fc0 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 = (get4byte(&zDb
10fd0 48 65 61 64 65 72 5b 33 36 20 2b 20 37 2a 34 5d Header[36 + 7*4]
10fe0 29 3f 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 )?1:0);.#endif.
10ff0 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 }. rc = sq
11000 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 67 lite3PagerSetPag
11010 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 esize(pBt->pPage
11020 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a r, &pBt->pageSiz
11030 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 e, nReserve);.
11040 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 if( rc ) goto
11050 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a btree_open_out;.
11060 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 pBt->usableS
11070 69 7a 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 ize = pBt->pageS
11080 69 7a 65 20 2d 20 6e 52 65 73 65 72 76 65 3b 0a ize - nReserve;.
11090 20 20 20 20 61 73 73 65 72 74 28 20 28 70 42 74 assert( (pBt
110a0 2d 3e 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d ->pageSize & 7)=
110b0 3d 30 20 29 3b 20 20 2f 2a 20 38 2d 62 79 74 65 =0 ); /* 8-byte
110c0 20 61 6c 69 67 6e 6d 65 6e 74 20 6f 66 20 70 61 alignment of pa
110d0 67 65 53 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 69 geSize */. .#i
110e0 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
110f0 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
11100 43 48 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 CHE) && !defined
11110 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 (SQLITE_OMIT_DIS
11120 4b 49 4f 29 0a 20 20 20 20 2f 2a 20 41 64 64 20 KIO). /* Add
11130 74 68 65 20 6e 65 77 20 42 74 53 68 61 72 65 64 the new BtShared
11140 20 6f 62 6a 65 63 74 20 74 6f 20 74 68 65 20 6c object to the l
11150 69 6e 6b 65 64 20 6c 69 73 74 20 73 68 61 72 61 inked list shara
11160 62 6c 65 20 42 74 53 68 61 72 65 64 73 2e 0a 20 ble BtShareds..
11170 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d */. if( p-
11180 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 >sharable ){.
11190 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
111a0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
111b0 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 20 20 utexShared; ).
111c0 20 20 20 20 70 42 74 2d 3e 6e 52 65 66 20 3d 20 pBt->nRef =
111d0 31 3b 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 1;. MUTEX_L
111e0 4f 47 49 43 28 20 6d 75 74 65 78 53 68 61 72 65 OGIC( mutexShare
111f0 64 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 d = sqlite3Mutex
11200 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 Alloc(SQLITE_MUT
11210 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 EX_STATIC_MASTER
11220 29 3b 29 0a 20 20 20 20 20 20 69 66 28 20 53 51 );). if( SQ
11230 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 LITE_THREADSAFE
11240 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c && sqlite3Global
11250 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 Config.bCoreMute
11260 78 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 x ){. pBt
11270 2d 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 ->mutex = sqlite
11280 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 3MutexAlloc(SQLI
11290 54 45 5f 4d 55 54 45 58 5f 46 41 53 54 29 3b 0a TE_MUTEX_FAST);.
112a0 20 20 20 20 20 20 20 20 69 66 28 20 70 42 74 2d if( pBt-
112b0 3e 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 >mutex==0 ){.
112c0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
112d0 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 TE_NOMEM;.
112e0 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 db->mallocFa
112f0 69 6c 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 iled = 0;.
11300 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f goto btree_o
11310 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 pen_out;.
11320 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
11330 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
11340 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 nter(mutexShared
11350 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 4e );. pBt->pN
11360 65 78 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 53 ext = GLOBAL(BtS
11370 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
11380 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b 0a aredCacheList);.
11390 20 20 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 53 GLOBAL(BtS
113a0 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
113b0 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 20 3d aredCacheList) =
113c0 20 70 42 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 pBt;. sqli
113d0 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
113e0 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 mutexShared);.
113f0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a }.#endif. }..
11400 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
11410 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
11420 43 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e CACHE) && !defin
11430 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ed(SQLITE_OMIT_D
11440 49 53 4b 49 4f 29 0a 20 20 2f 2a 20 49 66 20 74 ISKIO). /* If t
11450 68 65 20 6e 65 77 20 42 74 72 65 65 20 75 73 65 he new Btree use
11460 73 20 61 20 73 68 61 72 61 62 6c 65 20 70 42 74 s a sharable pBt
11470 53 68 61 72 65 64 2c 20 74 68 65 6e 20 6c 69 6e Shared, then lin
11480 6b 20 74 68 65 20 6e 65 77 0a 20 20 2a 2a 20 42 k the new. ** B
11490 74 72 65 65 20 69 6e 74 6f 20 74 68 65 20 6c 69 tree into the li
114a0 73 74 20 6f 66 20 61 6c 6c 20 73 68 61 72 61 62 st of all sharab
114b0 6c 65 20 42 74 72 65 65 73 20 66 6f 72 20 74 68 le Btrees for th
114c0 65 20 73 61 6d 65 20 63 6f 6e 6e 65 63 74 69 6f e same connectio
114d0 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6c 69 73 74 n.. ** The list
114e0 20 69 73 20 6b 65 70 74 20 69 6e 20 61 73 63 65 is kept in asce
114f0 6e 64 69 6e 67 20 6f 72 64 65 72 20 62 79 20 70 nding order by p
11500 42 74 20 61 64 64 72 65 73 73 2e 0a 20 20 2a 2f Bt address.. */
11510 0a 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 62 . if( p->sharab
11520 6c 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b le ){. int i;
11530 0a 20 20 20 20 42 74 72 65 65 20 2a 70 53 69 62 . Btree *pSib
11540 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 ;. for(i=0; i
11550 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a <db->nDb; i++){.
11560 20 20 20 20 20 20 69 66 28 20 28 70 53 69 62 20 if( (pSib
11570 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 = db->aDb[i].pBt
11580 29 21 3d 30 20 26 26 20 70 53 69 62 2d 3e 73 68 )!=0 && pSib->sh
11590 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 arable ){.
115a0 20 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 while( pSib->p
115b0 50 72 65 76 20 29 7b 20 70 53 69 62 20 3d 20 70 Prev ){ pSib = p
115c0 53 69 62 2d 3e 70 50 72 65 76 3b 20 7d 0a 20 20 Sib->pPrev; }.
115d0 20 20 20 20 20 20 69 66 28 20 70 2d 3e 70 42 74 if( p->pBt
115e0 3c 70 53 69 62 2d 3e 70 42 74 20 29 7b 0a 20 20 <pSib->pBt ){.
115f0 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
11600 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 = pSib;.
11610 20 20 20 70 2d 3e 70 50 72 65 76 20 3d 20 30 3b p->pPrev = 0;
11620 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 2d . pSib-
11630 3e 70 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 >pPrev = p;.
11640 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
11650 20 20 20 20 20 77 68 69 6c 65 28 20 70 53 69 62 while( pSib
11660 2d 3e 70 4e 65 78 74 20 26 26 20 70 53 69 62 2d ->pNext && pSib-
11670 3e 70 4e 65 78 74 2d 3e 70 42 74 3c 70 2d 3e 70 >pNext->pBt<p->p
11680 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 Bt ){.
11690 20 20 70 53 69 62 20 3d 20 70 53 69 62 2d 3e 70 pSib = pSib->p
116a0 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 20 20 Next;.
116b0 7d 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 }. p->p
116c0 4e 65 78 74 20 3d 20 70 53 69 62 2d 3e 70 4e 65 Next = pSib->pNe
116d0 78 74 3b 0a 20 20 20 20 20 20 20 20 20 20 70 2d xt;. p-
116e0 3e 70 50 72 65 76 20 3d 20 70 53 69 62 3b 0a 20 >pPrev = pSib;.
116f0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e if( p->
11700 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 20 pNext ){.
11710 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 p->pNext->p
11720 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 Prev = p;.
11730 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
11740 70 53 69 62 2d 3e 70 4e 65 78 74 20 3d 20 70 3b pSib->pNext = p;
11750 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
11760 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
11770 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 }. }. }.#end
11780 69 66 0a 20 20 2a 70 70 42 74 72 65 65 20 3d 20 if. *ppBtree =
11790 70 3b 0a 0a 62 74 72 65 65 5f 6f 70 65 6e 5f 6f p;..btree_open_o
117a0 75 74 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 ut:. if( rc!=SQ
117b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
117c0 66 28 20 70 42 74 20 26 26 20 70 42 74 2d 3e 70 f( pBt && pBt->p
117d0 50 61 67 65 72 20 29 7b 0a 20 20 20 20 20 20 73 Pager ){. s
117e0 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 qlite3PagerClose
117f0 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 (pBt->pPager);.
11800 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
11810 5f 66 72 65 65 28 70 42 74 29 3b 0a 20 20 20 20 _free(pBt);.
11820 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b sqlite3_free(p);
11830 0a 20 20 20 20 2a 70 70 42 74 72 65 65 20 3d 20 . *ppBtree =
11840 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 0;. }else{.
11850 2f 2a 20 49 66 20 74 68 65 20 42 2d 54 72 65 65 /* If the B-Tree
11860 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c was successfull
11870 79 20 6f 70 65 6e 65 64 2c 20 73 65 74 20 74 68 y opened, set th
11880 65 20 70 61 67 65 72 2d 63 61 63 68 65 20 73 69 e pager-cache si
11890 7a 65 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a ze to the. **
118a0 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 default value.
118b0 45 78 63 65 70 74 2c 20 77 68 65 6e 20 6f 70 65 Except, when ope
118c0 6e 69 6e 67 20 6f 6e 20 61 6e 20 65 78 69 73 74 ning on an exist
118d0 69 6e 67 20 73 68 61 72 65 64 20 70 61 67 65 72 ing shared pager
118e0 2d 63 61 63 68 65 2c 0a 20 20 20 20 2a 2a 20 64 -cache,. ** d
118f0 6f 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 68 65 o not change the
11900 20 70 61 67 65 72 2d 63 61 63 68 65 20 73 69 7a pager-cache siz
11910 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 e.. */. if
11920 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 63 ( sqlite3BtreeSc
11930 68 65 6d 61 28 70 2c 20 30 2c 20 30 29 3d 3d 30 hema(p, 0, 0)==0
11940 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
11950 33 50 61 67 65 72 53 65 74 43 61 63 68 65 73 69 3PagerSetCachesi
11960 7a 65 28 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 ze(p->pBt->pPage
11970 72 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c r, SQLITE_DEFAUL
11980 54 5f 43 41 43 48 45 5f 53 49 5a 45 29 3b 0a 20 T_CACHE_SIZE);.
11990 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6d }. }. if( m
119a0 75 74 65 78 4f 70 65 6e 20 29 7b 0a 20 20 20 20 utexOpen ){.
119b0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
119c0 6d 75 74 65 78 5f 68 65 6c 64 28 6d 75 74 65 78 mutex_held(mutex
119d0 4f 70 65 6e 29 20 29 3b 0a 20 20 20 20 73 71 6c Open) );. sql
119e0 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
119f0 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 7d (mutexOpen);. }
11a00 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
11a10 0a 2f 2a 0a 2a 2a 20 44 65 63 72 65 6d 65 6e 74 ./*.** Decrement
11a20 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 6e 52 the BtShared.nR
11a30 65 66 20 63 6f 75 6e 74 65 72 2e 20 20 57 68 65 ef counter. Whe
11a40 6e 20 69 74 20 72 65 61 63 68 65 73 20 7a 65 72 n it reaches zer
11a50 6f 2c 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 68 65 o,.** remove the
11a60 20 42 74 53 68 61 72 65 64 20 73 74 72 75 63 74 BtShared struct
11a70 75 72 65 20 66 72 6f 6d 20 74 68 65 20 73 68 61 ure from the sha
11a80 72 69 6e 67 20 6c 69 73 74 2e 20 20 52 65 74 75 ring list. Retu
11a90 72 6e 0a 2a 2a 20 74 72 75 65 20 69 66 20 74 68 rn.** true if th
11aa0 65 20 42 74 53 68 61 72 65 64 2e 6e 52 65 66 20 e BtShared.nRef
11ab0 63 6f 75 6e 74 65 72 20 72 65 61 63 68 65 73 20 counter reaches
11ac0 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 0a zero and return.
11ad0 2a 2a 20 66 61 6c 73 65 20 69 66 20 69 74 20 69 ** false if it i
11ae0 73 20 73 74 69 6c 6c 20 70 6f 73 69 74 69 76 65 s still positive
11af0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
11b00 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e removeFromSharin
11b10 67 4c 69 73 74 28 42 74 53 68 61 72 65 64 20 2a gList(BtShared *
11b20 70 42 74 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 pBt){.#ifndef SQ
11b30 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
11b40 5f 43 41 43 48 45 0a 20 20 4d 55 54 45 58 5f 4c _CACHE. MUTEX_L
11b50 4f 47 49 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 OGIC( sqlite3_mu
11b60 74 65 78 20 2a 70 4d 61 73 74 65 72 3b 20 29 0a tex *pMaster; ).
11b70 20 20 42 74 53 68 61 72 65 64 20 2a 70 4c 69 73 BtShared *pLis
11b80 74 3b 0a 20 20 69 6e 74 20 72 65 6d 6f 76 65 64 t;. int removed
11b90 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 = 0;.. assert(
11ba0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e sqlite3_mutex_n
11bb0 6f 74 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 otheld(pBt->mute
11bc0 78 29 20 29 3b 0a 20 20 4d 55 54 45 58 5f 4c 4f x) );. MUTEX_LO
11bd0 47 49 43 28 20 70 4d 61 73 74 65 72 20 3d 20 73 GIC( pMaster = s
11be0 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
11bf0 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 (SQLITE_MUTEX_ST
11c00 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 20 29 0a ATIC_MASTER); ).
11c10 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
11c20 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a enter(pMaster);.
11c30 20 20 70 42 74 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 pBt->nRef--;.
11c40 20 69 66 28 20 70 42 74 2d 3e 6e 52 65 66 3c 3d if( pBt->nRef<=
11c50 30 20 29 7b 0a 20 20 20 20 69 66 28 20 47 4c 4f 0 ){. if( GLO
11c60 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 71 BAL(BtShared*,sq
11c70 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 65 lite3SharedCache
11c80 4c 69 73 74 29 3d 3d 70 42 74 20 29 7b 0a 20 20 List)==pBt ){.
11c90 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 GLOBAL(BtSha
11ca0 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 red*,sqlite3Shar
11cb0 65 64 43 61 63 68 65 4c 69 73 74 29 20 3d 20 70 edCacheList) = p
11cc0 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d Bt->pNext;. }
11cd0 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4c 69 73 else{. pLis
11ce0 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 t = GLOBAL(BtSha
11cf0 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 red*,sqlite3Shar
11d00 65 64 43 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 edCacheList);.
11d10 20 20 20 20 77 68 69 6c 65 28 20 41 4c 57 41 59 while( ALWAY
11d20 53 28 70 4c 69 73 74 29 20 26 26 20 70 4c 69 73 S(pList) && pLis
11d30 74 2d 3e 70 4e 65 78 74 21 3d 70 42 74 20 29 7b t->pNext!=pBt ){
11d40 0a 20 20 20 20 20 20 20 20 70 4c 69 73 74 3d 70 . pList=p
11d50 4c 69 73 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 List->pNext;.
11d60 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 41 }. if( A
11d70 4c 57 41 59 53 28 70 4c 69 73 74 29 20 29 7b 0a LWAYS(pList) ){.
11d80 20 20 20 20 20 20 20 20 70 4c 69 73 74 2d 3e 70 pList->p
11d90 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4e 65 78 Next = pBt->pNex
11da0 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d t;. }. }
11db0 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f . if( SQLITE_
11dc0 54 48 52 45 41 44 53 41 46 45 20 29 7b 0a 20 20 THREADSAFE ){.
11dd0 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
11de0 78 5f 66 72 65 65 28 70 42 74 2d 3e 6d 75 74 65 x_free(pBt->mute
11df0 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 x);. }. re
11e00 6d 6f 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 moved = 1;. }.
11e10 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
11e20 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 eave(pMaster);.
11e30 20 72 65 74 75 72 6e 20 72 65 6d 6f 76 65 64 3b return removed;
11e40 0a 23 65 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 .#else. return
11e50 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 1;.#endif.}../*.
11e60 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 70 42 74 ** Make sure pBt
11e70 2d 3e 70 54 6d 70 53 70 61 63 65 20 70 6f 69 6e ->pTmpSpace poin
11e80 74 73 20 74 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 ts to an allocat
11e90 69 6f 6e 20 6f 66 20 0a 2a 2a 20 4d 58 5f 43 45 ion of .** MX_CE
11ea0 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 62 79 74 LL_SIZE(pBt) byt
11eb0 65 73 20 77 69 74 68 20 61 20 34 2d 62 79 74 65 es with a 4-byte
11ec0 20 70 72 65 66 69 78 20 66 6f 72 20 61 20 6c 65 prefix for a le
11ed0 66 74 2d 63 68 69 6c 64 0a 2a 2a 20 70 6f 69 6e ft-child.** poin
11ee0 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ter..*/.static v
11ef0 6f 69 64 20 61 6c 6c 6f 63 61 74 65 54 65 6d 70 oid allocateTemp
11f00 53 70 61 63 65 28 42 74 53 68 61 72 65 64 20 2a Space(BtShared *
11f10 70 42 74 29 7b 0a 20 20 69 66 28 20 21 70 42 74 pBt){. if( !pBt
11f20 2d 3e 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 ->pTmpSpace ){.
11f30 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 pBt->pTmpSpac
11f40 65 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 4d e = sqlite3PageM
11f50 61 6c 6c 6f 63 28 20 70 42 74 2d 3e 70 61 67 65 alloc( pBt->page
11f60 53 69 7a 65 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 Size );.. /*
11f70 4f 6e 65 20 6f 66 20 74 68 65 20 75 73 65 73 20 One of the uses
11f80 6f 66 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 of pBt->pTmpSpac
11f90 65 20 69 73 20 74 6f 20 66 6f 72 6d 61 74 20 63 e is to format c
11fa0 65 6c 6c 73 20 62 65 66 6f 72 65 0a 20 20 20 20 ells before.
11fb0 2a 2a 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 ** inserting the
11fc0 6d 20 69 6e 74 6f 20 61 20 6c 65 61 66 20 70 61 m into a leaf pa
11fd0 67 65 20 28 66 75 6e 63 74 69 6f 6e 20 66 69 6c ge (function fil
11fe0 6c 49 6e 43 65 6c 6c 28 29 29 2e 20 49 66 0a 20 lInCell()). If.
11ff0 20 20 20 2a 2a 20 61 20 63 65 6c 6c 20 69 73 20 ** a cell is
12000 6c 65 73 73 20 74 68 61 6e 20 34 20 62 79 74 65 less than 4 byte
12010 73 20 69 6e 20 73 69 7a 65 2c 20 69 74 20 69 73 s in size, it is
12020 20 72 6f 75 6e 64 65 64 20 75 70 20 74 6f 20 34 rounded up to 4
12030 20 62 79 74 65 73 0a 20 20 20 20 2a 2a 20 62 79 bytes. ** by
12040 20 74 68 65 20 76 61 72 69 6f 75 73 20 72 6f 75 the various rou
12050 74 69 6e 65 73 20 74 68 61 74 20 6d 61 6e 69 70 tines that manip
12060 75 6c 61 74 65 20 62 69 6e 61 72 79 20 63 65 6c ulate binary cel
12070 6c 73 2e 20 57 68 69 63 68 0a 20 20 20 20 2a 2a ls. Which. **
12080 20 63 61 6e 20 6d 65 61 6e 20 74 68 61 74 20 66 can mean that f
12090 69 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 illInCell() only
120a0 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68 65 initializes the
120b0 20 66 69 72 73 74 20 32 20 6f 72 20 33 0a 20 20 first 2 or 3.
120c0 20 20 2a 2a 20 62 79 74 65 73 20 6f 66 20 70 54 ** bytes of pT
120d0 6d 70 53 70 61 63 65 2c 20 62 75 74 20 74 68 61 mpSpace, but tha
120e0 74 20 74 68 65 20 66 69 72 73 74 20 34 20 62 79 t the first 4 by
120f0 74 65 73 20 61 72 65 20 63 6f 70 69 65 64 20 66 tes are copied f
12100 72 6f 6d 0a 20 20 20 20 2a 2a 20 69 74 20 69 6e rom. ** it in
12110 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 70 61 to a database pa
12120 67 65 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 ge. This is not
12130 61 63 74 75 61 6c 6c 79 20 61 20 70 72 6f 62 6c actually a probl
12140 65 6d 2c 20 62 75 74 20 69 74 0a 20 20 20 20 2a em, but it. *
12150 2a 20 64 6f 65 73 20 63 61 75 73 65 20 61 20 76 * does cause a v
12160 61 6c 67 72 69 6e 64 20 65 72 72 6f 72 20 77 68 algrind error wh
12170 65 6e 20 74 68 65 20 31 20 6f 72 20 32 20 62 79 en the 1 or 2 by
12180 74 65 73 20 6f 66 20 75 6e 69 74 69 61 6c 69 7a tes of unitializ
12190 65 64 20 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 ed . ** data
121a0 69 73 20 70 61 73 73 65 64 20 74 6f 20 73 79 73 is passed to sys
121b0 74 65 6d 20 63 61 6c 6c 20 77 72 69 74 65 28 29 tem call write()
121c0 2e 20 53 6f 20 74 6f 20 61 76 6f 69 64 20 74 68 . So to avoid th
121d0 69 73 20 65 72 72 6f 72 2c 0a 20 20 20 20 2a 2a is error,. **
121e0 20 7a 65 72 6f 20 74 68 65 20 66 69 72 73 74 20 zero the first
121f0 34 20 62 79 74 65 73 20 6f 66 20 74 65 6d 70 20 4 bytes of temp
12200 73 70 61 63 65 20 68 65 72 65 2e 0a 20 20 20 20 space here..
12210 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 3a 20 **. ** Also:
12220 20 50 72 6f 76 69 64 65 20 66 6f 75 72 20 62 79 Provide four by
12230 74 65 73 20 6f 66 20 69 6e 69 74 69 61 6c 69 7a tes of initializ
12240 65 64 20 73 70 61 63 65 20 62 65 66 6f 72 65 20 ed space before
12250 74 68 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e the. ** begin
12260 6e 69 6e 67 20 6f 66 20 70 54 6d 70 53 70 61 63 ning of pTmpSpac
12270 65 20 61 73 20 61 6e 20 61 72 65 61 20 61 76 61 e as an area ava
12280 69 6c 61 62 6c 65 20 74 6f 20 70 72 65 70 65 6e ilable to prepen
12290 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 6c 65 66 d the. ** lef
122a0 74 2d 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 20 t-child pointer
122b0 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 to the beginning
122c0 20 6f 66 20 61 20 63 65 6c 6c 2e 0a 20 20 20 20 of a cell..
122d0 2a 2f 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e */. if( pBt->
122e0 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 pTmpSpace ){.
122f0 20 20 20 6d 65 6d 73 65 74 28 70 42 74 2d 3e 70 memset(pBt->p
12300 54 6d 70 53 70 61 63 65 2c 20 30 2c 20 38 29 3b TmpSpace, 0, 8);
12310 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 . pBt->pTmp
12320 53 70 61 63 65 20 2b 3d 20 34 3b 0a 20 20 20 20 Space += 4;.
12330 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 }. }.}../*.** F
12340 72 65 65 20 74 68 65 20 70 42 74 2d 3e 70 54 6d ree the pBt->pTm
12350 70 53 70 61 63 65 20 61 6c 6c 6f 63 61 74 69 6f pSpace allocatio
12360 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 n.*/.static void
12370 20 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 42 freeTempSpace(B
12380 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
12390 20 69 66 28 20 70 42 74 2d 3e 70 54 6d 70 53 70 if( pBt->pTmpSp
123a0 61 63 65 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e ace ){. pBt->
123b0 70 54 6d 70 53 70 61 63 65 20 2d 3d 20 34 3b 0a pTmpSpace -= 4;.
123c0 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 sqlite3PageF
123d0 72 65 65 28 70 42 74 2d 3e 70 54 6d 70 53 70 61 ree(pBt->pTmpSpa
123e0 63 65 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 54 ce);. pBt->pT
123f0 6d 70 53 70 61 63 65 20 3d 20 30 3b 0a 20 20 7d mpSpace = 0;. }
12400 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 .}../*.** Close
12410 61 6e 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 an open database
12420 20 61 6e 64 20 69 6e 76 61 6c 69 64 61 74 65 20 and invalidate
12430 61 6c 6c 20 63 75 72 73 6f 72 73 2e 0a 2a 2f 0a all cursors..*/.
12440 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
12450 43 6c 6f 73 65 28 42 74 72 65 65 20 2a 70 29 7b Close(Btree *p){
12460 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
12470 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 43 = p->pBt;. BtC
12480 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a 0a 20 20 ursor *pCur;..
12490 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72 /* Close all cur
124a0 73 6f 72 73 20 6f 70 65 6e 65 64 20 76 69 61 20 sors opened via
124b0 74 68 69 73 20 68 61 6e 64 6c 65 2e 20 20 2a 2f this handle. */
124c0 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
124d0 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d e3_mutex_held(p-
124e0 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 >db->mutex) );.
124f0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
12500 65 72 28 70 29 3b 0a 20 20 70 43 75 72 20 3d 20 er(p);. pCur =
12510 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 20 pBt->pCursor;.
12520 77 68 69 6c 65 28 20 70 43 75 72 20 29 7b 0a 20 while( pCur ){.
12530 20 20 20 42 74 43 75 72 73 6f 72 20 2a 70 54 6d BtCursor *pTm
12540 70 20 3d 20 70 43 75 72 3b 0a 20 20 20 20 70 43 p = pCur;. pC
12550 75 72 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 ur = pCur->pNext
12560 3b 0a 20 20 20 20 69 66 28 20 70 54 6d 70 2d 3e ;. if( pTmp->
12570 70 42 74 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 pBtree==p ){.
12580 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
12590 6c 6f 73 65 43 75 72 73 6f 72 28 70 54 6d 70 29 loseCursor(pTmp)
125a0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f ;. }. }.. /
125b0 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6e 79 20 61 * Rollback any a
125c0 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f ctive transactio
125d0 6e 20 61 6e 64 20 66 72 65 65 20 74 68 65 20 68 n and free the h
125e0 61 6e 64 6c 65 20 73 74 72 75 63 74 75 72 65 2e andle structure.
125f0 0a 20 20 2a 2a 20 54 68 65 20 63 61 6c 6c 20 74 . ** The call t
12600 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f o sqlite3BtreeRo
12610 6c 6c 62 61 63 6b 28 29 20 64 72 6f 70 73 20 61 llback() drops a
12620 6e 79 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 68 ny table-locks h
12630 65 6c 64 20 62 79 0a 20 20 2a 2a 20 74 68 69 73 eld by. ** this
12640 20 68 61 6e 64 6c 65 2e 0a 20 20 2a 2f 0a 20 20 handle.. */.
12650 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c sqlite3BtreeRoll
12660 62 61 63 6b 28 70 2c 20 53 51 4c 49 54 45 5f 4f back(p, SQLITE_O
12670 4b 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 K);. sqlite3Btr
12680 65 65 4c 65 61 76 65 28 70 29 3b 0a 0a 20 20 2f eeLeave(p);.. /
12690 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 73 * If there are s
126a0 74 69 6c 6c 20 6f 74 68 65 72 20 6f 75 74 73 74 till other outst
126b0 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 anding reference
126c0 73 20 74 6f 20 74 68 65 20 73 68 61 72 65 64 2d s to the shared-
126d0 62 74 72 65 65 0a 20 20 2a 2a 20 73 74 72 75 63 btree. ** struc
126e0 74 75 72 65 2c 20 72 65 74 75 72 6e 20 6e 6f 77 ture, return now
126f0 2e 20 54 68 65 20 72 65 6d 61 69 6e 64 65 72 20 . The remainder
12700 6f 66 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 of this procedur
12710 65 20 63 6c 65 61 6e 73 20 0a 20 20 2a 2a 20 75 e cleans . ** u
12720 70 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 72 p the shared-btr
12730 65 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 ee.. */. asser
12740 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 6b t( p->wantToLock
12750 3d 3d 30 20 26 26 20 70 2d 3e 6c 6f 63 6b 65 64 ==0 && p->locked
12760 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 21 70 2d ==0 );. if( !p-
12770 3e 73 68 61 72 61 62 6c 65 20 7c 7c 20 72 65 6d >sharable || rem
12780 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c 69 oveFromSharingLi
12790 73 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 2f st(pBt) ){. /
127a0 2a 20 54 68 65 20 70 42 74 20 69 73 20 6e 6f 20 * The pBt is no
127b0 6c 6f 6e 67 65 72 20 6f 6e 20 74 68 65 20 73 68 longer on the sh
127c0 61 72 69 6e 67 20 6c 69 73 74 2c 20 73 6f 20 77 aring list, so w
127d0 65 20 63 61 6e 20 61 63 63 65 73 73 0a 20 20 20 e can access.
127e0 20 2a 2a 20 69 74 20 77 69 74 68 6f 75 74 20 68 ** it without h
127f0 61 76 69 6e 67 20 74 6f 20 68 6f 6c 64 20 74 68 aving to hold th
12800 65 20 6d 75 74 65 78 2e 0a 20 20 20 20 2a 2a 0a e mutex.. **.
12810 20 20 20 20 2a 2a 20 43 6c 65 61 6e 20 6f 75 74 ** Clean out
12820 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 and delete the
12830 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 2e BtShared object.
12840 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 . */. asse
12850 72 74 28 20 21 70 42 74 2d 3e 70 43 75 72 73 6f rt( !pBt->pCurso
12860 72 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 r );. sqlite3
12870 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e PagerClose(pBt->
12880 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 pPager);. if(
12890 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 6d pBt->xFreeSchem
128a0 61 20 26 26 20 70 42 74 2d 3e 70 53 63 68 65 6d a && pBt->pSchem
128b0 61 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e a ){. pBt->
128c0 78 46 72 65 65 53 63 68 65 6d 61 28 70 42 74 2d xFreeSchema(pBt-
128d0 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 7d >pSchema);. }
128e0 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
128f0 65 65 28 30 2c 20 70 42 74 2d 3e 70 53 63 68 65 ee(0, pBt->pSche
12900 6d 61 29 3b 0a 20 20 20 20 66 72 65 65 54 65 6d ma);. freeTem
12910 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 pSpace(pBt);.
12920 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 42 sqlite3_free(pB
12930 74 29 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 t);. }..#ifndef
12940 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
12950 52 45 44 5f 43 41 43 48 45 0a 20 20 61 73 73 65 RED_CACHE. asse
12960 72 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 rt( p->wantToLoc
12970 6b 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 k==0 );. assert
12980 28 20 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 ( p->locked==0 )
12990 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 ;. if( p->pPrev
129a0 20 29 20 70 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 ) p->pPrev->pNe
129b0 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 xt = p->pNext;.
129c0 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 20 if( p->pNext )
129d0 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 p->pNext->pPrev
129e0 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 23 65 6e 64 = p->pPrev;.#end
129f0 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 if.. sqlite3_fr
12a00 65 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ee(p);. return
12a10 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
12a20 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 6c .** Change the l
12a30 69 6d 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d 62 imit on the numb
12a40 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f er of pages allo
12a50 77 65 64 20 69 6e 20 74 68 65 20 63 61 63 68 65 wed in the cache
12a60 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 78 69 ..**.** The maxi
12a70 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 63 61 mum number of ca
12a80 63 68 65 20 70 61 67 65 73 20 69 73 20 73 65 74 che pages is set
12a90 20 74 6f 20 74 68 65 20 61 62 73 6f 6c 75 74 65 to the absolute
12aa0 0a 2a 2a 20 76 61 6c 75 65 20 6f 66 20 6d 78 50 .** value of mxP
12ab0 61 67 65 2e 20 20 49 66 20 6d 78 50 61 67 65 20 age. If mxPage
12ac0 69 73 20 6e 65 67 61 74 69 76 65 2c 20 74 68 65 is negative, the
12ad0 20 70 61 67 65 72 20 77 69 6c 6c 0a 2a 2a 20 6f pager will.** o
12ae0 70 65 72 61 74 65 20 61 73 79 6e 63 68 72 6f 6e perate asynchron
12af0 6f 75 73 6c 79 20 2d 20 69 74 20 77 69 6c 6c 20 ously - it will
12b00 6e 6f 74 20 73 74 6f 70 20 74 6f 20 64 6f 20 66 not stop to do f
12b10 73 79 6e 63 28 29 73 0a 2a 2a 20 74 6f 20 69 6e sync()s.** to in
12b20 73 75 72 65 20 64 61 74 61 20 69 73 20 77 72 69 sure data is wri
12b30 74 74 65 6e 20 74 6f 20 74 68 65 20 64 69 73 6b tten to the disk
12b40 20 73 75 72 66 61 63 65 20 62 65 66 6f 72 65 0a surface before.
12b50 2a 2a 20 63 6f 6e 74 69 6e 75 69 6e 67 2e 20 20 ** continuing.
12b60 54 72 61 6e 73 61 63 74 69 6f 6e 73 20 73 74 69 Transactions sti
12b70 6c 6c 20 77 6f 72 6b 20 69 66 20 73 79 6e 63 68 ll work if synch
12b80 72 6f 6e 6f 75 73 20 69 73 20 6f 66 66 2c 0a 2a ronous is off,.*
12b90 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 * and the databa
12ba0 73 65 20 63 61 6e 6e 6f 74 20 62 65 20 63 6f 72 se cannot be cor
12bb0 72 75 70 74 65 64 20 69 66 20 74 68 69 73 20 70 rupted if this p
12bc0 72 6f 67 72 61 6d 0a 2a 2a 20 63 72 61 73 68 65 rogram.** crashe
12bd0 73 2e 20 20 42 75 74 20 69 66 20 74 68 65 20 6f s. But if the o
12be0 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 perating system
12bf0 63 72 61 73 68 65 73 20 6f 72 20 74 68 65 72 65 crashes or there
12c00 20 69 73 0a 2a 2a 20 61 6e 20 61 62 72 75 70 74 is.** an abrupt
12c10 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 77 power failure w
12c20 68 65 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 hen synchronous
12c30 69 73 20 6f 66 66 2c 20 74 68 65 20 64 61 74 61 is off, the data
12c40 62 61 73 65 0a 2a 2a 20 63 6f 75 6c 64 20 62 65 base.** could be
12c50 20 6c 65 66 74 20 69 6e 20 61 6e 20 69 6e 63 6f left in an inco
12c60 6e 73 69 73 74 65 6e 74 20 61 6e 64 20 75 6e 72 nsistent and unr
12c70 65 63 6f 76 65 72 61 62 6c 65 20 73 74 61 74 65 ecoverable state
12c80 2e 0a 2a 2a 20 53 79 6e 63 68 72 6f 6e 6f 75 73 ..** Synchronous
12c90 20 69 73 20 6f 6e 20 62 79 20 64 65 66 61 75 6c is on by defaul
12ca0 74 20 73 6f 20 64 61 74 61 62 61 73 65 20 63 6f t so database co
12cb0 72 72 75 70 74 69 6f 6e 20 69 73 20 6e 6f 74 0a rruption is not.
12cc0 2a 2a 20 6e 6f 72 6d 61 6c 6c 79 20 61 20 77 6f ** normally a wo
12cd0 72 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 rry..*/.int sqli
12ce0 74 65 33 42 74 72 65 65 53 65 74 43 61 63 68 65 te3BtreeSetCache
12cf0 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 69 Size(Btree *p, i
12d00 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 74 nt mxPage){. Bt
12d10 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
12d20 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 >pBt;. assert(
12d30 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
12d40 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 ld(p->db->mutex)
12d50 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 );. sqlite3Btr
12d60 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 eeEnter(p);. sq
12d70 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 61 63 lite3PagerSetCac
12d80 68 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 hesize(pBt->pPag
12d90 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 er, mxPage);. s
12da0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
12db0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 (p);. return SQ
12dc0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 LITE_OK;.}..#if
12dd0 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
12de0 53 49 5a 45 3e 30 0a 2f 2a 0a 2a 2a 20 43 68 61 SIZE>0./*.** Cha
12df0 6e 67 65 20 74 68 65 20 6c 69 6d 69 74 20 6f 6e nge the limit on
12e00 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 the amount of t
12e10 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
12e20 20 74 68 61 74 20 6d 61 79 20 62 65 0a 2a 2a 20 that may be.**
12e30 6d 65 6d 6f 72 79 20 6d 61 70 70 65 64 2e 0a 2a memory mapped..*
12e40 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
12e50 65 65 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 42 eeSetMmapLimit(B
12e60 74 72 65 65 20 2a 70 2c 20 73 71 6c 69 74 65 33 tree *p, sqlite3
12e70 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 29 7b 0a _int64 szMmap){.
12e80 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
12e90 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 = p->pBt;. asse
12ea0 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
12eb0 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 x_held(p->db->mu
12ec0 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
12ed0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
12ee0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 sqlite3PagerSe
12ef0 74 4d 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e tMmapLimit(pBt->
12f00 70 50 61 67 65 72 2c 20 73 7a 4d 6d 61 70 29 3b pPager, szMmap);
12f10 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
12f20 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
12f30 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
12f40 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
12f50 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 20 MAX_MMAP_SIZE>0
12f60 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 */../*.** Change
12f70 20 74 68 65 20 77 61 79 20 64 61 74 61 20 69 73 the way data is
12f80 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 20 synced to disk
12f90 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e 63 72 in order to incr
12fa0 65 61 73 65 20 6f 72 20 64 65 63 72 65 61 73 65 ease or decrease
12fb0 0a 2a 2a 20 68 6f 77 20 77 65 6c 6c 20 74 68 65 .** how well the
12fc0 20 64 61 74 61 62 61 73 65 20 72 65 73 69 73 74 database resist
12fd0 73 20 64 61 6d 61 67 65 20 64 75 65 20 74 6f 20 s damage due to
12fe0 4f 53 20 63 72 61 73 68 65 73 20 61 6e 64 20 70 OS crashes and p
12ff0 6f 77 65 72 0a 2a 2a 20 66 61 69 6c 75 72 65 73 ower.** failures
13000 2e 20 20 4c 65 76 65 6c 20 31 20 69 73 20 74 68 . Level 1 is th
13010 65 20 73 61 6d 65 20 61 73 20 61 73 79 6e 63 68 e same as asynch
13020 72 6f 6e 6f 75 73 20 28 6e 6f 20 73 79 6e 63 73 ronous (no syncs
13030 28 29 20 6f 63 63 75 72 20 61 6e 64 0a 2a 2a 20 () occur and.**
13040 74 68 65 72 65 20 69 73 20 61 20 68 69 67 68 20 there is a high
13050 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 probability of d
13060 61 6d 61 67 65 29 20 20 4c 65 76 65 6c 20 32 20 amage) Level 2
13070 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e 20 is the default.
13080 20 54 68 65 72 65 0a 2a 2a 20 69 73 20 61 20 76 There.** is a v
13090 65 72 79 20 6c 6f 77 20 62 75 74 20 6e 6f 6e 2d ery low but non-
130a0 7a 65 72 6f 20 70 72 6f 62 61 62 69 6c 69 74 79 zero probability
130b0 20 6f 66 20 64 61 6d 61 67 65 2e 20 20 4c 65 76 of damage. Lev
130c0 65 6c 20 33 20 72 65 64 75 63 65 73 20 74 68 65 el 3 reduces the
130d0 0a 2a 2a 20 70 72 6f 62 61 62 69 6c 69 74 79 20 .** probability
130e0 6f 66 20 64 61 6d 61 67 65 20 74 6f 20 6e 65 61 of damage to nea
130f0 72 20 7a 65 72 6f 20 62 75 74 20 77 69 74 68 20 r zero but with
13100 61 20 77 72 69 74 65 20 70 65 72 66 6f 72 6d 61 a write performa
13110 6e 63 65 20 72 65 64 75 63 74 69 6f 6e 2e 0a 2a nce reduction..*
13120 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
13130 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 _OMIT_PAGER_PRAG
13140 4d 41 53 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 MAS.int sqlite3B
13150 74 72 65 65 53 65 74 50 61 67 65 72 46 6c 61 67 treeSetPagerFlag
13160 73 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 s(. Btree *p,
13170 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
13180 68 65 20 62 74 72 65 65 20 74 6f 20 73 65 74 20 he btree to set
13190 74 68 65 20 73 61 66 65 74 79 20 6c 65 76 65 6c the safety level
131a0 20 6f 6e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 on */. unsigne
131b0 64 20 70 67 46 6c 61 67 73 20 20 20 20 20 20 20 d pgFlags
131c0 2f 2a 20 56 61 72 69 6f 75 73 20 50 41 47 45 52 /* Various PAGER
131d0 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 _* flags */.){.
131e0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
131f0 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 p->pBt;. asser
13200 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
13210 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 _held(p->db->mut
13220 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 ex) );. sqlite3
13230 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
13240 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 sqlite3PagerSet
13250 46 6c 61 67 73 28 70 42 74 2d 3e 70 50 61 67 65 Flags(pBt->pPage
13260 72 2c 20 70 67 46 6c 61 67 73 29 3b 0a 20 20 73 r, pgFlags);. s
13270 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
13280 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 (p);. return SQ
13290 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 LITE_OK;.}.#endi
132a0 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 f../*.** Return
132b0 54 52 55 45 20 69 66 20 74 68 65 20 67 69 76 65 TRUE if the give
132c0 6e 20 62 74 72 65 65 20 69 73 20 73 65 74 20 74 n btree is set t
132d0 6f 20 73 61 66 65 74 79 20 6c 65 76 65 6c 20 31 o safety level 1
132e0 2e 20 20 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 . In other.** w
132f0 6f 72 64 73 2c 20 72 65 74 75 72 6e 20 54 52 55 ords, return TRU
13300 45 20 69 66 20 6e 6f 20 73 79 6e 63 28 29 20 6f E if no sync() o
13310 63 63 75 72 73 20 6f 6e 20 74 68 65 20 64 69 73 ccurs on the dis
13320 6b 20 66 69 6c 65 73 2e 0a 2a 2f 0a 69 6e 74 20 k files..*/.int
13330 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 sqlite3BtreeSync
13340 44 69 73 61 62 6c 65 64 28 42 74 72 65 65 20 2a Disabled(Btree *
13350 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a p){. BtShared *
13360 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
13370 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 int rc;. assert
13380 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
13390 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 held(p->db->mute
133a0 78 29 20 29 3b 20 20 0a 20 20 73 71 6c 69 74 65 x) ); . sqlite
133b0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
133c0 20 20 61 73 73 65 72 74 28 20 70 42 74 20 26 26 assert( pBt &&
133d0 20 70 42 74 2d 3e 70 50 61 67 65 72 20 29 3b 0a pBt->pPager );.
133e0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
133f0 67 65 72 4e 6f 73 79 6e 63 28 70 42 74 2d 3e 70 gerNosync(pBt->p
13400 50 61 67 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 Pager);. sqlite
13410 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
13420 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
13430 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 /*.** Change the
13440 20 64 65 66 61 75 6c 74 20 70 61 67 65 73 20 73 default pages s
13450 69 7a 65 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 ize and the numb
13460 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 62 er of reserved b
13470 79 74 65 73 20 70 65 72 20 70 61 67 65 2e 0a 2a ytes per page..*
13480 2a 20 4f 72 2c 20 69 66 20 74 68 65 20 70 61 67 * Or, if the pag
13490 65 20 73 69 7a 65 20 68 61 73 20 61 6c 72 65 61 e size has alrea
134a0 64 79 20 62 65 65 6e 20 66 69 78 65 64 2c 20 72 dy been fixed, r
134b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 eturn SQLITE_REA
134c0 44 4f 4e 4c 59 20 0a 2a 2a 20 77 69 74 68 6f 75 DONLY .** withou
134d0 74 20 63 68 61 6e 67 69 6e 67 20 61 6e 79 74 68 t changing anyth
134e0 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 ing..**.** The p
134f0 61 67 65 20 73 69 7a 65 20 6d 75 73 74 20 62 65 age size must be
13500 20 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62 65 a power of 2 be
13510 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 tween 512 and 65
13520 35 33 36 2e 20 20 49 66 20 74 68 65 20 70 61 67 536. If the pag
13530 65 0a 2a 2a 20 73 69 7a 65 20 73 75 70 70 6c 69 e.** size suppli
13540 65 64 20 64 6f 65 73 20 6e 6f 74 20 6d 65 65 74 ed does not meet
13550 20 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 this constraint
13560 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 73 then the page s
13570 69 7a 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 63 68 ize is not.** ch
13580 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 anged..**.** Pag
13590 65 20 73 69 7a 65 73 20 61 72 65 20 63 6f 6e 73 e sizes are cons
135a0 74 72 61 69 6e 65 64 20 74 6f 20 62 65 20 61 20 trained to be a
135b0 70 6f 77 65 72 20 6f 66 20 74 77 6f 20 73 6f 20 power of two so
135c0 74 68 61 74 20 74 68 65 20 72 65 67 69 6f 6e 0a that the region.
135d0 2a 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ** of the databa
135e0 73 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 se file used for
135f0 20 6c 6f 63 6b 69 6e 67 20 28 62 65 67 69 6e 6e locking (beginn
13600 69 6e 67 20 61 74 20 50 45 4e 44 49 4e 47 5f 42 ing at PENDING_B
13610 59 54 45 2c 0a 2a 2a 20 74 68 65 20 66 69 72 73 YTE,.** the firs
13620 74 20 62 79 74 65 20 70 61 73 74 20 74 68 65 20 t byte past the
13630 31 47 42 20 62 6f 75 6e 64 61 72 79 2c 20 30 78 1GB boundary, 0x
13640 34 30 30 30 30 30 30 30 29 20 6e 65 65 64 73 20 40000000) needs
13650 74 6f 20 6f 63 63 75 72 0a 2a 2a 20 61 74 20 74 to occur.** at t
13660 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
13670 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 a page..**.** If
13680 20 70 61 72 61 6d 65 74 65 72 20 6e 52 65 73 65 parameter nRese
13690 72 76 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e rve is less than
136a0 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 zero, then the
136b0 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 76 number of reserv
136c0 65 64 0a 2a 2a 20 62 79 74 65 73 20 70 65 72 20 ed.** bytes per
136d0 70 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e 63 page is left unc
136e0 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 hanged..**.** If
136f0 20 74 68 65 20 69 46 69 78 21 3d 30 20 74 68 65 the iFix!=0 the
13700 6e 20 74 68 65 20 42 54 53 5f 50 41 47 45 53 49 n the BTS_PAGESI
13710 5a 45 5f 46 49 58 45 44 20 66 6c 61 67 20 69 73 ZE_FIXED flag is
13720 20 73 65 74 20 73 6f 20 74 68 61 74 20 74 68 65 set so that the
13730 20 70 61 67 65 20 73 69 7a 65 0a 2a 2a 20 61 6e page size.** an
13740 64 20 61 75 74 6f 76 61 63 75 75 6d 20 6d 6f 64 d autovacuum mod
13750 65 20 63 61 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 e can no longer
13760 62 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 be changed..*/.i
13770 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 nt sqlite3BtreeS
13780 65 74 50 61 67 65 53 69 7a 65 28 42 74 72 65 65 etPageSize(Btree
13790 20 2a 70 2c 20 69 6e 74 20 70 61 67 65 53 69 7a *p, int pageSiz
137a0 65 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 2c e, int nReserve,
137b0 20 69 6e 74 20 69 46 69 78 29 7b 0a 20 20 69 6e int iFix){. in
137c0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
137d0 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
137e0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 t = p->pBt;. as
137f0 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e 3d sert( nReserve>=
13800 2d 31 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d -1 && nReserve<=
13810 32 35 35 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 255 );. sqlite3
13820 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
13830 20 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 if( pBt->btsFla
13840 67 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 5a gs & BTS_PAGESIZ
13850 45 5f 46 49 58 45 44 20 29 7b 0a 20 20 20 20 73 E_FIXED ){. s
13860 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
13870 28 70 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 (p);. return
13880 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b SQLITE_READONLY;
13890 0a 20 20 7d 0a 20 20 69 66 28 20 6e 52 65 73 65 . }. if( nRese
138a0 72 76 65 3c 30 20 29 7b 0a 20 20 20 20 6e 52 65 rve<0 ){. nRe
138b0 73 65 72 76 65 20 3d 20 70 42 74 2d 3e 70 61 67 serve = pBt->pag
138c0 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 61 eSize - pBt->usa
138d0 62 6c 65 53 69 7a 65 3b 0a 20 20 7d 0a 20 20 61 bleSize;. }. a
138e0 73 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e ssert( nReserve>
138f0 3d 30 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d =0 && nReserve<=
13900 32 35 35 20 29 3b 0a 20 20 69 66 28 20 70 61 67 255 );. if( pag
13910 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 61 eSize>=512 && pa
13920 67 65 53 69 7a 65 3c 3d 53 51 4c 49 54 45 5f 4d geSize<=SQLITE_M
13930 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 26 26 0a AX_PAGE_SIZE &&.
13940 20 20 20 20 20 20 20 20 28 28 70 61 67 65 53 69 ((pageSi
13950 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 3d ze-1)&pageSize)=
13960 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 =0 ){. assert
13970 28 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 29 ( (pageSize & 7)
13980 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ==0 );. asser
13990 74 28 20 21 70 42 74 2d 3e 70 50 61 67 65 31 20 t( !pBt->pPage1
139a0 26 26 20 21 70 42 74 2d 3e 70 43 75 72 73 6f 72 && !pBt->pCursor
139b0 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 61 67 );. pBt->pag
139c0 65 53 69 7a 65 20 3d 20 28 75 33 32 29 70 61 67 eSize = (u32)pag
139d0 65 53 69 7a 65 3b 0a 20 20 20 20 66 72 65 65 54 eSize;. freeT
139e0 65 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 empSpace(pBt);.
139f0 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
13a00 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
13a10 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 e(pBt->pPager, &
13a20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e pBt->pageSize, n
13a30 52 65 73 65 72 76 65 29 3b 0a 20 20 70 42 74 2d Reserve);. pBt-
13a40 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 >usableSize = pB
13a50 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 28 75 t->pageSize - (u
13a60 31 36 29 6e 52 65 73 65 72 76 65 3b 0a 20 20 69 16)nReserve;. i
13a70 66 28 20 69 46 69 78 20 29 20 70 42 74 2d 3e 62 f( iFix ) pBt->b
13a80 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 tsFlags |= BTS_P
13a90 41 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 20 AGESIZE_FIXED;.
13aa0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
13ab0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
13ac0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 rc;.}../*.** Ret
13ad0 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 6c urn the currentl
13ae0 79 20 64 65 66 69 6e 65 64 20 70 61 67 65 20 73 y defined page s
13af0 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ize.*/.int sqlit
13b00 65 33 42 74 72 65 65 47 65 74 50 61 67 65 53 69 e3BtreeGetPageSi
13b10 7a 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ze(Btree *p){.
13b20 72 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e 70 return p->pBt->p
13b30 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a 23 69 66 20 ageSize;.}..#if
13b40 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 48 defined(SQLITE_H
13b50 41 53 5f 43 4f 44 45 43 29 20 7c 7c 20 64 65 66 AS_CODEC) || def
13b60 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 ined(SQLITE_DEBU
13b70 47 29 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 G)./*.** This fu
13b80 6e 63 74 69 6f 6e 20 69 73 20 73 69 6d 69 6c 61 nction is simila
13b90 72 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 r to sqlite3Btre
13ba0 65 47 65 74 52 65 73 65 72 76 65 28 29 2c 20 65 eGetReserve(), e
13bb0 78 63 65 70 74 20 74 68 61 74 20 69 74 0a 2a 2a xcept that it.**
13bc0 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c may only be cal
13bd0 6c 65 64 20 69 66 20 69 74 20 69 73 20 67 75 61 led if it is gua
13be0 72 61 6e 74 65 65 64 20 74 68 61 74 20 74 68 65 ranteed that the
13bf0 20 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 73 b-tree mutex is
13c00 20 61 6c 72 65 61 64 79 0a 2a 2a 20 68 65 6c 64 already.** held
13c10 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 ..**.** This is
13c20 75 73 65 66 75 6c 20 69 6e 20 6f 6e 65 20 73 70 useful in one sp
13c30 65 63 69 61 6c 20 63 61 73 65 20 69 6e 20 74 68 ecial case in th
13c40 65 20 62 61 63 6b 75 70 20 41 50 49 20 63 6f 64 e backup API cod
13c50 65 20 77 68 65 72 65 20 69 74 20 69 73 0a 2a 2a e where it is.**
13c60 20 6b 6e 6f 77 6e 20 74 68 61 74 20 74 68 65 20 known that the
13c70 73 68 61 72 65 64 20 62 2d 74 72 65 65 20 6d 75 shared b-tree mu
13c80 74 65 78 20 69 73 20 68 65 6c 64 2c 20 62 75 74 tex is held, but
13c90 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 74 68 the mutex on th
13ca0 65 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 e .** database h
13cb0 61 6e 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 andle that owns
13cc0 2a 70 20 69 73 20 6e 6f 74 2e 20 49 6e 20 74 68 *p is not. In th
13cd0 69 73 20 63 61 73 65 20 69 66 20 73 71 6c 69 74 is case if sqlit
13ce0 65 33 42 74 72 65 65 45 6e 74 65 72 28 29 0a 2a e3BtreeEnter().*
13cf0 2a 20 77 65 72 65 20 74 6f 20 62 65 20 63 61 6c * were to be cal
13d00 6c 65 64 2c 20 69 74 20 6d 69 67 68 74 20 63 6f led, it might co
13d10 6c 6c 69 64 65 20 77 69 74 68 20 73 6f 6d 65 20 llide with some
13d20 6f 74 68 65 72 20 6f 70 65 72 61 74 69 6f 6e 20 other operation
13d30 6f 6e 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 on the.** databa
13d40 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 6f se handle that o
13d50 77 6e 73 20 2a 70 2c 20 63 61 75 73 69 6e 67 20 wns *p, causing
13d60 75 6e 64 65 66 69 6e 65 64 20 62 65 68 61 76 69 undefined behavi
13d70 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 or..*/.int sqlit
13d80 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 76 e3BtreeGetReserv
13d90 65 4e 6f 4d 75 74 65 78 28 42 74 72 65 65 20 2a eNoMutex(Btree *
13da0 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 p){. assert( sq
13db0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
13dc0 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 (p->pBt->mutex)
13dd0 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 70 );. return p->p
13de0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 Bt->pageSize - p
13df0 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
13e00 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 e;.}.#endif /* S
13e10 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 20 QLITE_HAS_CODEC
13e20 7c 7c 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 || SQLITE_DEBUG
13e30 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 */..#if !defined
13e40 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 (SQLITE_OMIT_PAG
13e50 45 52 5f 50 52 41 47 4d 41 53 29 20 7c 7c 20 21 ER_PRAGMAS) || !
13e60 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
13e70 4d 49 54 5f 56 41 43 55 55 4d 29 0a 2f 2a 0a 2a MIT_VACUUM)./*.*
13e80 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
13e90 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
13ea0 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 space at the end
13eb0 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 20 74 of every page t
13ec0 68 61 74 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e hat.** are inten
13ed0 74 75 61 6c 6c 79 20 6c 65 66 74 20 75 6e 75 73 tually left unus
13ee0 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 ed. This is the
13ef0 20 22 72 65 73 65 72 76 65 64 22 20 73 70 61 63 "reserved" spac
13f00 65 20 74 68 61 74 20 69 73 0a 2a 2a 20 73 6f 6d e that is.** som
13f10 65 74 69 6d 65 73 20 75 73 65 64 20 62 79 20 65 etimes used by e
13f20 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e xtensions..*/.in
13f30 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 t sqlite3BtreeGe
13f40 74 52 65 73 65 72 76 65 28 42 74 72 65 65 20 2a tReserve(Btree *
13f50 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 73 p){. int n;. s
13f60 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
13f70 28 70 29 3b 0a 20 20 6e 20 3d 20 70 2d 3e 70 42 (p);. n = p->pB
13f80 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 2d t->pageSize - p-
13f90 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
13fa0 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
13fb0 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
13fc0 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 rn n;.}../*.** S
13fd0 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 et the maximum p
13fe0 61 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 20 age count for a
13ff0 64 61 74 61 62 61 73 65 20 69 66 20 6d 78 50 61 database if mxPa
14000 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 2e 0a ge is positive..
14010 2a 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 61 72 ** No changes ar
14020 65 20 6d 61 64 65 20 69 66 20 6d 78 50 61 67 65 e made if mxPage
14030 20 69 73 20 30 20 6f 72 20 6e 65 67 61 74 69 76 is 0 or negativ
14040 65 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 e..** Regardless
14050 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 of the value of
14060 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 6e 20 mxPage, return
14070 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 the maximum page
14080 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 count..*/.int s
14090 71 6c 69 74 65 33 42 74 72 65 65 4d 61 78 50 61 qlite3BtreeMaxPa
140a0 67 65 43 6f 75 6e 74 28 42 74 72 65 65 20 2a 70 geCount(Btree *p
140b0 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 , int mxPage){.
140c0 20 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 int n;. sqlite
140d0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
140e0 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 61 67 n = sqlite3Pag
140f0 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 70 erMaxPageCount(p
14100 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d ->pBt->pPager, m
14110 78 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 xPage);. sqlite
14120 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
14130 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f return n;.}../
14140 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 42 54 53 *.** Set the BTS
14150 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 66 _SECURE_DELETE f
14160 6c 61 67 20 69 66 20 6e 65 77 46 6c 61 67 20 69 lag if newFlag i
14170 73 20 30 20 6f 72 20 31 2e 20 20 49 66 20 6e 65 s 0 or 1. If ne
14180 77 46 6c 61 67 20 69 73 20 2d 31 2c 0a 2a 2a 20 wFlag is -1,.**
14190 74 68 65 6e 20 6d 61 6b 65 20 6e 6f 20 63 68 61 then make no cha
141a0 6e 67 65 73 2e 20 20 41 6c 77 61 79 73 20 72 65 nges. Always re
141b0 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f turn the value o
141c0 66 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 45 f the BTS_SECURE
141d0 5f 44 45 4c 45 54 45 0a 2a 2a 20 73 65 74 74 69 _DELETE.** setti
141e0 6e 67 20 61 66 74 65 72 20 74 68 65 20 63 68 61 ng after the cha
141f0 6e 67 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 nge..*/.int sqli
14200 74 65 33 42 74 72 65 65 53 65 63 75 72 65 44 65 te3BtreeSecureDe
14210 6c 65 74 65 28 42 74 72 65 65 20 2a 70 2c 20 69 lete(Btree *p, i
14220 6e 74 20 6e 65 77 46 6c 61 67 29 7b 0a 20 20 69 nt newFlag){. i
14230 6e 74 20 62 3b 0a 20 20 69 66 28 20 70 3d 3d 30 nt b;. if( p==0
14240 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 73 ) return 0;. s
14250 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
14260 28 70 29 3b 0a 20 20 69 66 28 20 6e 65 77 46 6c (p);. if( newFl
14270 61 67 3e 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e ag>=0 ){. p->
14280 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d pBt->btsFlags &=
14290 20 7e 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c ~BTS_SECURE_DEL
142a0 45 54 45 3b 0a 20 20 20 20 69 66 28 20 6e 65 77 ETE;. if( new
142b0 46 6c 61 67 20 29 20 70 2d 3e 70 42 74 2d 3e 62 Flag ) p->pBt->b
142c0 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 53 tsFlags |= BTS_S
142d0 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 ECURE_DELETE;.
142e0 7d 20 0a 20 20 62 20 3d 20 28 70 2d 3e 70 42 74 } . b = (p->pBt
142f0 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
14300 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 21 _SECURE_DELETE)!
14310 3d 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 =0;. sqlite3Btr
14320 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
14330 74 75 72 6e 20 62 3b 0a 7d 0a 23 65 6e 64 69 66 turn b;.}.#endif
14340 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 53 51 4c /* !defined(SQL
14350 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 ITE_OMIT_PAGER_P
14360 52 41 47 4d 41 53 29 20 7c 7c 20 21 64 65 66 69 RAGMAS) || !defi
14370 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
14380 56 41 43 55 55 4d 29 20 2a 2f 0a 0a 2f 2a 0a 2a VACUUM) */../*.*
14390 2a 20 43 68 61 6e 67 65 20 74 68 65 20 27 61 75 * Change the 'au
143a0 74 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 to-vacuum' prope
143b0 72 74 79 20 6f 66 20 74 68 65 20 64 61 74 61 62 rty of the datab
143c0 61 73 65 2e 20 49 66 20 74 68 65 20 27 61 75 74 ase. If the 'aut
143d0 6f 56 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 oVacuum'.** para
143e0 6d 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 meter is non-zer
143f0 6f 2c 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 o, then auto-vac
14400 75 75 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 uum mode is enab
14410 6c 65 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 led. If zero, it
14420 0a 2a 2a 20 69 73 20 64 69 73 61 62 6c 65 64 2e .** is disabled.
14430 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c The default val
14440 75 65 20 66 6f 72 20 74 68 65 20 61 75 74 6f 2d ue for the auto-
14450 76 61 63 75 75 6d 20 70 72 6f 70 65 72 74 79 20 vacuum property
14460 69 73 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 is .** determine
14470 64 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f d by the SQLITE_
14480 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 DEFAULT_AUTOVACU
14490 55 4d 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 UM macro..*/.int
144a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 sqlite3BtreeSet
144b0 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 AutoVacuum(Btree
144c0 20 2a 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 *p, int autoVac
144d0 75 75 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 4c uum){.#ifdef SQL
144e0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
144f0 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c UUM. return SQL
14500 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 ITE_READONLY;.#e
14510 6c 73 65 0a 20 20 42 74 53 68 61 72 65 64 20 2a lse. BtShared *
14520 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
14530 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
14540 4f 4b 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 75 OK;. u8 av = (u
14550 38 29 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 8)autoVacuum;..
14560 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
14570 65 72 28 70 29 3b 0a 20 20 69 66 28 20 28 70 42 er(p);. if( (pB
14580 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
14590 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 S_PAGESIZE_FIXED
145a0 29 21 3d 30 20 26 26 20 28 61 76 20 3f 31 3a 30 )!=0 && (av ?1:0
145b0 29 21 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 )!=pBt->autoVacu
145c0 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 um ){. rc = S
145d0 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a QLITE_READONLY;.
145e0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 }else{. pBt
145f0 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 ->autoVacuum = a
14600 76 20 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d v ?1:0;. pBt-
14610 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 76 >incrVacuum = av
14620 3d 3d 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 ==2 ?1:0;. }.
14630 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
14640 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
14650 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a c;.#endif.}../*.
14660 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 ** Return the va
14670 6c 75 65 20 6f 66 20 74 68 65 20 27 61 75 74 6f lue of the 'auto
14680 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 -vacuum' propert
14690 79 2e 20 49 66 20 61 75 74 6f 2d 76 61 63 75 75 y. If auto-vacuu
146a0 6d 20 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 m is .** enabled
146b0 20 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 1 is returned.
146c0 4f 74 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a Otherwise 0..*/.
146d0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
146e0 47 65 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 GetAutoVacuum(Bt
146f0 72 65 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 ree *p){.#ifdef
14700 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
14710 56 41 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 VACUUM. return
14720 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d BTREE_AUTOVACUUM
14730 5f 4e 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 _NONE;.#else. i
14740 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 nt rc;. sqlite3
14750 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
14760 20 72 63 20 3d 20 28 0a 20 20 20 20 28 21 70 2d rc = (. (!p-
14770 3e 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d >pBt->autoVacuum
14780 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 )?BTREE_AUTOVACU
14790 55 4d 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 UM_NONE:. (!p
147a0 2d 3e 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 ->pBt->incrVacuu
147b0 6d 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 m)?BTREE_AUTOVAC
147c0 55 55 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 UUM_FULL:. BT
147d0 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 REE_AUTOVACUUM_I
147e0 4e 43 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 NCR. );. sqlit
147f0 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
14800 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 . return rc;.#e
14810 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 47 ndif.}.../*.** G
14820 65 74 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 et a reference t
14830 6f 20 70 50 61 67 65 31 20 6f 66 20 74 68 65 20 o pPage1 of the
14840 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
14850 54 68 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 This will.** als
14860 6f 20 61 63 71 75 69 72 65 20 61 20 72 65 61 64 o acquire a read
14870 6c 6f 63 6b 20 6f 6e 20 74 68 61 74 20 66 69 6c lock on that fil
14880 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f e..**.** SQLITE_
14890 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f OK is returned o
148a0 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 74 n success. If t
148b0 68 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 he file is not a
148c0 0a 2a 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 .** well-formed
148d0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 database file, t
148e0 68 65 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 hen SQLITE_CORRU
148f0 50 54 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a PT is returned..
14900 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 ** SQLITE_BUSY i
14910 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 s returned if th
14920 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f e database is lo
14930 63 6b 65 64 2e 20 20 53 51 4c 49 54 45 5f 4e 4f cked. SQLITE_NO
14940 4d 45 4d 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e MEM.** is return
14950 65 64 20 69 66 20 77 65 20 72 75 6e 20 6f 75 74 ed if we run out
14960 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a 2f 0a of memory. .*/.
14970 73 74 61 74 69 63 20 69 6e 74 20 6c 6f 63 6b 42 static int lockB
14980 74 72 65 65 28 42 74 53 68 61 72 65 64 20 2a 70 tree(BtShared *p
14990 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 Bt){. int rc;
149a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
149b0 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 esult code from
149c0 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a subfunctions */.
149d0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
149e0 31 3b 20 20 20 20 20 2f 2a 20 50 61 67 65 20 31 1; /* Page 1
149f0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
14a00 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e file */. int n
14a10 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
14a20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
14a30 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 es in the databa
14a40 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 se */. int nPag
14a50 65 46 69 6c 65 20 3d 20 30 3b 20 20 20 2f 2a 20 eFile = 0; /*
14a60 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
14a70 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
14a80 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 file */. int nP
14a90 61 67 65 48 65 61 64 65 72 3b 20 20 20 20 20 2f ageHeader; /
14aa0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
14ab0 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 s in the databas
14ac0 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 68 e according to h
14ad0 64 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 dr */.. assert(
14ae0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
14af0 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
14b00 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 );. assert( pBt
14b10 2d 3e 70 50 61 67 65 31 3d 3d 30 20 29 3b 0a 20 ->pPage1==0 );.
14b20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
14b30 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 70 42 74 erSharedLock(pBt
14b40 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 ->pPager);. if(
14b50 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
14b60 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 return rc;. rc
14b70 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
14b80 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 31 2c pBt, 1, &pPage1,
14b90 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 0);. if( rc!=S
14ba0 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 QLITE_OK ) retur
14bb0 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 73 n rc;.. /* Do s
14bc0 6f 6d 65 20 63 68 65 63 6b 69 6e 67 20 74 6f 20 ome checking to
14bd0 68 65 6c 70 20 69 6e 73 75 72 65 20 74 68 65 20 help insure the
14be0 66 69 6c 65 20 77 65 20 6f 70 65 6e 65 64 20 72 file we opened r
14bf0 65 61 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 61 20 eally is. ** a
14c00 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 20 66 valid database f
14c10 69 6c 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 61 ile. . */. nPa
14c20 67 65 20 3d 20 6e 50 61 67 65 48 65 61 64 65 72 ge = nPageHeader
14c30 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 2b 28 = get4byte(28+(
14c40 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 u8*)pPage1->aDat
14c50 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 a);. sqlite3Pag
14c60 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d erPagecount(pBt-
14c70 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 46 >pPager, &nPageF
14c80 69 6c 65 29 3b 0a 20 20 69 66 28 20 6e 50 61 67 ile);. if( nPag
14c90 65 3d 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 32 e==0 || memcmp(2
14ca0 34 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 4+(u8*)pPage1->a
14cb0 44 61 74 61 2c 20 39 32 2b 28 75 38 2a 29 70 50 Data, 92+(u8*)pP
14cc0 61 67 65 31 2d 3e 61 44 61 74 61 2c 34 29 21 3d age1->aData,4)!=
14cd0 30 20 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 3d 0 ){. nPage =
14ce0 20 6e 50 61 67 65 46 69 6c 65 3b 0a 20 20 7d 0a nPageFile;. }.
14cf0 20 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b if( nPage>0 ){
14d00 0a 20 20 20 20 75 33 32 20 70 61 67 65 53 69 7a . u32 pageSiz
14d10 65 3b 0a 20 20 20 20 75 33 32 20 75 73 61 62 6c e;. u32 usabl
14d20 65 53 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 eSize;. u8 *p
14d30 61 67 65 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 age1 = pPage1->a
14d40 44 61 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 Data;. rc = S
14d50 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 QLITE_NOTADB;.
14d60 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 70 61 67 if( memcmp(pag
14d70 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 e1, zMagicHeader
14d80 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 20 20 20 , 16)!=0 ){.
14d90 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
14da0 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
14db0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
14dc0 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 66 28 20 MIT_WAL. if(
14dd0 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 7b 0a 20 page1[18]>1 ){.
14de0 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
14df0 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f gs |= BTS_READ_O
14e00 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 NLY;. }. i
14e10 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 31 20 29 f( page1[19]>1 )
14e20 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
14e30 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
14e40 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 }.#else.
14e50 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 32 20 if( page1[18]>2
14e60 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ){. pBt->bt
14e70 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 sFlags |= BTS_RE
14e80 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 AD_ONLY;. }.
14e90 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
14ea0 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f >2 ){. goto
14eb0 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
14ec0 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ed;. }.. /
14ed0 2a 20 49 66 20 74 68 65 20 77 72 69 74 65 20 76 * If the write v
14ee0 65 72 73 69 6f 6e 20 69 73 20 73 65 74 20 74 6f ersion is set to
14ef0 20 32 2c 20 74 68 69 73 20 64 61 74 61 62 61 73 2, this databas
14f00 65 20 73 68 6f 75 6c 64 20 62 65 20 61 63 63 65 e should be acce
14f10 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 6e 20 57 ssed. ** in W
14f20 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 AL mode. If the
14f30 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 log is not alrea
14f40 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 74 dy open, open it
14f50 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 20 20 20 now. Then .
14f60 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ** return SQLITE
14f70 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 6e 20 77 _OK and return w
14f80 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 74 69 6e ithout populatin
14f90 67 20 42 74 53 68 61 72 65 64 2e 70 50 61 67 65 g BtShared.pPage
14fa0 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 63 61 1.. ** The ca
14fb0 6c 6c 65 72 20 64 65 74 65 63 74 73 20 74 68 69 ller detects thi
14fc0 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 68 69 73 s and calls this
14fd0 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 2e function again.
14fe0 20 54 68 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 This is. **
14ff0 72 65 71 75 69 72 65 64 20 61 73 20 74 68 65 20 required as the
15000 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 65 20 version of page
15010 31 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 1 currently in t
15020 68 65 20 70 61 67 65 31 20 62 75 66 66 65 72 0a he page1 buffer.
15030 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 62 ** may not b
15040 65 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 e the latest ver
15050 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 6d 61 79 sion - there may
15060 20 62 65 20 61 20 6e 65 77 65 72 20 6f 6e 65 20 be a newer one
15070 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 20 20 2a in the log. *
15080 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 * file.. */.
15090 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
150a0 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 62 74 73 ==2 && (pBt->bts
150b0 46 6c 61 67 73 20 26 20 42 54 53 5f 4e 4f 5f 57 Flags & BTS_NO_W
150c0 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 AL)==0 ){.
150d0 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 30 3b 0a int isOpen = 0;.
150e0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
150f0 65 33 50 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 e3PagerOpenWal(p
15100 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 69 73 4f Bt->pPager, &isO
15110 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pen);. if(
15120 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
15130 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 . goto pa
15140 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
15150 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
15160 20 69 73 4f 70 65 6e 3d 3d 30 20 29 7b 0a 23 69 isOpen==0 ){.#i
15170 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 fdef SQLITE_DEFA
15180 55 4c 54 5f 57 41 4c 5f 53 41 46 45 54 59 4c 45 ULT_WAL_SAFETYLE
15190 56 45 4c 0a 20 20 20 20 20 20 20 20 2f 2a 20 44 VEL. /* D
151a0 65 66 61 75 6c 74 20 74 6f 20 73 70 65 63 69 66 efault to specif
151b0 69 65 64 20 73 61 66 65 74 79 5f 6c 65 76 65 6c ied safety_level
151c0 20 66 6f 72 20 57 41 4c 20 6d 6f 64 65 20 2a 2f for WAL mode */
151d0 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 42 74 . if( pBt
151e0 2d 3e 64 62 21 3d 30 20 26 26 20 70 42 74 2d 3e ->db!=0 && pBt->
151f0 64 62 2d 3e 61 44 62 21 3d 30 20 29 7b 0a 20 20 db->aDb!=0 ){.
15200 20 20 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b int iDb;
15210 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
15220 65 33 20 2a 64 62 20 3d 20 70 42 74 2d 3e 64 62 e3 *db = pBt->db
15230 3b 0a 20 20 20 20 20 20 20 20 20 20 44 62 20 2a ;. Db *
15240 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 3b 0a 20 aDb = db->aDb;.
15250 20 20 20 20 20 20 20 20 20 75 38 20 6c 65 76 65 u8 leve
15260 6c 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 l = 0;.
15270 20 66 6f 72 28 69 44 62 3d 30 3b 20 69 44 62 3c for(iDb=0; iDb<
15280 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 7b db->nDb; iDb++){
15290 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 . if(
152a0 20 61 44 62 5b 69 44 62 5d 2e 70 42 74 20 26 26 aDb[iDb].pBt &&
152b0 20 61 44 62 5b 69 44 62 5d 2e 70 42 74 2d 3e 70 aDb[iDb].pBt->p
152c0 42 74 3d 3d 70 42 74 20 29 20 62 72 65 61 6b 3b Bt==pBt ) break;
152d0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
152e0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 assert( i
152f0 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 Db<db->nDb );.
15300 20 20 20 20 20 20 20 20 6c 65 76 65 6c 20 3d 20 level =
15310 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 73 61 66 db->aDb[iDb].saf
15320 65 74 79 5f 6c 65 76 65 6c 3b 0a 20 20 20 20 20 ety_level;.
15330 20 20 20 20 20 69 66 28 20 21 53 51 4c 49 54 45 if( !SQLITE
15340 5f 44 62 53 61 66 65 74 79 4c 65 76 65 6c 49 73 _DbSafetyLevelIs
15350 46 69 78 65 64 28 6c 65 76 65 6c 29 20 26 26 20 Fixed(level) &&
15360 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 53 . (S
15370 51 4c 49 54 45 5f 44 62 53 61 66 65 74 79 4c 65 QLITE_DbSafetyLe
15380 76 65 6c 56 61 6c 75 65 28 6c 65 76 65 6c 29 20 velValue(level)
15390 21 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c != SQLITE_DEFAUL
153a0 54 5f 57 41 4c 5f 53 41 46 45 54 59 4c 45 56 45 T_WAL_SAFETYLEVE
153b0 4c 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 L) ){.
153c0 20 20 61 44 62 5b 69 44 62 5d 2e 73 61 66 65 74 aDb[iDb].safet
153d0 79 5f 6c 65 76 65 6c 20 3d 20 53 51 4c 49 54 45 y_level = SQLITE
153e0 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 41 46 _DEFAULT_WAL_SAF
153f0 45 54 59 4c 45 56 45 4c 3b 0a 20 20 20 20 20 20 ETYLEVEL;.
15400 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
15410 65 72 53 65 74 53 61 66 65 74 79 4c 65 76 65 6c erSetSafetyLevel
15420 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 51 (pBt->pPager, SQ
15430 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c LITE_DEFAULT_WAL
15440 5f 53 41 46 45 54 59 4c 45 56 45 4c 2c 20 0a 20 _SAFETYLEVEL, .
15450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15470 20 20 20 20 20 20 28 64 62 2d 3e 66 6c 61 67 73 (db->flags
15480 26 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 79 6e &SQLITE_FullFSyn
15490 63 29 21 3d 30 2c 0a 20 20 20 20 20 20 20 20 20 c)!=0,.
154a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
154b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 (d
154c0 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f b->flags&SQLITE_
154d0 43 6b 70 74 46 75 6c 6c 46 53 79 6e 63 29 21 3d CkptFullFSync)!=
154e0 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 0);. }.
154f0 20 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 }.#endif
15500 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 . release
15510 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 Page(pPage1);.
15520 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
15530 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a ITE_OK;. }.
15540 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
15550 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 7d 0a E_NOTADB;. }.
15560 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 54 #endif.. /* T
15570 68 65 20 6d 61 78 69 6d 75 6d 20 65 6d 62 65 64 he maximum embed
15580 64 65 64 20 66 72 61 63 74 69 6f 6e 20 6d 75 73 ded fraction mus
15590 74 20 62 65 20 65 78 61 63 74 6c 79 20 32 35 25 t be exactly 25%
155a0 2e 20 20 41 6e 64 20 74 68 65 20 6d 69 6e 69 6d . And the minim
155b0 75 6d 0a 20 20 20 20 2a 2a 20 65 6d 62 65 64 64 um. ** embedd
155c0 65 64 20 66 72 61 63 74 69 6f 6e 20 6d 75 73 74 ed fraction must
155d0 20 62 65 20 31 32 2e 35 25 20 66 6f 72 20 62 6f be 12.5% for bo
155e0 74 68 20 6c 65 61 66 2d 64 61 74 61 20 61 6e 64 th leaf-data and
155f0 20 6e 6f 6e 2d 6c 65 61 66 2d 64 61 74 61 2e 0a non-leaf-data..
15600 20 20 20 20 2a 2a 20 54 68 65 20 6f 72 69 67 69 ** The origi
15610 6e 61 6c 20 64 65 73 69 67 6e 20 61 6c 6c 6f 77 nal design allow
15620 65 64 20 74 68 65 73 65 20 61 6d 6f 75 6e 74 73 ed these amounts
15630 20 74 6f 20 76 61 72 79 2c 20 62 75 74 20 61 73 to vary, but as
15640 20 6f 66 0a 20 20 20 20 2a 2a 20 76 65 72 73 69 of. ** versi
15650 6f 6e 20 33 2e 36 2e 30 2c 20 77 65 20 72 65 71 on 3.6.0, we req
15660 75 69 72 65 20 74 68 65 6d 20 74 6f 20 62 65 20 uire them to be
15670 66 69 78 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 fixed.. */.
15680 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 26 70 61 if( memcmp(&pa
15690 67 65 31 5b 32 31 5d 2c 20 22 5c 31 30 30 5c 30 ge1[21], "\100\0
156a0 34 30 5c 30 34 30 22 2c 33 29 21 3d 30 20 29 7b 40\040",3)!=0 ){
156b0 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
156c0 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 1_init_failed;.
156d0 20 20 20 7d 0a 20 20 20 20 70 61 67 65 53 69 7a }. pageSiz
156e0 65 20 3d 20 28 70 61 67 65 31 5b 31 36 5d 3c 3c e = (page1[16]<<
156f0 38 29 20 7c 20 28 70 61 67 65 31 5b 31 37 5d 3c 8) | (page1[17]<
15700 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 20 28 28 <16);. if( ((
15710 70 61 67 65 53 69 7a 65 2d 31 29 26 70 61 67 65 pageSize-1)&page
15720 53 69 7a 65 29 21 3d 30 0a 20 20 20 20 20 7c 7c Size)!=0. ||
15730 20 70 61 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 pageSize>SQLITE
15740 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 0a _MAX_PAGE_SIZE .
15750 20 20 20 20 20 7c 7c 20 70 61 67 65 53 69 7a 65 || pageSize
15760 3c 3d 32 35 36 20 0a 20 20 20 20 29 7b 0a 20 20 <=256 . ){.
15770 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 goto page1_i
15780 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 nit_failed;.
15790 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 }. assert( (p
157a0 61 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 ageSize & 7)==0
157b0 29 3b 0a 20 20 20 20 75 73 61 62 6c 65 53 69 7a );. usableSiz
157c0 65 20 3d 20 70 61 67 65 53 69 7a 65 20 2d 20 70 e = pageSize - p
157d0 61 67 65 31 5b 32 30 5d 3b 0a 20 20 20 20 69 66 age1[20];. if
157e0 28 20 28 75 33 32 29 70 61 67 65 53 69 7a 65 21 ( (u32)pageSize!
157f0 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 =pBt->pageSize )
15800 7b 0a 20 20 20 20 20 20 2f 2a 20 41 66 74 65 72 {. /* After
15810 20 72 65 61 64 69 6e 67 20 74 68 65 20 66 69 72 reading the fir
15820 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 st page of the d
15830 61 74 61 62 61 73 65 20 61 73 73 75 6d 69 6e 67 atabase assuming
15840 20 61 20 70 61 67 65 20 73 69 7a 65 0a 20 20 20 a page size.
15850 20 20 20 2a 2a 20 6f 66 20 42 74 53 68 61 72 65 ** of BtShare
15860 64 2e 70 61 67 65 53 69 7a 65 2c 20 77 65 20 68 d.pageSize, we h
15870 61 76 65 20 64 69 73 63 6f 76 65 72 65 64 20 74 ave discovered t
15880 68 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a hat the page-siz
15890 65 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 61 63 e is. ** ac
158a0 74 75 61 6c 6c 79 20 70 61 67 65 53 69 7a 65 2e tually pageSize.
158b0 20 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 Unlock the data
158c0 62 61 73 65 2c 20 6c 65 61 76 65 20 70 42 74 2d base, leave pBt-
158d0 3e 70 50 61 67 65 31 20 61 74 0a 20 20 20 20 20 >pPage1 at.
158e0 20 2a 2a 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 ** zero and ret
158f0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 urn SQLITE_OK. T
15900 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 63 he caller will c
15910 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f all this functio
15920 6e 0a 20 20 20 20 20 20 2a 2a 20 61 67 61 69 6e n. ** again
15930 20 77 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 with the correc
15940 74 20 70 61 67 65 2d 73 69 7a 65 2e 0a 20 20 20 t page-size..
15950 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 6c 65 */. rele
15960 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b asePage(pPage1);
15970 0a 20 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 . pBt->usab
15980 6c 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 leSize = usableS
15990 69 7a 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e ize;. pBt->
159a0 70 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 pageSize = pageS
159b0 69 7a 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 ize;. freeT
159c0 65 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 empSpace(pBt);.
159d0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
159e0 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
159f0 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 e(pBt->pPager, &
15a00 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 pBt->pageSize,.
15a10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15a30 20 20 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c pageSize-usabl
15a40 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 eSize);. re
15a50 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
15a60 20 20 20 69 66 28 20 28 70 42 74 2d 3e 64 62 2d if( (pBt->db-
15a70 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f >flags & SQLITE_
15a80 52 65 63 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 RecoveryMode)==0
15a90 20 26 26 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 && nPage>nPageF
15aa0 69 6c 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 ile ){. rc
15ab0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
15ac0 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 _BKPT;. got
15ad0 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 o page1_init_fai
15ae0 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 led;. }. i
15af0 66 28 20 75 73 61 62 6c 65 53 69 7a 65 3c 34 38 f( usableSize<48
15b00 30 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 0 ){. goto
15b10 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 page1_init_faile
15b20 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 42 74 d;. }. pBt
15b30 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 70 61 67 ->pageSize = pag
15b40 65 53 69 7a 65 3b 0a 20 20 20 20 70 42 74 2d 3e eSize;. pBt->
15b50 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 75 73 61 usableSize = usa
15b60 62 6c 65 53 69 7a 65 3b 0a 23 69 66 6e 64 65 66 bleSize;.#ifndef
15b70 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
15b80 4f 56 41 43 55 55 4d 0a 20 20 20 20 70 42 74 2d OVACUUM. pBt-
15b90 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 >autoVacuum = (g
15ba0 65 74 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 et4byte(&page1[3
15bb0 36 20 2b 20 34 2a 34 5d 29 3f 31 3a 30 29 3b 0a 6 + 4*4])?1:0);.
15bc0 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 pBt->incrVac
15bd0 75 75 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 uum = (get4byte(
15be0 26 70 61 67 65 31 5b 33 36 20 2b 20 37 2a 34 5d &page1[36 + 7*4]
15bf0 29 3f 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 )?1:0);.#endif.
15c00 20 7d 0a 0a 20 20 2f 2a 20 6d 61 78 4c 6f 63 61 }.. /* maxLoca
15c10 6c 20 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d l is the maximum
15c20 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f amount of paylo
15c30 61 64 20 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 ad to store loca
15c40 6c 6c 79 20 66 6f 72 0a 20 20 2a 2a 20 61 20 63 lly for. ** a c
15c50 65 6c 6c 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 ell. Make sure
15c60 69 74 20 69 73 20 73 6d 61 6c 6c 20 65 6e 6f 75 it is small enou
15c70 67 68 20 73 6f 20 74 68 61 74 20 61 74 20 6c 65 gh so that at le
15c80 61 73 74 20 6d 69 6e 46 61 6e 6f 75 74 0a 20 20 ast minFanout.
15c90 2a 2a 20 63 65 6c 6c 73 20 63 61 6e 20 77 69 6c ** cells can wil
15ca0 6c 20 66 69 74 20 6f 6e 20 6f 6e 65 20 70 61 67 l fit on one pag
15cb0 65 2e 20 20 57 65 20 61 73 73 75 6d 65 20 61 20 e. We assume a
15cc0 31 30 2d 62 79 74 65 20 70 61 67 65 20 68 65 61 10-byte page hea
15cd0 64 65 72 2e 0a 20 20 2a 2a 20 42 65 73 69 64 65 der.. ** Beside
15ce0 73 20 74 68 65 20 70 61 79 6c 6f 61 64 2c 20 74 s the payload, t
15cf0 68 65 20 63 65 6c 6c 20 6d 75 73 74 20 73 74 6f he cell must sto
15d00 72 65 3a 0a 20 20 2a 2a 20 20 20 20 20 32 2d 62 re:. ** 2-b
15d10 79 74 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 yte pointer to t
15d20 68 65 20 63 65 6c 6c 0a 20 20 2a 2a 20 20 20 20 he cell. **
15d30 20 34 2d 62 79 74 65 20 63 68 69 6c 64 20 70 6f 4-byte child po
15d40 69 6e 74 65 72 0a 20 20 2a 2a 20 20 20 20 20 39 inter. ** 9
15d50 2d 62 79 74 65 20 6e 4b 65 79 20 76 61 6c 75 65 -byte nKey value
15d60 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 . ** 4-byte
15d70 20 6e 44 61 74 61 20 76 61 6c 75 65 0a 20 20 2a nData value. *
15d80 2a 20 20 20 20 20 34 2d 62 79 74 65 20 6f 76 65 * 4-byte ove
15d90 72 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 rflow page point
15da0 65 72 0a 20 20 2a 2a 20 53 6f 20 61 20 63 65 6c er. ** So a cel
15db0 6c 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 l consists of a
15dc0 32 2d 62 79 74 65 20 70 6f 69 6e 74 65 72 2c 20 2-byte pointer,
15dd0 61 20 68 65 61 64 65 72 20 77 68 69 63 68 20 69 a header which i
15de0 73 20 61 73 20 6d 75 63 68 20 61 73 0a 20 20 2a s as much as. *
15df0 2a 20 31 37 20 62 79 74 65 73 20 6c 6f 6e 67 2c * 17 bytes long,
15e00 20 30 20 74 6f 20 4e 20 62 79 74 65 73 20 6f 66 0 to N bytes of
15e10 20 70 61 79 6c 6f 61 64 2c 20 61 6e 64 20 61 6e payload, and an
15e20 20 6f 70 74 69 6f 6e 61 6c 20 34 20 62 79 74 65 optional 4 byte
15e30 20 6f 76 65 72 66 6c 6f 77 0a 20 20 2a 2a 20 70 overflow. ** p
15e40 61 67 65 20 70 6f 69 6e 74 65 72 2e 0a 20 20 2a age pointer.. *
15e50 2f 0a 20 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 /. pBt->maxLoca
15e60 6c 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d 3e l = (u16)((pBt->
15e70 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a 36 usableSize-12)*6
15e80 34 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 70 4/255 - 23);. p
15e90 42 74 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 28 Bt->minLocal = (
15ea0 75 31 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c u16)((pBt->usabl
15eb0 65 53 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 eSize-12)*32/255
15ec0 20 2d 20 32 33 29 3b 0a 20 20 70 42 74 2d 3e 6d - 23);. pBt->m
15ed0 61 78 4c 65 61 66 20 3d 20 28 75 31 36 29 28 70 axLeaf = (u16)(p
15ee0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
15ef0 20 33 35 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 35);. pBt->min
15f00 4c 65 61 66 20 3d 20 28 75 31 36 29 28 28 70 42 Leaf = (u16)((pB
15f10 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 t->usableSize-12
15f20 29 2a 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a )*32/255 - 23);.
15f30 20 20 69 66 28 20 70 42 74 2d 3e 6d 61 78 4c 6f if( pBt->maxLo
15f40 63 61 6c 3e 31 32 37 20 29 7b 0a 20 20 20 20 70 cal>127 ){. p
15f50 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c Bt->max1bytePayl
15f60 6f 61 64 20 3d 20 31 32 37 3b 0a 20 20 7d 65 6c oad = 127;. }el
15f70 73 65 7b 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 se{. pBt->max
15f80 31 62 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 28 1bytePayload = (
15f90 75 38 29 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c u8)pBt->maxLocal
15fa0 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
15fb0 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 2b 20 32 pBt->maxLeaf + 2
15fc0 33 20 3c 3d 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 3 <= MX_CELL_SIZ
15fd0 45 28 70 42 74 29 20 29 3b 0a 20 20 70 42 74 2d E(pBt) );. pBt-
15fe0 3e 70 50 61 67 65 31 20 3d 20 70 50 61 67 65 31 >pPage1 = pPage1
15ff0 3b 0a 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d ;. pBt->nPage =
16000 20 6e 50 61 67 65 3b 0a 20 20 72 65 74 75 72 6e nPage;. return
16010 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 SQLITE_OK;..pag
16020 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3a 0a e1_init_failed:.
16030 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
16040 61 67 65 31 29 3b 0a 20 20 70 42 74 2d 3e 70 50 age1);. pBt->pP
16050 61 67 65 31 20 3d 20 30 3b 0a 20 20 72 65 74 75 age1 = 0;. retu
16060 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 rn rc;.}..#ifnde
16070 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 f NDEBUG./*.** R
16080 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 eturn the number
16090 20 6f 66 20 63 75 72 73 6f 72 73 20 6f 70 65 6e of cursors open
160a0 20 6f 6e 20 70 42 74 2e 20 54 68 69 73 20 69 73 on pBt. This is
160b0 20 66 6f 72 20 75 73 65 0a 2a 2a 20 69 6e 20 61 for use.** in a
160c0 73 73 65 72 74 28 29 20 65 78 70 72 65 73 73 69 ssert() expressi
160d0 6f 6e 73 2c 20 73 6f 20 69 74 20 69 73 20 6f 6e ons, so it is on
160e0 6c 79 20 63 6f 6d 70 69 6c 65 64 20 69 66 20 4e ly compiled if N
160f0 44 45 42 55 47 20 69 73 20 6e 6f 74 0a 2a 2a 20 DEBUG is not.**
16100 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f defined..**.** O
16110 6e 6c 79 20 77 72 69 74 65 20 63 75 72 73 6f 72 nly write cursor
16120 73 20 61 72 65 20 63 6f 75 6e 74 65 64 20 69 66 s are counted if
16130 20 77 72 4f 6e 6c 79 20 69 73 20 74 72 75 65 2e wrOnly is true.
16140 20 20 49 66 20 77 72 4f 6e 6c 79 20 69 73 0a 2a If wrOnly is.*
16150 2a 20 66 61 6c 73 65 20 74 68 65 6e 20 61 6c 6c * false then all
16160 20 63 75 72 73 6f 72 73 20 61 72 65 20 63 6f 75 cursors are cou
16170 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 nted..**.** For
16180 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 20 the purposes of
16190 74 68 69 73 20 72 6f 75 74 69 6e 65 2c 20 61 20 this routine, a
161a0 63 75 72 73 6f 72 20 69 73 20 61 6e 79 20 63 75 cursor is any cu
161b0 72 73 6f 72 20 74 68 61 74 0a 2a 2a 20 69 73 20 rsor that.** is
161c0 63 61 70 61 62 6c 65 20 6f 66 20 72 65 61 64 69 capable of readi
161d0 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 20 74 6f ng or writing to
161e0 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 the database.
161f0 43 75 72 73 6f 72 73 20 74 68 61 74 0a 2a 2a 20 Cursors that.**
16200 68 61 76 65 20 62 65 65 6e 20 74 72 69 70 70 65 have been trippe
16210 64 20 69 6e 74 6f 20 74 68 65 20 43 55 52 53 4f d into the CURSO
16220 52 5f 46 41 55 4c 54 20 73 74 61 74 65 20 61 72 R_FAULT state ar
16230 65 20 6e 6f 74 20 63 6f 75 6e 74 65 64 2e 0a 2a e not counted..*
16240 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6f 75 /.static int cou
16250 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 42 ntValidCursors(B
16260 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 69 6e tShared *pBt, in
16270 74 20 77 72 4f 6e 6c 79 29 7b 0a 20 20 42 74 43 t wrOnly){. BtC
16280 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a 20 20 69 ursor *pCur;. i
16290 6e 74 20 72 20 3d 20 30 3b 0a 20 20 66 6f 72 28 nt r = 0;. for(
162a0 70 43 75 72 3d 70 42 74 2d 3e 70 43 75 72 73 6f pCur=pBt->pCurso
162b0 72 3b 20 70 43 75 72 3b 20 70 43 75 72 3d 70 43 r; pCur; pCur=pC
162c0 75 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 ur->pNext){.
162d0 69 66 28 20 28 77 72 4f 6e 6c 79 3d 3d 30 20 7c if( (wrOnly==0 |
162e0 7c 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 | (pCur->curFlag
162f0 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 6c s & BTCF_WriteFl
16300 61 67 29 21 3d 30 29 0a 20 20 20 20 20 26 26 20 ag)!=0). &&
16310 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
16320 52 53 4f 52 5f 46 41 55 4c 54 20 29 20 72 2b 2b RSOR_FAULT ) r++
16330 3b 20 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 ; . }. return
16340 72 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a r;.}.#endif../*.
16350 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 ** If there are
16360 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 no outstanding c
16370 75 72 73 6f 72 73 20 61 6e 64 20 77 65 20 61 72 ursors and we ar
16380 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 6d 69 64 e not in the mid
16390 64 6c 65 0a 2a 2a 20 6f 66 20 61 20 74 72 61 6e dle.** of a tran
163a0 73 61 63 74 69 6f 6e 20 62 75 74 20 74 68 65 72 saction but ther
163b0 65 20 69 73 20 61 20 72 65 61 64 20 6c 6f 63 6b e is a read lock
163c0 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
163d0 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 20 72 , then.** this r
163e0 6f 75 74 69 6e 65 20 75 6e 72 65 66 73 20 74 68 outine unrefs th
163f0 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 e first page of
16400 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
16410 65 20 77 68 69 63 68 20 0a 2a 2a 20 68 61 73 20 e which .** has
16420 74 68 65 20 65 66 66 65 63 74 20 6f 66 20 72 65 the effect of re
16430 6c 65 61 73 69 6e 67 20 74 68 65 20 72 65 61 64 leasing the read
16440 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 lock..**.** If
16450 74 68 65 72 65 20 69 73 20 61 20 74 72 61 6e 73 there is a trans
16460 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 action in progre
16470 73 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ss, this routine
16480 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a is a no-op..*/.
16490 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 6c 6f static void unlo
164a0 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 ckBtreeIfUnused(
164b0 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
164c0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
164d0 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
164e0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
164f0 73 65 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 sert( countValid
16500 43 75 72 73 6f 72 73 28 70 42 74 2c 30 29 3d 3d Cursors(pBt,0)==
16510 30 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 61 6e 0 || pBt->inTran
16520 73 61 63 74 69 6f 6e 3e 54 52 41 4e 53 5f 4e 4f saction>TRANS_NO
16530 4e 45 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d NE );. if( pBt-
16540 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d >inTransaction==
16550 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 20 70 42 TRANS_NONE && pB
16560 74 2d 3e 70 50 61 67 65 31 21 3d 30 20 29 7b 0a t->pPage1!=0 ){.
16570 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 MemPage *pPa
16580 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 ge1 = pBt->pPage
16590 31 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 1;. assert( p
165a0 50 61 67 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a Page1->aData );.
165b0 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
165c0 74 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 te3PagerRefcount
165d0 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d 31 (pBt->pPager)==1
165e0 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 50 61 );. pBt->pPa
165f0 67 65 31 20 3d 20 30 3b 0a 20 20 20 20 72 65 6c ge1 = 0;. rel
16600 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 easePage(pPage1)
16610 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 ;. }.}../*.** I
16620 66 20 70 42 74 20 70 6f 69 6e 74 73 20 74 6f 20 f pBt points to
16630 61 6e 20 65 6d 70 74 79 20 66 69 6c 65 20 74 68 an empty file th
16640 65 6e 20 63 6f 6e 76 65 72 74 20 74 68 61 74 20 en convert that
16650 65 6d 70 74 79 20 66 69 6c 65 0a 2a 2a 20 69 6e empty file.** in
16660 74 6f 20 61 20 6e 65 77 20 65 6d 70 74 79 20 64 to a new empty d
16670 61 74 61 62 61 73 65 20 62 79 20 69 6e 69 74 69 atabase by initi
16680 61 6c 69 7a 69 6e 67 20 74 68 65 20 66 69 72 73 alizing the firs
16690 74 20 70 61 67 65 20 6f 66 0a 2a 2a 20 74 68 65 t page of.** the
166a0 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 73 74 database..*/.st
166b0 61 74 69 63 20 69 6e 74 20 6e 65 77 44 61 74 61 atic int newData
166c0 62 61 73 65 28 42 74 53 68 61 72 65 64 20 2a 70 base(BtShared *p
166d0 42 74 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a Bt){. MemPage *
166e0 70 50 31 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 pP1;. unsigned
166f0 63 68 61 72 20 2a 64 61 74 61 3b 0a 20 20 69 6e char *data;. in
16700 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 t rc;.. assert(
16710 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
16720 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
16730 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 );. if( pBt->nP
16740 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 72 65 74 age>0 ){. ret
16750 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
16760 20 7d 0a 20 20 70 50 31 20 3d 20 70 42 74 2d 3e }. pP1 = pBt->
16770 70 50 61 67 65 31 3b 0a 20 20 61 73 73 65 72 74 pPage1;. assert
16780 28 20 70 50 31 21 3d 30 20 29 3b 0a 20 20 64 61 ( pP1!=0 );. da
16790 74 61 20 3d 20 70 50 31 2d 3e 61 44 61 74 61 3b ta = pP1->aData;
167a0 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
167b0 61 67 65 72 57 72 69 74 65 28 70 50 31 2d 3e 70 agerWrite(pP1->p
167c0 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 DbPage);. if( r
167d0 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
167e0 20 6d 65 6d 63 70 79 28 64 61 74 61 2c 20 7a 4d memcpy(data, zM
167f0 61 67 69 63 48 65 61 64 65 72 2c 20 73 69 7a 65 agicHeader, size
16800 6f 66 28 7a 4d 61 67 69 63 48 65 61 64 65 72 29 of(zMagicHeader)
16810 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 69 7a );. assert( siz
16820 65 6f 66 28 7a 4d 61 67 69 63 48 65 61 64 65 72 eof(zMagicHeader
16830 29 3d 3d 31 36 20 29 3b 0a 20 20 64 61 74 61 5b )==16 );. data[
16840 31 36 5d 20 3d 20 28 75 38 29 28 28 70 42 74 2d 16] = (u8)((pBt-
16850 3e 70 61 67 65 53 69 7a 65 3e 3e 38 29 26 30 78 >pageSize>>8)&0x
16860 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 37 5d 20 ff);. data[17]
16870 3d 20 28 75 38 29 28 28 70 42 74 2d 3e 70 61 67 = (u8)((pBt->pag
16880 65 53 69 7a 65 3e 3e 31 36 29 26 30 78 66 66 29 eSize>>16)&0xff)
16890 3b 0a 20 20 64 61 74 61 5b 31 38 5d 20 3d 20 31 ;. data[18] = 1
168a0 3b 0a 20 20 64 61 74 61 5b 31 39 5d 20 3d 20 31 ;. data[19] = 1
168b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d ;. assert( pBt-
168c0 3e 75 73 61 62 6c 65 53 69 7a 65 3c 3d 70 42 74 >usableSize<=pBt
168d0 2d 3e 70 61 67 65 53 69 7a 65 20 26 26 20 70 42 ->pageSize && pB
168e0 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2b 32 35 t->usableSize+25
168f0 35 3e 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5>=pBt->pageSize
16900 29 3b 0a 20 20 64 61 74 61 5b 32 30 5d 20 3d 20 );. data[20] =
16910 28 75 38 29 28 70 42 74 2d 3e 70 61 67 65 53 69 (u8)(pBt->pageSi
16920 7a 65 20 2d 20 70 42 74 2d 3e 75 73 61 62 6c 65 ze - pBt->usable
16930 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 31 Size);. data[21
16940 5d 20 3d 20 36 34 3b 0a 20 20 64 61 74 61 5b 32 ] = 64;. data[2
16950 32 5d 20 3d 20 33 32 3b 0a 20 20 64 61 74 61 5b 2] = 32;. data[
16960 32 33 5d 20 3d 20 33 32 3b 0a 20 20 6d 65 6d 73 23] = 32;. mems
16970 65 74 28 26 64 61 74 61 5b 32 34 5d 2c 20 30 2c et(&data[24], 0,
16980 20 31 30 30 2d 32 34 29 3b 0a 20 20 7a 65 72 6f 100-24);. zero
16990 50 61 67 65 28 70 50 31 2c 20 50 54 46 5f 49 4e Page(pP1, PTF_IN
169a0 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 7c 50 54 TKEY|PTF_LEAF|PT
169b0 46 5f 4c 45 41 46 44 41 54 41 20 29 3b 0a 20 20 F_LEAFDATA );.
169c0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
169d0 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 BTS_PAGESIZE_FI
169e0 58 45 44 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c XED;.#ifndef SQL
169f0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
16a00 55 55 4d 0a 20 20 61 73 73 65 72 74 28 20 70 42 UUM. assert( pB
16a10 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 3d 3d 31 t->autoVacuum==1
16a20 20 7c 7c 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 || pBt->autoVac
16a30 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 uum==0 );. asse
16a40 72 74 28 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 rt( pBt->incrVac
16a50 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 69 uum==1 || pBt->i
16a60 6e 63 72 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a ncrVacuum==0 );.
16a70 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 61 put4byte(&data
16a80 5b 33 36 20 2b 20 34 2a 34 5d 2c 20 70 42 74 2d [36 + 4*4], pBt-
16a90 3e 61 75 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 >autoVacuum);.
16aa0 70 75 74 34 62 79 74 65 28 26 64 61 74 61 5b 33 put4byte(&data[3
16ab0 36 20 2b 20 37 2a 34 5d 2c 20 70 42 74 2d 3e 69 6 + 7*4], pBt->i
16ac0 6e 63 72 56 61 63 75 75 6d 29 3b 0a 23 65 6e 64 ncrVacuum);.#end
16ad0 69 66 0a 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 if. pBt->nPage
16ae0 3d 20 31 3b 0a 20 20 64 61 74 61 5b 33 31 5d 20 = 1;. data[31]
16af0 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 = 1;. return SQ
16b00 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
16b10 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 * Initialize the
16b20 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 first page of t
16b30 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
16b40 20 28 63 72 65 61 74 69 6e 67 20 61 20 64 61 74 (creating a dat
16b50 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 73 69 73 74 abase.** consist
16b60 69 6e 67 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 ing of a single
16b70 70 61 67 65 20 61 6e 64 20 6e 6f 20 73 63 68 65 page and no sche
16b80 6d 61 20 6f 62 6a 65 63 74 73 29 2e 20 52 65 74 ma objects). Ret
16b90 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a urn SQLITE_OK.**
16ba0 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 if successful,
16bb0 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 or an SQLite err
16bc0 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77 69 73 or code otherwis
16bd0 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
16be0 33 42 74 72 65 65 4e 65 77 44 62 28 42 74 72 65 3BtreeNewDb(Btre
16bf0 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b e *p){. int rc;
16c00 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
16c10 6e 74 65 72 28 70 29 3b 0a 20 20 70 2d 3e 70 42 nter(p);. p->pB
16c20 74 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 t->nPage = 0;.
16c30 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 rc = newDatabase
16c40 28 70 2d 3e 70 42 74 29 3b 0a 20 20 73 71 6c 69 (p->pBt);. sqli
16c50 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
16c60 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
16c70 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 ../*.** Attempt
16c80 74 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20 74 to start a new t
16c90 72 61 6e 73 61 63 74 69 6f 6e 2e 20 41 20 77 72 ransaction. A wr
16ca0 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a ite-transaction.
16cb0 2a 2a 20 69 73 20 73 74 61 72 74 65 64 20 69 66 ** is started if
16cc0 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 the second argu
16cd0 6d 65 6e 74 20 69 73 20 6e 6f 6e 7a 65 72 6f 2c ment is nonzero,
16ce0 20 6f 74 68 65 72 77 69 73 65 20 61 20 72 65 61 otherwise a rea
16cf0 64 2d 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f d-.** transactio
16d00 6e 2e 20 20 49 66 20 74 68 65 20 73 65 63 6f 6e n. If the secon
16d10 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 32 20 d argument is 2
16d20 6f 72 20 6d 6f 72 65 20 61 6e 64 20 65 78 63 6c or more and excl
16d30 75 73 69 76 65 0a 2a 2a 20 74 72 61 6e 73 61 63 usive.** transac
16d40 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64 2c tion is started,
16d50 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 6e 6f meaning that no
16d60 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 69 other process i
16d70 73 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 6f 20 s allowed.** to
16d80 61 63 63 65 73 73 20 74 68 65 20 64 61 74 61 62 access the datab
16d90 61 73 65 2e 20 20 41 20 70 72 65 65 78 69 73 74 ase. A preexist
16da0 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ing transaction
16db0 6d 61 79 20 6e 6f 74 20 62 65 0a 2a 2a 20 75 70 may not be.** up
16dc0 67 72 61 64 65 64 20 74 6f 20 65 78 63 6c 75 73 graded to exclus
16dd0 69 76 65 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 ive by calling t
16de0 68 69 73 20 72 6f 75 74 69 6e 65 20 61 20 73 65 his routine a se
16df0 63 6f 6e 64 20 74 69 6d 65 20 2d 20 74 68 65 0a cond time - the.
16e00 2a 2a 20 65 78 63 6c 75 73 69 76 69 74 79 20 66 ** exclusivity f
16e10 6c 61 67 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 lag only works f
16e20 6f 72 20 61 20 6e 65 77 20 74 72 61 6e 73 61 63 or a new transac
16e30 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 77 72 tion..**.** A wr
16e40 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
16e50 6d 75 73 74 20 62 65 20 73 74 61 72 74 65 64 20 must be started
16e60 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e before attemptin
16e70 67 20 61 6e 79 20 0a 2a 2a 20 63 68 61 6e 67 65 g any .** change
16e80 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 s to the databas
16e90 65 2e 20 20 4e 6f 6e 65 20 6f 66 20 74 68 65 20 e. None of the
16ea0 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e following routin
16eb0 65 73 20 0a 2a 2a 20 77 69 6c 6c 20 77 6f 72 6b es .** will work
16ec0 20 75 6e 6c 65 73 73 20 61 20 74 72 61 6e 73 61 unless a transa
16ed0 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64 ction is started
16ee0 20 66 69 72 73 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 first:.**.**
16ef0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
16f00 72 65 61 74 65 54 61 62 6c 65 28 29 0a 2a 2a 20 reateTable().**
16f10 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
16f20 65 43 72 65 61 74 65 49 6e 64 65 78 28 29 0a 2a eCreateIndex().*
16f30 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 * sqlite3Bt
16f40 72 65 65 43 6c 65 61 72 54 61 62 6c 65 28 29 0a reeClearTable().
16f50 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
16f60 74 72 65 65 44 72 6f 70 54 61 62 6c 65 28 29 0a treeDropTable().
16f70 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
16f80 74 72 65 65 49 6e 73 65 72 74 28 29 0a 2a 2a 20 treeInsert().**
16f90 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
16fa0 65 44 65 6c 65 74 65 28 29 0a 2a 2a 20 20 20 20 eDelete().**
16fb0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 55 70 sqlite3BtreeUp
16fc0 64 61 74 65 4d 65 74 61 28 29 0a 2a 2a 0a 2a 2a dateMeta().**.**
16fd0 20 49 66 20 61 6e 20 69 6e 69 74 69 61 6c 20 61 If an initial a
16fe0 74 74 65 6d 70 74 20 74 6f 20 61 63 71 75 69 72 ttempt to acquir
16ff0 65 20 74 68 65 20 6c 6f 63 6b 20 66 61 69 6c 73 e the lock fails
17000 20 62 65 63 61 75 73 65 20 6f 66 20 6c 6f 63 6b because of lock
17010 20 63 6f 6e 74 65 6e 74 69 6f 6e 0a 2a 2a 20 61 contention.** a
17020 6e 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 nd the database
17030 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 75 was previously u
17040 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 6e 20 69 6e nlocked, then in
17050 76 6f 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 voke the busy ha
17060 6e 64 6c 65 72 0a 2a 2a 20 69 66 20 74 68 65 72 ndler.** if ther
17070 65 20 69 73 20 6f 6e 65 2e 20 20 42 75 74 20 69 e is one. But i
17080 66 20 74 68 65 72 65 20 77 61 73 20 70 72 65 76 f there was prev
17090 69 6f 75 73 6c 79 20 61 20 72 65 61 64 2d 6c 6f iously a read-lo
170a0 63 6b 2c 20 64 6f 20 6e 6f 74 0a 2a 2a 20 69 6e ck, do not.** in
170b0 76 6f 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 voke the busy ha
170c0 6e 64 6c 65 72 20 2d 20 6a 75 73 74 20 72 65 74 ndler - just ret
170d0 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e urn SQLITE_BUSY.
170e0 20 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 SQLITE_BUSY is
170f0 20 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 77 68 .** returned wh
17100 65 6e 20 74 68 65 72 65 20 69 73 20 61 6c 72 65 en there is alre
17110 61 64 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 ady a read-lock
17120 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 in order to avoi
17130 64 20 61 20 64 65 61 64 6c 6f 63 6b 2e 0a 2a 2a d a deadlock..**
17140 0a 2a 2a 20 53 75 70 70 6f 73 65 20 74 68 65 72 .** Suppose ther
17150 65 20 61 72 65 20 74 77 6f 20 70 72 6f 63 65 73 e are two proces
17160 73 65 73 20 41 20 61 6e 64 20 42 2e 20 20 41 20 ses A and B. A
17170 68 61 73 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 has a read lock
17180 61 6e 64 20 42 20 68 61 73 0a 2a 2a 20 61 20 72 and B has.** a r
17190 65 73 65 72 76 65 64 20 6c 6f 63 6b 2e 20 20 42 eserved lock. B
171a0 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 tries to promot
171b0 65 20 74 6f 20 65 78 63 6c 75 73 69 76 65 20 62 e to exclusive b
171c0 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 65 ut is blocked be
171d0 63 61 75 73 65 0a 2a 2a 20 6f 66 20 41 27 73 20 cause.** of A's
171e0 72 65 61 64 20 6c 6f 63 6b 2e 20 20 41 20 74 72 read lock. A tr
171f0 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 74 ies to promote t
17200 6f 20 72 65 73 65 72 76 65 64 20 62 75 74 20 69 o reserved but i
17210 73 20 62 6c 6f 63 6b 65 64 20 62 79 20 42 2e 0a s blocked by B..
17220 2a 2a 20 4f 6e 65 20 6f 72 20 74 68 65 20 6f 74 ** One or the ot
17230 68 65 72 20 6f 66 20 74 68 65 20 74 77 6f 20 70 her of the two p
17240 72 6f 63 65 73 73 65 73 20 6d 75 73 74 20 67 69 rocesses must gi
17250 76 65 20 77 61 79 20 6f 72 20 74 68 65 72 65 20 ve way or there
17260 63 61 6e 20 62 65 0a 2a 2a 20 6e 6f 20 70 72 6f can be.** no pro
17270 67 72 65 73 73 2e 20 20 42 79 20 72 65 74 75 72 gress. By retur
17280 6e 69 6e 67 20 53 51 4c 49 54 45 5f 42 55 53 59 ning SQLITE_BUSY
17290 20 61 6e 64 20 6e 6f 74 20 69 6e 76 6f 6b 69 6e and not invokin
172a0 67 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 g the busy callb
172b0 61 63 6b 0a 2a 2a 20 77 68 65 6e 20 41 20 61 6c ack.** when A al
172c0 72 65 61 64 79 20 68 61 73 20 61 20 72 65 61 64 ready has a read
172d0 20 6c 6f 63 6b 2c 20 77 65 20 65 6e 63 6f 75 72 lock, we encour
172e0 61 67 65 20 41 20 74 6f 20 67 69 76 65 20 75 70 age A to give up
172f0 20 61 6e 64 20 6c 65 74 20 42 0a 2a 2a 20 70 72 and let B.** pr
17300 6f 63 65 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 oceed..*/.int sq
17310 6c 69 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 lite3BtreeBeginT
17320 72 61 6e 73 28 42 74 72 65 65 20 2a 70 2c 20 69 rans(Btree *p, i
17330 6e 74 20 77 72 66 6c 61 67 29 7b 0a 20 20 73 71 nt wrflag){. sq
17340 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b 20 3d 20 lite3 *pBlock =
17350 30 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 0;. BtShared *p
17360 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 Bt = p->pBt;. i
17370 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
17380 4b 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 K;.. sqlite3Btr
17390 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 62 74 eeEnter(p);. bt
173a0 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b reeIntegrity(p);
173b0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 62 74 .. /* If the bt
173c0 72 65 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 ree is already i
173d0 6e 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 n a write-transa
173e0 63 74 69 6f 6e 2c 20 6f 72 20 69 74 0a 20 20 2a ction, or it. *
173f0 2a 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 * is already in
17400 61 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 a read-transacti
17410 6f 6e 20 61 6e 64 20 61 20 72 65 61 64 2d 74 72 on and a read-tr
17420 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 ansaction. ** i
17430 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 68 69 s requested, thi
17440 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 20 20 s is a no-op..
17450 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 */. if( p->inTr
17460 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
17470 20 7c 7c 20 28 70 2d 3e 69 6e 54 72 61 6e 73 3d || (p->inTrans=
17480 3d 54 52 41 4e 53 5f 52 45 41 44 20 26 26 20 21 =TRANS_READ && !
17490 77 72 66 6c 61 67 29 20 29 7b 0a 20 20 20 20 67 wrflag) ){. g
174a0 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b oto trans_begun;
174b0 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
174c0 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
174d0 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 7c n==TRANS_WRITE |
174e0 7c 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 42 | IfNotOmitAV(pB
174f0 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 29 3d t->bDoTruncate)=
17500 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 =0 );.. /* Writ
17510 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 e transactions a
17520 72 65 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 re not possible
17530 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 on a read-only d
17540 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 66 28 atabase */. if(
17550 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
17560 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 & BTS_READ_ONLY)
17570 21 3d 30 20 26 26 20 77 72 66 6c 61 67 20 29 7b !=0 && wrflag ){
17580 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
17590 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 67 _READONLY;. g
175a0 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b oto trans_begun;
175b0 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 . }..#ifndef SQ
175c0 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
175d0 5f 43 41 43 48 45 0a 20 20 2f 2a 20 49 66 20 61 _CACHE. /* If a
175e0 6e 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 nother database
175f0 68 61 6e 64 6c 65 20 68 61 73 20 61 6c 72 65 61 handle has alrea
17600 64 79 20 6f 70 65 6e 65 64 20 61 20 77 72 69 74 dy opened a writ
17610 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 0a 20 e transaction .
17620 20 2a 2a 20 6f 6e 20 74 68 69 73 20 73 68 61 72 ** on this shar
17630 65 64 2d 62 74 72 65 65 20 73 74 72 75 63 74 75 ed-btree structu
17640 72 65 20 61 6e 64 20 61 20 73 65 63 6f 6e 64 20 re and a second
17650 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
17660 6e 20 69 73 0a 20 20 2a 2a 20 72 65 71 75 65 73 n is. ** reques
17670 74 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 ted, return SQLI
17680 54 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 2a 2f 0a TE_LOCKED.. */.
17690 20 20 69 66 28 20 28 77 72 66 6c 61 67 20 26 26 if( (wrflag &&
176a0 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
176b0 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ion==TRANS_WRITE
176c0 29 0a 20 20 20 7c 7c 20 28 70 42 74 2d 3e 62 74 ). || (pBt->bt
176d0 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e sFlags & BTS_PEN
176e0 44 49 4e 47 29 21 3d 30 0a 20 20 29 7b 0a 20 20 DING)!=0. ){.
176f0 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 74 2d 3e pBlock = pBt->
17700 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a 20 20 7d pWriter->db;. }
17710 65 6c 73 65 20 69 66 28 20 77 72 66 6c 61 67 3e else if( wrflag>
17720 31 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 1 ){. BtLock
17730 2a 70 49 74 65 72 3b 0a 20 20 20 20 66 6f 72 28 *pIter;. for(
17740 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b pIter=pBt->pLock
17750 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 ; pIter; pIter=p
17760 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 Iter->pNext){.
17770 20 20 20 20 69 66 28 20 70 49 74 65 72 2d 3e 70 if( pIter->p
17780 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 20 20 20 Btree!=p ){.
17790 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 49 74 pBlock = pIt
177a0 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 3b 0a er->pBtree->db;.
177b0 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
177c0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
177d0 0a 20 20 69 66 28 20 70 42 6c 6f 63 6b 20 29 7b . if( pBlock ){
177e0 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e . sqlite3Conn
177f0 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d ectionBlocked(p-
17800 3e 64 62 2c 20 70 42 6c 6f 63 6b 29 3b 0a 20 20 >db, pBlock);.
17810 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4c 4f rc = SQLITE_LO
17820 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 CKED_SHAREDCACHE
17830 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 ;. goto trans
17840 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 23 65 6e 64 _begun;. }.#end
17850 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 72 65 61 if.. /* Any rea
17860 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 64 2d 77 d-only or read-w
17870 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
17880 20 69 6d 70 6c 69 65 73 20 61 20 72 65 61 64 2d implies a read-
17890 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a 20 70 61 lock on . ** pa
178a0 67 65 20 31 2e 20 53 6f 20 69 66 20 73 6f 6d 65 ge 1. So if some
178b0 20 6f 74 68 65 72 20 73 68 61 72 65 64 2d 63 61 other shared-ca
178c0 63 68 65 20 63 6c 69 65 6e 74 20 61 6c 72 65 61 che client alrea
178d0 64 79 20 68 61 73 20 61 20 77 72 69 74 65 2d 6c dy has a write-l
178e0 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 70 61 67 ock . ** on pag
178f0 65 20 31 2c 20 74 68 65 20 74 72 61 6e 73 61 63 e 1, the transac
17900 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 65 20 6f tion cannot be o
17910 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 63 20 3d pened. */. rc =
17920 20 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 querySharedCach
17930 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 4d 41 eTableLock(p, MA
17940 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 41 44 5f STER_ROOT, READ_
17950 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 53 51 4c LOCK);. if( SQL
17960 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 67 6f 74 ITE_OK!=rc ) got
17970 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 0a o trans_begun;..
17980 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
17990 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 41 4c 4c &= ~BTS_INITIALL
179a0 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 28 20 70 Y_EMPTY;. if( p
179b0 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 29 20 70 Bt->nPage==0 ) p
179c0 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 Bt->btsFlags |=
179d0 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d BTS_INITIALLY_EM
179e0 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 20 20 20 PTY;. do {.
179f0 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 74 72 65 /* Call lockBtre
17a00 65 28 29 20 75 6e 74 69 6c 20 65 69 74 68 65 72 e() until either
17a10 20 70 42 74 2d 3e 70 50 61 67 65 31 20 69 73 20 pBt->pPage1 is
17a20 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a 20 20 20 populated or.
17a30 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 ** lockBtree()
17a40 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 69 6e returns somethin
17a50 67 20 6f 74 68 65 72 20 74 68 61 6e 20 53 51 4c g other than SQL
17a60 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 74 72 65 ITE_OK. lockBtre
17a70 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 79 20 72 e(). ** may r
17a80 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
17a90 62 75 74 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 but leave pBt->p
17aa0 50 61 67 65 31 20 73 65 74 20 74 6f 20 30 20 69 Page1 set to 0 i
17ab0 66 20 61 66 74 65 72 0a 20 20 20 20 2a 2a 20 72 f after. ** r
17ac0 65 61 64 69 6e 67 20 70 61 67 65 20 31 20 69 74 eading page 1 it
17ad0 20 64 69 73 63 6f 76 65 72 73 20 74 68 61 74 20 discovers that
17ae0 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 the page-size of
17af0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 20 the database .
17b00 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 20 6e 6f ** file is no
17b10 74 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2e t pBt->pageSize.
17b20 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 6c 6f In this case lo
17b30 63 6b 42 74 72 65 65 28 29 20 77 69 6c 6c 20 75 ckBtree() will u
17b40 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 70 42 74 pdate. ** pBt
17b50 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f 20 74 68 ->pageSize to th
17b60 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 20 74 e page-size of t
17b70 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2e he file on disk.
17b80 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 68 69 6c . */. whil
17b90 65 28 20 70 42 74 2d 3e 70 50 61 67 65 31 3d 3d e( pBt->pPage1==
17ba0 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 0 && SQLITE_OK==
17bb0 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 65 65 28 (rc = lockBtree(
17bc0 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 20 69 66 pBt)) );.. if
17bd0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
17be0 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 && wrflag ){.
17bf0 20 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 if( (pBt->bts
17c00 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 44 Flags & BTS_READ
17c10 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a 20 20 20 _ONLY)!=0 ){.
17c20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
17c30 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 _READONLY;.
17c40 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
17c50 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
17c60 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 50 61 67 rBegin(pBt->pPag
17c70 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 71 6c 69 er,wrflag>1,sqli
17c80 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 te3TempInMemory(
17c90 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20 20 20 p->db));.
17ca0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
17cb0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
17cc0 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 rc = newDatabase
17cd0 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20 7d (pBt);. }
17ce0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
17cf0 20 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 . if( rc!=SQ
17d00 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
17d10 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e unlockBtreeIfUn
17d20 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 20 7d used(pBt);. }
17d30 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 63 26 30 . }while( (rc&0
17d40 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f 42 55 53 xFF)==SQLITE_BUS
17d50 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e Y && pBt->inTran
17d60 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e saction==TRANS_N
17d70 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 20 20 20 ONE &&.
17d80 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
17d90 48 61 6e 64 6c 65 72 28 70 42 74 29 20 29 3b 0a Handler(pBt) );.
17da0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
17db0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
17dc0 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
17dd0 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 S_NONE ){.
17de0 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f pBt->nTransactio
17df0 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c n++;.#ifndef SQL
17e00 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
17e10 43 41 43 48 45 0a 20 20 20 20 20 20 69 66 28 20 CACHE. if(
17e20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 p->sharable ){.
17e30 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 assert( p
17e40 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 3d 3d 70 ->lock.pBtree==p
17e50 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 62 && p->lock.iTab
17e60 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 20 20 20 20 le==1 );.
17e70 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 6b 20 3d p->lock.eLock =
17e80 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 READ_LOCK;.
17e90 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 4e 65 78 p->lock.pNex
17ea0 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a t = pBt->pLock;.
17eb0 20 20 20 20 20 20 20 20 70 42 74 2d 3e 70 4c 6f pBt->pLo
17ec0 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b 3b 0a 20 ck = &p->lock;.
17ed0 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
17ee0 20 20 7d 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 }. p->inTra
17ef0 6e 73 20 3d 20 28 77 72 66 6c 61 67 3f 54 52 41 ns = (wrflag?TRA
17f00 4e 53 5f 57 52 49 54 45 3a 54 52 41 4e 53 5f 52 NS_WRITE:TRANS_R
17f10 45 41 44 29 3b 0a 20 20 20 20 69 66 28 20 70 2d EAD);. if( p-
17f20 3e 69 6e 54 72 61 6e 73 3e 70 42 74 2d 3e 69 6e >inTrans>pBt->in
17f30 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 Transaction ){.
17f40 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e pBt->inTran
17f50 73 61 63 74 69 6f 6e 20 3d 20 70 2d 3e 69 6e 54 saction = p->inT
17f60 72 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 20 20 20 rans;. }.
17f70 69 66 28 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 if( wrflag ){.
17f80 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 MemPage *pPa
17f90 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 ge1 = pBt->pPage
17fa0 31 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 1;.#ifndef SQLIT
17fb0 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
17fc0 43 48 45 0a 20 20 20 20 20 20 61 73 73 65 72 74 CHE. assert
17fd0 28 20 21 70 42 74 2d 3e 70 57 72 69 74 65 72 20 ( !pBt->pWriter
17fe0 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 57 );. pBt->pW
17ff0 72 69 74 65 72 20 3d 20 70 3b 0a 20 20 20 20 20 riter = p;.
18000 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
18010 3d 20 7e 42 54 53 5f 45 58 43 4c 55 53 49 56 45 = ~BTS_EXCLUSIVE
18020 3b 0a 20 20 20 20 20 20 69 66 28 20 77 72 66 6c ;. if( wrfl
18030 61 67 3e 31 20 29 20 70 42 74 2d 3e 62 74 73 46 ag>1 ) pBt->btsF
18040 6c 61 67 73 20 7c 3d 20 42 54 53 5f 45 58 43 4c lags |= BTS_EXCL
18050 55 53 49 56 45 3b 0a 23 65 6e 64 69 66 0a 0a 20 USIVE;.#endif..
18060 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 64 /* If the d
18070 62 2d 73 69 7a 65 20 68 65 61 64 65 72 20 66 69 b-size header fi
18080 65 6c 64 20 69 73 20 69 6e 63 6f 72 72 65 63 74 eld is incorrect
18090 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 69 (as it may be i
180a0 66 20 61 6e 20 6f 6c 64 0a 20 20 20 20 20 20 2a f an old. *
180b0 2a 20 63 6c 69 65 6e 74 20 68 61 73 20 62 65 65 * client has bee
180c0 6e 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 n writing the da
180d0 74 61 62 61 73 65 20 66 69 6c 65 29 2c 20 75 70 tabase file), up
180e0 64 61 74 65 20 69 74 20 6e 6f 77 2e 20 44 6f 69 date it now. Doi
180f0 6e 67 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 73 ng. ** this
18100 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74 sooner rather t
18110 68 61 6e 20 6c 61 74 65 72 20 6d 65 61 6e 73 20 han later means
18120 74 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a the database siz
18130 65 20 63 61 6e 20 73 61 66 65 6c 79 20 0a 20 20 e can safely .
18140 20 20 20 20 2a 2a 20 72 65 2d 72 65 61 64 20 74 ** re-read t
18150 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
18160 20 66 72 6f 6d 20 70 61 67 65 20 31 20 69 66 20 from page 1 if
18170 61 20 73 61 76 65 70 6f 69 6e 74 20 6f 72 20 74 a savepoint or t
18180 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 ransaction.
18190 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 ** rollback occ
181a0 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 74 urs within the t
181b0 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 ransaction..
181c0 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 */. if( p
181d0 42 74 2d 3e 6e 50 61 67 65 21 3d 67 65 74 34 62 Bt->nPage!=get4b
181e0 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
181f0 74 61 5b 32 38 5d 29 20 29 7b 0a 20 20 20 20 20 ta[28]) ){.
18200 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
18210 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 agerWrite(pPage1
18220 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
18230 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
18240 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
18250 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
18260 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 ge1->aData[28],
18270 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 pBt->nPage);.
18280 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
18290 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 61 6e 73 }. }...trans
182a0 5f 62 65 67 75 6e 3a 0a 20 20 69 66 28 20 72 63 _begun:. if( rc
182b0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 77 ==SQLITE_OK && w
182c0 72 66 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 rflag ){. /*
182d0 54 68 69 73 20 63 61 6c 6c 20 6d 61 6b 65 73 20 This call makes
182e0 73 75 72 65 20 74 68 61 74 20 74 68 65 20 70 61 sure that the pa
182f0 67 65 72 20 68 61 73 20 74 68 65 20 63 6f 72 72 ger has the corr
18300 65 63 74 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 ect number of.
18310 20 20 2a 2a 20 6f 70 65 6e 20 73 61 76 65 70 6f ** open savepo
18320 69 6e 74 73 2e 20 49 66 20 74 68 65 20 73 65 63 ints. If the sec
18330 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 ond parameter is
18340 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 30 20 greater than 0
18350 61 6e 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 and. ** the s
18360 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 6e 6f ub-journal is no
18370 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 t already open,
18380 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 65 20 then it will be
18390 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a 20 20 20 opened here..
183a0 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c */. rc = sql
183b0 69 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 ite3PagerOpenSav
183c0 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 epoint(pBt->pPag
183d0 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 61 76 65 er, p->db->nSave
183e0 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 point);. }.. b
183f0 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 treeIntegrity(p)
18400 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
18410 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
18420 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 rn rc;.}..#ifnde
18430 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
18440 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a 2a 2a 20 TOVACUUM../*.**
18450 53 65 74 20 74 68 65 20 70 6f 69 6e 74 65 72 2d Set the pointer-
18460 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 map entries for
18470 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66 20 all children of
18480 70 61 67 65 20 70 50 61 67 65 2e 20 41 6c 73 6f page pPage. Also
18490 2c 20 69 66 0a 2a 2a 20 70 50 61 67 65 20 63 6f , if.** pPage co
184a0 6e 74 61 69 6e 73 20 63 65 6c 6c 73 20 74 68 61 ntains cells tha
184b0 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 65 72 66 t point to overf
184c0 6c 6f 77 20 70 61 67 65 73 2c 20 73 65 74 20 74 low pages, set t
184d0 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 6d 61 he pointer.** ma
184e0 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 74 68 p entries for th
184f0 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 e overflow pages
18500 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 as well..*/.sta
18510 74 69 63 20 69 6e 74 20 73 65 74 43 68 69 6c 64 tic int setChild
18520 50 74 72 6d 61 70 73 28 4d 65 6d 50 61 67 65 20 Ptrmaps(MemPage
18530 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 69 *pPage){. int i
18540 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
18550 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
18560 20 43 6f 75 6e 74 65 72 20 76 61 72 69 61 62 6c Counter variabl
18570 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c e */. int nCell
18580 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
18590 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
185a0 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 6e 20 ber of cells in
185b0 70 61 67 65 20 70 50 61 67 65 20 2a 2f 0a 20 20 page pPage */.
185c0 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
185d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
185e0 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
185f0 65 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 e */. BtShared
18600 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 *pBt = pPage->pB
18610 74 3b 0a 20 20 75 38 20 69 73 49 6e 69 74 4f 72 t;. u8 isInitOr
18620 69 67 20 3d 20 70 50 61 67 65 2d 3e 69 73 49 6e ig = pPage->isIn
18630 69 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 20 it;. Pgno pgno
18640 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 0a = pPage->pgno;..
18650 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
18660 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
18670 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
18680 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 49 );. rc = btreeI
18690 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a nitPage(pPage);.
186a0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
186b0 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 _OK ){. goto
186c0 73 65 74 5f 63 68 69 6c 64 5f 70 74 72 6d 61 70 set_child_ptrmap
186d0 73 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 6e 43 65 s_out;. }. nCe
186e0 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c ll = pPage->nCel
186f0 6c 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 l;.. for(i=0; i
18700 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 <nCell; i++){.
18710 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 u8 *pCell = fi
18720 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 ndCell(pPage, i)
18730 3b 0a 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 ;.. ptrmapPut
18740 4f 76 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 OvflPtr(pPage, p
18750 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a 20 20 20 Cell, &rc);..
18760 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
18770 66 20 29 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 f ){. Pgno
18780 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 34 childPgno = get4
18790 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a 20 20 20 byte(pCell);.
187a0 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 ptrmapPut(pBt
187b0 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 , childPgno, PTR
187c0 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c MAP_BTREE, pgno,
187d0 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d &rc);. }. }
187e0 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e .. if( !pPage->
187f0 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 6e 6f leaf ){. Pgno
18800 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 childPgno = get
18810 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 4byte(&pPage->aD
18820 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 ata[pPage->hdrOf
18830 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 74 fset+8]);. pt
18840 72 6d 61 70 50 75 74 28 70 42 74 2c 20 63 68 69 rmapPut(pBt, chi
18850 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 ldPgno, PTRMAP_B
18860 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 TREE, pgno, &rc)
18870 3b 0a 20 20 7d 0a 0a 73 65 74 5f 63 68 69 6c 64 ;. }..set_child
18880 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3a 0a 20 20 _ptrmaps_out:.
18890 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 pPage->isInit =
188a0 69 73 49 6e 69 74 4f 72 69 67 3b 0a 20 20 72 65 isInitOrig;. re
188b0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
188c0 2a 20 53 6f 6d 65 77 68 65 72 65 20 6f 6e 20 70 * Somewhere on p
188d0 50 61 67 65 20 69 73 20 61 20 70 6f 69 6e 74 65 Page is a pointe
188e0 72 20 74 6f 20 70 61 67 65 20 69 46 72 6f 6d 2e r to page iFrom.
188f0 20 20 4d 6f 64 69 66 79 20 74 68 69 73 20 70 6f Modify this po
18900 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 74 68 61 74 inter so.** that
18910 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 69 54 it points to iT
18920 6f 2e 20 50 61 72 61 6d 65 74 65 72 20 65 54 79 o. Parameter eTy
18930 70 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 pe describes the
18940 20 74 79 70 65 20 6f 66 20 70 6f 69 6e 74 65 72 type of pointer
18950 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f 64 69 66 69 to.** be modifi
18960 65 64 2c 20 61 73 20 20 66 6f 6c 6c 6f 77 73 3a ed, as follows:
18970 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 42 54 .**.** PTRMAP_BT
18980 52 45 45 3a 20 20 20 20 20 70 50 61 67 65 20 69 REE: pPage i
18990 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 2e 20 s a btree-page.
189a0 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e The pointer poin
189b0 74 73 20 61 74 20 61 20 63 68 69 6c 64 20 0a 2a ts at a child .*
189c0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
189d0 20 20 20 20 70 61 67 65 20 6f 66 20 70 50 61 67 page of pPag
189e0 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f e..**.** PTRMAP_
189f0 4f 56 45 52 46 4c 4f 57 31 3a 20 70 50 61 67 65 OVERFLOW1: pPage
18a00 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 is a btree-page
18a10 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f . The pointer po
18a20 69 6e 74 73 20 61 74 20 61 6e 20 6f 76 65 72 66 ints at an overf
18a30 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 low.**
18a40 20 20 20 20 20 20 20 20 20 70 61 67 65 20 70 6f page po
18a50 69 6e 74 65 64 20 74 6f 20 62 79 20 6f 6e 65 20 inted to by one
18a60 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 6f 6e 20 of the cells on
18a70 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 pPage..**.** PTR
18a80 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 3a 20 70 MAP_OVERFLOW2: p
18a90 50 61 67 65 20 69 73 20 61 6e 20 6f 76 65 72 66 Page is an overf
18aa0 6c 6f 77 2d 70 61 67 65 2e 20 54 68 65 20 70 6f low-page. The po
18ab0 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 74 20 inter points at
18ac0 74 68 65 20 6e 65 78 74 0a 2a 2a 20 20 20 20 20 the next.**
18ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 76 ov
18ae0 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 erflow page in t
18af0 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 he list..*/.stat
18b00 69 63 20 69 6e 74 20 6d 6f 64 69 66 79 50 61 67 ic int modifyPag
18b10 65 50 6f 69 6e 74 65 72 28 4d 65 6d 50 61 67 65 ePointer(MemPage
18b20 20 2a 70 50 61 67 65 2c 20 50 67 6e 6f 20 69 46 *pPage, Pgno iF
18b30 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 6f 2c 20 75 rom, Pgno iTo, u
18b40 38 20 65 54 79 70 65 29 7b 0a 20 20 61 73 73 65 8 eType){. asse
18b50 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
18b60 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
18b70 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
18b80 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
18b90 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
18ba0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
18bb0 3b 0a 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 ;. if( eType==P
18bc0 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 TRMAP_OVERFLOW2
18bd0 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 6f ){. /* The po
18be0 69 6e 74 65 72 20 69 73 20 61 6c 77 61 79 73 20 inter is always
18bf0 74 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 the first 4 byte
18c00 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 6e s of the page in
18c10 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a this case. */.
18c20 20 20 20 20 69 66 28 20 67 65 74 34 62 79 74 65 if( get4byte
18c30 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 21 3d (pPage->aData)!=
18c40 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 72 iFrom ){. r
18c50 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
18c60 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
18c70 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 70 50 . put4byte(pP
18c80 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 54 6f 29 age->aData, iTo)
18c90 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 75 ;. }else{. u
18ca0 38 20 69 73 49 6e 69 74 4f 72 69 67 20 3d 20 70 8 isInitOrig = p
18cb0 50 61 67 65 2d 3e 69 73 49 6e 69 74 3b 0a 20 20 Page->isInit;.
18cc0 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 int i;. int
18cd0 20 6e 43 65 6c 6c 3b 0a 0a 20 20 20 20 62 74 72 nCell;.. btr
18ce0 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 eeInitPage(pPage
18cf0 29 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 3d 20 70 );. nCell = p
18d00 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 Page->nCell;..
18d10 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 for(i=0; i<nCe
18d20 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ll; i++){.
18d30 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 6e 64 u8 *pCell = find
18d40 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 3b 0a Cell(pPage, i);.
18d50 20 20 20 20 20 20 69 66 28 20 65 54 79 70 65 3d if( eType=
18d60 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 =PTRMAP_OVERFLOW
18d70 31 20 29 7b 0a 20 20 20 20 20 20 20 20 43 65 6c 1 ){. Cel
18d80 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 lInfo info;.
18d90 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
18da0 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 llPtr(pPage, pCe
18db0 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 ll, &info);.
18dc0 20 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 if( info.iOv
18dd0 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 20 erflow.
18de0 26 26 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e 69 4f && pCell+info.iO
18df0 76 65 72 66 6c 6f 77 2b 33 3c 3d 70 50 61 67 65 verflow+3<=pPage
18e00 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d 3e 6d ->aData+pPage->m
18e10 61 73 6b 50 61 67 65 0a 20 20 20 20 20 20 20 20 askPage.
18e20 20 26 26 20 69 46 72 6f 6d 3d 3d 67 65 74 34 62 && iFrom==get4b
18e30 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e yte(&pCell[info.
18e40 69 4f 76 65 72 66 6c 6f 77 5d 29 0a 20 20 20 20 iOverflow]).
18e50 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ){.
18e60 20 70 75 74 34 62 79 74 65 28 26 70 43 65 6c 6c put4byte(&pCell
18e70 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d [info.iOverflow]
18e80 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 , iTo);.
18e90 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
18ea0 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
18eb0 20 20 20 20 20 20 20 20 69 66 28 20 67 65 74 34 if( get4
18ec0 62 79 74 65 28 70 43 65 6c 6c 29 3d 3d 69 46 72 byte(pCell)==iFr
18ed0 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 om ){.
18ee0 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c 2c 20 put4byte(pCell,
18ef0 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 iTo);.
18f00 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d break;. }
18f10 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
18f20 20 0a 20 20 20 20 69 66 28 20 69 3d 3d 6e 43 65 . if( i==nCe
18f30 6c 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ll ){. if(
18f40 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f 42 54 eType!=PTRMAP_BT
18f50 52 45 45 20 7c 7c 20 0a 20 20 20 20 20 20 20 20 REE || .
18f60 20 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 get4byte(&pPag
18f70 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e e->aData[pPage->
18f80 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 21 3d 69 hdrOffset+8])!=i
18f90 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 From ){.
18fa0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
18fb0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
18fc0 20 20 7d 0a 20 20 20 20 20 20 70 75 74 34 62 79 }. put4by
18fd0 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
18fe0 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
18ff0 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 t+8], iTo);.
19000 7d 0a 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 }.. pPage->is
19010 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 4f 72 69 Init = isInitOri
19020 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 g;. }. return
19030 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
19040 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 6f 70 *.** Move the op
19050 65 6e 20 64 61 74 61 62 61 73 65 20 70 61 67 65 en database page
19060 20 70 44 62 50 61 67 65 20 74 6f 20 6c 6f 63 61 pDbPage to loca
19070 74 69 6f 6e 20 69 46 72 65 65 50 61 67 65 20 69 tion iFreePage i
19080 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 n the .** databa
19090 73 65 2e 20 54 68 65 20 70 44 62 50 61 67 65 20 se. The pDbPage
190a0 72 65 66 65 72 65 6e 63 65 20 72 65 6d 61 69 6e reference remain
190b0 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a 20 54 s valid..**.** T
190c0 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 he isCommit flag
190d0 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 indicates that
190e0 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 there is no need
190f0 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 74 68 61 to remember tha
19100 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c t.** the journal
19110 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 79 6e needs to be syn
19120 63 28 29 65 64 20 62 65 66 6f 72 65 20 64 61 74 c()ed before dat
19130 61 62 61 73 65 20 70 61 67 65 20 70 44 62 50 61 abase page pDbPa
19140 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 63 61 6e ge->pgno .** can
19150 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f 2e 20 be written to.
19160 54 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 61 The caller has a
19170 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 65 64 20 lready promised
19180 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 74 6f 20 not to write to
19190 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2f that.** page..*/
191a0 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 6c 6f .static int relo
191b0 63 61 74 65 50 61 67 65 28 0a 20 20 42 74 53 68 catePage(. BtSh
191c0 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
191d0 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 2a 2f /* Btree */
191e0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 44 62 50 . MemPage *pDbP
191f0 61 67 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f age, /* O
19200 70 65 6e 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 pen page to move
19210 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 65 2c 20 */. u8 eType,
19220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
19230 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 27 74 * Pointer map 't
19240 79 70 65 27 20 65 6e 74 72 79 20 66 6f 72 20 70 ype' entry for p
19250 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f DbPage */. Pgno
19260 20 69 50 74 72 50 61 67 65 2c 20 20 20 20 20 20 iPtrPage,
19270 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
19280 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 20 65 6e map 'page-no' en
19290 74 72 79 20 66 6f 72 20 70 44 62 50 61 67 65 20 try for pDbPage
192a0 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 65 65 50 */. Pgno iFreeP
192b0 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a age, /*
192c0 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e 20 74 6f The location to
192d0 20 6d 6f 76 65 20 70 44 62 50 61 67 65 20 74 6f move pDbPage to
192e0 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f 6d 6d */. int isComm
192f0 69 74 20 20 20 20 20 20 20 20 20 20 20 20 20 2f it /
19300 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 20 * isCommit flag
19310 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 passed to sqlite
19320 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 20 2a 3PagerMovepage *
19330 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a /.){. MemPage *
19340 70 50 74 72 50 61 67 65 3b 20 20 20 2f 2a 20 54 pPtrPage; /* T
19350 68 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e he page that con
19360 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 tains a pointer
19370 74 6f 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 to pDbPage */.
19380 50 67 6e 6f 20 69 44 62 50 61 67 65 20 3d 20 70 Pgno iDbPage = p
19390 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 20 20 DbPage->pgno;.
193a0 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 Pager *pPager =
193b0 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69 pBt->pPager;. i
193c0 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
193d0 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
193e0 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 65 54 79 OVERFLOW2 || eTy
193f0 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 pe==PTRMAP_OVERF
19400 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 20 20 65 LOW1 || . e
19410 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 Type==PTRMAP_BTR
19420 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 EE || eType==PTR
19430 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 3b 0a MAP_ROOTPAGE );.
19440 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
19450 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
19460 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
19470 73 65 72 74 28 20 70 44 62 50 61 67 65 2d 3e 70 sert( pDbPage->p
19480 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 20 2f 2a Bt==pBt );.. /*
19490 20 4d 6f 76 65 20 70 61 67 65 20 69 44 62 50 61 Move page iDbPa
194a0 67 65 20 66 72 6f 6d 20 69 74 73 20 63 75 72 72 ge from its curr
194b0 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 ent location to
194c0 70 61 67 65 20 6e 75 6d 62 65 72 20 69 46 72 65 page number iFre
194d0 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 41 43 45 ePage */. TRACE
194e0 28 28 22 41 55 54 4f 56 41 43 55 55 4d 3a 20 4d (("AUTOVACUUM: M
194f0 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 72 65 65 oving %d to free
19500 20 70 61 67 65 20 25 64 20 28 70 74 72 20 70 61 page %d (ptr pa
19510 67 65 20 25 64 20 74 79 70 65 20 25 64 29 5c 6e ge %d type %d)\n
19520 22 2c 20 0a 20 20 20 20 20 20 69 44 62 50 61 67 ", . iDbPag
19530 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 69 50 e, iFreePage, iP
19540 74 72 50 61 67 65 2c 20 65 54 79 70 65 29 29 3b trPage, eType));
19550 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
19560 61 67 65 72 4d 6f 76 65 70 61 67 65 28 70 50 61 agerMovepage(pPa
19570 67 65 72 2c 20 70 44 62 50 61 67 65 2d 3e 70 44 ger, pDbPage->pD
19580 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 bPage, iFreePage
19590 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a 20 20 69 , isCommit);. i
195a0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
195b0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 ){. return r
195c0 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 61 67 65 c;. }. pDbPage
195d0 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 65 50 61 ->pgno = iFreePa
195e0 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 44 62 ge;.. /* If pDb
195f0 50 61 67 65 20 77 61 73 20 61 20 62 74 72 65 65 Page was a btree
19600 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 6d -page, then it m
19610 61 79 20 68 61 76 65 20 63 68 69 6c 64 20 70 61 ay have child pa
19620 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 6c 6c 73 ges and/or cells
19630 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f 69 6e 74 . ** that point
19640 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 to overflow pag
19650 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 es. The pointer
19660 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 map entries for
19670 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a 2a 20 70 all these. ** p
19680 61 67 65 73 20 6e 65 65 64 20 74 6f 20 62 65 20 ages need to be
19690 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a 0a 20 20 changed.. **.
196a0 2a 2a 20 49 66 20 70 44 62 50 61 67 65 20 69 73 ** If pDbPage is
196b0 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
196c0 65 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 e, then the firs
196d0 74 20 34 20 62 79 74 65 73 20 6d 61 79 20 73 74 t 4 bytes may st
196e0 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f 69 6e 74 ore a. ** point
196f0 65 72 20 74 6f 20 61 20 73 75 62 73 65 71 75 65 er to a subseque
19700 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 nt overflow page
19710 2e 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 . If this is the
19720 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 20 2a 2a case, then. **
19730 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
19740 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 70 64 needs to be upd
19750 61 74 65 64 20 66 6f 72 20 74 68 65 20 73 75 62 ated for the sub
19760 73 65 71 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 sequent overflow
19770 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 page.. */. if
19780 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
19790 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d BTREE || eType==
197a0 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 PTRMAP_ROOTPAGE
197b0 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 65 74 43 ){. rc = setC
197c0 68 69 6c 64 50 74 72 6d 61 70 73 28 70 44 62 50 hildPtrmaps(pDbP
197d0 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
197e0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
197f0 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
19800 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
19810 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f 76 66 6c Pgno nextOvfl
19820 20 3d 20 67 65 74 34 62 79 74 65 28 70 44 62 50 = get4byte(pDbP
19830 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 age->aData);.
19840 20 69 66 28 20 6e 65 78 74 4f 76 66 6c 21 3d 30 if( nextOvfl!=0
19850 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 ){. ptrmap
19860 50 75 74 28 70 42 74 2c 20 6e 65 78 74 4f 76 66 Put(pBt, nextOvf
19870 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c l, PTRMAP_OVERFL
19880 4f 57 32 2c 20 69 46 72 65 65 50 61 67 65 2c 20 OW2, iFreePage,
19890 26 72 63 29 3b 0a 20 20 20 20 20 20 69 66 28 20 &rc);. if(
198a0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
198b0 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
198c0 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rc;. }.
198d0 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 78 20 }. }.. /* Fix
198e0 74 68 65 20 64 61 74 61 62 61 73 65 20 70 6f 69 the database poi
198f0 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 69 50 74 nter on page iPt
19900 72 50 61 67 65 20 74 68 61 74 20 70 6f 69 6e 74 rPage that point
19910 65 64 20 61 74 20 69 44 62 50 61 67 65 20 73 6f ed at iDbPage so
19920 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 20 70 6f . ** that it po
19930 69 6e 74 73 20 61 74 20 69 46 72 65 65 50 61 67 ints at iFreePag
19940 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 68 65 20 e. Also fix the
19950 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 pointer map entr
19960 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 74 72 50 y for. ** iPtrP
19970 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 age.. */. if(
19980 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f 52 4f eType!=PTRMAP_RO
19990 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 72 63 OTPAGE ){. rc
199a0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
199b0 70 42 74 2c 20 69 50 74 72 50 61 67 65 2c 20 26 pBt, iPtrPage, &
199c0 70 50 74 72 50 61 67 65 2c 20 30 29 3b 0a 20 20 pPtrPage, 0);.
199d0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
199e0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 _OK ){. ret
199f0 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
19a00 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
19a10 67 65 72 57 72 69 74 65 28 70 50 74 72 50 61 67 gerWrite(pPtrPag
19a20 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
19a30 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
19a40 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 OK ){. rele
19a50 61 73 65 50 61 67 65 28 70 50 74 72 50 61 67 65 asePage(pPtrPage
19a60 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
19a70 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 rc;. }. rc
19a80 20 3d 20 6d 6f 64 69 66 79 50 61 67 65 50 6f 69 = modifyPagePoi
19a90 6e 74 65 72 28 70 50 74 72 50 61 67 65 2c 20 69 nter(pPtrPage, i
19aa0 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 DbPage, iFreePag
19ab0 65 2c 20 65 54 79 70 65 29 3b 0a 20 20 20 20 72 e, eType);. r
19ac0 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 50 eleasePage(pPtrP
19ad0 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
19ae0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
19af0 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 ptrmapPut(p
19b00 42 74 2c 20 69 46 72 65 65 50 61 67 65 2c 20 65 Bt, iFreePage, e
19b10 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 2c 20 Type, iPtrPage,
19b20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a &rc);. }. }.
19b30 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
19b40 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 /* Forward decla
19b50 72 61 74 69 6f 6e 20 72 65 71 75 69 72 65 64 20 ration required
19b60 62 79 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 by incrVacuumSte
19b70 70 28 29 2e 20 2a 2f 0a 73 74 61 74 69 63 20 69 p(). */.static i
19b80 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 nt allocateBtree
19b90 50 61 67 65 28 42 74 53 68 61 72 65 64 20 2a 2c Page(BtShared *,
19ba0 20 4d 65 6d 50 61 67 65 20 2a 2a 2c 20 50 67 6e MemPage **, Pgn
19bb0 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 38 29 3b 0a o *, Pgno, u8);.
19bc0 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 72 6d 20 61 ./*.** Perform a
19bd0 20 73 69 6e 67 6c 65 20 73 74 65 70 20 6f 66 20 single step of
19be0 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 an incremental-v
19bf0 61 63 75 75 6d 2e 20 49 66 20 73 75 63 63 65 73 acuum. If succes
19c00 73 66 75 6c 2c 20 72 65 74 75 72 6e 0a 2a 2a 20 sful, return.**
19c10 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 20 74 68 SQLITE_OK. If th
19c20 65 72 65 20 69 73 20 6e 6f 20 77 6f 72 6b 20 74 ere is no work t
19c30 6f 20 64 6f 20 28 61 6e 64 20 74 68 65 72 65 66 o do (and theref
19c40 6f 72 65 20 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 ore no point in
19c50 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 .** calling this
19c60 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 29 function again)
19c70 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f , return SQLITE_
19c80 44 4f 4e 45 2e 20 4f 72 2c 20 69 66 20 61 6e 20 DONE. Or, if an
19c90 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 63 75 72 73 error .** occurs
19ca0 2c 20 72 65 74 75 72 6e 20 73 6f 6d 65 20 6f 74 , return some ot
19cb0 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a her error code..
19cc0 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 73 70 65 63 69 **.** More speci
19cd0 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 20 66 75 fically, this fu
19ce0 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 73 20 nction attempts
19cf0 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a 65 20 74 to re-organize t
19d00 68 65 20 64 61 74 61 62 61 73 65 20 73 6f 20 0a he database so .
19d10 2a 2a 20 74 68 61 74 20 74 68 65 20 6c 61 73 74 ** that the last
19d20 20 70 61 67 65 20 6f 66 20 74 68 65 20 66 69 6c page of the fil
19d30 65 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 e currently in u
19d40 73 65 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 se is no longer
19d50 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 50 61 in use..**.** Pa
19d60 72 61 6d 65 74 65 72 20 6e 46 69 6e 20 69 73 20 rameter nFin is
19d70 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 the number of pa
19d80 67 65 73 20 74 68 61 74 20 74 68 69 73 20 64 61 ges that this da
19d90 74 61 62 61 73 65 20 77 6f 75 6c 64 20 63 6f 6e tabase would con
19da0 74 61 69 6e 0a 2a 2a 20 77 65 72 65 20 74 68 69 tain.** were thi
19db0 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 s function calle
19dc0 64 20 75 6e 74 69 6c 20 69 74 20 72 65 74 75 72 d until it retur
19dd0 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e 45 2e 0a ns SQLITE_DONE..
19de0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 43 6f **.** If the bCo
19df0 6d 6d 69 74 20 70 61 72 61 6d 65 74 65 72 20 69 mmit parameter i
19e00 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 69 73 s non-zero, this
19e10 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 function assume
19e20 73 20 74 68 61 74 20 74 68 65 20 0a 2a 2a 20 63 s that the .** c
19e30 61 6c 6c 65 72 20 77 69 6c 6c 20 6b 65 65 70 20 aller will keep
19e40 63 61 6c 6c 69 6e 67 20 69 6e 63 72 56 61 63 75 calling incrVacu
19e50 75 6d 53 74 65 70 28 29 20 75 6e 74 69 6c 20 69 umStep() until i
19e60 74 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 t returns SQLITE
19e70 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 20 61 6e 20 _DONE .** or an
19e80 65 72 72 6f 72 2e 20 62 43 6f 6d 6d 69 74 20 69 error. bCommit i
19e90 73 20 70 61 73 73 65 64 20 74 72 75 65 20 66 6f s passed true fo
19ea0 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d r an auto-vacuum
19eb0 2d 6f 6e 2d 63 6f 6d 6d 69 74 20 0a 2a 2a 20 6f -on-commit .** o
19ec0 70 65 72 61 74 69 6f 6e 2c 20 6f 72 20 66 61 6c peration, or fal
19ed0 73 65 20 66 6f 72 20 61 6e 20 69 6e 63 72 65 6d se for an increm
19ee0 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e 0a 2a 2f ental vacuum..*/
19ef0 0a 73 74 61 74 69 63 20 69 6e 74 20 69 6e 63 72 .static int incr
19f00 56 61 63 75 75 6d 53 74 65 70 28 42 74 53 68 61 VacuumStep(BtSha
19f10 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6e red *pBt, Pgno n
19f20 46 69 6e 2c 20 50 67 6e 6f 20 69 4c 61 73 74 50 Fin, Pgno iLastP
19f30 67 2c 20 69 6e 74 20 62 43 6f 6d 6d 69 74 29 7b g, int bCommit){
19f40 0a 20 20 50 67 6e 6f 20 6e 46 72 65 65 4c 69 73 . Pgno nFreeLis
19f50 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
19f60 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
19f70 73 74 69 6c 6c 20 6f 6e 20 74 68 65 20 66 72 65 still on the fre
19f80 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 69 6e 74 20 e-list */. int
19f90 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 rc;.. assert( s
19fa0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
19fb0 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
19fc0 0a 20 20 61 73 73 65 72 74 28 20 69 4c 61 73 74 . assert( iLast
19fd0 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a 20 20 69 66 Pg>nFin );.. if
19fe0 28 20 21 50 54 52 4d 41 50 5f 49 53 50 41 47 45 ( !PTRMAP_ISPAGE
19ff0 28 70 42 74 2c 20 69 4c 61 73 74 50 67 29 20 26 (pBt, iLastPg) &
1a000 26 20 69 4c 61 73 74 50 67 21 3d 50 45 4e 44 49 & iLastPg!=PENDI
1a010 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
1a020 29 20 29 7b 0a 20 20 20 20 75 38 20 65 54 79 70 ) ){. u8 eTyp
1a030 65 3b 0a 20 20 20 20 50 67 6e 6f 20 69 50 74 72 e;. Pgno iPtr
1a040 50 61 67 65 3b 0a 0a 20 20 20 20 6e 46 72 65 65 Page;.. nFree
1a050 4c 69 73 74 20 3d 20 67 65 74 34 62 79 74 65 28 List = get4byte(
1a060 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 &pBt->pPage1->aD
1a070 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 69 66 ata[36]);. if
1a080 28 20 6e 46 72 65 65 4c 69 73 74 3d 3d 30 20 29 ( nFreeList==0 )
1a090 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
1a0a0 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 QLITE_DONE;.
1a0b0 7d 0a 0a 20 20 20 20 72 63 20 3d 20 70 74 72 6d }.. rc = ptrm
1a0c0 61 70 47 65 74 28 70 42 74 2c 20 69 4c 61 73 74 apGet(pBt, iLast
1a0d0 50 67 2c 20 26 65 54 79 70 65 2c 20 26 69 50 74 Pg, &eType, &iPt
1a0e0 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 rPage);. if(
1a0f0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1a100 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
1a110 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
1a120 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 52 4f eType==PTRMAP_RO
1a130 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 20 20 OTPAGE ){.
1a140 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
1a150 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
1a160 7d 0a 0a 20 20 20 20 69 66 28 20 65 54 79 70 65 }.. if( eType
1a170 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 50 41 47 ==PTRMAP_FREEPAG
1a180 45 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 62 E ){. if( b
1a190 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 Commit==0 ){.
1a1a0 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 /* Remove t
1a1b0 68 65 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 he page from the
1a1c0 20 66 69 6c 65 73 20 66 72 65 65 2d 6c 69 73 74 files free-list
1a1d0 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 72 65 . This is not re
1a1e0 71 75 69 72 65 64 0a 20 20 20 20 20 20 20 20 2a quired. *
1a1f0 2a 20 69 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 * if bCommit is
1a200 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e 20 74 68 61 non-zero. In tha
1a210 74 20 63 61 73 65 2c 20 74 68 65 20 66 72 65 65 t case, the free
1a220 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 0a 20 20 -list will be.
1a230 20 20 20 20 20 20 2a 2a 20 74 72 75 6e 63 61 74 ** truncat
1a240 65 64 20 74 6f 20 7a 65 72 6f 20 61 66 74 65 72 ed to zero after
1a250 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
1a260 65 74 75 72 6e 73 2c 20 73 6f 20 69 74 20 64 6f eturns, so it do
1a270 65 73 6e 27 74 20 0a 20 20 20 20 20 20 20 20 2a esn't . *
1a280 2a 20 6d 61 74 74 65 72 20 69 66 20 69 74 20 73 * matter if it s
1a290 74 69 6c 6c 20 63 6f 6e 74 61 69 6e 73 20 73 6f till contains so
1a2a0 6d 65 20 67 61 72 62 61 67 65 20 65 6e 74 72 69 me garbage entri
1a2b0 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 es.. */.
1a2c0 20 20 20 20 20 20 20 50 67 6e 6f 20 69 46 72 65 Pgno iFre
1a2d0 65 50 67 3b 0a 20 20 20 20 20 20 20 20 4d 65 6d ePg;. Mem
1a2e0 50 61 67 65 20 2a 70 46 72 65 65 50 67 3b 0a 20 Page *pFreePg;.
1a2f0 20 20 20 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f rc = allo
1a300 63 61 74 65 42 74 72 65 65 50 61 67 65 28 70 42 cateBtreePage(pB
1a310 74 2c 20 26 70 46 72 65 65 50 67 2c 20 26 69 46 t, &pFreePg, &iF
1a320 72 65 65 50 67 2c 20 69 4c 61 73 74 50 67 2c 20 reePg, iLastPg,
1a330 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 3b 0a BTALLOC_EXACT);.
1a340 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
1a350 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1a360 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
1a370 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
1a380 20 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 assert( iFre
1a390 65 50 67 3d 3d 69 4c 61 73 74 50 67 20 29 3b 0a ePg==iLastPg );.
1a3a0 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
1a3b0 61 67 65 28 70 46 72 65 65 50 67 29 3b 0a 20 20 age(pFreePg);.
1a3c0 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c 73 65 }. } else
1a3d0 20 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 69 46 {. Pgno iF
1a3e0 72 65 65 50 67 3b 20 20 20 20 20 20 20 20 20 20 reePg;
1a3f0 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 66 /* Index of f
1a400 72 65 65 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 ree page to move
1a410 20 70 4c 61 73 74 50 67 20 74 6f 20 2a 2f 0a 20 pLastPg to */.
1a420 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4c MemPage *pL
1a430 61 73 74 50 67 3b 0a 20 20 20 20 20 20 75 38 20 astPg;. u8
1a440 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f 43 5f eMode = BTALLOC_
1a450 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f 64 65 20 70 ANY; /* Mode p
1a460 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6c 6c arameter for all
1a470 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 28 29 ocateBtreePage()
1a480 20 2a 2f 0a 20 20 20 20 20 20 50 67 6e 6f 20 69 */. Pgno i
1a490 4e 65 61 72 20 3d 20 30 3b 20 20 20 20 20 20 20 Near = 0;
1a4a0 20 20 20 20 2f 2a 20 6e 65 61 72 62 79 20 70 61 /* nearby pa
1a4b0 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6c 6c 6f rameter for allo
1a4c0 63 61 74 65 42 74 72 65 65 50 61 67 65 28 29 20 cateBtreePage()
1a4d0 2a 2f 0a 0a 20 20 20 20 20 20 72 63 20 3d 20 62 */.. rc = b
1a4e0 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c treeGetPage(pBt,
1a4f0 20 69 4c 61 73 74 50 67 2c 20 26 70 4c 61 73 74 iLastPg, &pLast
1a500 50 67 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 Pg, 0);. if
1a510 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1a520 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
1a530 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 n rc;. }..
1a540 20 20 20 20 20 2f 2a 20 49 66 20 62 43 6f 6d 6d /* If bComm
1a550 69 74 20 69 73 20 7a 65 72 6f 2c 20 74 68 69 73 it is zero, this
1a560 20 6c 6f 6f 70 20 72 75 6e 73 20 65 78 61 63 74 loop runs exact
1a570 6c 79 20 6f 6e 63 65 20 61 6e 64 20 70 61 67 65 ly once and page
1a580 20 70 4c 61 73 74 50 67 0a 20 20 20 20 20 20 2a pLastPg. *
1a590 2a 20 69 73 20 73 77 61 70 70 65 64 20 77 69 74 * is swapped wit
1a5a0 68 20 74 68 65 20 66 69 72 73 74 20 66 72 65 65 h the first free
1a5b0 20 70 61 67 65 20 70 75 6c 6c 65 64 20 6f 66 66 page pulled off
1a5c0 20 74 68 65 20 66 72 65 65 20 6c 69 73 74 2e 0a the free list..
1a5d0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
1a5e0 2a 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 * On the other h
1a5f0 61 6e 64 2c 20 69 66 20 62 43 6f 6d 6d 69 74 20 and, if bCommit
1a600 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
1a610 7a 65 72 6f 2c 20 74 68 65 6e 20 6b 65 65 70 0a zero, then keep.
1a620 20 20 20 20 20 20 2a 2a 20 6c 6f 6f 70 69 6e 67 ** looping
1a630 20 75 6e 74 69 6c 20 61 20 66 72 65 65 2d 70 61 until a free-pa
1a640 67 65 20 6c 6f 63 61 74 65 64 20 77 69 74 68 69 ge located withi
1a650 6e 20 74 68 65 20 66 69 72 73 74 20 6e 46 69 6e n the first nFin
1a660 20 70 61 67 65 73 0a 20 20 20 20 20 20 2a 2a 20 pages. **
1a670 6f 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 66 of the file is f
1a680 6f 75 6e 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 ound.. */.
1a690 20 20 20 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 if( bCommit
1a6a0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 65 ==0 ){. e
1a6b0 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f 43 5f 4c Mode = BTALLOC_L
1a6c0 45 3b 0a 20 20 20 20 20 20 20 20 69 4e 65 61 72 E;. iNear
1a6d0 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 20 20 7d = nFin;. }
1a6e0 0a 20 20 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 . do {.
1a6f0 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 MemPage *pFr
1a700 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 72 63 eePg;. rc
1a710 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 = allocateBtree
1a720 50 61 67 65 28 70 42 74 2c 20 26 70 46 72 65 65 Page(pBt, &pFree
1a730 50 67 2c 20 26 69 46 72 65 65 50 67 2c 20 69 4e Pg, &iFreePg, iN
1a740 65 61 72 2c 20 65 4d 6f 64 65 29 3b 0a 20 20 20 ear, eMode);.
1a750 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
1a760 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1a770 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
1a780 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 20 20 20 pLastPg);.
1a790 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1a7a0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
1a7b0 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 46 72 releasePage(pFr
1a7c0 65 65 50 67 29 3b 0a 20 20 20 20 20 20 7d 77 68 eePg);. }wh
1a7d0 69 6c 65 28 20 62 43 6f 6d 6d 69 74 20 26 26 20 ile( bCommit &&
1a7e0 69 46 72 65 65 50 67 3e 6e 46 69 6e 20 29 3b 0a iFreePg>nFin );.
1a7f0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 46 assert( iF
1a800 72 65 65 50 67 3c 69 4c 61 73 74 50 67 20 29 3b reePg<iLastPg );
1a810 0a 20 20 20 20 20 20 0a 20 20 20 20 20 20 72 63 . . rc
1a820 20 3d 20 72 65 6c 6f 63 61 74 65 50 61 67 65 28 = relocatePage(
1a830 70 42 74 2c 20 70 4c 61 73 74 50 67 2c 20 65 54 pBt, pLastPg, eT
1a840 79 70 65 2c 20 69 50 74 72 50 61 67 65 2c 20 69 ype, iPtrPage, i
1a850 46 72 65 65 50 67 2c 20 62 43 6f 6d 6d 69 74 29 FreePg, bCommit)
1a860 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 ;. releaseP
1a870 61 67 65 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 age(pLastPg);.
1a880 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1a890 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1a8a0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
1a8b0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 }. }. }..
1a8c0 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 if( bCommit==0
1a8d0 29 7b 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 ){. do {.
1a8e0 20 20 69 4c 61 73 74 50 67 2d 2d 3b 0a 20 20 20 iLastPg--;.
1a8f0 20 7d 77 68 69 6c 65 28 20 69 4c 61 73 74 50 67 }while( iLastPg
1a900 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 ==PENDING_BYTE_P
1a910 41 47 45 28 70 42 74 29 20 7c 7c 20 50 54 52 4d AGE(pBt) || PTRM
1a920 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 69 AP_ISPAGE(pBt, i
1a930 4c 61 73 74 50 67 29 20 29 3b 0a 20 20 20 20 70 LastPg) );. p
1a940 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 Bt->bDoTruncate
1a950 3d 20 31 3b 0a 20 20 20 20 70 42 74 2d 3e 6e 50 = 1;. pBt->nP
1a960 61 67 65 20 3d 20 69 4c 61 73 74 50 67 3b 0a 20 age = iLastPg;.
1a970 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
1a980 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
1a990 54 68 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 The database ope
1a9a0 6e 65 64 20 62 79 20 74 68 65 20 66 69 72 73 74 ned by the first
1a9b0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 argument is an
1a9c0 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 auto-vacuum data
1a9d0 62 61 73 65 0a 2a 2a 20 6e 4f 72 69 67 20 70 61 base.** nOrig pa
1a9e0 67 65 73 20 69 6e 20 73 69 7a 65 20 63 6f 6e 74 ges in size cont
1a9f0 61 69 6e 69 6e 67 20 6e 46 72 65 65 20 66 72 65 aining nFree fre
1aa00 65 20 70 61 67 65 73 2e 20 52 65 74 75 72 6e 20 e pages. Return
1aa10 74 68 65 20 65 78 70 65 63 74 65 64 20 0a 2a 2a the expected .**
1aa20 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
1aa30 61 62 61 73 65 20 69 6e 20 70 61 67 65 73 20 66 abase in pages f
1aa40 6f 6c 6c 6f 77 69 6e 67 20 61 6e 20 61 75 74 6f ollowing an auto
1aa50 2d 76 61 63 75 75 6d 20 6f 70 65 72 61 74 69 6f -vacuum operatio
1aa60 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e n..*/.static Pgn
1aa70 6f 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 42 74 o finalDbSize(Bt
1aa80 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e Shared *pBt, Pgn
1aa90 6f 20 6e 4f 72 69 67 2c 20 50 67 6e 6f 20 6e 46 o nOrig, Pgno nF
1aaa0 72 65 65 29 7b 0a 20 20 69 6e 74 20 6e 45 6e 74 ree){. int nEnt
1aab0 72 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ry;
1aac0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1aad0 72 20 6f 66 20 65 6e 74 72 69 65 73 20 6f 6e 20 r of entries on
1aae0 6f 6e 65 20 70 74 72 6d 61 70 20 70 61 67 65 20 one ptrmap page
1aaf0 2a 2f 0a 20 20 50 67 6e 6f 20 6e 50 74 72 6d 61 */. Pgno nPtrma
1ab00 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p;
1ab10 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1ab20 66 20 50 74 72 4d 61 70 20 70 61 67 65 73 20 74 f PtrMap pages t
1ab30 6f 20 62 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 o be freed */.
1ab40 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 20 20 20 20 Pgno nFin;
1ab50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ab60 2f 2a 20 52 65 74 75 72 6e 20 76 61 6c 75 65 20 /* Return value
1ab70 2a 2f 0a 0a 20 20 6e 45 6e 74 72 79 20 3d 20 70 */.. nEntry = p
1ab80 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 35 Bt->usableSize/5
1ab90 3b 0a 20 20 6e 50 74 72 6d 61 70 20 3d 20 28 6e ;. nPtrmap = (n
1aba0 46 72 65 65 2d 6e 4f 72 69 67 2b 50 54 52 4d 41 Free-nOrig+PTRMA
1abb0 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 6e 4f P_PAGENO(pBt, nO
1abc0 72 69 67 29 2b 6e 45 6e 74 72 79 29 2f 6e 45 6e rig)+nEntry)/nEn
1abd0 74 72 79 3b 0a 20 20 6e 46 69 6e 20 3d 20 6e 4f try;. nFin = nO
1abe0 72 69 67 20 2d 20 6e 46 72 65 65 20 2d 20 6e 50 rig - nFree - nP
1abf0 74 72 6d 61 70 3b 0a 20 20 69 66 28 20 6e 4f 72 trmap;. if( nOr
1ac00 69 67 3e 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f ig>PENDING_BYTE_
1ac10 50 41 47 45 28 70 42 74 29 20 26 26 20 6e 46 69 PAGE(pBt) && nFi
1ac20 6e 3c 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 n<PENDING_BYTE_P
1ac30 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 AGE(pBt) ){.
1ac40 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 20 20 77 68 nFin--;. }. wh
1ac50 69 6c 65 28 20 50 54 52 4d 41 50 5f 49 53 50 41 ile( PTRMAP_ISPA
1ac60 47 45 28 70 42 74 2c 20 6e 46 69 6e 29 20 7c 7c GE(pBt, nFin) ||
1ac70 20 6e 46 69 6e 3d 3d 50 45 4e 44 49 4e 47 5f 42 nFin==PENDING_B
1ac80 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b YTE_PAGE(pBt) ){
1ac90 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d . nFin--;. }
1aca0 0a 0a 20 20 72 65 74 75 72 6e 20 6e 46 69 6e 3b .. return nFin;
1acb0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 77 72 69 74 .}../*.** A writ
1acc0 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 e-transaction mu
1acd0 73 74 20 62 65 20 6f 70 65 6e 65 64 20 62 65 66 st be opened bef
1ace0 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 ore calling this
1acf0 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 49 74 function..** It
1ad00 20 70 65 72 66 6f 72 6d 73 20 61 20 73 69 6e 67 performs a sing
1ad10 6c 65 20 75 6e 69 74 20 6f 66 20 77 6f 72 6b 20 le unit of work
1ad20 74 6f 77 61 72 64 73 20 61 6e 20 69 6e 63 72 65 towards an incre
1ad30 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e 0a 2a mental vacuum..*
1ad40 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 63 72 *.** If the incr
1ad50 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 20 69 emental vacuum i
1ad60 73 20 66 69 6e 69 73 68 65 64 20 61 66 74 65 72 s finished after
1ad70 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 68 this function h
1ad80 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 51 4c 49 54 as run,.** SQLIT
1ad90 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 75 72 6e E_DONE is return
1ada0 65 64 2e 20 49 66 20 69 74 20 69 73 20 6e 6f 74 ed. If it is not
1adb0 20 66 69 6e 69 73 68 65 64 2c 20 62 75 74 20 6e finished, but n
1adc0 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 o error occurred
1add0 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 ,.** SQLITE_OK i
1ade0 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 s returned. Othe
1adf0 72 77 69 73 65 20 61 6e 20 53 51 4c 69 74 65 20 rwise an SQLite
1ae00 65 72 72 6f 72 20 63 6f 64 65 2e 20 0a 2a 2f 0a error code. .*/.
1ae10 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
1ae20 49 6e 63 72 56 61 63 75 75 6d 28 42 74 72 65 65 IncrVacuum(Btree
1ae30 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a *p){. int rc;.
1ae40 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1ae50 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 20 73 71 6c = p->pBt;.. sql
1ae60 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1ae70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 );. assert( pBt
1ae80 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d ->inTransaction=
1ae90 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 26 26 20 =TRANS_WRITE &&
1aea0 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
1aeb0 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 69 66 28 S_WRITE );. if(
1aec0 20 21 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 !pBt->autoVacuu
1aed0 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 m ){. rc = SQ
1aee0 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c LITE_DONE;. }el
1aef0 73 65 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 4f 72 se{. Pgno nOr
1af00 69 67 20 3d 20 62 74 72 65 65 50 61 67 65 63 6f ig = btreePageco
1af10 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 20 50 67 unt(pBt);. Pg
1af20 6e 6f 20 6e 46 72 65 65 20 3d 20 67 65 74 34 62 no nFree = get4b
1af30 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 yte(&pBt->pPage1
1af40 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 ->aData[36]);.
1af50 20 20 50 67 6e 6f 20 6e 46 69 6e 20 3d 20 66 69 Pgno nFin = fi
1af60 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 2c 20 6e nalDbSize(pBt, n
1af70 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b 0a 0a 20 Orig, nFree);..
1af80 20 20 20 69 66 28 20 6e 4f 72 69 67 3c 6e 46 69 if( nOrig<nFi
1af90 6e 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 n ){. rc =
1afa0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1afb0 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 KPT;. }else i
1afc0 66 28 20 6e 46 72 65 65 3e 30 20 29 7b 0a 20 20 f( nFree>0 ){.
1afd0 20 20 20 20 72 63 20 3d 20 73 61 76 65 41 6c 6c rc = saveAll
1afe0 43 75 72 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 Cursors(pBt, 0,
1aff0 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 0);. if( rc
1b000 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1b010 20 20 20 20 20 20 20 69 6e 76 61 6c 69 64 61 74 invalidat
1b020 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 eAllOverflowCach
1b030 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20 e(pBt);.
1b040 72 63 20 3d 20 69 6e 63 72 56 61 63 75 75 6d 53 rc = incrVacuumS
1b050 74 65 70 28 70 42 74 2c 20 6e 46 69 6e 2c 20 6e tep(pBt, nFin, n
1b060 4f 72 69 67 2c 20 30 29 3b 0a 20 20 20 20 20 20 Orig, 0);.
1b070 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d }. if( rc==
1b080 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1b090 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
1b0a0 33 50 61 67 65 72 57 72 69 74 65 28 70 42 74 2d 3PagerWrite(pBt-
1b0b0 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 >pPage1->pDbPage
1b0c0 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 );. put4b
1b0d0 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 yte(&pBt->pPage1
1b0e0 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 70 42 74 ->aData[28], pBt
1b0f0 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 ->nPage);.
1b100 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
1b110 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 rc = SQLITE_D
1b120 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 ONE;. }. }.
1b130 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1b140 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
1b150 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 rc;.}../*.** Thi
1b160 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
1b170 6c 65 64 20 70 72 69 6f 72 20 74 6f 20 73 71 6c led prior to sql
1b180 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 20 ite3PagerCommit
1b190 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69 when a transacti
1b1a0 6f 6e 0a 2a 2a 20 69 73 20 63 6f 6d 6d 69 74 74 on.** is committ
1b1b0 65 64 20 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 ed for an auto-v
1b1c0 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 2e 0a acuum database..
1b1d0 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f **.** If SQLITE_
1b1e0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 OK is returned,
1b1f0 74 68 65 6e 20 2a 70 6e 54 72 75 6e 63 20 69 73 then *pnTrunc is
1b200 20 73 65 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 set to the numb
1b210 65 72 20 6f 66 20 70 61 67 65 73 0a 2a 2a 20 74 er of pages.** t
1b220 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1b230 20 73 68 6f 75 6c 64 20 62 65 20 74 72 75 6e 63 should be trunc
1b240 61 74 65 64 20 74 6f 20 64 75 72 69 6e 67 20 74 ated to during t
1b250 68 65 20 63 6f 6d 6d 69 74 20 70 72 6f 63 65 73 he commit proces
1b260 73 2e 20 0a 2a 2a 20 69 2e 65 2e 20 74 68 65 20 s. .** i.e. the
1b270 64 61 74 61 62 61 73 65 20 68 61 73 20 62 65 65 database has bee
1b280 6e 20 72 65 6f 72 67 61 6e 69 7a 65 64 20 73 6f n reorganized so
1b290 20 74 68 61 74 20 6f 6e 6c 79 20 74 68 65 20 66 that only the f
1b2a0 69 72 73 74 20 2a 70 6e 54 72 75 6e 63 0a 2a 2a irst *pnTrunc.**
1b2b0 20 70 61 67 65 73 20 61 72 65 20 69 6e 20 75 73 pages are in us
1b2c0 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
1b2d0 20 61 75 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 autoVacuumCommi
1b2e0 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 t(BtShared *pBt)
1b2f0 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
1b300 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 20 ITE_OK;. Pager
1b310 2a 70 50 61 67 65 72 20 3d 20 70 42 74 2d 3e 70 *pPager = pBt->p
1b320 50 61 67 65 72 3b 0a 20 20 56 56 41 5f 4f 4e 4c Pager;. VVA_ONL
1b330 59 28 20 69 6e 74 20 6e 52 65 66 20 3d 20 73 71 Y( int nRef = sq
1b340 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 6f 75 lite3PagerRefcou
1b350 6e 74 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 nt(pPager) );..
1b360 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
1b370 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
1b380 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 6e 76 >mutex) );. inv
1b390 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c alidateAllOverfl
1b3a0 6f 77 43 61 63 68 65 28 70 42 74 29 3b 0a 20 20 owCache(pBt);.
1b3b0 61 73 73 65 72 74 28 70 42 74 2d 3e 61 75 74 6f assert(pBt->auto
1b3c0 56 61 63 75 75 6d 29 3b 0a 20 20 69 66 28 20 21 Vacuum);. if( !
1b3d0 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 pBt->incrVacuum
1b3e0 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e ){. Pgno nFin
1b3f0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d ; /* Num
1b400 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 ber of pages in
1b410 64 61 74 61 62 61 73 65 20 61 66 74 65 72 20 61 database after a
1b420 75 74 6f 76 61 63 75 75 6d 69 6e 67 20 2a 2f 0a utovacuuming */.
1b430 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 65 3b 20 Pgno nFree;
1b440 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1b450 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 68 65 of pages on the
1b460 20 66 72 65 65 6c 69 73 74 20 69 6e 69 74 69 61 freelist initia
1b470 6c 6c 79 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 lly */. Pgno
1b480 69 46 72 65 65 3b 20 20 20 20 20 20 20 20 2f 2a iFree; /*
1b490 20 54 68 65 20 6e 65 78 74 20 70 61 67 65 20 74 The next page t
1b4a0 6f 20 62 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 o be freed */.
1b4b0 20 20 50 67 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 Pgno nOrig;
1b4c0 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 /* Database
1b4d0 20 73 69 7a 65 20 62 65 66 6f 72 65 20 66 72 65 size before fre
1b4e0 65 69 6e 67 20 2a 2f 0a 0a 20 20 20 20 6e 4f 72 eing */.. nOr
1b4f0 69 67 20 3d 20 62 74 72 65 65 50 61 67 65 63 6f ig = btreePageco
1b500 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 20 69 66 unt(pBt);. if
1b510 28 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 ( PTRMAP_ISPAGE(
1b520 70 42 74 2c 20 6e 4f 72 69 67 29 20 7c 7c 20 6e pBt, nOrig) || n
1b530 4f 72 69 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 Orig==PENDING_BY
1b540 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
1b550 20 20 20 20 20 20 2f 2a 20 49 74 20 69 73 20 6e /* It is n
1b560 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 ot possible to c
1b570 72 65 61 74 65 20 61 20 64 61 74 61 62 61 73 65 reate a database
1b580 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 66 for which the f
1b590 69 6e 61 6c 20 70 61 67 65 0a 20 20 20 20 20 20 inal page.
1b5a0 2a 2a 20 69 73 20 65 69 74 68 65 72 20 61 20 70 ** is either a p
1b5b0 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 20 ointer-map page
1b5c0 6f 72 20 74 68 65 20 70 65 6e 64 69 6e 67 2d 62 or the pending-b
1b5d0 79 74 65 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 yte page. If one
1b5e0 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 65 6e 63 . ** is enc
1b5f0 6f 75 6e 74 65 72 65 64 2c 20 74 68 69 73 20 69 ountered, this i
1b600 6e 64 69 63 61 74 65 73 20 63 6f 72 72 75 70 74 ndicates corrupt
1b610 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ion.. */.
1b620 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1b630 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
1b640 20 20 20 20 7d 0a 0a 20 20 20 20 6e 46 72 65 65 }.. nFree
1b650 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 = get4byte(&pBt
1b660 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b ->pPage1->aData[
1b670 33 36 5d 29 3b 0a 20 20 20 20 6e 46 69 6e 20 3d 36]);. nFin =
1b680 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 finalDbSize(pBt
1b690 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b , nOrig, nFree);
1b6a0 0a 20 20 20 20 69 66 28 20 6e 46 69 6e 3e 6e 4f . if( nFin>nO
1b6b0 72 69 67 20 29 20 72 65 74 75 72 6e 20 53 51 4c rig ) return SQL
1b6c0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
1b6d0 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 6e 3c 6e ;. if( nFin<n
1b6e0 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 20 72 63 Orig ){. rc
1b6f0 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 = saveAllCursor
1b700 73 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 s(pBt, 0, 0);.
1b710 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 46 72 65 }. for(iFre
1b720 65 3d 6e 4f 72 69 67 3b 20 69 46 72 65 65 3e 6e e=nOrig; iFree>n
1b730 46 69 6e 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 Fin && rc==SQLIT
1b740 45 5f 4f 4b 3b 20 69 46 72 65 65 2d 2d 29 7b 0a E_OK; iFree--){.
1b750 20 20 20 20 20 20 72 63 20 3d 20 69 6e 63 72 56 rc = incrV
1b760 61 63 75 75 6d 53 74 65 70 28 70 42 74 2c 20 6e acuumStep(pBt, n
1b770 46 69 6e 2c 20 69 46 72 65 65 2c 20 31 29 3b 0a Fin, iFree, 1);.
1b780 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 28 72 }. if( (r
1b790 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 7c c==SQLITE_DONE |
1b7a0 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 | rc==SQLITE_OK)
1b7b0 20 26 26 20 6e 46 72 65 65 3e 30 20 29 7b 0a 20 && nFree>0 ){.
1b7c0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
1b7d0 33 50 61 67 65 72 57 72 69 74 65 28 70 42 74 2d 3PagerWrite(pBt-
1b7e0 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 >pPage1->pDbPage
1b7f0 29 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 );. put4byt
1b800 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e e(&pBt->pPage1->
1b810 61 44 61 74 61 5b 33 32 5d 2c 20 30 29 3b 0a 20 aData[32], 0);.
1b820 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
1b830 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 Bt->pPage1->aDat
1b840 61 5b 33 36 5d 2c 20 30 29 3b 0a 20 20 20 20 20 a[36], 0);.
1b850 20 70 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e put4byte(&pBt->
1b860 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 pPage1->aData[28
1b870 5d 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 20 20 20 ], nFin);.
1b880 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 pBt->bDoTruncate
1b890 20 3d 20 31 3b 0a 20 20 20 20 20 20 70 42 74 2d = 1;. pBt-
1b8a0 3e 6e 50 61 67 65 20 3d 20 6e 46 69 6e 3b 0a 20 >nPage = nFin;.
1b8b0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21 }. if( rc!
1b8c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1b8d0 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 sqlite3Pager
1b8e0 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65 72 29 Rollback(pPager)
1b8f0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 ;. }. }.. a
1b900 73 73 65 72 74 28 20 6e 52 65 66 3e 3d 73 71 6c ssert( nRef>=sql
1b910 69 74 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e ite3PagerRefcoun
1b920 74 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 72 t(pPager) );. r
1b930 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6c eturn rc;.}..#el
1b940 73 65 20 2f 2a 20 69 66 6e 64 65 66 20 53 51 4c se /* ifndef SQL
1b950 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
1b960 55 55 4d 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 UUM */.# define
1b970 73 65 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 setChildPtrmaps(
1b980 78 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e x) SQLITE_OK.#en
1b990 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 dif../*.** This
1b9a0 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 routine does the
1b9b0 20 66 69 72 73 74 20 70 68 61 73 65 20 6f 66 20 first phase of
1b9c0 61 20 74 77 6f 2d 70 68 61 73 65 20 63 6f 6d 6d a two-phase comm
1b9d0 69 74 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e it. This routin
1b9e0 65 0a 2a 2a 20 63 61 75 73 65 73 20 61 20 72 6f e.** causes a ro
1b9f0 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 74 llback journal t
1ba00 6f 20 62 65 20 63 72 65 61 74 65 64 20 28 69 66 o be created (if
1ba10 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 it does not alr
1ba20 65 61 64 79 20 65 78 69 73 74 29 0a 2a 2a 20 61 eady exist).** a
1ba30 6e 64 20 70 6f 70 75 6c 61 74 65 64 20 77 69 74 nd populated wit
1ba40 68 20 65 6e 6f 75 67 68 20 69 6e 66 6f 72 6d 61 h enough informa
1ba50 74 69 6f 6e 20 73 6f 20 74 68 61 74 20 69 66 20 tion so that if
1ba60 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 6f 63 63 a power loss occ
1ba70 75 72 73 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 urs.** the datab
1ba80 61 73 65 20 63 61 6e 20 62 65 20 72 65 73 74 6f ase can be resto
1ba90 72 65 64 20 74 6f 20 69 74 73 20 6f 72 69 67 69 red to its origi
1baa0 6e 61 6c 20 73 74 61 74 65 20 62 79 20 70 6c 61 nal state by pla
1bab0 79 69 6e 67 20 62 61 63 6b 0a 2a 2a 20 74 68 65 ying back.** the
1bac0 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 65 6e 20 journal. Then
1bad0 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
1bae0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 72 65 20 the journal are
1baf0 66 6c 75 73 68 65 64 20 6f 75 74 20 74 6f 0a 2a flushed out to.*
1bb00 2a 20 74 68 65 20 64 69 73 6b 2e 20 20 41 66 74 * the disk. Aft
1bb10 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 er the journal i
1bb20 73 20 73 61 66 65 6c 79 20 6f 6e 20 6f 78 69 64 s safely on oxid
1bb30 65 2c 20 74 68 65 20 63 68 61 6e 67 65 73 20 74 e, the changes t
1bb40 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 o the.** databas
1bb50 65 20 61 72 65 20 77 72 69 74 74 65 6e 20 69 6e e are written in
1bb60 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
1bb70 66 69 6c 65 20 61 6e 64 20 66 6c 75 73 68 65 64 file and flushed
1bb80 20 74 6f 20 6f 78 69 64 65 2e 0a 2a 2a 20 41 74 to oxide..** At
1bb90 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 69 73 the end of this
1bba0 20 63 61 6c 6c 2c 20 74 68 65 20 72 6f 6c 6c 62 call, the rollb
1bbb0 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 73 74 69 6c ack journal stil
1bbc0 6c 20 65 78 69 73 74 73 20 6f 6e 20 74 68 65 0a l exists on the.
1bbd0 2a 2a 20 64 69 73 6b 20 61 6e 64 20 77 65 20 61 ** disk and we a
1bbe0 72 65 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 re still holding
1bbf0 20 61 6c 6c 20 6c 6f 63 6b 73 2c 20 73 6f 20 74 all locks, so t
1bc00 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 he transaction h
1bc10 61 73 20 6e 6f 74 0a 2a 2a 20 63 6f 6d 6d 69 74 as not.** commit
1bc20 74 65 64 2e 20 20 53 65 65 20 73 71 6c 69 74 65 ted. See sqlite
1bc30 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 3BtreeCommitPhas
1bc40 65 54 77 6f 28 29 20 66 6f 72 20 74 68 65 20 73 eTwo() for the s
1bc50 65 63 6f 6e 64 20 70 68 61 73 65 20 6f 66 20 74 econd phase of t
1bc60 68 65 0a 2a 2a 20 63 6f 6d 6d 69 74 20 70 72 6f he.** commit pro
1bc70 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 cess..**.** This
1bc80 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 call is a no-op
1bc90 20 69 66 20 6e 6f 20 77 72 69 74 65 2d 74 72 61 if no write-tra
1bca0 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 75 72 72 nsaction is curr
1bcb0 65 6e 74 6c 79 20 61 63 74 69 76 65 20 6f 6e 20 ently active on
1bcc0 70 42 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 pBt..**.** Other
1bcd0 77 69 73 65 2c 20 73 79 6e 63 20 74 68 65 20 64 wise, sync the d
1bce0 61 74 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 atabase file for
1bcf0 20 74 68 65 20 62 74 72 65 65 20 70 42 74 2e 20 the btree pBt.
1bd00 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 73 20 74 zMaster points t
1bd10 6f 0a 2a 2a 20 74 68 65 20 6e 61 6d 65 20 6f 66 o.** the name of
1bd20 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 a master journa
1bd30 6c 20 66 69 6c 65 20 74 68 61 74 20 73 68 6f 75 l file that shou
1bd40 6c 64 20 62 65 20 77 72 69 74 74 65 6e 20 69 6e ld be written in
1bd50 74 6f 20 74 68 65 0a 2a 2a 20 69 6e 64 69 76 69 to the.** indivi
1bd60 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66 69 6c dual journal fil
1bd70 65 2c 20 6f 72 20 69 73 20 4e 55 4c 4c 2c 20 69 e, or is NULL, i
1bd80 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 6d 61 73 ndicating no mas
1bd90 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
1bda0 20 0a 2a 2a 20 28 73 69 6e 67 6c 65 20 64 61 74 .** (single dat
1bdb0 61 62 61 73 65 20 74 72 61 6e 73 61 63 74 69 6f abase transactio
1bdc0 6e 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 n)..**.** When t
1bdd0 68 69 73 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 his is called, t
1bde0 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
1bdf0 6c 20 73 68 6f 75 6c 64 20 61 6c 72 65 61 64 79 l should already
1be00 20 68 61 76 65 20 62 65 65 6e 0a 2a 2a 20 63 72 have been.** cr
1be10 65 61 74 65 64 2c 20 70 6f 70 75 6c 61 74 65 64 eated, populated
1be20 20 77 69 74 68 20 74 68 69 73 20 6a 6f 75 72 6e with this journ
1be30 61 6c 20 70 6f 69 6e 74 65 72 20 61 6e 64 20 73 al pointer and s
1be40 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a ynced to disk..*
1be50 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 69 73 20 69 *.** Once this i
1be60 73 20 72 6f 75 74 69 6e 65 20 68 61 73 20 72 65 s routine has re
1be70 74 75 72 6e 65 64 2c 20 74 68 65 20 6f 6e 6c 79 turned, the only
1be80 20 74 68 69 6e 67 20 72 65 71 75 69 72 65 64 20 thing required
1be90 74 6f 20 63 6f 6d 6d 69 74 0a 2a 2a 20 74 68 65 to commit.** the
1bea0 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
1beb0 6f 6e 20 66 6f 72 20 74 68 69 73 20 64 61 74 61 on for this data
1bec0 62 61 73 65 20 66 69 6c 65 20 69 73 20 74 6f 20 base file is to
1bed0 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 6e delete the journ
1bee0 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 al..*/.int sqlit
1bef0 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 e3BtreeCommitPha
1bf00 73 65 4f 6e 65 28 42 74 72 65 65 20 2a 70 2c 20 seOne(Btree *p,
1bf10 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 const char *zMas
1bf20 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ter){. int rc =
1bf30 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
1bf40 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 ( p->inTrans==TR
1bf50 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 20 ANS_WRITE ){.
1bf60 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
1bf70 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 73 71 6c p->pBt;. sql
1bf80 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1bf90 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
1bfa0 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
1bfb0 4d 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 M. if( pBt->a
1bfc0 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 utoVacuum ){.
1bfd0 20 20 20 72 63 20 3d 20 61 75 74 6f 56 61 63 75 rc = autoVacu
1bfe0 75 6d 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 umCommit(pBt);.
1bff0 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
1c000 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1c010 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
1c020 61 76 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 ave(p);.
1c030 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
1c040 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 }. }. if(
1c050 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 pBt->bDoTruncat
1c060 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 e ){. sqlit
1c070 65 33 50 61 67 65 72 54 72 75 6e 63 61 74 65 49 e3PagerTruncateI
1c080 6d 61 67 65 28 70 42 74 2d 3e 70 50 61 67 65 72 mage(pBt->pPager
1c090 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 , pBt->nPage);.
1c0a0 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
1c0b0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
1c0c0 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 rCommitPhaseOne(
1c0d0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a 4d 61 pBt->pPager, zMa
1c0e0 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 20 73 71 ster, 0);. sq
1c0f0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
1c100 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e p);. }. return
1c110 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
1c120 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
1c130 61 6c 6c 65 64 20 66 72 6f 6d 20 62 6f 74 68 20 alled from both
1c140 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 BtreeCommitPhase
1c150 54 77 6f 28 29 20 61 6e 64 20 42 74 72 65 65 52 Two() and BtreeR
1c160 6f 6c 6c 62 61 63 6b 28 29 0a 2a 2a 20 61 74 20 ollback().** at
1c170 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f the conclusion o
1c180 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e f a transaction.
1c190 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
1c1a0 62 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 btreeEndTransact
1c1b0 69 6f 6e 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 ion(Btree *p){.
1c1c0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
1c1d0 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 p->pBt;. sqlit
1c1e0 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a e3 *db = p->db;.
1c1f0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
1c200 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 3BtreeHoldsMutex
1c210 28 70 29 20 29 3b 0a 0a 23 69 66 6e 64 65 66 20 (p) );..#ifndef
1c220 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
1c230 56 41 43 55 55 4d 0a 20 20 70 42 74 2d 3e 62 44 VACUUM. pBt->bD
1c240 6f 54 72 75 6e 63 61 74 65 20 3d 20 30 3b 0a 23 oTruncate = 0;.#
1c250 65 6e 64 69 66 0a 20 20 69 66 28 20 70 2d 3e 69 endif. if( p->i
1c260 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f 4e 4f 4e nTrans>TRANS_NON
1c270 45 20 26 26 20 64 62 2d 3e 6e 56 64 62 65 52 65 E && db->nVdbeRe
1c280 61 64 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20 49 ad>1 ){. /* I
1c290 66 20 74 68 65 72 65 20 61 72 65 20 6f 74 68 65 f there are othe
1c2a0 72 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 r active stateme
1c2b0 6e 74 73 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 nts that belong
1c2c0 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 to this database
1c2d0 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c 65 2c 20 . ** handle,
1c2e0 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 61 20 72 downgrade to a r
1c2f0 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 ead-only transac
1c300 74 69 6f 6e 2e 20 54 68 65 20 6f 74 68 65 72 20 tion. The other
1c310 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 20 20 2a statements. *
1c320 2a 20 6d 61 79 20 73 74 69 6c 6c 20 62 65 20 72 * may still be r
1c330 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 eading from the
1c340 64 61 74 61 62 61 73 65 2e 20 20 2a 2f 0a 20 20 database. */.
1c350 20 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 downgradeAllSh
1c360 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
1c370 63 6b 73 28 70 29 3b 0a 20 20 20 20 70 2d 3e 69 cks(p);. p->i
1c380 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e 53 5f 52 nTrans = TRANS_R
1c390 45 41 44 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 EAD;. }else{.
1c3a0 20 20 2f 2a 20 49 66 20 74 68 65 20 68 61 6e 64 /* If the hand
1c3b0 6c 65 20 68 61 64 20 61 6e 79 20 6b 69 6e 64 20 le had any kind
1c3c0 6f 66 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f of transaction o
1c3d0 70 65 6e 2c 20 64 65 63 72 65 6d 65 6e 74 20 74 pen, decrement t
1c3e0 68 65 20 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 he . ** trans
1c3f0 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 6f 66 20 action count of
1c400 74 68 65 20 73 68 61 72 65 64 20 62 74 72 65 65 the shared btree
1c410 2e 20 49 66 20 74 68 65 20 74 72 61 6e 73 61 63 . If the transac
1c420 74 69 6f 6e 20 63 6f 75 6e 74 20 0a 20 20 20 20 tion count .
1c430 2a 2a 20 72 65 61 63 68 65 73 20 30 2c 20 73 65 ** reaches 0, se
1c440 74 20 74 68 65 20 73 68 61 72 65 64 20 73 74 61 t the shared sta
1c450 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e 45 te to TRANS_NONE
1c460 2e 20 54 68 65 20 75 6e 6c 6f 63 6b 42 74 72 65 . The unlockBtre
1c470 65 49 66 55 6e 75 73 65 64 28 29 0a 20 20 20 20 eIfUnused().
1c480 2a 2a 20 63 61 6c 6c 20 62 65 6c 6f 77 20 77 69 ** call below wi
1c490 6c 6c 20 75 6e 6c 6f 63 6b 20 74 68 65 20 70 61 ll unlock the pa
1c4a0 67 65 72 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28 ger. */. if(
1c4b0 20 70 2d 3e 69 6e 54 72 61 6e 73 21 3d 54 52 41 p->inTrans!=TRA
1c4c0 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 20 NS_NONE ){.
1c4d0 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 43 clearAllSharedC
1c4e0 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 70 acheTableLocks(p
1c4f0 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 54 );. pBt->nT
1c500 72 61 6e 73 61 63 74 69 6f 6e 2d 2d 3b 0a 20 20 ransaction--;.
1c510 20 20 20 20 69 66 28 20 30 3d 3d 70 42 74 2d 3e if( 0==pBt->
1c520 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b 0a nTransaction ){.
1c530 20 20 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 pBt->inT
1c540 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 ransaction = TRA
1c550 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 20 20 7d NS_NONE;. }
1c560 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 . }.. /* S
1c570 65 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 et the current t
1c580 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 61 74 65 ransaction state
1c590 20 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e 45 20 61 to TRANS_NONE a
1c5a0 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 0a 20 nd unlock the .
1c5b0 20 20 20 2a 2a 20 70 61 67 65 72 20 69 66 20 74 ** pager if t
1c5c0 68 69 73 20 63 61 6c 6c 20 63 6c 6f 73 65 64 20 his call closed
1c5d0 74 68 65 20 6f 6e 6c 79 20 72 65 61 64 20 6f 72 the only read or
1c5e0 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
1c5f0 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 70 2d 3e 69 on. */. p->i
1c600 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e nTrans = TRANS_N
1c610 4f 4e 45 3b 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 ONE;. unlockB
1c620 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 treeIfUnused(pBt
1c630 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 49 );. }.. btreeI
1c640 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 7d 0a 0a ntegrity(p);.}..
1c650 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 74 68 65 /*.** Commit the
1c660 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 75 72 transaction cur
1c670 72 65 6e 74 6c 79 20 69 6e 20 70 72 6f 67 72 65 rently in progre
1c680 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ss..**.** This r
1c690 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 outine implement
1c6a0 73 20 74 68 65 20 73 65 63 6f 6e 64 20 70 68 61 s the second pha
1c6b0 73 65 20 6f 66 20 61 20 32 2d 70 68 61 73 65 20 se of a 2-phase
1c6c0 63 6f 6d 6d 69 74 2e 20 20 54 68 65 0a 2a 2a 20 commit. The.**
1c6d0 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d sqlite3BtreeComm
1c6e0 69 74 50 68 61 73 65 4f 6e 65 28 29 20 72 6f 75 itPhaseOne() rou
1c6f0 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 66 69 tine does the fi
1c700 72 73 74 20 70 68 61 73 65 20 61 6e 64 20 73 68 rst phase and sh
1c710 6f 75 6c 64 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b ould.** be invok
1c720 65 64 20 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c ed prior to call
1c730 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ing this routine
1c740 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 42 74 . The sqlite3Bt
1c750 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e reeCommitPhaseOn
1c760 65 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64 e().** routine d
1c770 69 64 20 61 6c 6c 20 74 68 65 20 77 6f 72 6b 20 id all the work
1c780 6f 66 20 77 72 69 74 69 6e 67 20 69 6e 66 6f 72 of writing infor
1c790 6d 61 74 69 6f 6e 20 6f 75 74 20 74 6f 20 64 69 mation out to di
1c7a0 73 6b 20 61 6e 64 20 66 6c 75 73 68 69 6e 67 20 sk and flushing
1c7b0 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 20 the.** contents
1c7c0 73 6f 20 74 68 61 74 20 74 68 65 79 20 61 72 65 so that they are
1c7d0 20 77 72 69 74 74 65 6e 20 6f 6e 74 6f 20 74 68 written onto th
1c7e0 65 20 64 69 73 6b 20 70 6c 61 74 74 65 72 2e 20 e disk platter.
1c7f0 20 41 6c 6c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 All this.** rou
1c800 74 69 6e 65 20 68 61 73 20 74 6f 20 64 6f 20 69 tine has to do i
1c810 73 20 64 65 6c 65 74 65 20 6f 72 20 74 72 75 6e s delete or trun
1c820 63 61 74 65 20 6f 72 20 7a 65 72 6f 20 74 68 65 cate or zero the
1c830 20 68 65 61 64 65 72 20 69 6e 20 74 68 65 0a 2a header in the.*
1c840 2a 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a * the rollback j
1c850 6f 75 72 6e 61 6c 20 28 77 68 69 63 68 20 63 61 ournal (which ca
1c860 75 73 65 73 20 74 68 65 20 74 72 61 6e 73 61 63 uses the transac
1c870 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d 69 74 29 20 tion to commit)
1c880 61 6e 64 0a 2a 2a 20 64 72 6f 70 20 6c 6f 63 6b and.** drop lock
1c890 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c s..**.** Normall
1c8a0 79 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f y, if an error o
1c8b0 63 63 75 72 73 20 77 68 69 6c 65 20 74 68 65 20 ccurs while the
1c8c0 70 61 67 65 72 20 6c 61 79 65 72 20 69 73 20 61 pager layer is a
1c8d0 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 0a 2a 2a ttempting to .**
1c8e0 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 20 75 6e finalize the un
1c8f0 64 65 72 6c 79 69 6e 67 20 6a 6f 75 72 6e 61 6c derlying journal
1c900 20 66 69 6c 65 2c 20 74 68 69 73 20 66 75 6e 63 file, this func
1c910 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 61 6e 20 tion returns an
1c920 65 72 72 6f 72 20 61 6e 64 0a 2a 2a 20 74 68 65 error and.** the
1c930 20 75 70 70 65 72 20 6c 61 79 65 72 20 77 69 6c upper layer wil
1c940 6c 20 61 74 74 65 6d 70 74 20 61 20 72 6f 6c 6c l attempt a roll
1c950 62 61 63 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 back. However, i
1c960 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 f the second arg
1c970 75 6d 65 6e 74 0a 2a 2a 20 69 73 20 6e 6f 6e 2d ument.** is non-
1c980 7a 65 72 6f 20 74 68 65 6e 20 74 68 69 73 20 62 zero then this b
1c990 2d 74 72 65 65 20 74 72 61 6e 73 61 63 74 69 6f -tree transactio
1c9a0 6e 20 69 73 20 70 61 72 74 20 6f 66 20 61 20 6d n is part of a m
1c9b0 75 6c 74 69 2d 66 69 6c 65 20 0a 2a 2a 20 74 72 ulti-file .** tr
1c9c0 61 6e 73 61 63 74 69 6f 6e 2e 20 49 6e 20 74 68 ansaction. In th
1c9d0 69 73 20 63 61 73 65 2c 20 74 68 65 20 74 72 61 is case, the tra
1c9e0 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 nsaction has alr
1c9f0 65 61 64 79 20 62 65 65 6e 20 63 6f 6d 6d 69 74 eady been commit
1ca00 74 65 64 20 0a 2a 2a 20 28 62 79 20 64 65 6c 65 ted .** (by dele
1ca10 74 69 6e 67 20 61 20 6d 61 73 74 65 72 20 6a 6f ting a master jo
1ca20 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 6e 64 20 urnal file) and
1ca30 74 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 the caller will
1ca40 69 67 6e 6f 72 65 20 74 68 69 73 20 0a 2a 2a 20 ignore this .**
1ca50 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e functions return
1ca60 20 63 6f 64 65 2e 20 53 6f 2c 20 65 76 65 6e 20 code. So, even
1ca70 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 if an error occu
1ca80 72 73 20 69 6e 20 74 68 65 20 70 61 67 65 72 20 rs in the pager
1ca90 6c 61 79 65 72 2c 0a 2a 2a 20 72 65 73 65 74 20 layer,.** reset
1caa0 74 68 65 20 62 2d 74 72 65 65 20 6f 62 6a 65 63 the b-tree objec
1cab0 74 73 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 ts internal stat
1cac0 65 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 e to indicate th
1cad0 61 74 20 74 68 65 20 77 72 69 74 65 0a 2a 2a 20 at the write.**
1cae0 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 transaction has
1caf0 62 65 65 6e 20 63 6c 6f 73 65 64 2e 20 54 68 69 been closed. Thi
1cb00 73 20 69 73 20 71 75 69 74 65 20 73 61 66 65 2c s is quite safe,
1cb10 20 61 73 20 74 68 65 20 70 61 67 65 72 20 77 69 as the pager wi
1cb20 6c 6c 20 68 61 76 65 0a 2a 2a 20 74 72 61 6e 73 ll have.** trans
1cb30 69 74 69 6f 6e 65 64 20 74 6f 20 74 68 65 20 65 itioned to the e
1cb40 72 72 6f 72 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a rror state..**.*
1cb50 2a 20 54 68 69 73 20 77 69 6c 6c 20 72 65 6c 65 * This will rele
1cb60 61 73 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f ase the write lo
1cb70 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ck on the databa
1cb80 73 65 20 66 69 6c 65 2e 20 20 49 66 20 74 68 65 se file. If the
1cb90 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 61 63 74 re.** are no act
1cba0 69 76 65 20 63 75 72 73 6f 72 73 2c 20 69 74 20 ive cursors, it
1cbb0 61 6c 73 6f 20 72 65 6c 65 61 73 65 73 20 74 68 also releases th
1cbc0 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a e read lock..*/.
1cbd0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
1cbe0 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 42 CommitPhaseTwo(B
1cbf0 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 62 43 6c tree *p, int bCl
1cc00 65 61 6e 75 70 29 7b 0a 0a 20 20 69 66 28 20 70 eanup){.. if( p
1cc10 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
1cc20 5f 4e 4f 4e 45 20 29 20 72 65 74 75 72 6e 20 53 _NONE ) return S
1cc30 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 QLITE_OK;. sqli
1cc40 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
1cc50 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 ;. btreeIntegri
1cc60 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 ty(p);.. /* If
1cc70 74 68 65 20 68 61 6e 64 6c 65 20 68 61 73 20 61 the handle has a
1cc80 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
1cc90 6f 6e 20 6f 70 65 6e 2c 20 63 6f 6d 6d 69 74 20 on open, commit
1cca0 74 68 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 the shared-btree
1ccb0 73 20 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 s . ** transact
1ccc0 69 6f 6e 20 61 6e 64 20 73 65 74 20 74 68 65 20 ion and set the
1ccd0 73 68 61 72 65 64 20 73 74 61 74 65 20 74 6f 20 shared state to
1cce0 54 52 41 4e 53 5f 52 45 41 44 2e 0a 20 20 2a 2f TRANS_READ.. */
1ccf0 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e . if( p->inTran
1cd00 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 s==TRANS_WRITE )
1cd10 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 {. int rc;.
1cd20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1cd30 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 61 73 = p->pBt;. as
1cd40 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 sert( pBt->inTra
1cd50 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
1cd60 57 52 49 54 45 20 29 3b 0a 20 20 20 20 61 73 73 WRITE );. ass
1cd70 65 72 74 28 20 70 42 74 2d 3e 6e 54 72 61 6e 73 ert( pBt->nTrans
1cd80 61 63 74 69 6f 6e 3e 30 20 29 3b 0a 20 20 20 20 action>0 );.
1cd90 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
1cda0 72 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 rCommitPhaseTwo(
1cdb0 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 pBt->pPager);.
1cdc0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1cdd0 5f 4f 4b 20 26 26 20 62 43 6c 65 61 6e 75 70 3d _OK && bCleanup=
1cde0 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 =0 ){. sqli
1cdf0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
1ce00 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 ;. return r
1ce10 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 42 74 c;. }. pBt
1ce20 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 ->inTransaction
1ce30 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b 0a 20 20 = TRANS_READ;.
1ce40 20 20 62 74 72 65 65 43 6c 65 61 72 48 61 73 43 btreeClearHasC
1ce50 6f 6e 74 65 6e 74 28 70 42 74 29 3b 0a 20 20 7d ontent(pBt);. }
1ce60 0a 0a 20 20 62 74 72 65 65 45 6e 64 54 72 61 6e .. btreeEndTran
1ce70 73 61 63 74 69 6f 6e 28 70 29 3b 0a 20 20 73 71 saction(p);. sq
1ce80 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
1ce90 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c p);. return SQL
1cea0 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
1ceb0 20 44 6f 20 62 6f 74 68 20 70 68 61 73 65 73 20 Do both phases
1cec0 6f 66 20 61 20 63 6f 6d 6d 69 74 2e 0a 2a 2f 0a of a commit..*/.
1ced0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
1cee0 43 6f 6d 6d 69 74 28 42 74 72 65 65 20 2a 70 29 Commit(Btree *p)
1cef0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 {. int rc;. sq
1cf00 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
1cf10 70 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 p);. rc = sqlit
1cf20 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 e3BtreeCommitPha
1cf30 73 65 4f 6e 65 28 70 2c 20 30 29 3b 0a 20 20 69 seOne(p, 0);. i
1cf40 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1cf50 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c ){. rc = sql
1cf60 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
1cf70 68 61 73 65 54 77 6f 28 70 2c 20 30 29 3b 0a 20 haseTwo(p, 0);.
1cf80 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 }. sqlite3Btre
1cf90 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
1cfa0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1cfb0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 This routine se
1cfc0 74 73 20 74 68 65 20 73 74 61 74 65 20 74 6f 20 ts the state to
1cfd0 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 61 6e 64 CURSOR_FAULT and
1cfe0 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a 20 63 6f the error.** co
1cff0 64 65 20 74 6f 20 65 72 72 43 6f 64 65 20 66 6f de to errCode fo
1d000 72 20 65 76 65 72 79 20 63 75 72 73 6f 72 20 6f r every cursor o
1d010 6e 20 42 74 53 68 61 72 65 64 20 74 68 61 74 20 n BtShared that
1d020 70 42 74 72 65 65 0a 2a 2a 20 72 65 66 65 72 65 pBtree.** refere
1d030 6e 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 45 76 65 72 nces..**.** Ever
1d040 79 20 63 75 72 73 6f 72 20 69 73 20 74 72 69 70 y cursor is trip
1d050 70 65 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 63 ped, including c
1d060 75 72 73 6f 72 73 20 74 68 61 74 20 62 65 6c 6f ursors that belo
1d070 6e 67 0a 2a 2a 20 74 6f 20 6f 74 68 65 72 20 64 ng.** to other d
1d080 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
1d090 6f 6e 73 20 74 68 61 74 20 68 61 70 70 65 6e 20 ons that happen
1d0a0 74 6f 20 62 65 20 73 68 61 72 69 6e 67 0a 2a 2a to be sharing.**
1d0b0 20 74 68 65 20 63 61 63 68 65 20 77 69 74 68 20 the cache with
1d0c0 70 42 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 pBtree..**.** Th
1d0d0 69 73 20 72 6f 75 74 69 6e 65 20 67 65 74 73 20 is routine gets
1d0e0 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 72 6f called when a ro
1d0f0 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 2e 0a 2a llback occurs..*
1d100 2a 20 41 6c 6c 20 63 75 72 73 6f 72 73 20 75 73 * All cursors us
1d110 69 6e 67 20 74 68 65 20 73 61 6d 65 20 63 61 63 ing the same cac
1d120 68 65 20 6d 75 73 74 20 62 65 20 74 72 69 70 70 he must be tripp
1d130 65 64 0a 2a 2a 20 74 6f 20 70 72 65 76 65 6e 74 ed.** to prevent
1d140 20 74 68 65 6d 20 66 72 6f 6d 20 74 72 79 69 6e them from tryin
1d150 67 20 74 6f 20 75 73 65 20 74 68 65 20 62 74 72 g to use the btr
1d160 65 65 20 61 66 74 65 72 0a 2a 2a 20 74 68 65 20 ee after.** the
1d170 72 6f 6c 6c 62 61 63 6b 2e 20 20 54 68 65 20 72 rollback. The r
1d180 6f 6c 6c 62 61 63 6b 20 6d 61 79 20 68 61 76 65 ollback may have
1d190 20 64 65 6c 65 74 65 64 20 74 61 62 6c 65 73 0a deleted tables.
1d1a0 2a 2a 20 6f 72 20 6d 6f 76 65 64 20 72 6f 6f 74 ** or moved root
1d1b0 20 70 61 67 65 73 2c 20 73 6f 20 69 74 20 69 73 pages, so it is
1d1c0 20 6e 6f 74 20 73 75 66 66 69 63 69 65 6e 74 20 not sufficient
1d1d0 74 6f 0a 2a 2a 20 73 61 76 65 20 74 68 65 20 73 to.** save the s
1d1e0 74 61 74 65 20 6f 66 20 74 68 65 20 63 75 72 73 tate of the curs
1d1f0 6f 72 2e 20 20 54 68 65 20 63 75 72 73 6f 72 20 or. The cursor
1d200 6d 75 73 74 20 62 65 0a 2a 2a 20 69 6e 76 61 6c must be.** inval
1d210 69 64 61 74 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 idated..*/.void
1d220 73 71 6c 69 74 65 33 42 74 72 65 65 54 72 69 70 sqlite3BtreeTrip
1d230 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 72 65 65 AllCursors(Btree
1d240 20 2a 70 42 74 72 65 65 2c 20 69 6e 74 20 65 72 *pBtree, int er
1d250 72 43 6f 64 65 29 7b 0a 20 20 42 74 43 75 72 73 rCode){. BtCurs
1d260 6f 72 20 2a 70 3b 0a 20 20 69 66 28 20 70 42 74 or *p;. if( pBt
1d270 72 65 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b ree==0 ) return;
1d280 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
1d290 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
1d2a0 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e 70 42 for(p=pBtree->pB
1d2b0 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 t->pCursor; p; p
1d2c0 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 =p->pNext){.
1d2d0 69 6e 74 20 69 3b 0a 20 20 20 20 73 71 6c 69 74 int i;. sqlit
1d2e0 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 72 73 e3BtreeClearCurs
1d2f0 6f 72 28 70 29 3b 0a 20 20 20 20 70 2d 3e 65 53 or(p);. p->eS
1d300 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 46 41 tate = CURSOR_FA
1d310 55 4c 54 3b 0a 20 20 20 20 70 2d 3e 73 6b 69 70 ULT;. p->skip
1d320 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b 0a Next = errCode;.
1d330 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d for(i=0; i<=
1d340 70 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 7b 0a p->iPage; i++){.
1d350 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
1d360 65 28 70 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b e(p->apPage[i]);
1d370 0a 20 20 20 20 20 20 70 2d 3e 61 70 50 61 67 65 . p->apPage
1d380 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 [i] = 0;. }.
1d390 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 }. sqlite3Btre
1d3a0 65 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a eLeave(pBtree);.
1d3b0 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 }../*.** Rollbac
1d3c0 6b 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f k the transactio
1d3d0 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 20 20 n in progress.
1d3e0 41 6c 6c 20 63 75 72 73 6f 72 73 20 77 69 6c 6c All cursors will
1d3f0 20 62 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 65 64 be.** invalided
1d400 20 62 79 20 74 68 69 73 20 6f 70 65 72 61 74 69 by this operati
1d410 6f 6e 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 on. Any attempt
1d420 20 74 6f 20 75 73 65 20 61 20 63 75 72 73 6f 72 to use a cursor
1d430 0a 2a 2a 20 74 68 61 74 20 77 61 73 20 6f 70 65 .** that was ope
1d440 6e 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 n at the beginni
1d450 6e 67 20 6f 66 20 74 68 69 73 20 6f 70 65 72 61 ng of this opera
1d460 74 69 6f 6e 20 77 69 6c 6c 20 72 65 73 75 6c 74 tion will result
1d470 0a 2a 2a 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e .** in an error.
1d480 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c .**.** This will
1d490 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 release the wri
1d4a0 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 te lock on the d
1d4b0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 atabase file. I
1d4c0 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e f there.** are n
1d4d0 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 o active cursors
1d4e0 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 , it also releas
1d4f0 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b es the read lock
1d500 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1d510 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 74 BtreeRollback(Bt
1d520 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 70 ree *p, int trip
1d530 43 6f 64 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b Code){. int rc;
1d540 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
1d550 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d = p->pBt;. Mem
1d560 50 61 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 Page *pPage1;..
1d570 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1d580 65 72 28 70 29 3b 0a 20 20 69 66 28 20 74 72 69 er(p);. if( tri
1d590 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b pCode==SQLITE_OK
1d5a0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 74 72 69 ){. rc = tri
1d5b0 70 43 6f 64 65 20 3d 20 73 61 76 65 41 6c 6c 43 pCode = saveAllC
1d5c0 75 72 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 ursors(pBt, 0, 0
1d5d0 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
1d5e0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1d5f0 20 20 7d 0a 20 20 69 66 28 20 74 72 69 70 43 6f }. if( tripCo
1d600 64 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 de ){. sqlite
1d610 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 3BtreeTripAllCur
1d620 73 6f 72 73 28 70 2c 20 74 72 69 70 43 6f 64 65 sors(p, tripCode
1d630 29 3b 0a 20 20 7d 0a 20 20 62 74 72 65 65 49 6e );. }. btreeIn
1d640 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 69 tegrity(p);.. i
1d650 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
1d660 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 RANS_WRITE ){.
1d670 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 20 20 20 int rc2;..
1d680 61 73 73 65 72 74 28 20 54 52 41 4e 53 5f 57 52 assert( TRANS_WR
1d690 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 72 61 6e ITE==pBt->inTran
1d6a0 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 20 20 72 saction );. r
1d6b0 63 32 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 c2 = sqlite3Page
1d6c0 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 2d 3e 70 rRollback(pBt->p
1d6d0 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 Pager);. if(
1d6e0 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc2!=SQLITE_OK )
1d6f0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 63 32 {. rc = rc2
1d700 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
1d710 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6d 61 79 The rollback may
1d720 20 68 61 76 65 20 64 65 73 74 72 6f 79 65 64 20 have destroyed
1d730 74 68 65 20 70 50 61 67 65 31 2d 3e 61 44 61 74 the pPage1->aDat
1d740 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a 20 20 20 a value. So.
1d750 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 65 47 65 ** call btreeGe
1d760 74 50 61 67 65 28 29 20 6f 6e 20 70 61 67 65 20 tPage() on page
1d770 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 6b 65 0a 1 again to make.
1d780 20 20 20 20 2a 2a 20 73 75 72 65 20 70 50 61 67 ** sure pPag
1d790 65 31 2d 3e 61 44 61 74 61 20 69 73 20 73 65 74 e1->aData is set
1d7a0 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a 2f 0a 20 correctly. */.
1d7b0 20 20 20 69 66 28 20 62 74 72 65 65 47 65 74 50 if( btreeGetP
1d7c0 61 67 65 28 70 42 74 2c 20 31 2c 20 26 70 50 61 age(pBt, 1, &pPa
1d7d0 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 54 45 5f ge1, 0)==SQLITE_
1d7e0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 OK ){. int
1d7f0 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 nPage = get4byte
1d800 28 32 38 2b 28 75 38 2a 29 70 50 61 67 65 31 2d (28+(u8*)pPage1-
1d810 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 74 >aData);. t
1d820 65 73 74 63 61 73 65 28 20 6e 50 61 67 65 3d 3d estcase( nPage==
1d830 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 0 );. if( n
1d840 50 61 67 65 3d 3d 30 20 29 20 73 71 6c 69 74 65 Page==0 ) sqlite
1d850 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 3PagerPagecount(
1d860 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 6e 50 pBt->pPager, &nP
1d870 61 67 65 29 3b 0a 20 20 20 20 20 20 74 65 73 74 age);. test
1d880 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 61 67 65 case( pBt->nPage
1d890 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 20 20 20 !=nPage );.
1d8a0 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 pBt->nPage = nP
1d8b0 61 67 65 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 age;. relea
1d8c0 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a sePage(pPage1);.
1d8d0 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
1d8e0 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 ( countValidCurs
1d8f0 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d 30 20 29 ors(pBt, 1)==0 )
1d900 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 ;. pBt->inTra
1d910 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 nsaction = TRANS
1d920 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 _READ;. btree
1d930 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
1d940 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 pBt);. }.. btr
1d950 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e eeEndTransaction
1d960 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 (p);. sqlite3Bt
1d970 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
1d980 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
1d990 2a 2a 20 53 74 61 72 74 20 61 20 73 74 61 74 65 ** Start a state
1d9a0 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 ment subtransact
1d9b0 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 61 6e ion. The subtran
1d9c0 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 72 saction can be r
1d9d0 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 69 6e olled.** back in
1d9e0 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 dependently of t
1d9f0 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 he main transact
1da00 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 73 74 ion. You must st
1da10 61 72 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f art a transactio
1da20 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 74 61 n .** before sta
1da30 72 74 69 6e 67 20 61 20 73 75 62 74 72 61 6e 73 rting a subtrans
1da40 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 action. The subt
1da50 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 6e ransaction is en
1da60 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ded automaticall
1da70 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d 61 69 y .** if the mai
1da80 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f n transaction co
1da90 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 20 62 mmits or rolls b
1daa0 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 65 ack..**.** State
1dab0 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 ment subtransact
1dac0 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 61 72 ions are used ar
1dad0 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 61 6c 20 ound individual
1dae0 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a SQL statements.*
1daf0 2a 20 74 68 61 74 20 61 72 65 20 63 6f 6e 74 61 * that are conta
1db00 69 6e 65 64 20 77 69 74 68 69 6e 20 61 20 42 45 ined within a BE
1db10 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 6c 6f GIN...COMMIT blo
1db20 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 74 72 ck. If a constr
1db30 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 aint.** error oc
1db40 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 curs within the
1db50 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 20 65 statement, the e
1db60 66 66 65 63 74 20 6f 66 20 74 68 61 74 20 6f 6e ffect of that on
1db70 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 63 e statement.** c
1db80 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 an be rolled bac
1db90 6b 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 k without having
1dba0 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 to rollback the
1dbb0 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74 entire transact
1dbc0 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 74 61 ion..**.** A sta
1dbd0 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 6e 73 tement sub-trans
1dbe0 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65 6d action is implem
1dbf0 65 6e 74 65 64 20 61 73 20 61 6e 20 61 6e 6f 6e ented as an anon
1dc00 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 2e ymous savepoint.
1dc10 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 70 61 The.** value pa
1dc20 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f ssed as the seco
1dc30 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 nd parameter is
1dc40 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 the total number
1dc50 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 2c 0a of savepoints,.
1dc60 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 ** including the
1dc70 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 20 73 new anonymous s
1dc80 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e 20 6f avepoint, open o
1dc90 6e 20 74 68 65 20 42 2d 54 72 65 65 2e 20 69 2e n the B-Tree. i.
1dca0 65 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 e. if there.** a
1dcb0 72 65 20 6e 6f 20 61 63 74 69 76 65 20 73 61 76 re no active sav
1dcc0 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f 20 6f epoints and no o
1dcd0 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 2d 74 ther statement-t
1dce0 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 65 6e ransactions open
1dcf0 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e 74 20 ,.** iStatement
1dd00 69 73 20 31 2e 20 54 68 69 73 20 61 6e 6f 6e 79 is 1. This anony
1dd10 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 20 63 mous savepoint c
1dd20 61 6e 20 62 65 20 72 65 6c 65 61 73 65 64 20 6f an be released o
1dd30 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 2a 2a r rolled back.**
1dd40 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 using the sqlit
1dd50 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 e3BtreeSavepoint
1dd60 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a () function..*/.
1dd70 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
1dd80 42 65 67 69 6e 53 74 6d 74 28 42 74 72 65 65 20 BeginStmt(Btree
1dd90 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 65 6d 65 *p, int iStateme
1dda0 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 nt){. int rc;.
1ddb0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
1ddc0 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 p->pBt;. sqlit
1ddd0 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
1dde0 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e . assert( p->in
1ddf0 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 Trans==TRANS_WRI
1de00 54 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TE );. assert(
1de10 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
1de20 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d BTS_READ_ONLY)=
1de30 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
1de40 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 3b 0a iStatement>0 );.
1de50 20 20 61 73 73 65 72 74 28 20 69 53 74 61 74 65 assert( iState
1de60 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 61 76 ment>p->db->nSav
1de70 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 73 65 epoint );. asse
1de80 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 rt( pBt->inTrans
1de90 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
1dea0 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 20 74 ITE );. /* At t
1deb0 68 65 20 70 61 67 65 72 20 6c 65 76 65 6c 2c 20 he pager level,
1dec0 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e a statement tran
1ded0 73 61 63 74 69 6f 6e 20 69 73 20 61 20 73 61 76 saction is a sav
1dee0 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 2a 2a epoint with. **
1def0 20 61 6e 20 69 6e 64 65 78 20 67 72 65 61 74 65 an index greate
1df00 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 65 70 r than all savep
1df10 6f 69 6e 74 73 20 63 72 65 61 74 65 64 20 65 78 oints created ex
1df20 70 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 0a 20 plicitly using.
1df30 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e ** SQL statemen
1df40 74 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 67 61 ts. It is illega
1df50 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c 65 61 l to open, relea
1df60 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 61 se or rollback a
1df70 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 61 76 ny. ** such sav
1df80 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 74 68 epoints while th
1df90 65 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e e statement tran
1dfa0 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e saction savepoin
1dfb0 74 20 69 73 20 61 63 74 69 76 65 2e 0a 20 20 2a t is active.. *
1dfc0 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 /. rc = sqlite3
1dfd0 50 61 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 69 PagerOpenSavepoi
1dfe0 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 nt(pBt->pPager,
1dff0 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 20 73 iStatement);. s
1e000 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
1e010 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
1e020 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 ;.}../*.** The s
1e030 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 econd argument t
1e040 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c o this function,
1e050 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 20 53 op, is always S
1e060 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
1e070 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f 49 4e K.** or SAVEPOIN
1e080 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 73 20 T_RELEASE. This
1e090 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 72 20 function either
1e0a0 72 65 6c 65 61 73 65 73 20 6f 72 20 72 6f 6c 6c releases or roll
1e0b0 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 73 61 s back the.** sa
1e0c0 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 66 69 vepoint identifi
1e0d0 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 ed by parameter
1e0e0 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 70 65 iSavepoint, depe
1e0f0 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c nding on the val
1e100 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a 2a 2a ue .** of op..**
1e110 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 53 .** Normally, iS
1e120 61 76 65 70 6f 69 6e 74 20 69 73 20 67 72 65 61 avepoint is grea
1e130 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 ter than or equa
1e140 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 65 76 l to zero. Howev
1e150 65 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a 2a 20 er, if op is.**
1e160 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 SAVEPOINT_ROLLBA
1e170 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 70 6f CK, then iSavepo
1e180 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 int may also be
1e190 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 -1. In this case
1e1a0 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 the .** content
1e1b0 73 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20 s of the entire
1e1c0 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 20 transaction are
1e1d0 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 69 rolled back. Thi
1e1e0 73 20 69 73 20 64 69 66 66 65 72 65 6e 74 0a 2a s is different.*
1e1f0 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 * from a normal
1e200 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c transaction roll
1e210 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f 63 6b back, as no lock
1e220 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 20 61 s are released a
1e230 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 nd the.** transa
1e240 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 6f 70 ction remains op
1e250 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 en..*/.int sqlit
1e260 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 e3BtreeSavepoint
1e270 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6f (Btree *p, int o
1e280 70 2c 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e p, int iSavepoin
1e290 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 t){. int rc = S
1e2a0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 QLITE_OK;. if(
1e2b0 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d p && p->inTrans=
1e2c0 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a =TRANS_WRITE ){.
1e2d0 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
1e2e0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 t = p->pBt;.
1e2f0 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 56 45 assert( op==SAVE
1e300 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 7c 7c POINT_RELEASE ||
1e310 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 op==SAVEPOINT_R
1e320 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 20 61 OLLBACK );. a
1e330 73 73 65 72 74 28 20 69 53 61 76 65 70 6f 69 6e ssert( iSavepoin
1e340 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 70 6f t>=0 || (iSavepo
1e350 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d 3d 53 int==-1 && op==S
1e360 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
1e370 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 K) );. sqlite
1e380 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
1e390 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1e3a0 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 28 70 PagerSavepoint(p
1e3b0 42 74 2d 3e 70 50 61 67 65 72 2c 20 6f 70 2c 20 Bt->pPager, op,
1e3c0 69 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 20 iSavepoint);.
1e3d0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1e3e0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 OK ){. if(
1e3f0 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 20 iSavepoint<0 &&
1e400 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
1e410 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 BTS_INITIALLY_E
1e420 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 20 MPTY)!=0 ){.
1e430 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d pBt->nPage =
1e440 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 0;. }.
1e450 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 rc = newDataba
1e460 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 70 se(pBt);. p
1e470 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 34 Bt->nPage = get4
1e480 62 79 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 70 byte(28 + pBt->p
1e490 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a 0a Page1->aData);..
1e4a0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
1e4b0 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 20 77 abase size was w
1e4c0 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 ritten into the
1e4d0 6f 66 66 73 65 74 20 32 38 20 6f 66 20 74 68 65 offset 28 of the
1e4e0 20 68 65 61 64 65 72 0a 20 20 20 20 20 20 2a 2a header. **
1e4f0 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 when the transa
1e500 63 74 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 73 ction started, s
1e510 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 74 o we know that t
1e520 68 65 20 76 61 6c 75 65 20 61 74 20 6f 66 66 73 he value at offs
1e530 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 69 et. ** 28 i
1e540 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 20 s nonzero. */.
1e550 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
1e560 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 20 >nPage>0 );.
1e570 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 }. sqlite3Btr
1e580 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a eeLeave(p);. }.
1e590 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1e5a0 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e /*.** Create a n
1e5b0 65 77 20 63 75 72 73 6f 72 20 66 6f 72 20 74 68 ew cursor for th
1e5c0 65 20 42 54 72 65 65 20 77 68 6f 73 65 20 72 6f e BTree whose ro
1e5d0 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 70 61 67 ot is on the pag
1e5e0 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 20 e.** iTable. If
1e5f0 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 73 a read-only curs
1e600 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 2c or is requested,
1e610 20 69 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 it is assumed t
1e620 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 hat.** the calle
1e630 72 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 74 r already has at
1e640 20 6c 65 61 73 74 20 61 20 72 65 61 64 2d 6f 6e least a read-on
1e650 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f ly transaction o
1e660 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 61 pen.** on the da
1e670 74 61 62 61 73 65 20 61 6c 72 65 61 64 79 2e 20 tabase already.
1e680 49 66 20 61 20 77 72 69 74 65 2d 63 75 72 73 6f If a write-curso
1e690 72 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 r is requested,
1e6a0 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c then.** the call
1e6b0 65 72 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f er is assumed to
1e6c0 20 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 have an open wr
1e6d0 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ite transaction.
1e6e0 0a 2a 2a 0a 2a 2a 20 49 66 20 77 72 46 6c 61 67 .**.** If wrFlag
1e6f0 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 20 63 75 ==0, then the cu
1e700 72 73 6f 72 20 63 61 6e 20 6f 6e 6c 79 20 62 65 rsor can only be
1e710 20 75 73 65 64 20 66 6f 72 20 72 65 61 64 69 6e used for readin
1e720 67 2e 0a 2a 2a 20 49 66 20 77 72 46 6c 61 67 3d g..** If wrFlag=
1e730 3d 31 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 =1, then the cur
1e740 73 6f 72 20 63 61 6e 20 62 65 20 75 73 65 64 20 sor can be used
1e750 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 20 66 for reading or f
1e760 6f 72 0a 2a 2a 20 77 72 69 74 69 6e 67 20 69 66 or.** writing if
1e770 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e other condition
1e780 73 20 66 6f 72 20 77 72 69 74 69 6e 67 20 61 72 s for writing ar
1e790 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 54 68 65 e also met. The
1e7a0 73 65 0a 2a 2a 20 61 72 65 20 74 68 65 20 63 6f se.** are the co
1e7b0 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 nditions that mu
1e7c0 73 74 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 st be met in ord
1e7d0 65 72 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 er for writing t
1e7e0 6f 0a 2a 2a 20 62 65 20 61 6c 6c 6f 77 65 64 3a o.** be allowed:
1e7f0 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 .**.** 1: The c
1e800 75 72 73 6f 72 20 6d 75 73 74 20 68 61 76 65 20 ursor must have
1e810 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 been opened with
1e820 20 77 72 46 6c 61 67 3d 3d 31 0a 2a 2a 0a 2a 2a wrFlag==1.**.**
1e830 20 32 3a 20 20 4f 74 68 65 72 20 64 61 74 61 62 2: Other datab
1e840 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 ase connections
1e850 74 68 61 74 20 73 68 61 72 65 20 74 68 65 20 73 that share the s
1e860 61 6d 65 20 70 61 67 65 72 20 63 61 63 68 65 0a ame pager cache.
1e870 2a 2a 20 20 20 20 20 62 75 74 20 77 68 69 63 68 ** but which
1e880 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 are not in the
1e890 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 READ_UNCOMMITTED
1e8a0 20 73 74 61 74 65 20 6d 61 79 20 6e 6f 74 20 68 state may not h
1e8b0 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 72 73 6f ave.** curso
1e8c0 72 73 20 6f 70 65 6e 20 77 69 74 68 20 77 72 46 rs open with wrF
1e8d0 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 20 73 61 lag==0 on the sa
1e8e0 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 68 65 72 me table. Other
1e8f0 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 68 65 20 wise.** the
1e900 63 68 61 6e 67 65 73 20 6d 61 64 65 20 62 79 20 changes made by
1e910 74 68 69 73 20 77 72 69 74 65 20 63 75 72 73 6f this write curso
1e920 72 20 77 6f 75 6c 64 20 62 65 20 76 69 73 69 62 r would be visib
1e930 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 74 68 65 le to.** the
1e940 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 69 6e read cursors in
1e950 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 61 62 the other datab
1e960 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ase connection..
1e970 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 20 64 61 **.** 3: The da
1e980 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 77 tabase must be w
1e990 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 6f 6e 20 ritable (not on
1e9a0 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 61 29 read-only media)
1e9b0 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 65 72 65 .**.** 4: There
1e9c0 20 6d 75 73 74 20 62 65 20 61 6e 20 61 63 74 69 must be an acti
1e9d0 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a ve transaction..
1e9e0 2a 2a 0a 2a 2a 20 4e 6f 20 63 68 65 63 6b 69 6e **.** No checkin
1e9f0 67 20 69 73 20 64 6f 6e 65 20 74 6f 20 6d 61 6b g is done to mak
1ea00 65 20 73 75 72 65 20 74 68 61 74 20 70 61 67 65 e sure that page
1ea10 20 69 54 61 62 6c 65 20 72 65 61 6c 6c 79 20 69 iTable really i
1ea20 73 20 74 68 65 0a 2a 2a 20 72 6f 6f 74 20 70 61 s the.** root pa
1ea30 67 65 20 6f 66 20 61 20 62 2d 74 72 65 65 2e 20 ge of a b-tree.
1ea40 20 49 66 20 69 74 20 69 73 20 6e 6f 74 2c 20 74 If it is not, t
1ea50 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 61 hen the cursor a
1ea60 63 71 75 69 72 65 64 0a 2a 2a 20 77 69 6c 6c 20 cquired.** will
1ea70 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 not work correct
1ea80 6c 79 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 ly..**.** It is
1ea90 61 73 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 assumed that the
1eaa0 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 sqlite3BtreeCur
1eab0 73 6f 72 5a 65 72 6f 28 29 20 68 61 73 20 62 65 sorZero() has be
1eac0 65 6e 20 63 61 6c 6c 65 64 0a 2a 2a 20 6f 6e 20 en called.** on
1ead0 70 43 75 72 20 74 6f 20 69 6e 69 74 69 61 6c 69 pCur to initiali
1eae0 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 73 70 ze the memory sp
1eaf0 61 63 65 20 70 72 69 6f 72 20 74 6f 20 69 6e 76 ace prior to inv
1eb00 6f 6b 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 oking this routi
1eb10 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ne..*/.static in
1eb20 74 20 62 74 72 65 65 43 75 72 73 6f 72 28 0a 20 t btreeCursor(.
1eb30 20 42 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 Btree *p,
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 2f 2a 20 54 68 65 20 62 /* The b
1eb60 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 54 tree */. int iT
1eb70 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 able,
1eb80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb90 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 20 6f 66 /* Root page of
1eba0 20 74 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 2a table to open *
1ebb0 2f 0a 20 20 69 6e 74 20 77 72 46 6c 61 67 2c 20 /. int wrFlag,
1ebc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ebd0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 20 /* 1
1ebe0 74 6f 20 77 72 69 74 65 2e 20 30 20 72 65 61 64 to write. 0 read
1ebf0 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 72 75 63 -only */. struc
1ec00 74 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 t KeyInfo *pKeyI
1ec10 6e 66 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 nfo,
1ec20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 74 /* First arg t
1ec30 6f 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 75 6e o comparison fun
1ec40 63 74 69 6f 6e 20 2a 2f 0a 20 20 42 74 43 75 72 ction */. BtCur
1ec50 73 6f 72 20 2a 70 43 75 72 20 20 20 20 20 20 20 sor *pCur
1ec60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ec70 20 20 2f 2a 20 53 70 61 63 65 20 66 6f 72 20 6e /* Space for n
1ec80 65 77 20 63 75 72 73 6f 72 20 2a 2f 0a 29 7b 0a ew cursor */.){.
1ec90 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1eca0 3d 20 70 2d 3e 70 42 74 3b 20 20 20 20 20 20 20 = p->pBt;
1ecb0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 61 72 /* Shar
1ecc0 65 64 20 62 2d 74 72 65 65 20 68 61 6e 64 6c 65 ed b-tree handle
1ecd0 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
1ece0 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 qlite3BtreeHolds
1ecf0 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 61 73 Mutex(p) );. as
1ed00 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
1ed10 7c 7c 20 77 72 46 6c 61 67 3d 3d 31 20 29 3b 0a || wrFlag==1 );.
1ed20 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
1ed30 69 6e 67 20 61 73 73 65 72 74 20 73 74 61 74 65 ing assert state
1ed40 6d 65 6e 74 73 20 76 65 72 69 66 79 20 74 68 61 ments verify tha
1ed50 74 20 69 66 20 74 68 69 73 20 69 73 20 61 20 73 t if this is a s
1ed60 68 61 72 61 62 6c 65 20 0a 20 20 2a 2a 20 62 2d harable . ** b-
1ed70 74 72 65 65 20 64 61 74 61 62 61 73 65 2c 20 74 tree database, t
1ed80 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 he connection is
1ed90 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 72 65 71 holding the req
1eda0 75 69 72 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b uired table lock
1edb0 73 2c 20 0a 20 20 2a 2a 20 61 6e 64 20 74 68 61 s, . ** and tha
1edc0 74 20 6e 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 t no other conne
1edd0 63 74 69 6f 6e 20 68 61 73 20 61 6e 79 20 6f 70 ction has any op
1ede0 65 6e 20 63 75 72 73 6f 72 20 74 68 61 74 20 63 en cursor that c
1edf0 6f 6e 66 6c 69 63 74 73 20 77 69 74 68 20 0a 20 onflicts with .
1ee00 20 2a 2a 20 74 68 69 73 20 6c 6f 63 6b 2e 20 20 ** this lock.
1ee10 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 68 61 73 */. assert( has
1ee20 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
1ee30 4c 6f 63 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 Lock(p, iTable,
1ee40 70 4b 65 79 49 6e 66 6f 21 3d 30 2c 20 77 72 46 pKeyInfo!=0, wrF
1ee50 6c 61 67 2b 31 29 20 29 3b 0a 20 20 61 73 73 65 lag+1) );. asse
1ee60 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c rt( wrFlag==0 ||
1ee70 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 !hasReadConflic
1ee80 74 73 28 70 2c 20 69 54 61 62 6c 65 29 20 29 3b ts(p, iTable) );
1ee90 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 .. /* Assert th
1eea0 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68 61 at the caller ha
1eeb0 73 20 6f 70 65 6e 65 64 20 74 68 65 20 72 65 71 s opened the req
1eec0 75 69 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f uired transactio
1eed0 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 n. */. assert(
1eee0 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 p->inTrans>TRANS
1eef0 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 72 _NONE );. asser
1ef00 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 t( wrFlag==0 ||
1ef10 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
1ef20 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 S_WRITE );. ass
1ef30 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 ert( pBt->pPage1
1ef40 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 2d && pBt->pPage1-
1ef50 3e 61 44 61 74 61 20 29 3b 0a 0a 20 20 69 66 28 >aData );.. if(
1ef60 20 4e 45 56 45 52 28 77 72 46 6c 61 67 20 26 26 NEVER(wrFlag &&
1ef70 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
1ef80 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 & BTS_READ_ONLY)
1ef90 21 3d 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 !=0) ){. retu
1efa0 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e rn SQLITE_READON
1efb0 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 77 72 LY;. }. if( wr
1efc0 46 6c 61 67 20 29 7b 0a 20 20 20 20 61 6c 6c 6f Flag ){. allo
1efd0 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 70 42 cateTempSpace(pB
1efe0 74 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d t);. if( pBt-
1eff0 3e 70 54 6d 70 53 70 61 63 65 3d 3d 30 20 29 20 >pTmpSpace==0 )
1f000 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
1f010 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 MEM;. }. if( i
1f020 54 61 62 6c 65 3d 3d 31 20 26 26 20 62 74 72 65 Table==1 && btre
1f030 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3d ePagecount(pBt)=
1f040 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 =0 ){. assert
1f050 28 20 77 72 46 6c 61 67 3d 3d 30 20 29 3b 0a 20 ( wrFlag==0 );.
1f060 20 20 20 69 54 61 62 6c 65 20 3d 20 30 3b 0a 20 iTable = 0;.
1f070 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 74 68 61 }.. /* Now tha
1f080 74 20 6e 6f 20 6f 74 68 65 72 20 65 72 72 6f 72 t no other error
1f090 73 20 63 61 6e 20 6f 63 63 75 72 2c 20 66 69 6e s can occur, fin
1f0a0 69 73 68 20 66 69 6c 6c 69 6e 67 20 69 6e 20 74 ish filling in t
1f0b0 68 65 20 42 74 43 75 72 73 6f 72 0a 20 20 2a 2a he BtCursor. **
1f0c0 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 6c variables and l
1f0d0 69 6e 6b 20 74 68 65 20 63 75 72 73 6f 72 20 69 ink the cursor i
1f0e0 6e 74 6f 20 74 68 65 20 42 74 53 68 61 72 65 64 nto the BtShared
1f0f0 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 70 43 75 list. */. pCu
1f100 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 3d 20 28 50 r->pgnoRoot = (P
1f110 67 6e 6f 29 69 54 61 62 6c 65 3b 0a 20 20 70 43 gno)iTable;. pC
1f120 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d 31 3b 0a ur->iPage = -1;.
1f130 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f pCur->pKeyInfo
1f140 20 3d 20 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 70 = pKeyInfo;. p
1f150 43 75 72 2d 3e 70 42 74 72 65 65 20 3d 20 70 3b Cur->pBtree = p;
1f160 0a 20 20 70 43 75 72 2d 3e 70 42 74 20 3d 20 70 . pCur->pBt = p
1f170 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 77 72 Bt;. assert( wr
1f180 46 6c 61 67 3d 3d 30 20 7c 7c 20 77 72 46 6c 61 Flag==0 || wrFla
1f190 67 3d 3d 42 54 43 46 5f 57 72 69 74 65 46 6c 61 g==BTCF_WriteFla
1f1a0 67 20 29 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 g );. pCur->cur
1f1b0 46 6c 61 67 73 20 3d 20 77 72 46 6c 61 67 3b 0a Flags = wrFlag;.
1f1c0 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 20 3d 20 pCur->pNext =
1f1d0 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 20 pBt->pCursor;.
1f1e0 69 66 28 20 70 43 75 72 2d 3e 70 4e 65 78 74 20 if( pCur->pNext
1f1f0 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 70 4e 65 ){. pCur->pNe
1f200 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 43 75 72 xt->pPrev = pCur
1f210 3b 0a 20 20 7d 0a 20 20 70 42 74 2d 3e 70 43 75 ;. }. pBt->pCu
1f220 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 rsor = pCur;. p
1f230 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
1f240 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
1f250 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1f260 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 ;.}.int sqlite3B
1f270 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 42 74 treeCursor(. Bt
1f280 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 ree *p,
1f290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f2a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
1f2b0 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 btree */. int
1f2c0 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 iTable,
1f2d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f2e0 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 /* Root
1f2f0 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f page of table to
1f300 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 open */. int w
1f310 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 rFlag,
1f320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f330 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 /* 1 to w
1f340 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c rite. 0 read-onl
1f350 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 y */. struct Ke
1f360 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c yInfo *pKeyInfo,
1f370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f380 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 /* First arg
1f390 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 20 2a 2f to xCompare() */
1f3a0 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
1f3b0 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
1f3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f3d0 2a 20 57 72 69 74 65 20 6e 65 77 20 63 75 72 73 * Write new curs
1f3e0 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 or here */.){.
1f3f0 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 int rc;. sqlite
1f400 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
1f410 20 20 72 63 20 3d 20 62 74 72 65 65 43 75 72 73 rc = btreeCurs
1f420 6f 72 28 70 2c 20 69 54 61 62 6c 65 2c 20 77 72 or(p, iTable, wr
1f430 46 6c 61 67 2c 20 70 4b 65 79 49 6e 66 6f 2c 20 Flag, pKeyInfo,
1f440 70 43 75 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 pCur);. sqlite3
1f450 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1f460 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1f470 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
1f480 73 69 7a 65 20 6f 66 20 61 20 42 74 43 75 72 73 size of a BtCurs
1f490 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 62 79 74 or object in byt
1f4a0 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 es..**.** This i
1f4b0 6e 74 65 72 66 61 63 65 73 20 69 73 20 6e 65 65 nterfaces is nee
1f4c0 64 65 64 20 73 6f 20 74 68 61 74 20 75 73 65 72 ded so that user
1f4d0 73 20 6f 66 20 63 75 72 73 6f 72 73 20 63 61 6e s of cursors can
1f4e0 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a 2a 2a 20 preallocate.**
1f4f0 73 75 66 66 69 63 69 65 6e 74 20 73 74 6f 72 61 sufficient stora
1f500 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 63 75 72 ge to hold a cur
1f510 73 6f 72 2e 20 20 54 68 65 20 42 74 43 75 72 73 sor. The BtCurs
1f520 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 6f 70 61 or object is opa
1f530 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 72 73 20 que.** to users
1f540 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f 74 20 64 so they cannot d
1f550 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 29 20 74 o the sizeof() t
1f560 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 68 65 79 hemselves - they
1f570 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a 20 74 68 must call.** th
1f580 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 69 is routine..*/.i
1f590 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 nt sqlite3BtreeC
1f5a0 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 64 29 7b ursorSize(void){
1f5b0 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 38 . return ROUND8
1f5c0 28 73 69 7a 65 6f 66 28 42 74 43 75 72 73 6f 72 (sizeof(BtCursor
1f5d0 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 ));.}../*.** Ini
1f5e0 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 79 20 74 tialize memory t
1f5f0 68 61 74 20 77 69 6c 6c 20 62 65 20 63 6f 6e 76 hat will be conv
1f600 65 72 74 65 64 20 69 6e 74 6f 20 61 20 42 74 43 erted into a BtC
1f610 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e 0a 2a 2a ursor object..**
1f620 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 61 .** The simple a
1f630 70 70 72 6f 61 63 68 20 68 65 72 65 20 77 6f 75 pproach here wou
1f640 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 65 74 28 ld be to memset(
1f650 29 20 74 68 65 20 65 6e 74 69 72 65 20 6f 62 6a ) the entire obj
1f660 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f 2e 20 ect.** to zero.
1f670 20 42 75 74 20 69 74 20 74 75 72 6e 73 20 6f 75 But it turns ou
1f680 74 20 74 68 61 74 20 74 68 65 20 61 70 50 61 67 t that the apPag
1f690 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 5b 5d 20 e[] and aiIdx[]
1f6a0 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 6e 6f 74 arrays.** do not
1f6b0 20 6e 65 65 64 20 74 6f 20 62 65 20 7a 65 72 6f need to be zero
1f6c0 65 64 20 61 6e 64 20 74 68 65 79 20 61 72 65 20 ed and they are
1f6d0 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 63 61 6e large, so we can
1f6e0 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a 2a 20 6f save a lot.** o
1f6f0 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 20 73 6b f run-time by sk
1f700 69 70 70 69 6e 67 20 74 68 65 20 69 6e 69 74 69 ipping the initi
1f710 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 68 6f alization of tho
1f720 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a 2a 2f 0a se elements..*/.
1f730 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 void sqlite3Btre
1f740 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 74 43 75 eCursorZero(BtCu
1f750 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d 65 6d 73 rsor *p){. mems
1f760 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 65 74 6f et(p, 0, offseto
1f770 66 28 42 74 43 75 72 73 6f 72 2c 20 69 50 61 67 f(BtCursor, iPag
1f780 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c e));.}../*.** Cl
1f790 6f 73 65 20 61 20 63 75 72 73 6f 72 2e 20 20 54 ose a cursor. T
1f7a0 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 he read lock on
1f7b0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
1f7c0 65 20 69 73 20 72 65 6c 65 61 73 65 64 0a 2a 2a e is released.**
1f7d0 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 63 when the last c
1f7e0 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 65 64 2e ursor is closed.
1f7f0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
1f800 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 treeCloseCursor(
1f810 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
1f820 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 65 . Btree *pBtree
1f830 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 65 65 3b = pCur->pBtree;
1f840 0a 20 20 69 66 28 20 70 42 74 72 65 65 20 29 7b . if( pBtree ){
1f850 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 . int i;.
1f860 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
1f870 70 43 75 72 2d 3e 70 42 74 3b 0a 20 20 20 20 73 pCur->pBt;. s
1f880 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1f890 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 73 71 (pBtree);. sq
1f8a0 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 lite3BtreeClearC
1f8b0 75 72 73 6f 72 28 70 43 75 72 29 3b 0a 20 20 20 ursor(pCur);.
1f8c0 20 69 66 28 20 70 43 75 72 2d 3e 70 50 72 65 76 if( pCur->pPrev
1f8d0 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e ){. pCur->
1f8e0 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 pPrev->pNext = p
1f8f0 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 Cur->pNext;.
1f900 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 42 74 }else{. pBt
1f910 2d 3e 70 43 75 72 73 6f 72 20 3d 20 70 43 75 72 ->pCursor = pCur
1f920 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 ->pNext;. }.
1f930 20 20 20 69 66 28 20 70 43 75 72 2d 3e 70 4e 65 if( pCur->pNe
1f940 78 74 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 xt ){. pCur
1f950 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d ->pNext->pPrev =
1f960 20 70 43 75 72 2d 3e 70 50 72 65 76 3b 0a 20 20 pCur->pPrev;.
1f970 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b }. for(i=0;
1f980 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 65 3b i<=pCur->iPage;
1f990 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 65 6c i++){. rel
1f9a0 65 61 73 65 50 61 67 65 28 70 43 75 72 2d 3e 61 easePage(pCur->a
1f9b0 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 20 7d pPage[i]);. }
1f9c0 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 . unlockBtree
1f9d0 49 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 IfUnused(pBt);.
1f9e0 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 sqlite3DbFree
1f9f0 28 70 42 74 72 65 65 2d 3e 64 62 2c 20 70 43 75 (pBtree->db, pCu
1fa00 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 r->aOverflow);.
1fa10 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 66 72 /* sqlite3_fr
1fa20 65 65 28 70 43 75 72 29 3b 20 2a 2f 0a 20 20 20 ee(pCur); */.
1fa30 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1fa40 76 65 28 70 42 74 72 65 65 29 3b 0a 20 20 7d 0a ve(pBtree);. }.
1fa50 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1fa60 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b OK;.}../*.** Mak
1fa70 65 20 73 75 72 65 20 74 68 65 20 42 74 43 75 72 e sure the BtCur
1fa80 73 6f 72 2a 20 67 69 76 65 6e 20 69 6e 20 74 68 sor* given in th
1fa90 65 20 61 72 67 75 6d 65 6e 74 20 68 61 73 20 61 e argument has a
1faa0 20 76 61 6c 69 64 0a 2a 2a 20 42 74 43 75 72 73 valid.** BtCurs
1fab0 6f 72 2e 69 6e 66 6f 20 73 74 72 75 63 74 75 72 or.info structur
1fac0 65 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 e. If it is not
1fad0 20 61 6c 72 65 61 64 79 20 76 61 6c 69 64 2c 20 already valid,
1fae0 63 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 61 72 call.** btreePar
1faf0 73 65 43 65 6c 6c 28 29 20 74 6f 20 66 69 6c 6c seCell() to fill
1fb00 20 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 it in..**.** Bt
1fb10 43 75 72 73 6f 72 2e 69 6e 66 6f 20 69 73 20 61 Cursor.info is a
1fb20 20 63 61 63 68 65 20 6f 66 20 74 68 65 20 69 6e cache of the in
1fb30 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 formation in the
1fb40 20 63 75 72 72 65 6e 74 20 63 65 6c 6c 2e 0a 2a current cell..*
1fb50 2a 20 55 73 69 6e 67 20 74 68 69 73 20 63 61 63 * Using this cac
1fb60 68 65 20 72 65 64 75 63 65 73 20 74 68 65 20 6e he reduces the n
1fb70 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 74 umber of calls t
1fb80 6f 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c o btreeParseCell
1fb90 28 29 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 37 2d 30 ()..**.** 2007-0
1fba0 36 2d 32 35 3a 20 20 54 68 65 72 65 20 69 73 20 6-25: There is
1fbb0 61 20 62 75 67 20 69 6e 20 73 6f 6d 65 20 76 65 a bug in some ve
1fbc0 72 73 69 6f 6e 73 20 6f 66 20 4d 53 56 43 20 74 rsions of MSVC t
1fbd0 68 61 74 20 63 61 75 73 65 20 74 68 65 0a 2a 2a hat cause the.**
1fbe0 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 63 72 61 compiler to cra
1fbf0 73 68 20 77 68 65 6e 20 67 65 74 43 65 6c 6c 49 sh when getCellI
1fc00 6e 66 6f 28 29 20 69 73 20 69 6d 70 6c 65 6d 65 nfo() is impleme
1fc10 6e 74 65 64 20 61 73 20 61 20 6d 61 63 72 6f 2e nted as a macro.
1fc20 0a 2a 2a 20 42 75 74 20 74 68 65 72 65 20 69 73 .** But there is
1fc30 20 61 20 6d 65 61 73 75 72 65 61 62 6c 65 20 73 a measureable s
1fc40 70 65 65 64 20 61 64 76 61 6e 74 61 67 65 20 74 peed advantage t
1fc50 6f 20 75 73 69 6e 67 20 74 68 65 20 6d 61 63 72 o using the macr
1fc60 6f 20 6f 6e 20 67 63 63 0a 2a 2a 20 28 77 68 65 o on gcc.** (whe
1fc70 6e 20 6c 65 73 73 20 63 6f 6d 70 69 6c 65 72 20 n less compiler
1fc80 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 6c 69 optimizations li
1fc90 6b 65 20 2d 4f 73 20 6f 72 20 2d 4f 30 20 61 72 ke -Os or -O0 ar
1fca0 65 20 75 73 65 64 20 61 6e 64 20 74 68 65 0a 2a e used and the.*
1fcb0 2a 20 63 6f 6d 70 69 6c 65 72 20 69 73 20 6e 6f * compiler is no
1fcc0 74 20 64 6f 69 6e 67 20 61 67 67 72 65 73 73 69 t doing aggressi
1fcd0 76 65 20 69 6e 6c 69 6e 69 6e 67 2e 29 20 20 53 ve inlining.) S
1fce0 6f 20 77 65 20 75 73 65 20 61 20 72 65 61 6c 20 o we use a real
1fcf0 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 function.** for
1fd00 4d 53 56 43 20 61 6e 64 20 61 20 6d 61 63 72 6f MSVC and a macro
1fd10 20 66 6f 72 20 65 76 65 72 79 74 68 69 6e 67 20 for everything
1fd20 65 6c 73 65 2e 20 20 54 69 63 6b 65 74 20 23 32 else. Ticket #2
1fd30 34 35 37 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 457..*/.#ifndef
1fd40 4e 44 45 42 55 47 0a 20 20 73 74 61 74 69 63 20 NDEBUG. static
1fd50 76 6f 69 64 20 61 73 73 65 72 74 43 65 6c 6c 49 void assertCellI
1fd60 6e 66 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 43 nfo(BtCursor *pC
1fd70 75 72 29 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 ur){. CellInf
1fd80 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 69 6e 74 20 o info;. int
1fd90 69 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 iPage = pCur->iP
1fda0 61 67 65 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 age;. memset(
1fdb0 26 69 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 6f 66 &info, 0, sizeof
1fdc0 28 69 6e 66 6f 29 29 3b 0a 20 20 20 20 62 74 72 (info));. btr
1fdd0 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 eeParseCell(pCur
1fde0 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 5d 2c ->apPage[iPage],
1fdf0 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 pCur->aiIdx[iPa
1fe00 67 65 5d 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 ge], &info);.
1fe10 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 assert( CORRUPT
1fe20 5f 44 42 20 7c 7c 20 6d 65 6d 63 6d 70 28 26 69 _DB || memcmp(&i
1fe30 6e 66 6f 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f nfo, &pCur->info
1fe40 2c 20 73 69 7a 65 6f 66 28 69 6e 66 6f 29 29 3d , sizeof(info))=
1fe50 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a =0 );. }.#else.
1fe60 20 20 23 64 65 66 69 6e 65 20 61 73 73 65 72 74 #define assert
1fe70 43 65 6c 6c 49 6e 66 6f 28 78 29 0a 23 65 6e 64 CellInfo(x).#end
1fe80 69 66 0a 23 69 66 64 65 66 20 5f 4d 53 43 5f 56 if.#ifdef _MSC_V
1fe90 45 52 0a 20 20 2f 2a 20 55 73 65 20 61 20 72 65 ER. /* Use a re
1fea0 61 6c 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 4d al function in M
1feb0 53 56 43 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 SVC to work arou
1fec0 6e 64 20 62 75 67 73 20 69 6e 20 74 68 61 74 20 nd bugs in that
1fed0 63 6f 6d 70 69 6c 65 72 2e 20 2a 2f 0a 20 20 73 compiler. */. s
1fee0 74 61 74 69 63 20 76 6f 69 64 20 67 65 74 43 65 tatic void getCe
1fef0 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f 72 20 llInfo(BtCursor
1ff00 2a 70 43 75 72 29 7b 0a 20 20 20 20 69 66 28 20 *pCur){. if(
1ff10 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
1ff20 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 ==0 ){. int
1ff30 20 69 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 iPage = pCur->i
1ff40 50 61 67 65 3b 0a 20 20 20 20 20 20 62 74 72 65 Page;. btre
1ff50 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d eParseCell(pCur-
1ff60 3e 61 70 50 61 67 65 5b 69 50 61 67 65 5d 2c 70 >apPage[iPage],p
1ff70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 67 65 Cur->aiIdx[iPage
1ff80 5d 2c 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a ],&pCur->info);.
1ff90 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 pCur->curF
1ffa0 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c lags |= BTCF_Val
1ffb0 69 64 4e 4b 65 79 3b 0a 20 20 20 20 7d 65 6c 73 idNKey;. }els
1ffc0 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 43 e{. assertC
1ffd0 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 ellInfo(pCur);.
1ffe0 20 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 65 20 2f }. }.#else /
1fff0 2a 20 69 66 20 6e 6f 74 20 5f 4d 53 43 5f 56 45 * if not _MSC_VE
20000 52 20 2a 2f 0a 20 20 2f 2a 20 55 73 65 20 61 20 R */. /* Use a
20010 6d 61 63 72 6f 20 69 6e 20 61 6c 6c 20 6f 74 68 macro in all oth
20020 65 72 20 63 6f 6d 70 69 6c 65 72 73 20 73 6f 20 er compilers so
20030 74 68 61 74 20 74 68 65 20 66 75 6e 63 74 69 6f that the functio
20040 6e 20 69 73 20 69 6e 6c 69 6e 65 64 20 2a 2f 0a n is inlined */.
20050 23 64 65 66 69 6e 65 20 67 65 74 43 65 6c 6c 49 #define getCellI
20060 6e 66 6f 28 70 43 75 72 29 20 20 20 20 20 20 20 nfo(pCur)
20070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
200a0 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 . if( pCur->inf
200b0 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 20 20 20 o.nSize==0 ){
200c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
200d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
200e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
200f0 5c 0a 20 20 20 20 69 6e 74 20 69 50 61 67 65 20 \. int iPage
20100 3d 20 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 20 = pCur->iPage;
20110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20140 20 5c 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 \. btreePars
20150 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 eCell(pCur->apPa
20160 67 65 5b 69 50 61 67 65 5d 2c 70 43 75 72 2d 3e ge[iPage],pCur->
20170 61 69 49 64 78 5b 69 50 61 67 65 5d 2c 26 70 43 aiIdx[iPage],&pC
20180 75 72 2d 3e 69 6e 66 6f 29 3b 20 20 20 20 20 20 ur->info);
20190 20 20 5c 0a 20 20 20 20 70 43 75 72 2d 3e 63 75 \. pCur->cu
201a0 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 rFlags |= BTCF_V
201b0 61 6c 69 64 4e 4b 65 79 3b 20 20 20 20 20 20 20 alidNKey;
201c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
201d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
201e0 20 20 20 5c 0a 20 20 7d 65 6c 73 65 7b 20 20 20 \. }else{
201f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20230 20 20 20 20 5c 0a 20 20 20 20 61 73 73 65 72 74 \. assert
20240 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 20 CellInfo(pCur);
20250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20280 20 20 20 20 20 5c 0a 20 20 7d 0a 23 65 6e 64 69 \. }.#endi
20290 66 20 2f 2a 20 5f 4d 53 43 5f 56 45 52 20 2a 2f f /* _MSC_VER */
202a0 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 ..#ifndef NDEBUG
202b0 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 72 6f /* The next ro
202c0 75 74 69 6e 65 20 75 73 65 64 20 6f 6e 6c 79 20 utine used only
202d0 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20 within assert()
202e0 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 2f 2a statements */./*
202f0 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 .** Return true
20300 69 66 20 74 68 65 20 67 69 76 65 6e 20 42 74 43 if the given BtC
20310 75 72 73 6f 72 20 69 73 20 76 61 6c 69 64 2e 20 ursor is valid.
20320 20 41 20 76 61 6c 69 64 20 63 75 72 73 6f 72 20 A valid cursor
20330 69 73 20 6f 6e 65 0a 2a 2a 20 74 68 61 74 20 69 is one.** that i
20340 73 20 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e s currently poin
20350 74 69 6e 67 20 74 6f 20 61 20 72 6f 77 20 69 6e ting to a row in
20360 20 61 20 28 6e 6f 6e 2d 65 6d 70 74 79 29 20 74 a (non-empty) t
20370 61 62 6c 65 2e 0a 2a 2a 20 54 68 69 73 20 69 73 able..** This is
20380 20 61 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 a verification
20390 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 routine is used
203a0 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 73 65 only within asse
203b0 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 2e rt() statements.
203c0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
203d0 74 72 65 65 43 75 72 73 6f 72 49 73 56 61 6c 69 treeCursorIsVali
203e0 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 d(BtCursor *pCur
203f0 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 ){. return pCur
20400 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 74 65 && pCur->eState
20410 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a ==CURSOR_VALID;.
20420 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 4e 44 45 42 }.#endif /* NDEB
20430 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 UG */../*.** Set
20440 20 2a 70 53 69 7a 65 20 74 6f 20 74 68 65 20 73 *pSize to the s
20450 69 7a 65 20 6f 66 20 74 68 65 20 62 75 66 66 65 ize of the buffe
20460 72 20 6e 65 65 64 65 64 20 74 6f 20 68 6f 6c 64 r needed to hold
20470 20 74 68 65 20 76 61 6c 75 65 20 6f 66 0a 2a 2a the value of.**
20480 20 74 68 65 20 6b 65 79 20 66 6f 72 20 74 68 65 the key for the
20490 20 63 75 72 72 65 6e 74 20 65 6e 74 72 79 2e 20 current entry.
204a0 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 If the cursor i
204b0 73 20 6e 6f 74 20 70 6f 69 6e 74 69 6e 67 0a 2a s not pointing.*
204c0 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 65 6e 74 * to a valid ent
204d0 72 79 2c 20 2a 70 53 69 7a 65 20 69 73 20 73 65 ry, *pSize is se
204e0 74 20 74 6f 20 30 2e 20 0a 2a 2a 0a 2a 2a 20 46 t to 0. .**.** F
204f0 6f 72 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 or a table with
20500 74 68 65 20 49 4e 54 4b 45 59 20 66 6c 61 67 20 the INTKEY flag
20510 73 65 74 2c 20 74 68 69 73 20 72 6f 75 74 69 6e set, this routin
20520 65 20 72 65 74 75 72 6e 73 20 74 68 65 20 6b 65 e returns the ke
20530 79 0a 2a 2a 20 69 74 73 65 6c 66 2c 20 6e 6f 74 y.** itself, not
20540 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
20550 79 74 65 73 20 69 6e 20 74 68 65 20 6b 65 79 2e ytes in the key.
20560 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 .**.** The calle
20570 72 20 6d 75 73 74 20 70 6f 73 69 74 69 6f 6e 20 r must position
20580 74 68 65 20 63 75 72 73 6f 72 20 70 72 69 6f 72 the cursor prior
20590 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 68 69 to invoking thi
205a0 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 20 0a 2a s routine..** .*
205b0 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 * This routine c
205c0 61 6e 6e 6f 74 20 66 61 69 6c 2e 20 20 49 74 20 annot fail. It
205d0 61 6c 77 61 79 73 20 72 65 74 75 72 6e 73 20 53 always returns S
205e0 51 4c 49 54 45 5f 4f 4b 2e 20 20 0a 2a 2f 0a 69 QLITE_OK. .*/.i
205f0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b nt sqlite3BtreeK
20600 65 79 53 69 7a 65 28 42 74 43 75 72 73 6f 72 20 eySize(BtCursor
20610 2a 70 43 75 72 2c 20 69 36 34 20 2a 70 53 69 7a *pCur, i64 *pSiz
20620 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 e){. assert( cu
20630 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
20640 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
20650 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
20660 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 7c CURSOR_INVALID |
20670 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d | pCur->eState==
20680 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
20690 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
206a0 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
206b0 20 29 7b 0a 20 20 20 20 2a 70 53 69 7a 65 20 3d ){. *pSize =
206c0 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 0;. }else{.
206d0 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 getCellInfo(pCu
206e0 72 29 3b 0a 20 20 20 20 2a 70 53 69 7a 65 20 3d r);. *pSize =
206f0 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 pCur->info.nKey
20700 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
20710 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
20720 2a 2a 20 53 65 74 20 2a 70 53 69 7a 65 20 74 6f ** Set *pSize to
20730 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
20740 79 74 65 73 20 6f 66 20 64 61 74 61 20 69 6e 20 ytes of data in
20750 74 68 65 20 65 6e 74 72 79 20 74 68 65 0a 2a 2a the entry the.**
20760 20 63 75 72 73 6f 72 20 63 75 72 72 65 6e 74 6c cursor currentl
20770 79 20 70 6f 69 6e 74 73 20 74 6f 2e 0a 2a 2a 0a y points to..**.
20780 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 ** The caller mu
20790 73 74 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 st guarantee tha
207a0 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 t the cursor is
207b0 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 6e 6f pointing to a no
207c0 6e 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 64 20 n-NULL.** valid
207d0 65 6e 74 72 79 2e 20 20 49 6e 20 6f 74 68 65 72 entry. In other
207e0 20 77 6f 72 64 73 2c 20 74 68 65 20 63 61 6c 6c words, the call
207f0 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 6d 75 ing procedure mu
20800 73 74 20 67 75 61 72 61 6e 74 65 65 0a 2a 2a 20 st guarantee.**
20810 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 that the cursor
20820 68 61 73 20 43 75 72 73 6f 72 2e 65 53 74 61 74 has Cursor.eStat
20830 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e e==CURSOR_VALID.
20840 0a 2a 2a 0a 2a 2a 20 46 61 69 6c 75 72 65 20 69 .**.** Failure i
20850 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 2e 20 s not possible.
20860 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 This function a
20870 6c 77 61 79 73 20 72 65 74 75 72 6e 73 20 53 51 lways returns SQ
20880 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 49 74 20 6d LITE_OK..** It m
20890 69 67 68 74 20 6a 75 73 74 20 61 73 20 77 65 6c ight just as wel
208a0 6c 20 62 65 20 61 20 70 72 6f 63 65 64 75 72 65 l be a procedure
208b0 20 28 72 65 74 75 72 6e 69 6e 67 20 76 6f 69 64 (returning void
208c0 29 20 62 75 74 20 77 65 20 63 6f 6e 74 69 6e 75 ) but we continu
208d0 65 0a 2a 2a 20 74 6f 20 72 65 74 75 72 6e 20 61 e.** to return a
208e0 6e 20 69 6e 74 65 67 65 72 20 72 65 73 75 6c 74 n integer result
208f0 20 63 6f 64 65 20 66 6f 72 20 68 69 73 74 6f 72 code for histor
20900 69 63 61 6c 20 72 65 61 73 6f 6e 73 2e 0a 2a 2f ical reasons..*/
20910 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
20920 65 44 61 74 61 53 69 7a 65 28 42 74 43 75 72 73 eDataSize(BtCurs
20930 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 or *pCur, u32 *p
20940 53 69 7a 65 29 7b 0a 20 20 61 73 73 65 72 74 28 Size){. assert(
20950 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
20960 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 x(pCur) );. ass
20970 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
20980 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
20990 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
209a0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
209b0 69 50 61 67 65 5d 2d 3e 69 6e 74 4b 65 79 4c 65 iPage]->intKeyLe
209c0 61 66 3d 3d 31 20 29 3b 0a 20 20 67 65 74 43 65 af==1 );. getCe
209d0 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 llInfo(pCur);.
209e0 2a 70 53 69 7a 65 20 3d 20 70 43 75 72 2d 3e 69 *pSize = pCur->i
209f0 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 nfo.nPayload;.
20a00 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
20a10 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e ;.}../*.** Given
20a20 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
20a30 20 6f 66 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 of an overflow
20a40 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 74 61 page in the data
20a50 62 61 73 65 20 28 70 61 72 61 6d 65 74 65 72 0a base (parameter.
20a60 2a 2a 20 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 ** ovfl), this f
20a70 75 6e 63 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 unction finds th
20a80 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
20a90 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 the next page i
20aa0 6e 20 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 n the .** linked
20ab0 20 6c 69 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f list of overflo
20ac0 77 20 70 61 67 65 73 2e 20 49 66 20 70 6f 73 73 w pages. If poss
20ad0 69 62 6c 65 2c 20 69 74 20 75 73 65 73 20 74 68 ible, it uses th
20ae0 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a e auto-vacuum.**
20af0 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 pointer-map dat
20b00 61 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 61 a instead of rea
20b10 64 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 ding the content
20b20 20 6f 66 20 70 61 67 65 20 6f 76 66 6c 20 74 6f of page ovfl to
20b30 20 64 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 do so. .**.** I
20b40 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
20b50 73 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f s an SQLite erro
20b60 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
20b70 65 64 2e 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a ed. Otherwise:.*
20b80 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 6e 75 *.** The page nu
20b90 6d 62 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 mber of the next
20ba0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 overflow page i
20bb0 6e 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 n the linked lis
20bc0 74 20 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e t is .** written
20bd0 20 74 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 to *pPgnoNext.
20be0 49 66 20 70 61 67 65 20 6f 76 66 6c 20 69 73 20 If page ovfl is
20bf0 74 68 65 20 6c 61 73 74 20 70 61 67 65 20 69 6e the last page in
20c00 20 69 74 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 its linked .**
20c10 6c 69 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 list, *pPgnoNext
20c20 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e is set to zero.
20c30 20 0a 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 .**.** If ppPag
20c40 65 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 e is not NULL, a
20c50 6e 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 nd a reference t
20c60 6f 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 o the MemPage ob
20c70 6a 65 63 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 ject correspondi
20c80 6e 67 0a 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 ng.** to page nu
20c90 6d 62 65 72 20 70 4f 76 66 6c 20 77 61 73 20 6f mber pOvfl was o
20ca0 62 74 61 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 btained, then *p
20cb0 70 50 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 pPage is set to
20cc0 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a point to that.**
20cd0 20 72 65 66 65 72 65 6e 63 65 2e 20 49 74 20 69 reference. It i
20ce0 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 s the responsibi
20cf0 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c lity of the call
20d00 65 72 20 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 er to call relea
20d10 73 65 50 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a sePage().** on *
20d20 70 70 50 61 67 65 20 74 6f 20 66 72 65 65 20 74 ppPage to free t
20d30 68 65 20 72 65 66 65 72 65 6e 63 65 2e 20 49 6e he reference. In
20d40 20 6e 6f 20 72 65 66 65 72 65 6e 63 65 20 77 61 no reference wa
20d50 73 20 6f 62 74 61 69 6e 65 64 20 28 62 65 63 61 s obtained (beca
20d60 75 73 65 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 use.** the point
20d70 65 72 2d 6d 61 70 20 77 61 73 20 75 73 65 64 20 er-map was used
20d80 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 76 61 to obtain the va
20d90 6c 75 65 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 lue for *pPgnoNe
20da0 78 74 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 xt), then.** *pp
20db0 50 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 7a Page is set to z
20dc0 65 72 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ero..*/.static i
20dd0 6e 74 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 nt getOverflowPa
20de0 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a ge(. BtShared *
20df0 70 42 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 pBt,
20e00 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 /* The databa
20e10 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e se file */. Pgn
20e20 6f 20 6f 76 66 6c 2c 20 20 20 20 20 20 20 20 20 o ovfl,
20e30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
20e40 72 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 rent overflow pa
20e50 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d ge number */. M
20e60 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c emPage **ppPage,
20e70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
20e80 55 54 3a 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 UT: MemPage hand
20e90 6c 65 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 le (may be NULL)
20ea0 20 2a 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e */. Pgno *pPgn
20eb0 6f 4e 65 78 74 20 20 20 20 20 20 20 20 20 20 20 oNext
20ec0 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 /* OUT: Next
20ed0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 overflow page nu
20ee0 6d 62 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e mber */.){. Pgn
20ef0 6f 20 6e 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 o next = 0;. Me
20f00 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 mPage *pPage = 0
20f10 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
20f20 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
20f30 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
20f40 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
20f50 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 ) );. assert(pP
20f60 67 6e 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 gnoNext);..#ifnd
20f70 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
20f80 55 54 4f 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 UTOVACUUM. /* T
20f90 72 79 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e ry to find the n
20fa0 65 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 ext page in the
20fb0 6f 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 overflow list us
20fc0 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 ing the. ** aut
20fd0 6f 76 61 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d ovacuum pointer-
20fe0 6d 61 70 20 70 61 67 65 73 2e 20 47 75 65 73 73 map pages. Guess
20ff0 20 74 68 61 74 20 74 68 65 20 6e 65 78 74 20 70 that the next p
21000 61 67 65 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 age in . ** the
21010 20 6f 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 overflow list i
21020 73 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6f s page number (o
21030 76 66 6c 2b 31 29 2e 20 49 66 20 74 68 61 74 20 vfl+1). If that
21040 67 75 65 73 73 20 74 75 72 6e 73 20 0a 20 20 2a guess turns . *
21050 2a 20 6f 75 74 20 74 6f 20 62 65 20 77 72 6f 6e * out to be wron
21060 67 2c 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 g, fall back to
21070 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 loading the data
21080 20 6f 66 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e of page . ** n
21090 75 6d 62 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 umber ovfl to de
210a0 74 65 72 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 termine the next
210b0 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 page number..
210c0 2a 2f 0a 20 20 69 66 28 20 70 42 74 2d 3e 61 75 */. if( pBt->au
210d0 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 toVacuum ){.
210e0 50 67 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 Pgno pgno;. P
210f0 67 6e 6f 20 69 47 75 65 73 73 20 3d 20 6f 76 66 gno iGuess = ovf
21100 6c 2b 31 3b 0a 20 20 20 20 75 38 20 65 54 79 70 l+1;. u8 eTyp
21110 65 3b 0a 0a 20 20 20 20 77 68 69 6c 65 28 20 50 e;.. while( P
21120 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
21130 2c 20 69 47 75 65 73 73 29 20 7c 7c 20 69 47 75 , iGuess) || iGu
21140 65 73 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 ess==PENDING_BYT
21150 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 E_PAGE(pBt) ){.
21160 20 20 20 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 iGuess++;.
21170 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 }.. if( iG
21180 75 65 73 73 3c 3d 62 74 72 65 65 50 61 67 65 63 uess<=btreePagec
21190 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 ount(pBt) ){.
211a0 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 rc = ptrmapGe
211b0 74 28 70 42 74 2c 20 69 47 75 65 73 73 2c 20 26 t(pBt, iGuess, &
211c0 65 54 79 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 eType, &pgno);.
211d0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
211e0 49 54 45 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d ITE_OK && eType=
211f0 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 =PTRMAP_OVERFLOW
21200 32 20 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 2 && pgno==ovfl
21210 29 7b 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 ){. next
21220 3d 20 69 47 75 65 73 73 3b 0a 20 20 20 20 20 20 = iGuess;.
21230 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f rc = SQLITE_DO
21240 4e 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 NE;. }.
21250 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }. }.#endif..
21260 61 73 73 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 assert( next==0
21270 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f || rc==SQLITE_DO
21280 4e 45 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d NE );. if( rc==
21290 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
212a0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
212b0 67 65 28 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 ge(pBt, ovfl, &p
212c0 50 61 67 65 2c 20 28 70 70 50 61 67 65 3d 3d 30 Page, (ppPage==0
212d0 29 20 3f 20 50 41 47 45 52 5f 47 45 54 5f 52 45 ) ? PAGER_GET_RE
212e0 41 44 4f 4e 4c 59 20 3a 20 30 29 3b 0a 20 20 20 ADONLY : 0);.
212f0 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c assert( rc==SQL
21300 49 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 3d ITE_OK || pPage=
21310 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 =0 );. if( rc
21320 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
21330 20 20 20 20 20 6e 65 78 74 20 3d 20 67 65 74 34 next = get4
21340 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 byte(pPage->aDat
21350 61 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 a);. }. }..
21360 20 2a 70 50 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 *pPgnoNext = ne
21370 78 74 3b 0a 20 20 69 66 28 20 70 70 50 61 67 65 xt;. if( ppPage
21380 20 29 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 ){. *ppPage
21390 3d 20 70 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65 = pPage;. }else
213a0 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 {. releasePag
213b0 65 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 e(pPage);. }.
213c0 72 65 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 return (rc==SQLI
213d0 54 45 5f 44 4f 4e 45 20 3f 20 53 51 4c 49 54 45 TE_DONE ? SQLITE
213e0 5f 4f 4b 20 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a _OK : rc);.}../*
213f0 0a 2a 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 .** Copy data fr
21400 6f 6d 20 61 20 62 75 66 66 65 72 20 74 6f 20 61 om a buffer to a
21410 20 70 61 67 65 2c 20 6f 72 20 66 72 6f 6d 20 61 page, or from a
21420 20 70 61 67 65 20 74 6f 20 61 20 62 75 66 66 65 page to a buffe
21430 72 2e 0a 2a 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 r..**.** pPayloa
21440 64 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 d is a pointer t
21450 6f 20 64 61 74 61 20 73 74 6f 72 65 64 20 6f 6e o data stored on
21460 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 70 database page p
21470 44 62 50 61 67 65 2e 0a 2a 2a 20 49 66 20 61 72 DbPage..** If ar
21480 67 75 6d 65 6e 74 20 65 4f 70 20 69 73 20 66 61 gument eOp is fa
21490 6c 73 65 2c 20 74 68 65 6e 20 6e 42 79 74 65 20 lse, then nByte
214a0 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 61 72 bytes of data ar
214b0 65 20 63 6f 70 69 65 64 0a 2a 2a 20 66 72 6f 6d e copied.** from
214c0 20 70 50 61 79 6c 6f 61 64 20 74 6f 20 74 68 65 pPayload to the
214d0 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 buffer pointed
214e0 61 74 20 62 79 20 70 42 75 66 2e 20 49 66 20 65 at by pBuf. If e
214f0 4f 70 20 69 73 20 74 72 75 65 2c 0a 2a 2a 20 74 Op is true,.** t
21500 68 65 6e 20 73 71 6c 69 74 65 33 50 61 67 65 72 hen sqlite3Pager
21510 57 72 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 Write() is calle
21520 64 20 6f 6e 20 70 44 62 50 61 67 65 20 61 6e 64 d on pDbPage and
21530 20 6e 42 79 74 65 20 62 79 74 65 73 0a 2a 2a 20 nByte bytes.**
21540 6f 66 20 64 61 74 61 20 61 72 65 20 63 6f 70 69 of data are copi
21550 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 ed from the buff
21560 65 72 20 70 42 75 66 20 74 6f 20 70 50 61 79 6c er pBuf to pPayl
21570 6f 61 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 oad..**.** SQLIT
21580 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
21590 20 6f 6e 20 73 75 63 63 65 73 73 2c 20 6f 74 68 on success, oth
215a0 65 72 77 69 73 65 20 61 6e 20 65 72 72 6f 72 20 erwise an error
215b0 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 code..*/.static
215c0 69 6e 74 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 int copyPayload(
215d0 0a 20 20 76 6f 69 64 20 2a 70 50 61 79 6c 6f 61 . void *pPayloa
215e0 64 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 d, /*
215f0 50 6f 69 6e 74 65 72 20 74 6f 20 70 61 67 65 20 Pointer to page
21600 64 61 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 2a data */. void *
21610 70 42 75 66 2c 20 20 20 20 20 20 20 20 20 20 20 pBuf,
21620 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
21630 6f 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e o buffer */. in
21640 74 20 6e 42 79 74 65 2c 20 20 20 20 20 20 20 20 t nByte,
21650 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
21660 72 20 6f 66 20 62 79 74 65 73 20 74 6f 20 63 6f r of bytes to co
21670 70 79 20 2a 2f 0a 20 20 69 6e 74 20 65 4f 70 2c py */. int eOp,
21680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21690 20 20 2f 2a 20 30 20 2d 3e 20 63 6f 70 79 20 66 /* 0 -> copy f
216a0 72 6f 6d 20 70 61 67 65 2c 20 31 20 2d 3e 20 63 rom page, 1 -> c
216b0 6f 70 79 20 74 6f 20 70 61 67 65 20 2a 2f 0a 20 opy to page */.
216c0 20 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 DbPage *pDbPage
216d0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
216e0 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 50 ge containing pP
216f0 61 79 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 ayload */.){. i
21700 66 28 20 65 4f 70 20 29 7b 0a 20 20 20 20 2f 2a f( eOp ){. /*
21710 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 Copy data from
21720 62 75 66 66 65 72 20 74 6f 20 70 61 67 65 20 28 buffer to page (
21730 61 20 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f a write operatio
21740 6e 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 n) */. int rc
21750 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
21760 72 69 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 rite(pDbPage);.
21770 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
21780 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
21790 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
217a0 20 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f memcpy(pPaylo
217b0 61 64 2c 20 70 42 75 66 2c 20 6e 42 79 74 65 29 ad, pBuf, nByte)
217c0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f ;. }else{. /
217d0 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d * Copy data from
217e0 20 70 61 67 65 20 74 6f 20 62 75 66 66 65 72 20 page to buffer
217f0 28 61 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f (a read operatio
21800 6e 29 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 n) */. memcpy
21810 28 70 42 75 66 2c 20 70 50 61 79 6c 6f 61 64 2c (pBuf, pPayload,
21820 20 6e 42 79 74 65 29 3b 0a 20 20 7d 0a 20 20 72 nByte);. }. r
21830 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
21840 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 .}../*.** This f
21850 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 unction is used
21860 74 6f 20 72 65 61 64 20 6f 72 20 6f 76 65 72 77 to read or overw
21870 72 69 74 65 20 70 61 79 6c 6f 61 64 20 69 6e 66 rite payload inf
21880 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 ormation.** for
21890 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 the entry that t
218a0 68 65 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 he pCur cursor i
218b0 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 54 s pointing to. T
218c0 68 65 20 65 4f 70 0a 2a 2a 20 61 72 67 75 6d 65 he eOp.** argume
218d0 6e 74 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 nt is interprete
218e0 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a d as follows:.**
218f0 0a 2a 2a 20 20 20 30 3a 20 54 68 65 20 6f 70 65 .** 0: The ope
21900 72 61 74 69 6f 6e 20 69 73 20 61 20 72 65 61 64 ration is a read
21910 2e 20 50 6f 70 75 6c 61 74 65 20 74 68 65 20 6f . Populate the o
21920 76 65 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a verflow cache..*
21930 2a 20 20 20 31 3a 20 54 68 65 20 6f 70 65 72 61 * 1: The opera
21940 74 69 6f 6e 20 69 73 20 61 20 77 72 69 74 65 2e tion is a write.
21950 20 50 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 Populate the ov
21960 65 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a erflow cache..**
21970 20 20 20 32 3a 20 54 68 65 20 6f 70 65 72 61 74 2: The operat
21980 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e 20 44 ion is a read. D
21990 6f 20 6e 6f 74 20 70 6f 70 75 6c 61 74 65 20 74 o not populate t
219a0 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 he overflow cach
219b0 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 74 6f 74 61 6c e..**.** A total
219c0 20 6f 66 20 22 61 6d 74 22 20 62 79 74 65 73 20 of "amt" bytes
219d0 61 72 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 are read or writ
219e0 74 65 6e 20 62 65 67 69 6e 6e 69 6e 67 20 61 74 ten beginning at
219f0 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 20 44 61 "offset"..** Da
21a00 74 61 20 69 73 20 72 65 61 64 20 74 6f 20 6f 72 ta is read to or
21a10 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
21a20 20 70 42 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 pBuf..**.** The
21a30 20 63 6f 6e 74 65 6e 74 20 62 65 69 6e 67 20 72 content being r
21a40 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 20 6d ead or written m
21a50 69 67 68 74 20 61 70 70 65 61 72 20 6f 6e 20 74 ight appear on t
21a60 68 65 20 6d 61 69 6e 20 70 61 67 65 0a 2a 2a 20 he main page.**
21a70 6f 72 20 62 65 20 73 63 61 74 74 65 72 65 64 20 or be scattered
21a80 6f 75 74 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 out on multiple
21a90 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a overflow pages..
21aa0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 72 **.** If the cur
21ab0 72 65 6e 74 20 63 75 72 73 6f 72 20 65 6e 74 72 rent cursor entr
21ac0 79 20 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f y uses one or mo
21ad0 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 re overflow page
21ae0 73 20 61 6e 64 20 74 68 65 0a 2a 2a 20 65 4f 70 s and the.** eOp
21af0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 74 argument is not
21b00 20 32 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 2, this functio
21b10 6e 20 6d 61 79 20 61 6c 6c 6f 63 61 74 65 20 73 n may allocate s
21b20 70 61 63 65 20 66 6f 72 20 61 6e 64 20 6c 61 7a pace for and laz
21b30 69 6c 79 20 0a 2a 2a 20 70 6f 70 75 6c 61 74 65 ily .** populate
21b40 73 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 s the overflow p
21b50 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 61 age-list cache a
21b60 72 72 61 79 20 28 42 74 43 75 72 73 6f 72 2e 61 rray (BtCursor.a
21b70 4f 76 65 72 66 6c 6f 77 29 2e 20 0a 2a 2a 20 53 Overflow). .** S
21b80 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 ubsequent calls
21b90 75 73 65 20 74 68 69 73 20 63 61 63 68 65 20 74 use this cache t
21ba0 6f 20 6d 61 6b 65 20 73 65 65 6b 69 6e 67 20 74 o make seeking t
21bb0 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 6f o the supplied o
21bc0 66 66 73 65 74 20 0a 2a 2a 20 6d 6f 72 65 20 65 ffset .** more e
21bd0 66 66 69 63 69 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 fficient..**.**
21be0 4f 6e 63 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 Once an overflow
21bf0 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 page-list cache
21c00 20 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 has been alloca
21c10 74 65 64 2c 20 69 74 20 6d 61 79 20 62 65 0a 2a ted, it may be.*
21c20 2a 20 69 6e 76 61 6c 69 64 61 74 65 64 20 69 66 * invalidated if
21c30 20 73 6f 6d 65 20 6f 74 68 65 72 20 63 75 72 73 some other curs
21c40 6f 72 20 77 72 69 74 65 73 20 74 6f 20 74 68 65 or writes to the
21c50 20 73 61 6d 65 20 74 61 62 6c 65 2c 20 6f 72 20 same table, or
21c60 69 66 0a 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 if.** the cursor
21c70 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 61 20 64 is moved to a d
21c80 69 66 66 65 72 65 6e 74 20 72 6f 77 2e 20 41 64 ifferent row. Ad
21c90 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e 20 61 ditionally, in a
21ca0 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 6d 6f uto-vacuum.** mo
21cb0 64 65 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e de, the followin
21cc0 67 20 65 76 65 6e 74 73 20 6d 61 79 20 69 6e 76 g events may inv
21cd0 61 6c 69 64 61 74 65 20 61 6e 20 6f 76 65 72 66 alidate an overf
21ce0 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
21cf0 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 che..**.** * A
21d00 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 n incremental va
21d10 63 75 75 6d 2c 0a 2a 2a 20 20 20 2a 20 41 20 63 cuum,.** * A c
21d20 6f 6d 6d 69 74 20 69 6e 20 61 75 74 6f 5f 76 61 ommit in auto_va
21d30 63 75 75 6d 3d 22 66 75 6c 6c 22 20 6d 6f 64 65 cuum="full" mode
21d40 2c 0a 2a 2a 20 20 20 2a 20 43 72 65 61 74 69 6e ,.** * Creatin
21d50 67 20 61 20 74 61 62 6c 65 20 28 6d 61 79 20 72 g a table (may r
21d60 65 71 75 69 72 65 20 6d 6f 76 69 6e 67 20 61 6e equire moving an
21d70 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 29 2e overflow page).
21d80 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
21d90 63 63 65 73 73 50 61 79 6c 6f 61 64 28 0a 20 20 ccessPayload(.
21da0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
21db0 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 70 /* Cursor p
21dc0 6f 69 6e 74 69 6e 67 20 74 6f 20 65 6e 74 72 79 ointing to entry
21dd0 20 74 6f 20 72 65 61 64 20 66 72 6f 6d 20 2a 2f to read from */
21de0 0a 20 20 75 33 32 20 6f 66 66 73 65 74 2c 20 20 . u32 offset,
21df0 20 20 20 20 20 20 20 20 2f 2a 20 42 65 67 69 6e /* Begin
21e00 20 72 65 61 64 69 6e 67 20 74 68 69 73 20 66 61 reading this fa
21e10 72 20 69 6e 74 6f 20 70 61 79 6c 6f 61 64 20 2a r into payload *
21e20 2f 0a 20 20 75 33 32 20 61 6d 74 2c 20 20 20 20 /. u32 amt,
21e30 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 /* Read
21e40 20 74 68 69 73 20 6d 61 6e 79 20 62 79 74 65 73 this many bytes
21e50 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 */. unsigned c
21e60 68 61 72 20 2a 70 42 75 66 2c 20 2f 2a 20 57 72 har *pBuf, /* Wr
21e70 69 74 65 20 74 68 65 20 62 79 74 65 73 20 69 6e ite the bytes in
21e80 74 6f 20 74 68 69 73 20 62 75 66 66 65 72 20 2a to this buffer *
21e90 2f 20 0a 20 20 69 6e 74 20 65 4f 70 20 20 20 20 / . int eOp
21ea0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 65 72 /* zer
21eb0 6f 20 74 6f 20 72 65 61 64 2e 20 6e 6f 6e 2d 7a o to read. non-z
21ec0 65 72 6f 20 74 6f 20 77 72 69 74 65 2e 20 2a 2f ero to write. */
21ed0 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 .){. unsigned c
21ee0 68 61 72 20 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 har *aPayload;.
21ef0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
21f00 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 49 64 78 20 _OK;. int iIdx
21f10 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a = 0;. MemPage *
21f20 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 pPage = pCur->ap
21f30 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
21f40 5d 3b 20 2f 2a 20 42 74 72 65 65 20 70 61 67 65 ]; /* Btree page
21f50 20 6f 66 20 63 75 72 72 65 6e 74 20 65 6e 74 72 of current entr
21f60 79 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 y */. BtShared
21f70 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 *pBt = pCur->pBt
21f80 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
21f90 20 20 20 2f 2a 20 42 74 72 65 65 20 74 68 69 73 /* Btree this
21fa0 20 63 75 72 73 6f 72 20 62 65 6c 6f 6e 67 73 20 cursor belongs
21fb0 74 6f 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c to */.#ifdef SQL
21fc0 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 ITE_DIRECT_OVERF
21fd0 4c 4f 57 5f 52 45 41 44 0a 20 20 75 6e 73 69 67 LOW_READ. unsig
21fe0 6e 65 64 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 ned char * const
21ff0 20 70 42 75 66 53 74 61 72 74 20 3d 20 70 42 75 pBufStart = pBu
22000 66 3b 0a 20 20 69 6e 74 20 62 45 6e 64 3b 20 20 f;. int bEnd;
22010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
22030 2a 20 54 72 75 65 20 69 66 20 72 65 61 64 69 6e * True if readin
22040 67 20 74 6f 20 65 6e 64 20 6f 66 20 64 61 74 61 g to end of data
22050 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 */.#endif.. as
22060 73 65 72 74 28 20 70 50 61 67 65 20 29 3b 0a 20 sert( pPage );.
22070 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
22080 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
22090 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
220a0 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 pCur->aiIdx[pCu
220b0 72 2d 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 2d r->iPage]<pPage-
220c0 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 >nCell );. asse
220d0 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
220e0 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
220f0 61 73 73 65 72 74 28 20 65 4f 70 21 3d 32 20 7c assert( eOp!=2 |
22100 7c 20 6f 66 66 73 65 74 3d 3d 30 20 29 3b 20 20 | offset==0 );
22110 20 20 2f 2a 20 41 6c 77 61 79 73 20 73 74 61 72 /* Always star
22120 74 20 66 72 6f 6d 20 62 65 67 69 6e 6e 69 6e 67 t from beginning
22130 20 66 6f 72 20 65 4f 70 3d 3d 32 20 2a 2f 0a 0a for eOp==2 */..
22140 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 getCellInfo(pC
22150 75 72 29 3b 0a 20 20 61 50 61 79 6c 6f 61 64 20 ur);. aPayload
22160 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 = pCur->info.pPa
22170 79 6c 6f 61 64 3b 0a 23 69 66 64 65 66 20 53 51 yload;.#ifdef SQ
22180 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 LITE_DIRECT_OVER
22190 46 4c 4f 57 5f 52 45 41 44 0a 20 20 62 45 6e 64 FLOW_READ. bEnd
221a0 20 3d 20 6f 66 66 73 65 74 2b 61 6d 74 3d 3d 70 = offset+amt==p
221b0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f Cur->info.nPaylo
221c0 61 64 3b 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 ad;.#endif. ass
221d0 65 72 74 28 20 6f 66 66 73 65 74 2b 61 6d 74 20 ert( offset+amt
221e0 3c 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 <= pCur->info.nP
221f0 61 79 6c 6f 61 64 20 29 3b 0a 0a 20 20 69 66 28 ayload );.. if(
22200 20 26 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d &aPayload[pCur-
22210 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 >info.nLocal] >
22220 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
22230 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 5d 20 29 t->usableSize] )
22240 7b 0a 20 20 20 20 2f 2a 20 54 72 79 69 6e 67 20 {. /* Trying
22250 74 6f 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 to read or write
22260 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
22270 20 74 68 65 20 64 61 74 61 20 69 73 20 61 6e 20 the data is an
22280 65 72 72 6f 72 20 2a 2f 0a 20 20 20 20 72 65 74 error */. ret
22290 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
222a0 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 PT_BKPT;. }..
222b0 2f 2a 20 43 68 65 63 6b 20 69 66 20 64 61 74 61 /* Check if data
222c0 20 6d 75 73 74 20 62 65 20 72 65 61 64 2f 77 72 must be read/wr
222d0 69 74 74 65 6e 20 74 6f 2f 66 72 6f 6d 20 74 68 itten to/from th
222e0 65 20 62 74 72 65 65 20 70 61 67 65 20 69 74 73 e btree page its
222f0 65 6c 66 2e 20 2a 2f 0a 20 20 69 66 28 20 6f 66 elf. */. if( of
22300 66 73 65 74 3c 70 43 75 72 2d 3e 69 6e 66 6f 2e fset<pCur->info.
22310 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 69 6e nLocal ){. in
22320 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 69 t a = amt;. i
22330 66 28 20 61 2b 6f 66 66 73 65 74 3e 70 43 75 72 f( a+offset>pCur
22340 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 7b ->info.nLocal ){
22350 0a 20 20 20 20 20 20 61 20 3d 20 70 43 75 72 2d . a = pCur-
22360 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d 20 6f >info.nLocal - o
22370 66 66 73 65 74 3b 0a 20 20 20 20 7d 0a 20 20 20 ffset;. }.
22380 20 72 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 rc = copyPayloa
22390 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 d(&aPayload[offs
223a0 65 74 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 et], pBuf, a, (e
223b0 4f 70 20 26 20 30 78 30 31 29 2c 20 70 50 61 67 Op & 0x01), pPag
223c0 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
223d0 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 offset = 0;.
223e0 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 pBuf += a;.
223f0 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 amt -= a;. }els
22400 65 7b 0a 20 20 20 20 6f 66 66 73 65 74 20 2d 3d e{. offset -=
22410 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 pCur->info.nLoc
22420 61 6c 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 al;. }.. if( r
22430 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
22440 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f 6e amt>0 ){. con
22450 73 74 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 20 st u32 ovflSize
22460 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
22470 65 20 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 73 e - 4; /* Bytes
22480 20 63 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 66 content per ovf
22490 6c 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 67 l page */. Pg
224a0 6e 6f 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 no nextPage;..
224b0 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 nextPage = get
224c0 34 62 79 74 65 28 26 61 50 61 79 6c 6f 61 64 5b 4byte(&aPayload[
224d0 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
224e0 6c 5d 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 l]);.. /* If
224f0 74 68 65 20 42 74 43 75 72 73 6f 72 2e 61 4f 76 the BtCursor.aOv
22500 65 72 66 6c 6f 77 5b 5d 20 68 61 73 20 6e 6f 74 erflow[] has not
22510 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 2c been allocated,
22520 20 61 6c 6c 6f 63 61 74 65 20 69 74 20 6e 6f 77 allocate it now
22530 2e 0a 20 20 20 20 2a 2a 20 45 78 63 65 70 74 2c .. ** Except,
22540 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 do not allocate
22550 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 66 6f 72 aOverflow[] for
22560 20 65 4f 70 3d 3d 32 2e 0a 20 20 20 20 2a 2a 0a eOp==2.. **.
22570 20 20 20 20 2a 2a 20 54 68 65 20 61 4f 76 65 72 ** The aOver
22580 66 6c 6f 77 5b 5d 20 61 72 72 61 79 20 69 73 20 flow[] array is
22590 73 69 7a 65 64 20 61 74 20 6f 6e 65 20 65 6e 74 sized at one ent
225a0 72 79 20 66 6f 72 20 65 61 63 68 20 6f 76 65 72 ry for each over
225b0 66 6c 6f 77 20 70 61 67 65 0a 20 20 20 20 2a 2a flow page. **
225c0 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 in the overflow
225d0 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 67 65 chain. The page
225e0 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 66 number of the f
225f0 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 irst overflow pa
22600 67 65 20 69 73 0a 20 20 20 20 2a 2a 20 73 74 6f ge is. ** sto
22610 72 65 64 20 69 6e 20 61 4f 76 65 72 66 6c 6f 77 red in aOverflow
22620 5b 30 5d 2c 20 65 74 63 2e 20 41 20 76 61 6c 75 [0], etc. A valu
22630 65 20 6f 66 20 30 20 69 6e 20 74 68 65 20 61 4f e of 0 in the aO
22640 76 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 0a verflow[] array.
22650 20 20 20 20 2a 2a 20 6d 65 61 6e 73 20 22 6e 6f ** means "no
22660 74 20 79 65 74 20 6b 6e 6f 77 6e 22 20 28 74 68 t yet known" (th
22670 65 20 63 61 63 68 65 20 69 73 20 6c 61 7a 69 6c e cache is lazil
22680 79 20 70 6f 70 75 6c 61 74 65 64 29 2e 0a 20 20 y populated)..
22690 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 65 4f 70 */. if( eOp
226a0 21 3d 32 20 26 26 20 28 70 43 75 72 2d 3e 63 75 !=2 && (pCur->cu
226b0 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 rFlags & BTCF_Va
226c0 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 29 7b 0a 20 lidOvfl)==0 ){.
226d0 20 20 20 20 20 69 6e 74 20 6e 4f 76 66 6c 20 3d int nOvfl =
226e0 20 28 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 (pCur->info.nPa
226f0 79 6c 6f 61 64 2d 70 43 75 72 2d 3e 69 6e 66 6f yload-pCur->info
22700 2e 6e 4c 6f 63 61 6c 2b 6f 76 66 6c 53 69 7a 65 .nLocal+ovflSize
22710 2d 31 29 2f 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 -1)/ovflSize;.
22720 20 20 20 20 69 66 28 20 6e 4f 76 66 6c 3e 70 43 if( nOvfl>pC
22730 75 72 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 29 ur->nOvflAlloc )
22740 7b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 2a {. Pgno *
22750 61 4e 65 77 20 3d 20 28 50 67 6e 6f 2a 29 73 71 aNew = (Pgno*)sq
22760 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 0a lite3DbRealloc(.
22770 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 pCur
22780 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2c 20 70 43 ->pBtree->db, pC
22790 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 6e ur->aOverflow, n
227a0 4f 76 66 6c 2a 32 2a 73 69 7a 65 6f 66 28 50 67 Ovfl*2*sizeof(Pg
227b0 6e 6f 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 no). );.
227c0 20 20 20 20 20 20 20 69 66 28 20 61 4e 65 77 3d if( aNew=
227d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
227e0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
227f0 4d 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 M;. }else
22800 7b 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 72 {. pCur
22810 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 3d 20 6e ->nOvflAlloc = n
22820 4f 76 66 6c 2a 32 3b 0a 20 20 20 20 20 20 20 20 Ovfl*2;.
22830 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f pCur->aOverflo
22840 77 20 3d 20 61 4e 65 77 3b 0a 20 20 20 20 20 20 w = aNew;.
22850 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
22860 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
22870 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 6d _OK ){. m
22880 65 6d 73 65 74 28 70 43 75 72 2d 3e 61 4f 76 65 emset(pCur->aOve
22890 72 66 6c 6f 77 2c 20 30 2c 20 6e 4f 76 66 6c 2a rflow, 0, nOvfl*
228a0 73 69 7a 65 6f 66 28 50 67 6e 6f 29 29 3b 0a 20 sizeof(Pgno));.
228b0 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 pCur->cur
228c0 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 Flags |= BTCF_Va
228d0 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 20 20 20 7d lidOvfl;. }
228e0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 . }.. /* I
228f0 66 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 f the overflow p
22900 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 age-list cache h
22910 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 as been allocate
22920 64 20 61 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a d and the. **
22930 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 66 entry for the f
22940 69 72 73 74 20 72 65 71 75 69 72 65 64 20 6f 76 irst required ov
22950 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 76 erflow page is v
22960 61 6c 69 64 2c 20 73 6b 69 70 0a 20 20 20 20 2a alid, skip. *
22970 2a 20 64 69 72 65 63 74 6c 79 20 74 6f 20 69 74 * directly to it
22980 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
22990 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
229a0 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 & BTCF_ValidOvf
229b0 6c 29 21 3d 30 0a 20 20 20 20 20 26 26 20 70 43 l)!=0. && pC
229c0 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 6f 66 ur->aOverflow[of
229d0 66 73 65 74 2f 6f 76 66 6c 53 69 7a 65 5d 0a 20 fset/ovflSize].
229e0 20 20 20 29 7b 0a 20 20 20 20 20 20 69 49 64 78 ){. iIdx
229f0 20 3d 20 28 6f 66 66 73 65 74 2f 6f 76 66 6c 53 = (offset/ovflS
22a00 69 7a 65 29 3b 0a 20 20 20 20 20 20 6e 65 78 74 ize);. next
22a10 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 Page = pCur->aOv
22a20 65 72 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a 20 20 erflow[iIdx];.
22a30 20 20 20 20 6f 66 66 73 65 74 20 3d 20 28 6f 66 offset = (of
22a40 66 73 65 74 25 6f 76 66 6c 53 69 7a 65 29 3b 0a fset%ovflSize);.
22a50 20 20 20 20 7d 0a 0a 20 20 20 20 66 6f 72 28 20 }.. for(
22a60 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ; rc==SQLITE_OK
22a70 26 26 20 61 6d 74 3e 30 20 26 26 20 6e 65 78 74 && amt>0 && next
22a80 50 61 67 65 3b 20 69 49 64 78 2b 2b 29 7b 0a 0a Page; iIdx++){..
22a90 20 20 20 20 20 20 2f 2a 20 49 66 20 72 65 71 75 /* If requ
22aa0 69 72 65 64 2c 20 70 6f 70 75 6c 61 74 65 20 74 ired, populate t
22ab0 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
22ac0 2d 6c 69 73 74 20 63 61 63 68 65 2e 20 2a 2f 0a -list cache. */.
22ad0 20 20 20 20 20 20 69 66 28 20 28 70 43 75 72 2d if( (pCur-
22ae0 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 >curFlags & BTCF
22af0 5f 56 61 6c 69 64 4f 76 66 6c 29 21 3d 30 20 29 _ValidOvfl)!=0 )
22b00 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
22b10 28 21 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f (!pCur->aOverflo
22b20 77 5b 69 49 64 78 5d 20 7c 7c 20 70 43 75 72 2d w[iIdx] || pCur-
22b30 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d >aOverflow[iIdx]
22b40 3d 3d 6e 65 78 74 50 61 67 65 29 3b 0a 20 20 20 ==nextPage);.
22b50 20 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 pCur->aOver
22b60 66 6c 6f 77 5b 69 49 64 78 5d 20 3d 20 6e 65 78 flow[iIdx] = nex
22b70 74 50 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a 0a tPage;. }..
22b80 20 20 20 20 20 20 69 66 28 20 6f 66 66 73 65 74 if( offset
22b90 3e 3d 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 >=ovflSize ){.
22ba0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c /* The onl
22bb0 79 20 72 65 61 73 6f 6e 20 74 6f 20 72 65 61 64 y reason to read
22bc0 20 74 68 69 73 20 70 61 67 65 20 69 73 20 74 6f this page is to
22bd0 20 6f 62 74 61 69 6e 20 74 68 65 20 70 61 67 65 obtain the page
22be0 0a 20 20 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 . ** numb
22bf0 65 72 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 er for the next
22c00 70 61 67 65 20 69 6e 20 74 68 65 20 6f 76 65 72 page in the over
22c10 66 6c 6f 77 20 63 68 61 69 6e 2e 20 54 68 65 20 flow chain. The
22c20 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 page. **
22c30 64 61 74 61 20 69 73 20 6e 6f 74 20 72 65 71 75 data is not requ
22c40 69 72 65 64 2e 20 53 6f 20 66 69 72 73 74 20 74 ired. So first t
22c50 72 79 20 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 ry to lookup the
22c60 20 6f 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 overflow.
22c70 20 20 2a 2a 20 70 61 67 65 2d 6c 69 73 74 20 63 ** page-list c
22c80 61 63 68 65 2c 20 69 66 20 61 6e 79 2c 20 74 68 ache, if any, th
22c90 65 6e 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 en fall back to
22ca0 74 68 65 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 the getOverflowP
22cb0 61 67 65 28 29 0a 20 20 20 20 20 20 20 20 2a 2a age(). **
22cc0 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 20 20 20 function..
22cd0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
22ce0 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 61 Note that the a
22cf0 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 Overflow[] array
22d00 20 6d 75 73 74 20 62 65 20 61 6c 6c 6f 63 61 74 must be allocat
22d10 65 64 20 62 65 63 61 75 73 65 20 65 4f 70 21 3d ed because eOp!=
22d20 32 0a 20 20 20 20 20 20 20 20 2a 2a 20 68 65 72 2. ** her
22d30 65 2e 20 20 49 66 20 65 4f 70 3d 3d 32 2c 20 74 e. If eOp==2, t
22d40 68 65 6e 20 6f 66 66 73 65 74 3d 3d 30 20 61 6e hen offset==0 an
22d50 64 20 74 68 69 73 20 62 72 61 6e 63 68 20 69 73 d this branch is
22d60 20 6e 65 76 65 72 20 74 61 6b 65 6e 2e 0a 20 20 never taken..
22d70 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
22d80 20 61 73 73 65 72 74 28 20 65 4f 70 21 3d 32 20 assert( eOp!=2
22d90 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
22da0 74 28 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 t( pCur->curFlag
22db0 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 s & BTCF_ValidOv
22dc0 66 6c 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 fl );. if
22dd0 28 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f ( pCur->aOverflo
22de0 77 5b 69 49 64 78 2b 31 5d 20 29 7b 0a 20 20 20 w[iIdx+1] ){.
22df0 20 20 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 nextPage
22e00 3d 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f = pCur->aOverflo
22e10 77 5b 69 49 64 78 2b 31 5d 3b 0a 20 20 20 20 20 w[iIdx+1];.
22e20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
22e30 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 rc = getOver
22e40 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6e 65 flowPage(pBt, ne
22e50 78 74 50 61 67 65 2c 20 30 2c 20 26 6e 65 78 74 xtPage, 0, &next
22e60 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d Page);. }
22e70 0a 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 . offset
22e80 2d 3d 20 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 -= ovflSize;.
22e90 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
22ea0 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 72 65 61 /* Need to rea
22eb0 64 20 74 68 69 73 20 70 61 67 65 20 70 72 6f 70 d this page prop
22ec0 65 72 6c 79 2e 20 49 74 20 63 6f 6e 74 61 69 6e erly. It contain
22ed0 73 20 73 6f 6d 65 20 6f 66 20 74 68 65 0a 20 20 s some of the.
22ee0 20 20 20 20 20 20 2a 2a 20 72 61 6e 67 65 20 6f ** range o
22ef0 66 20 64 61 74 61 20 74 68 61 74 20 69 73 20 62 f data that is b
22f00 65 69 6e 67 20 72 65 61 64 20 28 65 4f 70 3d 3d eing read (eOp==
22f10 30 29 20 6f 72 20 77 72 69 74 74 65 6e 20 28 65 0) or written (e
22f20 4f 70 21 3d 30 29 2e 0a 20 20 20 20 20 20 20 20 Op!=0)..
22f30 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
22f40 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 _DIRECT_OVERFLOW
22f50 5f 52 45 41 44 0a 20 20 20 20 20 20 20 20 73 71 _READ. sq
22f60 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b 0a lite3_file *fd;.
22f70 23 65 6e 64 69 66 0a 20 20 20 20 20 20 20 20 69 #endif. i
22f80 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 nt a = amt;.
22f90 20 20 20 20 69 66 28 20 61 20 2b 20 6f 66 66 73 if( a + offs
22fa0 65 74 20 3e 20 6f 76 66 6c 53 69 7a 65 20 29 7b et > ovflSize ){
22fb0 0a 20 20 20 20 20 20 20 20 20 20 61 20 3d 20 6f . a = o
22fc0 76 66 6c 53 69 7a 65 20 2d 20 6f 66 66 73 65 74 vflSize - offset
22fd0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 23 69 66 ;. }..#if
22fe0 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 45 43 def SQLITE_DIREC
22ff0 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a T_OVERFLOW_READ.
23000 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6c /* If al
23010 6c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 l the following
23020 61 72 65 20 74 72 75 65 3a 0a 20 20 20 20 20 20 are true:.
23030 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 **. **
23040 20 20 31 29 20 74 68 69 73 20 69 73 20 61 20 72 1) this is a r
23050 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 2c 20 61 ead operation, a
23060 6e 64 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 nd . **
23070 20 32 29 20 64 61 74 61 20 69 73 20 72 65 71 75 2) data is requ
23080 69 72 65 64 20 66 72 6f 6d 20 74 68 65 20 73 74 ired from the st
23090 61 72 74 20 6f 66 20 74 68 69 73 20 6f 76 65 72 art of this over
230a0 66 6c 6f 77 20 70 61 67 65 2c 20 61 6e 64 0a 20 flow page, and.
230b0 20 20 20 20 20 20 20 2a 2a 20 20 20 33 29 20 74 ** 3) t
230c0 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 66 he database is f
230d0 69 6c 65 2d 62 61 63 6b 65 64 2c 20 61 6e 64 0a ile-backed, and.
230e0 20 20 20 20 20 20 20 20 2a 2a 20 20 20 34 29 20 ** 4)
230f0 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 70 65 6e there is no open
23100 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
23110 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 on, and.
23120 2a 2a 20 20 20 35 29 20 74 68 65 20 64 61 74 61 ** 5) the data
23130 62 61 73 65 20 69 73 20 6e 6f 74 20 61 20 57 41 base is not a WA
23140 4c 20 64 61 74 61 62 61 73 65 2c 0a 20 20 20 20 L database,.
23150 20 20 20 20 2a 2a 20 20 20 36 29 20 61 6c 6c 20 ** 6) all
23160 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 70 61 data from the pa
23170 67 65 20 69 73 20 62 65 69 6e 67 20 72 65 61 64 ge is being read
23180 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 37 .. ** 7
23190 29 20 61 74 20 6c 65 61 73 74 20 34 20 62 79 74 ) at least 4 byt
231a0 65 73 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 es have already
231b0 62 65 65 6e 20 72 65 61 64 20 69 6e 74 6f 20 74 been read into t
231c0 68 65 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 he output buffer
231d0 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 . **.
231e0 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 64 61 74 ** then dat
231f0 61 20 63 61 6e 20 62 65 20 72 65 61 64 20 64 69 a can be read di
23200 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 rectly from the
23210 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e database file in
23220 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a to the. *
23230 2a 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 2c * output buffer,
23240 20 62 79 70 61 73 73 69 6e 67 20 74 68 65 20 70 bypassing the p
23250 61 67 65 2d 63 61 63 68 65 20 61 6c 74 6f 67 65 age-cache altoge
23260 74 68 65 72 2e 20 54 68 69 73 20 73 70 65 65 64 ther. This speed
23270 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 75 70 20 s. ** up
23280 6c 6f 61 64 69 6e 67 20 6c 61 72 67 65 20 72 65 loading large re
23290 63 6f 72 64 73 20 74 68 61 74 20 73 70 61 6e 20 cords that span
232a0 6d 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 many overflow pa
232b0 67 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ges.. */.
232c0 20 20 20 20 20 20 20 20 69 66 28 20 28 65 4f 70 if( (eOp
232d0 26 30 78 30 31 29 3d 3d 30 20 20 20 20 20 20 20 &0x01)==0
232e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
232f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23300 2a 20 28 31 29 20 2a 2f 0a 20 20 20 20 20 20 20 * (1) */.
23310 20 20 26 26 20 6f 66 66 73 65 74 3d 3d 30 20 20 && offset==0
23320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23340 20 20 20 20 20 20 20 20 2f 2a 20 28 32 29 20 2a /* (2) *
23350 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 62 /. && (b
23360 45 6e 64 20 7c 7c 20 61 3d 3d 6f 76 66 6c 53 69 End || a==ovflSi
23370 7a 65 29 20 20 20 20 20 20 20 20 20 20 20 20 20 ze)
23380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23390 20 2f 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 /* (6) */.
233a0 20 20 20 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 && pBt->inTr
233b0 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
233c0 5f 52 45 41 44 20 20 20 20 20 20 20 20 20 20 20 _READ
233d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 34 29 /* (4)
233e0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 */. &&
233f0 28 66 64 20 3d 20 73 71 6c 69 74 65 33 50 61 67 (fd = sqlite3Pag
23400 65 72 46 69 6c 65 28 70 42 74 2d 3e 70 50 61 67 erFile(pBt->pPag
23410 65 72 29 29 2d 3e 70 4d 65 74 68 6f 64 73 20 20 er))->pMethods
23420 20 20 20 2f 2a 20 28 33 29 20 2a 2f 0a 20 20 20 /* (3) */.
23430 20 20 20 20 20 20 26 26 20 70 42 74 2d 3e 70 50 && pBt->pP
23440 61 67 65 31 2d 3e 61 44 61 74 61 5b 31 39 5d 3d age1->aData[19]=
23450 3d 30 78 30 31 20 20 20 20 20 20 20 20 20 20 20 =0x01
23460 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 /* (
23470 35 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 5) */. &
23480 26 20 26 70 42 75 66 5b 2d 34 5d 3e 3d 70 42 75 & &pBuf[-4]>=pBu
23490 66 53 74 61 72 74 20 20 20 20 20 20 20 20 20 20 fStart
234a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
234b0 20 20 20 20 20 2f 2a 20 28 37 29 20 2a 2f 0a 20 /* (7) */.
234c0 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 ){.
234d0 20 20 20 20 75 38 20 61 53 61 76 65 5b 34 5d 3b u8 aSave[4];
234e0 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 2a 61 . u8 *a
234f0 57 72 69 74 65 20 3d 20 26 70 42 75 66 5b 2d 34 Write = &pBuf[-4
23500 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 ];. ass
23510 65 72 74 28 20 61 57 72 69 74 65 3e 3d 70 42 75 ert( aWrite>=pBu
23520 66 53 74 61 72 74 20 29 3b 20 20 20 20 20 20 20 fStart );
23530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23540 20 20 2f 2a 20 68 65 6e 63 65 20 28 37 29 20 2a /* hence (7) *
23550 2f 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 /. memc
23560 70 79 28 61 53 61 76 65 2c 20 61 57 72 69 74 65 py(aSave, aWrite
23570 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 4);.
23580 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 rc = sqlite3OsRe
23590 61 64 28 66 64 2c 20 61 57 72 69 74 65 2c 20 61 ad(fd, aWrite, a
235a0 2b 34 2c 20 28 69 36 34 29 70 42 74 2d 3e 70 61 +4, (i64)pBt->pa
235b0 67 65 53 69 7a 65 2a 28 6e 65 78 74 50 61 67 65 geSize*(nextPage
235c0 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 -1));.
235d0 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 62 nextPage = get4b
235e0 79 74 65 28 61 57 72 69 74 65 29 3b 0a 20 20 20 yte(aWrite);.
235f0 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 57 memcpy(aW
23600 72 69 74 65 2c 20 61 53 61 76 65 2c 20 34 29 3b rite, aSave, 4);
23610 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 0a 23 . }else.#
23620 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 20 20 7b endif.. {
23630 0a 20 20 20 20 20 20 20 20 20 20 44 62 50 61 67 . DbPag
23640 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 20 20 e *pDbPage;.
23650 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
23660 65 33 50 61 67 65 72 41 63 71 75 69 72 65 28 70 e3PagerAcquire(p
23670 42 74 2d 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 Bt->pPager, next
23680 50 61 67 65 2c 20 26 70 44 62 50 61 67 65 2c 0a Page, &pDbPage,.
23690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 ((
236a0 65 4f 70 26 30 78 30 31 29 3d 3d 30 20 3f 20 50 eOp&0x01)==0 ? P
236b0 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c AGER_GET_READONL
236c0 59 20 3a 20 30 29 0a 20 20 20 20 20 20 20 20 20 Y : 0).
236d0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 );. if
236e0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
236f0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 ){. a
23700 50 61 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 Payload = sqlite
23710 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
23720 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
23730 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 nextPage = g
23740 65 74 34 62 79 74 65 28 61 50 61 79 6c 6f 61 64 et4byte(aPayload
23750 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
23760 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 c = copyPayload(
23770 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 &aPayload[offset
23780 2b 34 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 +4], pBuf, a, (e
23790 4f 70 26 30 78 30 31 29 2c 20 70 44 62 50 61 67 Op&0x01), pDbPag
237a0 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
237b0 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
237c0 66 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 f(pDbPage);.
237d0 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d offset =
237e0 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 0;. }.
237f0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
23800 20 20 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 amt -= a;.
23810 20 20 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 pBuf += a;.
23820 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
23830 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 .. if( rc==SQLI
23840 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 TE_OK && amt>0 )
23850 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
23860 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
23870 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
23880 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 c;.}../*.** Read
23890 20 70 61 72 74 20 6f 66 20 74 68 65 20 6b 65 79 part of the key
238a0 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
238b0 20 63 75 72 73 6f 72 20 70 43 75 72 2e 20 20 45 cursor pCur. E
238c0 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 xactly.** "amt"
238d0 62 79 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 bytes will be tr
238e0 61 6e 73 66 65 72 72 65 64 20 69 6e 74 6f 20 70 ansferred into p
238f0 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e Buf[]. The tran
23900 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 sfer.** begins a
23910 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a t "offset"..**.*
23920 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 * The caller mus
23930 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 70 43 t ensure that pC
23940 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 ur is pointing t
23950 6f 20 61 20 76 61 6c 69 64 20 72 6f 77 0a 2a 2a o a valid row.**
23960 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a in the table..*
23970 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 *.** Return SQLI
23980 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 TE_OK on success
23990 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 or an error cod
239a0 65 20 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f e if anything go
239b0 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e es.** wrong. An
239c0 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e error is return
239d0 65 64 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d ed if "offset+am
239e0 74 22 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 t" is larger tha
239f0 6e 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 n.** the availab
23a00 6c 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 le payload..*/.i
23a10 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b nt sqlite3BtreeK
23a20 65 79 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ey(BtCursor *pCu
23a30 72 2c 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 r, u32 offset, u
23a40 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 32 amt, void *pB
23a50 75 66 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 uf){. assert( c
23a60 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
23a70 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
23a80 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
23a90 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
23aa0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
23ab0 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 70 43 75 >iPage>=0 && pCu
23ac0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
23ad0 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 iPage] );. asse
23ae0 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b rt( pCur->aiIdx[
23af0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 pCur->iPage]<pCu
23b00 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
23b10 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b iPage]->nCell );
23b20 0a 20 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 . return access
23b30 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 Payload(pCur, of
23b40 66 73 65 74 2c 20 61 6d 74 2c 20 28 75 6e 73 69 fset, amt, (unsi
23b50 67 6e 65 64 20 63 68 61 72 2a 29 70 42 75 66 2c gned char*)pBuf,
23b60 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 0);.}../*.** Re
23b70 61 64 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 ad part of the d
23b80 61 74 61 20 61 73 73 6f 63 69 61 74 65 64 20 77 ata associated w
23b90 69 74 68 20 63 75 72 73 6f 72 20 70 43 75 72 2e ith cursor pCur.
23ba0 20 20 45 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d Exactly.** "am
23bb0 74 22 20 62 79 74 65 73 20 77 69 6c 6c 20 62 65 t" bytes will be
23bc0 20 74 72 61 6e 73 66 65 72 65 64 20 69 6e 74 6f transfered into
23bd0 20 70 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 pBuf[]. The tr
23be0 61 6e 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 ansfer.** begins
23bf0 20 61 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a at "offset"..**
23c00 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 .** Return SQLIT
23c10 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 E_OK on success
23c20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 or an error code
23c30 20 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 if anything goe
23c40 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 s.** wrong. An
23c50 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 error is returne
23c60 64 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 d if "offset+amt
23c70 22 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e " is larger than
23c80 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c .** the availabl
23c90 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e e payload..*/.in
23ca0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 t sqlite3BtreeDa
23cb0 74 61 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ta(BtCursor *pCu
23cc0 72 2c 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 r, u32 offset, u
23cd0 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 32 amt, void *pB
23ce0 75 66 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a uf){. int rc;..
23cf0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
23d00 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69 MIT_INCRBLOB. i
23d10 66 20 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 f ( pCur->eState
23d20 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
23d30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
23d40 51 4c 49 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d QLITE_ABORT;. }
23d50 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
23d60 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 t( cursorHoldsMu
23d70 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 72 tex(pCur) );. r
23d80 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f c = restoreCurso
23d90 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b rPosition(pCur);
23da0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
23db0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 E_OK ){. asse
23dc0 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
23dd0 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
23de0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 ;. assert( pC
23df0 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 ur->iPage>=0 &&
23e00 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
23e10 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 20 r->iPage] );.
23e20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
23e30 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
23e40 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 ]<pCur->apPage[p
23e50 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 Cur->iPage]->nCe
23e60 6c 6c 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 ll );. rc = a
23e70 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 ccessPayload(pCu
23e80 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 r, offset, amt,
23e90 70 42 75 66 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 pBuf, 0);. }.
23ea0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
23eb0 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 .** Return a poi
23ec0 6e 74 65 72 20 74 6f 20 70 61 79 6c 6f 61 64 20 nter to payload
23ed0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d information from
23ee0 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 the entry that
23ef0 74 68 65 20 0a 2a 2a 20 70 43 75 72 20 63 75 72 the .** pCur cur
23f00 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 sor is pointing
23f10 74 6f 2e 20 20 54 68 65 20 70 6f 69 6e 74 65 72 to. The pointer
23f20 20 69 73 20 74 6f 20 74 68 65 20 62 65 67 69 6e is to the begin
23f30 6e 69 6e 67 20 6f 66 0a 2a 2a 20 74 68 65 20 6b ning of.** the k
23f40 65 79 20 69 66 20 69 6e 64 65 78 20 62 74 72 65 ey if index btre
23f50 65 73 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 es (pPage->intKe
23f60 79 3d 3d 30 29 20 61 6e 64 20 69 73 20 74 68 65 y==0) and is the
23f70 20 64 61 74 61 20 66 6f 72 0a 2a 2a 20 74 61 62 data for.** tab
23f80 6c 65 20 62 74 72 65 65 73 20 28 70 50 61 67 65 le btrees (pPage
23f90 2d 3e 69 6e 74 4b 65 79 3d 3d 31 29 2e 20 54 68 ->intKey==1). Th
23fa0 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
23fb0 73 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 0a 2a s of available.*
23fc0 2a 20 6b 65 79 2f 64 61 74 61 20 69 73 20 77 72 * key/data is wr
23fd0 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 41 6d 74 itten into *pAmt
23fe0 2e 20 20 49 66 20 2a 70 41 6d 74 3d 3d 30 2c 20 . If *pAmt==0,
23ff0 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 0a 2a then the value.*
24000 2a 20 72 65 74 75 72 6e 65 64 20 77 69 6c 6c 20 * returned will
24010 6e 6f 74 20 62 65 20 61 20 76 61 6c 69 64 20 70 not be a valid p
24020 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 ointer..**.** Th
24030 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6e is routine is an
24040 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 optimization.
24050 49 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 66 6f 72 It is common for
24060 20 74 68 65 20 65 6e 74 69 72 65 20 6b 65 79 0a the entire key.
24070 2a 2a 20 61 6e 64 20 64 61 74 61 20 74 6f 20 66 ** and data to f
24080 69 74 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 it on the local
24090 70 61 67 65 20 61 6e 64 20 66 6f 72 20 74 68 65 page and for the
240a0 72 65 20 74 6f 20 62 65 20 6e 6f 20 6f 76 65 72 re to be no over
240b0 66 6c 6f 77 0a 2a 2a 20 70 61 67 65 73 2e 20 20 flow.** pages.
240c0 57 68 65 6e 20 74 68 61 74 20 69 73 20 73 6f 2c When that is so,
240d0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 63 61 this routine ca
240e0 6e 20 62 65 20 75 73 65 64 20 74 6f 20 61 63 63 n be used to acc
240f0 65 73 73 20 74 68 65 0a 2a 2a 20 6b 65 79 20 61 ess the.** key a
24100 6e 64 20 64 61 74 61 20 77 69 74 68 6f 75 74 20 nd data without
24110 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 2e 20 20 making a copy.
24120 49 66 20 74 68 65 20 6b 65 79 20 61 6e 64 2f 6f If the key and/o
24130 72 20 64 61 74 61 20 73 70 69 6c 6c 73 0a 2a 2a r data spills.**
24140 20 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 onto overflow p
24150 61 67 65 73 2c 20 74 68 65 6e 20 61 63 63 65 73 ages, then acces
24160 73 50 61 79 6c 6f 61 64 28 29 20 6d 75 73 74 20 sPayload() must
24170 62 65 20 75 73 65 64 20 74 6f 20 72 65 61 73 73 be used to reass
24180 65 6d 62 6c 65 0a 2a 2a 20 74 68 65 20 6b 65 79 emble.** the key
24190 2f 64 61 74 61 20 61 6e 64 20 63 6f 70 79 20 69 /data and copy i
241a0 74 20 69 6e 74 6f 20 61 20 70 72 65 61 6c 6c 6f t into a preallo
241b0 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a 2a 2a cated buffer..**
241c0 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 .** The pointer
241d0 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 returned by this
241e0 20 72 6f 75 74 69 6e 65 20 6c 6f 6f 6b 73 20 64 routine looks d
241f0 69 72 65 63 74 6c 79 20 69 6e 74 6f 20 74 68 65 irectly into the
24200 20 63 61 63 68 65 64 0a 2a 2a 20 70 61 67 65 20 cached.** page
24210 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2e of the database.
24220 20 20 54 68 65 20 64 61 74 61 20 6d 69 67 68 74 The data might
24230 20 63 68 61 6e 67 65 20 6f 72 20 6d 6f 76 65 20 change or move
24240 74 68 65 20 6e 65 78 74 20 74 69 6d 65 0a 2a 2a the next time.**
24250 20 61 6e 79 20 62 74 72 65 65 20 72 6f 75 74 69 any btree routi
24260 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f ne is called..*/
24270 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 76 6f .static const vo
24280 69 64 20 2a 66 65 74 63 68 50 61 79 6c 6f 61 64 id *fetchPayload
24290 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 (. BtCursor *pC
242a0 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 ur, /* Curs
242b0 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 or pointing to e
242c0 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f ntry to read fro
242d0 6d 20 2a 2f 0a 20 20 75 33 32 20 2a 70 41 6d 74 m */. u32 *pAmt
242e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
242f0 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 rite the number
24300 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 of available byt
24310 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 es here */.){.
24320 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 assert( pCur!=0
24330 26 26 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d && pCur->iPage>=
24340 30 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 0 && pCur->apPag
24350 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b e[pCur->iPage]);
24360 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
24370 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
24380 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
24390 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
243a0 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 _held(pCur->pBtr
243b0 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ee->db->mutex) )
243c0 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
243d0 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
243e0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
243f0 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
24400 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d 3e 61 ->iPage]<pCur->a
24410 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
24420 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 e]->nCell );. a
24430 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 ssert( pCur->inf
24440 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 20 2a o.nSize>0 );. *
24450 70 41 6d 74 20 3d 20 70 43 75 72 2d 3e 69 6e 66 pAmt = pCur->inf
24460 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 72 65 74 75 o.nLocal;. retu
24470 72 6e 20 28 76 6f 69 64 2a 29 70 43 75 72 2d 3e rn (void*)pCur->
24480 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3b 0a 7d info.pPayload;.}
24490 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 .../*.** For the
244a0 20 65 6e 74 72 79 20 74 68 61 74 20 63 75 72 73 entry that curs
244b0 6f 72 20 70 43 75 72 20 69 73 20 70 6f 69 6e 74 or pCur is point
244c0 20 74 6f 2c 20 72 65 74 75 72 6e 20 61 73 0a 2a to, return as.*
244d0 2a 20 6d 61 6e 79 20 62 79 74 65 73 20 6f 66 20 * many bytes of
244e0 74 68 65 20 6b 65 79 20 6f 72 20 64 61 74 61 20 the key or data
244f0 61 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 as are available
24500 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 0a 2a 2a on the local.**
24510 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 20 57 b-tree page. W
24520 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 rite the number
24530 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 of available byt
24540 65 73 20 69 6e 74 6f 20 2a 70 41 6d 74 2e 0a 2a es into *pAmt..*
24550 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 *.** The pointer
24560 20 72 65 74 75 72 6e 65 64 20 69 73 20 65 70 68 returned is eph
24570 65 6d 65 72 61 6c 2e 20 20 54 68 65 20 6b 65 79 emeral. The key
24580 2f 64 61 74 61 20 6d 61 79 20 6d 6f 76 65 0a 2a /data may move.*
24590 2a 20 6f 72 20 62 65 20 64 65 73 74 72 6f 79 65 * or be destroye
245a0 64 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 63 61 d on the next ca
245b0 6c 6c 20 74 6f 20 61 6e 79 20 42 74 72 65 65 20 ll to any Btree
245c0 72 6f 75 74 69 6e 65 2c 0a 2a 2a 20 69 6e 63 6c routine,.** incl
245d0 75 64 69 6e 67 20 63 61 6c 6c 73 20 66 72 6f 6d uding calls from
245e0 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20 61 other threads a
245f0 67 61 69 6e 73 74 20 74 68 65 20 73 61 6d 65 20 gainst the same
24600 63 61 63 68 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c cache..** Hence,
24610 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20 a mutex on the
24620 42 74 53 68 61 72 65 64 20 73 68 6f 75 6c 64 20 BtShared should
24630 62 65 20 68 65 6c 64 20 70 72 69 6f 72 20 74 6f be held prior to
24640 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 74 68 69 73 calling.** this
24650 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 routine..**.**
24660 54 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 69 These routines i
24670 73 20 75 73 65 64 20 74 6f 20 67 65 74 20 71 75 s used to get qu
24680 69 63 6b 20 61 63 63 65 73 73 20 74 6f 20 6b 65 ick access to ke
24690 79 20 61 6e 64 20 64 61 74 61 0a 2a 2a 20 69 6e y and data.** in
246a0 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 the common case
246b0 20 77 68 65 72 65 20 6e 6f 20 6f 76 65 72 66 6c where no overfl
246c0 6f 77 20 70 61 67 65 73 20 61 72 65 20 75 73 65 ow pages are use
246d0 64 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 d..*/.const void
246e0 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 *sqlite3BtreeKe
246f0 79 46 65 74 63 68 28 42 74 43 75 72 73 6f 72 20 yFetch(BtCursor
24700 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 41 6d 74 *pCur, u32 *pAmt
24710 29 7b 0a 20 20 72 65 74 75 72 6e 20 66 65 74 63 ){. return fetc
24720 68 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 hPayload(pCur, p
24730 41 6d 74 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f Amt);.}.const vo
24740 69 64 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 id *sqlite3Btree
24750 44 61 74 61 46 65 74 63 68 28 42 74 43 75 72 73 DataFetch(BtCurs
24760 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 or *pCur, u32 *p
24770 41 6d 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 66 Amt){. return f
24780 65 74 63 68 50 61 79 6c 6f 61 64 28 70 43 75 72 etchPayload(pCur
24790 2c 20 70 41 6d 74 29 3b 0a 7d 0a 0a 0a 2f 2a 0a , pAmt);.}.../*.
247a0 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
247b0 6f 72 20 64 6f 77 6e 20 74 6f 20 61 20 6e 65 77 or down to a new
247c0 20 63 68 69 6c 64 20 70 61 67 65 2e 20 20 54 68 child page. Th
247d0 65 20 6e 65 77 50 67 6e 6f 20 61 72 67 75 6d 65 e newPgno argume
247e0 6e 74 20 69 73 20 74 68 65 0a 2a 2a 20 70 61 67 nt is the.** pag
247f0 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
24800 63 68 69 6c 64 20 70 61 67 65 20 74 6f 20 6d 6f child page to mo
24810 76 65 20 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 ve to..**.** Thi
24820 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
24830 6e 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 ns SQLITE_CORRUP
24840 54 20 69 66 20 74 68 65 20 70 61 67 65 2d 68 65 T if the page-he
24850 61 64 65 72 20 66 6c 61 67 73 20 66 69 65 6c 64 ader flags field
24860 20 6f 66 0a 2a 2a 20 74 68 65 20 6e 65 77 20 63 of.** the new c
24870 68 69 6c 64 20 70 61 67 65 20 64 6f 65 73 20 6e hild page does n
24880 6f 74 20 6d 61 74 63 68 20 74 68 65 20 66 6c 61 ot match the fla
24890 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 gs field of the
248a0 70 61 72 65 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 parent (i.e..**
248b0 69 66 20 61 6e 20 69 6e 74 6b 65 79 20 70 61 67 if an intkey pag
248c0 65 20 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 e appears to be
248d0 74 68 65 20 70 61 72 65 6e 74 20 6f 66 20 61 20 the parent of a
248e0 6e 6f 6e 2d 69 6e 74 6b 65 79 20 70 61 67 65 2c non-intkey page,
248f0 20 6f 72 0a 2a 2a 20 76 69 63 65 2d 76 65 72 73 or.** vice-vers
24900 61 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e a)..*/.static in
24910 74 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 42 74 t moveToChild(Bt
24920 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 Cursor *pCur, u3
24930 32 20 6e 65 77 50 67 6e 6f 29 7b 0a 20 20 69 6e 2 newPgno){. in
24940 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 20 3d 20 t rc;. int i =
24950 70 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 4d pCur->iPage;. M
24960 65 6d 50 61 67 65 20 2a 70 4e 65 77 50 61 67 65 emPage *pNewPage
24970 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
24980 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 0a t = pCur->pBt;..
24990 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
249a0 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
249b0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
249c0 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
249d0 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 OR_VALID );. as
249e0 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 sert( pCur->iPag
249f0 65 3c 42 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 e<BTCURSOR_MAX_D
24a00 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 EPTH );. assert
24a10 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 ( pCur->iPage>=0
24a20 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e );. if( pCur->
24a30 69 50 61 67 65 3e 3d 28 42 54 43 55 52 53 4f 52 iPage>=(BTCURSOR
24a40 5f 4d 41 58 5f 44 45 50 54 48 2d 31 29 20 29 7b _MAX_DEPTH-1) ){
24a50 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
24a60 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
24a70 0a 20 20 7d 0a 20 20 72 63 20 3d 20 67 65 74 41 . }. rc = getA
24a80 6e 64 49 6e 69 74 50 61 67 65 28 70 42 74 2c 20 ndInitPage(pBt,
24a90 6e 65 77 50 67 6e 6f 2c 20 26 70 4e 65 77 50 61 newPgno, &pNewPa
24aa0 67 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ge,.
24ab0 20 20 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 (pCur->curFla
24ac0 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
24ad0 6c 61 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f lag)==0 ? PAGER_
24ae0 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 GET_READONLY : 0
24af0 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 );. if( rc ) re
24b00 74 75 72 6e 20 72 63 3b 0a 20 20 70 43 75 72 2d turn rc;. pCur-
24b10 3e 61 70 50 61 67 65 5b 69 2b 31 5d 20 3d 20 70 >apPage[i+1] = p
24b20 4e 65 77 50 61 67 65 3b 0a 20 20 70 43 75 72 2d NewPage;. pCur-
24b30 3e 61 69 49 64 78 5b 69 2b 31 5d 20 3d 20 30 3b >aiIdx[i+1] = 0;
24b40 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 2b 2b . pCur->iPage++
24b50 3b 0a 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ;.. pCur->info.
24b60 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 nSize = 0;. pCu
24b70 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e r->curFlags &= ~
24b80 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c (BTCF_ValidNKey|
24b90 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b BTCF_ValidOvfl);
24ba0 0a 20 20 69 66 28 20 70 4e 65 77 50 61 67 65 2d . if( pNewPage-
24bb0 3e 6e 43 65 6c 6c 3c 31 20 7c 7c 20 70 4e 65 77 >nCell<1 || pNew
24bc0 50 61 67 65 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 Page->intKey!=pC
24bd0 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 69 ur->apPage[i]->i
24be0 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 72 65 74 ntKey ){. ret
24bf0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
24c00 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 PT_BKPT;. }. r
24c10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
24c20 0a 7d 0a 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 .}..#if 0./*.**
24c30 50 61 67 65 20 70 50 61 72 65 6e 74 20 69 73 20 Page pParent is
24c40 61 6e 20 69 6e 74 65 72 6e 61 6c 20 28 6e 6f 6e an internal (non
24c50 2d 6c 65 61 66 29 20 74 72 65 65 20 70 61 67 65 -leaf) tree page
24c60 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
24c70 0a 2a 2a 20 61 73 73 65 72 74 73 20 74 68 61 74 .** asserts that
24c80 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 43 68 page number iCh
24c90 69 6c 64 20 69 73 20 74 68 65 20 6c 65 66 74 2d ild is the left-
24ca0 63 68 69 6c 64 20 69 66 20 74 68 65 20 69 49 64 child if the iId
24cb0 78 27 74 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 x'th.** cell in
24cc0 70 61 67 65 20 70 50 61 72 65 6e 74 2e 20 4f 72 page pParent. Or
24cd0 2c 20 69 66 20 69 49 64 78 20 69 73 20 65 71 75 , if iIdx is equ
24ce0 61 6c 20 74 6f 20 74 68 65 20 74 6f 74 61 6c 20 al to the total
24cf0 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 65 6c number of.** cel
24d00 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 2c 20 74 ls in pParent, t
24d10 68 61 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 hat page number
24d20 69 43 68 69 6c 64 20 69 73 20 74 68 65 20 72 69 iChild is the ri
24d30 67 68 74 2d 63 68 69 6c 64 20 6f 66 0a 2a 2a 20 ght-child of.**
24d40 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 the page..*/.sta
24d50 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 50 tic void assertP
24d60 61 72 65 6e 74 49 6e 64 65 78 28 4d 65 6d 50 61 arentIndex(MemPa
24d70 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 69 6e 74 ge *pParent, int
24d80 20 69 49 64 78 2c 20 50 67 6e 6f 20 69 43 68 69 iIdx, Pgno iChi
24d90 6c 64 29 7b 0a 20 20 61 73 73 65 72 74 28 20 69 ld){. assert( i
24da0 49 64 78 3c 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 Idx<=pParent->nC
24db0 65 6c 6c 20 29 3b 0a 20 20 69 66 28 20 69 49 64 ell );. if( iId
24dc0 78 3d 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c x==pParent->nCel
24dd0 6c 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 l ){. assert(
24de0 20 67 65 74 34 62 79 74 65 28 26 70 50 61 72 65 get4byte(&pPare
24df0 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e nt->aData[pParen
24e00 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 t->hdrOffset+8])
24e10 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 65 ==iChild );. }e
24e20 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 lse{. assert(
24e30 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 get4byte(findCe
24e40 6c 6c 28 70 50 61 72 65 6e 74 2c 20 69 49 64 78 ll(pParent, iIdx
24e50 29 29 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 ))==iChild );.
24e60 7d 0a 7d 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 }.}.#else.# def
24e70 69 6e 65 20 61 73 73 65 72 74 50 61 72 65 6e 74 ine assertParent
24e80 49 6e 64 65 78 28 78 2c 79 2c 7a 29 20 0a 23 65 Index(x,y,z) .#e
24e90 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 ndif../*.** Move
24ea0 20 74 68 65 20 63 75 72 73 6f 72 20 75 70 20 74 the cursor up t
24eb0 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 o the parent pag
24ec0 65 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 e..**.** pCur->i
24ed0 64 78 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 dx is set to the
24ee0 20 63 65 6c 6c 20 69 6e 64 65 78 20 74 68 61 74 cell index that
24ef0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 6f contains the po
24f00 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 inter.** to the
24f10 70 61 67 65 20 77 65 20 61 72 65 20 63 6f 6d 69 page we are comi
24f20 6e 67 20 66 72 6f 6d 2e 20 20 49 66 20 77 65 20 ng from. If we
24f30 61 72 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 are coming from
24f40 74 68 65 0a 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 the.** right-mos
24f50 74 20 63 68 69 6c 64 20 70 61 67 65 20 74 68 65 t child page the
24f60 6e 20 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 n pCur->idx is s
24f70 65 74 20 74 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 et to one more t
24f80 68 61 6e 0a 2a 2a 20 74 68 65 20 6c 61 72 67 65 han.** the large
24f90 73 74 20 63 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a st cell index..*
24fa0 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 6f /.static void mo
24fb0 76 65 54 6f 50 61 72 65 6e 74 28 42 74 43 75 72 veToParent(BtCur
24fc0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 sor *pCur){. as
24fd0 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
24fe0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
24ff0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
25000 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
25010 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 ALID );. assert
25020 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 ( pCur->iPage>0
25030 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
25040 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
25050 69 50 61 67 65 5d 20 29 3b 0a 0a 20 20 2f 2a 20 iPage] );.. /*
25060 55 50 44 41 54 45 3a 20 49 74 20 69 73 20 61 63 UPDATE: It is ac
25070 74 75 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 tually possible
25080 66 6f 72 20 74 68 65 20 63 6f 6e 64 69 74 69 6f for the conditio
25090 6e 20 74 65 73 74 65 64 20 62 79 20 74 68 65 20 n tested by the
250a0 61 73 73 65 72 74 0a 20 20 2a 2a 20 62 65 6c 6f assert. ** belo
250b0 77 20 74 6f 20 62 65 20 75 6e 74 72 75 65 20 69 w to be untrue i
250c0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
250d0 69 6c 65 20 69 73 20 63 6f 72 72 75 70 74 2e 20 ile is corrupt.
250e0 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72 20 69 This can occur i
250f0 66 0a 20 20 2a 2a 20 6f 6e 65 20 63 75 72 73 6f f. ** one curso
25100 72 20 68 61 73 20 6d 6f 64 69 66 69 65 64 20 70 r has modified p
25110 61 67 65 20 70 50 61 72 65 6e 74 20 77 68 69 6c age pParent whil
25120 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f e a reference to
25130 20 69 74 20 69 73 20 68 65 6c 64 20 0a 20 20 2a it is held . *
25140 2a 20 62 79 20 61 20 73 65 63 6f 6e 64 20 63 75 * by a second cu
25150 72 73 6f 72 2e 20 57 68 69 63 68 20 63 61 6e 20 rsor. Which can
25160 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 61 only happen if a
25170 20 73 69 6e 67 6c 65 20 70 61 67 65 20 69 73 20 single page is
25180 6c 69 6e 6b 65 64 0a 20 20 2a 2a 20 69 6e 74 6f linked. ** into
25190 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 62 more than one b
251a0 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 -tree structure
251b0 69 6e 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 in a corrupt dat
251c0 61 62 61 73 65 2e 20 20 2a 2f 0a 23 69 66 20 30 abase. */.#if 0
251d0 0a 20 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 . assertParentI
251e0 6e 64 65 78 28 0a 20 20 20 20 70 43 75 72 2d 3e ndex(. pCur->
251f0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
25200 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 ge-1], . pCur
25210 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
25220 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 age-1], . pCu
25230 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
25240 69 50 61 67 65 5d 2d 3e 70 67 6e 6f 0a 20 20 29 iPage]->pgno. )
25250 3b 0a 23 65 6e 64 69 66 0a 20 20 74 65 73 74 63 ;.#endif. testc
25260 61 73 65 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ase( pCur->aiIdx
25270 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 20 [pCur->iPage-1]
25280 3e 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 > pCur->apPage[p
25290 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2d 3e 6e Cur->iPage-1]->n
252a0 43 65 6c 6c 20 29 3b 0a 0a 20 20 72 65 6c 65 61 Cell );.. relea
252b0 73 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 sePage(pCur->apP
252c0 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
252d0 29 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 );. pCur->iPage
252e0 2d 2d 3b 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f --;. pCur->info
252f0 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 .nSize = 0;. pC
25300 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 ur->curFlags &=
25310 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 ~(BTCF_ValidNKey
25320 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 |BTCF_ValidOvfl)
25330 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 ;.}../*.** Move
25340 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f the cursor to po
25350 69 6e 74 20 74 6f 20 74 68 65 20 72 6f 6f 74 20 int to the root
25360 70 61 67 65 20 6f 66 20 69 74 73 20 62 2d 74 72 page of its b-tr
25370 65 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a ee structure..**
25380 0a 2a 2a 20 49 66 20 74 68 65 20 74 61 62 6c 65 .** If the table
25390 20 68 61 73 20 61 20 76 69 72 74 75 61 6c 20 72 has a virtual r
253a0 6f 6f 74 20 70 61 67 65 2c 20 74 68 65 6e 20 74 oot page, then t
253b0 68 65 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 he cursor is mov
253c0 65 64 20 74 6f 20 70 6f 69 6e 74 0a 2a 2a 20 74 ed to point.** t
253d0 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 72 6f o the virtual ro
253e0 6f 74 20 70 61 67 65 20 69 6e 73 74 65 61 64 20 ot page instead
253f0 6f 66 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f of the actual ro
25400 6f 74 20 70 61 67 65 2e 20 41 20 74 61 62 6c 65 ot page. A table
25410 20 68 61 73 20 61 0a 2a 2a 20 76 69 72 74 75 61 has a.** virtua
25420 6c 20 72 6f 6f 74 20 70 61 67 65 20 77 68 65 6e l root page when
25430 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 the actual root
25440 20 70 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 6e page contains n
25450 6f 20 63 65 6c 6c 73 20 61 6e 64 20 61 20 0a 2a o cells and a .*
25460 2a 20 73 69 6e 67 6c 65 20 63 68 69 6c 64 20 70 * single child p
25470 61 67 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e age. This can on
25480 6c 79 20 68 61 70 70 65 6e 20 77 69 74 68 20 74 ly happen with t
25490 68 65 20 74 61 62 6c 65 20 72 6f 6f 74 65 64 20 he table rooted
254a0 61 74 20 70 61 67 65 20 31 2e 0a 2a 2a 0a 2a 2a at page 1..**.**
254b0 20 49 66 20 74 68 65 20 62 2d 74 72 65 65 20 73 If the b-tree s
254c0 74 72 75 63 74 75 72 65 20 69 73 20 65 6d 70 74 tructure is empt
254d0 79 2c 20 74 68 65 20 63 75 72 73 6f 72 20 73 74 y, the cursor st
254e0 61 74 65 20 69 73 20 73 65 74 20 74 6f 20 0a 2a ate is set to .*
254f0 2a 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 * CURSOR_INVALID
25500 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 . Otherwise, the
25510 20 63 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 cursor is set t
25520 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 o point to the f
25530 69 72 73 74 0a 2a 2a 20 63 65 6c 6c 20 6c 6f 63 irst.** cell loc
25540 61 74 65 64 20 6f 6e 20 74 68 65 20 72 6f 6f 74 ated on the root
25550 20 28 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f (or virtual roo
25560 74 29 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 t) page and the
25570 63 75 72 73 6f 72 20 73 74 61 74 65 0a 2a 2a 20 cursor state.**
25580 69 73 20 73 65 74 20 74 6f 20 43 55 52 53 4f 52 is set to CURSOR
25590 5f 56 41 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 _VALID..**.** If
255a0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
255b0 65 74 75 72 6e 73 20 73 75 63 63 65 73 73 66 75 eturns successfu
255c0 6c 6c 79 2c 20 69 74 20 6d 61 79 20 62 65 20 61 lly, it may be a
255d0 73 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 0a ssumed that the.
255e0 2a 2a 20 70 61 67 65 2d 68 65 61 64 65 72 20 66 ** page-header f
255f0 6c 61 67 73 20 69 6e 64 69 63 61 74 65 20 74 68 lags indicate th
25600 61 74 20 74 68 65 20 5b 76 69 72 74 75 61 6c 5d at the [virtual]
25610 20 72 6f 6f 74 2d 70 61 67 65 20 69 73 20 74 68 root-page is th
25620 65 20 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 6b e expected .** k
25630 69 6e 64 20 6f 66 20 62 2d 74 72 65 65 20 70 61 ind of b-tree pa
25640 67 65 20 28 69 2e 65 2e 20 69 66 20 77 68 65 6e ge (i.e. if when
25650 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 63 75 72 opening the cur
25660 73 6f 72 20 74 68 65 20 63 61 6c 6c 65 72 20 64 sor the caller d
25670 69 64 20 6e 6f 74 0a 2a 2a 20 73 70 65 63 69 66 id not.** specif
25680 79 20 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 y a KeyInfo stru
25690 63 74 75 72 65 20 74 68 65 20 66 6c 61 67 73 20 cture the flags
256a0 62 79 74 65 20 69 73 20 73 65 74 20 74 6f 20 30 byte is set to 0
256b0 78 30 35 20 6f 72 20 30 78 30 44 2c 0a 2a 2a 20 x05 or 0x0D,.**
256c0 69 6e 64 69 63 61 74 69 6e 67 20 61 20 74 61 62 indicating a tab
256d0 6c 65 20 62 2d 74 72 65 65 2c 20 6f 72 20 69 66 le b-tree, or if
256e0 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 the caller did
256f0 73 70 65 63 69 66 79 20 61 20 4b 65 79 49 6e 66 specify a KeyInf
25700 6f 20 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 o .** structure
25710 74 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 69 the flags byte i
25720 73 20 73 65 74 20 74 6f 20 30 78 30 32 20 6f 72 s set to 0x02 or
25730 20 30 78 30 41 2c 20 69 6e 64 69 63 61 74 69 6e 0x0A, indicatin
25740 67 20 61 6e 20 69 6e 64 65 78 0a 2a 2a 20 62 2d g an index.** b-
25750 74 72 65 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 tree)..*/.static
25760 20 69 6e 74 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 int moveToRoot(
25770 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
25780 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 52 6f 6f . MemPage *pRoo
25790 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 t;. int rc = SQ
257a0 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 LITE_OK;.. asse
257b0 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
257c0 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
257d0 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 49 assert( CURSOR_I
257e0 4e 56 41 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f NVALID < CURSOR_
257f0 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 REQUIRESEEK );.
25800 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f assert( CURSOR_
25810 56 41 4c 49 44 20 20 20 3c 20 43 55 52 53 4f 52 VALID < CURSOR
25820 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a _REQUIRESEEK );.
25830 20 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 assert( CURSOR
25840 5f 46 41 55 4c 54 20 20 20 3e 20 43 55 52 53 4f _FAULT > CURSO
25850 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b R_REQUIRESEEK );
25860 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
25870 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 ate>=CURSOR_REQU
25880 49 52 45 53 45 45 4b 20 29 7b 0a 20 20 20 20 69 IRESEEK ){. i
25890 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d f( pCur->eState=
258a0 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b =CURSOR_FAULT ){
258b0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
258c0 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 Cur->skipNext!=S
258d0 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 QLITE_OK );.
258e0 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 return pCur->s
258f0 6b 69 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 kipNext;. }.
25900 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
25910 6c 65 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 learCursor(pCur)
25920 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 75 ;. }.. if( pCu
25930 72 2d 3e 69 50 61 67 65 3e 3d 30 20 29 7b 0a 20 r->iPage>=0 ){.
25940 20 20 20 77 68 69 6c 65 28 20 70 43 75 72 2d 3e while( pCur->
25950 69 50 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 iPage ) releaseP
25960 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 67 65 age(pCur->apPage
25970 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 5d 29 [pCur->iPage--])
25980 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 ;. }else if( pC
25990 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
259a0 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
259b0 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
259c0 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 75 72 6e ALID;. return
259d0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
259e0 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 67 65 lse{. rc = ge
259f0 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 43 75 tAndInitPage(pCu
25a00 72 2d 3e 70 42 74 72 65 65 2d 3e 70 42 74 2c 20 r->pBtree->pBt,
25a10 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 2c 20 pCur->pgnoRoot,
25a20 26 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d &pCur->apPage[0]
25a30 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
25a40 20 20 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 (pCur->curFla
25a50 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
25a60 6c 61 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f lag)==0 ? PAGER_
25a70 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 GET_READONLY : 0
25a80 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
25a90 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
25aa0 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
25ab0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
25ac0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
25ad0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 ;. }. pCur
25ae0 2d 3e 69 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d ->iPage = 0;. }
25af0 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d . pRoot = pCur-
25b00 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 20 61 73 >apPage[0];. as
25b10 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 70 67 6e sert( pRoot->pgn
25b20 6f 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f o==pCur->pgnoRoo
25b30 74 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 43 t );.. /* If pC
25b40 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 69 73 20 ur->pKeyInfo is
25b50 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 not NULL, then t
25b60 68 65 20 63 61 6c 6c 65 72 20 74 68 61 74 20 6f he caller that o
25b70 70 65 6e 65 64 20 74 68 69 73 20 63 75 72 73 6f pened this curso
25b80 72 0a 20 20 2a 2a 20 65 78 70 65 63 74 65 64 20 r. ** expected
25b90 74 6f 20 6f 70 65 6e 20 69 74 20 6f 6e 20 61 6e to open it on an
25ba0 20 69 6e 64 65 78 20 62 2d 74 72 65 65 2e 20 4f index b-tree. O
25bb0 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 4b 65 therwise, if pKe
25bc0 79 49 6e 66 6f 20 69 73 0a 20 20 2a 2a 20 4e 55 yInfo is. ** NU
25bd0 4c 4c 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 65 LL, the caller e
25be0 78 70 65 63 74 73 20 61 20 74 61 62 6c 65 20 62 xpects a table b
25bf0 2d 74 72 65 65 2e 20 49 66 20 74 68 69 73 20 69 -tree. If this i
25c00 73 20 6e 6f 74 20 74 68 65 20 63 61 73 65 2c 0a s not the case,.
25c10 20 20 2a 2a 20 72 65 74 75 72 6e 20 61 6e 20 53 ** return an S
25c20 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 65 72 QLITE_CORRUPT er
25c30 72 6f 72 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ror. . **. **
25c40 45 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 Earlier versions
25c50 20 6f 66 20 53 51 4c 69 74 65 20 61 73 73 75 6d of SQLite assum
25c60 65 64 20 74 68 61 74 20 74 68 69 73 20 74 65 73 ed that this tes
25c70 74 20 63 6f 75 6c 64 20 6e 6f 74 20 66 61 69 6c t could not fail
25c80 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 72 6f 6f . ** if the roo
25c90 74 20 70 61 67 65 20 77 61 73 20 61 6c 72 65 61 t page was alrea
25ca0 64 79 20 6c 6f 61 64 65 64 20 77 68 65 6e 20 74 dy loaded when t
25cb0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 his function was
25cc0 20 63 61 6c 6c 65 64 20 28 69 2e 65 2e 0a 20 20 called (i.e..
25cd0 2a 2a 20 69 66 20 70 43 75 72 2d 3e 69 50 61 67 ** if pCur->iPag
25ce0 65 3e 3d 30 29 2e 20 42 75 74 20 74 68 69 73 20 e>=0). But this
25cf0 69 73 20 6e 6f 74 20 73 6f 20 69 66 20 74 68 65 is not so if the
25d00 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 database is cor
25d10 72 75 70 74 65 64 20 0a 20 20 2a 2a 20 69 6e 20 rupted . ** in
25d20 73 75 63 68 20 61 20 77 61 79 20 74 68 61 74 20 such a way that
25d30 70 61 67 65 20 70 52 6f 6f 74 20 69 73 20 6c 69 page pRoot is li
25d40 6e 6b 65 64 20 69 6e 74 6f 20 61 20 73 65 63 6f nked into a seco
25d50 6e 64 20 62 2d 74 72 65 65 20 74 61 62 6c 65 20 nd b-tree table
25d60 0a 20 20 2a 2a 20 28 6f 72 20 74 68 65 20 66 72 . ** (or the fr
25d70 65 65 6c 69 73 74 29 2e 20 20 2a 2f 0a 20 20 61 eelist). */. a
25d80 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 69 6e ssert( pRoot->in
25d90 74 4b 65 79 3d 3d 31 20 7c 7c 20 70 52 6f 6f 74 tKey==1 || pRoot
25da0 2d 3e 69 6e 74 4b 65 79 3d 3d 30 20 29 3b 0a 20 ->intKey==0 );.
25db0 20 69 66 28 20 70 52 6f 6f 74 2d 3e 69 73 49 6e if( pRoot->isIn
25dc0 69 74 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e it==0 || (pCur->
25dd0 70 4b 65 79 49 6e 66 6f 3d 3d 30 29 21 3d 70 52 pKeyInfo==0)!=pR
25de0 6f 6f 74 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 oot->intKey ){.
25df0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
25e00 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
25e10 20 7d 0a 0a 20 20 70 43 75 72 2d 3e 61 69 49 64 }.. pCur->aiId
25e20 78 5b 30 5d 20 3d 20 30 3b 0a 20 20 70 43 75 72 x[0] = 0;. pCur
25e30 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
25e40 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 ;. pCur->curFla
25e50 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c gs &= ~(BTCF_AtL
25e60 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b ast|BTCF_ValidNK
25e70 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 ey|BTCF_ValidOvf
25e80 6c 29 3b 0a 0a 20 20 69 66 28 20 70 52 6f 6f 74 l);.. if( pRoot
25e90 2d 3e 6e 43 65 6c 6c 3e 30 20 29 7b 0a 20 20 20 ->nCell>0 ){.
25ea0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
25eb0 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 CURSOR_VALID;.
25ec0 7d 65 6c 73 65 20 69 66 28 20 21 70 52 6f 6f 74 }else if( !pRoot
25ed0 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 ->leaf ){. Pg
25ee0 6e 6f 20 73 75 62 70 61 67 65 3b 0a 20 20 20 20 no subpage;.
25ef0 69 66 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 21 if( pRoot->pgno!
25f00 3d 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =1 ) return SQLI
25f10 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
25f20 0a 20 20 20 20 73 75 62 70 61 67 65 20 3d 20 67 . subpage = g
25f30 65 74 34 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e et4byte(&pRoot->
25f40 61 44 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 aData[pRoot->hdr
25f50 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 Offset+8]);.
25f60 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
25f70 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 URSOR_VALID;.
25f80 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
25f90 64 28 70 43 75 72 2c 20 73 75 62 70 61 67 65 29 d(pCur, subpage)
25fa0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
25fb0 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
25fc0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
25fd0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
25fe0 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
25ff0 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 cursor down to
26000 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 the left-most le
26010 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
26020 20 74 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f the.** entry to
26030 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 which it is cur
26040 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e rently pointing.
26050 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d .**.** The left-
26060 6d 6f 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 most leaf is the
26070 20 6f 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d one with the sm
26080 61 6c 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 allest key - the
26090 20 66 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 first.** in asc
260a0 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f ending order..*/
260b0 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 .static int move
260c0 54 6f 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 ToLeftmost(BtCur
260d0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 sor *pCur){. Pg
260e0 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 no pgno;. int r
260f0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
26100 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
26110 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
26120 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
26130 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
26140 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
26150 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
26160 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 while( rc==SQLIT
26170 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 E_OK && !(pPage
26180 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
26190 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 Cur->iPage])->le
261a0 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 af ){. assert
261b0 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
261c0 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 ur->iPage]<pPage
261d0 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 70 ->nCell );. p
261e0 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 66 gno = get4byte(f
261f0 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 indCell(pPage, p
26200 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
26210 3e 69 50 61 67 65 5d 29 29 3b 0a 20 20 20 20 72 >iPage]));. r
26220 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
26230 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d pCur, pgno);. }
26240 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
26250 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
26260 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 cursor down to t
26270 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 he right-most le
26280 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
26290 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 the.** page to
262a0 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 which it is curr
262b0 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 20 ently pointing.
262c0 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 66 66 Notice the diff
262d0 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 65 erence.** betwee
262e0 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
262f0 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 67 () and moveToRig
26300 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 54 htmost(). moveT
26310 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 oLeftmost().** f
26320 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d 6d 6f inds the left-mo
26330 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 st entry beneath
26340 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 65 the *entry* whe
26350 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 74 reas moveToRight
26360 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 most().** finds
26370 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 the right-most e
26380 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 ntry beneath the
26390 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 *page*..**.** T
263a0 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e he right-most en
263b0 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 20 77 try is the one w
263c0 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 74 20 ith the largest
263d0 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 0a 2a key - the last.*
263e0 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 69 * key in ascendi
263f0 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ng order..*/.sta
26400 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 69 tic int moveToRi
26410 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 ghtmost(BtCursor
26420 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 *pCur){. Pgno
26430 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d pgno;. int rc =
26440 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 SQLITE_OK;. Me
26450 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 mPage *pPage = 0
26460 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
26470 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
26480 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
26490 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
264a0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
264b0 20 77 68 69 6c 65 28 20 21 28 70 50 61 67 65 20 while( !(pPage
264c0 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
264d0 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 Cur->iPage])->le
264e0 61 66 20 29 7b 0a 20 20 20 20 70 67 6e 6f 20 3d af ){. pgno =
264f0 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
26500 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 ->aData[pPage->h
26510 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 drOffset+8]);.
26520 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
26530 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 ur->iPage] = pPa
26540 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 72 ge->nCell;. r
26550 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
26560 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 pCur, pgno);.
26570 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
26580 20 72 63 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d rc;. }. pCur-
26590 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
265a0 67 65 5d 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 ge] = pPage->nCe
265b0 6c 6c 2d 31 3b 0a 20 20 61 73 73 65 72 74 28 20 ll-1;. assert(
265c0 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
265d0 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
265e0 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
265f0 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 & BTCF_ValidNKe
26600 79 29 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 y)==0 );. retur
26610 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
26620 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 /* Move the curs
26630 6f 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 or to the first
26640 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 62 entry in the tab
26650 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 le. Return SQLI
26660 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 TE_OK.** on succ
26670 65 73 73 2e 20 20 53 65 74 20 2a 70 52 65 73 20 ess. Set *pRes
26680 74 6f 20 30 20 69 66 20 74 68 65 20 63 75 72 73 to 0 if the curs
26690 6f 72 20 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e or actually poin
266a0 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a ts to something.
266b0 2a 2a 20 6f 72 20 73 65 74 20 2a 70 52 65 73 20 ** or set *pRes
266c0 74 6f 20 31 20 69 66 20 74 68 65 20 74 61 62 6c to 1 if the tabl
266d0 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 e is empty..*/.i
266e0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 nt sqlite3BtreeF
266f0 69 72 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 irst(BtCursor *p
26700 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b Cur, int *pRes){
26710 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
26720 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
26730 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
26740 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
26750 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 3_mutex_held(pCu
26760 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d r->pBtree->db->m
26770 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 utex) );. rc =
26780 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 moveToRoot(pCur)
26790 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
267a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 TE_OK ){. if(
267b0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
267c0 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b URSOR_INVALID ){
267d0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
267e0 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 Cur->pgnoRoot==0
267f0 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 || pCur->apPage
26800 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
26810 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 Cell==0 );.
26820 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 *pRes = 1;.
26830 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 }else{. ass
26840 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 ert( pCur->apPag
26850 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e e[pCur->iPage]->
26860 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 20 nCell>0 );.
26870 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
26880 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 rc = moveToLef
26890 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 tmost(pCur);.
268a0 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
268b0 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 rc;.}../* Move t
268c0 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 he cursor to the
268d0 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 last entry in t
268e0 68 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 he table. Retur
268f0 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f n SQLITE_OK.** o
26900 6e 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 n success. Set
26910 2a 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 *pRes to 0 if th
26920 65 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c e cursor actuall
26930 79 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 y points to some
26940 74 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 thing.** or set
26950 2a 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 *pRes to 1 if th
26960 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 e table is empty
26970 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
26980 42 74 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 BtreeLast(BtCurs
26990 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
269a0 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Res){. int rc;.
269b0 20 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 . assert( curs
269c0 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
269d0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
269e0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
269f0 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d ld(pCur->pBtree-
26a00 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a >db->mutex) );..
26a10 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 /* If the curs
26a20 6f 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 or already point
26a30 73 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e s to the last en
26a40 74 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e try, this is a n
26a50 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 o-op. */. if( C
26a60 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 URSOR_VALID==pCu
26a70 72 2d 3e 65 53 74 61 74 65 20 26 26 20 28 70 43 r->eState && (pC
26a80 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
26a90 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 TCF_AtLast)!=0 )
26aa0 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
26ab0 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 DEBUG. /* Thi
26ac0 73 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 s block serves t
26ad0 6f 20 61 73 73 65 72 74 28 29 20 74 68 61 74 20 o assert() that
26ae0 74 68 65 20 63 75 72 73 6f 72 20 72 65 61 6c 6c the cursor reall
26af0 79 20 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 y does point .
26b00 20 20 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 ** to the last
26b10 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 62 2d entry in the b-
26b20 74 72 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 tree. */. int
26b30 20 69 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d ii;. for(ii=
26b40 30 3b 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 0; ii<pCur->iPag
26b50 65 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 e; ii++){.
26b60 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
26b70 49 64 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 Idx[ii]==pCur->a
26b80 70 50 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c pPage[ii]->nCell
26b90 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 );. }. as
26ba0 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 sert( pCur->aiId
26bb0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d x[pCur->iPage]==
26bc0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
26bd0 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
26be0 2d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 -1 );. assert
26bf0 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 ( pCur->apPage[p
26c00 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 Cur->iPage]->lea
26c10 66 20 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 f );.#endif.
26c20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
26c30 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d 6f ;. }.. rc = mo
26c40 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a veToRoot(pCur);.
26c50 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
26c60 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 43 _OK ){. if( C
26c70 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 URSOR_INVALID==p
26c80 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 Cur->eState ){.
26c90 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
26ca0 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c r->pgnoRoot==0 |
26cb0 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 | pCur->apPage[p
26cc0 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 Cur->iPage]->nCe
26cd0 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a ll==0 );. *
26ce0 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d 65 pRes = 1;. }e
26cf0 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
26d00 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
26d10 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
26d20 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 . *pRes = 0
26d30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 ;. rc = mov
26d40 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 eToRightmost(pCu
26d50 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 r);. if( rc
26d60 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
26d70 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 pCur->cur
26d80 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 41 74 Flags |= BTCF_At
26d90 4c 61 73 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 Last;. }els
26da0 65 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d e{. pCur-
26db0 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 >curFlags &= ~BT
26dc0 43 46 5f 41 74 4c 61 73 74 3b 0a 20 20 20 20 20 CF_AtLast;.
26dd0 20 7d 0a 20 20 20 0a 20 20 20 20 7d 0a 20 20 7d }. . }. }
26de0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
26df0 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 ./* Move the cur
26e00 73 6f 72 20 73 6f 20 74 68 61 74 20 69 74 20 70 sor so that it p
26e10 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 6e 74 72 oints to an entr
26e20 79 20 6e 65 61 72 20 74 68 65 20 6b 65 79 20 0a y near the key .
26e30 2a 2a 20 73 70 65 63 69 66 69 65 64 20 62 79 20 ** specified by
26e40 70 49 64 78 4b 65 79 20 6f 72 20 69 6e 74 4b 65 pIdxKey or intKe
26e50 79 2e 20 20 20 52 65 74 75 72 6e 20 61 20 73 75 y. Return a su
26e60 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a 2a 0a 2a ccess code..**.*
26e70 2a 20 46 6f 72 20 49 4e 54 4b 45 59 20 74 61 62 * For INTKEY tab
26e80 6c 65 73 2c 20 74 68 65 20 69 6e 74 4b 65 79 20 les, the intKey
26e90 70 61 72 61 6d 65 74 65 72 20 69 73 20 75 73 65 parameter is use
26ea0 64 2e 20 20 70 49 64 78 4b 65 79 20 0a 2a 2a 20 d. pIdxKey .**
26eb0 6d 75 73 74 20 62 65 20 4e 55 4c 4c 2e 20 20 46 must be NULL. F
26ec0 6f 72 20 69 6e 64 65 78 20 74 61 62 6c 65 73 2c or index tables,
26ed0 20 70 49 64 78 4b 65 79 20 69 73 20 75 73 65 64 pIdxKey is used
26ee0 20 61 6e 64 20 69 6e 74 4b 65 79 0a 2a 2a 20 69 and intKey.** i
26ef0 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a 0a 2a 2a s ignored..**.**
26f00 20 49 66 20 61 6e 20 65 78 61 63 74 20 6d 61 74 If an exact mat
26f10 63 68 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c ch is not found,
26f20 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
26f30 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 6c 65 is always.** le
26f40 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ft pointing at a
26f50 20 6c 65 61 66 20 70 61 67 65 20 77 68 69 63 68 leaf page which
26f60 20 77 6f 75 6c 64 20 68 6f 6c 64 20 74 68 65 20 would hold the
26f70 65 6e 74 72 79 20 69 66 20 69 74 0a 2a 2a 20 77 entry if it.** w
26f80 65 72 65 20 70 72 65 73 65 6e 74 2e 20 20 54 68 ere present. Th
26f90 65 20 63 75 72 73 6f 72 20 6d 69 67 68 74 20 70 e cursor might p
26fa0 6f 69 6e 74 20 74 6f 20 61 6e 20 65 6e 74 72 79 oint to an entry
26fb0 20 74 68 61 74 20 63 6f 6d 65 73 0a 2a 2a 20 62 that comes.** b
26fc0 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 20 74 efore or after t
26fd0 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 6e he key..**.** An
26fe0 20 69 6e 74 65 67 65 72 20 69 73 20 77 72 69 74 integer is writ
26ff0 74 65 6e 20 69 6e 74 6f 20 2a 70 52 65 73 20 77 ten into *pRes w
27000 68 69 63 68 20 69 73 20 74 68 65 20 72 65 73 75 hich is the resu
27010 6c 74 20 6f 66 0a 2a 2a 20 63 6f 6d 70 61 72 69 lt of.** compari
27020 6e 67 20 74 68 65 20 6b 65 79 20 77 69 74 68 20 ng the key with
27030 74 68 65 20 65 6e 74 72 79 20 74 6f 20 77 68 69 the entry to whi
27040 63 68 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 ch the cursor is
27050 20 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 20 .** pointing.
27060 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 The meaning of t
27070 68 65 20 69 6e 74 65 67 65 72 20 77 72 69 74 74 he integer writt
27080 65 6e 20 69 6e 74 6f 0a 2a 2a 20 2a 70 52 65 73 en into.** *pRes
27090 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a is as follows:.
270a0 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3c **.** *pRes<
270b0 30 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 0 The curso
270c0 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
270d0 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
270e0 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
270f0 20 20 20 20 20 20 20 20 69 73 20 73 6d 61 6c 6c is small
27100 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 er than intKey/p
27110 49 64 78 4b 65 79 20 6f 72 20 69 66 20 74 68 65 IdxKey or if the
27120 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 0a table is empty.
27130 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
27140 20 20 20 20 61 6e 64 20 74 68 65 20 63 75 72 73 and the curs
27150 6f 72 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 or is therefore
27160 6c 65 66 74 20 70 6f 69 6e 74 20 74 6f 20 6e 6f left point to no
27170 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 thing..**.**
27180 20 2a 70 52 65 73 3d 3d 30 20 20 20 20 20 54 68 *pRes==0 Th
27190 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
271a0 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 pointing at an
271b0 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 entry that.**
271c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 e
271d0 78 61 63 74 6c 79 20 6d 61 74 63 68 65 73 20 69 xactly matches i
271e0 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a ntKey/pIdxKey..*
271f0 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3e 30 *.** *pRes>0
27200 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 The cursor
27210 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e is left pointin
27220 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 g at an entry th
27230 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 at.**
27240 20 20 20 20 20 20 20 69 73 20 6c 61 72 67 65 72 is larger
27250 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 64 than intKey/pId
27260 78 4b 65 79 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 xKey..**.*/.int
27270 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 sqlite3BtreeMove
27280 74 6f 55 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 toUnpacked(. Bt
27290 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 Cursor *pCur,
272a0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 /* The cu
272b0 72 73 6f 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 rsor to be moved
272c0 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 */. UnpackedRe
272d0 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f cord *pIdxKey, /
272e0 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 * Unpacked index
272f0 20 6b 65 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e key */. i64 in
27300 74 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 tKey,
27310 20 20 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 /* The table
27320 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 key */. int bia
27330 73 52 69 67 68 74 2c 20 20 20 20 20 20 20 20 20 sRight,
27340 20 20 2f 2a 20 49 66 20 74 72 75 65 2c 20 62 69 /* If true, bi
27350 61 73 20 74 68 65 20 73 65 61 72 63 68 20 74 6f as the search to
27360 20 74 68 65 20 68 69 67 68 20 65 6e 64 20 2a 2f the high end */
27370 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 20 20 20 . int *pRes
27380 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
27390 72 69 74 65 20 73 65 61 72 63 68 20 72 65 73 75 rite search resu
273a0 6c 74 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 lts here */.){.
273b0 20 69 6e 74 20 72 63 3b 0a 20 20 52 65 63 6f 72 int rc;. Recor
273c0 64 43 6f 6d 70 61 72 65 20 78 52 65 63 6f 72 64 dCompare xRecord
273d0 43 6f 6d 70 61 72 65 3b 0a 0a 20 20 61 73 73 65 Compare;.. asse
273e0 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
273f0 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
27400 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
27410 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
27420 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
27430 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
27440 20 70 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 pRes );. asser
27450 74 28 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d t( (pIdxKey==0)=
27460 3d 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f =(pCur->pKeyInfo
27470 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 ==0) );.. /* If
27480 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 the cursor is a
27490 6c 72 65 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 lready positione
274a0 64 20 61 74 20 74 68 65 20 70 6f 69 6e 74 20 77 d at the point w
274b0 65 20 61 72 65 20 74 72 79 69 6e 67 0a 20 20 2a e are trying. *
274c0 2a 20 74 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 * to move to, th
274d0 65 6e 20 6a 75 73 74 20 72 65 74 75 72 6e 20 77 en just return w
274e0 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 ithout doing any
274f0 20 77 6f 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 work */. if( p
27500 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
27510 53 4f 52 5f 56 41 4c 49 44 20 26 26 20 28 70 43 SOR_VALID && (pC
27520 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
27530 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d TCF_ValidNKey)!=
27540 30 0a 20 20 20 26 26 20 70 43 75 72 2d 3e 61 70 0. && pCur->ap
27550 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 Page[0]->intKey
27560 0a 20 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 . ){. if( pC
27570 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 ur->info.nKey==i
27580 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a ntKey ){. *
27590 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 pRes = 0;.
275a0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
275b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
275c0 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
275d0 26 20 42 54 43 46 5f 41 74 4c 61 73 74 29 21 3d & BTCF_AtLast)!=
275e0 30 20 26 26 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 0 && pCur->info.
275f0 6e 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 nKey<intKey ){.
27600 20 20 20 20 20 2a 70 52 65 73 20 3d 20 2d 31 3b *pRes = -1;
27610 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
27620 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
27630 20 7d 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 }.. if( pIdxKe
27640 79 20 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 y ){. xRecord
27650 43 6f 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 Compare = sqlite
27660 33 56 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 3VdbeFindCompare
27670 28 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 (pIdxKey);. p
27680 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 IdxKey->errCode
27690 3d 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 = 0;. assert(
276a0 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c pIdxKey->defaul
276b0 74 5f 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 t_rc==1 .
276c0 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 || pIdxKey->de
276d0 66 61 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 fault_rc==0 .
276e0 20 20 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 || pIdxKey
276f0 2d 3e 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 ->default_rc==-1
27700 0a 20 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b . );. }else{
27710 0a 20 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 . xRecordComp
27720 61 72 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 are = 0; /* All
27730 6b 65 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 keys are integer
27740 73 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d s */. }.. rc =
27750 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 moveToRoot(pCur
27760 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 );. if( rc ){.
27770 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
27780 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 }. assert( pCur
27790 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c ->pgnoRoot==0 ||
277a0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
277b0 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 ur->iPage] );.
277c0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 assert( pCur->pg
277d0 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 noRoot==0 || pCu
277e0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
277f0 69 50 61 67 65 5d 2d 3e 69 73 49 6e 69 74 20 29 iPage]->isInit )
27800 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
27810 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
27820 5f 49 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 _INVALID || pCur
27830 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
27840 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 Page]->nCell>0 )
27850 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
27860 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 tate==CURSOR_INV
27870 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a 70 52 65 ALID ){. *pRe
27880 73 20 3d 20 2d 31 3b 0a 20 20 20 20 61 73 73 65 s = -1;. asse
27890 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f rt( pCur->pgnoRo
278a0 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 ot==0 || pCur->a
278b0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
278c0 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a e]->nCell==0 );.
278d0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
278e0 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 65 E_OK;. }. asse
278f0 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 rt( pCur->apPage
27900 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 70 [0]->intKey || p
27910 49 64 78 4b 65 79 20 29 3b 0a 20 20 66 6f 72 28 IdxKey );. for(
27920 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 77 72 ;;){. int lwr
27930 2c 20 75 70 72 2c 20 69 64 78 2c 20 63 3b 0a 20 , upr, idx, c;.
27940 20 20 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b 0a Pgno chldPg;.
27950 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 MemPage *pPa
27960 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
27970 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
27980 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 3b 20 20 u8 *pCell;
27990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
279a0 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
279b0 65 72 20 74 6f 20 63 75 72 72 65 6e 74 20 63 65 er to current ce
279c0 6c 6c 20 69 6e 20 70 50 61 67 65 20 2a 2f 0a 0a ll in pPage */..
279d0 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e 6e 43 /* pPage->nC
279e0 65 6c 6c 20 6d 75 73 74 20 62 65 20 67 72 65 61 ell must be grea
279f0 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e 20 49 ter than zero. I
27a00 66 20 74 68 69 73 20 69 73 20 74 68 65 20 72 6f f this is the ro
27a10 6f 74 2d 70 61 67 65 0a 20 20 20 20 2a 2a 20 74 ot-page. ** t
27a20 68 65 20 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 he cursor would
27a30 68 61 76 65 20 62 65 65 6e 20 49 4e 56 41 4c 49 have been INVALI
27a40 44 20 61 62 6f 76 65 20 61 6e 64 20 74 68 69 73 D above and this
27a50 20 66 6f 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 20 for(;;) loop.
27a60 20 20 2a 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 66 ** not run. If
27a70 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 65 this is not the
27a80 20 72 6f 6f 74 2d 70 61 67 65 2c 20 74 68 65 6e root-page, then
27a90 20 74 68 65 20 6d 6f 76 65 54 6f 43 68 69 6c 64 the moveToChild
27aa0 28 29 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a () routine. *
27ab0 2a 20 77 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 * would have alr
27ac0 65 61 64 79 20 64 65 74 65 63 74 65 64 20 64 62 eady detected db
27ad0 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 53 69 6d corruption. Sim
27ae0 69 6c 61 72 6c 79 2c 20 70 50 61 67 65 20 6d 75 ilarly, pPage mu
27af0 73 74 0a 20 20 20 20 2a 2a 20 62 65 20 74 68 65 st. ** be the
27b00 20 72 69 67 68 74 20 6b 69 6e 64 20 28 69 6e 64 right kind (ind
27b10 65 78 20 6f 72 20 74 61 62 6c 65 29 20 6f 66 20 ex or table) of
27b20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 4f 74 68 b-tree page. Oth
27b30 65 72 77 69 73 65 0a 20 20 20 20 2a 2a 20 61 20 erwise. ** a
27b40 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 6f 72 moveToChild() or
27b50 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 29 20 63 61 moveToRoot() ca
27b60 6c 6c 20 77 6f 75 6c 64 20 68 61 76 65 20 64 65 ll would have de
27b70 74 65 63 74 65 64 20 63 6f 72 72 75 70 74 69 6f tected corruptio
27b80 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 n. */. asser
27b90 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e t( pPage->nCell>
27ba0 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
27bb0 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d pPage->intKey==
27bc0 28 70 49 64 78 4b 65 79 3d 3d 30 29 20 29 3b 0a (pIdxKey==0) );.
27bd0 20 20 20 20 6c 77 72 20 3d 20 30 3b 0a 20 20 20 lwr = 0;.
27be0 20 75 70 72 20 3d 20 70 50 61 67 65 2d 3e 6e 43 upr = pPage->nC
27bf0 65 6c 6c 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 ell-1;. asser
27c00 74 28 20 62 69 61 73 52 69 67 68 74 3d 3d 30 20 t( biasRight==0
27c10 7c 7c 20 62 69 61 73 52 69 67 68 74 3d 3d 31 20 || biasRight==1
27c20 29 3b 0a 20 20 20 20 69 64 78 20 3d 20 75 70 72 );. idx = upr
27c30 3e 3e 28 31 2d 62 69 61 73 52 69 67 68 74 29 3b >>(1-biasRight);
27c40 20 2f 2a 20 69 64 78 20 3d 20 62 69 61 73 52 69 /* idx = biasRi
27c50 67 68 74 20 3f 20 75 70 72 20 3a 20 28 6c 77 72 ght ? upr : (lwr
27c60 2b 75 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 +upr)/2; */.
27c70 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
27c80 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 ->iPage] = (u16)
27c90 69 64 78 3b 0a 20 20 20 20 69 66 28 20 78 52 65 idx;. if( xRe
27ca0 63 6f 72 64 43 6f 6d 70 61 72 65 3d 3d 30 20 29 cordCompare==0 )
27cb0 7b 0a 20 20 20 20 20 20 66 6f 72 28 3b 3b 29 7b {. for(;;){
27cc0 0a 20 20 20 20 20 20 20 20 69 36 34 20 6e 43 65 . i64 nCe
27cd0 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 70 llKey;. p
27ce0 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 Cell = findCell(
27cf0 70 50 61 67 65 2c 20 69 64 78 29 20 2b 20 70 50 pPage, idx) + pP
27d00 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
27d10 65 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 e;. if( p
27d20 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 Page->intKeyLeaf
27d30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 ){. wh
27d40 69 6c 65 28 20 30 78 38 30 20 3c 3d 20 2a 28 70 ile( 0x80 <= *(p
27d50 43 65 6c 6c 2b 2b 29 20 29 7b 0a 20 20 20 20 20 Cell++) ){.
27d60 20 20 20 20 20 20 20 69 66 28 20 70 43 65 6c 6c if( pCell
27d70 3e 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e >=pPage->aDataEn
27d80 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 d ) return SQLIT
27d90 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
27da0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
27db0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 67 65 }. ge
27dc0 74 56 61 72 69 6e 74 28 70 43 65 6c 6c 2c 20 28 tVarint(pCell, (
27dd0 75 36 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 29 3b u64*)&nCellKey);
27de0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 . if( nCe
27df0 6c 6c 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a llKey<intKey ){.
27e00 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 3d 20 lwr =
27e10 69 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 20 idx+1;.
27e20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 7b 20 if( lwr>upr ){
27e30 63 20 3d 20 2d 31 3b 20 62 72 65 61 6b 3b 20 7d c = -1; break; }
27e40 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
27e50 66 28 20 6e 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b f( nCellKey>intK
27e60 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ey ){.
27e70 75 70 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 20 upr = idx-1;.
27e80 20 20 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 if( lwr>u
27e90 70 72 20 29 7b 20 63 20 3d 20 2b 31 3b 20 62 72 pr ){ c = +1; br
27ea0 65 61 6b 3b 20 7d 0a 20 20 20 20 20 20 20 20 7d eak; }. }
27eb0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
27ec0 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 4b 65 79 assert( nCellKey
27ed0 3d 3d 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 ==intKey );.
27ee0 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 pCur->curF
27ef0 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c lags |= BTCF_Val
27f00 69 64 4e 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 idNKey;.
27f10 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 pCur->info.nKe
27f20 79 20 3d 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 y = nCellKey;.
27f30 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 69 pCur->ai
27f40 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
27f50 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 = (u16)idx;.
27f60 20 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 if( !pPag
27f70 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
27f80 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 lwr = idx
27f90 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f ;. go
27fa0 74 6f 20 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c to moveto_next_l
27fb0 61 79 65 72 3b 0a 20 20 20 20 20 20 20 20 20 20 ayer;.
27fc0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
27fd0 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
27fe0 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
27ff0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
28000 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
28010 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 o_finish;.
28020 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
28030 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
28040 6c 77 72 2b 75 70 72 3e 3d 30 20 29 3b 0a 20 20 lwr+upr>=0 );.
28050 20 20 20 20 20 20 69 64 78 20 3d 20 28 6c 77 72 idx = (lwr
28060 2b 75 70 72 29 3e 3e 31 3b 20 20 2f 2a 20 69 64 +upr)>>1; /* id
28070 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 2f 32 3b x = (lwr+upr)/2;
28080 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 */. }.
28090 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 66 6f 72 }else{. for
280a0 28 3b 3b 29 7b 0a 20 20 20 20 20 20 20 20 69 6e (;;){. in
280b0 74 20 6e 43 65 6c 6c 3b 0a 20 20 20 20 20 20 20 t nCell;.
280c0 20 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c pCell = findCel
280d0 6c 28 70 50 61 67 65 2c 20 69 64 78 29 20 2b 20 l(pPage, idx) +
280e0 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
280f0 69 7a 65 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a ize;.. /*
28100 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 73 75 70 The maximum sup
28110 70 6f 72 74 65 64 20 70 61 67 65 2d 73 69 7a 65 ported page-size
28120 20 69 73 20 36 35 35 33 36 20 62 79 74 65 73 2e is 65536 bytes.
28130 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 This means that
28140 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 . ** the
28150 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f maximum number o
28160 66 20 72 65 63 6f 72 64 20 62 79 74 65 73 20 73 f record bytes s
28170 74 6f 72 65 64 20 6f 6e 20 61 6e 20 69 6e 64 65 tored on an inde
28180 78 20 42 2d 54 72 65 65 0a 20 20 20 20 20 20 20 x B-Tree.
28190 20 2a 2a 20 70 61 67 65 20 69 73 20 6c 65 73 73 ** page is less
281a0 20 74 68 61 6e 20 31 36 33 38 34 20 62 79 74 65 than 16384 byte
281b0 73 20 61 6e 64 20 6d 61 79 20 62 65 20 73 74 6f s and may be sto
281c0 72 65 64 20 61 73 20 61 20 32 2d 62 79 74 65 0a red as a 2-byte.
281d0 20 20 20 20 20 20 20 20 2a 2a 20 76 61 72 69 6e ** varin
281e0 74 2e 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 t. This informat
281f0 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 ion is used to a
28200 74 74 65 6d 70 74 20 74 6f 20 61 76 6f 69 64 20 ttempt to avoid
28210 70 61 72 73 69 6e 67 20 0a 20 20 20 20 20 20 20 parsing .
28220 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 ** the entire c
28230 65 6c 6c 20 62 79 20 63 68 65 63 6b 69 6e 67 20 ell by checking
28240 66 6f 72 20 74 68 65 20 63 61 73 65 73 20 77 68 for the cases wh
28250 65 72 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 ere the record i
28260 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 s . ** st
28270 6f 72 65 64 20 65 6e 74 69 72 65 6c 79 20 77 69 ored entirely wi
28280 74 68 69 6e 20 74 68 65 20 62 2d 74 72 65 65 20 thin the b-tree
28290 70 61 67 65 20 62 79 20 69 6e 73 70 65 63 74 69 page by inspecti
282a0 6e 67 20 74 68 65 20 66 69 72 73 74 20 0a 20 20 ng the first .
282b0 20 20 20 20 20 20 2a 2a 20 32 20 62 79 74 65 73 ** 2 bytes
282c0 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a 20 20 of the cell..
282d0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
282e0 20 6e 43 65 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 nCell = pCell[0
282f0 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e ];. if( n
28300 43 65 6c 6c 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 Cell<=pPage->max
28310 31 62 79 74 65 50 61 79 6c 6f 61 64 20 29 7b 0a 1bytePayload ){.
28320 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 /* Thi
28330 73 20 62 72 61 6e 63 68 20 72 75 6e 73 20 69 66 s branch runs if
28340 20 74 68 65 20 72 65 63 6f 72 64 2d 73 69 7a 65 the record-size
28350 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 63 65 field of the ce
28360 6c 6c 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 ll is a.
28370 20 20 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 65 ** single byte
28380 20 76 61 72 69 6e 74 20 61 6e 64 20 74 68 65 20 varint and the
28390 72 65 63 6f 72 64 20 66 69 74 73 20 65 6e 74 69 record fits enti
283a0 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 6e rely on the main
283b0 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 62 2d . ** b-
283c0 74 72 65 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 tree page. */.
283d0 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 testcas
283e0 65 28 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 e( pCell+nCell+1
283f0 3d 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e ==pPage->aDataEn
28400 64 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63 d );. c
28410 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 = xRecordCompar
28420 65 28 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 e(nCell, (void*)
28430 26 70 43 65 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b &pCell[1], pIdxK
28440 65 79 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c ey);. }el
28450 73 65 20 69 66 28 20 21 28 70 43 65 6c 6c 5b 31 se if( !(pCell[1
28460 5d 20 26 20 30 78 38 30 29 20 0a 20 20 20 20 20 ] & 0x80) .
28470 20 20 20 20 20 26 26 20 28 6e 43 65 6c 6c 20 3d && (nCell =
28480 20 28 28 6e 43 65 6c 6c 26 30 78 37 66 29 3c 3c ((nCell&0x7f)<<
28490 37 29 20 2b 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 7) + pCell[1])<=
284a0 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a pPage->maxLocal.
284b0 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ){.
284c0 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f /* The reco
284d0 72 64 2d 73 69 7a 65 20 66 69 65 6c 64 20 69 73 rd-size field is
284e0 20 61 20 32 20 62 79 74 65 20 76 61 72 69 6e 74 a 2 byte varint
284f0 20 61 6e 64 20 74 68 65 20 72 65 63 6f 72 64 20 and the record
28500 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 66 69 . ** fi
28510 74 73 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 74 ts entirely on t
28520 68 65 20 6d 61 69 6e 20 62 2d 74 72 65 65 20 70 he main b-tree p
28530 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 age. */.
28540 20 20 20 74 65 73 74 63 61 73 65 28 20 70 43 65 testcase( pCe
28550 6c 6c 2b 6e 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 ll+nCell+2==pPag
28560 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a 20 e->aDataEnd );.
28570 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 52 65 c = xRe
28580 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 6c cordCompare(nCel
28590 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 6c 6c l, (void*)&pCell
285a0 5b 32 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 [2], pIdxKey);.
285b0 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
285c0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 /* The r
285d0 65 63 6f 72 64 20 66 6c 6f 77 73 20 6f 76 65 72 ecord flows over
285e0 20 6f 6e 74 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 onto one or mor
285f0 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 e overflow pages
28600 2e 20 49 6e 0a 20 20 20 20 20 20 20 20 20 20 2a . In. *
28610 2a 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 * this case the
28620 77 68 6f 6c 65 20 63 65 6c 6c 20 6e 65 65 64 73 whole cell needs
28630 20 74 6f 20 62 65 20 70 61 72 73 65 64 2c 20 61 to be parsed, a
28640 20 62 75 66 66 65 72 20 61 6c 6c 6f 63 61 74 65 buffer allocate
28650 64 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 d. ** a
28660 6e 64 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 nd accessPayload
28670 28 29 20 75 73 65 64 20 74 6f 20 72 65 74 72 69 () used to retri
28680 65 76 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 eve the record i
28690 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 nto the.
286a0 20 20 2a 2a 20 62 75 66 66 65 72 20 62 65 66 6f ** buffer befo
286b0 72 65 20 56 64 62 65 52 65 63 6f 72 64 43 6f 6d re VdbeRecordCom
286c0 70 61 72 65 28 29 20 63 61 6e 20 62 65 20 63 61 pare() can be ca
286d0 6c 6c 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 20 lled. */.
286e0 20 20 20 76 6f 69 64 20 2a 70 43 65 6c 6c 4b 65 void *pCellKe
286f0 79 3b 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 y;. u8
28700 2a 20 63 6f 6e 73 74 20 70 43 65 6c 6c 42 6f 64 * const pCellBod
28710 79 20 3d 20 70 43 65 6c 6c 20 2d 20 70 50 61 67 y = pCell - pPag
28720 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
28730 0a 20 20 20 20 20 20 20 20 20 20 62 74 72 65 65 . btree
28740 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 ParseCellPtr(pPa
28750 67 65 2c 20 70 43 65 6c 6c 42 6f 64 79 2c 20 26 ge, pCellBody, &
28760 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 20 pCur->info);.
28770 20 20 20 20 20 20 20 6e 43 65 6c 6c 20 3d 20 28 nCell = (
28780 69 6e 74 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e int)pCur->info.n
28790 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 70 Key;. p
287a0 43 65 6c 6c 4b 65 79 20 3d 20 73 71 6c 69 74 65 CellKey = sqlite
287b0 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 6c 6c 20 29 3Malloc( nCell )
287c0 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
287d0 70 43 65 6c 6c 4b 65 79 3d 3d 30 20 29 7b 0a 20 pCellKey==0 ){.
287e0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
287f0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
28800 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d goto m
28810 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 oveto_finish;.
28820 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
28830 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b pCur->aiIdx[
28840 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 pCur->iPage] = (
28850 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 u16)idx;.
28860 20 20 20 72 63 20 3d 20 61 63 63 65 73 73 50 61 rc = accessPa
28870 79 6c 6f 61 64 28 70 43 75 72 2c 20 30 2c 20 6e yload(pCur, 0, n
28880 43 65 6c 6c 2c 20 28 75 6e 73 69 67 6e 65 64 20 Cell, (unsigned
28890 63 68 61 72 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 char*)pCellKey,
288a0 32 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 2);. if
288b0 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 ( rc ){.
288c0 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
288d0 28 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 (pCellKey);.
288e0 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
288f0 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 eto_finish;.
28900 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
28910 20 20 63 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d c = xRecordCom
28920 70 61 72 65 28 6e 43 65 6c 6c 2c 20 70 43 65 6c pare(nCell, pCel
28930 6c 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 3b 0a lKey, pIdxKey);.
28940 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
28950 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3_free(pCellKey)
28960 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
28970 20 20 20 20 61 73 73 65 72 74 28 20 0a 20 20 20 assert( .
28980 20 20 20 20 20 20 20 20 20 28 70 49 64 78 4b 65 (pIdxKe
28990 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 y->errCode!=SQLI
289a0 54 45 5f 43 4f 52 52 55 50 54 20 7c 7c 20 63 3d TE_CORRUPT || c=
289b0 3d 30 29 0a 20 20 20 20 20 20 20 20 20 26 26 20 =0). &&
289c0 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 (pIdxKey->errCod
289d0 65 21 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 e!=SQLITE_NOMEM
289e0 7c 7c 20 70 43 75 72 2d 3e 70 42 74 72 65 65 2d || pCur->pBtree-
289f0 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 >db->mallocFaile
28a00 64 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 d). );.
28a10 20 20 20 20 20 20 69 66 28 20 63 3c 30 20 29 7b if( c<0 ){
28a20 0a 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 3d . lwr =
28a30 20 69 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 idx+1;.
28a40 7d 65 6c 73 65 20 69 66 28 20 63 3e 30 20 29 7b }else if( c>0 ){
28a50 0a 20 20 20 20 20 20 20 20 20 20 75 70 72 20 3d . upr =
28a60 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 20 idx-1;.
28a70 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
28a80 20 61 73 73 65 72 74 28 20 63 3d 3d 30 20 29 3b assert( c==0 );
28a90 0a 20 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 . *pRes
28aa0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
28ab0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
28ac0 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
28ad0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
28ae0 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 e] = (u16)idx;.
28af0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 49 64 if( pId
28b00 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 29 20 xKey->errCode )
28b10 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
28b20 55 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 UPT;. g
28b30 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 oto moveto_finis
28b40 68 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 h;. }.
28b50 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 if( lwr>upr
28b60 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 ) break;.
28b70 20 20 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 assert( lwr+up
28b80 72 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 r>=0 );.
28b90 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e idx = (lwr+upr)>
28ba0 3e 31 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c >1; /* idx = (l
28bb0 77 72 2b 75 70 72 29 2f 32 20 2a 2f 0a 20 20 20 wr+upr)/2 */.
28bc0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 }. }. a
28bd0 73 73 65 72 74 28 20 6c 77 72 3d 3d 75 70 72 2b ssert( lwr==upr+
28be0 31 20 7c 7c 20 28 70 50 61 67 65 2d 3e 69 6e 74 1 || (pPage->int
28bf0 4b 65 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c Key && !pPage->l
28c00 65 61 66 29 20 29 3b 0a 20 20 20 20 61 73 73 65 eaf) );. asse
28c10 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 rt( pPage->isIni
28c20 74 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 t );. if( pPa
28c30 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
28c40 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
28c50 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
28c60 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b e]<pCur->apPage[
28c70 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
28c80 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 70 43 75 ell );. pCu
28c90 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
28ca0 50 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 Page] = (u16)idx
28cb0 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
28cc0 63 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 c;. rc = SQ
28cd0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 67 LITE_OK;. g
28ce0 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 oto moveto_finis
28cf0 68 3b 0a 20 20 20 20 7d 0a 6d 6f 76 65 74 6f 5f h;. }.moveto_
28d00 6e 65 78 74 5f 6c 61 79 65 72 3a 0a 20 20 20 20 next_layer:.
28d10 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d 3e if( lwr>=pPage->
28d20 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 63 nCell ){. c
28d30 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 hldPg = get4byte
28d40 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
28d50 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
28d60 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 8]);. }else{.
28d70 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 67 chldPg = g
28d80 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
28d90 28 70 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a 20 (pPage, lwr));.
28da0 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 61 }. pCur->a
28db0 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
28dc0 5d 20 3d 20 28 75 31 36 29 6c 77 72 3b 0a 20 20 ] = (u16)lwr;.
28dd0 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
28de0 6c 64 28 70 43 75 72 2c 20 63 68 6c 64 50 67 29 ld(pCur, chldPg)
28df0 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 62 ;. if( rc ) b
28e00 72 65 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 65 74 6f reak;. }.moveto
28e10 5f 66 69 6e 69 73 68 3a 0a 20 20 70 43 75 72 2d _finish:. pCur-
28e20 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
28e30 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 . pCur->curFlag
28e40 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 s &= ~(BTCF_Vali
28e50 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 dNKey|BTCF_Valid
28e60 4f 76 66 6c 29 3b 0a 20 20 72 65 74 75 72 6e 20 Ovfl);. return
28e70 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}.../*.** Re
28e80 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 turn TRUE if the
28e90 20 63 75 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 cursor is not p
28ea0 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e ointing at an en
28eb0 74 72 79 20 6f 66 20 74 68 65 20 74 61 62 6c 65 try of the table
28ec0 2e 0a 2a 2a 0a 2a 2a 20 54 52 55 45 20 77 69 6c ..**.** TRUE wil
28ed0 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 61 66 l be returned af
28ee0 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 ter a call to sq
28ef0 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 lite3BtreeNext()
28f00 20 6d 6f 76 65 73 0a 2a 2a 20 70 61 73 74 20 74 moves.** past t
28f10 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e he last entry in
28f20 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 73 71 the table or sq
28f30 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 28 29 lite3BtreePrev()
28f40 20 6d 6f 76 65 73 20 70 61 73 74 0a 2a 2a 20 74 moves past.** t
28f50 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 2e 20 he first entry.
28f60 20 54 52 55 45 20 69 73 20 61 6c 73 6f 20 72 65 TRUE is also re
28f70 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 74 61 turned if the ta
28f80 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f ble is empty..*/
28f90 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
28fa0 65 45 6f 66 28 42 74 43 75 72 73 6f 72 20 2a 70 eEof(BtCursor *p
28fb0 43 75 72 29 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a Cur){. /* TODO:
28fc0 20 57 68 61 74 20 69 66 20 74 68 65 20 63 75 72 What if the cur
28fd0 73 6f 72 20 69 73 20 69 6e 20 43 55 52 53 4f 52 sor is in CURSOR
28fe0 5f 52 45 51 55 49 52 45 53 45 45 4b 20 62 75 74 _REQUIRESEEK but
28ff0 20 61 6c 6c 20 74 61 62 6c 65 20 65 6e 74 72 69 all table entri
29000 65 73 0a 20 20 2a 2a 20 68 61 76 65 20 62 65 65 es. ** have bee
29010 6e 20 64 65 6c 65 74 65 64 3f 20 54 68 69 73 20 n deleted? This
29020 41 50 49 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f API will need to
29030 20 63 68 61 6e 67 65 20 74 6f 20 72 65 74 75 72 change to retur
29040 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a n an error code.
29050 20 20 2a 2a 20 61 73 20 77 65 6c 6c 20 61 73 20 ** as well as
29060 74 68 65 20 62 6f 6f 6c 65 61 6e 20 72 65 73 75 the boolean resu
29070 6c 74 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 lt value.. */.
29080 20 72 65 74 75 72 6e 20 28 43 55 52 53 4f 52 5f return (CURSOR_
29090 56 41 4c 49 44 21 3d 70 43 75 72 2d 3e 65 53 74 VALID!=pCur->eSt
290a0 61 74 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 ate);.}../*.** A
290b0 64 76 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f dvance the curso
290c0 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e r to the next en
290d0 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 try in the datab
290e0 61 73 65 2e 20 20 49 66 0a 2a 2a 20 73 75 63 63 ase. If.** succ
290f0 65 73 73 66 75 6c 20 74 68 65 6e 20 73 65 74 20 essful then set
29100 2a 70 52 65 73 3d 30 2e 20 20 49 66 20 74 68 65 *pRes=0. If the
29110 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 73 20 61 cursor.** was a
29120 6c 72 65 61 64 79 20 70 6f 69 6e 74 69 6e 67 20 lready pointing
29130 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 to the last entr
29140 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
29150 65 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 e before.** this
29160 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c routine was cal
29170 6c 65 64 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 led, then set *p
29180 52 65 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 Res=1..**.** The
29190 20 6d 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e main entry poin
291a0 74 20 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 t is sqlite3Btre
291b0 65 4e 65 78 74 28 29 2e 20 20 54 68 61 74 20 72 eNext(). That r
291c0 6f 75 74 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 outine is optimi
291d0 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 zed.** for the c
291e0 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 ommon case of me
291f0 72 65 6c 79 20 69 6e 63 72 65 6d 65 6e 74 69 6e rely incrementin
29200 67 20 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 g the cell count
29210 65 72 20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 er BtCursor.aiId
29220 78 0a 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 x.** to the next
29230 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 cell on the cur
29240 72 65 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 rent page. The
29250 28 73 6c 6f 77 65 72 29 20 62 74 72 65 65 4e 65 (slower) btreeNe
29260 78 74 28 29 20 68 65 6c 70 65 72 0a 2a 2a 20 72 xt() helper.** r
29270 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
29280 20 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 when it is nece
29290 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f ssary to move to
292a0 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 a different pag
292b0 65 20 6f 72 0a 2a 2a 20 74 6f 20 72 65 73 74 6f e or.** to resto
292c0 72 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a re the cursor..*
292d0 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 *.** The calling
292e0 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 function will s
292f0 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 et *pRes to 0 or
29300 20 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 1. The initial
29310 20 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 *pRes value.**
29320 77 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 will be 1 if the
29330 20 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 cursor being st
29340 65 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 epped correspond
29350 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 s to an SQL inde
29360 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 x and.** if this
29370 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 routine could h
29380 61 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 ave been skipped
29390 20 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 if that SQL ind
293a0 65 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 ex had been.** a
293b0 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 unique index.
293c0 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 63 61 Otherwise the ca
293d0 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 ller will have s
293e0 65 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f et *pRes to zero
293f0 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 ..** Zero is the
29400 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 common case. Th
29410 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e e btree implemen
29420 74 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 tation is free t
29430 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 o use the.** ini
29440 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 tial *pRes value
29450 20 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d as a hint to im
29460 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 prove performanc
29470 65 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 65 e, but the curre
29480 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 nt.** SQLite btr
29490 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ee implementatio
294a0 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 n does not. (Not
294b0 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 e that the comdb
294c0 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 2 btree.** imple
294d0 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 mentation does u
294e0 73 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f se this hint, ho
294f0 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 wever.).*/.stati
29500 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
29510 45 20 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 E int btreeNext(
29520 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
29530 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e int *pRes){. in
29540 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 64 78 3b t rc;. int idx;
29550 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
29560 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 e;.. assert( cu
29570 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
29580 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
29590 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
295a0 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 ==0 || pCur->eSt
295b0 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
295c0 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 2a D );. assert( *
295d0 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 69 66 28 pRes==0 );. if(
295e0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
295f0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 URSOR_VALID ){.
29600 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 assert( (pCur
29610 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
29620 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 F_ValidOvfl)==0
29630 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 );. rc = rest
29640 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
29650 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 n(pCur);. if(
29660 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
29670 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
29680 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
29690 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d CURSOR_INVALID=
296a0 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b =pCur->eState ){
296b0 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 . *pRes = 1
296c0 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
296d0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
296e0 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b if( pCur->sk
296f0 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 ipNext ){.
29700 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
29710 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
29720 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 ID || pCur->eSta
29730 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e te==CURSOR_SKIPN
29740 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 EXT );. pCu
29750 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
29760 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 OR_VALID;.
29770 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 if( pCur->skipNe
29780 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 xt>0 ){.
29790 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d pCur->skipNext =
297a0 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 0;. retu
297b0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
297c0 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 }. pCur
297d0 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a ->skipNext = 0;.
297e0 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 }. }.. pPa
297f0 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
29800 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
29810 20 20 69 64 78 20 3d 20 2b 2b 70 43 75 72 2d 3e idx = ++pCur->
29820 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
29830 65 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 e];. assert( pP
29840 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 0a age->isInit );..
29850 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
29860 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 6f 72 base file is cor
29870 72 75 70 74 2c 20 69 74 20 69 73 20 70 6f 73 73 rupt, it is poss
29880 69 62 6c 65 20 66 6f 72 20 74 68 65 20 76 61 6c ible for the val
29890 75 65 20 6f 66 20 69 64 78 20 0a 20 20 2a 2a 20 ue of idx . **
298a0 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 20 68 65 to be invalid he
298b0 72 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c re. This can onl
298c0 79 20 6f 63 63 75 72 20 69 66 20 61 20 73 65 63 y occur if a sec
298d0 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f 64 69 66 ond cursor modif
298e0 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 ies. ** the pag
298f0 65 20 77 68 69 6c 65 20 63 75 72 73 6f 72 20 70 e while cursor p
29900 43 75 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 Cur is holding a
29910 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 69 74 reference to it
29920 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 20 2a 2a . Which can. **
29930 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 only happen if
29940 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
29950 63 6f 72 72 75 70 74 20 69 6e 20 73 75 63 68 20 corrupt in such
29960 61 20 77 61 79 20 61 73 20 74 6f 20 6c 69 6e 6b a way as to link
29970 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 the. ** page i
29980 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e nto more than on
29990 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 e b-tree structu
299a0 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 re. */. testcas
299b0 65 28 20 69 64 78 3e 70 50 61 67 65 2d 3e 6e 43 e( idx>pPage->nC
299c0 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 20 69 64 ell );.. if( id
299d0 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 x>=pPage->nCell
299e0 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 ){. if( !pPag
299f0 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
29a00 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
29a10 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 74 65 d(pCur, get4byte
29a20 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
29a30 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
29a40 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 8]));. if(
29a50 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
29a60 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 return mov
29a70 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 eToLeftmost(pCur
29a80 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 6f 7b );. }. do{
29a90 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
29aa0 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 >iPage==0 ){.
29ab0 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a *pRes = 1;.
29ac0 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 pCur->eS
29ad0 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
29ae0 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 72 VALID;. r
29af0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
29b00 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d . }. m
29b10 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 oveToParent(pCur
29b20 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d );. pPage =
29b30 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
29b40 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 ur->iPage];.
29b50 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 69 }while( pCur->ai
29b60 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
29b70 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 >=pPage->nCell )
29b80 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d ;. if( pPage-
29b90 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 >intKey ){.
29ba0 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 return sqlite3B
29bb0 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 treeNext(pCur, p
29bc0 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b Res);. }else{
29bd0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
29be0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
29bf0 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e }. if( pPage->
29c00 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 leaf ){. retu
29c10 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
29c20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 }else{. retur
29c30 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
29c40 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 6e (pCur);. }.}.in
29c50 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 t sqlite3BtreeNe
29c60 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 xt(BtCursor *pCu
29c70 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
29c80 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
29c90 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
29ca0 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
29cb0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
29cc0 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 Res!=0 );. asse
29cd0 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 rt( *pRes==0 ||
29ce0 2a 70 52 65 73 3d 3d 31 20 29 3b 0a 20 20 61 73 *pRes==1 );. as
29cf0 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 sert( pCur->skip
29d00 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Next==0 || pCur-
29d10 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
29d20 56 41 4c 49 44 20 29 3b 0a 20 20 70 43 75 72 2d VALID );. pCur-
29d30 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
29d40 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 . pCur->curFlag
29d50 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 s &= ~(BTCF_Vali
29d60 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 dNKey|BTCF_Valid
29d70 4f 76 66 6c 29 3b 0a 20 20 2a 70 52 65 73 20 3d Ovfl);. *pRes =
29d80 20 30 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 0;. if( pCur->
29d90 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
29da0 41 4c 49 44 20 29 20 72 65 74 75 72 6e 20 62 74 ALID ) return bt
29db0 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 52 reeNext(pCur, pR
29dc0 65 73 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 70 es);. pPage = p
29dd0 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
29de0 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 69 66 28 20 ->iPage];. if(
29df0 28 2b 2b 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 (++pCur->aiIdx[p
29e00 43 75 72 2d 3e 69 50 61 67 65 5d 29 3e 3d 70 50 Cur->iPage])>=pP
29e10 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 age->nCell ){.
29e20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
29e30 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 ur->iPage]--;.
29e40 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 4e 65 return btreeNe
29e50 78 74 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a xt(pCur, pRes);.
29e60 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d }. if( pPage-
29e70 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 >leaf ){. ret
29e80 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
29e90 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
29ea0 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 rn moveToLeftmos
29eb0 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a t(pCur);. }.}..
29ec0 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 20 63 /*.** Step the c
29ed0 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 61 63 ursor to the bac
29ee0 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 k to the previou
29ef0 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 s entry in the d
29f00 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a 2a 20 atabase. If.**
29f10 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 6e 20 successful then
29f20 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 49 66 set *pRes=0. If
29f30 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 the cursor.** w
29f40 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 as already point
29f50 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72 73 74 ing to the first
29f60 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 entry in the da
29f70 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a 2a 2a tabase before.**
29f80 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 this routine wa
29f90 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 73 s called, then s
29fa0 65 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2a 0a 2a et *pRes=1..**.*
29fb0 2a 20 54 68 65 20 6d 61 69 6e 20 65 6e 74 72 79 * The main entry
29fc0 20 70 6f 69 6e 74 20 69 73 20 73 71 6c 69 74 65 point is sqlite
29fd0 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 28 29 3BtreePrevious()
29fe0 2e 20 20 54 68 61 74 20 72 6f 75 74 69 6e 65 20 . That routine
29ff0 69 73 20 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 is optimized.**
2a000 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 for the common c
2a010 61 73 65 20 6f 66 20 6d 65 72 65 6c 79 20 64 65 ase of merely de
2a020 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 crementing the c
2a030 65 6c 6c 20 63 6f 75 6e 74 65 72 20 42 74 43 75 ell counter BtCu
2a040 72 73 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f rsor.aiIdx.** to
2a050 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 63 65 the previous ce
2a060 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e ll on the curren
2a070 74 20 70 61 67 65 2e 20 20 54 68 65 20 28 73 6c t page. The (sl
2a080 6f 77 65 72 29 20 62 74 72 65 65 50 72 65 76 69 ower) btreePrevi
2a090 6f 75 73 28 29 0a 2a 2a 20 68 65 6c 70 65 72 20 ous().** helper
2a0a0 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
2a0b0 64 20 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 d when it is nec
2a0c0 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 essary to move t
2a0d0 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 o a different pa
2a0e0 67 65 0a 2a 2a 20 6f 72 20 74 6f 20 72 65 73 74 ge.** or to rest
2a0f0 6f 72 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a ore the cursor..
2a100 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e **.** The callin
2a110 67 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 g function will
2a120 73 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f set *pRes to 0 o
2a130 72 20 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 r 1. The initia
2a140 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a l *pRes value.**
2a150 20 77 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 will be 1 if th
2a160 65 20 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 e cursor being s
2a170 74 65 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e tepped correspon
2a180 64 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 ds to an SQL ind
2a190 65 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 ex and.** if thi
2a1a0 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 s routine could
2a1b0 68 61 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 have been skippe
2a1c0 64 20 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e d if that SQL in
2a1d0 64 65 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 dex had been.**
2a1e0 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 a unique index.
2a1f0 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 63 Otherwise the c
2a200 61 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 aller will have
2a210 73 65 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 set *pRes to zer
2a220 6f 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 o..** Zero is th
2a230 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 e common case. T
2a240 68 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 he btree impleme
2a250 6e 74 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 ntation is free
2a260 74 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e to use the.** in
2a270 69 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 itial *pRes valu
2a280 65 20 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 e as a hint to i
2a290 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e mprove performan
2a2a0 63 65 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 ce, but the curr
2a2b0 65 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 ent.** SQLite bt
2a2c0 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ree implementati
2a2d0 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f on does not. (No
2a2e0 74 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 te that the comd
2a2f0 62 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c b2 btree.** impl
2a300 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 ementation does
2a310 75 73 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 use this hint, h
2a320 6f 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 owever.).*/.stat
2a330 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 ic SQLITE_NOINLI
2a340 4e 45 20 69 6e 74 20 62 74 72 65 65 50 72 65 76 NE int btreePrev
2a350 69 6f 75 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ious(BtCursor *p
2a360 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b Cur, int *pRes){
2a370 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65 6d . int rc;. Mem
2a380 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 Page *pPage;..
2a390 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
2a3a0 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
2a3b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 73 ;. assert( pRes
2a3c0 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
2a3d0 20 2a 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 61 *pRes==0 );. a
2a3e0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 ssert( pCur->ski
2a3f0 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 pNext==0 || pCur
2a400 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
2a410 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 _VALID );. asse
2a420 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c rt( (pCur->curFl
2a430 61 67 73 20 26 20 28 42 54 43 46 5f 41 74 4c 61 ags & (BTCF_AtLa
2a440 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 st|BTCF_ValidOvf
2a450 6c 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 l|BTCF_ValidNKey
2a460 29 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ))==0 );. asser
2a470 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 t( pCur->info.nS
2a480 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 ize==0 );. if(
2a490 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
2a4a0 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 RSOR_VALID ){.
2a4b0 20 20 72 63 20 3d 20 72 65 73 74 6f 72 65 43 75 rc = restoreCu
2a4c0 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 rsorPosition(pCu
2a4d0 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d r);. if( rc!=
2a4e0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2a4f0 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
2a500 20 20 7d 0a 20 20 20 20 69 66 28 20 43 55 52 53 }. if( CURS
2a510 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 OR_INVALID==pCur
2a520 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 20 20 ->eState ){.
2a530 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 *pRes = 1;.
2a540 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2a550 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 _OK;. }. i
2a560 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 f( pCur->skipNex
2a570 74 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 t ){. asser
2a580 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
2a590 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c =CURSOR_VALID ||
2a5a0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
2a5b0 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 URSOR_SKIPNEXT )
2a5c0 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 ;. pCur->eS
2a5d0 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 tate = CURSOR_VA
2a5e0 4c 49 44 3b 0a 20 20 20 20 20 20 69 66 28 20 70 LID;. if( p
2a5f0 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3c 30 20 Cur->skipNext<0
2a600 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d ){. pCur-
2a610 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 >skipNext = 0;.
2a620 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
2a630 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
2a640 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 . pCur->ski
2a650 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 7d pNext = 0;. }
2a660 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 20 3d 20 . }.. pPage =
2a670 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
2a680 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 61 73 73 r->iPage];. ass
2a690 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e ert( pPage->isIn
2a6a0 69 74 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 it );. if( !pPa
2a6b0 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
2a6c0 69 6e 74 20 69 64 78 20 3d 20 70 43 75 72 2d 3e int idx = pCur->
2a6d0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2a6e0 65 5d 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 e];. rc = mov
2a6f0 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 eToChild(pCur, g
2a700 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
2a710 28 70 50 61 67 65 2c 20 69 64 78 29 29 29 3b 0a (pPage, idx)));.
2a720 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
2a730 75 72 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 3d urn rc;. rc =
2a740 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 moveToRightmost
2a750 28 70 43 75 72 29 3b 0a 20 20 7d 65 6c 73 65 7b (pCur);. }else{
2a760 0a 20 20 20 20 77 68 69 6c 65 28 20 70 43 75 72 . while( pCur
2a770 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2a780 61 67 65 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 age]==0 ){.
2a790 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 if( pCur->iPage
2a7a0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ==0 ){. p
2a7b0 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
2a7c0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
2a7d0 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b *pRes = 1;
2a7e0 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
2a7f0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 SQLITE_OK;.
2a800 20 7d 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f 50 }. moveToP
2a810 61 72 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 20 arent(pCur);.
2a820 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 }. assert( p
2a830 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d Cur->info.nSize=
2a840 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 =0 );. assert
2a850 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 ( (pCur->curFlag
2a860 73 20 26 20 28 42 54 43 46 5f 56 61 6c 69 64 4e s & (BTCF_ValidN
2a870 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 Key|BTCF_ValidOv
2a880 66 6c 29 29 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 fl))==0 );..
2a890 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
2a8a0 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 20 20 ->iPage]--;.
2a8b0 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 pPage = pCur->ap
2a8c0 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
2a8d0 5d 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 ];. if( pPage
2a8e0 2d 3e 69 6e 74 4b 65 79 20 26 26 20 21 70 50 61 ->intKey && !pPa
2a8f0 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
2a900 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 rc = sqlite3Bt
2a910 72 65 65 50 72 65 76 69 6f 75 73 28 70 43 75 72 reePrevious(pCur
2a920 2c 20 70 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c , pRes);. }el
2a930 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
2a940 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
2a950 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
2a960 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 .}.int sqlite3Bt
2a970 72 65 65 50 72 65 76 69 6f 75 73 28 42 74 43 75 reePrevious(BtCu
2a980 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 rsor *pCur, int
2a990 2a 70 52 65 73 29 7b 0a 20 20 61 73 73 65 72 74 *pRes){. assert
2a9a0 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
2a9b0 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
2a9c0 73 65 72 74 28 20 70 52 65 73 21 3d 30 20 29 3b sert( pRes!=0 );
2a9d0 0a 20 20 61 73 73 65 72 74 28 20 2a 70 52 65 73 . assert( *pRes
2a9e0 3d 3d 30 20 7c 7c 20 2a 70 52 65 73 3d 3d 31 20 ==0 || *pRes==1
2a9f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2aa00 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c r->skipNext==0 |
2aa10 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d | pCur->eState!=
2aa20 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
2aa30 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 70 *pRes = 0;. p
2aa40 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d Cur->curFlags &=
2aa50 20 7e 28 42 54 43 46 5f 41 74 4c 61 73 74 7c 42 ~(BTCF_AtLast|B
2aa60 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 TCF_ValidOvfl|BT
2aa70 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 3b 0a 20 CF_ValidNKey);.
2aa80 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a pCur->info.nSiz
2aa90 65 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 43 75 e = 0;. if( pCu
2aaa0 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
2aab0 52 5f 56 41 4c 49 44 0a 20 20 20 7c 7c 20 70 43 R_VALID. || pC
2aac0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
2aad0 69 50 61 67 65 5d 3d 3d 30 0a 20 20 20 7c 7c 20 iPage]==0. ||
2aae0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
2aaf0 72 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 66 3d r->iPage]->leaf=
2ab00 3d 30 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 75 =0. ){. retu
2ab10 72 6e 20 62 74 72 65 65 50 72 65 76 69 6f 75 73 rn btreePrevious
2ab20 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 (pCur, pRes);.
2ab30 7d 0a 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b }. pCur->aiIdx[
2ab40 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a pCur->iPage]--;.
2ab50 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2ab60 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c OK;.}../*.** All
2ab70 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 ocate a new page
2ab80 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 from the databa
2ab90 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 se file..**.** T
2aba0 68 65 20 6e 65 77 20 70 61 67 65 20 69 73 20 6d he new page is m
2abb0 61 72 6b 65 64 20 61 73 20 64 69 72 74 79 2e 20 arked as dirty.
2abc0 20 28 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 (In other words
2abd0 2c 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 , sqlite3PagerWr
2abe0 69 74 65 28 29 0a 2a 2a 20 68 61 73 20 61 6c 72 ite().** has alr
2abf0 65 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 eady been called
2ac00 20 6f 6e 20 74 68 65 20 6e 65 77 20 70 61 67 65 on the new page
2ac10 2e 29 20 20 54 68 65 20 6e 65 77 20 70 61 67 65 .) The new page
2ac20 20 68 61 73 20 61 6c 73 6f 0a 2a 2a 20 62 65 65 has also.** bee
2ac30 6e 20 72 65 66 65 72 65 6e 63 65 64 20 61 6e 64 n referenced and
2ac40 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 72 6f 75 the calling rou
2ac50 74 69 6e 65 20 69 73 20 72 65 73 70 6f 6e 73 69 tine is responsi
2ac60 62 6c 65 20 66 6f 72 20 63 61 6c 6c 69 6e 67 0a ble for calling.
2ac70 2a 2a 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 ** sqlite3PagerU
2ac80 6e 72 65 66 28 29 20 6f 6e 20 74 68 65 20 6e 65 nref() on the ne
2ac90 77 20 70 61 67 65 20 77 68 65 6e 20 69 74 20 69 w page when it i
2aca0 73 20 64 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 s done..**.** SQ
2acb0 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 LITE_OK is retur
2acc0 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 ned on success.
2acd0 20 41 6e 79 20 6f 74 68 65 72 20 72 65 74 75 72 Any other retur
2ace0 6e 20 76 61 6c 75 65 20 69 6e 64 69 63 61 74 65 n value indicate
2acf0 73 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 2e 20 20 s.** an error.
2ad00 2a 70 70 50 61 67 65 20 61 6e 64 20 2a 70 50 67 *ppPage and *pPg
2ad10 6e 6f 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 no are undefined
2ad20 20 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 in the event of
2ad30 20 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a 20 44 6f an error..** Do
2ad40 20 6e 6f 74 20 69 6e 76 6f 6b 65 20 73 71 6c 69 not invoke sqli
2ad50 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 20 te3PagerUnref()
2ad60 6f 6e 20 2a 70 70 50 61 67 65 20 69 66 20 61 6e on *ppPage if an
2ad70 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e error is return
2ad80 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
2ad90 20 22 6e 65 61 72 62 79 22 20 70 61 72 61 6d 65 "nearby" parame
2ada0 74 65 72 20 69 73 20 6e 6f 74 20 30 2c 20 74 68 ter is not 0, th
2adb0 65 6e 20 61 6e 20 65 66 66 6f 72 74 20 69 73 20 en an effort is
2adc0 6d 61 64 65 20 74 6f 20 0a 2a 2a 20 6c 6f 63 61 made to .** loca
2add0 74 65 20 61 20 70 61 67 65 20 63 6c 6f 73 65 20 te a page close
2ade0 74 6f 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 to the page numb
2adf0 65 72 20 22 6e 65 61 72 62 79 22 2e 20 20 54 68 er "nearby". Th
2ae00 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 is can be used i
2ae10 6e 20 61 6e 0a 2a 2a 20 61 74 74 65 6d 70 74 20 n an.** attempt
2ae20 74 6f 20 6b 65 65 70 20 72 65 6c 61 74 65 64 20 to keep related
2ae30 70 61 67 65 73 20 63 6c 6f 73 65 20 74 6f 20 65 pages close to e
2ae40 61 63 68 20 6f 74 68 65 72 20 69 6e 20 74 68 65 ach other in the
2ae50 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 0a database file,.
2ae60 2a 2a 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e ** which in turn
2ae70 20 63 61 6e 20 6d 61 6b 65 20 64 61 74 61 62 61 can make databa
2ae80 73 65 20 61 63 63 65 73 73 20 66 61 73 74 65 72 se access faster
2ae90 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 ..**.** If the e
2aea0 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 72 20 69 Mode parameter i
2aeb0 73 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 s BTALLOC_EXACT
2aec0 61 6e 64 20 74 68 65 20 6e 65 61 72 62 79 20 70 and the nearby p
2aed0 61 67 65 20 65 78 69 73 74 73 0a 2a 2a 20 61 6e age exists.** an
2aee0 79 77 68 65 72 65 20 6f 6e 20 74 68 65 20 66 72 ywhere on the fr
2aef0 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 20 69 74 ee-list, then it
2af00 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 is guaranteed t
2af10 6f 20 62 65 20 72 65 74 75 72 6e 65 64 2e 20 20 o be returned.
2af20 49 66 0a 2a 2a 20 65 4d 6f 64 65 20 69 73 20 42 If.** eMode is B
2af30 54 41 4c 4c 4f 43 5f 4c 54 20 74 68 65 6e 20 74 TALLOC_LT then t
2af40 68 65 20 70 61 67 65 20 72 65 74 75 72 6e 65 64 he page returned
2af50 20 77 69 6c 6c 20 62 65 20 6c 65 73 73 20 74 68 will be less th
2af60 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 74 an or equal.** t
2af70 6f 20 6e 65 61 72 62 79 20 69 66 20 61 6e 79 20 o nearby if any
2af80 73 75 63 68 20 70 61 67 65 20 65 78 69 73 74 73 such page exists
2af90 2e 20 20 49 66 20 65 4d 6f 64 65 20 69 73 20 42 . If eMode is B
2afa0 54 41 4c 4c 4f 43 5f 41 4e 59 20 74 68 65 6e 20 TALLOC_ANY then
2afb0 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 there.** are no
2afc0 72 65 73 74 72 69 63 74 69 6f 6e 73 20 6f 6e 20 restrictions on
2afd0 77 68 69 63 68 20 70 61 67 65 20 69 73 20 72 65 which page is re
2afe0 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 turned..*/.stati
2aff0 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 c int allocateBt
2b000 72 65 65 50 61 67 65 28 0a 20 20 42 74 53 68 61 reePage(. BtSha
2b010 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
2b020 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a /* The btree *
2b030 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
2b040 50 61 67 65 2c 20 20 20 20 20 20 2f 2a 20 53 74 Page, /* St
2b050 6f 72 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 ore pointer to t
2b060 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 he allocated pag
2b070 65 20 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f e here */. Pgno
2b080 20 2a 70 50 67 6e 6f 2c 20 20 20 20 20 20 20 20 *pPgno,
2b090 20 20 20 2f 2a 20 53 74 6f 72 65 20 74 68 65 20 /* Store the
2b0a0 70 61 67 65 20 6e 75 6d 62 65 72 20 68 65 72 65 page number here
2b0b0 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 65 61 72 62 */. Pgno nearb
2b0c0 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 y, /*
2b0d0 53 65 61 72 63 68 20 66 6f 72 20 61 20 70 61 67 Search for a pag
2b0e0 65 20 6e 65 61 72 20 74 68 69 73 20 6f 6e 65 20 e near this one
2b0f0 2a 2f 0a 20 20 75 38 20 65 4d 6f 64 65 20 20 20 */. u8 eMode
2b100 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
2b110 54 41 4c 4c 4f 43 5f 45 58 41 43 54 2c 20 42 54 TALLOC_EXACT, BT
2b120 41 4c 4c 4f 43 5f 4c 54 2c 20 6f 72 20 42 54 41 ALLOC_LT, or BTA
2b130 4c 4c 4f 43 5f 41 4e 59 20 2a 2f 0a 29 7b 0a 20 LLOC_ANY */.){.
2b140 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 MemPage *pPage1
2b150 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 ;. int rc;. u3
2b160 32 20 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 2 n; /* Numb
2b170 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 er of pages on t
2b180 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a 20 he freelist */.
2b190 20 75 33 32 20 6b 3b 20 20 20 20 20 2f 2a 20 4e u32 k; /* N
2b1a0 75 6d 62 65 72 20 6f 66 20 6c 65 61 76 65 73 20 umber of leaves
2b1b0 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 6f 66 20 on the trunk of
2b1c0 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a the freelist */.
2b1d0 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 72 75 6e MemPage *pTrun
2b1e0 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 k = 0;. MemPage
2b1f0 20 2a 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 30 *pPrevTrunk = 0
2b200 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 61 67 65 3b ;. Pgno mxPage;
2b210 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 69 /* Total si
2b220 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
2b230 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 61 73 se file */.. as
2b240 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
2b250 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
2b260 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
2b270 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 ( eMode==BTALLOC
2b280 5f 41 4e 59 20 7c 7c 20 28 6e 65 61 72 62 79 3e _ANY || (nearby>
2b290 30 20 26 26 20 49 66 4e 6f 74 4f 6d 69 74 41 56 0 && IfNotOmitAV
2b2a0 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d (pBt->autoVacuum
2b2b0 29 29 20 29 3b 0a 20 20 70 50 61 67 65 31 20 3d )) );. pPage1 =
2b2c0 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 pBt->pPage1;.
2b2d0 6d 78 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 mxPage = btreePa
2b2e0 67 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 gecount(pBt);.
2b2f0 6e 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 n = get4byte(&pP
2b300 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 age1->aData[36])
2b310 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d ;. testcase( n=
2b320 3d 6d 78 50 61 67 65 2d 31 20 29 3b 0a 20 20 69 =mxPage-1 );. i
2b330 66 28 20 6e 3e 3d 6d 78 50 61 67 65 20 29 7b 0a f( n>=mxPage ){.
2b340 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2b350 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
2b360 20 20 7d 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b }. if( n>0 ){
2b370 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 . /* There ar
2b380 65 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 e pages on the f
2b390 72 65 65 6c 69 73 74 2e 20 20 52 65 75 73 65 20 reelist. Reuse
2b3a0 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 70 61 67 one of those pag
2b3b0 65 73 2e 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 es. */. Pgno
2b3c0 69 54 72 75 6e 6b 3b 0a 20 20 20 20 75 38 20 73 iTrunk;. u8 s
2b3d0 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 20 2f earchList = 0; /
2b3e0 2a 20 49 66 20 74 68 65 20 66 72 65 65 2d 6c 69 * If the free-li
2b3f0 73 74 20 6d 75 73 74 20 62 65 20 73 65 61 72 63 st must be searc
2b400 68 65 64 20 66 6f 72 20 27 6e 65 61 72 62 79 27 hed for 'nearby'
2b410 20 2a 2f 0a 20 20 20 20 0a 20 20 20 20 2f 2a 20 */. . /*
2b420 49 66 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f If eMode==BTALLO
2b430 43 5f 45 58 41 43 54 20 61 6e 64 20 61 20 71 75 C_EXACT and a qu
2b440 65 72 79 20 6f 66 20 74 68 65 20 70 6f 69 6e 74 ery of the point
2b450 65 72 2d 6d 61 70 0a 20 20 20 20 2a 2a 20 73 68 er-map. ** sh
2b460 6f 77 73 20 74 68 61 74 20 74 68 65 20 70 61 67 ows that the pag
2b470 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 73 6f e 'nearby' is so
2b480 6d 65 77 68 65 72 65 20 6f 6e 20 74 68 65 20 66 mewhere on the f
2b490 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 0a 20 ree-list, then.
2b4a0 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 ** the entire
2b4b0 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 20 73 65 -list will be se
2b4c0 61 72 63 68 65 64 20 66 6f 72 20 74 68 61 74 20 arched for that
2b4d0 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 23 69 66 page.. */.#if
2b4e0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2b4f0 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
2b500 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c if( eMode==BTALL
2b510 4f 43 5f 45 58 41 43 54 20 29 7b 0a 20 20 20 20 OC_EXACT ){.
2b520 20 20 69 66 28 20 6e 65 61 72 62 79 3c 3d 6d 78 if( nearby<=mx
2b530 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20 Page ){.
2b540 75 38 20 65 54 79 70 65 3b 0a 20 20 20 20 20 20 u8 eType;.
2b550 20 20 61 73 73 65 72 74 28 20 6e 65 61 72 62 79 assert( nearby
2b560 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 >0 );. as
2b570 73 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 sert( pBt->autoV
2b580 61 63 75 75 6d 20 29 3b 0a 20 20 20 20 20 20 20 acuum );.
2b590 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 rc = ptrmapGet(
2b5a0 70 42 74 2c 20 6e 65 61 72 62 79 2c 20 26 65 54 pBt, nearby, &eT
2b5b0 79 70 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 ype, 0);.
2b5c0 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
2b5d0 20 72 63 3b 0a 20 20 20 20 20 20 20 20 69 66 28 rc;. if(
2b5e0 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 eType==PTRMAP_F
2b5f0 52 45 45 50 41 47 45 20 29 7b 0a 20 20 20 20 20 REEPAGE ){.
2b600 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 searchList
2b610 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 = 1;. }.
2b620 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 }. }else
2b630 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c if( eMode==BTAL
2b640 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 20 20 20 20 LOC_LE ){.
2b650 73 65 61 72 63 68 4c 69 73 74 20 3d 20 31 3b 0a searchList = 1;.
2b660 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }.#endif..
2b670 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 /* Decrement t
2b680 68 65 20 66 72 65 65 2d 6c 69 73 74 20 63 6f 75 he free-list cou
2b690 6e 74 20 62 79 20 31 2e 20 53 65 74 20 69 54 72 nt by 1. Set iTr
2b6a0 75 6e 6b 20 74 6f 20 74 68 65 20 69 6e 64 65 78 unk to the index
2b6b0 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 66 of the. ** f
2b6c0 69 72 73 74 20 66 72 65 65 2d 6c 69 73 74 20 74 irst free-list t
2b6d0 72 75 6e 6b 20 70 61 67 65 2e 20 69 50 72 65 76 runk page. iPrev
2b6e0 54 72 75 6e 6b 20 69 73 20 69 6e 69 74 69 61 6c Trunk is initial
2b6f0 6c 79 20 31 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ly 1.. */.
2b700 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
2b710 65 72 57 72 69 74 65 28 70 50 61 67 65 31 2d 3e erWrite(pPage1->
2b720 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 pDbPage);. if
2b730 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
2b740 3b 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 26 ;. put4byte(&
2b750 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
2b760 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 20 20 20 2f 2a ], n-1);.. /*
2b770 20 54 68 65 20 63 6f 64 65 20 77 69 74 68 69 6e The code within
2b780 20 74 68 69 73 20 6c 6f 6f 70 20 69 73 20 72 75 this loop is ru
2b790 6e 20 6f 6e 6c 79 20 6f 6e 63 65 20 69 66 20 74 n only once if t
2b7a0 68 65 20 27 73 65 61 72 63 68 4c 69 73 74 27 20 he 'searchList'
2b7b0 76 61 72 69 61 62 6c 65 0a 20 20 20 20 2a 2a 20 variable. **
2b7c0 69 73 20 6e 6f 74 20 74 72 75 65 2e 20 4f 74 68 is not true. Oth
2b7d0 65 72 77 69 73 65 2c 20 69 74 20 72 75 6e 73 20 erwise, it runs
2b7e0 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 74 72 once for each tr
2b7f0 75 6e 6b 2d 70 61 67 65 20 6f 6e 20 74 68 65 0a unk-page on the.
2b800 20 20 20 20 2a 2a 20 66 72 65 65 2d 6c 69 73 74 ** free-list
2b810 20 75 6e 74 69 6c 20 74 68 65 20 70 61 67 65 20 until the page
2b820 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f 63 61 'nearby' is loca
2b830 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 4c ted (eMode==BTAL
2b840 4c 4f 43 5f 45 58 41 43 54 29 0a 20 20 20 20 2a LOC_EXACT). *
2b850 2a 20 6f 72 20 75 6e 74 69 6c 20 61 20 70 61 67 * or until a pag
2b860 65 20 6c 65 73 73 20 74 68 61 6e 20 27 6e 65 61 e less than 'nea
2b870 72 62 79 27 20 69 73 20 6c 6f 63 61 74 65 64 20 rby' is located
2b880 28 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f (eMode==BTALLOC_
2b890 4c 54 29 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 LT). */. d
2b8a0 6f 20 7b 0a 20 20 20 20 20 20 70 50 72 65 76 54 o {. pPrevT
2b8b0 72 75 6e 6b 20 3d 20 70 54 72 75 6e 6b 3b 0a 20 runk = pTrunk;.
2b8c0 20 20 20 20 20 69 66 28 20 70 50 72 65 76 54 72 if( pPrevTr
2b8d0 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 unk ){. i
2b8e0 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 Trunk = get4byte
2b8f0 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 (&pPrevTrunk->aD
2b900 61 74 61 5b 30 5d 29 3b 0a 20 20 20 20 20 20 7d ata[0]);. }
2b910 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 69 54 else{. iT
2b920 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 runk = get4byte(
2b930 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
2b940 32 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 2]);. }.
2b950 20 20 20 74 65 73 74 63 61 73 65 28 20 69 54 72 testcase( iTr
2b960 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 unk==mxPage );.
2b970 20 20 20 20 20 69 66 28 20 69 54 72 75 6e 6b 3e if( iTrunk>
2b980 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 mxPage ){.
2b990 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
2b9a0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
2b9b0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2b9c0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
2b9d0 67 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 ge(pBt, iTrunk,
2b9e0 26 70 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 &pTrunk, 0);.
2b9f0 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 }. if( r
2ba00 63 20 29 7b 0a 20 20 20 20 20 20 20 20 70 54 72 c ){. pTr
2ba10 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 unk = 0;.
2ba20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 goto end_alloca
2ba30 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 7d te_page;. }
2ba40 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
2ba50 54 72 75 6e 6b 21 3d 30 20 29 3b 0a 20 20 20 20 Trunk!=0 );.
2ba60 20 20 61 73 73 65 72 74 28 20 70 54 72 75 6e 6b assert( pTrunk
2ba70 2d 3e 61 44 61 74 61 21 3d 30 20 29 3b 0a 0a 20 ->aData!=0 );..
2ba80 20 20 20 20 20 6b 20 3d 20 67 65 74 34 62 79 74 k = get4byt
2ba90 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 e(&pTrunk->aData
2baa0 5b 34 5d 29 3b 20 2f 2a 20 23 20 6f 66 20 6c 65 [4]); /* # of le
2bab0 61 76 65 73 20 6f 6e 20 74 68 69 73 20 74 72 75 aves on this tru
2bac0 6e 6b 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 nk page */.
2bad0 20 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 73 65 if( k==0 && !se
2bae0 61 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 20 20 archList ){.
2baf0 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b /* The trunk
2bb00 20 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 20 61 has no leaves a
2bb10 6e 64 20 74 68 65 20 6c 69 73 74 20 69 73 20 6e nd the list is n
2bb20 6f 74 20 62 65 69 6e 67 20 73 65 61 72 63 68 65 ot being searche
2bb30 64 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 d. . ** S
2bb40 6f 20 65 78 74 72 61 63 74 20 74 68 65 20 74 72 o extract the tr
2bb50 75 6e 6b 20 70 61 67 65 20 69 74 73 65 6c 66 20 unk page itself
2bb60 61 6e 64 20 75 73 65 20 69 74 20 61 73 20 74 68 and use it as th
2bb70 65 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 20 20 e newly .
2bb80 20 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 ** allocated pa
2bb90 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 ge */. as
2bba0 73 65 72 74 28 20 70 50 72 65 76 54 72 75 6e 6b sert( pPrevTrunk
2bbb0 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 ==0 );. r
2bbc0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2bbd0 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 Write(pTrunk->pD
2bbe0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
2bbf0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
2bc00 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
2bc10 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
2bc20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2a 70 }. *p
2bc30 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 Pgno = iTrunk;.
2bc40 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
2bc50 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
2bc60 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
2bc70 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
2bc80 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e *ppPage = pTrun
2bc90 6b 3b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e k;. pTrun
2bca0 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 54 k = 0;. T
2bcb0 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a RACE(("ALLOCATE:
2bcc0 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 20 66 %d trunk - %d f
2bcd0 72 65 65 20 70 61 67 65 73 20 6c 65 66 74 5c 6e ree pages left\n
2bce0 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 29 29 ", *pPgno, n-1))
2bcf0 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 ;. }else if
2bd00 28 20 6b 3e 28 75 33 32 29 28 70 42 74 2d 3e 75 ( k>(u32)(pBt->u
2bd10 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 29 sableSize/4 - 2)
2bd20 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 56 ){. /* V
2bd30 61 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f 75 74 alue of k is out
2bd40 20 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 74 61 of range. Data
2bd50 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 base corruption
2bd60 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 */. rc =
2bd70 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
2bd80 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 KPT;. got
2bd90 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
2bda0 61 67 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c age;.#ifndef SQL
2bdb0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
2bdc0 55 55 4d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 UUM. }else
2bdd0 69 66 28 20 73 65 61 72 63 68 4c 69 73 74 20 0a if( searchList .
2bde0 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 && (
2bdf0 6e 65 61 72 62 79 3d 3d 69 54 72 75 6e 6b 20 7c nearby==iTrunk |
2be00 7c 20 28 69 54 72 75 6e 6b 3c 6e 65 61 72 62 79 | (iTrunk<nearby
2be10 20 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c && eMode==BTALL
2be20 4f 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 20 29 OC_LE)) . )
2be30 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 {. /* The
2be40 20 6c 69 73 74 20 69 73 20 62 65 69 6e 67 20 73 list is being s
2be50 65 61 72 63 68 65 64 20 61 6e 64 20 74 68 69 73 earched and this
2be60 20 74 72 75 6e 6b 20 70 61 67 65 20 69 73 20 74 trunk page is t
2be70 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 he page.
2be80 2a 2a 20 74 6f 20 61 6c 6c 6f 63 61 74 65 2c 20 ** to allocate,
2be90 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 regardless of wh
2bea0 65 74 68 65 72 20 69 74 20 68 61 73 20 6c 65 61 ether it has lea
2beb0 76 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ves.. */.
2bec0 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 3d *pPgno =
2bed0 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 iTrunk;.
2bee0 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e *ppPage = pTrun
2bef0 6b 3b 0a 20 20 20 20 20 20 20 20 73 65 61 72 63 k;. searc
2bf00 68 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 hList = 0;.
2bf10 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
2bf20 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b agerWrite(pTrunk
2bf30 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2bf40 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
2bf50 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
2bf60 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
2bf70 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2bf80 20 20 69 66 28 20 6b 3d 3d 30 20 29 7b 0a 20 20 if( k==0 ){.
2bf90 20 20 20 20 20 20 20 20 69 66 28 20 21 70 50 72 if( !pPr
2bfa0 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 evTrunk ){.
2bfb0 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
2bfc0 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
2bfd0 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
2bfe0 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
2bff0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2c000 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2c010 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 72 e3PagerWrite(pPr
2c020 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 evTrunk->pDbPage
2c030 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
2c040 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
2c050 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2c060 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
2c070 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
2c080 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2c090 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 72 65 memcpy(&pPre
2c0a0 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d vTrunk->aData[0]
2c0b0 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
2c0c0 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
2c0d0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c }. }el
2c0e0 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a se{. /*
2c0f0 20 54 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 The trunk page
2c100 69 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 is required by t
2c110 68 65 20 63 61 6c 6c 65 72 20 62 75 74 20 69 74 he caller but it
2c120 20 63 6f 6e 74 61 69 6e 73 20 0a 20 20 20 20 20 contains .
2c130 20 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 73 ** pointers
2c140 20 74 6f 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 to free-list le
2c150 61 76 65 73 2e 20 54 68 65 20 66 69 72 73 74 20 aves. The first
2c160 6c 65 61 66 20 62 65 63 6f 6d 65 73 20 61 20 74 leaf becomes a t
2c170 72 75 6e 6b 0a 20 20 20 20 20 20 20 20 20 20 2a runk. *
2c180 2a 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 63 * page in this c
2c190 61 73 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a ase.. *
2c1a0 2f 0a 20 20 20 20 20 20 20 20 20 20 4d 65 6d 50 /. MemP
2c1b0 61 67 65 20 2a 70 4e 65 77 54 72 75 6e 6b 3b 0a age *pNewTrunk;.
2c1c0 20 20 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 Pgno i
2c1d0 4e 65 77 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 NewTrunk = get4b
2c1e0 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
2c1f0 74 61 5b 38 5d 29 3b 0a 20 20 20 20 20 20 20 20 ta[8]);.
2c200 20 20 69 66 28 20 69 4e 65 77 54 72 75 6e 6b 3e if( iNewTrunk>
2c210 6d 78 50 61 67 65 20 29 7b 20 0a 20 20 20 20 20 mxPage ){ .
2c220 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
2c230 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
2c240 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 . got
2c250 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
2c260 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d age;. }
2c270 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 . testc
2c280 61 73 65 28 20 69 4e 65 77 54 72 75 6e 6b 3d 3d ase( iNewTrunk==
2c290 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
2c2a0 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 rc = btreeGe
2c2b0 74 50 61 67 65 28 70 42 74 2c 20 69 4e 65 77 54 tPage(pBt, iNewT
2c2c0 72 75 6e 6b 2c 20 26 70 4e 65 77 54 72 75 6e 6b runk, &pNewTrunk
2c2d0 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 0);.
2c2e0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2c2f0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 K ){.
2c300 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 goto end_alloca
2c310 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 te_page;.
2c320 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 72 }. r
2c330 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2c340 57 72 69 74 65 28 70 4e 65 77 54 72 75 6e 6b 2d Write(pNewTrunk-
2c350 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
2c360 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
2c370 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2c380 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
2c390 65 28 70 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 e(pNewTrunk);.
2c3a0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
2c3b0 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
2c3c0 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
2c3d0 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 memcpy(&
2c3e0 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 74 61 pNewTrunk->aData
2c3f0 5b 30 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 [0], &pTrunk->aD
2c400 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 ata[0], 4);.
2c410 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 put4byte(&
2c420 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 74 61 pNewTrunk->aData
2c430 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 20 20 20 20 [4], k-1);.
2c440 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 4e 65 memcpy(&pNe
2c450 77 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 38 5d wTrunk->aData[8]
2c460 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
2c470 5b 31 32 5d 2c 20 28 6b 2d 31 29 2a 34 29 3b 0a [12], (k-1)*4);.
2c480 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 releas
2c490 65 50 61 67 65 28 70 4e 65 77 54 72 75 6e 6b 29 ePage(pNewTrunk)
2c4a0 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
2c4b0 21 70 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a 20 !pPrevTrunk ){.
2c4c0 20 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 asser
2c4d0 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
2c4e0 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
2c4f0 31 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 1->pDbPage) );.
2c500 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 put4b
2c510 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
2c520 74 61 5b 33 32 5d 2c 20 69 4e 65 77 54 72 75 6e ta[32], iNewTrun
2c530 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 k);. }e
2c540 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 lse{.
2c550 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
2c560 65 72 57 72 69 74 65 28 70 50 72 65 76 54 72 75 erWrite(pPrevTru
2c570 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 nk->pDbPage);.
2c580 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
2c590 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2c5a0 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
2c5b0 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
2c5c0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2c5d0 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 put4byte(&pP
2c5e0 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b revTrunk->aData[
2c5f0 30 5d 2c 20 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 0], iNewTrunk);.
2c600 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2c610 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 54 }. pT
2c620 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 runk = 0;.
2c630 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 TRACE(("ALLOCA
2c640 54 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 TE: %d trunk - %
2c650 64 20 66 72 65 65 20 70 61 67 65 73 20 6c 65 66 d free pages lef
2c660 74 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d t\n", *pPgno, n-
2c670 31 29 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 1));.#endif.
2c680 20 20 7d 65 6c 73 65 20 69 66 28 20 6b 3e 30 20 }else if( k>0
2c690 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 78 ){. /* Ex
2c6a0 74 72 61 63 74 20 61 20 6c 65 61 66 20 66 72 6f tract a leaf fro
2c6b0 6d 20 74 68 65 20 74 72 75 6e 6b 20 2a 2f 0a 20 m the trunk */.
2c6c0 20 20 20 20 20 20 20 75 33 32 20 63 6c 6f 73 65 u32 close
2c6d0 73 74 3b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f st;. Pgno
2c6e0 20 69 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 iPage;.
2c6f0 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 61 unsigned char *a
2c700 44 61 74 61 20 3d 20 70 54 72 75 6e 6b 2d 3e 61 Data = pTrunk->a
2c710 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20 69 66 Data;. if
2c720 28 20 6e 65 61 72 62 79 3e 30 20 29 7b 0a 20 20 ( nearby>0 ){.
2c730 20 20 20 20 20 20 20 20 75 33 32 20 69 3b 0a 20 u32 i;.
2c740 20 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 closest
2c750 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
2c760 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c if( eMode==BTALL
2c770 4f 43 5f 4c 45 20 29 7b 0a 20 20 20 20 20 20 20 OC_LE ){.
2c780 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c for(i=0; i<
2c790 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 k; i++){.
2c7a0 20 20 20 20 20 20 20 69 50 61 67 65 20 3d 20 67 iPage = g
2c7b0 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 et4byte(&aData[8
2c7c0 2b 69 2a 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 +i*4]);.
2c7d0 20 20 20 20 20 20 69 66 28 20 69 50 61 67 65 3c if( iPage<
2c7e0 3d 6e 65 61 72 62 79 20 29 7b 0a 20 20 20 20 20 =nearby ){.
2c7f0 20 20 20 20 20 20 20 20 20 20 20 63 6c 6f 73 65 close
2c800 73 74 20 3d 20 69 3b 0a 20 20 20 20 20 20 20 20 st = i;.
2c810 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
2c820 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 }.
2c830 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
2c840 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
2c850 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 69 int di
2c860 73 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 st;.
2c870 64 69 73 74 20 3d 20 73 71 6c 69 74 65 33 41 62 dist = sqlite3Ab
2c880 73 49 6e 74 33 32 28 67 65 74 34 62 79 74 65 28 sInt32(get4byte(
2c890 26 61 44 61 74 61 5b 38 5d 29 20 2d 20 6e 65 61 &aData[8]) - nea
2c8a0 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 rby);.
2c8b0 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 6b 3b 20 for(i=1; i<k;
2c8c0 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 i++){.
2c8d0 20 20 20 20 69 6e 74 20 64 32 20 3d 20 73 71 6c int d2 = sql
2c8e0 69 74 65 33 41 62 73 49 6e 74 33 32 28 67 65 74 ite3AbsInt32(get
2c8f0 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 2b 69 4byte(&aData[8+i
2c900 2a 34 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a *4]) - nearby);.
2c910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 if
2c920 28 20 64 32 3c 64 69 73 74 20 29 7b 0a 20 20 20 ( d2<dist ){.
2c930 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6c 6f clo
2c940 73 65 73 74 20 3d 20 69 3b 0a 20 20 20 20 20 20 sest = i;.
2c950 20 20 20 20 20 20 20 20 20 20 64 69 73 74 20 3d dist =
2c960 20 64 32 3b 0a 20 20 20 20 20 20 20 20 20 20 20 d2;.
2c970 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 }.
2c980 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
2c990 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
2c9a0 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 20 closest
2c9b0 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a = 0;. }..
2c9c0 20 20 20 20 20 20 20 20 69 50 61 67 65 20 3d 20 iPage =
2c9d0 67 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b get4byte(&aData[
2c9e0 38 2b 63 6c 6f 73 65 73 74 2a 34 5d 29 3b 0a 20 8+closest*4]);.
2c9f0 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
2ca00 20 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 iPage==mxPage )
2ca10 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 50 ;. if( iP
2ca20 61 67 65 3e 6d 78 50 61 67 65 20 29 7b 0a 20 20 age>mxPage ){.
2ca30 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
2ca40 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
2ca50 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
2ca60 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
2ca70 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ge;. }.
2ca80 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
2ca90 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b iPage==mxPage );
2caa0 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 73 65 . if( !se
2cab0 61 72 63 68 4c 69 73 74 20 0a 20 20 20 20 20 20 archList .
2cac0 20 20 20 7c 7c 20 28 69 50 61 67 65 3d 3d 6e 65 || (iPage==ne
2cad0 61 72 62 79 20 7c 7c 20 28 69 50 61 67 65 3c 6e arby || (iPage<n
2cae0 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d earby && eMode==
2caf0 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 BTALLOC_LE)) .
2cb00 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
2cb10 20 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 int noContent
2cb20 3b 0a 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 ;. *pPg
2cb30 6e 6f 20 3d 20 69 50 61 67 65 3b 0a 20 20 20 20 no = iPage;.
2cb40 20 20 20 20 20 20 54 52 41 43 45 28 28 22 41 4c TRACE(("AL
2cb50 4c 4f 43 41 54 45 3a 20 25 64 20 77 61 73 20 6c LOCATE: %d was l
2cb60 65 61 66 20 25 64 20 6f 66 20 25 64 20 6f 6e 20 eaf %d of %d on
2cb70 74 72 75 6e 6b 20 25 64 22 0a 20 20 20 20 20 20 trunk %d".
2cb80 20 20 20 20 20 20 20 20 20 20 20 22 3a 20 25 64 ": %d
2cb90 20 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 more free pages
2cba0 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
2cbb0 20 20 20 20 20 20 2a 70 50 67 6e 6f 2c 20 63 6c *pPgno, cl
2cbc0 6f 73 65 73 74 2b 31 2c 20 6b 2c 20 70 54 72 75 osest+1, k, pTru
2cbd0 6e 6b 2d 3e 70 67 6e 6f 2c 20 6e 2d 31 29 29 3b nk->pgno, n-1));
2cbe0 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
2cbf0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2cc00 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 e(pTrunk->pDbPag
2cc10 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 e);. if
2cc20 28 20 72 63 20 29 20 67 6f 74 6f 20 65 6e 64 5f ( rc ) goto end_
2cc30 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
2cc40 20 20 20 20 20 20 20 20 20 69 66 28 20 63 6c 6f if( clo
2cc50 73 65 73 74 3c 6b 2d 31 20 29 7b 0a 20 20 20 20 sest<k-1 ){.
2cc60 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 memcpy(&
2cc70 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a aData[8+closest*
2cc80 34 5d 2c 20 26 61 44 61 74 61 5b 34 2b 6b 2a 34 4], &aData[4+k*4
2cc90 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 ], 4);.
2cca0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 }. put
2ccb0 34 62 79 74 65 28 26 61 44 61 74 61 5b 34 5d 2c 4byte(&aData[4],
2ccc0 20 6b 2d 31 29 3b 0a 20 20 20 20 20 20 20 20 20 k-1);.
2ccd0 20 6e 6f 43 6f 6e 74 65 6e 74 20 3d 20 21 62 74 noContent = !bt
2cce0 72 65 65 47 65 74 48 61 73 43 6f 6e 74 65 6e 74 reeGetHasContent
2ccf0 28 70 42 74 2c 20 2a 70 50 67 6e 6f 29 3f 20 50 (pBt, *pPgno)? P
2cd00 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 AGER_GET_NOCONTE
2cd10 4e 54 20 3a 20 30 3b 0a 20 20 20 20 20 20 20 20 NT : 0;.
2cd20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 rc = btreeGetP
2cd30 61 67 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c age(pBt, *pPgno,
2cd40 20 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 ppPage, noConte
2cd50 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 nt);. i
2cd60 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
2cd70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2cd80 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
2cd90 72 57 72 69 74 65 28 28 2a 70 70 50 61 67 65 29 rWrite((*ppPage)
2cda0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2cdb0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
2cdc0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2cdd0 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 relea
2cde0 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b sePage(*ppPage);
2cdf0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
2ce00 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2ce10 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 searchList
2ce20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 = 0;. }.
2ce30 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 6c }. rel
2ce40 65 61 73 65 50 61 67 65 28 70 50 72 65 76 54 72 easePage(pPrevTr
2ce50 75 6e 6b 29 3b 0a 20 20 20 20 20 20 70 50 72 65 unk);. pPre
2ce60 76 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 vTrunk = 0;.
2ce70 7d 77 68 69 6c 65 28 20 73 65 61 72 63 68 4c 69 }while( searchLi
2ce80 73 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 st );. }else{.
2ce90 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 65 20 /* There are
2cea0 6e 6f 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 no pages on the
2ceb0 66 72 65 65 6c 69 73 74 2c 20 73 6f 20 61 70 70 freelist, so app
2cec0 65 6e 64 20 61 20 6e 65 77 20 70 61 67 65 20 74 end a new page t
2ced0 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 o the. ** dat
2cee0 61 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 20 20 abase image..
2cef0 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 72 6d 61 **. ** Norma
2cf00 6c 6c 79 2c 20 6e 65 77 20 70 61 67 65 73 20 61 lly, new pages a
2cf10 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 llocated by this
2cf20 20 62 6c 6f 63 6b 20 63 61 6e 20 62 65 20 72 65 block can be re
2cf30 71 75 65 73 74 65 64 20 66 72 6f 6d 20 74 68 65 quested from the
2cf40 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 6c 61 . ** pager la
2cf50 79 65 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f yer with the 'no
2cf60 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 -content' flag s
2cf70 65 74 2e 20 54 68 69 73 20 70 72 65 76 65 6e 74 et. This prevent
2cf80 73 20 74 68 65 20 70 61 67 65 72 0a 20 20 20 20 s the pager.
2cf90 2a 2a 20 66 72 6f 6d 20 74 72 79 69 6e 67 20 74 ** from trying t
2cfa0 6f 20 72 65 61 64 20 74 68 65 20 70 61 67 65 73 o read the pages
2cfb0 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 content from di
2cfc0 73 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20 sk. However, if
2cfd0 74 68 65 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 the. ** curre
2cfe0 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 nt transaction h
2cff0 61 73 20 61 6c 72 65 61 64 79 20 72 75 6e 20 6f as already run o
2d000 6e 65 20 6f 72 20 6d 6f 72 65 20 69 6e 63 72 65 ne or more incre
2d010 6d 65 6e 74 61 6c 2d 76 61 63 75 75 6d 0a 20 20 mental-vacuum.
2d020 20 20 2a 2a 20 73 74 65 70 73 2c 20 74 68 65 6e ** steps, then
2d030 20 74 68 65 20 70 61 67 65 20 77 65 20 61 72 65 the page we are
2d040 20 61 62 6f 75 74 20 74 6f 20 61 6c 6c 6f 63 61 about to alloca
2d050 74 65 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 63 te may contain c
2d060 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 74 68 ontent. ** th
2d070 61 74 20 69 73 20 72 65 71 75 69 72 65 64 20 69 at is required i
2d080 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 n the event of a
2d090 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 68 rollback. In th
2d0a0 69 73 20 63 61 73 65 2c 20 64 6f 0a 20 20 20 20 is case, do.
2d0b0 2a 2a 20 6e 6f 74 20 73 65 74 20 74 68 65 20 6e ** not set the n
2d0c0 6f 2d 63 6f 6e 74 65 6e 74 20 66 6c 61 67 2e 20 o-content flag.
2d0d0 54 68 69 73 20 63 61 75 73 65 73 20 74 68 65 20 This causes the
2d0e0 70 61 67 65 72 20 74 6f 20 6c 6f 61 64 20 61 6e pager to load an
2d0f0 64 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a d journal. **
2d100 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 the current pag
2d110 65 20 63 6f 6e 74 65 6e 74 20 62 65 66 6f 72 65 e content before
2d120 20 6f 76 65 72 77 72 69 74 69 6e 67 20 69 74 2e overwriting it.
2d130 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e . **. ** N
2d140 6f 74 65 20 74 68 61 74 20 74 68 65 20 70 61 67 ote that the pag
2d150 65 72 20 77 69 6c 6c 20 6e 6f 74 20 61 63 74 75 er will not actu
2d160 61 6c 6c 79 20 61 74 74 65 6d 70 74 20 74 6f 20 ally attempt to
2d170 6c 6f 61 64 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 load or journal
2d180 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 65 6e 74 20 . ** content
2d190 66 6f 72 20 61 6e 79 20 70 61 67 65 20 74 68 61 for any page tha
2d1a0 74 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 6c 69 t really does li
2d1b0 65 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f e past the end o
2d1c0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 f the database.
2d1d0 20 20 20 2a 2a 20 66 69 6c 65 20 6f 6e 20 64 69 ** file on di
2d1e0 73 6b 2e 20 53 6f 20 74 68 65 20 65 66 66 65 63 sk. So the effec
2d1f0 74 73 20 6f 66 20 64 69 73 61 62 6c 69 6e 67 20 ts of disabling
2d200 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 6f the no-content o
2d210 70 74 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 20 20 ptimization.
2d220 2a 2a 20 68 65 72 65 20 61 72 65 20 63 6f 6e 66 ** here are conf
2d230 69 6e 65 64 20 74 6f 20 74 68 6f 73 65 20 70 61 ined to those pa
2d240 67 65 73 20 74 68 61 74 20 6c 69 65 20 62 65 74 ges that lie bet
2d250 77 65 65 6e 20 74 68 65 20 65 6e 64 20 6f 66 20 ween the end of
2d260 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 the. ** datab
2d270 61 73 65 20 69 6d 61 67 65 20 61 6e 64 20 74 68 ase image and th
2d280 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 e end of the dat
2d290 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 abase file..
2d2a0 2a 2f 0a 20 20 20 20 69 6e 74 20 62 4e 6f 43 6f */. int bNoCo
2d2b0 6e 74 65 6e 74 20 3d 20 28 30 3d 3d 49 66 4e 6f ntent = (0==IfNo
2d2c0 74 4f 6d 69 74 41 56 28 70 42 74 2d 3e 62 44 6f tOmitAV(pBt->bDo
2d2d0 54 72 75 6e 63 61 74 65 29 29 3f 20 50 41 47 45 Truncate))? PAGE
2d2e0 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 3a R_GET_NOCONTENT:
2d2f0 30 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 0;.. rc = sql
2d300 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
2d310 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 Bt->pPage1->pDbP
2d320 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
2d330 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
2d340 20 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a pBt->nPage++;.
2d350 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 if( pBt->nPa
2d360 67 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 ge==PENDING_BYTE
2d370 5f 50 41 47 45 28 70 42 74 29 20 29 20 70 42 74 _PAGE(pBt) ) pBt
2d380 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 0a 23 69 66 6e ->nPage++;..#ifn
2d390 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2d3a0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 AUTOVACUUM. i
2d3b0 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 f( pBt->autoVacu
2d3c0 75 6d 20 26 26 20 50 54 52 4d 41 50 5f 49 53 50 um && PTRMAP_ISP
2d3d0 41 47 45 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 AGE(pBt, pBt->nP
2d3e0 61 67 65 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a age) ){. /*
2d3f0 20 49 66 20 2a 70 50 67 6e 6f 20 72 65 66 65 72 If *pPgno refer
2d400 73 20 74 6f 20 61 20 70 6f 69 6e 74 65 72 2d 6d s to a pointer-m
2d410 61 70 20 70 61 67 65 2c 20 61 6c 6c 6f 63 61 74 ap page, allocat
2d420 65 20 74 77 6f 20 6e 65 77 20 70 61 67 65 73 0a e two new pages.
2d430 20 20 20 20 20 20 2a 2a 20 61 74 20 74 68 65 20 ** at the
2d440 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 20 end of the file
2d450 69 6e 73 74 65 61 64 20 6f 66 20 6f 6e 65 2e 20 instead of one.
2d460 54 68 65 20 66 69 72 73 74 20 61 6c 6c 6f 63 61 The first alloca
2d470 74 65 64 20 70 61 67 65 0a 20 20 20 20 20 20 2a ted page. *
2d480 2a 20 62 65 63 6f 6d 65 73 20 61 20 6e 65 77 20 * becomes a new
2d490 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 pointer-map page
2d4a0 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 69 73 20 , the second is
2d4b0 75 73 65 64 20 62 79 20 74 68 65 20 63 61 6c 6c used by the call
2d4c0 65 72 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 er.. */.
2d4d0 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 20 MemPage *pPg
2d4e0 3d 20 30 3b 0a 20 20 20 20 20 20 54 52 41 43 45 = 0;. TRACE
2d4f0 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 (("ALLOCATE: %d
2d500 66 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 from end of file
2d510 20 28 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 (pointer-map pa
2d520 67 65 29 5c 6e 22 2c 20 70 42 74 2d 3e 6e 50 61 ge)\n", pBt->nPa
2d530 67 65 29 29 3b 0a 20 20 20 20 20 20 61 73 73 65 ge));. asse
2d540 72 74 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d rt( pBt->nPage!=
2d550 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
2d560 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 20 20 E(pBt) );.
2d570 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
2d580 65 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 e(pBt, pBt->nPag
2d590 65 2c 20 26 70 50 67 2c 20 62 4e 6f 43 6f 6e 74 e, &pPg, bNoCont
2d5a0 65 6e 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ent);. if(
2d5b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2d5c0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
2d5d0 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
2d5e0 70 50 67 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 pPg->pDbPage);.
2d5f0 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 releasePa
2d600 67 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d ge(pPg);. }
2d610 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 . if( rc )
2d620 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
2d630 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 pBt->nPage++;.
2d640 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 if( pBt->nP
2d650 61 67 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 age==PENDING_BYT
2d660 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 20 70 E_PAGE(pBt) ){ p
2d670 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 Bt->nPage++; }.
2d680 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
2d690 70 75 74 34 62 79 74 65 28 32 38 20 2b 20 28 75 put4byte(28 + (u
2d6a0 38 2a 29 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 8*)pBt->pPage1->
2d6b0 61 44 61 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 aData, pBt->nPag
2d6c0 65 29 3b 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d e);. *pPgno =
2d6d0 20 70 42 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 pBt->nPage;..
2d6e0 20 20 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f assert( *pPgno
2d6f0 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 !=PENDING_BYTE_P
2d700 41 47 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 AGE(pBt) );.
2d710 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
2d720 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 e(pBt, *pPgno, p
2d730 70 50 61 67 65 2c 20 62 4e 6f 43 6f 6e 74 65 6e pPage, bNoConten
2d740 74 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 t);. if( rc )
2d750 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2d760 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
2d770 72 57 72 69 74 65 28 28 2a 70 70 50 61 67 65 29 rWrite((*ppPage)
2d780 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2d790 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2d7a0 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 K ){. relea
2d7b0 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b sePage(*ppPage);
2d7c0 0a 20 20 20 20 7d 0a 20 20 20 20 54 52 41 43 45 . }. TRACE
2d7d0 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 (("ALLOCATE: %d
2d7e0 66 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 from end of file
2d7f0 5c 6e 22 2c 20 2a 70 50 67 6e 6f 29 29 3b 0a 20 \n", *pPgno));.
2d800 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 2a 70 }.. assert( *p
2d810 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 59 Pgno!=PENDING_BY
2d820 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a TE_PAGE(pBt) );.
2d830 0a 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 .end_allocate_pa
2d840 67 65 3a 0a 20 20 72 65 6c 65 61 73 65 50 61 67 ge:. releasePag
2d850 65 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 6c e(pTrunk);. rel
2d860 65 61 73 65 50 61 67 65 28 70 50 72 65 76 54 72 easePage(pPrevTr
2d870 75 6e 6b 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d unk);. if( rc==
2d880 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2d890 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 if( sqlite3Page
2d8a0 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 28 2a rPageRefcount((*
2d8b0 70 70 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 ppPage)->pDbPage
2d8c0 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 72 65 6c )>1 ){. rel
2d8d0 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 easePage(*ppPage
2d8e0 29 3b 0a 20 20 20 20 20 20 2a 70 70 50 61 67 65 );. *ppPage
2d8f0 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 75 = 0;. retu
2d900 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
2d910 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 T_BKPT;. }.
2d920 20 20 28 2a 70 70 50 61 67 65 29 2d 3e 69 73 49 (*ppPage)->isI
2d930 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 nit = 0;. }else
2d940 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 {. *ppPage =
2d950 30 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 0;. }. assert(
2d960 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c rc!=SQLITE_OK |
2d970 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 | sqlite3PagerIs
2d980 77 72 69 74 65 61 62 6c 65 28 28 2a 70 70 50 61 writeable((*ppPa
2d990 67 65 29 2d 3e 70 44 62 50 61 67 65 29 20 29 3b ge)->pDbPage) );
2d9a0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
2d9b0 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
2d9c0 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 tion is used to
2d9d0 61 64 64 20 70 61 67 65 20 69 50 61 67 65 20 74 add page iPage t
2d9e0 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 o the database f
2d9f0 69 6c 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 0a ile free-list. .
2da00 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 ** It is assumed
2da10 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 69 that the page i
2da20 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 s not already a
2da30 70 61 72 74 20 6f 66 20 74 68 65 20 66 72 65 65 part of the free
2da40 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 -list..**.** The
2da50 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 value passed as
2da60 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 the second argu
2da70 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e ment to this fun
2da80 63 74 69 6f 6e 20 69 73 20 6f 70 74 69 6f 6e 61 ction is optiona
2da90 6c 2e 0a 2a 2a 20 49 66 20 74 68 65 20 63 61 6c l..** If the cal
2daa0 6c 65 72 20 68 61 70 70 65 6e 73 20 74 6f 20 68 ler happens to h
2dab0 61 76 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f ave a pointer to
2dac0 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a the MemPage obj
2dad0 65 63 74 20 0a 2a 2a 20 63 6f 72 72 65 73 70 6f ect .** correspo
2dae0 6e 64 69 6e 67 20 74 6f 20 70 61 67 65 20 69 50 nding to page iP
2daf0 61 67 65 20 68 61 6e 64 79 2c 20 69 74 20 6d 61 age handy, it ma
2db00 79 20 70 61 73 73 20 69 74 20 61 73 20 74 68 65 y pass it as the
2db10 20 73 65 63 6f 6e 64 20 76 61 6c 75 65 2e 20 0a second value. .
2db20 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 ** Otherwise, it
2db30 20 6d 61 79 20 70 61 73 73 20 4e 55 4c 4c 2e 0a may pass NULL..
2db40 2a 2a 0a 2a 2a 20 49 66 20 61 20 70 6f 69 6e 74 **.** If a point
2db50 65 72 20 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 er to a MemPage
2db60 6f 62 6a 65 63 74 20 69 73 20 70 61 73 73 65 64 object is passed
2db70 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 as the second a
2db80 72 67 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 73 20 rgument,.** its
2db90 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 reference count
2dba0 69 73 20 6e 6f 74 20 61 6c 74 65 72 65 64 20 62 is not altered b
2dbb0 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e y this function.
2dbc0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 .*/.static int f
2dbd0 72 65 65 50 61 67 65 32 28 42 74 53 68 61 72 65 reePage2(BtShare
2dbe0 64 20 2a 70 42 74 2c 20 4d 65 6d 50 61 67 65 20 d *pBt, MemPage
2dbf0 2a 70 4d 65 6d 50 61 67 65 2c 20 50 67 6e 6f 20 *pMemPage, Pgno
2dc00 69 50 61 67 65 29 7b 0a 20 20 4d 65 6d 50 61 67 iPage){. MemPag
2dc10 65 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 20 20 e *pTrunk = 0;
2dc20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2dc30 20 46 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b Free-list trunk
2dc40 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 page */. Pgno
2dc50 69 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 20 iTrunk = 0;
2dc60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2dc70 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 * Page number of
2dc80 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b free-list trunk
2dc90 20 70 61 67 65 20 2a 2f 20 0a 20 20 4d 65 6d 50 page */ . MemP
2dca0 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 age *pPage1 = pB
2dcb0 74 2d 3e 70 50 61 67 65 31 3b 20 20 20 20 20 20 t->pPage1;
2dcc0 2f 2a 20 4c 6f 63 61 6c 20 72 65 66 65 72 65 6e /* Local referen
2dcd0 63 65 20 74 6f 20 70 61 67 65 20 31 20 2a 2f 0a ce to page 1 */.
2dce0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
2dcf0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2dd00 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 62 65 /* Page be
2dd10 69 6e 67 20 66 72 65 65 64 2e 20 4d 61 79 20 62 ing freed. May b
2dd20 65 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 6e 74 e NULL. */. int
2dd30 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
2dd40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2dd50 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20 /* Return Code
2dd60 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b 20 */. int nFree;
2dd70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2dd80 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 /* Init
2dd90 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 ial number of pa
2dda0 67 65 73 20 6f 6e 20 66 72 65 65 2d 6c 69 73 74 ges on free-list
2ddb0 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
2ddc0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2ddd0 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
2dde0 0a 20 20 61 73 73 65 72 74 28 20 69 50 61 67 65 . assert( iPage
2ddf0 3e 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 >1 );. assert(
2de00 21 70 4d 65 6d 50 61 67 65 20 7c 7c 20 70 4d 65 !pMemPage || pMe
2de10 6d 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 mPage->pgno==iPa
2de20 67 65 20 29 3b 0a 0a 20 20 69 66 28 20 70 4d 65 ge );.. if( pMe
2de30 6d 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 mPage ){. pPa
2de40 67 65 20 3d 20 70 4d 65 6d 50 61 67 65 3b 0a 20 ge = pMemPage;.
2de50 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 sqlite3PagerR
2de60 65 66 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ef(pPage->pDbPag
2de70 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 e);. }else{.
2de80 20 70 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 pPage = btreePa
2de90 67 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 69 50 geLookup(pBt, iP
2dea0 61 67 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 age);. }.. /*
2deb0 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 Increment the fr
2dec0 65 65 20 70 61 67 65 20 63 6f 75 6e 74 20 6f 6e ee page count on
2ded0 20 70 50 61 67 65 31 20 2a 2f 0a 20 20 72 63 20 pPage1 */. rc
2dee0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
2def0 69 74 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 ite(pPage1->pDbP
2df00 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 age);. if( rc )
2df10 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
2df20 75 74 3b 0a 20 20 6e 46 72 65 65 20 3d 20 67 65 ut;. nFree = ge
2df30 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
2df40 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 70 75 aData[36]);. pu
2df50 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
2df60 61 44 61 74 61 5b 33 36 5d 2c 20 6e 46 72 65 65 aData[36], nFree
2df70 2b 31 29 3b 0a 0a 20 20 69 66 28 20 70 42 74 2d +1);.. if( pBt-
2df80 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
2df90 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b SECURE_DELETE ){
2dfa0 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 73 . /* If the s
2dfb0 65 63 75 72 65 5f 64 65 6c 65 74 65 20 6f 70 74 ecure_delete opt
2dfc0 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 ion is enabled,
2dfd0 74 68 65 6e 0a 20 20 20 20 2a 2a 20 61 6c 77 61 then. ** alwa
2dfe0 79 73 20 66 75 6c 6c 79 20 6f 76 65 72 77 72 69 ys fully overwri
2dff0 74 65 20 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 te deleted infor
2e000 6d 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f mation with zero
2e010 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 s.. */. if
2e020 28 20 28 21 70 50 61 67 65 20 26 26 20 28 28 72 ( (!pPage && ((r
2e030 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
2e040 28 70 42 74 2c 20 69 50 61 67 65 2c 20 26 70 50 (pBt, iPage, &pP
2e050 61 67 65 2c 20 30 29 29 21 3d 30 29 20 29 0a 20 age, 0))!=0) ).
2e060 20 20 20 20 7c 7c 20 20 20 20 20 20 20 20 20 20 ||
2e070 20 20 28 28 72 63 20 3d 20 73 71 6c 69 74 65 33 ((rc = sqlite3
2e080 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 PagerWrite(pPage
2e090 2d 3e 70 44 62 50 61 67 65 29 29 21 3d 30 29 0a ->pDbPage))!=0).
2e0a0 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 ){. got
2e0b0 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
2e0c0 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 }. memset
2e0d0 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 30 (pPage->aData, 0
2e0e0 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 61 , pPage->pBt->pa
2e0f0 67 65 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 geSize);. }..
2e100 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 /* If the databa
2e110 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f se supports auto
2e120 2d 76 61 63 75 75 6d 2c 20 77 72 69 74 65 20 61 -vacuum, write a
2e130 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 70 n entry in the p
2e140 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 2a 2a 20 ointer-map. **
2e150 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 to indicate that
2e160 20 74 68 65 20 70 61 67 65 20 69 73 20 66 72 65 the page is fre
2e170 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 49 53 e.. */. if( IS
2e180 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 AUTOVACUUM ){.
2e190 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
2e1a0 20 69 50 61 67 65 2c 20 50 54 52 4d 41 50 5f 46 iPage, PTRMAP_F
2e1b0 52 45 45 50 41 47 45 2c 20 30 2c 20 26 72 63 29 REEPAGE, 0, &rc)
2e1c0 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 67 ;. if( rc ) g
2e1d0 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
2e1e0 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 ;. }.. /* Now
2e1f0 6d 61 6e 69 70 75 6c 61 74 65 20 74 68 65 20 61 manipulate the a
2e200 63 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 66 ctual database f
2e210 72 65 65 2d 6c 69 73 74 20 73 74 72 75 63 74 75 ree-list structu
2e220 72 65 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 re. There are tw
2e230 6f 0a 20 20 2a 2a 20 70 6f 73 73 69 62 69 6c 69 o. ** possibili
2e240 74 69 65 73 2e 20 49 66 20 74 68 65 20 66 72 65 ties. If the fre
2e250 65 2d 6c 69 73 74 20 69 73 20 63 75 72 72 65 6e e-list is curren
2e260 74 6c 79 20 65 6d 70 74 79 2c 20 6f 72 20 69 66 tly empty, or if
2e270 20 74 68 65 20 66 69 72 73 74 0a 20 20 2a 2a 20 the first. **
2e280 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 trunk page in th
2e290 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 e free-list is f
2e2a0 75 6c 6c 2c 20 74 68 65 6e 20 74 68 69 73 20 70 ull, then this p
2e2b0 61 67 65 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 age will become
2e2c0 61 0a 20 20 2a 2a 20 6e 65 77 20 66 72 65 65 2d a. ** new free-
2e2d0 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e list trunk page.
2e2e0 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 77 Otherwise, it w
2e2f0 69 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6c 65 61 ill become a lea
2e300 66 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 66 69 f of the. ** fi
2e310 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 rst trunk page i
2e320 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 72 n the current fr
2e330 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 62 6c ee-list. This bl
2e340 6f 63 6b 20 74 65 73 74 73 20 69 66 20 69 74 0a ock tests if it.
2e350 20 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 6c 65 ** is possible
2e360 20 74 6f 20 61 64 64 20 74 68 65 20 70 61 67 65 to add the page
2e370 20 61 73 20 61 20 6e 65 77 20 66 72 65 65 2d 6c as a new free-l
2e380 69 73 74 20 6c 65 61 66 2e 0a 20 20 2a 2f 0a 20 ist leaf.. */.
2e390 20 69 66 28 20 6e 46 72 65 65 21 3d 30 20 29 7b if( nFree!=0 ){
2e3a0 0a 20 20 20 20 75 33 32 20 6e 4c 65 61 66 3b 20 . u32 nLeaf;
2e3b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2e3c0 2a 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 72 * Initial number
2e3d0 20 6f 66 20 6c 65 61 66 20 63 65 6c 6c 73 20 6f of leaf cells o
2e3e0 6e 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a n trunk page */.
2e3f0 0a 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 . iTrunk = ge
2e400 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
2e410 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 aData[32]);.
2e420 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
2e430 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 26 e(pBt, iTrunk, &
2e440 70 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 pTrunk, 0);.
2e450 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2e460 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 K ){. goto
2e470 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 freepage_out;.
2e480 20 20 7d 0a 0a 20 20 20 20 6e 4c 65 61 66 20 3d }.. nLeaf =
2e490 20 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e get4byte(&pTrun
2e4a0 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 k->aData[4]);.
2e4b0 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 assert( pBt->u
2e4c0 73 61 62 6c 65 53 69 7a 65 3e 33 32 20 29 3b 0a sableSize>32 );.
2e4d0 20 20 20 20 69 66 28 20 6e 4c 65 61 66 20 3e 20 if( nLeaf >
2e4e0 28 75 33 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 (u32)pBt->usable
2e4f0 53 69 7a 65 2f 34 20 2d 20 32 20 29 7b 0a 20 20 Size/4 - 2 ){.
2e500 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2e510 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
2e520 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 goto freepag
2e530 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 e_out;. }.
2e540 20 69 66 28 20 6e 4c 65 61 66 20 3c 20 28 75 33 if( nLeaf < (u3
2e550 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 2)pBt->usableSiz
2e560 65 2f 34 20 2d 20 38 20 29 7b 0a 20 20 20 20 20 e/4 - 8 ){.
2e570 20 2f 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 /* In this case
2e580 20 74 68 65 72 65 20 69 73 20 72 6f 6f 6d 20 6f there is room o
2e590 6e 20 74 68 65 20 74 72 75 6e 6b 20 70 61 67 65 n the trunk page
2e5a0 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 20 70 to insert the p
2e5b0 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 65 69 age. ** bei
2e5c0 6e 67 20 66 72 65 65 64 20 61 73 20 61 20 6e 65 ng freed as a ne
2e5d0 77 20 6c 65 61 66 2e 0a 20 20 20 20 20 20 2a 2a w leaf.. **
2e5e0 0a 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 . ** Note t
2e5f0 68 61 74 20 74 68 65 20 74 72 75 6e 6b 20 70 61 hat the trunk pa
2e600 67 65 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 ge is not really
2e610 20 66 75 6c 6c 20 75 6e 74 69 6c 20 69 74 20 63 full until it c
2e620 6f 6e 74 61 69 6e 73 0a 20 20 20 20 20 20 2a 2a ontains. **
2e630 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 usableSize/4 -
2e640 32 20 65 6e 74 72 69 65 73 2c 20 6e 6f 74 20 75 2 entries, not u
2e650 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 sableSize/4 - 8
2e660 65 6e 74 72 69 65 73 20 61 73 20 77 65 20 68 61 entries as we ha
2e670 76 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f 64 65 ve. ** code
2e680 64 2e 20 20 42 75 74 20 64 75 65 20 74 6f 20 61 d. But due to a
2e690 20 63 6f 64 69 6e 67 20 65 72 72 6f 72 20 69 6e coding error in
2e6a0 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
2e6b0 69 74 65 20 70 72 69 6f 72 20 74 6f 0a 20 20 20 ite prior to.
2e6c0 20 20 20 2a 2a 20 33 2e 36 2e 30 2c 20 64 61 74 ** 3.6.0, dat
2e6d0 61 62 61 73 65 73 20 77 69 74 68 20 66 72 65 65 abases with free
2e6e0 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 73 list trunk pages
2e6f0 20 68 6f 6c 64 69 6e 67 20 6d 6f 72 65 20 74 68 holding more th
2e700 61 6e 0a 20 20 20 20 20 20 2a 2a 20 75 73 61 62 an. ** usab
2e710 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 6e 74 leSize/4 - 8 ent
2e720 72 69 65 73 20 77 69 6c 6c 20 62 65 20 72 65 70 ries will be rep
2e730 6f 72 74 65 64 20 61 73 20 63 6f 72 72 75 70 74 orted as corrupt
2e740 2e 20 20 49 6e 20 6f 72 64 65 72 0a 20 20 20 20 . In order.
2e750 20 20 2a 2a 20 74 6f 20 6d 61 69 6e 74 61 69 6e ** to maintain
2e760 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 backwards compa
2e770 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c tibility with ol
2e780 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 der versions of
2e790 53 51 4c 69 74 65 2c 0a 20 20 20 20 20 20 2a 2a SQLite,. **
2e7a0 20 77 65 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 we will continu
2e7b0 65 20 74 6f 20 72 65 73 74 72 69 63 74 20 74 68 e to restrict th
2e7c0 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 e number of entr
2e7d0 69 65 73 20 74 6f 20 75 73 61 62 6c 65 53 69 7a ies to usableSiz
2e7e0 65 2f 34 20 2d 20 38 0a 20 20 20 20 20 20 2a 2a e/4 - 8. **
2e7f0 20 66 6f 72 20 6e 6f 77 2e 20 20 41 74 20 73 6f for now. At so
2e800 6d 65 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 me point in the
2e810 66 75 74 75 72 65 20 28 6f 6e 63 65 20 65 76 65 future (once eve
2e820 72 79 6f 6e 65 20 68 61 73 20 75 70 67 72 61 64 ryone has upgrad
2e830 65 64 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 33 ed. ** to 3
2e840 2e 36 2e 30 20 6f 72 20 6c 61 74 65 72 29 20 77 .6.0 or later) w
2e850 65 20 73 68 6f 75 6c 64 20 63 6f 6e 73 69 64 65 e should conside
2e860 72 20 66 69 78 69 6e 67 20 74 68 65 20 63 6f 6e r fixing the con
2e870 64 69 74 69 6f 6e 61 6c 20 61 62 6f 76 65 0a 20 ditional above.
2e880 20 20 20 20 20 2a 2a 20 74 6f 20 72 65 61 64 20 ** to read
2e890 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d 32 22 "usableSize/4-2"
2e8a0 20 69 6e 73 74 65 61 64 20 6f 66 20 22 75 73 61 instead of "usa
2e8b0 62 6c 65 53 69 7a 65 2f 34 2d 38 22 2e 0a 20 20 bleSize/4-8"..
2e8c0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 */. rc
2e8d0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
2e8e0 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 ite(pTrunk->pDbP
2e8f0 61 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 age);. if(
2e900 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2e910 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 . put4byt
2e920 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 e(&pTrunk->aData
2e930 5b 34 5d 2c 20 6e 4c 65 61 66 2b 31 29 3b 0a 20 [4], nLeaf+1);.
2e940 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
2e950 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 38 &pTrunk->aData[8
2e960 2b 6e 4c 65 61 66 2a 34 5d 2c 20 69 50 61 67 65 +nLeaf*4], iPage
2e970 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
2e980 50 61 67 65 20 26 26 20 28 70 42 74 2d 3e 62 74 Page && (pBt->bt
2e990 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 sFlags & BTS_SEC
2e9a0 55 52 45 5f 44 45 4c 45 54 45 29 3d 3d 30 20 29 URE_DELETE)==0 )
2e9b0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 {. sqli
2e9c0 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 69 74 te3PagerDontWrit
2e9d0 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
2e9e0 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
2e9f0 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 53 rc = btreeS
2ea00 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 74 etHasContent(pBt
2ea10 2c 20 69 50 61 67 65 29 3b 0a 20 20 20 20 20 20 , iPage);.
2ea20 7d 0a 20 20 20 20 20 20 54 52 41 43 45 28 28 22 }. TRACE(("
2ea30 46 52 45 45 2d 50 41 47 45 3a 20 25 64 20 6c 65 FREE-PAGE: %d le
2ea40 61 66 20 6f 6e 20 74 72 75 6e 6b 20 70 61 67 65 af on trunk page
2ea50 20 25 64 5c 6e 22 2c 70 50 61 67 65 2d 3e 70 67 %d\n",pPage->pg
2ea60 6e 6f 2c 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f 29 no,pTrunk->pgno)
2ea70 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 );. goto fr
2ea80 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 eepage_out;.
2ea90 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 63 }. }.. /* If c
2eaa0 6f 6e 74 72 6f 6c 20 66 6c 6f 77 73 20 74 6f 20 ontrol flows to
2eab0 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e this point, then
2eac0 20 69 74 20 77 61 73 20 6e 6f 74 20 70 6f 73 73 it was not poss
2ead0 69 62 6c 65 20 74 6f 20 61 64 64 20 74 68 65 0a ible to add the.
2eae0 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 62 65 ** the page be
2eaf0 69 6e 67 20 66 72 65 65 64 20 61 73 20 61 20 6c ing freed as a l
2eb00 65 61 66 20 70 61 67 65 20 6f 66 20 74 68 65 20 eaf page of the
2eb10 66 69 72 73 74 20 74 72 75 6e 6b 20 69 6e 20 74 first trunk in t
2eb20 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 20 20 he free-list..
2eb30 2a 2a 20 50 6f 73 73 69 62 6c 79 20 62 65 63 61 ** Possibly beca
2eb40 75 73 65 20 74 68 65 20 66 72 65 65 2d 6c 69 73 use the free-lis
2eb50 74 20 69 73 20 65 6d 70 74 79 2c 20 6f 72 20 70 t is empty, or p
2eb60 6f 73 73 69 62 6c 79 20 62 65 63 61 75 73 65 20 ossibly because
2eb70 74 68 65 20 0a 20 20 2a 2a 20 66 69 72 73 74 20 the . ** first
2eb80 74 72 75 6e 6b 20 69 6e 20 74 68 65 20 66 72 65 trunk in the fre
2eb90 65 2d 6c 69 73 74 20 69 73 20 66 75 6c 6c 2e 20 e-list is full.
2eba0 45 69 74 68 65 72 20 77 61 79 2c 20 74 68 65 20 Either way, the
2ebb0 70 61 67 65 20 62 65 69 6e 67 20 66 72 65 65 64 page being freed
2ebc0 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 63 6f 6d . ** will becom
2ebd0 65 20 74 68 65 20 6e 65 77 20 66 69 72 73 74 20 e the new first
2ebe0 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 trunk page in th
2ebf0 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 20 20 2a e free-list.. *
2ec00 2f 0a 20 20 69 66 28 20 70 50 61 67 65 3d 3d 30 /. if( pPage==0
2ec10 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 && SQLITE_OK!=(
2ec20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
2ec30 65 28 70 42 74 2c 20 69 50 61 67 65 2c 20 26 70 e(pBt, iPage, &p
2ec40 50 61 67 65 2c 20 30 29 29 20 29 7b 0a 20 20 20 Page, 0)) ){.
2ec50 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
2ec60 75 74 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 ut;. }. rc = s
2ec70 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
2ec80 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
2ec90 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
2eca0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 TE_OK ){. got
2ecb0 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
2ecc0 20 20 7d 0a 20 20 70 75 74 34 62 79 74 65 28 70 }. put4byte(p
2ecd0 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 54 72 Page->aData, iTr
2ece0 75 6e 6b 29 3b 0a 20 20 70 75 74 34 62 79 74 65 unk);. put4byte
2ecf0 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 34 (&pPage->aData[4
2ed00 5d 2c 20 30 29 3b 0a 20 20 70 75 74 34 62 79 74 ], 0);. put4byt
2ed10 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
2ed20 5b 33 32 5d 2c 20 69 50 61 67 65 29 3b 0a 20 20 [32], iPage);.
2ed30 54 52 41 43 45 28 28 22 46 52 45 45 2d 50 41 47 TRACE(("FREE-PAG
2ed40 45 3a 20 25 64 20 6e 65 77 20 74 72 75 6e 6b 20 E: %d new trunk
2ed50 70 61 67 65 20 72 65 70 6c 61 63 69 6e 67 20 25 page replacing %
2ed60 64 5c 6e 22 2c 20 70 50 61 67 65 2d 3e 70 67 6e d\n", pPage->pgn
2ed70 6f 2c 20 69 54 72 75 6e 6b 29 29 3b 0a 0a 66 72 o, iTrunk));..fr
2ed80 65 65 70 61 67 65 5f 6f 75 74 3a 0a 20 20 69 66 eepage_out:. if
2ed90 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 ( pPage ){. p
2eda0 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 30 Page->isInit = 0
2edb0 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 50 ;. }. releaseP
2edc0 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 72 65 age(pPage);. re
2edd0 6c 65 61 73 65 50 61 67 65 28 70 54 72 75 6e 6b leasePage(pTrunk
2ede0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
2edf0 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72 }.static void fr
2ee00 65 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a eePage(MemPage *
2ee10 70 50 61 67 65 2c 20 69 6e 74 20 2a 70 52 43 29 pPage, int *pRC)
2ee20 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 29 3d 3d {. if( (*pRC)==
2ee30 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2ee40 20 2a 70 52 43 20 3d 20 66 72 65 65 50 61 67 65 *pRC = freePage
2ee50 32 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 70 50 2(pPage->pBt, pP
2ee60 61 67 65 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f age, pPage->pgno
2ee70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 );. }.}../*.**
2ee80 46 72 65 65 20 61 6e 79 20 6f 76 65 72 66 6c 6f Free any overflo
2ee90 77 20 70 61 67 65 73 20 61 73 73 6f 63 69 61 74 w pages associat
2eea0 65 64 20 77 69 74 68 20 74 68 65 20 67 69 76 65 ed with the give
2eeb0 6e 20 43 65 6c 6c 2e 20 20 57 72 69 74 65 20 74 n Cell. Write t
2eec0 68 65 0a 2a 2a 20 6c 6f 63 61 6c 20 43 65 6c 6c he.** local Cell
2eed0 20 73 69 7a 65 20 28 74 68 65 20 6e 75 6d 62 65 size (the numbe
2eee0 72 20 6f 66 20 62 79 74 65 73 20 6f 6e 20 74 68 r of bytes on th
2eef0 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 67 65 2c e original page,
2ef00 20 6f 6d 69 74 74 69 6e 67 0a 2a 2a 20 6f 76 65 omitting.** ove
2ef10 72 66 6c 6f 77 29 20 69 6e 74 6f 20 2a 70 6e 53 rflow) into *pnS
2ef20 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ize..*/.static i
2ef30 6e 74 20 63 6c 65 61 72 43 65 6c 6c 28 0a 20 20 nt clearCell(.
2ef40 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
2ef50 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
2ef60 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 page that contai
2ef70 6e 73 20 74 68 65 20 43 65 6c 6c 20 2a 2f 0a 20 ns the Cell */.
2ef80 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
2ef90 70 43 65 6c 6c 2c 20 20 20 20 2f 2a 20 46 69 72 pCell, /* Fir
2efa0 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 43 st byte of the C
2efb0 65 6c 6c 20 2a 2f 0a 20 20 75 31 36 20 2a 70 6e ell */. u16 *pn
2efc0 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 Size
2efd0 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 73 /* Write the s
2efe0 69 7a 65 20 6f 66 20 74 68 65 20 43 65 6c 6c 20 ize of the Cell
2eff0 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 here */.){. BtS
2f000 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 hared *pBt = pPa
2f010 67 65 2d 3e 70 42 74 3b 0a 20 20 43 65 6c 6c 49 ge->pBt;. CellI
2f020 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 50 67 6e 6f nfo info;. Pgno
2f030 20 6f 76 66 6c 50 67 6e 6f 3b 0a 20 20 69 6e 74 ovflPgno;. int
2f040 20 72 63 3b 0a 20 20 69 6e 74 20 6e 4f 76 66 6c rc;. int nOvfl
2f050 3b 0a 20 20 75 33 32 20 6f 76 66 6c 50 61 67 65 ;. u32 ovflPage
2f060 53 69 7a 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 Size;.. assert(
2f070 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2f080 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
2f090 6d 75 74 65 78 29 20 29 3b 0a 20 20 62 74 72 65 mutex) );. btre
2f0a0 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 eParseCellPtr(pP
2f0b0 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 age, pCell, &inf
2f0c0 6f 29 3b 0a 20 20 2a 70 6e 53 69 7a 65 20 3d 20 o);. *pnSize =
2f0d0 69 6e 66 6f 2e 6e 53 69 7a 65 3b 0a 20 20 69 66 info.nSize;. if
2f0e0 28 20 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 ( info.iOverflow
2f0f0 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
2f100 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 2f 2a n SQLITE_OK; /*
2f110 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 No overflow pag
2f120 65 73 2e 20 52 65 74 75 72 6e 20 77 69 74 68 6f es. Return witho
2f130 75 74 20 64 6f 69 6e 67 20 61 6e 79 74 68 69 6e ut doing anythin
2f140 67 20 2a 2f 0a 20 20 7d 0a 20 20 69 66 28 20 70 g */. }. if( p
2f150 43 65 6c 6c 2b 69 6e 66 6f 2e 69 4f 76 65 72 66 Cell+info.iOverf
2f160 6c 6f 77 2b 33 20 3e 20 70 50 61 67 65 2d 3e 61 low+3 > pPage->a
2f170 44 61 74 61 2b 70 50 61 67 65 2d 3e 6d 61 73 6b Data+pPage->mask
2f180 50 61 67 65 20 29 7b 0a 20 20 20 20 72 65 74 75 Page ){. retu
2f190 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
2f1a0 54 5f 42 4b 50 54 3b 20 20 2f 2a 20 43 65 6c 6c T_BKPT; /* Cell
2f1b0 20 65 78 74 65 6e 64 73 20 70 61 73 74 20 65 6e extends past en
2f1c0 64 20 6f 66 20 70 61 67 65 20 2a 2f 0a 20 20 7d d of page */. }
2f1d0 0a 20 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 67 65 . ovflPgno = ge
2f1e0 74 34 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e t4byte(&pCell[in
2f1f0 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d 29 3b 0a fo.iOverflow]);.
2f200 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 assert( pBt->u
2f210 73 61 62 6c 65 53 69 7a 65 20 3e 20 34 20 29 3b sableSize > 4 );
2f220 0a 20 20 6f 76 66 6c 50 61 67 65 53 69 7a 65 20 . ovflPageSize
2f230 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
2f240 65 20 2d 20 34 3b 0a 20 20 6e 4f 76 66 6c 20 3d e - 4;. nOvfl =
2f250 20 28 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 (info.nPayload
2f260 2d 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2b 20 - info.nLocal +
2f270 6f 76 66 6c 50 61 67 65 53 69 7a 65 20 2d 20 31 ovflPageSize - 1
2f280 29 2f 6f 76 66 6c 50 61 67 65 53 69 7a 65 3b 0a )/ovflPageSize;.
2f290 20 20 61 73 73 65 72 74 28 20 6f 76 66 6c 50 67 assert( ovflPg
2f2a0 6e 6f 3d 3d 30 20 7c 7c 20 6e 4f 76 66 6c 3e 30 no==0 || nOvfl>0
2f2b0 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 6e 4f 76 );. while( nOv
2f2c0 66 6c 2d 2d 20 29 7b 0a 20 20 20 20 50 67 6e 6f fl-- ){. Pgno
2f2d0 20 69 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 iNext = 0;.
2f2e0 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 6c 20 3d MemPage *pOvfl =
2f2f0 20 30 3b 0a 20 20 20 20 69 66 28 20 6f 76 66 6c 0;. if( ovfl
2f300 50 67 6e 6f 3c 32 20 7c 7c 20 6f 76 66 6c 50 67 Pgno<2 || ovflPg
2f310 6e 6f 3e 62 74 72 65 65 50 61 67 65 63 6f 75 6e no>btreePagecoun
2f320 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 t(pBt) ){.
2f330 2f 2a 20 30 20 69 73 20 6e 6f 74 20 61 20 6c 65 /* 0 is not a le
2f340 67 61 6c 20 70 61 67 65 20 6e 75 6d 62 65 72 20 gal page number
2f350 61 6e 64 20 70 61 67 65 20 31 20 63 61 6e 6e 6f and page 1 canno
2f360 74 20 62 65 20 61 6e 20 0a 20 20 20 20 20 20 2a t be an . *
2f370 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e * overflow page.
2f380 20 54 68 65 72 65 66 6f 72 65 20 69 66 20 6f 76 Therefore if ov
2f390 66 6c 50 67 6e 6f 3c 32 20 6f 72 20 70 61 73 74 flPgno<2 or past
2f3a0 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
2f3b0 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 74 . ** file t
2f3c0 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 he database must
2f3d0 20 62 65 20 63 6f 72 72 75 70 74 2e 20 2a 2f 0a be corrupt. */.
2f3e0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
2f3f0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
2f400 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
2f410 6e 4f 76 66 6c 20 29 7b 0a 20 20 20 20 20 20 72 nOvfl ){. r
2f420 63 20 3d 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 c = getOverflowP
2f430 61 67 65 28 70 42 74 2c 20 6f 76 66 6c 50 67 6e age(pBt, ovflPgn
2f440 6f 2c 20 26 70 4f 76 66 6c 2c 20 26 69 4e 65 78 o, &pOvfl, &iNex
2f450 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 t);. if( rc
2f460 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
2f470 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 28 20 70 }.. if( ( p
2f480 4f 76 66 6c 20 7c 7c 20 28 28 70 4f 76 66 6c 20 Ovfl || ((pOvfl
2f490 3d 20 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 = btreePageLooku
2f4a0 70 28 70 42 74 2c 20 6f 76 66 6c 50 67 6e 6f 29 p(pBt, ovflPgno)
2f4b0 29 21 3d 30 29 20 29 0a 20 20 20 20 20 26 26 20 )!=0) ). &&
2f4c0 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 sqlite3PagerPage
2f4d0 52 65 66 63 6f 75 6e 74 28 70 4f 76 66 6c 2d 3e Refcount(pOvfl->
2f4e0 70 44 62 50 61 67 65 29 21 3d 31 0a 20 20 20 20 pDbPage)!=1.
2f4f0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 72 ){. /* Ther
2f500 65 20 69 73 20 6e 6f 20 72 65 61 73 6f 6e 20 61 e is no reason a
2f510 6e 79 20 63 75 72 73 6f 72 20 73 68 6f 75 6c 64 ny cursor should
2f520 20 68 61 76 65 20 61 6e 20 6f 75 74 73 74 61 6e have an outstan
2f530 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 20 0a ding reference .
2f540 20 20 20 20 20 20 2a 2a 20 74 6f 20 61 6e 20 6f ** to an o
2f550 76 65 72 66 6c 6f 77 20 70 61 67 65 20 62 65 6c verflow page bel
2f560 6f 6e 67 69 6e 67 20 74 6f 20 61 20 63 65 6c 6c onging to a cell
2f570 20 74 68 61 74 20 69 73 20 62 65 69 6e 67 20 64 that is being d
2f580 65 6c 65 74 65 64 2f 75 70 64 61 74 65 64 2e 0a eleted/updated..
2f590 20 20 20 20 20 20 2a 2a 20 53 6f 20 69 66 20 74 ** So if t
2f5a0 68 65 72 65 20 65 78 69 73 74 73 20 6d 6f 72 65 here exists more
2f5b0 20 74 68 61 6e 20 6f 6e 65 20 72 65 66 65 72 65 than one refere
2f5c0 6e 63 65 20 74 6f 20 74 68 69 73 20 70 61 67 65 nce to this page
2f5d0 2c 20 74 68 65 6e 20 69 74 20 0a 20 20 20 20 20 , then it .
2f5e0 20 2a 2a 20 6d 75 73 74 20 6e 6f 74 20 72 65 61 ** must not rea
2f5f0 6c 6c 79 20 62 65 20 61 6e 20 6f 76 65 72 66 6c lly be an overfl
2f600 6f 77 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 ow page and the
2f610 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 database must be
2f620 20 63 6f 72 72 75 70 74 2e 20 0a 20 20 20 20 20 corrupt. .
2f630 20 2a 2a 20 49 74 20 69 73 20 68 65 6c 70 66 75 ** It is helpfu
2f640 6c 20 74 6f 20 64 65 74 65 63 74 20 74 68 69 73 l to detect this
2f650 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 before calling
2f660 66 72 65 65 50 61 67 65 32 28 29 2c 20 61 73 20 freePage2(), as
2f670 0a 20 20 20 20 20 20 2a 2a 20 66 72 65 65 50 61 . ** freePa
2f680 67 65 32 28 29 20 6d 61 79 20 7a 65 72 6f 20 74 ge2() may zero t
2f690 68 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 73 he page contents
2f6a0 20 69 66 20 73 65 63 75 72 65 2d 64 65 6c 65 74 if secure-delet
2f6b0 65 20 6d 6f 64 65 20 69 73 0a 20 20 20 20 20 20 e mode is.
2f6c0 2a 2a 20 65 6e 61 62 6c 65 64 2e 20 49 66 20 74 ** enabled. If t
2f6d0 68 69 73 20 27 6f 76 65 72 66 6c 6f 77 27 20 70 his 'overflow' p
2f6e0 61 67 65 20 68 61 70 70 65 6e 73 20 74 6f 20 62 age happens to b
2f6f0 65 20 61 20 70 61 67 65 20 74 68 61 74 20 74 68 e a page that th
2f700 65 0a 20 20 20 20 20 20 2a 2a 20 63 61 6c 6c 65 e. ** calle
2f710 72 20 69 73 20 69 74 65 72 61 74 69 6e 67 20 74 r is iterating t
2f720 68 72 6f 75 67 68 20 6f 72 20 75 73 69 6e 67 20 hrough or using
2f730 69 6e 20 73 6f 6d 65 20 6f 74 68 65 72 20 77 61 in some other wa
2f740 79 2c 20 74 68 69 73 0a 20 20 20 20 20 20 2a 2a y, this. **
2f750 20 63 61 6e 20 62 65 20 70 72 6f 62 6c 65 6d 61 can be problema
2f760 74 69 63 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 tic.. */.
2f770 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2f780 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
2f790 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
2f7a0 63 20 3d 20 66 72 65 65 50 61 67 65 32 28 70 42 c = freePage2(pB
2f7b0 74 2c 20 70 4f 76 66 6c 2c 20 6f 76 66 6c 50 67 t, pOvfl, ovflPg
2f7c0 6e 6f 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 no);. }..
2f7d0 69 66 28 20 70 4f 76 66 6c 20 29 7b 0a 20 20 20 if( pOvfl ){.
2f7e0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 sqlite3PagerU
2f7f0 6e 72 65 66 28 70 4f 76 66 6c 2d 3e 70 44 62 50 nref(pOvfl->pDbP
2f800 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 age);. }.
2f810 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
2f820 72 63 3b 0a 20 20 20 20 6f 76 66 6c 50 67 6e 6f rc;. ovflPgno
2f830 20 3d 20 69 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 = iNext;. }.
2f840 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
2f850 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 ;.}../*.** Creat
2f860 65 20 74 68 65 20 62 79 74 65 20 73 65 71 75 65 e the byte seque
2f870 6e 63 65 20 75 73 65 64 20 74 6f 20 72 65 70 72 nce used to repr
2f880 65 73 65 6e 74 20 61 20 63 65 6c 6c 20 6f 6e 20 esent a cell on
2f890 70 61 67 65 20 70 50 61 67 65 0a 2a 2a 20 61 6e page pPage.** an
2f8a0 64 20 77 72 69 74 65 20 74 68 61 74 20 62 79 74 d write that byt
2f8b0 65 20 73 65 71 75 65 6e 63 65 20 69 6e 74 6f 20 e sequence into
2f8c0 70 43 65 6c 6c 5b 5d 2e 20 20 4f 76 65 72 66 6c pCell[]. Overfl
2f8d0 6f 77 20 70 61 67 65 73 20 61 72 65 0a 2a 2a 20 ow pages are.**
2f8e0 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 66 69 allocated and fi
2f8f0 6c 6c 65 64 20 69 6e 20 61 73 20 6e 65 63 65 73 lled in as neces
2f900 73 61 72 79 2e 20 20 54 68 65 20 63 61 6c 6c 69 sary. The calli
2f910 6e 67 20 70 72 6f 63 65 64 75 72 65 0a 2a 2a 20 ng procedure.**
2f920 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 is responsible f
2f930 6f 72 20 6d 61 6b 69 6e 67 20 73 75 72 65 20 73 or making sure s
2f940 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 20 ufficient space
2f950 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 has been allocat
2f960 65 64 0a 2a 2a 20 66 6f 72 20 70 43 65 6c 6c 5b ed.** for pCell[
2f970 5d 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 ]..**.** Note th
2f980 61 74 20 70 43 65 6c 6c 20 64 6f 65 73 20 6e 6f at pCell does no
2f990 74 20 6e 65 63 65 73 73 61 72 79 20 6e 65 65 64 t necessary need
2f9a0 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 to point to the
2f9b0 20 70 50 61 67 65 2d 3e 61 44 61 74 61 0a 2a 2a pPage->aData.**
2f9c0 20 61 72 65 61 2e 20 20 70 43 65 6c 6c 20 6d 69 area. pCell mi
2f9d0 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 73 6f 6d ght point to som
2f9e0 65 20 74 65 6d 70 6f 72 61 72 79 20 73 74 6f 72 e temporary stor
2f9f0 61 67 65 2e 20 20 54 68 65 20 63 65 6c 6c 20 77 age. The cell w
2fa00 69 6c 6c 0a 2a 2a 20 62 65 20 63 6f 6e 73 74 72 ill.** be constr
2fa10 75 63 74 65 64 20 69 6e 20 74 68 69 73 20 74 65 ucted in this te
2fa20 6d 70 6f 72 61 72 79 20 61 72 65 61 20 74 68 65 mporary area the
2fa30 6e 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 70 50 n copied into pP
2fa40 61 67 65 2d 3e 61 44 61 74 61 0a 2a 2a 20 6c 61 age->aData.** la
2fa50 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ter..*/.static i
2fa60 6e 74 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 0a 20 nt fillInCell(.
2fa70 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c MemPage *pPage,
2fa80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2fa90 2f 2a 20 54 68 65 20 70 61 67 65 20 74 68 61 74 /* The page that
2faa0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 63 65 contains the ce
2fab0 6c 6c 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ll */. unsigned
2fac0 20 63 68 61 72 20 2a 70 43 65 6c 6c 2c 20 20 20 char *pCell,
2fad0 20 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 /* Comple
2fae0 74 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 63 te text of the c
2faf0 65 6c 6c 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 ell */. const v
2fb00 6f 69 64 20 2a 70 4b 65 79 2c 20 69 36 34 20 6e oid *pKey, i64 n
2fb10 4b 65 79 2c 20 20 20 20 2f 2a 20 54 68 65 20 6b Key, /* The k
2fb20 65 79 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f ey */. const vo
2fb30 69 64 20 2a 70 44 61 74 61 2c 69 6e 74 20 6e 44 id *pData,int nD
2fb40 61 74 61 2c 20 20 20 2f 2a 20 54 68 65 20 64 61 ata, /* The da
2fb50 74 61 20 2a 2f 0a 20 20 69 6e 74 20 6e 5a 65 72 ta */. int nZer
2fb60 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o,
2fb70 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 20 /* Extra
2fb80 7a 65 72 6f 20 62 79 74 65 73 20 74 6f 20 61 70 zero bytes to ap
2fb90 70 65 6e 64 20 74 6f 20 70 44 61 74 61 20 2a 2f pend to pData */
2fba0 0a 20 20 69 6e 74 20 2a 70 6e 53 69 7a 65 20 20 . int *pnSize
2fbb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2fbc0 20 20 2f 2a 20 57 72 69 74 65 20 63 65 6c 6c 20 /* Write cell
2fbd0 73 69 7a 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a size here */.){.
2fbe0 20 20 69 6e 74 20 6e 50 61 79 6c 6f 61 64 3b 0a int nPayload;.
2fbf0 20 20 63 6f 6e 73 74 20 75 38 20 2a 70 53 72 63 const u8 *pSrc
2fc00 3b 0a 20 20 69 6e 74 20 6e 53 72 63 2c 20 6e 2c ;. int nSrc, n,
2fc10 20 72 63 3b 0a 20 20 69 6e 74 20 73 70 61 63 65 rc;. int space
2fc20 4c 65 66 74 3b 0a 20 20 4d 65 6d 50 61 67 65 20 Left;. MemPage
2fc30 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 4d 65 *pOvfl = 0;. Me
2fc40 6d 50 61 67 65 20 2a 70 54 6f 52 65 6c 65 61 73 mPage *pToReleas
2fc50 65 20 3d 20 30 3b 0a 20 20 75 6e 73 69 67 6e 65 e = 0;. unsigne
2fc60 64 20 63 68 61 72 20 2a 70 50 72 69 6f 72 3b 0a d char *pPrior;.
2fc70 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
2fc80 2a 70 50 61 79 6c 6f 61 64 3b 0a 20 20 42 74 53 *pPayload;. BtS
2fc90 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 hared *pBt = pPa
2fca0 67 65 2d 3e 70 42 74 3b 0a 20 20 50 67 6e 6f 20 ge->pBt;. Pgno
2fcb0 70 67 6e 6f 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 pgnoOvfl = 0;.
2fcc0 69 6e 74 20 6e 48 65 61 64 65 72 3b 0a 0a 20 20 int nHeader;..
2fcd0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
2fce0 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
2fcf0 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
2fd00 0a 0a 20 20 2f 2a 20 70 50 61 67 65 20 69 73 20 .. /* pPage is
2fd10 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 not necessarily
2fd20 77 72 69 74 65 61 62 6c 65 20 73 69 6e 63 65 20 writeable since
2fd30 70 43 65 6c 6c 20 6d 69 67 68 74 20 62 65 20 61 pCell might be a
2fd40 75 78 69 6c 69 61 72 79 0a 20 20 2a 2a 20 62 75 uxiliary. ** bu
2fd50 66 66 65 72 20 73 70 61 63 65 20 74 68 61 74 20 ffer space that
2fd60 69 73 20 73 65 70 61 72 61 74 65 20 66 72 6f 6d is separate from
2fd70 20 74 68 65 20 70 50 61 67 65 20 62 75 66 66 65 the pPage buffe
2fd80 72 20 61 72 65 61 20 2a 2f 0a 20 20 61 73 73 65 r area */. asse
2fd90 72 74 28 20 70 43 65 6c 6c 3c 70 50 61 67 65 2d rt( pCell<pPage-
2fda0 3e 61 44 61 74 61 20 7c 7c 20 70 43 65 6c 6c 3e >aData || pCell>
2fdb0 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 =&pPage->aData[p
2fdc0 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 Bt->pageSize].
2fdd0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c || sql
2fde0 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 ite3PagerIswrite
2fdf0 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 able(pPage->pDbP
2fe00 61 67 65 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 age) );.. /* Fi
2fe10 6c 6c 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 ll in the header
2fe20 2e 20 2a 2f 0a 20 20 6e 48 65 61 64 65 72 20 3d . */. nHeader =
2fe30 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
2fe40 53 69 7a 65 3b 0a 20 20 6e 50 61 79 6c 6f 61 64 Size;. nPayload
2fe50 20 3d 20 6e 44 61 74 61 20 2b 20 6e 5a 65 72 6f = nData + nZero
2fe60 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 ;. if( pPage->i
2fe70 6e 74 4b 65 79 4c 65 61 66 20 29 7b 0a 20 20 20 ntKeyLeaf ){.
2fe80 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 74 56 nHeader += putV
2fe90 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c 5b 6e arint32(&pCell[n
2fea0 48 65 61 64 65 72 5d 2c 20 6e 50 61 79 6c 6f 61 Header], nPayloa
2feb0 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 d);. }else{.
2fec0 20 61 73 73 65 72 74 28 20 6e 44 61 74 61 3d 3d assert( nData==
2fed0 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
2fee0 20 6e 5a 65 72 6f 3d 3d 30 20 29 3b 0a 20 20 7d nZero==0 );. }
2fef0 0a 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 . nHeader += pu
2ff00 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e tVarint(&pCell[n
2ff10 48 65 61 64 65 72 5d 2c 20 2a 28 75 36 34 2a 29 Header], *(u64*)
2ff20 26 6e 4b 65 79 29 3b 0a 20 20 0a 20 20 2f 2a 20 &nKey);. . /*
2ff30 46 69 6c 6c 20 69 6e 20 74 68 65 20 70 61 79 6c Fill in the payl
2ff40 6f 61 64 20 73 69 7a 65 20 2a 2f 0a 20 20 69 66 oad size */. if
2ff50 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 ( pPage->intKey
2ff60 29 7b 0a 20 20 20 20 70 53 72 63 20 3d 20 70 44 ){. pSrc = pD
2ff70 61 74 61 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 ata;. nSrc =
2ff80 6e 44 61 74 61 3b 0a 20 20 20 20 6e 44 61 74 61 nData;. nData
2ff90 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 20 0a = 0;. }else{ .
2ffa0 20 20 20 20 69 66 28 20 4e 45 56 45 52 28 6e 4b if( NEVER(nK
2ffb0 65 79 3e 30 78 37 66 66 66 66 66 66 66 20 7c 7c ey>0x7fffffff ||
2ffc0 20 70 4b 65 79 3d 3d 30 29 20 29 7b 0a 20 20 20 pKey==0) ){.
2ffd0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2ffe0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
2fff0 20 20 20 7d 0a 20 20 20 20 6e 50 61 79 6c 6f 61 }. nPayloa
30000 64 20 3d 20 28 69 6e 74 29 6e 4b 65 79 3b 0a 20 d = (int)nKey;.
30010 20 20 20 70 53 72 63 20 3d 20 70 4b 65 79 3b 0a pSrc = pKey;.
30020 20 20 20 20 6e 53 72 63 20 3d 20 28 69 6e 74 29 nSrc = (int)
30030 6e 4b 65 79 3b 0a 20 20 7d 0a 20 20 69 66 28 20 nKey;. }. if(
30040 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d nPayload<=pPage-
30050 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 >maxLocal ){.
30060 20 6e 20 3d 20 6e 48 65 61 64 65 72 20 2b 20 6e n = nHeader + n
30070 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 74 65 73 Payload;. tes
30080 74 63 61 73 65 28 20 6e 3d 3d 33 20 29 3b 0a 20 tcase( n==3 );.
30090 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d testcase( n==
300a0 34 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 3c 34 4 );. if( n<4
300b0 20 29 20 6e 20 3d 20 34 3b 0a 20 20 20 20 2a 70 ) n = 4;. *p
300c0 6e 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 20 20 73 nSize = n;. s
300d0 70 61 63 65 4c 65 66 74 20 3d 20 6e 50 61 79 6c paceLeft = nPayl
300e0 6f 61 64 3b 0a 20 20 20 20 70 50 72 69 6f 72 20 oad;. pPrior
300f0 3d 20 70 43 65 6c 6c 3b 0a 20 20 7d 65 6c 73 65 = pCell;. }else
30100 7b 0a 20 20 20 20 69 6e 74 20 6d 6e 20 3d 20 70 {. int mn = p
30110 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a Page->minLocal;.
30120 20 20 20 20 6e 20 3d 20 6d 6e 20 2b 20 28 6e 50 n = mn + (nP
30130 61 79 6c 6f 61 64 20 2d 20 6d 6e 29 20 25 20 28 ayload - mn) % (
30140 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
30150 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 leSize - 4);.
30160 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 testcase( n==pP
30170 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b age->maxLocal );
30180 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e . testcase( n
30190 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
301a0 6c 2b 31 20 29 3b 0a 20 20 20 20 69 66 28 20 6e l+1 );. if( n
301b0 20 3e 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 > pPage->maxLoc
301c0 61 6c 20 29 20 6e 20 3d 20 6d 6e 3b 0a 20 20 20 al ) n = mn;.
301d0 20 73 70 61 63 65 4c 65 66 74 20 3d 20 6e 3b 0a spaceLeft = n;.
301e0 20 20 20 20 2a 70 6e 53 69 7a 65 20 3d 20 6e 20 *pnSize = n
301f0 2b 20 6e 48 65 61 64 65 72 20 2b 20 34 3b 0a 20 + nHeader + 4;.
30200 20 20 20 70 50 72 69 6f 72 20 3d 20 26 70 43 65 pPrior = &pCe
30210 6c 6c 5b 6e 48 65 61 64 65 72 2b 6e 5d 3b 0a 20 ll[nHeader+n];.
30220 20 7d 0a 20 20 70 50 61 79 6c 6f 61 64 20 3d 20 }. pPayload =
30230 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 3b &pCell[nHeader];
30240 0a 0a 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 .. /* At this p
30250 6f 69 6e 74 20 76 61 72 69 61 62 6c 65 73 20 73 oint variables s
30260 68 6f 75 6c 64 20 62 65 20 73 65 74 20 61 73 20 hould be set as
30270 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 follows:. **.
30280 2a 2a 20 20 20 6e 50 61 79 6c 6f 61 64 20 20 20 ** nPayload
30290 20 20 20 20 20 20 20 20 54 6f 74 61 6c 20 70 61 Total pa
302a0 79 6c 6f 61 64 20 73 69 7a 65 20 69 6e 20 62 79 yload size in by
302b0 74 65 73 0a 20 20 2a 2a 20 20 20 70 50 61 79 6c tes. ** pPayl
302c0 6f 61 64 20 20 20 20 20 20 20 20 20 20 20 42 65 oad Be
302d0 67 69 6e 20 77 72 69 74 69 6e 67 20 70 61 79 6c gin writing payl
302e0 6f 61 64 20 68 65 72 65 0a 20 20 2a 2a 20 20 20 oad here. **
302f0 73 70 61 63 65 4c 65 66 74 20 20 20 20 20 20 20 spaceLeft
30300 20 20 20 53 70 61 63 65 20 61 76 61 69 6c 61 62 Space availab
30310 6c 65 20 61 74 20 70 50 61 79 6c 6f 61 64 2e 20 le at pPayload.
30320 20 49 66 20 6e 50 61 79 6c 6f 61 64 3e 73 70 61 If nPayload>spa
30330 63 65 4c 65 66 74 2c 0a 20 20 2a 2a 20 20 20 20 ceLeft,. **
30340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30350 20 20 74 68 61 74 20 6d 65 61 6e 73 20 63 6f 6e that means con
30360 74 65 6e 74 20 6d 75 73 74 20 73 70 69 6c 6c 20 tent must spill
30370 69 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 into overflow pa
30380 67 65 73 2e 0a 20 20 2a 2a 20 20 20 2a 70 6e 53 ges.. ** *pnS
30390 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 53 ize S
303a0 69 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c ize of the local
303b0 20 63 65 6c 6c 20 28 6e 6f 74 20 63 6f 75 6e 74 cell (not count
303c0 69 6e 67 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ing overflow pag
303d0 65 73 29 0a 20 20 2a 2a 20 20 20 70 50 72 69 6f es). ** pPrio
303e0 72 20 20 20 20 20 20 20 20 20 20 20 20 20 57 68 r Wh
303f0 65 72 65 20 74 6f 20 77 72 69 74 65 20 74 68 65 ere to write the
30400 20 70 67 6e 6f 20 6f 66 20 74 68 65 20 66 69 72 pgno of the fir
30410 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 st overflow page
30420 0a 20 20 2a 2a 0a 20 20 2a 2a 20 55 73 65 20 61 . **. ** Use a
30430 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 65 50 61 call to btreePa
30440 72 73 65 43 65 6c 6c 50 74 72 28 29 20 74 6f 20 rseCellPtr() to
30450 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 verify that the
30460 76 61 6c 75 65 73 20 61 62 6f 76 65 0a 20 20 2a values above. *
30470 2a 20 77 65 72 65 20 63 6f 6d 70 75 74 65 64 20 * were computed
30480 63 6f 72 72 65 63 74 6c 79 2e 0a 20 20 2a 2f 0a correctly.. */.
30490 23 69 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 #if SQLITE_DEBUG
304a0 0a 20 20 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 . {. CellInf
304b0 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 62 74 72 65 o info;. btre
304c0 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 eParseCellPtr(pP
304d0 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 age, pCell, &inf
304e0 6f 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 o);. assert(
304f0 6e 48 65 61 64 65 72 3d 28 69 6e 74 29 28 69 6e nHeader=(int)(in
30500 66 6f 2e 70 50 61 79 6c 6f 61 64 20 2d 20 70 43 fo.pPayload - pC
30510 65 6c 6c 29 20 29 3b 0a 20 20 20 20 61 73 73 65 ell) );. asse
30520 72 74 28 20 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 6e rt( info.nKey==n
30530 4b 65 79 20 29 3b 0a 20 20 20 20 61 73 73 65 72 Key );. asser
30540 74 28 20 2a 70 6e 53 69 7a 65 20 3d 3d 20 69 6e t( *pnSize == in
30550 66 6f 2e 6e 53 69 7a 65 20 29 3b 0a 20 20 20 20 fo.nSize );.
30560 61 73 73 65 72 74 28 20 73 70 61 63 65 4c 65 66 assert( spaceLef
30570 74 20 3d 3d 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c t == info.nLocal
30580 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
30590 70 50 72 69 6f 72 20 3d 3d 20 26 70 43 65 6c 6c pPrior == &pCell
305a0 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d [info.iOverflow]
305b0 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a );. }.#endif..
305c0 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 70 /* Write the p
305d0 61 79 6c 6f 61 64 20 69 6e 74 6f 20 74 68 65 20 ayload into the
305e0 6c 6f 63 61 6c 20 43 65 6c 6c 20 61 6e 64 20 61 local Cell and a
305f0 6e 79 20 65 78 74 72 61 20 69 6e 74 6f 20 6f 76 ny extra into ov
30600 65 72 66 6c 6f 77 20 70 61 67 65 73 20 2a 2f 0a erflow pages */.
30610 20 20 77 68 69 6c 65 28 20 6e 50 61 79 6c 6f 61 while( nPayloa
30620 64 3e 30 20 29 7b 0a 20 20 20 20 69 66 28 20 73 d>0 ){. if( s
30630 70 61 63 65 4c 65 66 74 3d 3d 30 20 29 7b 0a 23 paceLeft==0 ){.#
30640 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
30650 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
30660 20 20 20 20 50 67 6e 6f 20 70 67 6e 6f 50 74 72 Pgno pgnoPtr
30670 6d 61 70 20 3d 20 70 67 6e 6f 4f 76 66 6c 3b 20 map = pgnoOvfl;
30680 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 61 67 65 /* Overflow page
30690 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 pointer-map ent
306a0 72 79 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 ry page */.
306b0 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 if( pBt->autoVa
306c0 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 cuum ){.
306d0 64 6f 7b 0a 20 20 20 20 20 20 20 20 20 20 70 67 do{. pg
306e0 6e 6f 4f 76 66 6c 2b 2b 3b 0a 20 20 20 20 20 20 noOvfl++;.
306f0 20 20 7d 20 77 68 69 6c 65 28 20 0a 20 20 20 20 } while( .
30700 20 20 20 20 20 20 50 54 52 4d 41 50 5f 49 53 50 PTRMAP_ISP
30710 41 47 45 28 70 42 74 2c 20 70 67 6e 6f 4f 76 66 AGE(pBt, pgnoOvf
30720 6c 29 20 7c 7c 20 70 67 6e 6f 4f 76 66 6c 3d 3d l) || pgnoOvfl==
30730 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
30740 45 28 70 42 74 29 20 0a 20 20 20 20 20 20 20 20 E(pBt) .
30750 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 );. }.#endi
30760 66 0a 20 20 20 20 20 20 72 63 20 3d 20 61 6c 6c f. rc = all
30770 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 28 70 ocateBtreePage(p
30780 42 74 2c 20 26 70 4f 76 66 6c 2c 20 26 70 67 6e Bt, &pOvfl, &pgn
30790 6f 4f 76 66 6c 2c 20 70 67 6e 6f 4f 76 66 6c 2c oOvfl, pgnoOvfl,
307a0 20 30 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 0);.#ifndef SQL
307b0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
307c0 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 UUM. /* If
307d0 74 68 65 20 64 61 74 61 62 61 73 65 20 73 75 70 the database sup
307e0 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 75 75 ports auto-vacuu
307f0 6d 2c 20 61 6e 64 20 74 68 65 20 73 65 63 6f 6e m, and the secon
30800 64 20 6f 72 20 73 75 62 73 65 71 75 65 6e 74 0a d or subsequent.
30810 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f ** overflo
30820 77 20 70 61 67 65 20 69 73 20 62 65 69 6e 67 20 w page is being
30830 61 6c 6c 6f 63 61 74 65 64 2c 20 61 64 64 20 61 allocated, add a
30840 6e 20 65 6e 74 72 79 20 74 6f 20 74 68 65 20 70 n entry to the p
30850 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 20 ointer-map.
30860 20 2a 2a 20 66 6f 72 20 74 68 61 74 20 70 61 67 ** for that pag
30870 65 20 6e 6f 77 2e 20 0a 20 20 20 20 20 20 2a 2a e now. . **
30880 0a 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 69 . ** If thi
30890 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 6f s is the first o
308a0 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 74 68 verflow page, th
308b0 65 6e 20 77 72 69 74 65 20 61 20 70 61 72 74 69 en write a parti
308c0 61 6c 20 65 6e 74 72 79 20 0a 20 20 20 20 20 20 al entry .
308d0 2a 2a 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 ** to the pointe
308e0 72 2d 6d 61 70 2e 20 49 66 20 77 65 20 77 72 69 r-map. If we wri
308f0 74 65 20 6e 6f 74 68 69 6e 67 20 74 6f 20 74 68 te nothing to th
30900 69 73 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 73 is pointer-map s
30910 6c 6f 74 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68 lot,. ** th
30920 65 6e 20 74 68 65 20 6f 70 74 69 6d 69 73 74 69 en the optimisti
30930 63 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e c overflow chain
30940 20 70 72 6f 63 65 73 73 69 6e 67 20 69 6e 20 63 processing in c
30950 6c 65 61 72 43 65 6c 6c 28 29 0a 20 20 20 20 20 learCell().
30960 20 2a 2a 20 6d 61 79 20 6d 69 73 69 6e 74 65 72 ** may misinter
30970 70 72 65 74 20 74 68 65 20 75 6e 69 6e 69 74 69 pret the uniniti
30980 61 6c 69 7a 65 64 20 76 61 6c 75 65 73 20 61 6e alized values an
30990 64 20 64 65 6c 65 74 65 20 74 68 65 0a 20 20 20 d delete the.
309a0 20 20 20 2a 2a 20 77 72 6f 6e 67 20 70 61 67 65 ** wrong page
309b0 73 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 s from the datab
309c0 61 73 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ase.. */.
309d0 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 if( pBt->aut
309e0 6f 56 61 63 75 75 6d 20 26 26 20 72 63 3d 3d 53 oVacuum && rc==S
309f0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
30a00 20 20 20 20 75 38 20 65 54 79 70 65 20 3d 20 28 u8 eType = (
30a10 70 67 6e 6f 50 74 72 6d 61 70 3f 50 54 52 4d 41 pgnoPtrmap?PTRMA
30a20 50 5f 4f 56 45 52 46 4c 4f 57 32 3a 50 54 52 4d P_OVERFLOW2:PTRM
30a30 41 50 5f 4f 56 45 52 46 4c 4f 57 31 29 3b 0a 20 AP_OVERFLOW1);.
30a40 20 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 ptrmapPut
30a50 28 70 42 74 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 (pBt, pgnoOvfl,
30a60 65 54 79 70 65 2c 20 70 67 6e 6f 50 74 72 6d 61 eType, pgnoPtrma
30a70 70 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 20 p, &rc);.
30a80 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 if( rc ){.
30a90 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
30aa0 28 70 4f 76 66 6c 29 3b 0a 20 20 20 20 20 20 20 (pOvfl);.
30ab0 20 7d 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 }. }.#endi
30ac0 66 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 f. if( rc )
30ad0 7b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 {. releas
30ae0 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 ePage(pToRelease
30af0 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 );. retur
30b00 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 n rc;. }..
30b10 20 20 20 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 /* If pToRe
30b20 6c 65 61 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 lease is not zer
30b30 6f 20 74 68 61 6e 20 70 50 72 69 6f 72 20 70 6f o than pPrior po
30b40 69 6e 74 73 20 69 6e 74 6f 20 74 68 65 20 64 61 ints into the da
30b50 74 61 20 61 72 65 61 0a 20 20 20 20 20 20 2a 2a ta area. **
30b60 20 6f 66 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 of pToRelease.
30b70 20 4d 61 6b 65 20 73 75 72 65 20 70 54 6f 52 65 Make sure pToRe
30b80 6c 65 61 73 65 20 69 73 20 73 74 69 6c 6c 20 77 lease is still w
30b90 72 69 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 riteable. */.
30ba0 20 20 20 61 73 73 65 72 74 28 20 70 54 6f 52 65 assert( pToRe
30bb0 6c 65 61 73 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 lease==0 || sqli
30bc0 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
30bd0 62 6c 65 28 70 54 6f 52 65 6c 65 61 73 65 2d 3e ble(pToRelease->
30be0 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 pDbPage) );..
30bf0 20 20 20 2f 2a 20 49 66 20 70 50 72 69 6f 72 20 /* If pPrior
30c00 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 is part of the d
30c10 61 74 61 20 61 72 65 61 20 6f 66 20 70 50 61 67 ata area of pPag
30c20 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 e, then make sur
30c30 65 20 70 50 61 67 65 0a 20 20 20 20 20 20 2a 2a e pPage. **
30c40 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 is still writea
30c50 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 ble */. ass
30c60 65 72 74 28 20 70 50 72 69 6f 72 3c 70 50 61 67 ert( pPrior<pPag
30c70 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 50 72 69 e->aData || pPri
30c80 6f 72 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 or>=&pPage->aDat
30c90 61 5b 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d a[pBt->pageSize]
30ca0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 . ||
30cb0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
30cc0 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
30cd0 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 DbPage) );..
30ce0 20 20 70 75 74 34 62 79 74 65 28 70 50 72 69 6f put4byte(pPrio
30cf0 72 2c 20 70 67 6e 6f 4f 76 66 6c 29 3b 0a 20 20 r, pgnoOvfl);.
30d00 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
30d10 70 54 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 20 pToRelease);.
30d20 20 20 20 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 pToRelease =
30d30 70 4f 76 66 6c 3b 0a 20 20 20 20 20 20 70 50 72 pOvfl;. pPr
30d40 69 6f 72 20 3d 20 70 4f 76 66 6c 2d 3e 61 44 61 ior = pOvfl->aDa
30d50 74 61 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 ta;. put4by
30d60 74 65 28 70 50 72 69 6f 72 2c 20 30 29 3b 0a 20 te(pPrior, 0);.
30d70 20 20 20 20 20 70 50 61 79 6c 6f 61 64 20 3d 20 pPayload =
30d80 26 70 4f 76 66 6c 2d 3e 61 44 61 74 61 5b 34 5d &pOvfl->aData[4]
30d90 3b 0a 20 20 20 20 20 20 73 70 61 63 65 4c 65 66 ;. spaceLef
30da0 74 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 t = pBt->usableS
30db0 69 7a 65 20 2d 20 34 3b 0a 20 20 20 20 7d 0a 20 ize - 4;. }.
30dc0 20 20 20 6e 20 3d 20 6e 50 61 79 6c 6f 61 64 3b n = nPayload;
30dd0 0a 20 20 20 20 69 66 28 20 6e 3e 73 70 61 63 65 . if( n>space
30de0 4c 65 66 74 20 29 20 6e 20 3d 20 73 70 61 63 65 Left ) n = space
30df0 4c 65 66 74 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 Left;.. /* If
30e00 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 6e pToRelease is n
30e10 6f 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 61 ot zero than pPa
30e20 79 6c 6f 61 64 20 70 6f 69 6e 74 73 20 69 6e 74 yload points int
30e30 6f 20 74 68 65 20 64 61 74 61 20 61 72 65 61 0a o the data area.
30e40 20 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 6c ** of pToRel
30e50 65 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 ease. Make sure
30e60 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 73 pToRelease is s
30e70 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e 20 till writeable.
30e80 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
30e90 54 6f 52 65 6c 65 61 73 65 3d 3d 30 20 7c 7c 20 ToRelease==0 ||
30ea0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
30eb0 69 74 65 61 62 6c 65 28 70 54 6f 52 65 6c 65 61 iteable(pToRelea
30ec0 73 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a se->pDbPage) );.
30ed0 0a 20 20 20 20 2f 2a 20 49 66 20 70 50 61 79 6c . /* If pPayl
30ee0 6f 61 64 20 69 73 20 70 61 72 74 20 6f 66 20 74 oad is part of t
30ef0 68 65 20 64 61 74 61 20 61 72 65 61 20 6f 66 20 he data area of
30f00 70 50 61 67 65 2c 20 74 68 65 6e 20 6d 61 6b 65 pPage, then make
30f10 20 73 75 72 65 20 70 50 61 67 65 0a 20 20 20 20 sure pPage.
30f20 2a 2a 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 ** is still writ
30f30 65 61 62 6c 65 20 2a 2f 0a 20 20 20 20 61 73 73 eable */. ass
30f40 65 72 74 28 20 70 50 61 79 6c 6f 61 64 3c 70 50 ert( pPayload<pP
30f50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 50 age->aData || pP
30f60 61 79 6c 6f 61 64 3e 3d 26 70 50 61 67 65 2d 3e ayload>=&pPage->
30f70 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 53 aData[pBt->pageS
30f80 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 20 ize].
30f90 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 || sqlite3Pager
30fa0 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
30fb0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a e->pDbPage) );..
30fc0 20 20 20 20 69 66 28 20 6e 53 72 63 3e 30 20 29 if( nSrc>0 )
30fd0 7b 0a 20 20 20 20 20 20 69 66 28 20 6e 3e 6e 53 {. if( n>nS
30fe0 72 63 20 29 20 6e 20 3d 20 6e 53 72 63 3b 0a 20 rc ) n = nSrc;.
30ff0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 53 72 assert( pSr
31000 63 20 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 c );. memcp
31010 79 28 70 50 61 79 6c 6f 61 64 2c 20 70 53 72 63 y(pPayload, pSrc
31020 2c 20 6e 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b , n);. }else{
31030 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 50 . memset(pP
31040 61 79 6c 6f 61 64 2c 20 30 2c 20 6e 29 3b 0a 20 ayload, 0, n);.
31050 20 20 20 7d 0a 20 20 20 20 6e 50 61 79 6c 6f 61 }. nPayloa
31060 64 20 2d 3d 20 6e 3b 0a 20 20 20 20 70 50 61 79 d -= n;. pPay
31070 6c 6f 61 64 20 2b 3d 20 6e 3b 0a 20 20 20 20 70 load += n;. p
31080 53 72 63 20 2b 3d 20 6e 3b 0a 20 20 20 20 6e 53 Src += n;. nS
31090 72 63 20 2d 3d 20 6e 3b 0a 20 20 20 20 73 70 61 rc -= n;. spa
310a0 63 65 4c 65 66 74 20 2d 3d 20 6e 3b 0a 20 20 20 ceLeft -= n;.
310b0 20 69 66 28 20 6e 53 72 63 3d 3d 30 20 29 7b 0a if( nSrc==0 ){.
310c0 20 20 20 20 20 20 6e 53 72 63 20 3d 20 6e 44 61 nSrc = nDa
310d0 74 61 3b 0a 20 20 20 20 20 20 70 53 72 63 20 3d ta;. pSrc =
310e0 20 70 44 61 74 61 3b 0a 20 20 20 20 7d 0a 20 20 pData;. }.
310f0 7d 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 }. releasePage(
31100 70 54 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 72 pToRelease);. r
31110 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
31120 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 .}../*.** Remove
31130 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 66 the i-th cell f
31140 72 6f 6d 20 70 50 61 67 65 2e 20 20 54 68 69 73 rom pPage. This
31150 20 72 6f 75 74 69 6e 65 20 65 66 66 65 63 74 73 routine effects
31160 20 70 50 61 67 65 20 6f 6e 6c 79 2e 0a 2a 2a 20 pPage only..**
31170 54 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 The cell content
31180 20 69 73 20 6e 6f 74 20 66 72 65 65 64 20 6f 72 is not freed or
31190 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e 20 20 49 deallocated. I
311a0 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 t is assumed tha
311b0 74 0a 2a 2a 20 74 68 65 20 63 65 6c 6c 20 63 6f t.** the cell co
311c0 6e 74 65 6e 74 20 68 61 73 20 62 65 65 6e 20 63 ntent has been c
311d0 6f 70 69 65 64 20 73 6f 6d 65 70 6c 61 63 65 20 opied someplace
311e0 65 6c 73 65 2e 20 20 54 68 69 73 20 72 6f 75 74 else. This rout
311f0 69 6e 65 20 6a 75 73 74 0a 2a 2a 20 72 65 6d 6f ine just.** remo
31200 76 65 73 20 74 68 65 20 72 65 66 65 72 65 6e 63 ves the referenc
31210 65 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 66 72 e to the cell fr
31220 6f 6d 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 om pPage..**.**
31230 22 73 7a 22 20 6d 75 73 74 20 62 65 20 74 68 65 "sz" must be the
31240 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
31250 20 69 6e 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2f in the cell..*/
31260 0a 73 74 61 74 69 63 20 76 6f 69 64 20 64 72 6f .static void dro
31270 70 43 65 6c 6c 28 4d 65 6d 50 61 67 65 20 2a 70 pCell(MemPage *p
31280 50 61 67 65 2c 20 69 6e 74 20 69 64 78 2c 20 69 Page, int idx, i
31290 6e 74 20 73 7a 2c 20 69 6e 74 20 2a 70 52 43 29 nt sz, int *pRC)
312a0 7b 0a 20 20 75 33 32 20 70 63 3b 20 20 20 20 20 {. u32 pc;
312b0 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f /* Offset to
312c0 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 6f 66 cell content of
312d0 20 63 65 6c 6c 20 62 65 69 6e 67 20 64 65 6c 65 cell being dele
312e0 74 65 64 20 2a 2f 0a 20 20 75 38 20 2a 64 61 74 ted */. u8 *dat
312f0 61 3b 20 20 20 20 20 20 20 2f 2a 20 70 50 61 67 a; /* pPag
31300 65 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 75 38 e->aData */. u8
31310 20 2a 70 74 72 3b 20 20 20 20 20 20 20 20 2f 2a *ptr; /*
31320 20 55 73 65 64 20 74 6f 20 6d 6f 76 65 20 62 79 Used to move by
31330 74 65 73 20 61 72 6f 75 6e 64 20 77 69 74 68 69 tes around withi
31340 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e n data[] */. in
31350 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 2f 2a t rc; /*
31360 20 54 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 The return code
31370 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 */. int hdr;
31380 20 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 6e 69 /* Beginni
31390 6e 67 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 ng of the header
313a0 2e 20 20 30 20 6d 6f 73 74 20 70 61 67 65 73 2e . 0 most pages.
313b0 20 20 31 30 30 20 70 61 67 65 20 31 20 2a 2f 0a 100 page 1 */.
313c0 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 . if( *pRC ) re
313d0 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 turn;.. assert(
313e0 20 69 64 78 3e 3d 30 20 26 26 20 69 64 78 3c 70 idx>=0 && idx<p
313f0 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 Page->nCell );.
31400 20 61 73 73 65 72 74 28 20 73 7a 3d 3d 63 65 6c assert( sz==cel
31410 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 69 64 78 lSize(pPage, idx
31420 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
31430 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
31440 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 teable(pPage->pD
31450 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 65 bPage) );. asse
31460 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
31470 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
31480 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 64 t->mutex) );. d
31490 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 ata = pPage->aDa
314a0 74 61 3b 0a 20 20 70 74 72 20 3d 20 26 70 50 61 ta;. ptr = &pPa
314b0 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 69 ge->aCellIdx[2*i
314c0 64 78 5d 3b 0a 20 20 70 63 20 3d 20 67 65 74 32 dx];. pc = get2
314d0 62 79 74 65 28 70 74 72 29 3b 0a 20 20 68 64 72 byte(ptr);. hdr
314e0 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 = pPage->hdrOff
314f0 73 65 74 3b 0a 20 20 74 65 73 74 63 61 73 65 28 set;. testcase(
31500 20 70 63 3d 3d 67 65 74 32 62 79 74 65 28 26 64 pc==get2byte(&d
31510 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 3b 0a 20 ata[hdr+5]) );.
31520 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 7a testcase( pc+sz
31530 3d 3d 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 ==pPage->pBt->us
31540 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 69 66 ableSize );. if
31550 28 20 70 63 20 3c 20 28 75 33 32 29 67 65 74 32 ( pc < (u32)get2
31560 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
31570 5d 29 20 7c 7c 20 70 63 2b 73 7a 20 3e 20 70 50 ]) || pc+sz > pP
31580 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
31590 53 69 7a 65 20 29 7b 0a 20 20 20 20 2a 70 52 43 Size ){. *pRC
315a0 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
315b0 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 T_BKPT;. retu
315c0 72 6e 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 66 rn;. }. rc = f
315d0 72 65 65 53 70 61 63 65 28 70 50 61 67 65 2c 20 reeSpace(pPage,
315e0 70 63 2c 20 73 7a 29 3b 0a 20 20 69 66 28 20 72 pc, sz);. if( r
315f0 63 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 c ){. *pRC =
31600 72 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a rc;. return;.
31610 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6e 43 65 }. pPage->nCe
31620 6c 6c 2d 2d 3b 0a 20 20 6d 65 6d 6d 6f 76 65 28 ll--;. memmove(
31630 70 74 72 2c 20 70 74 72 2b 32 2c 20 32 2a 28 70 ptr, ptr+2, 2*(p
31640 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 64 Page->nCell - id
31650 78 29 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 x));. put2byte(
31660 26 64 61 74 61 5b 68 64 72 2b 33 5d 2c 20 70 50 &data[hdr+3], pP
31670 61 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 70 age->nCell);. p
31680 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 32 Page->nFree += 2
31690 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 73 65 72 ;.}../*.** Inser
316a0 74 20 61 20 6e 65 77 20 63 65 6c 6c 20 6f 6e 20 t a new cell on
316b0 70 50 61 67 65 20 61 74 20 63 65 6c 6c 20 69 6e pPage at cell in
316c0 64 65 78 20 22 69 22 2e 20 20 70 43 65 6c 6c 20 dex "i". pCell
316d0 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a 2a points to the.**
316e0 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 content of the
316f0 63 65 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 cell..**.** If t
31700 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
31710 77 69 6c 6c 20 66 69 74 20 6f 6e 20 74 68 65 20 will fit on the
31720 70 61 67 65 2c 20 74 68 65 6e 20 70 75 74 20 69 page, then put i
31730 74 20 74 68 65 72 65 2e 20 20 49 66 20 69 74 0a t there. If it.
31740 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 66 69 74 2c ** will not fit,
31750 20 74 68 65 6e 20 6d 61 6b 65 20 61 20 63 6f 70 then make a cop
31760 79 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f y of the cell co
31770 6e 74 65 6e 74 20 69 6e 74 6f 20 70 54 65 6d 70 ntent into pTemp
31780 20 69 66 0a 2a 2a 20 70 54 65 6d 70 20 69 73 20 if.** pTemp is
31790 6e 6f 74 20 6e 75 6c 6c 2e 20 20 52 65 67 61 72 not null. Regar
317a0 64 6c 65 73 73 20 6f 66 20 70 54 65 6d 70 2c 20 dless of pTemp,
317b0 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 65 allocate a new e
317c0 6e 74 72 79 0a 2a 2a 20 69 6e 20 70 50 61 67 65 ntry.** in pPage
317d0 2d 3e 61 70 4f 76 66 6c 5b 5d 20 61 6e 64 20 6d ->apOvfl[] and m
317e0 61 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 6f 20 ake it point to
317f0 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
31800 20 28 65 69 74 68 65 72 0a 2a 2a 20 69 6e 20 70 (either.** in p
31810 54 65 6d 70 20 6f 72 20 74 68 65 20 6f 72 69 67 Temp or the orig
31820 69 6e 61 6c 20 70 43 65 6c 6c 29 20 61 6e 64 20 inal pCell) and
31830 61 6c 73 6f 20 72 65 63 6f 72 64 20 69 74 73 20 also record its
31840 69 6e 64 65 78 2e 20 0a 2a 2a 20 41 6c 6c 6f 63 index. .** Alloc
31850 61 74 69 6e 67 20 61 20 6e 65 77 20 65 6e 74 72 ating a new entr
31860 79 20 69 6e 20 70 50 61 67 65 2d 3e 61 43 65 6c y in pPage->aCel
31870 6c 5b 5d 20 69 6d 70 6c 69 65 73 20 74 68 61 74 l[] implies that
31880 20 0a 2a 2a 20 70 50 61 67 65 2d 3e 6e 4f 76 65 .** pPage->nOve
31890 72 66 6c 6f 77 20 69 73 20 69 6e 63 72 65 6d 65 rflow is increme
318a0 6e 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 nted..*/.static
318b0 76 6f 69 64 20 69 6e 73 65 72 74 43 65 6c 6c 28 void insertCell(
318c0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
318d0 65 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 6e 74 e, /* Page int
318e0 6f 20 77 68 69 63 68 20 77 65 20 61 72 65 20 63 o which we are c
318f0 6f 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 opying */. int
31900 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a i, /*
31910 20 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f 6d 65 New cell become
31920 73 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 s the i-th cell
31930 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 of the page */.
31940 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 u8 *pCell,
31950 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 6f 66 /* Content of
31960 20 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 2a 2f the new cell */
31970 0a 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 20 20 . int sz,
31980 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 /* Bytes of
31990 20 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 65 6c content in pCel
319a0 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 6d 70 l */. u8 *pTemp
319b0 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 , /* Temp
319c0 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 66 storage space f
319d0 6f 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e 65 65 or pCell, if nee
319e0 64 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 43 ded */. Pgno iC
319f0 68 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 49 66 hild, /* If
31a00 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 6c 61 non-zero, repla
31a10 63 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 ce first 4 bytes
31a20 20 77 69 74 68 20 74 68 69 73 20 76 61 6c 75 65 with this value
31a30 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 20 20 */. int *pRC
31a40 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 /* Read
31a50 61 6e 64 20 77 72 69 74 65 20 72 65 74 75 72 6e and write return
31a60 20 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 65 20 code from here
31a70 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 78 20 */.){. int idx
31a80 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 68 65 = 0; /* Whe
31a90 72 65 20 74 6f 20 77 72 69 74 65 20 6e 65 77 20 re to write new
31aa0 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 20 cell content in
31ab0 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 data[] */. int
31ac0 6a 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a j; /*
31ad0 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f Loop counter */
31ae0 0a 20 20 69 6e 74 20 65 6e 64 3b 20 20 20 20 20 . int end;
31af0 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 /* First by
31b00 74 65 20 70 61 73 74 20 74 68 65 20 6c 61 73 74 te past the last
31b10 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 6e cell pointer in
31b20 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 data[] */. int
31b30 20 69 6e 73 3b 20 20 20 20 20 20 20 20 20 20 2f ins; /
31b40 2a 20 49 6e 64 65 78 20 69 6e 20 64 61 74 61 5b * Index in data[
31b50 5d 20 77 68 65 72 65 20 6e 65 77 20 63 65 6c 6c ] where new cell
31b60 20 70 6f 69 6e 74 65 72 20 69 73 20 69 6e 73 65 pointer is inse
31b70 72 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 63 65 rted */. int ce
31b80 6c 6c 4f 66 66 73 65 74 3b 20 20 20 2f 2a 20 41 llOffset; /* A
31b90 64 64 72 65 73 73 20 6f 66 20 66 69 72 73 74 20 ddress of first
31ba0 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 6e 20 cell pointer in
31bb0 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a data[] */. u8 *
31bc0 64 61 74 61 3b 20 20 20 20 20 20 20 20 20 2f 2a data; /*
31bd0 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 The content of
31be0 74 68 65 20 77 68 6f 6c 65 20 70 61 67 65 20 2a the whole page *
31bf0 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 /.. if( *pRC )
31c00 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 return;.. asser
31c10 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 t( i>=0 && i<=pP
31c20 61 67 65 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 age->nCell+pPage
31c30 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 ->nOverflow );.
31c40 20 61 73 73 65 72 74 28 20 4d 58 5f 43 45 4c 4c assert( MX_CELL
31c50 28 70 50 61 67 65 2d 3e 70 42 74 29 3c 3d 31 30 (pPage->pBt)<=10
31c60 39 32 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 921 );. assert(
31c70 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d pPage->nCell<=M
31c80 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 X_CELL(pPage->pB
31c90 74 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 t) || CORRUPT_DB
31ca0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
31cb0 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3c 3d age->nOverflow<=
31cc0 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d ArraySize(pPage-
31cd0 3e 61 70 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 >apOvfl) );. as
31ce0 73 65 72 74 28 20 41 72 72 61 79 53 69 7a 65 28 sert( ArraySize(
31cf0 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 3d 3d pPage->apOvfl)==
31d00 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d ArraySize(pPage-
31d10 3e 61 69 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 >aiOvfl) );. as
31d20 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
31d30 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
31d40 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
31d50 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 73 68 6f /* The cell sho
31d60 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 uld normally be
31d70 73 69 7a 65 64 20 63 6f 72 72 65 63 74 6c 79 2e sized correctly.
31d80 20 20 48 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 However, when
31d90 6d 6f 76 69 6e 67 20 61 0a 20 20 2a 2a 20 6d 61 moving a. ** ma
31da0 6c 66 6f 72 6d 65 64 20 63 65 6c 6c 20 66 72 6f lformed cell fro
31db0 6d 20 61 20 6c 65 61 66 20 70 61 67 65 20 74 6f m a leaf page to
31dc0 20 61 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 an interior pag
31dd0 65 2c 20 69 66 20 74 68 65 20 63 65 6c 6c 20 73 e, if the cell s
31de0 69 7a 65 0a 20 20 2a 2a 20 77 61 6e 74 65 64 20 ize. ** wanted
31df0 74 6f 20 62 65 20 6c 65 73 73 20 74 68 61 6e 20 to be less than
31e00 34 20 62 75 74 20 67 6f 74 20 72 6f 75 6e 64 65 4 but got rounde
31e10 64 20 75 70 20 74 6f 20 34 20 6f 6e 20 74 68 65 d up to 4 on the
31e20 20 6c 65 61 66 2c 20 74 68 65 6e 20 73 69 7a 65 leaf, then size
31e30 0a 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 6c . ** might be l
31e40 65 73 73 20 74 68 61 6e 20 38 20 28 6c 65 61 66 ess than 8 (leaf
31e50 2d 73 69 7a 65 20 2b 20 70 6f 69 6e 74 65 72 29 -size + pointer)
31e60 20 6f 6e 20 74 68 65 20 69 6e 74 65 72 69 6f 72 on the interior
31e70 20 6e 6f 64 65 2e 20 20 48 65 6e 63 65 0a 20 20 node. Hence.
31e80 2a 2a 20 74 68 65 20 74 65 72 6d 20 61 66 74 65 ** the term afte
31e90 72 20 74 68 65 20 7c 7c 20 69 6e 20 74 68 65 20 r the || in the
31ea0 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 following assert
31eb0 28 29 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 (). */. assert(
31ec0 20 73 7a 3d 3d 63 65 6c 6c 53 69 7a 65 50 74 72 sz==cellSizePtr
31ed0 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 29 20 7c (pPage, pCell) |
31ee0 7c 20 28 73 7a 3d 3d 38 20 26 26 20 69 43 68 69 | (sz==8 && iChi
31ef0 6c 64 3e 30 29 20 29 3b 0a 20 20 69 66 28 20 70 ld>0) );. if( p
31f00 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 Page->nOverflow
31f10 7c 7c 20 73 7a 2b 32 3e 70 50 61 67 65 2d 3e 6e || sz+2>pPage->n
31f20 46 72 65 65 20 29 7b 0a 20 20 20 20 69 66 28 20 Free ){. if(
31f30 70 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 6d pTemp ){. m
31f40 65 6d 63 70 79 28 70 54 65 6d 70 2c 20 70 43 65 emcpy(pTemp, pCe
31f50 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 70 ll, sz);. p
31f60 43 65 6c 6c 20 3d 20 70 54 65 6d 70 3b 0a 20 20 Cell = pTemp;.
31f70 20 20 7d 0a 20 20 20 20 69 66 28 20 69 43 68 69 }. if( iChi
31f80 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 75 74 34 ld ){. put4
31f90 62 79 74 65 28 70 43 65 6c 6c 2c 20 69 43 68 69 byte(pCell, iChi
31fa0 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6a ld);. }. j
31fb0 20 3d 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 = pPage->nOverf
31fc0 6c 6f 77 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 low++;. asser
31fd0 74 28 20 6a 3c 28 69 6e 74 29 28 73 69 7a 65 6f t( j<(int)(sizeo
31fe0 66 28 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 f(pPage->apOvfl)
31ff0 2f 73 69 7a 65 6f 66 28 70 50 61 67 65 2d 3e 61 /sizeof(pPage->a
32000 70 4f 76 66 6c 5b 30 5d 29 29 20 29 3b 0a 20 20 pOvfl[0])) );.
32010 20 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b pPage->apOvfl[
32020 6a 5d 20 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 20 j] = pCell;.
32030 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 5d pPage->aiOvfl[j]
32040 20 3d 20 28 75 31 36 29 69 3b 0a 20 20 7d 65 6c = (u16)i;. }el
32050 73 65 7b 0a 20 20 20 20 69 6e 74 20 72 63 20 3d se{. int rc =
32060 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
32070 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 te(pPage->pDbPag
32080 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
32090 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
320a0 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 *pRC = rc;.
320b0 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 return;.
320c0 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 }. assert( sq
320d0 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
320e0 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
320f0 50 61 67 65 29 20 29 3b 0a 20 20 20 20 64 61 74 Page) );. dat
32100 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 a = pPage->aData
32110 3b 0a 20 20 20 20 63 65 6c 6c 4f 66 66 73 65 74 ;. cellOffset
32120 20 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 = pPage->cellOf
32130 66 73 65 74 3b 0a 20 20 20 20 65 6e 64 20 3d 20 fset;. end =
32140 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 cellOffset + 2*p
32150 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 Page->nCell;.
32160 20 69 6e 73 20 3d 20 63 65 6c 6c 4f 66 66 73 65 ins = cellOffse
32170 74 20 2b 20 32 2a 69 3b 0a 20 20 20 20 72 63 20 t + 2*i;. rc
32180 3d 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 = allocateSpace(
32190 70 50 61 67 65 2c 20 73 7a 2c 20 26 69 64 78 29 pPage, sz, &idx)
321a0 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 20 ;. if( rc ){
321b0 2a 70 52 43 20 3d 20 72 63 3b 20 72 65 74 75 72 *pRC = rc; retur
321c0 6e 3b 20 7d 0a 20 20 20 20 2f 2a 20 54 68 65 20 n; }. /* The
321d0 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 29 20 allocateSpace()
321e0 72 6f 75 74 69 6e 65 20 67 75 61 72 61 6e 74 65 routine guarante
321f0 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 es the following
32200 20 74 77 6f 20 70 72 6f 70 65 72 74 69 65 73 0a two properties.
32210 20 20 20 20 2a 2a 20 69 66 20 69 74 20 72 65 74 ** if it ret
32220 75 72 6e 73 20 73 75 63 63 65 73 73 20 2a 2f 0a urns success */.
32230 20 20 20 20 61 73 73 65 72 74 28 20 69 64 78 20 assert( idx
32240 3e 3d 20 65 6e 64 2b 32 20 29 3b 0a 20 20 20 20 >= end+2 );.
32250 61 73 73 65 72 74 28 20 69 64 78 2b 73 7a 20 3c assert( idx+sz <
32260 3d 20 28 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 = (int)pPage->pB
32270 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b t->usableSize );
32280 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c . pPage->nCel
32290 6c 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e l++;. pPage->
322a0 6e 46 72 65 65 20 2d 3d 20 28 75 31 36 29 28 32 nFree -= (u16)(2
322b0 20 2b 20 73 7a 29 3b 0a 20 20 20 20 6d 65 6d 63 + sz);. memc
322c0 70 79 28 26 64 61 74 61 5b 69 64 78 5d 2c 20 70 py(&data[idx], p
322d0 43 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 20 69 Cell, sz);. i
322e0 66 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 f( iChild ){.
322f0 20 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 put4byte(&dat
32300 61 5b 69 64 78 5d 2c 20 69 43 68 69 6c 64 29 3b a[idx], iChild);
32310 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 6d 6f . }. memmo
32320 76 65 28 26 64 61 74 61 5b 69 6e 73 2b 32 5d 2c ve(&data[ins+2],
32330 20 26 64 61 74 61 5b 69 6e 73 5d 2c 20 65 6e 64 &data[ins], end
32340 2d 69 6e 73 29 3b 0a 20 20 20 20 70 75 74 32 62 -ins);. put2b
32350 79 74 65 28 26 64 61 74 61 5b 69 6e 73 5d 2c 20 yte(&data[ins],
32360 69 64 78 29 3b 0a 20 20 20 20 70 75 74 32 62 79 idx);. put2by
32370 74 65 28 26 64 61 74 61 5b 70 50 61 67 65 2d 3e te(&data[pPage->
32380 68 64 72 4f 66 66 73 65 74 2b 33 5d 2c 20 70 50 hdrOffset+3], pP
32390 61 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 23 69 66 age->nCell);.#if
323a0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
323b0 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
323c0 69 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e if( pPage->pBt->
323d0 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 autoVacuum ){.
323e0 20 20 20 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 /* The cell
323f0 6d 61 79 20 63 6f 6e 74 61 69 6e 20 61 20 70 6f may contain a po
32400 69 6e 74 65 72 20 74 6f 20 61 6e 20 6f 76 65 72 inter to an over
32410 66 6c 6f 77 20 70 61 67 65 2e 20 49 66 20 73 6f flow page. If so
32420 2c 20 77 72 69 74 65 0a 20 20 20 20 20 20 2a 2a , write. **
32430 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 74 the entry for t
32440 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
32450 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 into the pointe
32460 72 20 6d 61 70 2e 0a 20 20 20 20 20 20 2a 2f 0a r map.. */.
32470 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 4f ptrmapPutO
32480 76 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 vflPtr(pPage, pC
32490 65 6c 6c 2c 20 70 52 43 29 3b 0a 20 20 20 20 7d ell, pRC);. }
324a0 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f .#endif. }.}../
324b0 2a 0a 2a 2a 20 41 72 72 61 79 20 61 70 43 65 6c *.** Array apCel
324c0 6c 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 l[] contains poi
324d0 6e 74 65 72 73 20 74 6f 20 6e 43 65 6c 6c 20 62 nters to nCell b
324e0 2d 74 72 65 65 20 70 61 67 65 20 63 65 6c 6c 73 -tree page cells
324f0 2e 20 54 68 65 20 0a 2a 2a 20 73 7a 43 65 6c 6c . The .** szCell
32500 5b 5d 20 61 72 72 61 79 20 63 6f 6e 74 61 69 6e [] array contain
32510 73 20 74 68 65 20 73 69 7a 65 20 69 6e 20 62 79 s the size in by
32520 74 65 73 20 6f 66 20 65 61 63 68 20 63 65 6c 6c tes of each cell
32530 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a . This function.
32540 2a 2a 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 ** replaces the
32550 63 75 72 72 65 6e 74 20 63 6f 6e 74 65 6e 74 73 current contents
32560 20 6f 66 20 70 61 67 65 20 70 50 67 20 77 69 74 of page pPg wit
32570 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f h the contents o
32580 66 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 61 72 f the cell.** ar
32590 72 61 79 2e 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 ray..**.** Some
325a0 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 69 6e 20 of the cells in
325b0 61 70 43 65 6c 6c 5b 5d 20 6d 61 79 20 63 75 72 apCell[] may cur
325c0 72 65 6e 74 6c 79 20 62 65 20 73 74 6f 72 65 64 rently be stored
325d0 20 69 6e 20 70 50 67 2e 20 54 68 69 73 0a 2a 2a in pPg. This.**
325e0 20 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 function works
325f0 61 72 6f 75 6e 64 20 70 72 6f 62 6c 65 6d 73 20 around problems
32600 63 61 75 73 65 64 20 62 79 20 74 68 69 73 20 62 caused by this b
32610 79 20 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 20 y making a copy
32620 6f 66 20 61 6e 79 20 0a 2a 2a 20 73 75 63 68 20 of any .** such
32630 63 65 6c 6c 73 20 62 65 66 6f 72 65 20 6f 76 65 cells before ove
32640 72 77 72 69 74 69 6e 67 20 74 68 65 20 70 61 67 rwriting the pag
32650 65 20 64 61 74 61 2e 0a 2a 2a 0a 2a 2a 20 54 68 e data..**.** Th
32660 65 20 4d 65 6d 50 61 67 65 2e 6e 46 72 65 65 20 e MemPage.nFree
32670 66 69 65 6c 64 20 69 73 20 69 6e 76 61 6c 69 64 field is invalid
32680 61 74 65 64 20 62 79 20 74 68 69 73 20 66 75 6e ated by this fun
32690 63 74 69 6f 6e 2e 20 49 74 20 69 73 20 74 68 65 ction. It is the
326a0 20 0a 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c .** responsibil
326b0 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 ity of the calle
326c0 72 20 74 6f 20 73 65 74 20 69 74 20 63 6f 72 72 r to set it corr
326d0 65 63 74 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 ectly..*/.static
326e0 20 76 6f 69 64 20 72 65 62 75 69 6c 64 50 61 67 void rebuildPag
326f0 65 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 e(. MemPage *pP
32700 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g,
32710 20 20 20 20 20 2f 2a 20 45 64 69 74 20 74 68 69 /* Edit thi
32720 73 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 s page */. int
32730 6e 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 nCell,
32740 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
32750 69 6e 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 inal number of c
32760 65 6c 6c 73 20 6f 6e 20 70 61 67 65 20 2a 2f 0a ells on page */.
32770 20 20 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 u8 **apCell,
32780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32790 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 /* Array of ce
327a0 6c 6c 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a lls */. u16 *sz
327b0 43 65 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 Cell
327c0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 /* Arra
327d0 79 20 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 y of cell sizes
327e0 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e */.){. const in
327f0 74 20 68 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 t hdr = pPg->hdr
32800 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 Offset;
32810 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 68 65 /* Offset of he
32820 61 64 65 72 20 6f 6e 20 70 50 67 20 2a 2f 0a 20 ader on pPg */.
32830 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 u8 * const aDat
32840 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 3b 20 a = pPg->aData;
32850 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 /* Poi
32860 6e 74 65 72 20 74 6f 20 64 61 74 61 20 66 6f 72 nter to data for
32870 20 70 50 67 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 pPg */. const
32880 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 20 3d int usableSize =
32890 20 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 6c pPg->pBt->usabl
328a0 65 53 69 7a 65 3b 0a 20 20 75 38 20 2a 20 63 6f eSize;. u8 * co
328b0 6e 73 74 20 70 45 6e 64 20 3d 20 26 61 44 61 74 nst pEnd = &aDat
328c0 61 5b 75 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 a[usableSize];.
328d0 20 69 6e 74 20 69 3b 0a 20 20 75 38 20 2a 70 43 int i;. u8 *pC
328e0 65 6c 6c 70 74 72 20 3d 20 70 50 67 2d 3e 61 43 ellptr = pPg->aC
328f0 65 6c 6c 49 64 78 3b 0a 20 20 75 38 20 2a 70 54 ellIdx;. u8 *pT
32900 6d 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 mp = sqlite3Page
32910 72 54 65 6d 70 53 70 61 63 65 28 70 50 67 2d 3e rTempSpace(pPg->
32920 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 pBt->pPager);.
32930 75 38 20 2a 70 44 61 74 61 3b 0a 0a 20 20 69 20 u8 *pData;.. i
32940 3d 20 67 65 74 32 62 79 74 65 28 26 61 44 61 74 = get2byte(&aDat
32950 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 6d 65 6d a[hdr+5]);. mem
32960 63 70 79 28 26 70 54 6d 70 5b 69 5d 2c 20 26 61 cpy(&pTmp[i], &a
32970 44 61 74 61 5b 69 5d 2c 20 75 73 61 62 6c 65 53 Data[i], usableS
32980 69 7a 65 20 2d 20 69 29 3b 0a 0a 20 20 70 44 61 ize - i);.. pDa
32990 74 61 20 3d 20 70 45 6e 64 3b 0a 20 20 66 6f 72 ta = pEnd;. for
329a0 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 (i=0; i<nCell; i
329b0 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 ++){. u8 *pCe
329c0 6c 6c 20 3d 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a ll = apCell[i];.
329d0 20 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 61 44 if( pCell>aD
329e0 61 74 61 20 26 26 20 70 43 65 6c 6c 3c 70 45 6e ata && pCell<pEn
329f0 64 20 29 7b 0a 20 20 20 20 20 20 70 43 65 6c 6c d ){. pCell
32a00 20 3d 20 26 70 54 6d 70 5b 70 43 65 6c 6c 20 2d = &pTmp[pCell -
32a10 20 61 44 61 74 61 5d 3b 0a 20 20 20 20 7d 0a 20 aData];. }.
32a20 20 20 20 70 44 61 74 61 20 2d 3d 20 73 7a 43 65 pData -= szCe
32a30 6c 6c 5b 69 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 ll[i];. memcp
32a40 79 28 70 44 61 74 61 2c 20 70 43 65 6c 6c 2c 20 y(pData, pCell,
32a50 73 7a 43 65 6c 6c 5b 69 5d 29 3b 0a 20 20 20 20 szCell[i]);.
32a60 70 75 74 32 62 79 74 65 28 70 43 65 6c 6c 70 74 put2byte(pCellpt
32a70 72 2c 20 28 70 44 61 74 61 20 2d 20 61 44 61 74 r, (pData - aDat
32a80 61 29 29 3b 0a 20 20 20 20 70 43 65 6c 6c 70 74 a));. pCellpt
32a90 72 20 2b 3d 20 32 3b 0a 20 20 20 20 61 73 73 65 r += 2;. asse
32aa0 72 74 28 20 73 7a 43 65 6c 6c 5b 69 5d 3d 3d 63 rt( szCell[i]==c
32ab0 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 67 2c 20 ellSizePtr(pPg,
32ac0 70 43 65 6c 6c 29 20 29 3b 0a 20 20 7d 0a 0a 20 pCell) );. }..
32ad0 20 2f 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 72 /* The pPg->nFr
32ae0 65 65 20 66 69 65 6c 64 20 69 73 20 6e 6f 77 20 ee field is now
32af0 73 65 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 2e set incorrectly.
32b00 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c The caller will
32b10 20 66 69 78 20 69 74 2e 20 2a 2f 0a 20 20 70 50 fix it. */. pP
32b20 67 2d 3e 6e 43 65 6c 6c 20 3d 20 6e 43 65 6c 6c g->nCell = nCell
32b30 3b 0a 20 20 70 50 67 2d 3e 6e 4f 76 65 72 66 6c ;. pPg->nOverfl
32b40 6f 77 20 3d 20 30 3b 0a 0a 20 20 70 75 74 32 62 ow = 0;.. put2b
32b50 79 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b 31 yte(&aData[hdr+1
32b60 5d 2c 20 30 29 3b 0a 20 20 70 75 74 32 62 79 74 ], 0);. put2byt
32b70 65 28 26 61 44 61 74 61 5b 68 64 72 2b 33 5d 2c e(&aData[hdr+3],
32b80 20 70 50 67 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 pPg->nCell);.
32b90 70 75 74 32 62 79 74 65 28 26 61 44 61 74 61 5b put2byte(&aData[
32ba0 68 64 72 2b 35 5d 2c 20 70 44 61 74 61 20 2d 20 hdr+5], pData -
32bb0 61 44 61 74 61 29 3b 0a 20 20 61 44 61 74 61 5b aData);. aData[
32bc0 68 64 72 2b 37 5d 20 3d 20 30 78 30 30 3b 0a 7d hdr+7] = 0x00;.}
32bd0 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 20 61 70 ../*.** Array ap
32be0 43 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 Cell[] contains
32bf0 6e 43 65 6c 6c 20 70 6f 69 6e 74 65 72 73 20 74 nCell pointers t
32c00 6f 20 62 2d 74 72 65 65 20 63 65 6c 6c 73 2e 20 o b-tree cells.
32c10 41 72 72 61 79 20 73 7a 43 65 6c 6c 0a 2a 2a 20 Array szCell.**
32c20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 69 7a contains the siz
32c30 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 65 61 e in bytes of ea
32c40 63 68 20 73 75 63 68 20 63 65 6c 6c 2e 20 54 68 ch such cell. Th
32c50 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 is function atte
32c60 6d 70 74 73 20 74 6f 20 0a 2a 2a 20 61 64 64 20 mpts to .** add
32c70 74 68 65 20 63 65 6c 6c 73 20 73 74 6f 72 65 64 the cells stored
32c80 20 69 6e 20 74 68 65 20 61 72 72 61 79 20 74 6f in the array to
32c90 20 70 61 67 65 20 70 50 67 2e 20 49 66 20 69 74 page pPg. If it
32ca0 20 63 61 6e 6e 6f 74 20 28 62 65 63 61 75 73 65 cannot (because
32cb0 20 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 6e 65 .** the page ne
32cc0 65 64 73 20 74 6f 20 62 65 20 64 65 66 72 61 67 eds to be defrag
32cd0 6d 65 6e 74 65 64 20 62 65 66 6f 72 65 20 74 68 mented before th
32ce0 65 20 63 65 6c 6c 73 20 77 69 6c 6c 20 66 69 74 e cells will fit
32cf0 29 2c 20 6e 6f 6e 2d 7a 65 72 6f 0a 2a 2a 20 69 ), non-zero.** i
32d00 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 s returned. Othe
32d10 72 77 69 73 65 2c 20 69 66 20 74 68 65 20 63 65 rwise, if the ce
32d20 6c 6c 73 20 61 72 65 20 61 64 64 65 64 20 73 75 lls are added su
32d30 63 63 65 73 73 66 75 6c 6c 79 2c 20 7a 65 72 6f ccessfully, zero
32d40 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 2e is.** returned.
32d50 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 .**.** Argument
32d60 70 43 65 6c 6c 70 74 72 20 70 6f 69 6e 74 73 20 pCellptr points
32d70 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 to the first ent
32d80 72 79 20 69 6e 20 74 68 65 20 63 65 6c 6c 2d 70 ry in the cell-p
32d90 6f 69 6e 74 65 72 20 61 72 72 61 79 0a 2a 2a 20 ointer array.**
32da0 28 70 61 72 74 20 6f 66 20 70 61 67 65 20 70 50 (part of page pP
32db0 67 29 20 74 6f 20 70 6f 70 75 6c 61 74 65 2e 20 g) to populate.
32dc0 41 66 74 65 72 20 63 65 6c 6c 20 61 70 43 65 6c After cell apCel
32dd0 6c 5b 30 5d 20 69 73 20 77 72 69 74 74 65 6e 20 l[0] is written
32de0 74 6f 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 62 to the.** page b
32df0 6f 64 79 2c 20 61 20 31 36 2d 62 69 74 20 6f 66 ody, a 16-bit of
32e00 66 73 65 74 20 69 73 20 77 72 69 74 74 65 6e 20 fset is written
32e10 74 6f 20 70 43 65 6c 6c 70 74 72 2e 20 41 6e 64 to pCellptr. And
32e20 20 73 6f 20 6f 6e 2c 20 66 6f 72 20 65 61 63 68 so on, for each
32e30 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 74 68 65 20 .** cell in the
32e40 61 72 72 61 79 2e 20 49 74 20 69 73 20 74 68 65 array. It is the
32e50 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 responsibility
32e60 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f of the caller to
32e70 20 65 6e 73 75 72 65 0a 2a 2a 20 74 68 61 74 20 ensure.** that
32e80 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 6f 76 it is safe to ov
32e90 65 72 77 72 69 74 65 20 74 68 69 73 20 70 61 72 erwrite this par
32ea0 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 70 6f t of the cell-po
32eb0 69 6e 74 65 72 20 61 72 72 61 79 2e 0a 2a 2a 0a inter array..**.
32ec0 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 66 75 6e ** When this fun
32ed0 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c ction is called,
32ee0 20 2a 70 70 44 61 74 61 20 70 6f 69 6e 74 73 20 *ppData points
32ef0 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 to the start of
32f00 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 the .** content
32f10 61 72 65 61 20 6f 6e 20 70 61 67 65 20 70 50 67 area on page pPg
32f20 2e 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f 66 . If the size of
32f30 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 61 72 65 the content are
32f40 61 20 69 73 20 65 78 74 65 6e 64 65 64 2c 0a 2a a is extended,.*
32f50 2a 20 2a 70 70 44 61 74 61 20 69 73 20 75 70 64 * *ppData is upd
32f60 61 74 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 6f ated to point to
32f70 20 74 68 65 20 6e 65 77 20 73 74 61 72 74 20 6f the new start o
32f80 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 61 72 f the content ar
32f90 65 61 0a 2a 2a 20 62 65 66 6f 72 65 20 72 65 74 ea.** before ret
32fa0 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 46 69 urning..**.** Fi
32fb0 6e 61 6c 6c 79 2c 20 61 72 67 75 6d 65 6e 74 20 nally, argument
32fc0 70 42 65 67 69 6e 20 70 6f 69 6e 74 73 20 74 6f pBegin points to
32fd0 20 74 68 65 20 62 79 74 65 20 69 6d 6d 65 64 69 the byte immedi
32fe0 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 ately following
32ff0 74 68 65 0a 2a 2a 20 65 6e 64 20 6f 66 20 74 68 the.** end of th
33000 65 20 73 70 61 63 65 20 72 65 71 75 69 72 65 64 e space required
33010 20 62 79 20 74 68 69 73 20 70 61 67 65 20 66 6f by this page fo
33020 72 20 74 68 65 20 63 65 6c 6c 2d 70 6f 69 6e 74 r the cell-point
33030 65 72 20 61 72 65 61 20 28 66 6f 72 0a 2a 2a 20 er area (for.**
33040 61 6c 6c 20 63 65 6c 6c 73 20 2d 20 6e 6f 74 20 all cells - not
33050 6a 75 73 74 20 74 68 6f 73 65 20 69 6e 73 65 72 just those inser
33060 74 65 64 20 62 79 20 74 68 65 20 63 75 72 72 65 ted by the curre
33070 6e 74 20 63 61 6c 6c 29 2e 20 49 66 20 74 68 65 nt call). If the
33080 20 63 6f 6e 74 65 6e 74 0a 2a 2a 20 61 72 65 61 content.** area
33090 20 6d 75 73 74 20 62 65 20 65 78 74 65 6e 64 65 must be extende
330a0 64 20 74 6f 20 62 65 66 6f 72 65 20 74 68 69 73 d to before this
330b0 20 70 6f 69 6e 74 20 69 6e 20 6f 72 64 65 72 20 point in order
330c0 74 6f 20 61 63 63 6f 6d 6f 64 61 74 65 20 61 6c to accomodate al
330d0 6c 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 61 70 l.** cells in ap
330e0 43 65 6c 6c 5b 5d 2c 20 74 68 65 6e 20 74 68 65 Cell[], then the
330f0 20 63 65 6c 6c 73 20 64 6f 20 6e 6f 74 20 66 69 cells do not fi
33100 74 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20 69 t and non-zero i
33110 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 s returned..*/.s
33120 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 49 6e tatic int pageIn
33130 73 65 72 74 41 72 72 61 79 28 0a 20 20 4d 65 6d sertArray(. Mem
33140 50 61 67 65 20 2a 70 50 67 2c 20 20 20 20 20 20 Page *pPg,
33150 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
33160 50 61 67 65 20 74 6f 20 61 64 64 20 63 65 6c 6c Page to add cell
33170 73 20 74 6f 20 2a 2f 0a 20 20 75 38 20 2a 70 42 s to */. u8 *pB
33180 65 67 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 egin,
33190 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 6e 64 /* End
331a0 20 6f 66 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 of cell-pointer
331b0 20 61 72 72 61 79 20 2a 2f 0a 20 20 75 38 20 2a array */. u8 *
331c0 2a 70 70 44 61 74 61 2c 20 20 20 20 20 20 20 20 *ppData,
331d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
331e0 4e 2f 4f 55 54 3a 20 50 61 67 65 20 63 6f 6e 74 N/OUT: Page cont
331f0 65 6e 74 20 2d 61 72 65 61 20 70 6f 69 6e 74 65 ent -area pointe
33200 72 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c r */. u8 *pCell
33210 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 ptr,
33220 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
33230 72 20 74 6f 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 r to cell-pointe
33240 72 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 r area */. int
33250 6e 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 nCell,
33260 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
33270 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 74 umber of cells t
33280 6f 20 61 64 64 20 74 6f 20 70 50 67 20 2a 2f 0a o add to pPg */.
33290 20 20 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 u8 **apCell,
332a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
332b0 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 /* Array of ce
332c0 6c 6c 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a lls */. u16 *sz
332d0 43 65 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 Cell
332e0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 /* Arra
332f0 79 20 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 y of cell sizes
33300 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 */.){. int i;.
33310 20 75 38 20 2a 61 44 61 74 61 20 3d 20 70 50 67 u8 *aData = pPg
33320 2d 3e 61 44 61 74 61 3b 0a 20 20 75 38 20 2a 70 ->aData;. u8 *p
33330 44 61 74 61 20 3d 20 2a 70 70 44 61 74 61 3b 0a Data = *ppData;.
33340 20 20 63 6f 6e 73 74 20 69 6e 74 20 62 46 72 65 const int bFre
33350 65 6c 69 73 74 20 3d 20 61 44 61 74 61 5b 31 5d elist = aData[1]
33360 20 7c 7c 20 61 44 61 74 61 5b 32 5d 3b 0a 20 20 || aData[2];.
33370 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f assert( CORRUPT_
33380 44 42 20 7c 7c 20 70 50 67 2d 3e 68 64 72 4f 66 DB || pPg->hdrOf
33390 66 73 65 74 3d 3d 30 20 29 3b 20 20 20 20 2f 2a fset==0 ); /*
333a0 20 4e 65 76 65 72 20 63 61 6c 6c 65 64 20 6f 6e Never called on
333b0 20 70 61 67 65 20 31 20 2a 2f 0a 20 20 66 6f 72 page 1 */. for
333c0 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 (i=0; i<nCell; i
333d0 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 73 7a 20 ++){. int sz
333e0 3d 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 = szCell[i];.
333f0 20 75 38 20 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 u8 *pSlot;.
33400 69 66 28 20 62 46 72 65 65 6c 69 73 74 3d 3d 30 if( bFreelist==0
33410 20 7c 7c 20 28 70 53 6c 6f 74 20 3d 20 70 61 67 || (pSlot = pag
33420 65 46 69 6e 64 53 6c 6f 74 28 70 50 67 2c 20 73 eFindSlot(pPg, s
33430 7a 2c 20 30 2c 20 30 29 29 3d 3d 30 20 29 7b 0a z, 0, 0))==0 ){.
33440 20 20 20 20 20 20 70 44 61 74 61 20 2d 3d 20 73 pData -= s
33450 7a 3b 0a 20 20 20 20 20 20 69 66 28 20 70 44 61 z;. if( pDa
33460 74 61 3c 70 42 65 67 69 6e 20 29 20 72 65 74 75 ta<pBegin ) retu
33470 72 6e 20 31 3b 0a 20 20 20 20 20 20 70 53 6c 6f rn 1;. pSlo
33480 74 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 7d t = pData;. }
33490 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 53 6c 6f . memcpy(pSlo
334a0 74 2c 20 61 70 43 65 6c 6c 5b 69 5d 2c 20 73 7a t, apCell[i], sz
334b0 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
334c0 70 43 65 6c 6c 70 74 72 2c 20 28 70 53 6c 6f 74 pCellptr, (pSlot
334d0 20 2d 20 61 44 61 74 61 29 29 3b 0a 20 20 20 20 - aData));.
334e0 70 43 65 6c 6c 70 74 72 20 2b 3d 20 32 3b 0a 20 pCellptr += 2;.
334f0 20 7d 0a 20 20 2a 70 70 44 61 74 61 20 3d 20 70 }. *ppData = p
33500 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 30 Data;. return 0
33510 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 ;.}../*.** Array
33520 20 61 70 43 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 apCell[] contai
33530 6e 73 20 6e 43 65 6c 6c 20 70 6f 69 6e 74 65 72 ns nCell pointer
33540 73 20 74 6f 20 62 2d 74 72 65 65 20 63 65 6c 6c s to b-tree cell
33550 73 2e 20 41 72 72 61 79 20 73 7a 43 65 6c 6c 20 s. Array szCell
33560 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 .** contains the
33570 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f size in bytes o
33580 66 20 65 61 63 68 20 73 75 63 68 20 63 65 6c 6c f each such cell
33590 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
335a0 61 64 64 73 20 74 68 65 0a 2a 2a 20 73 70 61 63 adds the.** spac
335b0 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 e associated wit
335c0 68 20 65 61 63 68 20 63 65 6c 6c 20 69 6e 20 74 h each cell in t
335d0 68 65 20 61 72 72 61 79 20 74 68 61 74 20 69 73 he array that is
335e0 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 currently store
335f0 64 20 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 d .** within the
33600 20 62 6f 64 79 20 6f 66 20 70 50 67 20 74 6f 20 body of pPg to
33610 74 68 65 20 70 50 67 20 66 72 65 65 2d 6c 69 73 the pPg free-lis
33620 74 2e 20 54 68 65 20 63 65 6c 6c 2d 70 6f 69 6e t. The cell-poin
33630 74 65 72 73 20 61 6e 64 20 6f 74 68 65 72 0a 2a ters and other.*
33640 2a 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 * fields of the
33650 70 61 67 65 20 61 72 65 20 6e 6f 74 20 75 70 64 page are not upd
33660 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ated..**.** This
33670 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
33680 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 s the total numb
33690 65 72 20 6f 66 20 63 65 6c 6c 73 20 61 64 64 65 er of cells adde
336a0 64 20 74 6f 20 74 68 65 20 66 72 65 65 2d 6c 69 d to the free-li
336b0 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e st..*/.static in
336c0 74 20 70 61 67 65 46 72 65 65 41 72 72 61 79 28 t pageFreeArray(
336d0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c . MemPage *pPg,
336e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
336f0 20 20 20 2f 2a 20 50 61 67 65 20 74 6f 20 65 64 /* Page to ed
33700 69 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c it */. int nCel
33710 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
33720 20 20 20 20 20 20 20 20 2f 2a 20 43 65 6c 6c 73 /* Cells
33730 20 74 6f 20 64 65 6c 65 74 65 20 2a 2f 0a 20 20 to delete */.
33740 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 u8 **apCell,
33750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33760 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 6c 6c /* Array of cell
33770 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 s */. u16 *szCe
33780 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ll
33790 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 /* Array
337a0 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a 2f of cell sizes */
337b0 0a 29 7b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 .){. u8 * const
337c0 20 61 44 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 aData = pPg->aD
337d0 61 74 61 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 ata;. u8 * cons
337e0 74 20 70 45 6e 64 20 3d 20 26 61 44 61 74 61 5b t pEnd = &aData[
337f0 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 pPg->pBt->usable
33800 53 69 7a 65 5d 3b 0a 20 20 75 38 20 2a 20 63 6f Size];. u8 * co
33810 6e 73 74 20 70 53 74 61 72 74 20 3d 20 26 61 44 nst pStart = &aD
33820 61 74 61 5b 70 50 67 2d 3e 68 64 72 4f 66 66 73 ata[pPg->hdrOffs
33830 65 74 20 2b 20 38 20 2b 20 70 50 67 2d 3e 63 68 et + 8 + pPg->ch
33840 69 6c 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 69 ildPtrSize];. i
33850 6e 74 20 6e 52 65 74 20 3d 20 30 3b 0a 20 20 69 nt nRet = 0;. i
33860 6e 74 20 69 3b 0a 20 20 75 38 20 2a 70 46 72 65 nt i;. u8 *pFre
33870 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 73 7a 46 e = 0;. int szF
33880 72 65 65 20 3d 20 30 3b 0a 0a 20 20 66 6f 72 28 ree = 0;.. for(
33890 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b i=0; i<nCell; i+
338a0 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 6c +){. u8 *pCel
338b0 6c 20 3d 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a 20 l = apCell[i];.
338c0 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 3d 70 53 if( pCell>=pS
338d0 74 61 72 74 20 26 26 20 70 43 65 6c 6c 3c 70 45 tart && pCell<pE
338e0 6e 64 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 nd ){. int
338f0 73 7a 20 3d 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a sz = szCell[i];.
33900 20 20 20 20 20 20 69 66 28 20 70 46 72 65 65 21 if( pFree!
33910 3d 28 70 43 65 6c 6c 20 2b 20 73 7a 29 20 29 7b =(pCell + sz) ){
33920 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 46 72 . if( pFr
33930 65 65 20 29 20 66 72 65 65 53 70 61 63 65 28 70 ee ) freeSpace(p
33940 50 67 2c 20 70 46 72 65 65 20 2d 20 61 44 61 74 Pg, pFree - aDat
33950 61 2c 20 73 7a 46 72 65 65 29 3b 0a 20 20 20 20 a, szFree);.
33960 20 20 20 20 70 46 72 65 65 20 3d 20 70 43 65 6c pFree = pCel
33970 6c 3b 0a 20 20 20 20 20 20 20 20 73 7a 46 72 65 l;. szFre
33980 65 20 3d 20 73 7a 3b 0a 20 20 20 20 20 20 20 20 e = sz;.
33990 69 66 28 20 70 46 72 65 65 2b 73 7a 3e 70 45 6e if( pFree+sz>pEn
339a0 64 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 d ) return 0;.
339b0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
339c0 20 20 20 70 46 72 65 65 20 3d 20 70 43 65 6c 6c pFree = pCell
339d0 3b 0a 20 20 20 20 20 20 20 20 73 7a 46 72 65 65 ;. szFree
339e0 20 2b 3d 20 73 7a 3b 0a 20 20 20 20 20 20 7d 0a += sz;. }.
339f0 20 20 20 20 20 20 6e 52 65 74 2b 2b 3b 0a 20 20 nRet++;.
33a00 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 46 }. }. if( pF
33a10 72 65 65 20 29 20 66 72 65 65 53 70 61 63 65 28 ree ) freeSpace(
33a20 70 50 67 2c 20 70 46 72 65 65 20 2d 20 61 44 61 pPg, pFree - aDa
33a30 74 61 2c 20 73 7a 46 72 65 65 29 3b 0a 20 20 72 ta, szFree);. r
33a40 65 74 75 72 6e 20 6e 52 65 74 3b 0a 7d 0a 0a 2f eturn nRet;.}../
33a50 2a 0a 2a 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 *.** The pPg->nF
33a60 72 65 65 20 66 69 65 6c 64 20 69 73 20 69 6e 76 ree field is inv
33a70 61 6c 69 64 20 77 68 65 6e 20 74 68 69 73 20 66 alid when this f
33a80 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e unction returns.
33a90 20 49 74 20 69 73 20 74 68 65 0a 2a 2a 20 72 65 It is the.** re
33aa0 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 sponsibility of
33ab0 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 73 65 the caller to se
33ac0 74 20 69 74 20 63 6f 72 72 65 63 74 6c 79 2e 0a t it correctly..
33ad0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 65 */.static void e
33ae0 64 69 74 50 61 67 65 28 0a 20 20 4d 65 6d 50 61 ditPage(. MemPa
33af0 67 65 20 2a 70 50 67 2c 20 20 20 20 20 20 20 20 ge *pPg,
33b00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 64 /* Ed
33b10 69 74 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a it this page */.
33b20 20 20 69 6e 74 20 69 4f 6c 64 2c 20 20 20 20 20 int iOld,
33b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33b40 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 66 69 /* Index of fi
33b50 72 73 74 20 63 65 6c 6c 20 63 75 72 72 65 6e 74 rst cell current
33b60 6c 79 20 6f 6e 20 70 61 67 65 20 2a 2f 0a 20 20 ly on page */.
33b70 69 6e 74 20 69 4e 65 77 2c 20 20 20 20 20 20 20 int iNew,
33b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33b90 2f 2a 20 49 6e 64 65 78 20 6f 66 20 6e 65 77 20 /* Index of new
33ba0 66 69 72 73 74 20 63 65 6c 6c 20 6f 6e 20 70 61 first cell on pa
33bb0 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4e 65 77 ge */. int nNew
33bc0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
33bd0 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6e 61 6c /* Final
33be0 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 number of cells
33bf0 20 6f 6e 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 on page */. u8
33c00 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 **apCell,
33c10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
33c20 20 41 72 72 61 79 20 6f 66 20 63 65 6c 6c 73 20 Array of cells
33c30 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c 6c */. u16 *szCell
33c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33c50 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 /* Array of
33c60 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a 2f 0a 29 cell sizes */.)
33c70 7b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 {. u8 * const a
33c80 44 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 Data = pPg->aDat
33c90 61 3b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 a;. const int h
33ca0 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 dr = pPg->hdrOff
33cb0 73 65 74 3b 0a 20 20 75 38 20 2a 70 42 65 67 69 set;. u8 *pBegi
33cc0 6e 20 3d 20 26 70 50 67 2d 3e 61 43 65 6c 6c 49 n = &pPg->aCellI
33cd0 64 78 5b 6e 4e 65 77 20 2a 20 32 5d 3b 0a 20 20 dx[nNew * 2];.
33ce0 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 70 50 67 2d int nCell = pPg-
33cf0 3e 6e 43 65 6c 6c 3b 20 20 20 20 20 20 20 2f 2a >nCell; /*
33d00 20 43 65 6c 6c 73 20 73 74 6f 72 65 64 20 6f 6e Cells stored on
33d10 20 70 50 67 20 2a 2f 0a 20 20 75 38 20 2a 70 44 pPg */. u8 *pD
33d20 61 74 61 3b 0a 20 20 75 38 20 2a 70 43 65 6c 6c ata;. u8 *pCell
33d30 70 74 72 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 ptr;. int i;.
33d40 69 6e 74 20 69 4f 6c 64 45 6e 64 20 3d 20 69 4f int iOldEnd = iO
33d50 6c 64 20 2b 20 70 50 67 2d 3e 6e 43 65 6c 6c 20 ld + pPg->nCell
33d60 2b 20 70 50 67 2d 3e 6e 4f 76 65 72 66 6c 6f 77 + pPg->nOverflow
33d70 3b 0a 20 20 69 6e 74 20 69 4e 65 77 45 6e 64 20 ;. int iNewEnd
33d80 3d 20 69 4e 65 77 20 2b 20 6e 4e 65 77 3b 0a 0a = iNew + nNew;..
33d90 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
33da0 42 55 47 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d BUG. u8 *pTmp =
33db0 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 65 6d sqlite3PagerTem
33dc0 70 53 70 61 63 65 28 70 50 67 2d 3e 70 42 74 2d pSpace(pPg->pBt-
33dd0 3e 70 50 61 67 65 72 29 3b 0a 20 20 6d 65 6d 63 >pPager);. memc
33de0 70 79 28 70 54 6d 70 2c 20 61 44 61 74 61 2c 20 py(pTmp, aData,
33df0 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 pPg->pBt->usable
33e00 53 69 7a 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 Size);.#endif..
33e10 20 2f 2a 20 52 65 6d 6f 76 65 20 63 65 6c 6c 73 /* Remove cells
33e20 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 74 20 from the start
33e30 61 6e 64 20 65 6e 64 20 6f 66 20 74 68 65 20 70 and end of the p
33e40 61 67 65 20 2a 2f 0a 20 20 69 66 28 20 69 4f 6c age */. if( iOl
33e50 64 3c 69 4e 65 77 20 29 7b 0a 20 20 20 20 69 6e d<iNew ){. in
33e60 74 20 6e 53 68 69 66 74 20 3d 20 70 61 67 65 46 t nShift = pageF
33e70 72 65 65 41 72 72 61 79 28 0a 20 20 20 20 20 20 reeArray(.
33e80 20 20 70 50 67 2c 20 69 4e 65 77 2d 69 4f 6c 64 pPg, iNew-iOld
33e90 2c 20 26 61 70 43 65 6c 6c 5b 69 4f 6c 64 5d 2c , &apCell[iOld],
33ea0 20 26 73 7a 43 65 6c 6c 5b 69 4f 6c 64 5d 0a 20 &szCell[iOld].
33eb0 20 20 20 29 3b 0a 20 20 20 20 6d 65 6d 6d 6f 76 );. memmov
33ec0 65 28 70 50 67 2d 3e 61 43 65 6c 6c 49 64 78 2c e(pPg->aCellIdx,
33ed0 20 26 70 50 67 2d 3e 61 43 65 6c 6c 49 64 78 5b &pPg->aCellIdx[
33ee0 6e 53 68 69 66 74 2a 32 5d 2c 20 6e 43 65 6c 6c nShift*2], nCell
33ef0 2a 32 29 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 2d *2);. nCell -
33f00 3d 20 6e 53 68 69 66 74 3b 0a 20 20 7d 0a 20 20 = nShift;. }.
33f10 69 66 28 20 69 4e 65 77 45 6e 64 20 3c 20 69 4f if( iNewEnd < iO
33f20 6c 64 45 6e 64 20 29 7b 0a 20 20 20 20 6e 43 65 ldEnd ){. nCe
33f30 6c 6c 20 2d 3d 20 70 61 67 65 46 72 65 65 41 72 ll -= pageFreeAr
33f40 72 61 79 28 0a 20 20 20 20 20 20 20 20 70 50 67 ray(. pPg
33f50 2c 20 69 4f 6c 64 45 6e 64 2d 69 4e 65 77 45 6e , iOldEnd-iNewEn
33f60 64 2c 20 26 61 70 43 65 6c 6c 5b 69 4e 65 77 45 d, &apCell[iNewE
33f70 6e 64 5d 2c 20 26 73 7a 43 65 6c 6c 5b 69 4e 65 nd], &szCell[iNe
33f80 77 45 6e 64 5d 0a 20 20 20 20 29 3b 0a 20 20 7d wEnd]. );. }
33f90 0a 0a 20 20 70 44 61 74 61 20 3d 20 26 61 44 61 .. pData = &aDa
33fa0 74 61 5b 67 65 74 32 62 79 74 65 28 26 61 44 61 ta[get2byte(&aDa
33fb0 74 61 5b 68 64 72 2b 35 5d 29 5d 3b 0a 20 20 69 ta[hdr+5])];. i
33fc0 66 28 20 70 44 61 74 61 3c 70 42 65 67 69 6e 20 f( pData<pBegin
33fd0 29 20 67 6f 74 6f 20 65 64 69 74 70 61 67 65 5f ) goto editpage_
33fe0 66 61 69 6c 3b 0a 0a 20 20 2f 2a 20 41 64 64 20 fail;.. /* Add
33ff0 63 65 6c 6c 73 20 74 6f 20 74 68 65 20 73 74 61 cells to the sta
34000 72 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a rt of the page *
34010 2f 0a 20 20 69 66 28 20 69 4e 65 77 3c 69 4f 6c /. if( iNew<iOl
34020 64 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41 64 d ){. int nAd
34030 64 20 3d 20 69 4f 6c 64 2d 69 4e 65 77 3b 0a 20 d = iOld-iNew;.
34040 20 20 20 70 43 65 6c 6c 70 74 72 20 3d 20 70 50 pCellptr = pP
34050 67 2d 3e 61 43 65 6c 6c 49 64 78 3b 0a 20 20 20 g->aCellIdx;.
34060 20 6d 65 6d 6d 6f 76 65 28 26 70 43 65 6c 6c 70 memmove(&pCellp
34070 74 72 5b 6e 41 64 64 2a 32 5d 2c 20 70 43 65 6c tr[nAdd*2], pCel
34080 6c 70 74 72 2c 20 6e 43 65 6c 6c 2a 32 29 3b 0a lptr, nCell*2);.
34090 20 20 20 20 69 66 28 20 70 61 67 65 49 6e 73 65 if( pageInse
340a0 72 74 41 72 72 61 79 28 0a 20 20 20 20 20 20 20 rtArray(.
340b0 20 20 20 70 50 67 2c 20 70 42 65 67 69 6e 2c 20 pPg, pBegin,
340c0 26 70 44 61 74 61 2c 20 70 43 65 6c 6c 70 74 72 &pData, pCellptr
340d0 2c 0a 20 20 20 20 20 20 20 20 20 20 6e 41 64 64 ,. nAdd
340e0 2c 20 26 61 70 43 65 6c 6c 5b 69 4e 65 77 5d 2c , &apCell[iNew],
340f0 20 26 73 7a 43 65 6c 6c 5b 69 4e 65 77 5d 0a 20 &szCell[iNew].
34100 20 20 20 29 20 29 20 67 6f 74 6f 20 65 64 69 74 ) ) goto edit
34110 70 61 67 65 5f 66 61 69 6c 3b 0a 20 20 20 20 6e page_fail;. n
34120 43 65 6c 6c 20 2b 3d 20 6e 41 64 64 3b 0a 20 20 Cell += nAdd;.
34130 7d 0a 0a 20 20 2f 2a 20 41 64 64 20 61 6e 79 20 }.. /* Add any
34140 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 2a overflow cells *
34150 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 /. for(i=0; i<p
34160 50 67 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 20 69 Pg->nOverflow; i
34170 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 69 43 65 ++){. int iCe
34180 6c 6c 20 3d 20 28 69 4f 6c 64 20 2b 20 70 50 67 ll = (iOld + pPg
34190 2d 3e 61 69 4f 76 66 6c 5b 69 5d 29 20 2d 20 69 ->aiOvfl[i]) - i
341a0 4e 65 77 3b 0a 20 20 20 20 69 66 28 20 69 43 65 New;. if( iCe
341b0 6c 6c 3e 3d 30 20 26 26 20 69 43 65 6c 6c 3c 6e ll>=0 && iCell<n
341c0 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 75 38 20 New ){. u8
341d0 2a 70 43 65 6c 6c 70 74 72 20 3d 20 26 70 50 67 *pCellptr = &pPg
341e0 2d 3e 61 43 65 6c 6c 49 64 78 5b 69 43 65 6c 6c ->aCellIdx[iCell
341f0 20 2a 20 32 5d 3b 0a 20 20 20 20 20 20 6d 65 6d * 2];. mem
34200 6d 6f 76 65 28 26 70 43 65 6c 6c 70 74 72 5b 32 move(&pCellptr[2
34210 5d 2c 20 70 43 65 6c 6c 70 74 72 2c 20 28 6e 43 ], pCellptr, (nC
34220 65 6c 6c 20 2d 20 69 43 65 6c 6c 29 20 2a 20 32 ell - iCell) * 2
34230 29 3b 0a 20 20 20 20 20 20 6e 43 65 6c 6c 2b 2b );. nCell++
34240 3b 0a 20 20 20 20 20 20 69 66 28 20 70 61 67 65 ;. if( page
34250 49 6e 73 65 72 74 41 72 72 61 79 28 0a 20 20 20 InsertArray(.
34260 20 20 20 20 20 20 20 20 20 70 50 67 2c 20 70 42 pPg, pB
34270 65 67 69 6e 2c 20 26 70 44 61 74 61 2c 20 70 43 egin, &pData, pC
34280 65 6c 6c 70 74 72 2c 0a 20 20 20 20 20 20 20 20 ellptr,.
34290 20 20 20 20 31 2c 20 26 61 70 43 65 6c 6c 5b 69 1, &apCell[i
342a0 43 65 6c 6c 20 2b 20 69 4e 65 77 5d 2c 20 26 73 Cell + iNew], &s
342b0 7a 43 65 6c 6c 5b 69 43 65 6c 6c 20 2b 20 69 4e zCell[iCell + iN
342c0 65 77 5d 0a 20 20 20 20 20 20 29 20 29 20 67 6f ew]. ) ) go
342d0 74 6f 20 65 64 69 74 70 61 67 65 5f 66 61 69 6c to editpage_fail
342e0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f ;. }. }.. /
342f0 2a 20 41 70 70 65 6e 64 20 63 65 6c 6c 73 20 74 * Append cells t
34300 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 o the end of the
34310 20 70 61 67 65 20 2a 2f 0a 20 20 70 43 65 6c 6c page */. pCell
34320 70 74 72 20 3d 20 26 70 50 67 2d 3e 61 43 65 6c ptr = &pPg->aCel
34330 6c 49 64 78 5b 6e 43 65 6c 6c 2a 32 5d 3b 0a 20 lIdx[nCell*2];.
34340 20 69 66 28 20 70 61 67 65 49 6e 73 65 72 74 41 if( pageInsertA
34350 72 72 61 79 28 0a 20 20 20 20 20 20 20 20 70 50 rray(. pP
34360 67 2c 20 70 42 65 67 69 6e 2c 20 26 70 44 61 74 g, pBegin, &pDat
34370 61 2c 20 70 43 65 6c 6c 70 74 72 2c 0a 20 20 20 a, pCellptr,.
34380 20 20 20 20 20 6e 4e 65 77 2d 6e 43 65 6c 6c 2c nNew-nCell,
34390 20 26 61 70 43 65 6c 6c 5b 69 4e 65 77 2b 6e 43 &apCell[iNew+nC
343a0 65 6c 6c 5d 2c 20 26 73 7a 43 65 6c 6c 5b 69 4e ell], &szCell[iN
343b0 65 77 2b 6e 43 65 6c 6c 5d 0a 20 20 29 20 29 20 ew+nCell]. ) )
343c0 67 6f 74 6f 20 65 64 69 74 70 61 67 65 5f 66 61 goto editpage_fa
343d0 69 6c 3b 0a 0a 20 20 70 50 67 2d 3e 6e 43 65 6c il;.. pPg->nCel
343e0 6c 20 3d 20 6e 4e 65 77 3b 0a 20 20 70 50 67 2d l = nNew;. pPg-
343f0 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a >nOverflow = 0;.
34400 0a 20 20 70 75 74 32 62 79 74 65 28 26 61 44 61 . put2byte(&aDa
34410 74 61 5b 68 64 72 2b 33 5d 2c 20 70 50 67 2d 3e ta[hdr+3], pPg->
34420 6e 43 65 6c 6c 29 3b 0a 20 20 70 75 74 32 62 79 nCell);. put2by
34430 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b 35 5d te(&aData[hdr+5]
34440 2c 20 70 44 61 74 61 20 2d 20 61 44 61 74 61 29 , pData - aData)
34450 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ;..#ifdef SQLITE
34460 5f 44 45 42 55 47 0a 20 20 66 6f 72 28 69 3d 30 _DEBUG. for(i=0
34470 3b 20 69 3c 6e 4e 65 77 20 26 26 20 21 43 4f 52 ; i<nNew && !COR
34480 52 55 50 54 5f 44 42 3b 20 69 2b 2b 29 7b 0a 20 RUPT_DB; i++){.
34490 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 61 u8 *pCell = a
344a0 70 43 65 6c 6c 5b 69 2b 69 4e 65 77 5d 3b 0a 20 pCell[i+iNew];.
344b0 20 20 20 69 6e 74 20 69 4f 66 66 20 3d 20 67 65 int iOff = ge
344c0 74 32 62 79 74 65 28 26 70 50 67 2d 3e 61 43 65 t2byte(&pPg->aCe
344d0 6c 6c 49 64 78 5b 69 2a 32 5d 29 3b 0a 20 20 20 llIdx[i*2]);.
344e0 20 69 66 28 20 70 43 65 6c 6c 3e 3d 61 44 61 74 if( pCell>=aDat
344f0 61 20 26 26 20 70 43 65 6c 6c 3c 26 61 44 61 74 a && pCell<&aDat
34500 61 5b 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 a[pPg->pBt->usab
34510 6c 65 53 69 7a 65 5d 20 29 7b 0a 20 20 20 20 20 leSize] ){.
34520 20 70 43 65 6c 6c 20 3d 20 26 70 54 6d 70 5b 70 pCell = &pTmp[p
34530 43 65 6c 6c 20 2d 20 61 44 61 74 61 5d 3b 0a 20 Cell - aData];.
34540 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 }. assert(
34550 20 30 3d 3d 6d 65 6d 63 6d 70 28 70 43 65 6c 6c 0==memcmp(pCell
34560 2c 20 26 61 44 61 74 61 5b 69 4f 66 66 5d 2c 20 , &aData[iOff],
34570 73 7a 43 65 6c 6c 5b 69 2b 69 4e 65 77 5d 29 20 szCell[i+iNew])
34580 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 );. }.#endif..
34590 20 72 65 74 75 72 6e 3b 0a 20 65 64 69 74 70 61 return;. editpa
345a0 67 65 5f 66 61 69 6c 3a 0a 20 20 2f 2a 20 55 6e ge_fail:. /* Un
345b0 61 62 6c 65 20 74 6f 20 65 64 69 74 20 74 68 69 able to edit thi
345c0 73 20 70 61 67 65 2e 20 52 65 62 75 69 6c 64 20 s page. Rebuild
345d0 69 74 20 66 72 6f 6d 20 73 63 72 61 74 63 68 20 it from scratch
345e0 69 6e 73 74 65 61 64 2e 20 2a 2f 0a 20 20 72 65 instead. */. re
345f0 62 75 69 6c 64 50 61 67 65 28 70 50 67 2c 20 6e buildPage(pPg, n
34600 4e 65 77 2c 20 26 61 70 43 65 6c 6c 5b 69 4e 65 New, &apCell[iNe
34610 77 5d 2c 20 26 73 7a 43 65 6c 6c 5b 69 4e 65 77 w], &szCell[iNew
34620 5d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 ]);.}../*.** The
34630 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 61 6d following param
34640 65 74 65 72 73 20 64 65 74 65 72 6d 69 6e 65 20 eters determine
34650 68 6f 77 20 6d 61 6e 79 20 61 64 6a 61 63 65 6e how many adjacen
34660 74 20 70 61 67 65 73 20 67 65 74 20 69 6e 76 6f t pages get invo
34670 6c 76 65 64 0a 2a 2a 20 69 6e 20 61 20 62 61 6c lved.** in a bal
34680 61 6e 63 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e ancing operation
34690 2e 20 20 4e 4e 20 69 73 20 74 68 65 20 6e 75 6d . NN is the num
346a0 62 65 72 20 6f 66 20 6e 65 69 67 68 62 6f 72 73 ber of neighbors
346b0 20 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 0a on either side.
346c0 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 ** of the page t
346d0 68 61 74 20 70 61 72 74 69 63 69 70 61 74 65 20 hat participate
346e0 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 in the balancing
346f0 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 4e 42 20 operation. NB
34700 69 73 20 74 68 65 0a 2a 2a 20 74 6f 74 61 6c 20 is the.** total
34710 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
34720 74 68 61 74 20 70 61 72 74 69 63 69 70 61 74 65 that participate
34730 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 , including the
34740 74 61 72 67 65 74 20 70 61 67 65 20 61 6e 64 0a target page and.
34750 2a 2a 20 4e 4e 20 6e 65 69 67 68 62 6f 72 73 20 ** NN neighbors
34760 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 2e 0a on either side..
34770 2a 2a 0a 2a 2a 20 54 68 65 20 6d 69 6e 69 6d 75 **.** The minimu
34780 6d 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 69 73 m value of NN is
34790 20 31 20 28 6f 66 20 63 6f 75 72 73 65 29 2e 20 1 (of course).
347a0 20 49 6e 63 72 65 61 73 69 6e 67 20 4e 4e 20 61 Increasing NN a
347b0 62 6f 76 65 20 31 0a 2a 2a 20 28 74 6f 20 32 20 bove 1.** (to 2
347c0 6f 72 20 33 29 20 67 69 76 65 73 20 61 20 6d 6f or 3) gives a mo
347d0 64 65 73 74 20 69 6d 70 72 6f 76 65 6d 65 6e 74 dest improvement
347e0 20 69 6e 20 53 45 4c 45 43 54 20 61 6e 64 20 44 in SELECT and D
347f0 45 4c 45 54 45 20 70 65 72 66 6f 72 6d 61 6e 63 ELETE performanc
34800 65 0a 2a 2a 20 69 6e 20 65 78 63 68 61 6e 67 65 e.** in exchange
34810 20 66 6f 72 20 61 20 6c 61 72 67 65 72 20 64 65 for a larger de
34820 67 72 61 64 61 74 69 6f 6e 20 69 6e 20 49 4e 53 gradation in INS
34830 45 52 54 20 61 6e 64 20 55 50 44 41 54 45 20 70 ERT and UPDATE p
34840 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 2a 2a 20 54 erformance..** T
34850 68 65 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 61 he value of NN a
34860 70 70 65 61 72 73 20 74 6f 20 67 69 76 65 20 74 ppears to give t
34870 68 65 20 62 65 73 74 20 72 65 73 75 6c 74 73 20 he best results
34880 6f 76 65 72 61 6c 6c 2e 0a 2a 2f 0a 23 64 65 66 overall..*/.#def
34890 69 6e 65 20 4e 4e 20 31 20 20 20 20 20 20 20 20 ine NN 1
348a0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
348b0 66 20 6e 65 69 67 68 62 6f 72 73 20 6f 6e 20 65 f neighbors on e
348c0 69 74 68 65 72 20 73 69 64 65 20 6f 66 20 70 50 ither side of pP
348d0 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e age */.#define N
348e0 42 20 28 4e 4e 2a 32 2b 31 29 20 20 20 20 20 20 B (NN*2+1)
348f0 2f 2a 20 54 6f 74 61 6c 20 70 61 67 65 73 20 69 /* Total pages i
34900 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 62 nvolved in the b
34910 61 6c 61 6e 63 65 20 2a 2f 0a 0a 0a 23 69 66 6e alance */...#ifn
34920 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
34930 51 55 49 43 4b 42 41 4c 41 4e 43 45 0a 2f 2a 0a QUICKBALANCE./*.
34940 2a 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20 ** This version
34950 6f 66 20 62 61 6c 61 6e 63 65 28 29 20 68 61 6e of balance() han
34960 64 6c 65 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 dles the common
34970 73 70 65 63 69 61 6c 20 63 61 73 65 20 77 68 65 special case whe
34980 72 65 0a 2a 2a 20 61 20 6e 65 77 20 65 6e 74 72 re.** a new entr
34990 79 20 69 73 20 62 65 69 6e 67 20 69 6e 73 65 72 y is being inser
349a0 74 65 64 20 6f 6e 20 74 68 65 20 65 78 74 72 65 ted on the extre
349b0 6d 65 20 72 69 67 68 74 2d 65 6e 64 20 6f 66 20 me right-end of
349c0 74 68 65 0a 2a 2a 20 74 72 65 65 2c 20 69 6e 20 the.** tree, in
349d0 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 77 68 65 other words, whe
349e0 6e 20 74 68 65 20 6e 65 77 20 65 6e 74 72 79 20 n the new entry
349f0 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 will become the
34a00 6c 61 72 67 65 73 74 0a 2a 2a 20 65 6e 74 72 79 largest.** entry
34a10 20 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a 2a in the tree..**
34a20 0a 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 74 .** Instead of t
34a30 72 79 69 6e 67 20 74 6f 20 62 61 6c 61 6e 63 65 rying to balance
34a40 20 74 68 65 20 33 20 72 69 67 68 74 2d 6d 6f 73 the 3 right-mos
34a50 74 20 6c 65 61 66 20 70 61 67 65 73 2c 20 6a 75 t leaf pages, ju
34a60 73 74 20 61 64 64 0a 2a 2a 20 61 20 6e 65 77 20 st add.** a new
34a70 70 61 67 65 20 74 6f 20 74 68 65 20 72 69 67 68 page to the righ
34a80 74 2d 68 61 6e 64 20 73 69 64 65 20 61 6e 64 20 t-hand side and
34a90 70 75 74 20 74 68 65 20 6f 6e 65 20 6e 65 77 20 put the one new
34aa0 65 6e 74 72 79 20 69 6e 0a 2a 2a 20 74 68 61 74 entry in.** that
34ab0 20 70 61 67 65 2e 20 20 54 68 69 73 20 6c 65 61 page. This lea
34ac0 76 65 73 20 74 68 65 20 72 69 67 68 74 20 73 69 ves the right si
34ad0 64 65 20 6f 66 20 74 68 65 20 74 72 65 65 20 73 de of the tree s
34ae0 6f 6d 65 77 68 61 74 0a 2a 2a 20 75 6e 62 61 6c omewhat.** unbal
34af0 61 6e 63 65 64 2e 20 20 42 75 74 20 6f 64 64 73 anced. But odds
34b00 20 61 72 65 20 74 68 61 74 20 77 65 20 77 69 6c are that we wil
34b10 6c 20 62 65 20 69 6e 73 65 72 74 69 6e 67 20 6e l be inserting n
34b20 65 77 20 65 6e 74 72 69 65 73 0a 2a 2a 20 61 74 ew entries.** at
34b30 20 74 68 65 20 65 6e 64 20 73 6f 6f 6e 20 61 66 the end soon af
34b40 74 65 72 77 61 72 64 73 20 73 6f 20 74 68 65 20 terwards so the
34b50 6e 65 61 72 6c 79 20 65 6d 70 74 79 20 70 61 67 nearly empty pag
34b60 65 20 77 69 6c 6c 20 71 75 69 63 6b 6c 79 0a 2a e will quickly.*
34b70 2a 20 66 69 6c 6c 20 75 70 2e 20 20 4f 6e 20 61 * fill up. On a
34b80 76 65 72 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 70 50 verage..**.** pP
34b90 61 67 65 20 69 73 20 74 68 65 20 6c 65 61 66 20 age is the leaf
34ba0 70 61 67 65 20 77 68 69 63 68 20 69 73 20 74 68 page which is th
34bb0 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 70 61 67 e right-most pag
34bc0 65 20 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a e in the tree..*
34bd0 2a 20 70 50 61 72 65 6e 74 20 69 73 20 69 74 73 * pParent is its
34be0 20 70 61 72 65 6e 74 2e 20 20 70 50 61 67 65 20 parent. pPage
34bf0 6d 75 73 74 20 68 61 76 65 20 61 20 73 69 6e 67 must have a sing
34c00 6c 65 20 6f 76 65 72 66 6c 6f 77 20 65 6e 74 72 le overflow entr
34c10 79 0a 2a 2a 20 77 68 69 63 68 20 69 73 20 61 6c y.** which is al
34c20 73 6f 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 so the right-mos
34c30 74 20 65 6e 74 72 79 20 6f 6e 20 74 68 65 20 70 t entry on the p
34c40 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 age..**.** The p
34c50 53 70 61 63 65 20 62 75 66 66 65 72 20 69 73 20 Space buffer is
34c60 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 61 20 used to store a
34c70 74 65 6d 70 6f 72 61 72 79 20 63 6f 70 79 20 6f temporary copy o
34c80 66 20 74 68 65 20 64 69 76 69 64 65 72 0a 2a 2a f the divider.**
34c90 20 63 65 6c 6c 20 74 68 61 74 20 77 69 6c 6c 20 cell that will
34ca0 62 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f be inserted into
34cb0 20 70 50 61 72 65 6e 74 2e 20 53 75 63 68 20 61 pParent. Such a
34cc0 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 20 6f cell consists o
34cd0 66 20 61 20 34 0a 2a 2a 20 62 79 74 65 20 70 61 f a 4.** byte pa
34ce0 67 65 20 6e 75 6d 62 65 72 20 66 6f 6c 6c 6f 77 ge number follow
34cf0 65 64 20 62 79 20 61 20 76 61 72 69 61 62 6c 65 ed by a variable
34d00 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 2e length integer.
34d10 20 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 6f 72 In other.** wor
34d20 64 73 2c 20 61 74 20 6d 6f 73 74 20 31 33 20 62 ds, at most 13 b
34d30 79 74 65 73 2e 20 48 65 6e 63 65 20 74 68 65 20 ytes. Hence the
34d40 70 53 70 61 63 65 20 62 75 66 66 65 72 20 6d 75 pSpace buffer mu
34d50 73 74 20 62 65 20 61 74 0a 2a 2a 20 6c 65 61 73 st be at.** leas
34d60 74 20 31 33 20 62 79 74 65 73 20 69 6e 20 73 69 t 13 bytes in si
34d70 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ze..*/.static in
34d80 74 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b 28 t balance_quick(
34d90 4d 65 6d 50 61 67 65 20 2a 70 50 61 72 65 6e 74 MemPage *pParent
34da0 2c 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 , MemPage *pPage
34db0 2c 20 75 38 20 2a 70 53 70 61 63 65 29 7b 0a 20 , u8 *pSpace){.
34dc0 20 42 74 53 68 61 72 65 64 20 2a 63 6f 6e 73 74 BtShared *const
34dd0 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 pBt = pPage->pB
34de0 74 3b 20 20 20 20 2f 2a 20 42 2d 54 72 65 65 20 t; /* B-Tree
34df0 44 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 4d 65 Database */. Me
34e00 6d 50 61 67 65 20 2a 70 4e 65 77 3b 20 20 20 20 mPage *pNew;
34e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34e20 20 20 20 2f 2a 20 4e 65 77 6c 79 20 61 6c 6c 6f /* Newly allo
34e30 63 61 74 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 cated page */.
34e40 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
34e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34e60 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 /* Return C
34e70 6f 64 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 ode */. Pgno pg
34e80 6e 6f 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 noNew;
34e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
34ea0 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 Page number of
34eb0 70 4e 65 77 20 2a 2f 0a 0a 20 20 61 73 73 65 72 pNew */.. asser
34ec0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
34ed0 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
34ee0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
34ef0 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
34f00 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 erIswriteable(pP
34f10 61 72 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 arent->pDbPage)
34f20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
34f30 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 31 ge->nOverflow==1
34f40 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 65 );.. /* This e
34f50 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 rror condition i
34f60 73 20 6e 6f 77 20 63 61 75 67 68 74 20 70 72 69 s now caught pri
34f70 6f 72 20 74 6f 20 72 65 61 63 68 69 6e 67 20 74 or to reaching t
34f80 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a his function */.
34f90 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 if( pPage->nCe
34fa0 6c 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 ll==0 ) return S
34fb0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
34fc0 50 54 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 PT;.. /* Alloca
34fd0 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e 20 54 te a new page. T
34fe0 68 69 73 20 70 61 67 65 20 77 69 6c 6c 20 62 65 his page will be
34ff0 63 6f 6d 65 20 74 68 65 20 72 69 67 68 74 2d 73 come the right-s
35000 69 62 6c 69 6e 67 20 6f 66 20 0a 20 20 2a 2a 20 ibling of . **
35010 70 50 61 67 65 2e 20 4d 61 6b 65 20 74 68 65 20 pPage. Make the
35020 70 61 72 65 6e 74 20 70 61 67 65 20 77 72 69 74 parent page writ
35030 61 62 6c 65 2c 20 73 6f 20 74 68 61 74 20 74 68 able, so that th
35040 65 20 6e 65 77 20 64 69 76 69 64 65 72 20 63 65 e new divider ce
35050 6c 6c 0a 20 20 2a 2a 20 6d 61 79 20 62 65 20 69 ll. ** may be i
35060 6e 73 65 72 74 65 64 2e 20 49 66 20 62 6f 74 68 nserted. If both
35070 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6f 6e these operation
35080 73 20 61 72 65 20 73 75 63 63 65 73 73 66 75 6c s are successful
35090 2c 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2f 0a , proceed.. */.
350a0 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 rc = allocateB
350b0 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 treePage(pBt, &p
350c0 4e 65 77 2c 20 26 70 67 6e 6f 4e 65 77 2c 20 30 New, &pgnoNew, 0
350d0 2c 20 30 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d , 0);.. if( rc=
350e0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 0a 20 =SQLITE_OK ){..
350f0 20 20 20 75 38 20 2a 70 4f 75 74 20 3d 20 26 70 u8 *pOut = &p
35100 53 70 61 63 65 5b 34 5d 3b 0a 20 20 20 20 75 38 Space[4];. u8
35110 20 2a 70 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d *pCell = pPage-
35120 3e 61 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 20 >apOvfl[0];.
35130 75 31 36 20 73 7a 43 65 6c 6c 20 3d 20 63 65 6c u16 szCell = cel
35140 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 lSizePtr(pPage,
35150 70 43 65 6c 6c 29 3b 0a 20 20 20 20 75 38 20 2a pCell);. u8 *
35160 70 53 74 6f 70 3b 0a 0a 20 20 20 20 61 73 73 65 pStop;.. asse
35170 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
35180 49 73 77 72 69 74 65 61 62 6c 65 28 70 4e 65 77 Iswriteable(pNew
35190 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
351a0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
351b0 3e 61 44 61 74 61 5b 30 5d 3d 3d 28 50 54 46 5f >aData[0]==(PTF_
351c0 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 44 INTKEY|PTF_LEAFD
351d0 41 54 41 7c 50 54 46 5f 4c 45 41 46 29 20 29 3b ATA|PTF_LEAF) );
351e0 0a 20 20 20 20 7a 65 72 6f 50 61 67 65 28 70 4e . zeroPage(pN
351f0 65 77 2c 20 50 54 46 5f 49 4e 54 4b 45 59 7c 50 ew, PTF_INTKEY|P
35200 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f TF_LEAFDATA|PTF_
35210 4c 45 41 46 29 3b 0a 20 20 20 20 72 65 62 75 69 LEAF);. rebui
35220 6c 64 50 61 67 65 28 70 4e 65 77 2c 20 31 2c 20 ldPage(pNew, 1,
35230 26 70 43 65 6c 6c 2c 20 26 73 7a 43 65 6c 6c 29 &pCell, &szCell)
35240 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e 46 72 65 ;. pNew->nFre
35250 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 e = pBt->usableS
35260 69 7a 65 20 2d 20 70 4e 65 77 2d 3e 63 65 6c 6c ize - pNew->cell
35270 4f 66 66 73 65 74 20 2d 20 32 20 2d 20 73 7a 43 Offset - 2 - szC
35280 65 6c 6c 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 ell;.. /* If
35290 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 6f 2d this is an auto-
352a0 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 2c vacuum database,
352b0 20 75 70 64 61 74 65 20 74 68 65 20 70 6f 69 6e update the poin
352c0 74 65 72 20 6d 61 70 0a 20 20 20 20 2a 2a 20 77 ter map. ** w
352d0 69 74 68 20 65 6e 74 72 69 65 73 20 66 6f 72 20 ith entries for
352e0 74 68 65 20 6e 65 77 20 70 61 67 65 2c 20 61 6e the new page, an
352f0 64 20 61 6e 79 20 70 6f 69 6e 74 65 72 20 66 72 d any pointer fr
35300 6f 6d 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 63 om the . ** c
35310 65 6c 6c 20 6f 6e 20 74 68 65 20 70 61 67 65 20 ell on the page
35320 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 to an overflow p
35330 61 67 65 2e 20 49 66 20 65 69 74 68 65 72 20 6f age. If either o
35340 66 20 74 68 65 73 65 0a 20 20 20 20 2a 2a 20 6f f these. ** o
35350 70 65 72 61 74 69 6f 6e 73 20 66 61 69 6c 73 2c perations fails,
35360 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 the return code
35370 20 69 73 20 73 65 74 2c 20 62 75 74 20 74 68 65 is set, but the
35380 20 63 6f 6e 74 65 6e 74 73 0a 20 20 20 20 2a 2a contents. **
35390 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 70 of the parent p
353a0 61 67 65 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 age are still ma
353b0 6e 69 70 75 6c 61 74 65 64 20 62 79 20 74 68 68 nipulated by thh
353c0 20 63 6f 64 65 20 62 65 6c 6f 77 2e 0a 20 20 20 code below..
353d0 20 2a 2a 20 54 68 61 74 20 69 73 20 4f 6b 2c 20 ** That is Ok,
353e0 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 74 68 at this point th
353f0 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 69 73 e parent page is
35400 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 0a 20 guaranteed to.
35410 20 20 20 2a 2a 20 62 65 20 6d 61 72 6b 65 64 20 ** be marked
35420 61 73 20 64 69 72 74 79 2e 20 52 65 74 75 72 6e as dirty. Return
35430 69 6e 67 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 ing an error cod
35440 65 20 77 69 6c 6c 20 63 61 75 73 65 20 61 0a 20 e will cause a.
35450 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2c 20 ** rollback,
35460 75 6e 64 6f 69 6e 67 20 61 6e 79 20 63 68 61 6e undoing any chan
35470 67 65 73 20 6d 61 64 65 20 74 6f 20 74 68 65 20 ges made to the
35480 70 61 72 65 6e 74 20 70 61 67 65 2e 0a 20 20 20 parent page..
35490 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 41 55 */. if( ISAU
354a0 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 TOVACUUM ){.
354b0 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
354c0 20 70 67 6e 6f 4e 65 77 2c 20 50 54 52 4d 41 50 pgnoNew, PTRMAP
354d0 5f 42 54 52 45 45 2c 20 70 50 61 72 65 6e 74 2d _BTREE, pParent-
354e0 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 >pgno, &rc);.
354f0 20 20 20 69 66 28 20 73 7a 43 65 6c 6c 3e 70 4e if( szCell>pN
35500 65 77 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 29 7b 0a ew->minLocal ){.
35510 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 ptrmapPu
35520 74 4f 76 66 6c 50 74 72 28 70 4e 65 77 2c 20 70 tOvflPtr(pNew, p
35530 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 20 20 20 20 Cell, &rc);.
35540 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 }. }. .
35550 20 2f 2a 20 43 72 65 61 74 65 20 61 20 64 69 76 /* Create a div
35560 69 64 65 72 20 63 65 6c 6c 20 74 6f 20 69 6e 73 ider cell to ins
35570 65 72 74 20 69 6e 74 6f 20 70 50 61 72 65 6e 74 ert into pParent
35580 2e 20 54 68 65 20 64 69 76 69 64 65 72 20 63 65 . The divider ce
35590 6c 6c 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 69 73 ll. ** consis
355a0 74 73 20 6f 66 20 61 20 34 2d 62 79 74 65 20 70 ts of a 4-byte p
355b0 61 67 65 20 6e 75 6d 62 65 72 20 28 74 68 65 20 age number (the
355c0 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 page number of p
355d0 50 61 67 65 29 20 61 6e 64 0a 20 20 20 20 2a 2a Page) and. **
355e0 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 a variable leng
355f0 74 68 20 6b 65 79 20 76 61 6c 75 65 20 28 77 68 th key value (wh
35600 69 63 68 20 6d 75 73 74 20 62 65 20 74 68 65 20 ich must be the
35610 73 61 6d 65 20 76 61 6c 75 65 20 61 73 20 74 68 same value as th
35620 65 0a 20 20 20 20 2a 2a 20 6c 61 72 67 65 73 74 e. ** largest
35630 20 6b 65 79 20 6f 6e 20 70 50 61 67 65 29 2e 0a key on pPage)..
35640 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 6f **. ** To
35650 20 66 69 6e 64 20 74 68 65 20 6c 61 72 67 65 73 find the larges
35660 74 20 6b 65 79 20 76 61 6c 75 65 20 6f 6e 20 70 t key value on p
35670 50 61 67 65 2c 20 66 69 72 73 74 20 66 69 6e 64 Page, first find
35680 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 the right-most
35690 0a 20 20 20 20 2a 2a 20 63 65 6c 6c 20 6f 6e 20 . ** cell on
356a0 70 50 61 67 65 2e 20 54 68 65 20 66 69 72 73 74 pPage. The first
356b0 20 74 77 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 two fields of t
356c0 68 69 73 20 63 65 6c 6c 20 61 72 65 20 74 68 65 his cell are the
356d0 20 0a 20 20 20 20 2a 2a 20 72 65 63 6f 72 64 2d . ** record-
356e0 6c 65 6e 67 74 68 20 28 61 20 76 61 72 69 61 62 length (a variab
356f0 6c 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 le length intege
35700 72 20 61 74 20 6d 6f 73 74 20 33 32 2d 62 69 74 r at most 32-bit
35710 73 20 69 6e 20 73 69 7a 65 29 0a 20 20 20 20 2a s in size). *
35720 2a 20 61 6e 64 20 74 68 65 20 6b 65 79 20 76 61 * and the key va
35730 6c 75 65 20 28 61 20 76 61 72 69 61 62 6c 65 20 lue (a variable
35740 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 2c 20 length integer,
35750 6d 61 79 20 68 61 76 65 20 61 6e 79 20 76 61 6c may have any val
35760 75 65 29 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 ue).. ** The
35770 66 69 72 73 74 20 6f 66 20 74 68 65 20 77 68 69 first of the whi
35780 6c 65 28 2e 2e 2e 29 20 6c 6f 6f 70 73 20 62 65 le(...) loops be
35790 6c 6f 77 20 73 6b 69 70 73 20 6f 76 65 72 20 74 low skips over t
357a0 68 65 20 72 65 63 6f 72 64 2d 6c 65 6e 67 74 68 he record-length
357b0 0a 20 20 20 20 2a 2a 20 66 69 65 6c 64 2e 20 54 . ** field. T
357c0 68 65 20 73 65 63 6f 6e 64 20 77 68 69 6c 65 28 he second while(
357d0 2e 2e 2e 29 20 6c 6f 6f 70 20 63 6f 70 69 65 73 ...) loop copies
357e0 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 20 66 the key value f
357f0 72 6f 6d 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 rom the. ** c
35800 65 6c 6c 20 6f 6e 20 70 50 61 67 65 20 69 6e 74 ell on pPage int
35810 6f 20 74 68 65 20 70 53 70 61 63 65 20 62 75 66 o the pSpace buf
35820 66 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 fer.. */.
35830 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c pCell = findCell
35840 28 70 50 61 67 65 2c 20 70 50 61 67 65 2d 3e 6e (pPage, pPage->n
35850 43 65 6c 6c 2d 31 29 3b 0a 20 20 20 20 70 53 74 Cell-1);. pSt
35860 6f 70 20 3d 20 26 70 43 65 6c 6c 5b 39 5d 3b 0a op = &pCell[9];.
35870 20 20 20 20 77 68 69 6c 65 28 20 28 2a 28 70 43 while( (*(pC
35880 65 6c 6c 2b 2b 29 26 30 78 38 30 29 20 26 26 20 ell++)&0x80) &&
35890 70 43 65 6c 6c 3c 70 53 74 6f 70 20 29 3b 0a 20 pCell<pStop );.
358a0 20 20 20 70 53 74 6f 70 20 3d 20 26 70 43 65 6c pStop = &pCel
358b0 6c 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 l[9];. while(
358c0 20 28 28 2a 28 70 4f 75 74 2b 2b 29 20 3d 20 2a ((*(pOut++) = *
358d0 28 70 43 65 6c 6c 2b 2b 29 29 26 30 78 38 30 29 (pCell++))&0x80)
358e0 20 26 26 20 70 43 65 6c 6c 3c 70 53 74 6f 70 20 && pCell<pStop
358f0 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 6e 73 65 72 );.. /* Inser
35900 74 20 74 68 65 20 6e 65 77 20 64 69 76 69 64 65 t the new divide
35910 72 20 63 65 6c 6c 20 69 6e 74 6f 20 70 50 61 72 r cell into pPar
35920 65 6e 74 2e 20 2a 2f 0a 20 20 20 20 69 6e 73 65 ent. */. inse
35930 72 74 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 rtCell(pParent,
35940 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 2c 20 pParent->nCell,
35950 70 53 70 61 63 65 2c 20 28 69 6e 74 29 28 70 4f pSpace, (int)(pO
35960 75 74 2d 70 53 70 61 63 65 29 2c 0a 20 20 20 20 ut-pSpace),.
35970 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 70 50 0, pP
35980 61 67 65 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b age->pgno, &rc);
35990 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 68 65 .. /* Set the
359a0 20 72 69 67 68 74 2d 63 68 69 6c 64 20 70 6f 69 right-child poi
359b0 6e 74 65 72 20 6f 66 20 70 50 61 72 65 6e 74 20 nter of pParent
359c0 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 to point to the
359d0 6e 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 new page. */.
359e0 20 70 75 74 34 62 79 74 65 28 26 70 50 61 72 65 put4byte(&pPare
359f0 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e nt->aData[pParen
35a00 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 2c t->hdrOffset+8],
35a10 20 70 67 6e 6f 4e 65 77 29 3b 0a 20 20 0a 20 20 pgnoNew);. .
35a20 20 20 2f 2a 20 52 65 6c 65 61 73 65 20 74 68 65 /* Release the
35a30 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 reference to th
35a40 65 20 6e 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 e new page. */.
35a50 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
35a60 4e 65 77 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 New);. }.. ret
35a70 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 urn rc;.}.#endif
35a80 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
35a90 51 55 49 43 4b 42 41 4c 41 4e 43 45 20 2a 2f 0a QUICKBALANCE */.
35aa0 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 54 68 69 .#if 0./*.** Thi
35ab0 73 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 s function does
35ac0 6e 6f 74 20 63 6f 6e 74 72 69 62 75 74 65 20 61 not contribute a
35ad0 6e 79 74 68 69 6e 67 20 74 6f 20 74 68 65 20 6f nything to the o
35ae0 70 65 72 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 peration of SQLi
35af0 74 65 2e 0a 2a 2a 20 69 74 20 69 73 20 73 6f 6d te..** it is som
35b00 65 74 69 6d 65 73 20 61 63 74 69 76 61 74 65 64 etimes activated
35b10 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 77 68 69 temporarily whi
35b20 6c 65 20 64 65 62 75 67 67 69 6e 67 20 63 6f 64 le debugging cod
35b30 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 0a 2a e responsible .*
35b40 2a 20 66 6f 72 20 73 65 74 74 69 6e 67 20 70 6f * for setting po
35b50 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 inter-map entrie
35b60 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 s..*/.static int
35b70 20 70 74 72 6d 61 70 43 68 65 63 6b 50 61 67 65 ptrmapCheckPage
35b80 73 28 4d 65 6d 50 61 67 65 20 2a 2a 61 70 50 61 s(MemPage **apPa
35b90 67 65 2c 20 69 6e 74 20 6e 50 61 67 65 29 7b 0a ge, int nPage){.
35ba0 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 66 6f int i, j;. fo
35bb0 72 28 69 3d 30 3b 20 69 3c 6e 50 61 67 65 3b 20 r(i=0; i<nPage;
35bc0 69 2b 2b 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e i++){. Pgno n
35bd0 3b 0a 20 20 20 20 75 38 20 65 3b 0a 20 20 20 20 ;. u8 e;.
35be0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
35bf0 20 61 70 50 61 67 65 5b 69 5d 3b 0a 20 20 20 20 apPage[i];.
35c00 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
35c10 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 20 20 pPage->pBt;.
35c20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 assert( pPage->i
35c30 73 49 6e 69 74 20 29 3b 0a 0a 20 20 20 20 66 6f sInit );.. fo
35c40 72 28 6a 3d 30 3b 20 6a 3c 70 50 61 67 65 2d 3e r(j=0; j<pPage->
35c50 6e 43 65 6c 6c 3b 20 6a 2b 2b 29 7b 0a 20 20 20 nCell; j++){.
35c60 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f CellInfo info
35c70 3b 0a 20 20 20 20 20 20 75 38 20 2a 7a 3b 0a 20 ;. u8 *z;.
35c80 20 20 20 20 0a 20 20 20 20 20 20 7a 20 3d 20 66 . z = f
35c90 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 6a indCell(pPage, j
35ca0 29 3b 0a 20 20 20 20 20 20 62 74 72 65 65 50 61 );. btreePa
35cb0 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 rseCellPtr(pPage
35cc0 2c 20 7a 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 , z, &info);.
35cd0 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 65 if( info.iOve
35ce0 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 rflow ){.
35cf0 20 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 Pgno ovfl = get
35d00 34 62 79 74 65 28 26 7a 5b 69 6e 66 6f 2e 69 4f 4byte(&z[info.iO
35d10 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 20 20 20 verflow]);.
35d20 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 ptrmapGet(pBt
35d30 2c 20 6f 76 66 6c 2c 20 26 65 2c 20 26 6e 29 3b , ovfl, &e, &n);
35d40 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
35d50 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 n==pPage->pgno
35d60 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 && e==PTRMAP_OVE
35d70 52 46 4c 4f 57 31 20 29 3b 0a 20 20 20 20 20 20 RFLOW1 );.
35d80 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 61 }. if( !pPa
35d90 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
35da0 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 20 3d Pgno child =
35db0 20 67 65 74 34 62 79 74 65 28 7a 29 3b 0a 20 20 get4byte(z);.
35dc0 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 ptrmapGet(
35dd0 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 pBt, child, &e,
35de0 26 6e 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 &n);. ass
35df0 65 72 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 ert( n==pPage->p
35e00 67 6e 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 gno && e==PTRMAP
35e10 5f 42 54 52 45 45 20 29 3b 0a 20 20 20 20 20 20 _BTREE );.
35e20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
35e30 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a !pPage->leaf ){.
35e40 20 20 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 Pgno child
35e50 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 = get4byte(&pPa
35e60 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d ge->aData[pPage-
35e70 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a >hdrOffset+8]);.
35e80 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 ptrmapGet(
35e90 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 pBt, child, &e,
35ea0 26 6e 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 &n);. asser
35eb0 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e t( n==pPage->pgn
35ec0 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 42 o && e==PTRMAP_B
35ed0 54 52 45 45 20 29 3b 0a 20 20 20 20 7d 0a 20 20 TREE );. }.
35ee0 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a }. return 1;.}.
35ef0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
35f00 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 is function is u
35f10 73 65 64 20 74 6f 20 63 6f 70 79 20 74 68 65 20 sed to copy the
35f20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
35f30 62 2d 74 72 65 65 20 6e 6f 64 65 20 73 74 6f 72 b-tree node stor
35f40 65 64 20 0a 2a 2a 20 6f 6e 20 70 61 67 65 20 70 ed .** on page p
35f50 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 70 54 6f From to page pTo
35f60 2e 20 49 66 20 70 61 67 65 20 70 46 72 6f 6d 20 . If page pFrom
35f70 77 61 73 20 6e 6f 74 20 61 20 6c 65 61 66 20 70 was not a leaf p
35f80 61 67 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 age, then.** the
35f90 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 pointer-map ent
35fa0 72 69 65 73 20 66 6f 72 20 65 61 63 68 20 63 68 ries for each ch
35fb0 69 6c 64 20 70 61 67 65 20 61 72 65 20 75 70 64 ild page are upd
35fc0 61 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 ated so that the
35fd0 0a 2a 2a 20 70 61 72 65 6e 74 20 70 61 67 65 20 .** parent page
35fe0 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 70 6f stored in the po
35ff0 69 6e 74 65 72 20 6d 61 70 20 69 73 20 70 61 67 inter map is pag
36000 65 20 70 54 6f 2e 20 49 66 20 70 46 72 6f 6d 20 e pTo. If pFrom
36010 63 6f 6e 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 79 contained.** any
36020 20 63 65 6c 6c 73 20 77 69 74 68 20 6f 76 65 72 cells with over
36030 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 flow page pointe
36040 72 73 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 72 rs, then the cor
36050 72 65 73 70 6f 6e 64 69 6e 67 20 70 6f 69 6e 74 responding point
36060 65 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 69 65 er.** map entrie
36070 73 20 61 72 65 20 61 6c 73 6f 20 75 70 64 61 74 s are also updat
36080 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 20 70 ed so that the p
36090 61 72 65 6e 74 20 70 61 67 65 20 69 73 20 70 61 arent page is pa
360a0 67 65 20 70 54 6f 2e 0a 2a 2a 0a 2a 2a 20 49 66 ge pTo..**.** If
360b0 20 70 46 72 6f 6d 20 69 73 20 63 75 72 72 65 6e pFrom is curren
360c0 74 6c 79 20 63 61 72 72 79 69 6e 67 20 61 6e 79 tly carrying any
360d0 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 overflow cells
360e0 28 65 6e 74 72 69 65 73 20 69 6e 20 74 68 65 0a (entries in the.
360f0 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 70 4f 76 66 ** MemPage.apOvf
36100 6c 5b 5d 20 61 72 72 61 79 29 2c 20 74 68 65 79 l[] array), they
36110 20 61 72 65 20 6e 6f 74 20 63 6f 70 69 65 64 20 are not copied
36120 74 6f 20 70 54 6f 2e 20 0a 2a 2a 0a 2a 2a 20 42 to pTo. .**.** B
36130 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2c efore returning,
36140 20 70 61 67 65 20 70 54 6f 20 69 73 20 72 65 69 page pTo is rei
36150 6e 69 74 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 nitialized using
36160 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 btreeInitPage()
36170 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 65 72 66 ..**.** The perf
36180 6f 72 6d 61 6e 63 65 20 6f 66 20 74 68 69 73 20 ormance of this
36190 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 function is not
361a0 63 72 69 74 69 63 61 6c 2e 20 49 74 20 69 73 20 critical. It is
361b0 6f 6e 6c 79 20 75 73 65 64 20 62 79 20 0a 2a 2a only used by .**
361c0 20 74 68 65 20 62 61 6c 61 6e 63 65 5f 73 68 61 the balance_sha
361d0 6c 6c 6f 77 65 72 28 29 20 61 6e 64 20 62 61 6c llower() and bal
361e0 61 6e 63 65 5f 64 65 65 70 65 72 28 29 20 70 72 ance_deeper() pr
361f0 6f 63 65 64 75 72 65 73 2c 20 6e 65 69 74 68 65 ocedures, neithe
36200 72 20 6f 66 0a 2a 2a 20 77 68 69 63 68 20 61 72 r of.** which ar
36210 65 20 63 61 6c 6c 65 64 20 6f 66 74 65 6e 20 75 e called often u
36220 6e 64 65 72 20 6e 6f 72 6d 61 6c 20 63 69 72 63 nder normal circ
36230 75 6d 73 74 61 6e 63 65 73 2e 0a 2a 2f 0a 73 74 umstances..*/.st
36240 61 74 69 63 20 76 6f 69 64 20 63 6f 70 79 4e 6f atic void copyNo
36250 64 65 43 6f 6e 74 65 6e 74 28 4d 65 6d 50 61 67 deContent(MemPag
36260 65 20 2a 70 46 72 6f 6d 2c 20 4d 65 6d 50 61 67 e *pFrom, MemPag
36270 65 20 2a 70 54 6f 2c 20 69 6e 74 20 2a 70 52 43 e *pTo, int *pRC
36280 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 29 3d ){. if( (*pRC)=
36290 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
362a0 20 20 42 74 53 68 61 72 65 64 20 2a 20 63 6f 6e BtShared * con
362b0 73 74 20 70 42 74 20 3d 20 70 46 72 6f 6d 2d 3e st pBt = pFrom->
362c0 70 42 74 3b 0a 20 20 20 20 75 38 20 2a 20 63 6f pBt;. u8 * co
362d0 6e 73 74 20 61 46 72 6f 6d 20 3d 20 70 46 72 6f nst aFrom = pFro
362e0 6d 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 75 38 m->aData;. u8
362f0 20 2a 20 63 6f 6e 73 74 20 61 54 6f 20 3d 20 70 * const aTo = p
36300 54 6f 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 69 To->aData;. i
36310 6e 74 20 63 6f 6e 73 74 20 69 46 72 6f 6d 48 64 nt const iFromHd
36320 72 20 3d 20 70 46 72 6f 6d 2d 3e 68 64 72 4f 66 r = pFrom->hdrOf
36330 66 73 65 74 3b 0a 20 20 20 20 69 6e 74 20 63 6f fset;. int co
36340 6e 73 74 20 69 54 6f 48 64 72 20 3d 20 28 28 70 nst iToHdr = ((p
36350 54 6f 2d 3e 70 67 6e 6f 3d 3d 31 29 20 3f 20 31 To->pgno==1) ? 1
36360 30 30 20 3a 20 30 29 3b 0a 20 20 20 20 69 6e 74 00 : 0);. int
36370 20 72 63 3b 0a 20 20 20 20 69 6e 74 20 69 44 61 rc;. int iDa
36380 74 61 3b 0a 20 20 0a 20 20 0a 20 20 20 20 61 73 ta;. . . as
36390 73 65 72 74 28 20 70 46 72 6f 6d 2d 3e 69 73 49 sert( pFrom->isI
363a0 6e 69 74 20 29 3b 0a 20 20 20 20 61 73 73 65 72 nit );. asser
363b0 74 28 20 70 46 72 6f 6d 2d 3e 6e 46 72 65 65 3e t( pFrom->nFree>
363c0 3d 69 54 6f 48 64 72 20 29 3b 0a 20 20 20 20 61 =iToHdr );. a
363d0 73 73 65 72 74 28 20 67 65 74 32 62 79 74 65 28 ssert( get2byte(
363e0 26 61 46 72 6f 6d 5b 69 46 72 6f 6d 48 64 72 2b &aFrom[iFromHdr+
363f0 35 5d 29 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 5]) <= (int)pBt-
36400 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 >usableSize );.
36410 20 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 74 68 . /* Copy th
36420 65 20 62 2d 74 72 65 65 20 6e 6f 64 65 20 63 6f e b-tree node co
36430 6e 74 65 6e 74 20 66 72 6f 6d 20 70 61 67 65 20 ntent from page
36440 70 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 70 54 pFrom to page pT
36450 6f 2e 20 2a 2f 0a 20 20 20 20 69 44 61 74 61 20 o. */. iData
36460 3d 20 67 65 74 32 62 79 74 65 28 26 61 46 72 6f = get2byte(&aFro
36470 6d 5b 69 46 72 6f 6d 48 64 72 2b 35 5d 29 3b 0a m[iFromHdr+5]);.
36480 20 20 20 20 6d 65 6d 63 70 79 28 26 61 54 6f 5b memcpy(&aTo[
36490 69 44 61 74 61 5d 2c 20 26 61 46 72 6f 6d 5b 69 iData], &aFrom[i
364a0 44 61 74 61 5d 2c 20 70 42 74 2d 3e 75 73 61 62 Data], pBt->usab
364b0 6c 65 53 69 7a 65 2d 69 44 61 74 61 29 3b 0a 20 leSize-iData);.
364c0 20 20 20 6d 65 6d 63 70 79 28 26 61 54 6f 5b 69 memcpy(&aTo[i
364d0 54 6f 48 64 72 5d 2c 20 26 61 46 72 6f 6d 5b 69 ToHdr], &aFrom[i
364e0 46 72 6f 6d 48 64 72 5d 2c 20 70 46 72 6f 6d 2d FromHdr], pFrom-
364f0 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a >cellOffset + 2*
36500 70 46 72 6f 6d 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 pFrom->nCell);.
36510 20 0a 20 20 20 20 2f 2a 20 52 65 69 6e 69 74 69 . /* Reiniti
36520 61 6c 69 7a 65 20 70 61 67 65 20 70 54 6f 20 73 alize page pTo s
36530 6f 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74 65 o that the conte
36540 6e 74 73 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 nts of the MemPa
36550 67 65 20 73 74 72 75 63 74 75 72 65 0a 20 20 20 ge structure.
36560 20 2a 2a 20 6d 61 74 63 68 20 74 68 65 20 6e 65 ** match the ne
36570 77 20 64 61 74 61 2e 20 54 68 65 20 69 6e 69 74 w data. The init
36580 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 70 54 ialization of pT
36590 6f 20 63 61 6e 20 61 63 74 75 61 6c 6c 79 20 66 o can actually f
365a0 61 69 6c 20 75 6e 64 65 72 0a 20 20 20 20 2a 2a ail under. **
365b0 20 66 61 69 72 6c 79 20 6f 62 73 63 75 72 65 20 fairly obscure
365c0 63 69 72 63 75 6d 73 74 61 6e 63 65 73 2c 20 65 circumstances, e
365d0 76 65 6e 20 74 68 6f 75 67 68 20 69 74 20 69 73 ven though it is
365e0 20 61 20 63 6f 70 79 20 6f 66 20 69 6e 69 74 69 a copy of initi
365f0 61 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a 20 70 alized . ** p
36600 61 67 65 20 70 46 72 6f 6d 2e 0a 20 20 20 20 2a age pFrom.. *
36610 2f 0a 20 20 20 20 70 54 6f 2d 3e 69 73 49 6e 69 /. pTo->isIni
36620 74 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 t = 0;. rc =
36630 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 54 btreeInitPage(pT
36640 6f 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d o);. if( rc!=
36650 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
36660 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 *pRC = rc;.
36670 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 return;.
36680 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 }. . /* If t
36690 68 69 73 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 his is an auto-v
366a0 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 2c 20 acuum database,
366b0 75 70 64 61 74 65 20 74 68 65 20 70 6f 69 6e 74 update the point
366c0 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 0a 20 er-map entries.
366d0 20 20 20 2a 2a 20 66 6f 72 20 61 6e 79 20 62 2d ** for any b-
366e0 74 72 65 65 20 6f 72 20 6f 76 65 72 66 6c 6f 77 tree or overflow
366f0 20 70 61 67 65 73 20 74 68 61 74 20 70 54 6f 20 pages that pTo
36700 6e 6f 77 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 now contains the
36710 20 70 6f 69 6e 74 65 72 73 20 74 6f 2e 0a 20 20 pointers to..
36720 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 41 */. if( ISA
36730 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 UTOVACUUM ){.
36740 20 20 20 2a 70 52 43 20 3d 20 73 65 74 43 68 69 *pRC = setChi
36750 6c 64 50 74 72 6d 61 70 73 28 70 54 6f 29 3b 0a ldPtrmaps(pTo);.
36760 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a }. }.}../*.
36770 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
36780 72 65 64 69 73 74 72 69 62 75 74 65 73 20 63 65 redistributes ce
36790 6c 6c 73 20 6f 6e 20 74 68 65 20 69 50 61 72 65 lls on the iPare
367a0 6e 74 49 64 78 27 74 68 20 63 68 69 6c 64 20 6f ntIdx'th child o
367b0 66 20 70 50 61 72 65 6e 74 0a 2a 2a 20 28 68 65 f pParent.** (he
367c0 72 65 61 66 74 65 72 20 22 74 68 65 20 70 61 67 reafter "the pag
367d0 65 22 29 20 61 6e 64 20 75 70 20 74 6f 20 32 20 e") and up to 2
367e0 73 69 62 6c 69 6e 67 73 20 73 6f 20 74 68 61 74 siblings so that
367f0 20 61 6c 6c 20 70 61 67 65 73 20 68 61 76 65 20 all pages have
36800 61 62 6f 75 74 20 74 68 65 0a 2a 2a 20 73 61 6d about the.** sam
36810 65 20 61 6d 6f 75 6e 74 20 6f 66 20 66 72 65 65 e amount of free
36820 20 73 70 61 63 65 2e 20 55 73 75 61 6c 6c 79 20 space. Usually
36830 61 20 73 69 6e 67 6c 65 20 73 69 62 6c 69 6e 67 a single sibling
36840 20 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 20 on either side
36850 6f 66 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 61 of the.** page a
36860 72 65 20 75 73 65 64 20 69 6e 20 74 68 65 20 62 re used in the b
36870 61 6c 61 6e 63 69 6e 67 2c 20 74 68 6f 75 67 68 alancing, though
36880 20 62 6f 74 68 20 73 69 62 6c 69 6e 67 73 20 6d both siblings m
36890 69 67 68 74 20 63 6f 6d 65 20 66 72 6f 6d 20 6f ight come from o
368a0 6e 65 0a 2a 2a 20 73 69 64 65 20 69 66 20 74 68 ne.** side if th
368b0 65 20 70 61 67 65 20 69 73 20 74 68 65 20 66 69 e page is the fi
368c0 72 73 74 20 6f 72 20 6c 61 73 74 20 63 68 69 6c rst or last chil
368d0 64 20 6f 66 20 69 74 73 20 70 61 72 65 6e 74 2e d of its parent.
368e0 20 49 66 20 74 68 65 20 70 61 67 65 20 0a 2a 2a If the page .**
368f0 20 68 61 73 20 66 65 77 65 72 20 74 68 61 6e 20 has fewer than
36900 32 20 73 69 62 6c 69 6e 67 73 20 28 73 6f 6d 65 2 siblings (some
36910 74 68 69 6e 67 20 77 68 69 63 68 20 63 61 6e 20 thing which can
36920 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 74 only happen if t
36930 68 65 20 70 61 67 65 0a 2a 2a 20 69 73 20 61 20 he page.** is a
36940 72 6f 6f 74 20 70 61 67 65 20 6f 72 20 61 20 63 root page or a c
36950 68 69 6c 64 20 6f 66 20 61 20 72 6f 6f 74 20 70 hild of a root p
36960 61 67 65 29 20 74 68 65 6e 20 61 6c 6c 20 61 76 age) then all av
36970 61 69 6c 61 62 6c 65 20 73 69 62 6c 69 6e 67 73 ailable siblings
36980 0a 2a 2a 20 70 61 72 74 69 63 69 70 61 74 65 20 .** participate
36990 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 in the balancing
369a0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 ..**.** The numb
369b0 65 72 20 6f 66 20 73 69 62 6c 69 6e 67 73 20 6f er of siblings o
369c0 66 20 74 68 65 20 70 61 67 65 20 6d 69 67 68 74 f the page might
369d0 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 6f 72 be increased or
369e0 20 64 65 63 72 65 61 73 65 64 20 62 79 20 0a 2a decreased by .*
369f0 2a 20 6f 6e 65 20 6f 72 20 74 77 6f 20 69 6e 20 * one or two in
36a00 61 6e 20 65 66 66 6f 72 74 20 74 6f 20 6b 65 65 an effort to kee
36a10 70 20 70 61 67 65 73 20 6e 65 61 72 6c 79 20 66 p pages nearly f
36a20 75 6c 6c 20 62 75 74 20 6e 6f 74 20 6f 76 65 72 ull but not over
36a30 20 66 75 6c 6c 2e 20 0a 2a 2a 0a 2a 2a 20 4e 6f full. .**.** No
36a40 74 65 20 74 68 61 74 20 77 68 65 6e 20 74 68 69 te that when thi
36a50 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
36a60 6c 65 64 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 led, some of the
36a70 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 61 cells on the pa
36a80 67 65 0a 2a 2a 20 6d 69 67 68 74 20 6e 6f 74 20 ge.** might not
36a90 61 63 74 75 61 6c 6c 79 20 62 65 20 73 74 6f 72 actually be stor
36aa0 65 64 20 69 6e 20 4d 65 6d 50 61 67 65 2e 61 44 ed in MemPage.aD
36ab0 61 74 61 5b 5d 2e 20 54 68 69 73 20 63 61 6e 20 ata[]. This can
36ac0 68 61 70 70 65 6e 0a 2a 2a 20 69 66 20 74 68 65 happen.** if the
36ad0 20 70 61 67 65 20 69 73 20 6f 76 65 72 66 75 6c page is overful
36ae0 6c 2e 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 l. This routine
36af0 65 6e 73 75 72 65 73 20 74 68 61 74 20 61 6c 6c ensures that all
36b00 20 63 65 6c 6c 73 20 61 6c 6c 6f 63 61 74 65 64 cells allocated
36b10 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 65 20 .** to the page
36b20 61 6e 64 20 69 74 73 20 73 69 62 6c 69 6e 67 73 and its siblings
36b30 20 66 69 74 20 69 6e 74 6f 20 4d 65 6d 50 61 67 fit into MemPag
36b40 65 2e 61 44 61 74 61 5b 5d 20 62 65 66 6f 72 65 e.aData[] before
36b50 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a returning..**.*
36b60 2a 20 49 6e 20 74 68 65 20 63 6f 75 72 73 65 20 * In the course
36b70 6f 66 20 62 61 6c 61 6e 63 69 6e 67 20 74 68 65 of balancing the
36b80 20 70 61 67 65 20 61 6e 64 20 69 74 73 20 73 69 page and its si
36b90 62 6c 69 6e 67 73 2c 20 63 65 6c 6c 73 20 6d 61 blings, cells ma
36ba0 79 20 62 65 0a 2a 2a 20 69 6e 73 65 72 74 65 64 y be.** inserted
36bb0 20 69 6e 74 6f 20 6f 72 20 72 65 6d 6f 76 65 64 into or removed
36bc0 20 66 72 6f 6d 20 74 68 65 20 70 61 72 65 6e 74 from the parent
36bd0 20 70 61 67 65 20 28 70 50 61 72 65 6e 74 29 2e page (pParent).
36be0 20 44 6f 69 6e 67 20 73 6f 0a 2a 2a 20 6d 61 79 Doing so.** may
36bf0 20 63 61 75 73 65 20 74 68 65 20 70 61 72 65 6e cause the paren
36c00 74 20 70 61 67 65 20 74 6f 20 62 65 63 6f 6d 65 t page to become
36c10 20 6f 76 65 72 66 75 6c 6c 20 6f 72 20 75 6e 64 overfull or und
36c20 65 72 66 75 6c 6c 2e 20 49 66 20 74 68 69 73 0a erfull. If this.
36c30 2a 2a 20 68 61 70 70 65 6e 73 2c 20 69 74 20 69 ** happens, it i
36c40 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 s the responsibi
36c50 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c lity of the call
36c60 65 72 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 er to invoke the
36c70 20 63 6f 72 72 65 63 74 0a 2a 2a 20 62 61 6c 61 correct.** bala
36c80 6e 63 69 6e 67 20 72 6f 75 74 69 6e 65 20 74 6f ncing routine to
36c90 20 66 69 78 20 74 68 69 73 20 70 72 6f 62 6c 65 fix this proble
36ca0 6d 20 28 73 65 65 20 74 68 65 20 62 61 6c 61 6e m (see the balan
36cb0 63 65 28 29 20 72 6f 75 74 69 6e 65 29 2e 20 0a ce() routine). .
36cc0 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f **.** If this ro
36cd0 75 74 69 6e 65 20 66 61 69 6c 73 20 66 6f 72 20 utine fails for
36ce0 61 6e 79 20 72 65 61 73 6f 6e 2c 20 69 74 20 6d any reason, it m
36cf0 69 67 68 74 20 6c 65 61 76 65 20 74 68 65 20 64 ight leave the d
36d00 61 74 61 62 61 73 65 0a 2a 2a 20 69 6e 20 61 20 atabase.** in a
36d10 63 6f 72 72 75 70 74 65 64 20 73 74 61 74 65 2e corrupted state.
36d20 20 53 6f 20 69 66 20 74 68 69 73 20 72 6f 75 74 So if this rout
36d30 69 6e 65 20 66 61 69 6c 73 2c 20 74 68 65 20 64 ine fails, the d
36d40 61 74 61 62 61 73 65 20 73 68 6f 75 6c 64 0a 2a atabase should.*
36d50 2a 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b * be rolled back
36d60 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74 68 69 72 ..**.** The thir
36d70 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 d argument to th
36d80 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 61 4f 76 is function, aOv
36d90 66 6c 53 70 61 63 65 2c 20 69 73 20 61 20 70 6f flSpace, is a po
36da0 69 6e 74 65 72 20 74 6f 20 61 0a 2a 2a 20 62 75 inter to a.** bu
36db0 66 66 65 72 20 62 69 67 20 65 6e 6f 75 67 68 20 ffer big enough
36dc0 74 6f 20 68 6f 6c 64 20 6f 6e 65 20 70 61 67 65 to hold one page
36dd0 2e 20 49 66 20 77 68 69 6c 65 20 69 6e 73 65 72 . If while inser
36de0 74 69 6e 67 20 63 65 6c 6c 73 20 69 6e 74 6f 20 ting cells into
36df0 74 68 65 20 70 61 72 65 6e 74 0a 2a 2a 20 70 61 the parent.** pa
36e00 67 65 20 28 70 50 61 72 65 6e 74 29 20 74 68 65 ge (pParent) the
36e10 20 70 61 72 65 6e 74 20 70 61 67 65 20 62 65 63 parent page bec
36e20 6f 6d 65 73 20 6f 76 65 72 66 75 6c 6c 2c 20 74 omes overfull, t
36e30 68 69 73 20 62 75 66 66 65 72 20 69 73 0a 2a 2a his buffer is.**
36e40 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 used to store t
36e50 68 65 20 70 61 72 65 6e 74 27 73 20 6f 76 65 72 he parent's over
36e60 66 6c 6f 77 20 63 65 6c 6c 73 2e 20 42 65 63 61 flow cells. Beca
36e70 75 73 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f use this functio
36e80 6e 20 69 6e 73 65 72 74 73 0a 2a 2a 20 61 20 6d n inserts.** a m
36e90 61 78 69 6d 75 6d 20 6f 66 20 66 6f 75 72 20 64 aximum of four d
36ea0 69 76 69 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 ivider cells int
36eb0 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 o the parent pag
36ec0 65 2c 20 61 6e 64 20 74 68 65 20 6d 61 78 69 6d e, and the maxim
36ed0 75 6d 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 61 20 um.** size of a
36ee0 63 65 6c 6c 20 73 74 6f 72 65 64 20 77 69 74 68 cell stored with
36ef0 69 6e 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 6e in an internal n
36f00 6f 64 65 20 69 73 20 61 6c 77 61 79 73 20 6c 65 ode is always le
36f10 73 73 20 74 68 61 6e 20 31 2f 34 0a 2a 2a 20 6f ss than 1/4.** o
36f20 66 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 2c f the page-size,
36f30 20 74 68 65 20 61 4f 76 66 6c 53 70 61 63 65 5b the aOvflSpace[
36f40 5d 20 62 75 66 66 65 72 20 69 73 20 67 75 61 72 ] buffer is guar
36f50 61 6e 74 65 65 64 20 74 6f 20 62 65 20 6c 61 72 anteed to be lar
36f60 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 66 6f 72 ge.** enough for
36f70 20 61 6c 6c 20 6f 76 65 72 66 6c 6f 77 20 63 65 all overflow ce
36f80 6c 6c 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 4f lls..**.** If aO
36f90 76 66 6c 53 70 61 63 65 20 69 73 20 73 65 74 20 vflSpace is set
36fa0 74 6f 20 61 20 6e 75 6c 6c 20 70 6f 69 6e 74 65 to a null pointe
36fb0 72 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e r, this function
36fc0 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 53 51 4c returns .** SQL
36fd0 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f 0a 23 69 ITE_NOMEM..*/.#i
36fe0 66 20 64 65 66 69 6e 65 64 28 5f 4d 53 43 5f 56 f defined(_MSC_V
36ff0 45 52 29 20 26 26 20 5f 4d 53 43 5f 56 45 52 20 ER) && _MSC_VER
37000 3e 3d 20 31 37 30 30 20 26 26 20 64 65 66 69 6e >= 1700 && defin
37010 65 64 28 5f 4d 5f 41 52 4d 29 0a 23 70 72 61 67 ed(_M_ARM).#prag
37020 6d 61 20 6f 70 74 69 6d 69 7a 65 28 22 22 2c 20 ma optimize("",
37030 6f 66 66 29 0a 23 65 6e 64 69 66 0a 73 74 61 74 off).#endif.stat
37040 69 63 20 69 6e 74 20 62 61 6c 61 6e 63 65 5f 6e ic int balance_n
37050 6f 6e 72 6f 6f 74 28 0a 20 20 4d 65 6d 50 61 67 onroot(. MemPag
37060 65 20 2a 70 50 61 72 65 6e 74 2c 20 20 20 20 20 e *pParent,
37070 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 /* Par
37080 65 6e 74 20 70 61 67 65 20 6f 66 20 73 69 62 6c ent page of sibl
37090 69 6e 67 73 20 62 65 69 6e 67 20 62 61 6c 61 6e ings being balan
370a0 63 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 50 61 ced */. int iPa
370b0 72 65 6e 74 49 64 78 2c 20 20 20 20 20 20 20 20 rentIdx,
370c0 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 /* Inde
370d0 78 20 6f 66 20 22 74 68 65 20 70 61 67 65 22 20 x of "the page"
370e0 69 6e 20 70 50 61 72 65 6e 74 20 2a 2f 0a 20 20 in pParent */.
370f0 75 38 20 2a 61 4f 76 66 6c 53 70 61 63 65 2c 20 u8 *aOvflSpace,
37100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37110 2f 2a 20 70 61 67 65 2d 73 69 7a 65 20 62 79 74 /* page-size byt
37120 65 73 20 6f 66 20 73 70 61 63 65 20 66 6f 72 20 es of space for
37130 70 61 72 65 6e 74 20 6f 76 66 6c 20 2a 2f 0a 20 parent ovfl */.
37140 20 69 6e 74 20 69 73 52 6f 6f 74 2c 20 20 20 20 int isRoot,
37150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37160 20 2f 2a 20 54 72 75 65 20 69 66 20 70 50 61 72 /* True if pPar
37170 65 6e 74 20 69 73 20 61 20 72 6f 6f 74 2d 70 61 ent is a root-pa
37180 67 65 20 2a 2f 0a 20 20 69 6e 74 20 62 42 75 6c ge */. int bBul
37190 6b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k
371a0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
371b0 69 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 if this call is
371c0 70 61 72 74 20 6f 66 20 61 20 62 75 6c 6b 20 6c part of a bulk l
371d0 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 oad */.){. BtSh
371e0 61 72 65 64 20 2a 70 42 74 3b 20 20 20 20 20 20 ared *pBt;
371f0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
37200 77 68 6f 6c 65 20 64 61 74 61 62 61 73 65 20 2a whole database *
37210 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 /. int nCell =
37220 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
37230 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 /* Number of ce
37240 6c 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 lls in apCell[]
37250 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 43 65 6c */. int nMaxCel
37260 6c 73 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 ls = 0;
37270 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 /* Allocated s
37280 69 7a 65 20 6f 66 20 61 70 43 65 6c 6c 2c 20 73 ize of apCell, s
37290 7a 43 65 6c 6c 2c 20 61 46 72 6f 6d 2e 20 2a 2f zCell, aFrom. */
372a0 0a 20 20 69 6e 74 20 6e 4e 65 77 20 3d 20 30 3b . int nNew = 0;
372b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
372c0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
372d0 65 73 20 69 6e 20 61 70 4e 65 77 5b 5d 20 2a 2f es in apNew[] */
372e0 0a 20 20 69 6e 74 20 6e 4f 6c 64 3b 20 20 20 20 . int nOld;
372f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37300 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
37310 65 73 20 69 6e 20 61 70 4f 6c 64 5b 5d 20 2a 2f es in apOld[] */
37320 0a 20 20 69 6e 74 20 69 2c 20 6a 2c 20 6b 3b 20 . int i, j, k;
37330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37340 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 73 /* Loop counters
37350 20 2a 2f 0a 20 20 69 6e 74 20 6e 78 44 69 76 3b */. int nxDiv;
37360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37370 20 20 20 2f 2a 20 4e 65 78 74 20 64 69 76 69 64 /* Next divid
37380 65 72 20 73 6c 6f 74 20 69 6e 20 70 50 61 72 65 er slot in pPare
37390 6e 74 2d 3e 61 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 nt->aCell[] */.
373a0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
373b0 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a _OK; /*
373c0 20 54 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 The return code
373d0 20 2a 2f 0a 20 20 75 31 36 20 6c 65 61 66 43 6f */. u16 leafCo
373e0 72 72 65 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 rrection;
373f0 20 20 20 2f 2a 20 34 20 69 66 20 70 50 61 67 65 /* 4 if pPage
37400 20 69 73 20 61 20 6c 65 61 66 2e 20 20 30 20 69 is a leaf. 0 i
37410 66 20 6e 6f 74 20 2a 2f 0a 20 20 69 6e 74 20 6c f not */. int l
37420 65 61 66 44 61 74 61 3b 20 20 20 20 20 20 20 20 eafData;
37430 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
37440 69 66 20 70 50 61 67 65 20 69 73 20 61 20 6c 65 if pPage is a le
37450 61 66 20 6f 66 20 61 20 4c 45 41 46 44 41 54 41 af of a LEAFDATA
37460 20 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 75 tree */. int u
37470 73 61 62 6c 65 53 70 61 63 65 3b 20 20 20 20 20 sableSpace;
37480 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 /* Bytes
37490 20 69 6e 20 70 50 61 67 65 20 62 65 79 6f 6e 64 in pPage beyond
374a0 20 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 the header */.
374b0 20 69 6e 74 20 70 61 67 65 46 6c 61 67 73 3b 20 int pageFlags;
374c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
374d0 20 56 61 6c 75 65 20 6f 66 20 70 50 61 67 65 2d Value of pPage-
374e0 3e 61 44 61 74 61 5b 30 5d 20 2a 2f 0a 20 20 69 >aData[0] */. i
374f0 6e 74 20 73 75 62 74 6f 74 61 6c 3b 20 20 20 20 nt subtotal;
37500 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
37510 75 62 74 6f 74 61 6c 20 6f 66 20 62 79 74 65 73 ubtotal of bytes
37520 20 69 6e 20 63 65 6c 6c 73 20 6f 6e 20 6f 6e 65 in cells on one
37530 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 69 page */. int i
37540 53 70 61 63 65 31 20 3d 20 30 3b 20 20 20 20 20 Space1 = 0;
37550 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
37560 20 75 6e 75 73 65 64 20 62 79 74 65 20 6f 66 20 unused byte of
37570 61 53 70 61 63 65 31 5b 5d 20 2a 2f 0a 20 20 69 aSpace1[] */. i
37580 6e 74 20 69 4f 76 66 6c 53 70 61 63 65 20 3d 20 nt iOvflSpace =
37590 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 0; /* F
375a0 69 72 73 74 20 75 6e 75 73 65 64 20 62 79 74 65 irst unused byte
375b0 20 6f 66 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d of aOvflSpace[]
375c0 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 63 72 61 */. int szScra
375d0 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 tch;
375e0 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 73 63 /* Size of sc
375f0 72 61 74 63 68 20 6d 65 6d 6f 72 79 20 72 65 71 ratch memory req
37600 75 65 73 74 65 64 20 2a 2f 0a 20 20 4d 65 6d 50 uested */. MemP
37610 61 67 65 20 2a 61 70 4f 6c 64 5b 4e 42 5d 3b 20 age *apOld[NB];
37620 20 20 20 20 20 20 20 20 20 2f 2a 20 70 50 61 67 /* pPag
37630 65 20 61 6e 64 20 75 70 20 74 6f 20 74 77 6f 20 e and up to two
37640 73 69 62 6c 69 6e 67 73 20 2a 2f 0a 20 20 4d 65 siblings */. Me
37650 6d 50 61 67 65 20 2a 61 70 4e 65 77 5b 4e 42 2b mPage *apNew[NB+
37660 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 70 50 2]; /* pP
37670 61 67 65 20 61 6e 64 20 75 70 20 74 6f 20 4e 42 age and up to NB
37680 20 73 69 62 6c 69 6e 67 73 20 61 66 74 65 72 20 siblings after
37690 62 61 6c 61 6e 63 69 6e 67 20 2a 2f 0a 20 20 75 balancing */. u
376a0 38 20 2a 70 52 69 67 68 74 3b 20 20 20 20 20 20 8 *pRight;
376b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c /* L
376c0 6f 63 61 74 69 6f 6e 20 69 6e 20 70 61 72 65 6e ocation in paren
376d0 74 20 6f 66 20 72 69 67 68 74 2d 73 69 62 6c 69 t of right-sibli
376e0 6e 67 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 ng pointer */.
376f0 75 38 20 2a 61 70 44 69 76 5b 4e 42 2d 31 5d 3b u8 *apDiv[NB-1];
37700 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
37710 44 69 76 69 64 65 72 20 63 65 6c 6c 73 20 69 6e Divider cells in
37720 20 70 50 61 72 65 6e 74 20 2a 2f 0a 20 20 69 6e pParent */. in
37730 74 20 63 6e 74 4e 65 77 5b 4e 42 2b 32 5d 3b 20 t cntNew[NB+2];
37740 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
37750 64 65 78 20 69 6e 20 61 43 65 6c 6c 5b 5d 20 6f dex in aCell[] o
37760 66 20 63 65 6c 6c 20 61 66 74 65 72 20 69 2d 74 f cell after i-t
37770 68 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 h page */. int
37780 63 6e 74 4f 6c 64 5b 4e 42 2b 32 5d 3b 20 20 20 cntOld[NB+2];
37790 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6c 64 20 /* Old
377a0 69 6e 64 65 78 20 69 6e 20 61 43 65 6c 6c 5b 5d index in aCell[]
377b0 20 61 66 74 65 72 20 69 2d 74 68 20 70 61 67 65 after i-th page
377c0 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 4e 65 77 5b */. int szNew[
377d0 4e 42 2b 32 5d 3b 20 20 20 20 20 20 20 20 20 20 NB+2];
377e0 20 20 20 2f 2a 20 43 6f 6d 62 69 6e 65 64 20 73 /* Combined s
377f0 69 7a 65 20 6f 66 20 63 65 6c 6c 73 20 70 6c 61 ize of cells pla
37800 63 65 20 6f 6e 20 69 2d 74 68 20 70 61 67 65 20 ce on i-th page
37810 2a 2f 0a 20 20 75 38 20 2a 2a 61 70 43 65 6c 6c */. u8 **apCell
37820 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
37830 20 20 2f 2a 20 41 6c 6c 20 63 65 6c 6c 73 20 62 /* All cells b
37840 65 67 69 6e 20 62 61 6c 61 6e 63 65 64 20 2a 2f egin balanced */
37850 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c 6c 3b 20 . u16 *szCell;
37860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37870 2f 2a 20 4c 6f 63 61 6c 20 73 69 7a 65 20 6f 66 /* Local size of
37880 20 61 6c 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 all cells in ap
37890 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a Cell[] */. u8 *
378a0 61 53 70 61 63 65 31 3b 20 20 20 20 20 20 20 20 aSpace1;
378b0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 /* Spac
378c0 65 20 66 6f 72 20 63 6f 70 69 65 73 20 6f 66 20 e for copies of
378d0 64 69 76 69 64 65 72 73 20 63 65 6c 6c 73 20 2a dividers cells *
378e0 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 /. Pgno pgno;
378f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37900 20 2f 2a 20 54 65 6d 70 20 76 61 72 20 74 6f 20 /* Temp var to
37910 73 74 6f 72 65 20 61 20 70 61 67 65 20 6e 75 6d store a page num
37920 62 65 72 20 69 6e 20 2a 2f 0a 20 20 75 38 20 61 ber in */. u8 a
37930 62 44 6f 6e 65 5b 4e 42 2b 32 5d 3b 20 20 20 20 bDone[NB+2];
37940 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
37950 20 61 66 74 65 72 20 69 27 74 68 20 6e 65 77 20 after i'th new
37960 70 61 67 65 20 69 73 20 70 6f 70 75 6c 61 74 65 page is populate
37970 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 61 50 67 6e d */. Pgno aPgn
37980 6f 5b 4e 42 2b 32 5d 3b 20 20 20 20 20 20 20 20 o[NB+2];
37990 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 /* Page numb
379a0 65 72 73 20 6f 66 20 6e 65 77 20 70 61 67 65 73 ers of new pages
379b0 20 62 65 66 6f 72 65 20 73 68 75 66 66 6c 69 6e before shufflin
379c0 67 20 2a 2f 0a 20 20 75 31 36 20 61 50 67 46 6c g */. u16 aPgFl
379d0 61 67 73 5b 4e 42 2b 32 5d 3b 20 20 20 20 20 20 ags[NB+2];
379e0 20 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 65 /* flags fie
379f0 6c 64 20 6f 66 20 6e 65 77 20 70 61 67 65 73 20 ld of new pages
37a00 62 65 66 6f 72 65 20 73 68 75 66 66 6c 69 6e 67 before shuffling
37a10 20 2a 2f 0a 0a 20 20 6d 65 6d 73 65 74 28 61 62 */.. memset(ab
37a20 44 6f 6e 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 Done, 0, sizeof(
37a30 61 62 44 6f 6e 65 29 29 3b 0a 20 20 70 42 74 20 abDone));. pBt
37a40 3d 20 70 50 61 72 65 6e 74 2d 3e 70 42 74 3b 0a = pParent->pBt;.
37a50 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
37a60 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
37a70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
37a80 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
37a90 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 erIswriteable(pP
37aa0 61 72 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 arent->pDbPage)
37ab0 29 3b 0a 0a 23 69 66 20 30 0a 20 20 54 52 41 43 );..#if 0. TRAC
37ac0 45 28 28 22 42 41 4c 41 4e 43 45 3a 20 62 65 67 E(("BALANCE: beg
37ad0 69 6e 20 70 61 67 65 20 25 64 20 63 68 69 6c 64 in page %d child
37ae0 20 6f 66 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 of %d\n", pPage
37af0 2d 3e 70 67 6e 6f 2c 20 70 50 61 72 65 6e 74 2d ->pgno, pParent-
37b00 3e 70 67 6e 6f 29 29 3b 0a 23 65 6e 64 69 66 0a >pgno));.#endif.
37b10 0a 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f . /* At this po
37b20 69 6e 74 20 70 50 61 72 65 6e 74 20 6d 61 79 20 int pParent may
37b30 68 61 76 65 20 61 74 20 6d 6f 73 74 20 6f 6e 65 have at most one
37b40 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 2e 20 overflow cell.
37b50 41 6e 64 20 69 66 0a 20 20 2a 2a 20 74 68 69 73 And if. ** this
37b60 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 20 69 overflow cell i
37b70 73 20 70 72 65 73 65 6e 74 2c 20 69 74 20 6d 75 s present, it mu
37b80 73 74 20 62 65 20 74 68 65 20 63 65 6c 6c 20 77 st be the cell w
37b90 69 74 68 20 0a 20 20 2a 2a 20 69 6e 64 65 78 20 ith . ** index
37ba0 69 50 61 72 65 6e 74 49 64 78 2e 20 54 68 69 73 iParentIdx. This
37bb0 20 73 63 65 6e 61 72 69 6f 20 63 6f 6d 65 73 20 scenario comes
37bc0 61 62 6f 75 74 20 77 68 65 6e 20 74 68 69 73 20 about when this
37bd0 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 function. ** is
37be0 20 63 61 6c 6c 65 64 20 28 69 6e 64 69 72 65 63 called (indirec
37bf0 74 6c 79 29 20 66 72 6f 6d 20 73 71 6c 69 74 65 tly) from sqlite
37c00 33 42 74 72 65 65 44 65 6c 65 74 65 28 29 2e 0a 3BtreeDelete()..
37c10 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
37c20 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f Parent->nOverflo
37c30 77 3d 3d 30 20 7c 7c 20 70 50 61 72 65 6e 74 2d w==0 || pParent-
37c40 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 31 20 29 3b >nOverflow==1 );
37c50 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 72 65 . assert( pPare
37c60 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 nt->nOverflow==0
37c70 20 7c 7c 20 70 50 61 72 65 6e 74 2d 3e 61 69 4f || pParent->aiO
37c80 76 66 6c 5b 30 5d 3d 3d 69 50 61 72 65 6e 74 49 vfl[0]==iParentI
37c90 64 78 20 29 3b 0a 0a 20 20 69 66 28 20 21 61 4f dx );.. if( !aO
37ca0 76 66 6c 53 70 61 63 65 20 29 7b 0a 20 20 20 20 vflSpace ){.
37cb0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
37cc0 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 MEM;. }.. /* F
37cd0 69 6e 64 20 74 68 65 20 73 69 62 6c 69 6e 67 20 ind the sibling
37ce0 70 61 67 65 73 20 74 6f 20 62 61 6c 61 6e 63 65 pages to balance
37cf0 2e 20 41 6c 73 6f 20 6c 6f 63 61 74 65 20 74 68 . Also locate th
37d00 65 20 63 65 6c 6c 73 20 69 6e 20 70 50 61 72 65 e cells in pPare
37d10 6e 74 20 0a 20 20 2a 2a 20 74 68 61 74 20 64 69 nt . ** that di
37d20 76 69 64 65 20 74 68 65 20 73 69 62 6c 69 6e 67 vide the sibling
37d30 73 2e 20 41 6e 20 61 74 74 65 6d 70 74 20 69 73 s. An attempt is
37d40 20 6d 61 64 65 20 74 6f 20 66 69 6e 64 20 4e 4e made to find NN
37d50 20 73 69 62 6c 69 6e 67 73 20 6f 6e 20 0a 20 20 siblings on .
37d60 2a 2a 20 65 69 74 68 65 72 20 73 69 64 65 20 6f ** either side o
37d70 66 20 70 50 61 67 65 2e 20 4d 6f 72 65 20 73 69 f pPage. More si
37d80 62 6c 69 6e 67 73 20 61 72 65 20 74 61 6b 65 6e blings are taken
37d90 20 66 72 6f 6d 20 6f 6e 65 20 73 69 64 65 2c 20 from one side,
37da0 68 6f 77 65 76 65 72 2c 20 0a 20 20 2a 2a 20 69 however, . ** i
37db0 66 20 74 68 65 72 65 20 61 72 65 20 66 65 77 65 f there are fewe
37dc0 72 20 74 68 61 6e 20 4e 4e 20 73 69 62 6c 69 6e r than NN siblin
37dd0 67 73 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 gs on the other
37de0 73 69 64 65 2e 20 49 66 20 70 50 61 72 65 6e 74 side. If pParent
37df0 0a 20 20 2a 2a 20 68 61 73 20 4e 42 20 6f 72 20 . ** has NB or
37e00 66 65 77 65 72 20 63 68 69 6c 64 72 65 6e 20 74 fewer children t
37e10 68 65 6e 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e hen all children
37e20 20 6f 66 20 70 50 61 72 65 6e 74 20 61 72 65 20 of pParent are
37e30 74 61 6b 65 6e 2e 20 20 0a 20 20 2a 2a 0a 20 20 taken. . **.
37e40 2a 2a 20 54 68 69 73 20 6c 6f 6f 70 20 61 6c 73 ** This loop als
37e50 6f 20 64 72 6f 70 73 20 74 68 65 20 64 69 76 69 o drops the divi
37e60 64 65 72 20 63 65 6c 6c 73 20 66 72 6f 6d 20 74 der cells from t
37e70 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 20 he parent page.
37e80 54 68 69 73 0a 20 20 2a 2a 20 77 61 79 2c 20 74 This. ** way, t
37e90 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 he remainder of
37ea0 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 the function doe
37eb0 73 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 64 65 s not have to de
37ec0 61 6c 20 77 69 74 68 20 61 6e 79 0a 20 20 2a 2a al with any. **
37ed0 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 overflow cells
37ee0 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 in the parent pa
37ef0 67 65 2c 20 73 69 6e 63 65 20 69 66 20 61 6e 79 ge, since if any
37f00 20 65 78 69 73 74 65 64 20 74 68 65 79 20 77 69 existed they wi
37f10 6c 6c 0a 20 20 2a 2a 20 68 61 76 65 20 61 6c 72 ll. ** have alr
37f20 65 61 64 79 20 62 65 65 6e 20 72 65 6d 6f 76 65 eady been remove
37f30 64 2e 0a 20 20 2a 2f 0a 20 20 69 20 3d 20 70 50 d.. */. i = pP
37f40 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 arent->nOverflow
37f50 20 2b 20 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c + pParent->nCel
37f60 6c 3b 0a 20 20 69 66 28 20 69 3c 32 20 29 7b 0a l;. if( i<2 ){.
37f70 20 20 20 20 6e 78 44 69 76 20 3d 20 30 3b 0a 20 nxDiv = 0;.
37f80 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
37f90 72 74 28 20 62 42 75 6c 6b 3d 3d 30 20 7c 7c 20 rt( bBulk==0 ||
37fa0 62 42 75 6c 6b 3d 3d 31 20 29 3b 0a 20 20 20 20 bBulk==1 );.
37fb0 69 66 28 20 69 50 61 72 65 6e 74 49 64 78 3d 3d if( iParentIdx==
37fc0 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 0 ){
37fd0 20 20 20 20 20 0a 20 20 20 20 20 20 6e 78 44 69 . nxDi
37fe0 76 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 v = 0;. }else
37ff0 20 69 66 28 20 69 50 61 72 65 6e 74 49 64 78 3d if( iParentIdx=
38000 3d 69 20 29 7b 0a 20 20 20 20 20 20 6e 78 44 69 =i ){. nxDi
38010 76 20 3d 20 69 2d 32 2b 62 42 75 6c 6b 3b 0a 20 v = i-2+bBulk;.
38020 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
38030 61 73 73 65 72 74 28 20 62 42 75 6c 6b 3d 3d 30 assert( bBulk==0
38040 20 29 3b 0a 20 20 20 20 20 20 6e 78 44 69 76 20 );. nxDiv
38050 3d 20 69 50 61 72 65 6e 74 49 64 78 2d 31 3b 0a = iParentIdx-1;.
38060 20 20 20 20 7d 0a 20 20 20 20 69 20 3d 20 32 2d }. i = 2-
38070 62 42 75 6c 6b 3b 0a 20 20 7d 0a 20 20 6e 4f 6c bBulk;. }. nOl
38080 64 20 3d 20 69 2b 31 3b 0a 20 20 69 66 28 20 28 d = i+1;. if( (
38090 69 2b 6e 78 44 69 76 2d 70 50 61 72 65 6e 74 2d i+nxDiv-pParent-
380a0 3e 6e 4f 76 65 72 66 6c 6f 77 29 3d 3d 70 50 61 >nOverflow)==pPa
380b0 72 65 6e 74 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 rent->nCell ){.
380c0 20 20 20 70 52 69 67 68 74 20 3d 20 26 70 50 61 pRight = &pPa
380d0 72 65 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 rent->aData[pPar
380e0 65 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 ent->hdrOffset+8
380f0 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 ];. }else{.
38100 70 52 69 67 68 74 20 3d 20 66 69 6e 64 43 65 6c pRight = findCel
38110 6c 28 70 50 61 72 65 6e 74 2c 20 69 2b 6e 78 44 l(pParent, i+nxD
38120 69 76 2d 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 iv-pParent->nOve
38130 72 66 6c 6f 77 29 3b 0a 20 20 7d 0a 20 20 70 67 rflow);. }. pg
38140 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 52 no = get4byte(pR
38150 69 67 68 74 29 3b 0a 20 20 77 68 69 6c 65 28 20 ight);. while(
38160 31 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 67 65 1 ){. rc = ge
38170 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 42 74 tAndInitPage(pBt
38180 2c 20 70 67 6e 6f 2c 20 26 61 70 4f 6c 64 5b 69 , pgno, &apOld[i
38190 5d 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 ], 0);. if( r
381a0 63 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 c ){. memse
381b0 74 28 61 70 4f 6c 64 2c 20 30 2c 20 28 69 2b 31 t(apOld, 0, (i+1
381c0 29 2a 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 )*sizeof(MemPage
381d0 2a 29 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 *));. goto
381e0 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b balance_cleanup;
381f0 0a 20 20 20 20 7d 0a 20 20 20 20 6e 4d 61 78 43 . }. nMaxC
38200 65 6c 6c 73 20 2b 3d 20 31 2b 61 70 4f 6c 64 5b ells += 1+apOld[
38210 69 5d 2d 3e 6e 43 65 6c 6c 2b 61 70 4f 6c 64 5b i]->nCell+apOld[
38220 69 5d 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a 20 i]->nOverflow;.
38230 20 20 20 69 66 28 20 28 69 2d 2d 29 3d 3d 30 20 if( (i--)==0
38240 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 69 66 ) break;.. if
38250 28 20 69 2b 6e 78 44 69 76 3d 3d 70 50 61 72 65 ( i+nxDiv==pPare
38260 6e 74 2d 3e 61 69 4f 76 66 6c 5b 30 5d 20 26 26 nt->aiOvfl[0] &&
38270 20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 pParent->nOverf
38280 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 61 70 44 low ){. apD
38290 69 76 5b 69 5d 20 3d 20 70 50 61 72 65 6e 74 2d iv[i] = pParent-
382a0 3e 61 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 20 >apOvfl[0];.
382b0 20 20 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 pgno = get4byt
382c0 65 28 61 70 44 69 76 5b 69 5d 29 3b 0a 20 20 20 e(apDiv[i]);.
382d0 20 20 20 73 7a 4e 65 77 5b 69 5d 20 3d 20 63 65 szNew[i] = ce
382e0 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 72 65 6e llSizePtr(pParen
382f0 74 2c 20 61 70 44 69 76 5b 69 5d 29 3b 0a 20 20 t, apDiv[i]);.
38300 20 20 20 20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 pParent->nOv
38310 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 20 20 erflow = 0;.
38320 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 70 44 }else{. apD
38330 69 76 5b 69 5d 20 3d 20 66 69 6e 64 43 65 6c 6c iv[i] = findCell
38340 28 70 50 61 72 65 6e 74 2c 20 69 2b 6e 78 44 69 (pParent, i+nxDi
38350 76 2d 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 v-pParent->nOver
38360 66 6c 6f 77 29 3b 0a 20 20 20 20 20 20 70 67 6e flow);. pgn
38370 6f 20 3d 20 67 65 74 34 62 79 74 65 28 61 70 44 o = get4byte(apD
38380 69 76 5b 69 5d 29 3b 0a 20 20 20 20 20 20 73 7a iv[i]);. sz
38390 4e 65 77 5b 69 5d 20 3d 20 63 65 6c 6c 53 69 7a New[i] = cellSiz
383a0 65 50 74 72 28 70 50 61 72 65 6e 74 2c 20 61 70 ePtr(pParent, ap
383b0 44 69 76 5b 69 5d 29 3b 0a 0a 20 20 20 20 20 20 Div[i]);..
383c0 2f 2a 20 44 72 6f 70 20 74 68 65 20 63 65 6c 6c /* Drop the cell
383d0 20 66 72 6f 6d 20 74 68 65 20 70 61 72 65 6e 74 from the parent
383e0 20 70 61 67 65 2e 20 61 70 44 69 76 5b 69 5d 20 page. apDiv[i]
383f0 73 74 69 6c 6c 20 70 6f 69 6e 74 73 20 74 6f 0a still points to.
38400 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 65 6c ** the cel
38410 6c 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 72 l within the par
38420 65 6e 74 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 ent, even though
38430 20 69 74 20 68 61 73 20 62 65 65 6e 20 64 72 6f it has been dro
38440 70 70 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 54 pped.. ** T
38450 68 69 73 20 69 73 20 73 61 66 65 20 62 65 63 61 his is safe beca
38460 75 73 65 20 6