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 20 20 73 71 6c 69 enable){. sqli
0b30: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
0b40: 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c sharedCacheEnabl
0b50: 65 64 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 72 ed = enable;. r
0b60: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
0b70: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 0a 23 69 66 .}.#endif....#if
0b80: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
0b90: 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 2f SHARED_CACHE. /
0ba0: 2a 0a 20 20 2a 2a 20 54 68 65 20 66 75 6e 63 74 *. ** The funct
0bb0: 69 6f 6e 73 20 71 75 65 72 79 53 68 61 72 65 64 ions queryShared
0bc0: 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 CacheTableLock()
0bd0: 2c 20 73 65 74 53 68 61 72 65 64 43 61 63 68 65 , setSharedCache
0be0: 54 61 62 6c 65 4c 6f 63 6b 28 29 2c 0a 20 20 2a TableLock(),. *
0bf0: 2a 20 61 6e 64 20 63 6c 65 61 72 41 6c 6c 53 68 * and clearAllSh
0c00: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0c10: 63 6b 73 28 29 0a 20 20 2a 2a 20 6d 61 6e 69 70 cks(). ** manip
0c20: 75 6c 61 74 65 20 65 6e 74 72 69 65 73 20 69 6e ulate entries in
0c30: 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 4c the BtShared.pL
0c40: 6f 63 6b 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 ock linked list
0c50: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 20 20 used to store.
0c60: 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 ** shared-cache
0c70: 74 61 62 6c 65 20 6c 65 76 65 6c 20 6c 6f 63 6b table level lock
0c80: 73 2e 20 49 66 20 74 68 65 20 6c 69 62 72 61 72 s. If the librar
0c90: 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 y is compiled wi
0ca0: 74 68 20 74 68 65 0a 20 20 2a 2a 20 73 68 61 72 th the. ** shar
0cb0: 65 64 2d 63 61 63 68 65 20 66 65 61 74 75 72 65 ed-cache feature
0cc0: 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 disabled, then
0cd0: 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 65 76 there is only ev
0ce0: 65 72 20 6f 6e 65 20 75 73 65 72 0a 20 20 2a 2a er one user. **
0cf0: 20 6f 66 20 65 61 63 68 20 42 74 53 68 61 72 65 of each BtShare
0d00: 64 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 d structure and
0d10: 73 6f 20 74 68 69 73 20 6c 6f 63 6b 69 6e 67 20 so this locking
0d20: 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 is not necessary
0d30: 2e 20 0a 20 20 2a 2a 20 53 6f 20 64 65 66 69 6e . . ** So defin
0d40: 65 20 74 68 65 20 6c 6f 63 6b 20 72 65 6c 61 74 e the lock relat
0d50: 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 ed functions as
0d60: 6e 6f 2d 6f 70 73 2e 0a 20 20 2a 2f 0a 20 20 23 no-ops.. */. #
0d70: 64 65 66 69 6e 65 20 71 75 65 72 79 53 68 61 72 define queryShar
0d80: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
0d90: 28 61 2c 62 2c 63 29 20 53 51 4c 49 54 45 5f 4f (a,b,c) SQLITE_O
0da0: 4b 0a 20 20 23 64 65 66 69 6e 65 20 73 65 74 53 K. #define setS
0db0: 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
0dc0: 6f 63 6b 28 61 2c 62 2c 63 29 20 53 51 4c 49 54 ock(a,b,c) SQLIT
0dd0: 45 5f 4f 4b 0a 20 20 23 64 65 66 69 6e 65 20 63 E_OK. #define c
0de0: 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 learAllSharedCac
0df0: 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a heTableLocks(a).
0e00: 20 20 23 64 65 66 69 6e 65 20 64 6f 77 6e 67 72 #define downgr
0e10: 61 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 adeAllSharedCach
0e20: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a 20 eTableLocks(a).
0e30: 20 23 64 65 66 69 6e 65 20 68 61 73 53 68 61 72 #define hasShar
0e40: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
0e50: 28 61 2c 62 2c 63 2c 64 29 20 31 0a 20 20 23 64 (a,b,c,d) 1. #d
0e60: 65 66 69 6e 65 20 68 61 73 52 65 61 64 43 6f 6e efine hasReadCon
0e70: 66 6c 69 63 74 73 28 61 2c 20 62 29 20 30 0a 23 flicts(a, b) 0.#
0e80: 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
0e90: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
0ea0: 44 5f 43 41 43 48 45 0a 0a 23 69 66 64 65 66 20 D_CACHE..#ifdef
0eb0: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a SQLITE_DEBUG./*.
0ec0: 2a 2a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 **** This functi
0ed0: 6f 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 on is only used
0ee0: 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 61 73 as part of an as
0ef0: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
0f00: 2e 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 43 68 65 63 . ***.**.** Chec
0f10: 6b 20 74 6f 20 73 65 65 20 69 66 20 70 42 74 72 k to see if pBtr
0f20: 65 65 20 68 6f 6c 64 73 20 74 68 65 20 72 65 71 ee holds the req
0f30: 75 69 72 65 64 20 6c 6f 63 6b 73 20 74 6f 20 72 uired locks to r
0f40: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 6f 20 ead or write to
0f50: 74 68 65 20 0a 2a 2a 20 74 61 62 6c 65 20 77 69 the .** table wi
0f60: 74 68 20 72 6f 6f 74 20 70 61 67 65 20 69 52 6f th root page iRo
0f70: 6f 74 2e 20 20 20 52 65 74 75 72 6e 20 31 20 69 ot. Return 1 i
0f80: 66 20 69 74 20 64 6f 65 73 20 61 6e 64 20 30 20 f it does and 0
0f90: 69 66 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f if not..**.** Fo
0fa0: 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 r example, when
0fb0: 77 72 69 74 69 6e 67 20 74 6f 20 61 20 74 61 62 writing to a tab
0fc0: 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 le with root-pag
0fd0: 65 20 69 52 6f 6f 74 20 76 69 61 20 0a 2a 2a 20 e iRoot via .**
0fe0: 42 74 72 65 65 20 63 6f 6e 6e 65 63 74 69 6f 6e Btree connection
0ff0: 20 70 42 74 72 65 65 3a 0a 2a 2a 0a 2a 2a 20 20 pBtree:.**.**
1000: 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 61 assert( hasSha
1010: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
1020: 6b 28 70 42 74 72 65 65 2c 20 69 52 6f 6f 74 2c k(pBtree, iRoot,
1030: 20 30 2c 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 0, WRITE_LOCK)
1040: 29 3b 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 77 72 );.**.** When wr
1050: 69 74 69 6e 67 20 74 6f 20 61 6e 20 69 6e 64 65 iting to an inde
1060: 78 20 74 68 61 74 20 72 65 73 69 64 65 73 20 69 x that resides i
1070: 6e 20 61 20 73 68 61 72 61 62 6c 65 20 64 61 74 n a sharable dat
1080: 61 62 61 73 65 2c 20 74 68 65 20 0a 2a 2a 20 63 abase, the .** c
1090: 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20 68 61 76 aller should hav
10a0: 65 20 66 69 72 73 74 20 6f 62 74 61 69 6e 65 64 e first obtained
10b0: 20 61 20 6c 6f 63 6b 20 73 70 65 63 69 66 79 69 a lock specifyi
10c0: 6e 67 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 ng the root page
10d0: 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 of.** the corre
10e0: 73 70 6f 6e 64 69 6e 67 20 74 61 62 6c 65 2e 20 sponding table.
10f0: 54 68 69 73 20 6d 61 6b 65 73 20 74 68 69 6e 67 This makes thing
1100: 73 20 61 20 62 69 74 20 6d 6f 72 65 20 63 6f 6d s a bit more com
1110: 70 6c 69 63 61 74 65 64 2c 0a 2a 2a 20 61 73 20 plicated,.** as
1120: 74 68 69 73 20 6d 6f 64 75 6c 65 20 74 72 65 61 this module trea
1130: 74 73 20 65 61 63 68 20 74 61 62 6c 65 20 61 73 ts each table as
1140: 20 61 20 73 65 70 61 72 61 74 65 20 73 74 72 75 a separate stru
1150: 63 74 75 72 65 2e 20 54 6f 20 64 65 74 65 72 6d cture. To determ
1160: 69 6e 65 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 ine.** the table
1170: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
1180: 6f 20 74 68 65 20 69 6e 64 65 78 20 62 65 69 6e o the index bein
1190: 67 20 77 72 69 74 74 65 6e 2c 20 74 68 69 73 0a g written, this.
11a0: 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 ** function has
11b0: 74 6f 20 73 65 61 72 63 68 20 74 68 72 6f 75 67 to search throug
11c0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 h the database s
11d0: 63 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 49 6e 73 chema..**.** Ins
11e0: 74 65 61 64 20 6f 66 20 61 20 6c 6f 63 6b 20 6f tead of a lock o
11f0: 6e 20 74 68 65 20 74 61 62 6c 65 2f 69 6e 64 65 n the table/inde
1200: 78 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 x rooted at page
1210: 20 69 52 6f 6f 74 2c 20 74 68 65 20 63 61 6c 6c iRoot, the call
1220: 65 72 20 6d 61 79 0a 2a 2a 20 68 6f 6c 64 20 61 er may.** hold a
1230: 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 write-lock on t
1240: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 20 he schema table
1250: 28 72 6f 6f 74 20 70 61 67 65 20 31 29 2e 20 54 (root page 1). T
1260: 68 69 73 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 61 his is also.** a
1270: 63 63 65 70 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 cceptable..*/.st
1280: 61 74 69 63 20 69 6e 74 20 68 61 73 53 68 61 72 atic int hasShar
1290: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
12a0: 28 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 (. Btree *pBtre
12b0: 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 e, /* Ha
12c0: 6e 64 6c 65 20 74 68 61 74 20 6d 75 73 74 20 68 ndle that must h
12d0: 6f 6c 64 20 6c 6f 63 6b 20 2a 2f 0a 20 20 50 67 old lock */. Pg
12e0: 6e 6f 20 69 52 6f 6f 74 2c 20 20 20 20 20 20 20 no iRoot,
12f0: 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 /* Root pag
1300: 65 20 6f 66 20 62 2d 74 72 65 65 20 2a 2f 0a 20 e of b-tree */.
1310: 20 69 6e 74 20 69 73 49 6e 64 65 78 2c 20 20 20 int isIndex,
1320: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
1330: 69 66 20 69 52 6f 6f 74 20 69 73 20 74 68 65 20 if iRoot is the
1340: 72 6f 6f 74 20 6f 66 20 61 6e 20 69 6e 64 65 78 root of an index
1350: 20 62 2d 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 b-tree */. int
1360: 20 65 4c 6f 63 6b 54 79 70 65 20 20 20 20 20 20 eLockType
1370: 20 20 20 20 2f 2a 20 52 65 71 75 69 72 65 64 20 /* Required
1380: 6c 6f 63 6b 20 74 79 70 65 20 28 52 45 41 44 5f lock type (READ_
1390: 4c 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f 4c 4f LOCK or WRITE_LO
13a0: 43 4b 29 20 2a 2f 0a 29 7b 0a 20 20 53 63 68 65 CK) */.){. Sche
13b0: 6d 61 20 2a 70 53 63 68 65 6d 61 20 3d 20 28 53 ma *pSchema = (S
13c0: 63 68 65 6d 61 20 2a 29 70 42 74 72 65 65 2d 3e chema *)pBtree->
13d0: 70 42 74 2d 3e 70 53 63 68 65 6d 61 3b 0a 20 20 pBt->pSchema;.
13e0: 50 67 6e 6f 20 69 54 61 62 20 3d 20 30 3b 0a 20 Pgno iTab = 0;.
13f0: 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a BtLock *pLock;.
1400: 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 64 61 . /* If this da
1410: 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 73 68 tabase is not sh
1420: 61 72 65 61 62 6c 65 2c 20 6f 72 20 69 66 20 74 areable, or if t
1430: 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 he client is rea
1440: 64 69 6e 67 0a 20 20 2a 2a 20 61 6e 64 20 68 61 ding. ** and ha
1450: 73 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d s the read-uncom
1460: 6d 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 2c mitted flag set,
1470: 20 74 68 65 6e 20 6e 6f 20 6c 6f 63 6b 20 69 73 then no lock is
1480: 20 72 65 71 75 69 72 65 64 2e 20 0a 20 20 2a 2a required. . **
1490: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 6d 6d Return true imm
14a0: 65 64 69 61 74 65 6c 79 2e 0a 20 20 2a 2f 0a 20 ediately.. */.
14b0: 20 69 66 28 20 28 70 42 74 72 65 65 2d 3e 73 68 if( (pBtree->sh
14c0: 61 72 61 62 6c 65 3d 3d 30 29 0a 20 20 20 7c 7c arable==0). ||
14d0: 20 28 65 4c 6f 63 6b 54 79 70 65 3d 3d 52 45 41 (eLockType==REA
14e0: 44 5f 4c 4f 43 4b 20 26 26 20 28 70 42 74 72 65 D_LOCK && (pBtre
14f0: 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 e->db->flags & S
1500: 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d QLITE_ReadUncomm
1510: 69 74 74 65 64 29 29 0a 20 20 29 7b 0a 20 20 20 itted)). ){.
1520: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a return 1;. }..
1530: 20 20 2f 2a 20 49 66 20 74 68 65 20 63 6c 69 65 /* If the clie
1540: 6e 74 20 69 73 20 72 65 61 64 69 6e 67 20 20 6f nt is reading o
1550: 72 20 77 72 69 74 69 6e 67 20 61 6e 20 69 6e 64 r writing an ind
1560: 65 78 20 61 6e 64 20 74 68 65 20 73 63 68 65 6d ex and the schem
1570: 61 20 69 73 0a 20 20 2a 2a 20 6e 6f 74 20 6c 6f a is. ** not lo
1580: 61 64 65 64 2c 20 74 68 65 6e 20 69 74 20 69 73 aded, then it is
1590: 20 74 6f 6f 20 64 69 66 66 69 63 75 6c 74 20 74 too difficult t
15a0: 6f 20 61 63 74 75 61 6c 6c 79 20 63 68 65 63 6b o actually check
15b0: 20 74 6f 20 73 65 65 20 69 66 0a 20 20 2a 2a 20 to see if. **
15c0: 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 6b the correct lock
15d0: 73 20 61 72 65 20 68 65 6c 64 2e 20 20 53 6f 20 s are held. So
15e0: 64 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 2d 20 do not bother -
15f0: 6a 75 73 74 20 72 65 74 75 72 6e 20 74 72 75 65 just return true
1600: 2e 0a 20 20 2a 2a 20 54 68 69 73 20 63 61 73 65 .. ** This case
1610: 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6d 65 20 75 does not come u
1620: 70 20 76 65 72 79 20 6f 66 74 65 6e 20 61 6e 79 p very often any
1630: 68 6f 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 how.. */. if(
1640: 69 73 49 6e 64 65 78 20 26 26 20 28 21 70 53 63 isIndex && (!pSc
1650: 68 65 6d 61 20 7c 7c 20 28 70 53 63 68 65 6d 61 hema || (pSchema
1660: 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 44 42 ->schemaFlags&DB
1670: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3d 3d _SchemaLoaded)==
1680: 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 0) ){. return
1690: 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 1;. }.. /* Fi
16a0: 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 6f 6f gure out the roo
16b0: 74 2d 70 61 67 65 20 74 68 61 74 20 74 68 65 20 t-page that the
16c0: 6c 6f 63 6b 20 73 68 6f 75 6c 64 20 62 65 20 68 lock should be h
16d0: 65 6c 64 20 6f 6e 2e 20 46 6f 72 20 74 61 62 6c eld on. For tabl
16e0: 65 0a 20 20 2a 2a 20 62 2d 74 72 65 65 73 2c 20 e. ** b-trees,
16f0: 74 68 69 73 20 69 73 20 6a 75 73 74 20 74 68 65 this is just the
1700: 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 68 root page of th
1710: 65 20 62 2d 74 72 65 65 20 62 65 69 6e 67 20 72 e b-tree being r
1720: 65 61 64 20 6f 72 0a 20 20 2a 2a 20 77 72 69 74 ead or. ** writ
1730: 74 65 6e 2e 20 46 6f 72 20 69 6e 64 65 78 20 62 ten. For index b
1740: 2d 74 72 65 65 73 2c 20 69 74 20 69 73 20 74 68 -trees, it is th
1750: 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 e root page of t
1760: 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 he associated.
1770: 2a 2a 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20 20 ** table. */.
1780: 69 66 28 20 69 73 49 6e 64 65 78 20 29 7b 0a 20 if( isIndex ){.
1790: 20 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a HashElem *p;.
17a0: 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 for(p=sqlite
17b0: 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 65 HashFirst(&pSche
17c0: 6d 61 2d 3e 69 64 78 48 61 73 68 29 3b 20 70 3b ma->idxHash); p;
17d0: 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 p=sqliteHashNex
17e0: 74 28 70 29 29 7b 0a 20 20 20 20 20 20 49 6e 64 t(p)){. Ind
17f0: 65 78 20 2a 70 49 64 78 20 3d 20 28 49 6e 64 65 ex *pIdx = (Inde
1800: 78 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 x *)sqliteHashDa
1810: 74 61 28 70 29 3b 0a 20 20 20 20 20 20 69 66 28 ta(p);. if(
1820: 20 70 49 64 78 2d 3e 74 6e 75 6d 3d 3d 28 69 6e pIdx->tnum==(in
1830: 74 29 69 52 6f 6f 74 20 29 7b 0a 20 20 20 20 20 t)iRoot ){.
1840: 20 20 20 69 54 61 62 20 3d 20 70 49 64 78 2d 3e iTab = pIdx->
1850: 70 54 61 62 6c 65 2d 3e 74 6e 75 6d 3b 0a 20 20 pTable->tnum;.
1860: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 }. }. }e
1870: 6c 73 65 7b 0a 20 20 20 20 69 54 61 62 20 3d 20 lse{. iTab =
1880: 69 52 6f 6f 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a iRoot;. }.. /*
1890: 20 53 65 61 72 63 68 20 66 6f 72 20 74 68 65 20 Search for the
18a0: 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e 20 45 required lock. E
18b0: 69 74 68 65 72 20 61 20 77 72 69 74 65 2d 6c 6f ither a write-lo
18c0: 63 6b 20 6f 6e 20 72 6f 6f 74 2d 70 61 67 65 20 ck on root-page
18d0: 69 54 61 62 2c 20 61 20 0a 20 20 2a 2a 20 77 72 iTab, a . ** wr
18e0: 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ite-lock on the
18f0: 73 63 68 65 6d 61 20 74 61 62 6c 65 2c 20 6f 72 schema table, or
1900: 20 28 69 66 20 74 68 65 20 63 6c 69 65 6e 74 20 (if the client
1910: 69 73 20 72 65 61 64 69 6e 67 29 20 61 0a 20 20 is reading) a.
1920: 2a 2a 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 ** read-lock on
1930: 69 54 61 62 20 77 69 6c 6c 20 73 75 66 66 69 63 iTab will suffic
1940: 65 2e 20 52 65 74 75 72 6e 20 31 20 69 66 20 61 e. Return 1 if a
1950: 6e 79 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 ny of these are
1960: 66 6f 75 6e 64 2e 20 20 2a 2f 0a 20 20 66 6f 72 found. */. for
1970: 28 70 4c 6f 63 6b 3d 70 42 74 72 65 65 2d 3e 70 (pLock=pBtree->p
1980: 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b Bt->pLock; pLock
1990: 3b 20 70 4c 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e 70 ; pLock=pLock->p
19a0: 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 Next){. if( p
19b0: 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 42 Lock->pBtree==pB
19c0: 74 72 65 65 20 0a 20 20 20 20 20 26 26 20 28 70 tree . && (p
19d0: 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 Lock->iTable==iT
19e0: 61 62 20 7c 7c 20 28 70 4c 6f 63 6b 2d 3e 65 4c ab || (pLock->eL
19f0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 ock==WRITE_LOCK
1a00: 26 26 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 && pLock->iTable
1a10: 3d 3d 31 29 29 0a 20 20 20 20 20 26 26 20 70 4c ==1)). && pL
1a20: 6f 63 6b 2d 3e 65 4c 6f 63 6b 3e 3d 65 4c 6f 63 ock->eLock>=eLoc
1a30: 6b 54 79 70 65 20 0a 20 20 20 20 29 7b 0a 20 20 kType . ){.
1a40: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 return 1;.
1a50: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 61 }. }.. /* Fa
1a60: 69 6c 65 64 20 74 6f 20 66 69 6e 64 20 74 68 65 iled to find the
1a70: 20 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e 20 required lock.
1a80: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d */. return 0;.}
1a90: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
1aa0: 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 23 69 66 64 E_DEBUG */..#ifd
1ab0: 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
1ac0: 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 73 20 66 75 6e /*.**** This fun
1ad0: 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 75 73 65 ction may be use
1ae0: 64 20 61 73 20 70 61 72 74 20 6f 66 20 61 73 73 d as part of ass
1af0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
1b00: 20 6f 6e 6c 79 2e 20 2a 2a 2a 2a 0a 2a 2a 0a 2a only. ****.**.*
1b10: 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
1b20: 20 69 74 20 77 6f 75 6c 64 20 62 65 20 69 6c 6c it would be ill
1b30: 65 67 61 6c 20 66 6f 72 20 70 42 74 72 65 65 20 egal for pBtree
1b40: 74 6f 20 77 72 69 74 65 20 69 6e 74 6f 20 74 68 to write into th
1b50: 65 0a 2a 2a 20 74 61 62 6c 65 20 6f 72 20 69 6e e.** table or in
1b60: 64 65 78 20 72 6f 6f 74 65 64 20 61 74 20 69 52 dex rooted at iR
1b70: 6f 6f 74 20 62 65 63 61 75 73 65 20 6f 74 68 65 oot because othe
1b80: 72 20 73 68 61 72 65 64 20 63 6f 6e 6e 65 63 74 r shared connect
1b90: 69 6f 6e 73 20 61 72 65 0a 2a 2a 20 73 69 6d 75 ions are.** simu
1ba0: 6c 74 61 6e 65 6f 75 73 6c 79 20 72 65 61 64 69 ltaneously readi
1bb0: 6e 67 20 74 68 61 74 20 73 61 6d 65 20 74 61 62 ng that same tab
1bc0: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 0a 2a 2a 0a le or index..**.
1bd0: 2a 2a 20 49 74 20 69 73 20 69 6c 6c 65 67 61 6c ** It is illegal
1be0: 20 66 6f 72 20 70 42 74 72 65 65 20 74 6f 20 77 for pBtree to w
1bf0: 72 69 74 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 rite if some oth
1c00: 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 er Btree object
1c10: 74 68 61 74 0a 2a 2a 20 73 68 61 72 65 73 20 74 that.** shares t
1c20: 68 65 20 73 61 6d 65 20 42 74 53 68 61 72 65 64 he same BtShared
1c30: 20 6f 62 6a 65 63 74 20 69 73 20 63 75 72 72 65 object is curre
1c40: 6e 74 6c 79 20 72 65 61 64 69 6e 67 20 6f 72 20 ntly reading or
1c50: 77 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 69 writing.** the i
1c60: 52 6f 6f 74 20 74 61 62 6c 65 2e 20 20 45 78 63 Root table. Exc
1c70: 65 70 74 2c 20 69 66 20 74 68 65 20 6f 74 68 65 ept, if the othe
1c80: 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 68 r Btree object h
1c90: 61 73 20 74 68 65 0a 2a 2a 20 72 65 61 64 2d 75 as the.** read-u
1ca0: 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c 61 67 20 ncommitted flag
1cb0: 73 65 74 2c 20 74 68 65 6e 20 69 74 20 69 73 20 set, then it is
1cc0: 4f 4b 20 66 6f 72 20 74 68 65 20 6f 74 68 65 72 OK for the other
1cd0: 20 6f 62 6a 65 63 74 20 74 6f 0a 2a 2a 20 68 61 object to.** ha
1ce0: 76 65 20 61 20 72 65 61 64 20 63 75 72 73 6f 72 ve a read cursor
1cf0: 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d ..**.** For exam
1d00: 70 6c 65 2c 20 62 65 66 6f 72 65 20 77 72 69 74 ple, before writ
1d10: 69 6e 67 20 74 6f 20 61 6e 79 20 70 61 72 74 20 ing to any part
1d20: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 of the table or
1d30: 69 6e 64 65 78 0a 2a 2a 20 72 6f 6f 74 65 64 20 index.** rooted
1d40: 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 6f at page iRoot, o
1d50: 6e 65 20 73 68 6f 75 6c 64 20 63 61 6c 6c 3a 0a ne should call:.
1d60: 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 28 **.** assert(
1d70: 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 !hasReadConflic
1d80: 74 73 28 70 42 74 72 65 65 2c 20 69 52 6f 6f 74 ts(pBtree, iRoot
1d90: 29 20 29 3b 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ) );.*/.static i
1da0: 6e 74 20 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 nt hasReadConfli
1db0: 63 74 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 cts(Btree *pBtre
1dc0: 65 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 29 7b 0a e, Pgno iRoot){.
1dd0: 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 BtCursor *p;.
1de0: 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e 70 for(p=pBtree->p
1df0: 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 Bt->pCursor; p;
1e00: 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 p=p->pNext){.
1e10: 20 69 66 28 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 if( p->pgnoRoot
1e20: 3d 3d 69 52 6f 6f 74 20 0a 20 20 20 20 20 26 26 ==iRoot . &&
1e30: 20 70 2d 3e 70 42 74 72 65 65 21 3d 70 42 74 72 p->pBtree!=pBtr
1e40: 65 65 0a 20 20 20 20 20 26 26 20 30 3d 3d 28 70 ee. && 0==(p
1e50: 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 6c ->pBtree->db->fl
1e60: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 61 ags & SQLITE_Rea
1e70: 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 0a 20 20 dUncommitted).
1e80: 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 ){. retur
1e90: 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 n 1;. }. }.
1ea0: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e return 0;.}.#en
1eb0: 64 69 66 20 20 20 20 2f 2a 20 23 69 66 64 65 66 dif /* #ifdef
1ec0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a 2f SQLITE_DEBUG */
1ed0: 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 6f ../*.** Query to
1ee0: 20 73 65 65 20 69 66 20 42 74 72 65 65 20 68 61 see if Btree ha
1ef0: 6e 64 6c 65 20 70 20 6d 61 79 20 6f 62 74 61 69 ndle p may obtai
1f00: 6e 20 61 20 6c 6f 63 6b 20 6f 66 20 74 79 70 65 n a lock of type
1f10: 20 65 4c 6f 63 6b 20 0a 2a 2a 20 28 52 45 41 44 eLock .** (READ
1f20: 5f 4c 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f 4c _LOCK or WRITE_L
1f30: 4f 43 4b 29 20 6f 6e 20 74 68 65 20 74 61 62 6c OCK) on the tabl
1f40: 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 e with root-page
1f50: 20 69 54 61 62 2e 20 52 65 74 75 72 6e 0a 2a 2a iTab. Return.**
1f60: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 SQLITE_OK if th
1f70: 65 20 6c 6f 63 6b 20 6d 61 79 20 62 65 20 6f 62 e lock may be ob
1f80: 74 61 69 6e 65 64 20 28 62 79 20 63 61 6c 6c 69 tained (by calli
1f90: 6e 67 0a 2a 2a 20 73 65 74 53 68 61 72 65 64 43 ng.** setSharedC
1fa0: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 29 acheTableLock())
1fb0: 2c 20 6f 72 20 53 51 4c 49 54 45 5f 4c 4f 43 4b , or SQLITE_LOCK
1fc0: 45 44 20 69 66 20 6e 6f 74 2e 0a 2a 2f 0a 73 74 ED if not..*/.st
1fd0: 61 74 69 63 20 69 6e 74 20 71 75 65 72 79 53 68 atic int querySh
1fe0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
1ff0: 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 50 67 6e ck(Btree *p, Pgn
2000: 6f 20 69 54 61 62 2c 20 75 38 20 65 4c 6f 63 6b o iTab, u8 eLock
2010: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
2020: 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 Bt = p->pBt;. B
2030: 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 0a 20 tLock *pIter;..
2040: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2050: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 BtreeHoldsMutex(
2060: 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 p) );. assert(
2070: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
2080: 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 || eLock==WRITE
2090: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 _LOCK );. asser
20a0: 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b 0a 20 t( p->db!=0 );.
20b0: 20 61 73 73 65 72 74 28 20 21 28 70 2d 3e 64 62 assert( !(p->db
20c0: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 52 ->flags&SQLITE_R
20d0: 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 7c eadUncommitted)|
20e0: 7c 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f |eLock==WRITE_LO
20f0: 43 4b 7c 7c 69 54 61 62 3d 3d 31 20 29 3b 0a 20 CK||iTab==1 );.
2100: 20 0a 20 20 2f 2a 20 49 66 20 72 65 71 75 65 73 . /* If reques
2110: 74 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 ting a write-loc
2120: 6b 2c 20 74 68 65 6e 20 74 68 65 20 42 74 72 65 k, then the Btre
2130: 65 20 6d 75 73 74 20 68 61 76 65 20 61 6e 20 6f e must have an o
2140: 70 65 6e 20 77 72 69 74 65 0a 20 20 2a 2a 20 74 pen write. ** t
2150: 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 ransaction on th
2160: 69 73 20 66 69 6c 65 2e 20 41 6e 64 2c 20 6f 62 is file. And, ob
2170: 76 69 6f 75 73 6c 79 2c 20 66 6f 72 20 74 68 69 viously, for thi
2180: 73 20 74 6f 20 62 65 20 73 6f 20 74 68 65 72 65 s to be so there
2190: 20 0a 20 20 2a 2a 20 6d 75 73 74 20 62 65 20 61 . ** must be a
21a0: 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61 n open write tra
21b0: 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65 20 nsaction on the
21c0: 66 69 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20 2a file itself.. *
21d0: 2f 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 /. assert( eLoc
21e0: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
21f0: 28 70 3d 3d 70 42 74 2d 3e 70 57 72 69 74 65 72 (p==pBt->pWriter
2200: 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d && p->inTrans==
2210: 54 52 41 4e 53 5f 57 52 49 54 45 29 20 29 3b 0a TRANS_WRITE) );.
2220: 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d assert( eLock=
2230: 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 42 =READ_LOCK || pB
2240: 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
2250: 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 3b ==TRANS_WRITE );
2260: 0a 20 20 0a 20 20 2f 2a 20 54 68 69 73 20 72 6f . . /* This ro
2270: 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
2280: 20 69 66 20 74 68 65 20 73 68 61 72 65 64 2d 63 if the shared-c
2290: 61 63 68 65 20 69 73 20 6e 6f 74 20 65 6e 61 62 ache is not enab
22a0: 6c 65 64 20 2a 2f 0a 20 20 69 66 28 20 21 70 2d led */. if( !p-
22b0: 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 >sharable ){.
22c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
22d0: 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 K;. }.. /* If
22e0: 73 6f 6d 65 20 6f 74 68 65 72 20 63 6f 6e 6e 65 some other conne
22f0: 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 6e 67 ction is holding
2300: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f an exclusive lo
2310: 63 6b 2c 20 74 68 65 0a 20 20 2a 2a 20 72 65 71 ck, the. ** req
2320: 75 65 73 74 65 64 20 6c 6f 63 6b 20 6d 61 79 20 uested lock may
2330: 6e 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 2e not be obtained.
2340: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 42 74 2d . */. if( pBt-
2350: 3e 70 57 72 69 74 65 72 21 3d 70 20 26 26 20 28 >pWriter!=p && (
2360: 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
2370: 42 54 53 5f 45 58 43 4c 55 53 49 56 45 29 21 3d BTS_EXCLUSIVE)!=
2380: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 ){. sqlite3
2390: 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 ConnectionBlocke
23a0: 64 28 70 2d 3e 64 62 2c 20 70 42 74 2d 3e 70 57 d(p->db, pBt->pW
23b0: 72 69 74 65 72 2d 3e 64 62 29 3b 0a 20 20 20 20 riter->db);.
23c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f return SQLITE_LO
23d0: 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 CKED_SHAREDCACHE
23e0: 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 70 49 74 ;. }.. for(pIt
23f0: 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 er=pBt->pLock; p
2400: 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 74 65 Iter; pIter=pIte
2410: 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 2f r->pNext){. /
2420: 2a 20 54 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 * The condition
2430: 28 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 (pIter->eLock!=e
2440: 4c 6f 63 6b 29 20 69 6e 20 74 68 65 20 66 6f 6c Lock) in the fol
2450: 6c 6f 77 69 6e 67 20 69 66 28 2e 2e 2e 29 20 0a lowing if(...) .
2460: 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 ** statement
2470: 20 69 73 20 61 20 73 69 6d 70 6c 69 66 69 63 61 is a simplifica
2480: 74 69 6f 6e 20 6f 66 3a 0a 20 20 20 20 2a 2a 0a tion of:. **.
2490: 20 20 20 20 2a 2a 20 20 20 28 65 4c 6f 63 6b 3d ** (eLock=
24a0: 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 7c 7c 20 70 =WRITE_LOCK || p
24b0: 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 49 Iter->eLock==WRI
24c0: 54 45 5f 4c 4f 43 4b 29 0a 20 20 20 20 2a 2a 0a TE_LOCK). **.
24d0: 20 20 20 20 2a 2a 20 73 69 6e 63 65 20 77 65 20 ** since we
24e0: 6b 6e 6f 77 20 74 68 61 74 20 69 66 20 65 4c 6f know that if eLo
24f0: 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 2c 20 ck==WRITE_LOCK,
2500: 74 68 65 6e 20 6e 6f 20 6f 74 68 65 72 20 63 6f then no other co
2510: 6e 6e 65 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 nnection. **
2520: 6d 61 79 20 68 6f 6c 64 20 61 20 57 52 49 54 45 may hold a WRITE
2530: 5f 4c 4f 43 4b 20 6f 6e 20 61 6e 79 20 74 61 62 _LOCK on any tab
2540: 6c 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20 le in this file
2550: 28 73 69 6e 63 65 20 74 68 65 72 65 20 63 61 6e (since there can
2560: 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 62 65 20 . ** only be
2570: 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65 72 29 a single writer)
2580: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 .. */. ass
2590: 65 72 74 28 20 70 49 74 65 72 2d 3e 65 4c 6f 63 ert( pIter->eLoc
25a0: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
25b0: 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 pIter->eLock==WR
25c0: 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 ITE_LOCK );.
25d0: 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 assert( eLock==R
25e0: 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 EAD_LOCK || pIte
25f0: 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 7c 7c 20 r->pBtree==p ||
2600: 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 pIter->eLock==RE
2610: 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 66 AD_LOCK);. if
2620: 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 21 ( pIter->pBtree!
2630: 3d 70 20 26 26 20 70 49 74 65 72 2d 3e 69 54 61 =p && pIter->iTa
2640: 62 6c 65 3d 3d 69 54 61 62 20 26 26 20 70 49 74 ble==iTab && pIt
2650: 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 4c 6f 63 6b er->eLock!=eLock
2660: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
2670: 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 3ConnectionBlock
2680: 65 64 28 70 2d 3e 64 62 2c 20 70 49 74 65 72 2d ed(p->db, pIter-
2690: 3e 70 42 74 72 65 65 2d 3e 64 62 29 3b 0a 20 20 >pBtree->db);.
26a0: 20 20 20 20 69 66 28 20 65 4c 6f 63 6b 3d 3d 57 if( eLock==W
26b0: 52 49 54 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 RITE_LOCK ){.
26c0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 3d 3d assert( p==
26d0: 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 3b 0a pBt->pWriter );.
26e0: 20 20 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 pBt->bts
26f0: 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 45 4e Flags |= BTS_PEN
2700: 44 49 4e 47 3b 0a 20 20 20 20 20 20 7d 0a 20 20 DING;. }.
2710: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2720: 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 E_LOCKED_SHAREDC
2730: 41 43 48 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a ACHE;. }. }.
2740: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2750: 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 OK;.}.#endif /*
2760: 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 !SQLITE_OMIT_SHA
2770: 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 69 RED_CACHE */..#i
2780: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
2790: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 2f T_SHARED_CACHE./
27a0: 2a 0a 2a 2a 20 41 64 64 20 61 20 6c 6f 63 6b 20 *.** Add a lock
27b0: 6f 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 on the table wit
27c0: 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 h root-page iTab
27d0: 6c 65 20 74 6f 20 74 68 65 20 73 68 61 72 65 64 le to the shared
27e0: 2d 62 74 72 65 65 20 75 73 65 64 0a 2a 2a 20 62 -btree used.** b
27f0: 79 20 42 74 72 65 65 20 68 61 6e 64 6c 65 20 70 y Btree handle p
2800: 2e 20 50 61 72 61 6d 65 74 65 72 20 65 4c 6f 63 . Parameter eLoc
2810: 6b 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 k must be either
2820: 20 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 0a 2a READ_LOCK or .*
2830: 2a 20 57 52 49 54 45 5f 4c 4f 43 4b 2e 0a 2a 2a * WRITE_LOCK..**
2840: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
2850: 6e 20 61 73 73 75 6d 65 73 20 74 68 65 20 66 6f n assumes the fo
2860: 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 llowing:.**.**
2870: 20 28 61 29 20 54 68 65 20 73 70 65 63 69 66 69 (a) The specifi
2880: 65 64 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 ed Btree object
2890: 70 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20 74 p is connected t
28a0: 6f 20 61 20 73 68 61 72 61 62 6c 65 0a 2a 2a 20 o a sharable.**
28b0: 20 20 20 20 20 20 64 61 74 61 62 61 73 65 20 28 database (
28c0: 6f 6e 65 20 77 69 74 68 20 74 68 65 20 42 74 53 one with the BtS
28d0: 68 61 72 65 64 2e 73 68 61 72 61 62 6c 65 20 66 hared.sharable f
28e0: 6c 61 67 20 73 65 74 29 2c 20 61 6e 64 0a 2a 2a lag set), and.**
28f0: 0a 2a 2a 20 20 20 28 62 29 20 4e 6f 20 6f 74 68 .** (b) No oth
2900: 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 73 er Btree objects
2910: 20 68 6f 6c 64 20 61 20 6c 6f 63 6b 20 74 68 61 hold a lock tha
2920: 74 20 63 6f 6e 66 6c 69 63 74 73 0a 2a 2a 20 20 t conflicts.**
2930: 20 20 20 20 20 77 69 74 68 20 74 68 65 20 72 65 with the re
2940: 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 28 69 2e quested lock (i.
2950: 65 2e 20 71 75 65 72 79 53 68 61 72 65 64 43 61 e. querySharedCa
2960: 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 20 68 cheTableLock() h
2970: 61 73 0a 2a 2a 20 20 20 20 20 20 20 61 6c 72 65 as.** alre
2980: 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 ady been called
2990: 61 6e 64 20 72 65 74 75 72 6e 65 64 20 53 51 4c and returned SQL
29a0: 49 54 45 5f 4f 4b 29 2e 0a 2a 2a 0a 2a 2a 20 53 ITE_OK)..**.** S
29b0: 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
29c0: 72 6e 65 64 20 69 66 20 74 68 65 20 6c 6f 63 6b rned if the lock
29d0: 20 69 73 20 61 64 64 65 64 20 73 75 63 63 65 73 is added succes
29e0: 73 66 75 6c 6c 79 2e 20 53 51 4c 49 54 45 5f 4e sfully. SQLITE_N
29f0: 4f 4d 45 4d 20 0a 2a 2a 20 69 73 20 72 65 74 75 OMEM .** is retu
2a00: 72 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 rned if a malloc
2a10: 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2e 0a attempt fails..
2a20: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 */.static int se
2a30: 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c tSharedCacheTabl
2a40: 65 4c 6f 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 eLock(Btree *p,
2a50: 50 67 6e 6f 20 69 54 61 62 6c 65 2c 20 75 38 20 Pgno iTable, u8
2a60: 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 68 61 72 eLock){. BtShar
2a70: 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
2a80: 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 ;. BtLock *pLoc
2a90: 6b 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 k = 0;. BtLock
2aa0: 2a 70 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 *pIter;.. asser
2ab0: 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 t( sqlite3BtreeH
2ac0: 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a oldsMutex(p) );.
2ad0: 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d assert( eLock=
2ae0: 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c =READ_LOCK || eL
2af0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 ock==WRITE_LOCK
2b00: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
2b10: 64 62 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 41 db!=0 );.. /* A
2b20: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 connection with
2b30: 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d 6d the read-uncomm
2b40: 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 20 77 itted flag set w
2b50: 69 6c 6c 20 6e 65 76 65 72 20 74 72 79 20 74 6f ill never try to
2b60: 0a 20 20 2a 2a 20 6f 62 74 61 69 6e 20 61 20 72 . ** obtain a r
2b70: 65 61 64 2d 6c 6f 63 6b 20 75 73 69 6e 67 20 74 ead-lock using t
2b80: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 his function. Th
2b90: 65 20 6f 6e 6c 79 20 72 65 61 64 2d 6c 6f 63 6b e only read-lock
2ba0: 20 6f 62 74 61 69 6e 65 64 0a 20 20 2a 2a 20 62 obtained. ** b
2bb0: 79 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 y a connection i
2bc0: 6e 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 n read-uncommitt
2bd0: 65 64 20 6d 6f 64 65 20 69 73 20 6f 6e 20 74 68 ed mode is on th
2be0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 e sqlite_master
2bf0: 0a 20 20 2a 2a 20 74 61 62 6c 65 2c 20 61 6e 64 . ** table, and
2c00: 20 74 68 61 74 20 6c 6f 63 6b 20 69 73 20 6f 62 that lock is ob
2c10: 74 61 69 6e 65 64 20 69 6e 20 42 74 72 65 65 42 tained in BtreeB
2c20: 65 67 69 6e 54 72 61 6e 73 28 29 2e 20 20 2a 2f eginTrans(). */
2c30: 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 28 70 . assert( 0==(p
2c40: 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 ->db->flags&SQLI
2c50: 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 74 74 TE_ReadUncommitt
2c60: 65 64 29 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 ed) || eLock==WR
2c70: 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f ITE_LOCK );.. /
2c80: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
2c90: 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 should only be c
2ca0: 61 6c 6c 65 64 20 6f 6e 20 61 20 73 68 61 72 61 alled on a shara
2cb0: 62 6c 65 20 62 2d 74 72 65 65 20 61 66 74 65 72 ble b-tree after
2cc0: 20 69 74 20 0a 20 20 2a 2a 20 68 61 73 20 62 65 it . ** has be
2cd0: 65 6e 20 64 65 74 65 72 6d 69 6e 65 64 20 74 68 en determined th
2ce0: 61 74 20 6e 6f 20 6f 74 68 65 72 20 62 2d 74 72 at no other b-tr
2cf0: 65 65 20 68 6f 6c 64 73 20 61 20 63 6f 6e 66 6c ee holds a confl
2d00: 69 63 74 69 6e 67 20 6c 6f 63 6b 2e 20 20 2a 2f icting lock. */
2d10: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 73 68 . assert( p->sh
2d20: 61 72 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 65 arable );. asse
2d30: 72 74 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 71 rt( SQLITE_OK==q
2d40: 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 54 uerySharedCacheT
2d50: 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 62 ableLock(p, iTab
2d60: 6c 65 2c 20 65 4c 6f 63 6b 29 20 29 3b 0a 0a 20 le, eLock) );..
2d70: 20 2f 2a 20 46 69 72 73 74 20 73 65 61 72 63 68 /* First search
2d80: 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 61 6e the list for an
2d90: 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 6b 20 6f existing lock o
2da0: 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a 2f n this table. */
2db0: 0a 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 . for(pIter=pBt
2dc0: 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 ->pLock; pIter;
2dd0: 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 pIter=pIter->pNe
2de0: 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49 74 xt){. if( pIt
2df0: 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 62 er->iTable==iTab
2e00: 6c 65 20 26 26 20 70 49 74 65 72 2d 3e 70 42 74 le && pIter->pBt
2e10: 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 20 ree==p ){.
2e20: 70 4c 6f 63 6b 20 3d 20 70 49 74 65 72 3b 0a 20 pLock = pIter;.
2e30: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
2e40: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 }. }.. /* If t
2e50: 68 65 20 61 62 6f 76 65 20 73 65 61 72 63 68 20 he above search
2e60: 64 69 64 20 6e 6f 74 20 66 69 6e 64 20 61 20 42 did not find a B
2e70: 74 4c 6f 63 6b 20 73 74 72 75 63 74 20 61 73 73 tLock struct ass
2e80: 6f 63 69 61 74 69 6e 67 20 42 74 72 65 65 20 70 ociating Btree p
2e90: 0a 20 20 2a 2a 20 77 69 74 68 20 74 61 62 6c 65 . ** with table
2ea0: 20 69 54 61 62 6c 65 2c 20 61 6c 6c 6f 63 61 74 iTable, allocat
2eb0: 65 20 6f 6e 65 20 61 6e 64 20 6c 69 6e 6b 20 69 e one and link i
2ec0: 74 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 2e t into the list.
2ed0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 4c 6f . */. if( !pLo
2ee0: 63 6b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b 20 ck ){. pLock
2ef0: 3d 20 28 42 74 4c 6f 63 6b 20 2a 29 73 71 6c 69 = (BtLock *)sqli
2f00: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 te3MallocZero(si
2f10: 7a 65 6f 66 28 42 74 4c 6f 63 6b 29 29 3b 0a 20 zeof(BtLock));.
2f20: 20 20 20 69 66 28 20 21 70 4c 6f 63 6b 20 29 7b if( !pLock ){
2f30: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2f40: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
2f50: 7d 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 69 54 61 }. pLock->iTa
2f60: 62 6c 65 20 3d 20 69 54 61 62 6c 65 3b 0a 20 20 ble = iTable;.
2f70: 20 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 20 pLock->pBtree
2f80: 3d 20 70 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e = p;. pLock->
2f90: 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f pNext = pBt->pLo
2fa0: 63 6b 3b 0a 20 20 20 20 70 42 74 2d 3e 70 4c 6f ck;. pBt->pLo
2fb0: 63 6b 20 3d 20 70 4c 6f 63 6b 3b 0a 20 20 7d 0a ck = pLock;. }.
2fc0: 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 42 74 . /* Set the Bt
2fd0: 4c 6f 63 6b 2e 65 4c 6f 63 6b 20 76 61 72 69 61 Lock.eLock varia
2fe0: 62 6c 65 20 74 6f 20 74 68 65 20 6d 61 78 69 6d ble to the maxim
2ff0: 75 6d 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e um of the curren
3000: 74 20 6c 6f 63 6b 0a 20 20 2a 2a 20 61 6e 64 20 t lock. ** and
3010: 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f the requested lo
3020: 63 6b 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 69 ck. This means i
3030: 66 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 77 f a write-lock w
3040: 61 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 0a as already held.
3050: 20 20 2a 2a 20 61 6e 64 20 61 20 72 65 61 64 2d ** and a read-
3060: 6c 6f 63 6b 20 72 65 71 75 65 73 74 65 64 2c 20 lock requested,
3070: 77 65 20 64 6f 6e 27 74 20 69 6e 63 6f 72 72 65 we don't incorre
3080: 63 74 6c 79 20 64 6f 77 6e 67 72 61 64 65 20 74 ctly downgrade t
3090: 68 65 20 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20 he lock.. */.
30a0: 61 73 73 65 72 74 28 20 57 52 49 54 45 5f 4c 4f assert( WRITE_LO
30b0: 43 4b 3e 52 45 41 44 5f 4c 4f 43 4b 20 29 3b 0a CK>READ_LOCK );.
30c0: 20 20 69 66 28 20 65 4c 6f 63 6b 3e 70 4c 6f 63 if( eLock>pLoc
30d0: 6b 2d 3e 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 k->eLock ){.
30e0: 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 65 pLock->eLock = e
30f0: 4c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 Lock;. }.. ret
3100: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
3110: 0a 23 65 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 .#endif /* !SQLI
3120: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
3130: 41 43 48 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 ACHE */..#ifndef
3140: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
3150: 52 45 44 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a 20 RED_CACHE./*.**
3160: 52 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65 20 Release all the
3170: 74 61 62 6c 65 20 6c 6f 63 6b 73 20 28 6c 6f 63 table locks (loc
3180: 6b 73 20 6f 62 74 61 69 6e 65 64 20 76 69 61 20 ks obtained via
3190: 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20 74 68 65 20 calls to.** the
31a0: 73 65 74 53 68 61 72 65 64 43 61 63 68 65 54 61 setSharedCacheTa
31b0: 62 6c 65 4c 6f 63 6b 28 29 20 70 72 6f 63 65 64 bleLock() proced
31c0: 75 72 65 29 20 68 65 6c 64 20 62 79 20 42 74 72 ure) held by Btr
31d0: 65 65 20 6f 62 6a 65 63 74 20 70 2e 0a 2a 2a 0a ee object p..**.
31e0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
31f0: 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 42 74 assumes that Bt
3200: 72 65 65 20 70 20 68 61 73 20 61 6e 20 6f 70 65 ree p has an ope
3210: 6e 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 n read or write
3220: 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e .** transaction.
3230: 20 49 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 2c If it does not,
3240: 20 74 68 65 6e 20 74 68 65 20 42 54 53 5f 50 45 then the BTS_PE
3250: 4e 44 49 4e 47 20 66 6c 61 67 0a 2a 2a 20 6d 61 NDING flag.** ma
3260: 79 20 62 65 20 69 6e 63 6f 72 72 65 63 74 6c 79 y be incorrectly
3270: 20 63 6c 65 61 72 65 64 2e 0a 2a 2f 0a 73 74 61 cleared..*/.sta
3280: 74 69 63 20 76 6f 69 64 20 63 6c 65 61 72 41 6c tic void clearAl
3290: 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c lSharedCacheTabl
32a0: 65 4c 6f 63 6b 73 28 42 74 72 65 65 20 2a 70 29 eLocks(Btree *p)
32b0: 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
32c0: 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 t = p->pBt;. Bt
32d0: 4c 6f 63 6b 20 2a 2a 70 70 49 74 65 72 20 3d 20 Lock **ppIter =
32e0: 26 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a 0a 20 20 &pBt->pLock;..
32f0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 assert( sqlite3B
3300: 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 treeHoldsMutex(p
3310: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
3320: 2d 3e 73 68 61 72 61 62 6c 65 20 7c 7c 20 30 3d ->sharable || 0=
3330: 3d 2a 70 70 49 74 65 72 20 29 3b 0a 20 20 61 73 =*ppIter );. as
3340: 73 65 72 74 28 20 70 2d 3e 69 6e 54 72 61 6e 73 sert( p->inTrans
3350: 3e 30 20 29 3b 0a 0a 20 20 77 68 69 6c 65 28 20 >0 );.. while(
3360: 2a 70 70 49 74 65 72 20 29 7b 0a 20 20 20 20 42 *ppIter ){. B
3370: 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 2a tLock *pLock = *
3380: 70 70 49 74 65 72 3b 0a 20 20 20 20 61 73 73 65 ppIter;. asse
3390: 72 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 rt( (pBt->btsFla
33a0: 67 73 20 26 20 42 54 53 5f 45 58 43 4c 55 53 49 gs & BTS_EXCLUSI
33b0: 56 45 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 VE)==0 || pBt->p
33c0: 57 72 69 74 65 72 3d 3d 70 4c 6f 63 6b 2d 3e 70 Writer==pLock->p
33d0: 42 74 72 65 65 20 29 3b 0a 20 20 20 20 61 73 73 Btree );. ass
33e0: 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 ert( pLock->pBtr
33f0: 65 65 2d 3e 69 6e 54 72 61 6e 73 3e 3d 70 4c 6f ee->inTrans>=pLo
3400: 63 6b 2d 3e 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 ck->eLock );.
3410: 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 if( pLock->pBtr
3420: 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 20 2a ee==p ){. *
3430: 70 70 49 74 65 72 20 3d 20 70 4c 6f 63 6b 2d 3e ppIter = pLock->
3440: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 61 73 73 pNext;. ass
3450: 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 ert( pLock->iTab
3460: 6c 65 21 3d 31 20 7c 7c 20 70 4c 6f 63 6b 3d 3d le!=1 || pLock==
3470: 26 70 2d 3e 6c 6f 63 6b 20 29 3b 0a 20 20 20 20 &p->lock );.
3480: 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 69 54 61 if( pLock->iTa
3490: 62 6c 65 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 ble!=1 ){.
34a0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
34b0: 4c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 7d 0a 20 Lock);. }.
34c0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
34d0: 70 70 49 74 65 72 20 3d 20 26 70 4c 6f 63 6b 2d ppIter = &pLock-
34e0: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 >pNext;. }.
34f0: 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 28 70 42 }.. assert( (pB
3500: 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
3510: 53 5f 50 45 4e 44 49 4e 47 29 3d 3d 30 20 7c 7c S_PENDING)==0 ||
3520: 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 3b pBt->pWriter );
3530: 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 57 72 69 . if( pBt->pWri
3540: 74 65 72 3d 3d 70 20 29 7b 0a 20 20 20 20 70 42 ter==p ){. pB
3550: 74 2d 3e 70 57 72 69 74 65 72 20 3d 20 30 3b 0a t->pWriter = 0;.
3560: 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
3570: 73 20 26 3d 20 7e 28 42 54 53 5f 45 58 43 4c 55 s &= ~(BTS_EXCLU
3580: 53 49 56 45 7c 42 54 53 5f 50 45 4e 44 49 4e 47 SIVE|BTS_PENDING
3590: 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 );. }else if( p
35a0: 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e Bt->nTransaction
35b0: 3d 3d 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 ==2 ){. /* Th
35c0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
35d0: 61 6c 6c 65 64 20 77 68 65 6e 20 42 74 72 65 65 alled when Btree
35e0: 20 70 20 69 73 20 63 6f 6e 63 6c 75 64 69 6e 67 p is concluding
35f0: 20 69 74 73 20 0a 20 20 20 20 2a 2a 20 74 72 61 its . ** tra
3600: 6e 73 61 63 74 69 6f 6e 2e 20 49 66 20 74 68 65 nsaction. If the
3610: 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 69 re currently exi
3620: 73 74 73 20 61 20 77 72 69 74 65 72 2c 20 61 6e sts a writer, an
3630: 64 20 70 20 69 73 20 6e 6f 74 0a 20 20 20 20 2a d p is not. *
3640: 2a 20 74 68 61 74 20 77 72 69 74 65 72 2c 20 74 * that writer, t
3650: 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f hen the number o
3660: 66 20 6c 6f 63 6b 73 20 68 65 6c 64 20 62 79 20 f locks held by
3670: 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 74 68 65 connections othe
3680: 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 r. ** than th
3690: 65 20 77 72 69 74 65 72 20 6d 75 73 74 20 62 65 e writer must be
36a0: 20 61 62 6f 75 74 20 74 6f 20 64 72 6f 70 20 74 about to drop t
36b0: 6f 20 7a 65 72 6f 2e 20 49 6e 20 74 68 69 73 20 o zero. In this
36c0: 63 61 73 65 0a 20 20 20 20 2a 2a 20 73 65 74 20 case. ** set
36d0: 74 68 65 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 the BTS_PENDING
36e0: 66 6c 61 67 20 74 6f 20 30 2e 0a 20 20 20 20 2a flag to 0.. *
36f0: 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 72 *. ** If ther
3700: 65 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 e is not current
3710: 6c 79 20 61 20 77 72 69 74 65 72 2c 20 74 68 65 ly a writer, the
3720: 6e 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 6d 75 n BTS_PENDING mu
3730: 73 74 0a 20 20 20 20 2a 2a 20 62 65 20 7a 65 72 st. ** be zer
3740: 6f 20 61 6c 72 65 61 64 79 2e 20 53 6f 20 74 68 o already. So th
3750: 69 73 20 6e 65 78 74 20 6c 69 6e 65 20 69 73 20 is next line is
3760: 68 61 72 6d 6c 65 73 73 20 69 6e 20 74 68 61 74 harmless in that
3770: 20 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 case.. */.
3780: 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
3790: 26 3d 20 7e 42 54 53 5f 50 45 4e 44 49 4e 47 3b &= ~BTS_PENDING;
37a0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 . }.}../*.** Th
37b0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 68 61 6e is function chan
37c0: 67 65 73 20 61 6c 6c 20 77 72 69 74 65 2d 6c 6f ges all write-lo
37d0: 63 6b 73 20 68 65 6c 64 20 62 79 20 42 74 72 65 cks held by Btre
37e0: 65 20 70 20 69 6e 74 6f 20 72 65 61 64 2d 6c 6f e p into read-lo
37f0: 63 6b 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 cks..*/.static v
3800: 6f 69 64 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c oid downgradeAll
3810: 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
3820: 4c 6f 63 6b 73 28 42 74 72 65 65 20 2a 70 29 7b Locks(Btree *p){
3830: 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
3840: 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 66 28 = p->pBt;. if(
3850: 20 70 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 pBt->pWriter==p
3860: 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 2a ){. BtLock *
3870: 70 4c 6f 63 6b 3b 0a 20 20 20 20 70 42 74 2d 3e pLock;. pBt->
3880: 70 57 72 69 74 65 72 20 3d 20 30 3b 0a 20 20 20 pWriter = 0;.
3890: 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
38a0: 3d 20 7e 28 42 54 53 5f 45 58 43 4c 55 53 49 56 = ~(BTS_EXCLUSIV
38b0: 45 7c 42 54 53 5f 50 45 4e 44 49 4e 47 29 3b 0a E|BTS_PENDING);.
38c0: 20 20 20 20 66 6f 72 28 70 4c 6f 63 6b 3d 70 42 for(pLock=pB
38d0: 74 2d 3e 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3b t->pLock; pLock;
38e0: 20 70 4c 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e 70 4e pLock=pLock->pN
38f0: 65 78 74 29 7b 0a 20 20 20 20 20 20 61 73 73 65 ext){. asse
3900: 72 74 28 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b rt( pLock->eLock
3910: 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 ==READ_LOCK || p
3920: 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 20 Lock->pBtree==p
3930: 29 3b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 2d 3e );. pLock->
3940: 65 4c 6f 63 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 eLock = READ_LOC
3950: 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a K;. }. }.}..
3960: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
3970: 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
3980: 48 45 20 2a 2f 0a 0a 73 74 61 74 69 63 20 76 6f HE */..static vo
3990: 69 64 20 72 65 6c 65 61 73 65 50 61 67 65 28 4d id releasePage(M
39a0: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 3b 20 emPage *pPage);
39b0: 20 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 /* Forward refe
39c0: 72 65 6e 63 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 2a rence */../*.***
39d0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
39e0: 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 6f is used inside o
39f0: 66 20 61 73 73 65 72 74 28 29 20 6f 6e 6c 79 20 f assert() only
3a00: 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 56 65 72 69 66 ****.**.** Verif
3a10: 79 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f y that the curso
3a20: 72 20 68 6f 6c 64 73 20 74 68 65 20 6d 75 74 65 r holds the mute
3a30: 78 20 6f 6e 20 69 74 73 20 42 74 53 68 61 72 65 x on its BtShare
3a40: 64 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 d.*/.#ifdef SQLI
3a50: 54 45 5f 44 45 42 55 47 0a 73 74 61 74 69 63 20 TE_DEBUG.static
3a60: 69 6e 74 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d int cursorHoldsM
3a70: 75 74 65 78 28 42 74 43 75 72 73 6f 72 20 2a 70 utex(BtCursor *p
3a80: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
3a90: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
3aa0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a 7d ->pBt->mutex);.}
3ab0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
3ac0: 6e 76 61 6c 69 64 61 74 65 20 74 68 65 20 6f 76 nvalidate the ov
3ad0: 65 72 66 6c 6f 77 20 63 61 63 68 65 20 6f 66 20 erflow cache of
3ae0: 74 68 65 20 63 75 72 73 6f 72 20 70 61 73 73 65 the cursor passe
3af0: 64 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 d as the first a
3b00: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 20 6f 6e 20 74 rgument..** on t
3b10: 68 65 20 73 68 61 72 65 64 20 62 74 72 65 65 20 he shared btree
3b20: 73 74 72 75 63 74 75 72 65 20 70 42 74 2e 0a 2a structure pBt..*
3b30: 2f 0a 23 64 65 66 69 6e 65 20 69 6e 76 61 6c 69 /.#define invali
3b40: 64 61 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 dateOverflowCach
3b50: 65 28 70 43 75 72 29 20 28 70 43 75 72 2d 3e 63 e(pCur) (pCur->c
3b60: 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 46 urFlags &= ~BTCF
3b70: 5f 56 61 6c 69 64 4f 76 66 6c 29 0a 0a 2f 2a 0a _ValidOvfl)../*.
3b80: 2a 2a 20 49 6e 76 61 6c 69 64 61 74 65 20 74 68 ** Invalidate th
3b90: 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d e overflow page-
3ba0: 6c 69 73 74 20 63 61 63 68 65 20 66 6f 72 20 61 list cache for a
3bb0: 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 ll cursors opene
3bc0: 64 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 72 d.** on the shar
3bd0: 65 64 20 62 74 72 65 65 20 73 74 72 75 63 74 75 ed btree structu
3be0: 72 65 20 70 42 74 2e 0a 2a 2f 0a 73 74 61 74 69 re pBt..*/.stati
3bf0: 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 74 c void invalidat
3c00: 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 eAllOverflowCach
3c10: 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 e(BtShared *pBt)
3c20: 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b {. BtCursor *p;
3c30: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
3c40: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
3c50: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 t->mutex) );. f
3c60: 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f or(p=pBt->pCurso
3c70: 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 r; p; p=p->pNext
3c80: 29 7b 0a 20 20 20 20 69 6e 76 61 6c 69 64 61 74 ){. invalidat
3c90: 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 eOverflowCache(p
3ca0: 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 );. }.}..#ifnde
3cb0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e f SQLITE_OMIT_IN
3cc0: 43 52 42 4c 4f 42 0a 2f 2a 0a 2a 2a 20 54 68 69 CRBLOB./*.** Thi
3cd0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
3ce0: 6c 6c 65 64 20 62 65 66 6f 72 65 20 6d 6f 64 69 lled before modi
3cf0: 66 79 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e fying the conten
3d00: 74 73 20 6f 66 20 61 20 74 61 62 6c 65 0a 2a 2a ts of a table.**
3d10: 20 74 6f 20 69 6e 76 61 6c 69 64 61 74 65 20 61 to invalidate a
3d20: 6e 79 20 69 6e 63 72 62 6c 6f 62 20 63 75 72 73 ny incrblob curs
3d30: 6f 72 73 20 74 68 61 74 20 61 72 65 20 6f 70 65 ors that are ope
3d40: 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 72 6f 77 20 n on the.** row
3d50: 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 6f or one of the ro
3d60: 77 73 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 ws being modifie
3d70: 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 72 67 75 d..**.** If argu
3d80: 6d 65 6e 74 20 69 73 43 6c 65 61 72 54 61 62 6c ment isClearTabl
3d90: 65 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 e is true, then
3da0: 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 the entire conte
3db0: 6e 74 73 20 6f 66 20 74 68 65 0a 2a 2a 20 74 61 nts of the.** ta
3dc0: 62 6c 65 20 69 73 20 61 62 6f 75 74 20 74 6f 20 ble is about to
3dd0: 62 65 20 64 65 6c 65 74 65 64 2e 20 49 6e 20 74 be deleted. In t
3de0: 68 69 73 20 63 61 73 65 20 69 6e 76 61 6c 69 64 his case invalid
3df0: 61 74 65 20 61 6c 6c 20 69 6e 63 72 62 6c 6f 62 ate all incrblob
3e00: 0a 2a 2a 20 63 75 72 73 6f 72 73 20 6f 70 65 6e .** cursors open
3e10: 20 6f 6e 20 61 6e 79 20 72 6f 77 20 77 69 74 68 on any row with
3e20: 69 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 in the table wit
3e30: 68 20 72 6f 6f 74 2d 70 61 67 65 20 70 67 6e 6f h root-page pgno
3e40: 52 6f 6f 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 Root..**.** Othe
3e50: 72 77 69 73 65 2c 20 69 66 20 61 72 67 75 6d 65 rwise, if argume
3e60: 6e 74 20 69 73 43 6c 65 61 72 54 61 62 6c 65 20 nt isClearTable
3e70: 69 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 74 is false, then t
3e80: 68 65 20 72 6f 77 20 77 69 74 68 0a 2a 2a 20 72 he row with.** r
3e90: 6f 77 69 64 20 69 52 6f 77 20 69 73 20 62 65 69 owid iRow is bei
3ea0: 6e 67 20 72 65 70 6c 61 63 65 64 20 6f 72 20 64 ng replaced or d
3eb0: 65 6c 65 74 65 64 2e 20 49 6e 20 74 68 69 73 20 eleted. In this
3ec0: 63 61 73 65 20 69 6e 76 61 6c 69 64 61 74 65 0a case invalidate.
3ed0: 2a 2a 20 6f 6e 6c 79 20 74 68 6f 73 65 20 69 6e ** only those in
3ee0: 63 72 62 6c 6f 62 20 63 75 72 73 6f 72 73 20 6f crblob cursors o
3ef0: 70 65 6e 20 6f 6e 20 74 68 61 74 20 73 70 65 63 pen on that spec
3f00: 69 66 69 63 20 72 6f 77 2e 0a 2a 2f 0a 73 74 61 ific row..*/.sta
3f10: 74 69 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 tic void invalid
3f20: 61 74 65 49 6e 63 72 62 6c 6f 62 43 75 72 73 6f ateIncrblobCurso
3f30: 72 73 28 0a 20 20 42 74 72 65 65 20 2a 70 42 74 rs(. Btree *pBt
3f40: 72 65 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a ree, /*
3f50: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 The database fi
3f60: 6c 65 20 74 6f 20 63 68 65 63 6b 20 2a 2f 0a 20 le to check */.
3f70: 20 69 36 34 20 69 52 6f 77 2c 20 20 20 20 20 20 i64 iRow,
3f80: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
3f90: 72 6f 77 69 64 20 74 68 61 74 20 6d 69 67 68 74 rowid that might
3fa0: 20 62 65 20 63 68 61 6e 67 69 6e 67 20 2a 2f 0a be changing */.
3fb0: 20 20 69 6e 74 20 69 73 43 6c 65 61 72 54 61 62 int isClearTab
3fc0: 6c 65 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 le /* Tru
3fd0: 65 20 69 66 20 61 6c 6c 20 72 6f 77 73 20 61 72 e if all rows ar
3fe0: 65 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 e being deleted
3ff0: 2a 2f 0a 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 */.){. BtCursor
4000: 20 2a 70 3b 0a 20 20 42 74 53 68 61 72 65 64 20 *p;. BtShared
4010: 2a 70 42 74 20 3d 20 70 42 74 72 65 65 2d 3e 70 *pBt = pBtree->p
4020: 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 Bt;. assert( sq
4030: 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d lite3BtreeHoldsM
4040: 75 74 65 78 28 70 42 74 72 65 65 29 20 29 3b 0a utex(pBtree) );.
4050: 20 20 66 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 for(p=pBt->pCu
4060: 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e rsor; p; p=p->pN
4070: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 28 70 ext){. if( (p
4080: 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
4090: 46 5f 49 6e 63 72 62 6c 6f 62 29 21 3d 30 0a 20 F_Incrblob)!=0.
40a0: 20 20 20 20 26 26 20 28 69 73 43 6c 65 61 72 54 && (isClearT
40b0: 61 62 6c 65 20 7c 7c 20 70 2d 3e 69 6e 66 6f 2e able || p->info.
40c0: 6e 4b 65 79 3d 3d 69 52 6f 77 29 0a 20 20 20 20 nKey==iRow).
40d0: 29 7b 0a 20 20 20 20 20 20 70 2d 3e 65 53 74 61 ){. p->eSta
40e0: 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 te = CURSOR_INVA
40f0: 4c 49 44 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d LID;. }. }.}
4100: 0a 0a 23 65 6c 73 65 0a 20 20 2f 2a 20 53 74 75 ..#else. /* Stu
4110: 62 20 66 75 6e 63 74 69 6f 6e 20 77 68 65 6e 20 b function when
4120: 49 4e 43 52 42 4c 4f 42 20 69 73 20 6f 6d 69 74 INCRBLOB is omit
4130: 74 65 64 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 ted */. #define
4140: 20 69 6e 76 61 6c 69 64 61 74 65 49 6e 63 72 62 invalidateIncrb
4150: 6c 6f 62 43 75 72 73 6f 72 73 28 78 2c 79 2c 7a lobCursors(x,y,z
4160: 29 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 ).#endif /* SQLI
4170: 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 TE_OMIT_INCRBLOB
4180: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 62 */../*.** Set b
4190: 69 74 20 70 67 6e 6f 20 6f 66 20 74 68 65 20 42 it pgno of the B
41a0: 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 tShared.pHasCont
41b0: 65 6e 74 20 62 69 74 76 65 63 2e 20 54 68 69 73 ent bitvec. This
41c0: 20 69 73 20 63 61 6c 6c 65 64 20 0a 2a 2a 20 77 is called .** w
41d0: 68 65 6e 20 61 20 70 61 67 65 20 74 68 61 74 20 hen a page that
41e0: 70 72 65 76 69 6f 75 73 6c 79 20 63 6f 6e 74 61 previously conta
41f0: 69 6e 65 64 20 64 61 74 61 20 62 65 63 6f 6d 65 ined data become
4200: 73 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 s a free-list le
4210: 61 66 20 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2a 0a af .** page..**.
4220: 2a 2a 20 54 68 65 20 42 74 53 68 61 72 65 64 2e ** The BtShared.
4230: 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 76 pHasContent bitv
4240: 65 63 20 65 78 69 73 74 73 20 74 6f 20 77 6f 72 ec exists to wor
4250: 6b 20 61 72 6f 75 6e 64 20 61 6e 20 6f 62 73 63 k around an obsc
4260: 75 72 65 0a 2a 2a 20 62 75 67 20 63 61 75 73 65 ure.** bug cause
4270: 64 20 62 79 20 74 68 65 20 69 6e 74 65 72 61 63 d by the interac
4280: 74 69 6f 6e 20 6f 66 20 74 77 6f 20 75 73 65 66 tion of two usef
4290: 75 6c 20 49 4f 20 6f 70 74 69 6d 69 7a 61 74 69 ul IO optimizati
42a0: 6f 6e 73 20 73 75 72 72 6f 75 6e 64 69 6e 67 0a ons surrounding.
42b0: 2a 2a 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 ** free-list lea
42c0: 66 20 70 61 67 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 f pages:.**.**
42d0: 20 31 29 20 57 68 65 6e 20 61 6c 6c 20 64 61 74 1) When all dat
42e0: 61 20 69 73 20 64 65 6c 65 74 65 64 20 66 72 6f a is deleted fro
42f0: 6d 20 61 20 70 61 67 65 20 61 6e 64 20 74 68 65 m a page and the
4300: 20 70 61 67 65 20 62 65 63 6f 6d 65 73 0a 2a 2a page becomes.**
4310: 20 20 20 20 20 20 61 20 66 72 65 65 2d 6c 69 73 a free-lis
4320: 74 20 6c 65 61 66 20 70 61 67 65 2c 20 74 68 65 t leaf page, the
4330: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 77 72 69 page is not wri
4340: 74 74 65 6e 20 74 6f 20 74 68 65 20 64 61 74 61 tten to the data
4350: 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 28 61 73 base.** (as
4360: 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 free-list leaf
4370: 70 61 67 65 73 20 63 6f 6e 74 61 69 6e 20 6e 6f pages contain no
4380: 20 6d 65 61 6e 69 6e 67 66 75 6c 20 64 61 74 61 meaningful data
4390: 29 2e 20 53 6f 6d 65 74 69 6d 65 73 0a 2a 2a 20 ). Sometimes.**
43a0: 20 20 20 20 20 73 75 63 68 20 61 20 70 61 67 65 such a page
43b0: 20 69 73 20 6e 6f 74 20 65 76 65 6e 20 6a 6f 75 is not even jou
43c0: 72 6e 61 6c 6c 65 64 20 28 61 73 20 69 74 20 77 rnalled (as it w
43d0: 69 6c 6c 20 6e 6f 74 20 62 65 20 6d 6f 64 69 66 ill not be modif
43e0: 69 65 64 2c 0a 2a 2a 20 20 20 20 20 20 77 68 79 ied,.** why
43f0: 20 62 6f 74 68 65 72 20 6a 6f 75 72 6e 61 6c 6c bother journall
4400: 69 6e 67 20 69 74 3f 29 2e 0a 2a 2a 0a 2a 2a 20 ing it?)..**.**
4410: 20 20 32 29 20 57 68 65 6e 20 61 20 66 72 65 65 2) When a free
4420: 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 20 -list leaf page
4430: 69 73 20 72 65 75 73 65 64 2c 20 69 74 73 20 63 is reused, its c
4440: 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 72 65 ontent is not re
4450: 61 64 0a 2a 2a 20 20 20 20 20 20 66 72 6f 6d 20 ad.** from
4460: 74 68 65 20 64 61 74 61 62 61 73 65 20 6f 72 20 the database or
4470: 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 6a written to the j
4480: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 77 68 79 ournal file (why
4490: 20 73 68 6f 75 6c 64 20 69 74 0a 2a 2a 20 20 20 should it.**
44a0: 20 20 20 62 65 2c 20 69 66 20 69 74 20 69 73 20 be, if it is
44b0: 6e 6f 74 20 61 74 20 61 6c 6c 20 6d 65 61 6e 69 not at all meani
44c0: 6e 67 66 75 6c 3f 29 2e 0a 2a 2a 0a 2a 2a 20 42 ngful?)..**.** B
44d0: 79 20 74 68 65 6d 73 65 6c 76 65 73 2c 20 74 68 y themselves, th
44e0: 65 73 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ese optimization
44f0: 73 20 77 6f 72 6b 20 66 69 6e 65 20 61 6e 64 20 s work fine and
4500: 70 72 6f 76 69 64 65 20 61 20 68 61 6e 64 79 0a provide a handy.
4510: 2a 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 62 ** performance b
4520: 6f 6f 73 74 20 74 6f 20 62 75 6c 6b 20 64 65 6c oost to bulk del
4530: 65 74 65 20 6f 72 20 69 6e 73 65 72 74 20 6f 70 ete or insert op
4540: 65 72 61 74 69 6f 6e 73 2e 20 48 6f 77 65 76 65 erations. Howeve
4550: 72 2c 20 69 66 0a 2a 2a 20 61 20 70 61 67 65 20 r, if.** a page
4560: 69 73 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 20 is moved to the
4570: 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 74 68 free-list and th
4580: 65 6e 20 72 65 75 73 65 64 20 77 69 74 68 69 6e en reused within
4590: 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 74 72 61 the same.** tra
45a0: 6e 73 61 63 74 69 6f 6e 2c 20 61 20 70 72 6f 62 nsaction, a prob
45b0: 6c 65 6d 20 63 6f 6d 65 73 20 75 70 2e 20 49 66 lem comes up. If
45c0: 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 the page is not
45d0: 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 77 68 65 6e journalled when
45e0: 0a 2a 2a 20 69 74 20 69 73 20 6d 6f 76 65 64 20 .** it is moved
45f0: 74 6f 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 to the free-list
4600: 20 61 6e 64 20 69 74 20 69 73 20 61 6c 73 6f 20 and it is also
4610: 6e 6f 74 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 77 not journalled w
4620: 68 65 6e 20 69 74 0a 2a 2a 20 69 73 20 65 78 74 hen it.** is ext
4630: 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65 20 racted from the
4640: 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 72 65 free-list and re
4650: 75 73 65 64 2c 20 74 68 65 6e 20 74 68 65 20 6f used, then the o
4660: 72 69 67 69 6e 61 6c 20 64 61 74 61 0a 2a 2a 20 riginal data.**
4670: 6d 61 79 20 62 65 20 6c 6f 73 74 2e 20 49 6e 20 may be lost. In
4680: 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 72 the event of a r
4690: 6f 6c 6c 62 61 63 6b 2c 20 69 74 20 6d 61 79 20 ollback, it may
46a0: 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 0a not be possible.
46b0: 2a 2a 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 ** to restore th
46c0: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 69 74 e database to it
46d0: 73 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 66 69 s original confi
46e0: 67 75 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 guration..**.**
46f0: 54 68 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 20 The solution is
4700: 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 the BtShared.pHa
4710: 73 43 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 2e sContent bitvec.
4720: 20 57 68 65 6e 65 76 65 72 20 61 20 70 61 67 65 Whenever a page
4730: 20 69 73 20 0a 2a 2a 20 6d 6f 76 65 64 20 74 6f is .** moved to
4740: 20 62 65 63 6f 6d 65 20 61 20 66 72 65 65 2d 6c become a free-l
4750: 69 73 74 20 6c 65 61 66 20 70 61 67 65 2c 20 74 ist leaf page, t
4760: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
4770: 20 62 69 74 20 69 73 0a 2a 2a 20 73 65 74 20 69 bit is.** set i
4780: 6e 20 74 68 65 20 62 69 74 76 65 63 2e 20 57 68 n the bitvec. Wh
4790: 65 6e 65 76 65 72 20 61 20 6c 65 61 66 20 70 61 enever a leaf pa
47a0: 67 65 20 69 73 20 65 78 74 72 61 63 74 65 64 20 ge is extracted
47b0: 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 from the free-li
47c0: 73 74 2c 0a 2a 2a 20 6f 70 74 69 6d 69 7a 61 74 st,.** optimizat
47d0: 69 6f 6e 20 32 20 61 62 6f 76 65 20 69 73 20 6f ion 2 above is o
47e0: 6d 69 74 74 65 64 20 69 66 20 74 68 65 20 63 6f mitted if the co
47f0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 rresponding bit
4800: 69 73 20 61 6c 72 65 61 64 79 0a 2a 2a 20 73 65 is already.** se
4810: 74 20 69 6e 20 42 74 53 68 61 72 65 64 2e 70 48 t in BtShared.pH
4820: 61 73 43 6f 6e 74 65 6e 74 2e 20 54 68 65 20 63 asContent. The c
4830: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 62 ontents of the b
4840: 69 74 76 65 63 20 61 72 65 20 63 6c 65 61 72 65 itvec are cleare
4850: 64 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 d.** at the end
4860: 6f 66 20 65 76 65 72 79 20 74 72 61 6e 73 61 63 of every transac
4870: 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
4880: 69 6e 74 20 62 74 72 65 65 53 65 74 48 61 73 43 int btreeSetHasC
4890: 6f 6e 74 65 6e 74 28 42 74 53 68 61 72 65 64 20 ontent(BtShared
48a0: 2a 70 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 *pBt, Pgno pgno)
48b0: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
48c0: 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 21 70 ITE_OK;. if( !p
48d0: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 Bt->pHasContent
48e0: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 ){. assert( p
48f0: 67 6e 6f 3c 3d 70 42 74 2d 3e 6e 50 61 67 65 20 gno<=pBt->nPage
4900: 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 48 61 73 );. pBt->pHas
4910: 43 6f 6e 74 65 6e 74 20 3d 20 73 71 6c 69 74 65 Content = sqlite
4920: 33 42 69 74 76 65 63 43 72 65 61 74 65 28 70 42 3BitvecCreate(pB
4930: 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 69 t->nPage);. i
4940: 66 28 20 21 70 42 74 2d 3e 70 48 61 73 43 6f 6e f( !pBt->pHasCon
4950: 74 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 72 63 tent ){. rc
4960: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b = SQLITE_NOMEM;
4970: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 . }. }. if(
4980: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
4990: 26 20 70 67 6e 6f 3c 3d 73 71 6c 69 74 65 33 42 & pgno<=sqlite3B
49a0: 69 74 76 65 63 53 69 7a 65 28 70 42 74 2d 3e 70 itvecSize(pBt->p
49b0: 48 61 73 43 6f 6e 74 65 6e 74 29 20 29 7b 0a 20 HasContent) ){.
49c0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
49d0: 69 74 76 65 63 53 65 74 28 70 42 74 2d 3e 70 48 itvecSet(pBt->pH
49e0: 61 73 43 6f 6e 74 65 6e 74 2c 20 70 67 6e 6f 29 asContent, pgno)
49f0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
4a00: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 c;.}../*.** Quer
4a10: 79 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 y the BtShared.p
4a20: 48 61 73 43 6f 6e 74 65 6e 74 20 76 65 63 74 6f HasContent vecto
4a30: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 r..**.** This fu
4a40: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
4a50: 20 77 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 when a free-lis
4a60: 74 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 t leaf page is r
4a70: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 0a emoved from the.
4a80: 2a 2a 20 66 72 65 65 2d 6c 69 73 74 20 66 6f 72 ** free-list for
4a90: 20 72 65 75 73 65 2e 20 49 74 20 72 65 74 75 72 reuse. It retur
4aa0: 6e 73 20 66 61 6c 73 65 20 69 66 20 69 74 20 69 ns false if it i
4ab0: 73 20 73 61 66 65 20 74 6f 20 72 65 74 72 69 65 s safe to retrie
4ac0: 76 65 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 66 ve the.** page f
4ad0: 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 6c 61 rom the pager la
4ae0: 79 65 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f yer with the 'no
4af0: 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 -content' flag s
4b00: 65 74 2e 20 54 72 75 65 20 6f 74 68 65 72 77 69 et. True otherwi
4b10: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e se..*/.static in
4b20: 74 20 62 74 72 65 65 47 65 74 48 61 73 43 6f 6e t btreeGetHasCon
4b30: 74 65 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 tent(BtShared *p
4b40: 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a Bt, Pgno pgno){.
4b50: 20 20 42 69 74 76 65 63 20 2a 70 20 3d 20 70 42 Bitvec *p = pB
4b60: 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 3b 0a t->pHasContent;.
4b70: 20 20 72 65 74 75 72 6e 20 28 70 20 26 26 20 28 return (p && (
4b80: 70 67 6e 6f 3e 73 71 6c 69 74 65 33 42 69 74 76 pgno>sqlite3Bitv
4b90: 65 63 53 69 7a 65 28 70 29 20 7c 7c 20 73 71 6c ecSize(p) || sql
4ba0: 69 74 65 33 42 69 74 76 65 63 54 65 73 74 28 70 ite3BitvecTest(p
4bb0: 2c 20 70 67 6e 6f 29 29 29 3b 0a 7d 0a 0a 2f 2a , pgno)));.}../*
4bc0: 0a 2a 2a 20 43 6c 65 61 72 20 28 64 65 73 74 72 .** Clear (destr
4bd0: 6f 79 29 20 74 68 65 20 42 74 53 68 61 72 65 64 oy) the BtShared
4be0: 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 .pHasContent bit
4bf0: 76 65 63 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 vec. This should
4c00: 20 62 65 0a 2a 2a 20 69 6e 76 6f 6b 65 64 20 61 be.** invoked a
4c10: 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
4c20: 20 6f 66 20 65 61 63 68 20 77 72 69 74 65 2d 74 of each write-t
4c30: 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 ransaction..*/.s
4c40: 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
4c50: 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
4c60: 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
4c70: 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 sqlite3BitvecD
4c80: 65 73 74 72 6f 79 28 70 42 74 2d 3e 70 48 61 73 estroy(pBt->pHas
4c90: 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 70 42 74 2d Content);. pBt-
4ca0: 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 3d 20 30 >pHasContent = 0
4cb0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 ;.}../*.** Relea
4cc0: 73 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 70 se all of the ap
4cd0: 50 61 67 65 5b 5d 20 70 61 67 65 73 20 66 6f 72 Page[] pages for
4ce0: 20 61 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 73 74 a cursor..*/.st
4cf0: 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 52 atic void btreeR
4d00: 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 eleaseAllCursorP
4d10: 61 67 65 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ages(BtCursor *p
4d20: 43 75 72 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 Cur){. int i;.
4d30: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d 70 43 75 for(i=0; i<=pCu
4d40: 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 7b 0a r->iPage; i++){.
4d50: 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
4d60: 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 29 pCur->apPage[i])
4d70: 3b 0a 20 20 20 20 70 43 75 72 2d 3e 61 70 50 61 ;. pCur->apPa
4d80: 67 65 5b 69 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 ge[i] = 0;. }.
4d90: 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d pCur->iPage = -
4da0: 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 1;.}.../*.** Sav
4db0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 e the current cu
4dc0: 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e 20 69 6e rsor position in
4dd0: 20 74 68 65 20 76 61 72 69 61 62 6c 65 73 20 42 the variables B
4de0: 74 43 75 72 73 6f 72 2e 6e 4b 65 79 20 0a 2a 2a tCursor.nKey .**
4df0: 20 61 6e 64 20 42 74 43 75 72 73 6f 72 2e 70 4b and BtCursor.pK
4e00: 65 79 2e 20 54 68 65 20 63 75 72 73 6f 72 27 73 ey. The cursor's
4e10: 20 73 74 61 74 65 20 69 73 20 73 65 74 20 74 6f state is set to
4e20: 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 CURSOR_REQUIRES
4e30: 45 45 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 EEK..**.** The c
4e40: 61 6c 6c 65 72 20 6d 75 73 74 20 65 6e 73 75 72 aller must ensur
4e50: 65 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f e that the curso
4e60: 72 20 69 73 20 76 61 6c 69 64 20 28 68 61 73 20 r is valid (has
4e70: 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
4e80: 41 4c 49 44 29 0a 2a 2a 20 70 72 69 6f 72 20 74 ALID).** prior t
4e90: 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 72 o calling this r
4ea0: 6f 75 74 69 6e 65 2e 20 20 0a 2a 2f 0a 73 74 61 outine. .*/.sta
4eb0: 74 69 63 20 69 6e 74 20 73 61 76 65 43 75 72 73 tic int saveCurs
4ec0: 6f 72 50 6f 73 69 74 69 6f 6e 28 42 74 43 75 72 orPosition(BtCur
4ed0: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 6e sor *pCur){. in
4ee0: 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 t rc;.. assert(
4ef0: 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 CURSOR_VALID==p
4f00: 43 75 72 2d 3e 65 53 74 61 74 65 20 29 3b 0a 20 Cur->eState );.
4f10: 20 61 73 73 65 72 74 28 20 30 3d 3d 70 43 75 72 assert( 0==pCur
4f20: 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 61 73 73 65 ->pKey );. asse
4f30: 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
4f40: 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 0a 20 utex(pCur) );..
4f50: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 rc = sqlite3Btr
4f60: 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20 eeKeySize(pCur,
4f70: 26 70 43 75 72 2d 3e 6e 4b 65 79 29 3b 0a 20 20 &pCur->nKey);.
4f80: 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
4f90: 54 45 5f 4f 4b 20 29 3b 20 20 2f 2a 20 4b 65 79 TE_OK ); /* Key
4fa0: 53 69 7a 65 28 29 20 63 61 6e 6e 6f 74 20 66 61 Size() cannot fa
4fb0: 69 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 20 74 il */.. /* If t
4fc0: 68 69 73 20 69 73 20 61 6e 20 69 6e 74 4b 65 79 his is an intKey
4fd0: 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 74 68 65 table, then the
4fe0: 20 61 62 6f 76 65 20 63 61 6c 6c 20 74 6f 20 42 above call to B
4ff0: 74 72 65 65 4b 65 79 53 69 7a 65 28 29 0a 20 20 treeKeySize().
5000: 2a 2a 20 73 74 6f 72 65 73 20 74 68 65 20 69 6e ** stores the in
5010: 74 65 67 65 72 20 6b 65 79 20 69 6e 20 70 43 75 teger key in pCu
5020: 72 2d 3e 6e 4b 65 79 2e 20 49 6e 20 74 68 69 73 r->nKey. In this
5030: 20 63 61 73 65 20 74 68 69 73 20 76 61 6c 75 65 case this value
5040: 20 69 73 0a 20 20 2a 2a 20 61 6c 6c 20 74 68 61 is. ** all tha
5050: 74 20 69 73 20 72 65 71 75 69 72 65 64 2e 20 4f t is required. O
5060: 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 43 75 therwise, if pCu
5070: 72 20 69 73 20 6e 6f 74 20 6f 70 65 6e 20 6f 6e r is not open on
5080: 20 61 6e 20 69 6e 74 4b 65 79 0a 20 20 2a 2a 20 an intKey. **
5090: 74 61 62 6c 65 2c 20 74 68 65 6e 20 6d 61 6c 6c table, then mall
50a0: 6f 63 20 73 70 61 63 65 20 66 6f 72 20 61 6e 64 oc space for and
50b0: 20 73 74 6f 72 65 20 74 68 65 20 70 43 75 72 2d store the pCur-
50c0: 3e 6e 4b 65 79 20 62 79 74 65 73 20 6f 66 20 6b >nKey bytes of k
50d0: 65 79 20 0a 20 20 2a 2a 20 64 61 74 61 2e 0a 20 ey . ** data..
50e0: 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 70 43 75 */. if( 0==pCu
50f0: 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e r->apPage[0]->in
5100: 74 4b 65 79 20 29 7b 0a 20 20 20 20 76 6f 69 64 tKey ){. void
5110: 20 2a 70 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 *pKey = sqlite3
5120: 4d 61 6c 6c 6f 63 28 20 70 43 75 72 2d 3e 6e 4b Malloc( pCur->nK
5130: 65 79 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4b ey );. if( pK
5140: 65 79 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d ey ){. rc =
5150: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 sqlite3BtreeKey
5160: 28 70 43 75 72 2c 20 30 2c 20 28 69 6e 74 29 70 (pCur, 0, (int)p
5170: 43 75 72 2d 3e 6e 4b 65 79 2c 20 70 4b 65 79 29 Cur->nKey, pKey)
5180: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
5190: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
51a0: 20 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 pCur->pKey
51b0: 3d 20 70 4b 65 79 3b 0a 20 20 20 20 20 20 7d 65 = pKey;. }e
51c0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71 6c lse{. sql
51d0: 69 74 65 33 5f 66 72 65 65 28 70 4b 65 79 29 3b ite3_free(pKey);
51e0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
51f0: 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
5200: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 QLITE_NOMEM;.
5210: 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 }. }. assert(
5220: 20 21 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 !pCur->apPage[0
5230: 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 21 70 43 ]->intKey || !pC
5240: 75 72 2d 3e 70 4b 65 79 20 29 3b 0a 0a 20 20 69 ur->pKey );.. i
5250: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
5260: 20 29 7b 0a 20 20 20 20 62 74 72 65 65 52 65 6c ){. btreeRel
5270: 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 easeAllCursorPag
5280: 65 73 28 70 43 75 72 29 3b 0a 20 20 20 20 70 43 es(pCur);. pC
5290: 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
52a0: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 3b SOR_REQUIRESEEK;
52b0: 0a 20 20 7d 0a 0a 20 20 69 6e 76 61 6c 69 64 61 . }.. invalida
52c0: 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 teOverflowCache(
52d0: 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 pCur);. return
52e0: 72 63 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 rc;.}../* Forwar
52f0: 64 20 72 65 66 65 72 65 6e 63 65 20 2a 2f 0a 73 d reference */.s
5300: 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 tatic int SQLITE
5310: 5f 4e 4f 49 4e 4c 49 4e 45 20 73 61 76 65 43 75 _NOINLINE saveCu
5320: 72 73 6f 72 73 4f 6e 4c 69 73 74 28 42 74 43 75 rsorsOnList(BtCu
5330: 72 73 6f 72 2a 2c 50 67 6e 6f 2c 42 74 43 75 72 rsor*,Pgno,BtCur
5340: 73 6f 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 53 61 sor*);../*.** Sa
5350: 76 65 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 73 ve the positions
5360: 20 6f 66 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 of all cursors
5370: 28 65 78 63 65 70 74 20 70 45 78 63 65 70 74 29 (except pExcept)
5380: 20 74 68 61 74 20 61 72 65 20 6f 70 65 6e 20 6f that are open o
5390: 6e 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 77 n.** the table w
53a0: 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 52 ith root-page iR
53b0: 6f 6f 74 2e 20 20 22 53 61 76 69 6e 67 20 74 68 oot. "Saving th
53c0: 65 20 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f e cursor positio
53d0: 6e 22 20 6d 65 61 6e 73 20 74 68 61 74 0a 2a 2a n" means that.**
53e0: 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e 20 69 6e the location in
53f0: 20 74 68 65 20 62 74 72 65 65 20 69 73 20 72 65 the btree is re
5400: 6d 65 6d 62 65 72 65 64 20 69 6e 20 73 75 63 68 membered in such
5410: 20 61 20 77 61 79 20 74 68 61 74 20 69 74 20 63 a way that it c
5420: 61 6e 20 62 65 0a 2a 2a 20 6d 6f 76 65 64 20 62 an be.** moved b
5430: 61 63 6b 20 74 6f 20 74 68 65 20 73 61 6d 65 20 ack to the same
5440: 73 70 6f 74 20 61 66 74 65 72 20 74 68 65 20 62 spot after the b
5450: 74 72 65 65 20 68 61 73 20 62 65 65 6e 20 6d 6f tree has been mo
5460: 64 69 66 69 65 64 2e 20 20 54 68 69 73 0a 2a 2a dified. This.**
5470: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c routine is call
5480: 65 64 20 6a 75 73 74 20 62 65 66 6f 72 65 20 63 ed just before c
5490: 75 72 73 6f 72 20 70 45 78 63 65 70 74 20 69 73 ursor pExcept is
54a0: 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 used to modify
54b0: 74 68 65 0a 2a 2a 20 74 61 62 6c 65 2c 20 66 6f the.** table, fo
54c0: 72 20 65 78 61 6d 70 6c 65 20 69 6e 20 42 74 72 r example in Btr
54d0: 65 65 44 65 6c 65 74 65 28 29 20 6f 72 20 42 74 eeDelete() or Bt
54e0: 72 65 65 49 6e 73 65 72 74 28 29 2e 0a 2a 2a 0a reeInsert()..**.
54f0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ** Implementatio
5500: 6e 20 6e 6f 74 65 3a 20 20 54 68 69 73 20 72 6f n note: This ro
5510: 75 74 69 6e 65 20 6d 65 72 65 6c 79 20 63 68 65 utine merely che
5520: 63 6b 73 20 74 6f 20 73 65 65 20 69 66 20 61 6e cks to see if an
5530: 79 20 63 75 72 73 6f 72 73 0a 2a 2a 20 6e 65 65 y cursors.** nee
5540: 64 20 74 6f 20 62 65 20 73 61 76 65 64 2e 20 20 d to be saved.
5550: 49 74 20 63 61 6c 6c 73 20 6f 75 74 20 74 6f 20 It calls out to
5560: 73 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 saveCursorsOnLis
5570: 74 28 29 20 69 6e 20 74 68 65 20 28 75 6e 75 73 t() in the (unus
5580: 75 61 6c 29 0a 2a 2a 20 65 76 65 6e 74 20 74 68 ual).** event th
5590: 61 74 20 63 75 72 73 6f 72 73 20 61 72 65 20 69 at cursors are i
55a0: 6e 20 6e 65 65 64 20 74 6f 20 62 65 69 6e 67 20 n need to being
55b0: 73 61 76 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 saved..*/.static
55c0: 20 69 6e 74 20 73 61 76 65 41 6c 6c 43 75 72 73 int saveAllCurs
55d0: 6f 72 73 28 42 74 53 68 61 72 65 64 20 2a 70 42 ors(BtShared *pB
55e0: 74 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 42 t, Pgno iRoot, B
55f0: 74 43 75 72 73 6f 72 20 2a 70 45 78 63 65 70 74 tCursor *pExcept
5600: 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 ){. BtCursor *p
5610: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
5620: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
5630: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
5640: 61 73 73 65 72 74 28 20 70 45 78 63 65 70 74 3d assert( pExcept=
5650: 3d 30 20 7c 7c 20 70 45 78 63 65 70 74 2d 3e 70 =0 || pExcept->p
5660: 42 74 3d 3d 70 42 74 20 29 3b 0a 20 20 66 6f 72 Bt==pBt );. for
5670: 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b (p=pBt->pCursor;
5680: 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b p; p=p->pNext){
5690: 0a 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 . if( p!=pExc
56a0: 65 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 ept && (0==iRoot
56b0: 20 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d || p->pgnoRoot=
56c0: 3d 69 52 6f 6f 74 29 20 29 20 62 72 65 61 6b 3b =iRoot) ) break;
56d0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 20 . }. return p
56e0: 3f 20 73 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c ? saveCursorsOnL
56f0: 69 73 74 28 70 2c 20 69 52 6f 6f 74 2c 20 70 45 ist(p, iRoot, pE
5700: 78 63 65 70 74 29 20 3a 20 53 51 4c 49 54 45 5f xcept) : SQLITE_
5710: 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 54 68 69 73 20 68 OK;.}../* This h
5720: 65 6c 70 65 72 20 72 6f 75 74 69 6e 65 20 74 6f elper routine to
5730: 20 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 20 saveAllCursors
5740: 64 6f 65 73 20 74 68 65 20 61 63 74 75 61 6c 20 does the actual
5750: 77 6f 72 6b 20 6f 66 20 73 61 76 69 6e 67 0a 2a work of saving.*
5760: 2a 20 74 68 65 20 63 75 72 73 6f 72 73 20 69 66 * the cursors if
5770: 20 61 6e 64 20 77 68 65 6e 20 61 20 63 75 72 73 and when a curs
5780: 6f 72 20 69 73 20 66 6f 75 6e 64 20 74 68 61 74 or is found that
5790: 20 61 63 74 75 61 6c 6c 79 20 72 65 71 75 69 72 actually requir
57a0: 65 73 20 73 61 76 69 6e 67 2e 0a 2a 2a 20 54 68 es saving..** Th
57b0: 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 69 73 e common case is
57c0: 20 74 68 61 74 20 6e 6f 20 63 75 72 73 6f 72 73 that no cursors
57d0: 20 6e 65 65 64 20 74 6f 20 62 65 20 73 61 76 65 need to be save
57e0: 64 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 d, so this routi
57f0: 6e 65 20 69 73 0a 2a 2a 20 62 72 6f 6b 65 6e 20 ne is.** broken
5800: 6f 75 74 20 66 72 6f 6d 20 69 74 73 20 63 61 6c out from its cal
5810: 6c 65 72 20 74 6f 20 61 76 6f 69 64 20 75 6e 6e ler to avoid unn
5820: 65 63 65 73 73 61 72 79 20 73 74 61 63 6b 20 70 ecessary stack p
5830: 6f 69 6e 74 65 72 20 6d 6f 76 65 6d 65 6e 74 2e ointer movement.
5840: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 .*/.static int S
5850: 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 73 QLITE_NOINLINE s
5860: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
5870: 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 2c (. BtCursor *p,
5880: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
5890: 66 69 72 73 74 20 63 75 72 73 6f 72 20 74 68 61 first cursor tha
58a0: 74 20 6e 65 65 64 73 20 73 61 76 69 6e 67 20 2a t needs saving *
58b0: 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 /. Pgno iRoot,
58c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 6c 79 /* Only
58d0: 20 73 61 76 65 20 63 75 72 73 6f 72 20 77 69 74 save cursor wit
58e0: 68 20 74 68 69 73 20 69 52 6f 6f 74 2e 20 53 61 h this iRoot. Sa
58f0: 76 65 20 61 6c 6c 20 69 66 20 7a 65 72 6f 20 2a ve all if zero *
5900: 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 45 /. BtCursor *pE
5910: 78 63 65 70 74 20 20 20 20 2f 2a 20 44 6f 20 6e xcept /* Do n
5920: 6f 74 20 73 61 76 65 20 74 68 69 73 20 63 75 72 ot save this cur
5930: 73 6f 72 20 2a 2f 0a 29 7b 0a 20 20 64 6f 7b 0a sor */.){. do{.
5940: 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 65 if( p!=pExce
5950: 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 pt && (0==iRoot
5960: 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d || p->pgnoRoot==
5970: 69 52 6f 6f 74 29 20 29 7b 0a 20 20 20 20 20 20 iRoot) ){.
5980: 69 66 28 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 if( p->eState==C
5990: 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 URSOR_VALID ){.
59a0: 20 20 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 int rc =
59b0: 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 saveCursorPositi
59c0: 6f 6e 28 70 29 3b 0a 20 20 20 20 20 20 20 20 69 on(p);. i
59d0: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 f( SQLITE_OK!=rc
59e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
59f0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 turn rc;.
5a00: 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
5a10: 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
5a20: 28 20 70 2d 3e 69 50 61 67 65 3e 30 20 29 3b 0a ( p->iPage>0 );.
5a30: 20 20 20 20 20 20 20 20 62 74 72 65 65 52 65 6c btreeRel
5a40: 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 easeAllCursorPag
5a50: 65 73 28 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 es(p);. }.
5a60: 20 20 20 7d 0a 20 20 20 20 70 20 3d 20 70 2d 3e }. p = p->
5a70: 70 4e 65 78 74 3b 0a 20 20 7d 77 68 69 6c 65 28 pNext;. }while(
5a80: 20 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 p );. return S
5a90: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
5aa0: 2a 2a 20 43 6c 65 61 72 20 74 68 65 20 63 75 72 ** Clear the cur
5ab0: 72 65 6e 74 20 63 75 72 73 6f 72 20 70 6f 73 69 rent cursor posi
5ac0: 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 tion..*/.void sq
5ad0: 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 lite3BtreeClearC
5ae0: 75 72 73 6f 72 28 42 74 43 75 72 73 6f 72 20 2a ursor(BtCursor *
5af0: 70 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 pCur){. assert(
5b00: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
5b10: 78 28 70 43 75 72 29 20 29 3b 0a 20 20 73 71 6c x(pCur) );. sql
5b20: 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e ite3_free(pCur->
5b30: 70 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e 70 pKey);. pCur->p
5b40: 4b 65 79 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d Key = 0;. pCur-
5b50: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
5b60: 5f 49 4e 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a _INVALID;.}../*.
5b70: 2a 2a 20 49 6e 20 74 68 69 73 20 76 65 72 73 69 ** In this versi
5b80: 6f 6e 20 6f 66 20 42 74 72 65 65 4d 6f 76 65 74 on of BtreeMovet
5b90: 6f 2c 20 70 4b 65 79 20 69 73 20 61 20 70 61 63 o, pKey is a pac
5ba0: 6b 65 64 20 69 6e 64 65 78 20 72 65 63 6f 72 64 ked index record
5bb0: 0a 2a 2a 20 73 75 63 68 20 61 73 20 69 73 20 67 .** such as is g
5bc0: 65 6e 65 72 61 74 65 64 20 62 79 20 74 68 65 20 enerated by the
5bd0: 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 OP_MakeRecord op
5be0: 63 6f 64 65 2e 20 20 55 6e 70 61 63 6b 20 74 68 code. Unpack th
5bf0: 65 0a 2a 2a 20 72 65 63 6f 72 64 20 61 6e 64 20 e.** record and
5c00: 74 68 65 6e 20 63 61 6c 6c 20 42 74 72 65 65 4d then call BtreeM
5c10: 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 29 20 ovetoUnpacked()
5c20: 74 6f 20 64 6f 20 74 68 65 20 77 6f 72 6b 2e 0a to do the work..
5c30: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
5c40: 72 65 65 4d 6f 76 65 74 6f 28 0a 20 20 42 74 43 reeMoveto(. BtC
5c50: 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 ursor *pCur,
5c60: 20 2f 2a 20 43 75 72 73 6f 72 20 6f 70 65 6e 20 /* Cursor open
5c70: 6f 6e 20 74 68 65 20 62 74 72 65 65 20 74 6f 20 on the btree to
5c80: 62 65 20 73 65 61 72 63 68 65 64 20 2a 2f 0a 20 be searched */.
5c90: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
5ca0: 79 2c 20 20 20 2f 2a 20 50 61 63 6b 65 64 20 6b y, /* Packed k
5cb0: 65 79 20 69 66 20 74 68 65 20 62 74 72 65 65 20 ey if the btree
5cc0: 69 73 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 20 is an index */.
5cd0: 20 69 36 34 20 6e 4b 65 79 2c 20 20 20 20 20 20 i64 nKey,
5ce0: 20 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 /* Integer
5cf0: 6b 65 79 20 66 6f 72 20 74 61 62 6c 65 73 2e 20 key for tables.
5d00: 20 53 69 7a 65 20 6f 66 20 70 4b 65 79 20 66 6f Size of pKey fo
5d10: 72 20 69 6e 64 69 63 65 73 20 2a 2f 0a 20 20 69 r indices */. i
5d20: 6e 74 20 62 69 61 73 2c 20 20 20 20 20 20 20 20 nt bias,
5d30: 20 20 20 2f 2a 20 42 69 61 73 20 73 65 61 72 63 /* Bias searc
5d40: 68 20 74 6f 20 74 68 65 20 68 69 67 68 20 65 6e h to the high en
5d50: 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 d */. int *pRes
5d60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 /* Wr
5d70: 69 74 65 20 73 65 61 72 63 68 20 72 65 73 75 6c ite search resul
5d80: 74 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 ts here */.){.
5d90: 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
5da0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 /* St
5db0: 61 74 75 73 20 63 6f 64 65 20 2a 2f 0a 20 20 55 atus code */. U
5dc0: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 npackedRecord *p
5dd0: 49 64 78 4b 65 79 3b 20 20 20 2f 2a 20 55 6e 70 IdxKey; /* Unp
5de0: 61 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 79 20 acked index key
5df0: 2a 2f 0a 20 20 63 68 61 72 20 61 53 70 61 63 65 */. char aSpace
5e00: 5b 32 30 30 5d 3b 20 20 20 20 20 20 20 20 20 20 [200];
5e10: 2f 2a 20 54 65 6d 70 20 73 70 61 63 65 20 66 6f /* Temp space fo
5e20: 72 20 70 49 64 78 4b 65 79 20 2d 20 74 6f 20 61 r pIdxKey - to a
5e30: 76 6f 69 64 20 61 20 6d 61 6c 6c 6f 63 20 2a 2f void a malloc */
5e40: 0a 20 20 63 68 61 72 20 2a 70 46 72 65 65 20 3d . char *pFree =
5e50: 20 30 3b 0a 0a 20 20 69 66 28 20 70 4b 65 79 20 0;.. if( pKey
5e60: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e ){. assert( n
5e70: 4b 65 79 3d 3d 28 69 36 34 29 28 69 6e 74 29 6e Key==(i64)(int)n
5e80: 4b 65 79 20 29 3b 0a 20 20 20 20 70 49 64 78 4b Key );. pIdxK
5e90: 65 79 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 ey = sqlite3Vdbe
5ea0: 41 6c 6c 6f 63 55 6e 70 61 63 6b 65 64 52 65 63 AllocUnpackedRec
5eb0: 6f 72 64 28 0a 20 20 20 20 20 20 20 20 70 43 75 ord(. pCu
5ec0: 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 61 53 70 r->pKeyInfo, aSp
5ed0: 61 63 65 2c 20 73 69 7a 65 6f 66 28 61 53 70 61 ace, sizeof(aSpa
5ee0: 63 65 29 2c 20 26 70 46 72 65 65 0a 20 20 20 20 ce), &pFree.
5ef0: 29 3b 0a 20 20 20 20 69 66 28 20 70 49 64 78 4b );. if( pIdxK
5f00: 65 79 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 ey==0 ) return S
5f10: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 QLITE_NOMEM;.
5f20: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f sqlite3VdbeReco
5f30: 72 64 55 6e 70 61 63 6b 28 70 43 75 72 2d 3e 70 rdUnpack(pCur->p
5f40: 4b 65 79 49 6e 66 6f 2c 20 28 69 6e 74 29 6e 4b KeyInfo, (int)nK
5f50: 65 79 2c 20 70 4b 65 79 2c 20 70 49 64 78 4b 65 ey, pKey, pIdxKe
5f60: 79 29 3b 0a 20 20 20 20 69 66 28 20 70 49 64 78 y);. if( pIdx
5f70: 4b 65 79 2d 3e 6e 46 69 65 6c 64 3d 3d 30 20 29 Key->nField==0 )
5f80: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 {. sqlite3D
5f90: 62 46 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 bFree(pCur->pKey
5fa0: 49 6e 66 6f 2d 3e 64 62 2c 20 70 46 72 65 65 29 Info->db, pFree)
5fb0: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
5fc0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
5fd0: 50 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 PT;. }. }els
5fe0: 65 7b 0a 20 20 20 20 70 49 64 78 4b 65 79 20 3d e{. pIdxKey =
5ff0: 20 30 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 0;. }. rc = s
6000: 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 qlite3BtreeMovet
6010: 6f 55 6e 70 61 63 6b 65 64 28 70 43 75 72 2c 20 oUnpacked(pCur,
6020: 70 49 64 78 4b 65 79 2c 20 6e 4b 65 79 2c 20 62 pIdxKey, nKey, b
6030: 69 61 73 2c 20 70 52 65 73 29 3b 0a 20 20 69 66 ias, pRes);. if
6040: 28 20 70 46 72 65 65 20 29 7b 0a 20 20 20 20 73 ( pFree ){. s
6050: 71 6c 69 74 65 33 44 62 46 72 65 65 28 70 43 75 qlite3DbFree(pCu
6060: 72 2d 3e 70 4b 65 79 49 6e 66 6f 2d 3e 64 62 2c r->pKeyInfo->db,
6070: 20 70 46 72 65 65 29 3b 0a 20 20 7d 0a 20 20 72 pFree);. }. r
6080: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
6090: 2a 2a 20 52 65 73 74 6f 72 65 20 74 68 65 20 63 ** Restore the c
60a0: 75 72 73 6f 72 20 74 6f 20 74 68 65 20 70 6f 73 ursor to the pos
60b0: 69 74 69 6f 6e 20 69 74 20 77 61 73 20 69 6e 20 ition it was in
60c0: 28 6f 72 20 61 73 20 63 6c 6f 73 65 20 74 6f 20 (or as close to
60d0: 61 73 20 70 6f 73 73 69 62 6c 65 29 0a 2a 2a 20 as possible).**
60e0: 77 68 65 6e 20 73 61 76 65 43 75 72 73 6f 72 50 when saveCursorP
60f0: 6f 73 69 74 69 6f 6e 28 29 20 77 61 73 20 63 61 osition() was ca
6100: 6c 6c 65 64 2e 20 4e 6f 74 65 20 74 68 61 74 20 lled. Note that
6110: 74 68 69 73 20 63 61 6c 6c 20 64 65 6c 65 74 65 this call delete
6120: 73 20 74 68 65 20 0a 2a 2a 20 73 61 76 65 64 20 s the .** saved
6130: 70 6f 73 69 74 69 6f 6e 20 69 6e 66 6f 20 73 74 position info st
6140: 6f 72 65 64 20 62 79 20 73 61 76 65 43 75 72 73 ored by saveCurs
6150: 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2c 20 73 6f orPosition(), so
6160: 20 74 68 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a there can be.**
6170: 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 65 66 66 at most one eff
6180: 65 63 74 69 76 65 20 72 65 73 74 6f 72 65 43 75 ective restoreCu
6190: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 20 63 rsorPosition() c
61a0: 61 6c 6c 20 61 66 74 65 72 20 65 61 63 68 20 0a all after each .
61b0: 2a 2a 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 ** saveCursorPos
61c0: 69 74 69 6f 6e 28 29 2e 0a 2a 2f 0a 73 74 61 74 ition()..*/.stat
61d0: 69 63 20 69 6e 74 20 62 74 72 65 65 52 65 73 74 ic int btreeRest
61e0: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
61f0: 6e 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 n(BtCursor *pCur
6200: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 61 ){. int rc;. a
6210: 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
6220: 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
6230: 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
6240: 3e 65 53 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f >eState>=CURSOR_
6250: 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 REQUIRESEEK );.
6260: 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 if( pCur->eStat
6270: 65 3d 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 e==CURSOR_FAULT
6280: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 43 ){. return pC
6290: 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 20 ur->skipNext;.
62a0: 7d 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 }. pCur->eState
62b0: 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 = CURSOR_INVALI
62c0: 44 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 4d D;. rc = btreeM
62d0: 6f 76 65 74 6f 28 70 43 75 72 2c 20 70 43 75 72 oveto(pCur, pCur
62e0: 2d 3e 70 4b 65 79 2c 20 70 43 75 72 2d 3e 6e 4b ->pKey, pCur->nK
62f0: 65 79 2c 20 30 2c 20 26 70 43 75 72 2d 3e 73 6b ey, 0, &pCur->sk
6300: 69 70 4e 65 78 74 29 3b 0a 20 20 69 66 28 20 72 ipNext);. if( r
6310: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
6320: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
6330: 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 20 (pCur->pKey);.
6340: 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 30 pCur->pKey = 0
6350: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 ;. assert( pC
6360: 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
6370: 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 OR_VALID || pCur
6380: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
6390: 5f 49 4e 56 41 4c 49 44 20 29 3b 0a 20 20 20 20 _INVALID );.
63a0: 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 if( pCur->skipNe
63b0: 78 74 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 xt && pCur->eSta
63c0: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
63d0: 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e ){. pCur->
63e0: 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f eState = CURSOR_
63f0: 53 4b 49 50 4e 45 58 54 3b 0a 20 20 20 20 7d 0a SKIPNEXT;. }.
6400: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
6410: 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 72 65 73 74 .}..#define rest
6420: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
6430: 6e 28 70 29 20 5c 0a 20 20 28 70 2d 3e 65 53 74 n(p) \. (p->eSt
6440: 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 ate>=CURSOR_REQU
6450: 49 52 45 53 45 45 4b 20 3f 20 5c 0a 20 20 20 20 IRESEEK ? \.
6460: 20 20 20 20 20 62 74 72 65 65 52 65 73 74 6f 72 btreeRestor
6470: 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
6480: 70 29 20 3a 20 5c 0a 20 20 20 20 20 20 20 20 20 p) : \.
6490: 53 51 4c 49 54 45 5f 4f 4b 29 0a 0a 2f 2a 0a 2a SQLITE_OK)../*.*
64a0: 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 74 * Determine whet
64b0: 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 63 75 72 her or not a cur
64c0: 73 6f 72 20 68 61 73 20 6d 6f 76 65 64 20 66 72 sor has moved fr
64d0: 6f 6d 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 20 om the position
64e0: 77 68 65 72 65 0a 2a 2a 20 69 74 20 77 61 73 20 where.** it was
64f0: 6c 61 73 74 20 70 6c 61 63 65 64 2c 20 6f 72 20 last placed, or
6500: 68 61 73 20 62 65 65 6e 20 69 6e 76 61 6c 69 64 has been invalid
6510: 61 74 65 64 20 66 6f 72 20 61 6e 79 20 6f 74 68 ated for any oth
6520: 65 72 20 72 65 61 73 6f 6e 2e 0a 2a 2a 20 43 75 er reason..** Cu
6530: 72 73 6f 72 73 20 63 61 6e 20 6d 6f 76 65 20 77 rsors can move w
6540: 68 65 6e 20 74 68 65 20 72 6f 77 20 74 68 65 79 hen the row they
6550: 20 61 72 65 20 70 6f 69 6e 74 69 6e 67 20 61 74 are pointing at
6560: 20 69 73 20 64 65 6c 65 74 65 64 20 6f 75 74 0a is deleted out.
6570: 2a 2a 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 ** from under th
6580: 65 6d 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2e em, for example.
6590: 20 20 43 75 72 73 6f 72 20 6d 69 67 68 74 20 61 Cursor might a
65a0: 6c 73 6f 20 6d 6f 76 65 20 69 66 20 61 20 62 74 lso move if a bt
65b0: 72 65 65 0a 2a 2a 20 69 73 20 72 65 62 61 6c 61 ree.** is rebala
65c0: 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c nced..**.** Call
65d0: 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ing this routine
65e0: 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 63 75 72 with a NULL cur
65f0: 73 6f 72 20 70 6f 69 6e 74 65 72 20 72 65 74 75 sor pointer retu
6600: 72 6e 73 20 66 61 6c 73 65 2e 0a 2a 2a 0a 2a 2a rns false..**.**
6610: 20 55 73 65 20 74 68 65 20 73 65 70 61 72 61 74 Use the separat
6620: 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 e sqlite3BtreeCu
6630: 72 73 6f 72 52 65 73 74 6f 72 65 28 29 20 72 6f rsorRestore() ro
6640: 75 74 69 6e 65 20 74 6f 20 72 65 73 74 6f 72 65 utine to restore
6650: 20 61 20 63 75 72 73 6f 72 0a 2a 2a 20 62 61 63 a cursor.** bac
6660: 6b 20 74 6f 20 77 68 65 72 65 20 69 74 20 6f 75 k to where it ou
6670: 67 68 74 20 74 6f 20 62 65 20 69 66 20 74 68 69 ght to be if thi
6680: 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e s routine return
6690: 73 20 74 72 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73 s true..*/.int s
66a0: 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f qlite3BtreeCurso
66b0: 72 48 61 73 4d 6f 76 65 64 28 42 74 43 75 72 73 rHasMoved(BtCurs
66c0: 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 65 74 or *pCur){. ret
66d0: 75 72 6e 20 70 43 75 72 20 26 26 20 70 43 75 72 urn pCur && pCur
66e0: 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
66f0: 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a _VALID;.}../*.**
6700: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 This routine re
6710: 73 74 6f 72 65 73 20 61 20 63 75 72 73 6f 72 20 stores a cursor
6720: 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 back to its orig
6730: 69 6e 61 6c 20 70 6f 73 69 74 69 6f 6e 20 61 66 inal position af
6740: 74 65 72 20 69 74 0a 2a 2a 20 68 61 73 20 62 65 ter it.** has be
6750: 65 6e 20 6d 6f 76 65 64 20 62 79 20 73 6f 6d 65 en moved by some
6760: 20 6f 75 74 73 69 64 65 20 61 63 74 69 76 69 74 outside activit
6770: 79 20 28 73 75 63 68 20 61 73 20 61 20 62 74 72 y (such as a btr
6780: 65 65 20 72 65 62 61 6c 61 6e 63 65 20 6f 72 0a ee rebalance or.
6790: 2a 2a 20 61 20 72 6f 77 20 68 61 76 69 6e 67 20 ** a row having
67a0: 62 65 65 6e 20 64 65 6c 65 74 65 64 20 6f 75 74 been deleted out
67b0: 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 20 from under the
67c0: 63 75 72 73 6f 72 29 2e 20 20 0a 2a 2a 0a 2a 2a cursor). .**.**
67d0: 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 65 On success, the
67e0: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
67f0: 70 61 72 61 6d 65 74 65 72 20 69 73 20 66 61 6c parameter is fal
6800: 73 65 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 se if the cursor
6810: 20 69 73 20 6c 65 66 74 0a 2a 2a 20 70 6f 69 6e is left.** poin
6820: 74 69 6e 67 20 61 74 20 65 78 61 63 74 6c 79 20 ting at exactly
6830: 74 68 65 20 73 61 6d 65 20 72 6f 77 2e 20 20 2a the same row. *
6840: 70 44 69 66 66 65 72 6e 74 52 6f 77 20 69 73 20 pDifferntRow is
6850: 74 68 65 20 72 6f 77 20 74 68 65 20 63 75 72 73 the row the curs
6860: 6f 72 0a 2a 2a 20 77 61 73 20 70 6f 69 6e 74 69 or.** was pointi
6870: 6e 67 20 74 6f 20 68 61 73 20 62 65 65 6e 20 64 ng to has been d
6880: 65 6c 65 74 65 64 2c 20 66 6f 72 63 69 6e 67 20 eleted, forcing
6890: 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f the cursor to po
68a0: 69 6e 74 20 74 6f 20 73 6f 6d 65 0a 2a 2a 20 6e int to some.** n
68b0: 65 61 72 62 79 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a earby row..**.**
68c0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 This routine sh
68d0: 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c ould only be cal
68e0: 6c 65 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 led for a cursor
68f0: 20 74 68 61 74 20 6a 75 73 74 20 72 65 74 75 72 that just retur
6900: 6e 65 64 0a 2a 2a 20 54 52 55 45 20 66 72 6f 6d ned.** TRUE from
6910: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 sqlite3BtreeCur
6920: 73 6f 72 48 61 73 4d 6f 76 65 64 28 29 2e 0a 2a sorHasMoved()..*
6930: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
6940: 65 65 43 75 72 73 6f 72 52 65 73 74 6f 72 65 28 eeCursorRestore(
6950: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
6960: 69 6e 74 20 2a 70 44 69 66 66 65 72 65 6e 74 52 int *pDifferentR
6970: 6f 77 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a ow){. int rc;..
6980: 20 20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d assert( pCur!=
6990: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
69a0: 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
69b0: 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 72 SOR_VALID );. r
69c0: 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f c = restoreCurso
69d0: 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b rPosition(pCur);
69e0: 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 . if( rc ){.
69f0: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
6a00: 3d 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 = 1;. return
6a10: 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 rc;. }. if( pC
6a20: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
6a30: 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 4e 45 56 45 OR_VALID || NEVE
6a40: 52 28 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 R(pCur->skipNext
6a50: 21 3d 30 29 20 29 7b 0a 20 20 20 20 2a 70 44 69 !=0) ){. *pDi
6a60: 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a fferentRow = 1;.
6a70: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 44 }else{. *pD
6a80: 69 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 30 3b ifferentRow = 0;
6a90: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
6aa0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e LITE_OK;.}..#ifn
6ab0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
6ac0: 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a AUTOVACUUM./*.**
6ad0: 20 47 69 76 65 6e 20 61 20 70 61 67 65 20 6e 75 Given a page nu
6ae0: 6d 62 65 72 20 6f 66 20 61 20 72 65 67 75 6c 61 mber of a regula
6af0: 72 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2c r database page,
6b00: 20 72 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 return the page
6b10: 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 .** number for t
6b20: 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 he pointer-map p
6b30: 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e age that contain
6b40: 73 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 s the entry for
6b50: 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 70 61 67 the.** input pag
6b60: 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 e number..**.**
6b70: 52 65 74 75 72 6e 20 30 20 28 6e 6f 74 20 61 20 Return 0 (not a
6b80: 76 61 6c 69 64 20 70 61 67 65 29 20 66 6f 72 20 valid page) for
6b90: 70 67 6e 6f 3d 3d 31 20 73 69 6e 63 65 20 74 68 pgno==1 since th
6ba0: 65 72 65 20 69 73 0a 2a 2a 20 6e 6f 20 70 6f 69 ere is.** no poi
6bb0: 6e 74 65 72 20 6d 61 70 20 61 73 73 6f 63 69 61 nter map associa
6bc0: 74 65 64 20 77 69 74 68 20 70 61 67 65 20 31 2e ted with page 1.
6bd0: 20 20 54 68 65 20 69 6e 74 65 67 72 69 74 79 5f The integrity_
6be0: 63 68 65 63 6b 20 6c 6f 67 69 63 0a 2a 2a 20 72 check logic.** r
6bf0: 65 71 75 69 72 65 73 20 74 68 61 74 20 70 74 72 equires that ptr
6c00: 6d 61 70 50 61 67 65 6e 6f 28 2a 2c 31 29 21 3d mapPageno(*,1)!=
6c10: 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 1..*/.static Pgn
6c20: 6f 20 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 42 o ptrmapPageno(B
6c30: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
6c40: 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 no pgno){. int
6c50: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
6c60: 3b 0a 20 20 50 67 6e 6f 20 69 50 74 72 4d 61 70 ;. Pgno iPtrMap
6c70: 2c 20 72 65 74 3b 0a 20 20 61 73 73 65 72 74 28 , ret;. assert(
6c80: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
6c90: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
6ca0: 29 3b 0a 20 20 69 66 28 20 70 67 6e 6f 3c 32 20 );. if( pgno<2
6cb0: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 6e 50 ) return 0;. nP
6cc0: 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 20 3d agesPerMapPage =
6cd0: 20 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a (pBt->usableSiz
6ce0: 65 2f 35 29 2b 31 3b 0a 20 20 69 50 74 72 4d 61 e/5)+1;. iPtrMa
6cf0: 70 20 3d 20 28 70 67 6e 6f 2d 32 29 2f 6e 50 61 p = (pgno-2)/nPa
6d00: 67 65 73 50 65 72 4d 61 70 50 61 67 65 3b 0a 20 gesPerMapPage;.
6d10: 20 72 65 74 20 3d 20 28 69 50 74 72 4d 61 70 2a ret = (iPtrMap*
6d20: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
6d30: 29 20 2b 20 32 3b 20 0a 20 20 69 66 28 20 72 65 ) + 2; . if( re
6d40: 74 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f t==PENDING_BYTE_
6d50: 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
6d60: 20 72 65 74 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 ret++;. }. re
6d70: 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a 0a turn ret;.}../*.
6d80: 2a 2a 20 57 72 69 74 65 20 61 6e 20 65 6e 74 72 ** Write an entr
6d90: 79 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 y into the point
6da0: 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 er map..**.** Th
6db0: 69 73 20 72 6f 75 74 69 6e 65 20 75 70 64 61 74 is routine updat
6dc0: 65 73 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d es the pointer m
6dd0: 61 70 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 ap entry for pag
6de0: 65 20 6e 75 6d 62 65 72 20 27 6b 65 79 27 0a 2a e number 'key'.*
6df0: 2a 20 73 6f 20 74 68 61 74 20 69 74 20 6d 61 70 * so that it map
6e00: 73 20 74 6f 20 74 79 70 65 20 27 65 54 79 70 65 s to type 'eType
6e10: 27 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 67 ' and parent pag
6e20: 65 20 6e 75 6d 62 65 72 20 27 70 67 6e 6f 27 2e e number 'pgno'.
6e30: 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 52 43 20 69 .**.** If *pRC i
6e40: 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e 6f 6e 2d s initially non-
6e50: 7a 65 72 6f 20 28 6e 6f 6e 2d 53 51 4c 49 54 45 zero (non-SQLITE
6e60: 5f 4f 4b 29 20 74 68 65 6e 20 74 68 69 73 20 72 _OK) then this r
6e70: 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 61 20 6e outine is.** a n
6e80: 6f 2d 6f 70 2e 20 20 49 66 20 61 6e 20 65 72 72 o-op. If an err
6e90: 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 20 61 or occurs, the a
6ea0: 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f 72 ppropriate error
6eb0: 20 63 6f 64 65 20 69 73 20 77 72 69 74 74 65 6e code is written
6ec0: 0a 2a 2a 20 69 6e 74 6f 20 2a 70 52 43 2e 0a 2a .** into *pRC..*
6ed0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 74 /.static void pt
6ee0: 72 6d 61 70 50 75 74 28 42 74 53 68 61 72 65 64 rmapPut(BtShared
6ef0: 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 2c *pBt, Pgno key,
6f00: 20 75 38 20 65 54 79 70 65 2c 20 50 67 6e 6f 20 u8 eType, Pgno
6f10: 70 61 72 65 6e 74 2c 20 69 6e 74 20 2a 70 52 43 parent, int *pRC
6f20: 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 ){. DbPage *pDb
6f30: 50 61 67 65 3b 20 20 2f 2a 20 54 68 65 20 70 6f Page; /* The po
6f40: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 2a inter map page *
6f50: 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d 61 70 3b /. u8 *pPtrmap;
6f60: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 /* The poi
6f70: 6e 74 65 72 20 6d 61 70 20 64 61 74 61 20 2a 2f nter map data */
6f80: 0a 20 20 50 67 6e 6f 20 69 50 74 72 6d 61 70 3b . Pgno iPtrmap;
6f90: 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e /* The poin
6fa0: 74 65 72 20 6d 61 70 20 70 61 67 65 20 6e 75 6d ter map page num
6fb0: 62 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 ber */. int off
6fc0: 73 65 74 3b 20 20 20 20 20 20 20 2f 2a 20 4f 66 set; /* Of
6fd0: 66 73 65 74 20 69 6e 20 70 6f 69 6e 74 65 72 20 fset in pointer
6fe0: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
6ff0: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
7000: 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 66 /* Return code f
7010: 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 rom subfunctions
7020: 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 */.. if( *pRC
7030: 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 73 ) return;.. ass
7040: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
7050: 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
7060: 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 68 65 20 ex) );. /* The
7070: 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 master-journal p
7080: 61 67 65 20 6e 75 6d 62 65 72 20 6d 75 73 74 20 age number must
7090: 6e 65 76 65 72 20 62 65 20 75 73 65 64 20 61 73 never be used as
70a0: 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 a pointer map p
70b0: 61 67 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 age */. assert(
70c0: 20 30 3d 3d 50 54 52 4d 41 50 5f 49 53 50 41 47 0==PTRMAP_ISPAG
70d0: 45 28 70 42 74 2c 20 50 45 4e 44 49 4e 47 5f 42 E(pBt, PENDING_B
70e0: 59 54 45 5f 50 41 47 45 28 70 42 74 29 29 20 29 YTE_PAGE(pBt)) )
70f0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 ;.. assert( pBt
7100: 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a ->autoVacuum );.
7110: 20 20 69 66 28 20 6b 65 79 3d 3d 30 20 29 7b 0a if( key==0 ){.
7120: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
7130: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
7140: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a return;. }.
7150: 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 4d iPtrmap = PTRM
7160: 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 6b AP_PAGENO(pBt, k
7170: 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ey);. rc = sqli
7180: 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d te3PagerGet(pBt-
7190: 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 70 >pPager, iPtrmap
71a0: 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 20 69 , &pDbPage);. i
71b0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
71c0: 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 72 ){. *pRC = r
71d0: 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 c;. return;.
71e0: 20 7d 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 }. offset = PT
71f0: 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 RMAP_PTROFFSET(i
7200: 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 Ptrmap, key);.
7210: 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a if( offset<0 ){.
7220: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
7230: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
7240: 20 20 20 20 67 6f 74 6f 20 70 74 72 6d 61 70 5f goto ptrmap_
7250: 65 78 69 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 exit;. }. asse
7260: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
7270: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
7280: 7a 65 2d 35 20 29 3b 0a 20 20 70 50 74 72 6d 61 ze-5 );. pPtrma
7290: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
72a0: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
72b0: 62 50 61 67 65 29 3b 0a 0a 20 20 69 66 28 20 65 bPage);.. if( e
72c0: 54 79 70 65 21 3d 70 50 74 72 6d 61 70 5b 6f 66 Type!=pPtrmap[of
72d0: 66 73 65 74 5d 20 7c 7c 20 67 65 74 34 62 79 74 fset] || get4byt
72e0: 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 e(&pPtrmap[offse
72f0: 74 2b 31 5d 29 21 3d 70 61 72 65 6e 74 20 29 7b t+1])!=parent ){
7300: 0a 20 20 20 20 54 52 41 43 45 28 28 22 50 54 52 . TRACE(("PTR
7310: 4d 41 50 5f 55 50 44 41 54 45 3a 20 25 64 2d 3e MAP_UPDATE: %d->
7320: 28 25 64 2c 25 64 29 5c 6e 22 2c 20 6b 65 79 2c (%d,%d)\n", key,
7330: 20 65 54 79 70 65 2c 20 70 61 72 65 6e 74 29 29 eType, parent))
7340: 3b 0a 20 20 20 20 2a 70 52 43 3d 20 72 63 20 3d ;. *pRC= rc =
7350: 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
7360: 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
7370: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
7380: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 74 72 OK ){. pPtr
7390: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 3d 20 65 54 map[offset] = eT
73a0: 79 70 65 3b 0a 20 20 20 20 20 20 70 75 74 34 62 ype;. put4b
73b0: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
73c0: 73 65 74 2b 31 5d 2c 20 70 61 72 65 6e 74 29 3b set+1], parent);
73d0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 70 74 72 6d . }. }..ptrm
73e0: 61 70 5f 65 78 69 74 3a 0a 20 20 73 71 6c 69 74 ap_exit:. sqlit
73f0: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
7400: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
7410: 52 65 61 64 20 61 6e 20 65 6e 74 72 79 20 66 72 Read an entry fr
7420: 6f 6d 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d om the pointer m
7430: 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ap..**.** This r
7440: 6f 75 74 69 6e 65 20 72 65 74 72 69 65 76 65 73 outine retrieves
7450: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
7460: 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 entry for page
7470: 27 6b 65 79 27 2c 20 77 72 69 74 69 6e 67 0a 2a 'key', writing.*
7480: 2a 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 70 * the type and p
7490: 61 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 arent page numbe
74a0: 72 20 74 6f 20 2a 70 45 54 79 70 65 20 61 6e 64 r to *pEType and
74b0: 20 2a 70 50 67 6e 6f 20 72 65 73 70 65 63 74 69 *pPgno respecti
74c0: 76 65 6c 79 2e 0a 2a 2a 20 41 6e 20 65 72 72 6f vely..** An erro
74d0: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
74e0: 65 64 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 ed if something
74f0: 67 6f 65 73 20 77 72 6f 6e 67 2c 20 6f 74 68 65 goes wrong, othe
7500: 72 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b 2e rwise SQLITE_OK.
7510: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
7520: 74 72 6d 61 70 47 65 74 28 42 74 53 68 61 72 65 trmapGet(BtShare
7530: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 d *pBt, Pgno key
7540: 2c 20 75 38 20 2a 70 45 54 79 70 65 2c 20 50 67 , u8 *pEType, Pg
7550: 6e 6f 20 2a 70 50 67 6e 6f 29 7b 0a 20 20 44 62 no *pPgno){. Db
7560: 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 Page *pDbPage;
7570: 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
7580: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
7590: 74 20 69 50 74 72 6d 61 70 3b 20 20 20 20 20 20 t iPtrmap;
75a0: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
75b0: 70 61 67 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 page index */.
75c0: 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 20 u8 *pPtrmap;
75d0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 /* Pointer ma
75e0: 70 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 p page data */.
75f0: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
7600: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
7610: 20 65 6e 74 72 79 20 69 6e 20 70 6f 69 6e 74 65 entry in pointe
7620: 72 20 6d 61 70 20 2a 2f 0a 20 20 69 6e 74 20 72 r map */. int r
7630: 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 c;.. assert( sq
7640: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
7650: 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
7660: 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 . iPtrmap = PTR
7670: 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
7680: 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c key);. rc = sql
7690: 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 ite3PagerGet(pBt
76a0: 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 ->pPager, iPtrma
76b0: 70 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 20 p, &pDbPage);.
76c0: 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20 20 20 if( rc!=0 ){.
76d0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
76e0: 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 pPtrmap = (u8
76f0: 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 *)sqlite3PagerGe
7700: 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a tData(pDbPage);.
7710: 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 52 4d . offset = PTRM
7720: 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 50 74 AP_PTROFFSET(iPt
7730: 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 69 66 rmap, key);. if
7740: 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a 20 20 ( offset<0 ){.
7750: 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e sqlite3PagerUn
7760: 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 20 20 ref(pDbPage);.
7770: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
7780: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
7790: 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 }. assert( offs
77a0: 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e et <= (int)pBt->
77b0: 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a usableSize-5 );.
77c0: 20 20 61 73 73 65 72 74 28 20 70 45 54 79 70 65 assert( pEType
77d0: 21 3d 30 20 29 3b 0a 20 20 2a 70 45 54 79 70 65 !=0 );. *pEType
77e0: 20 3d 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 = pPtrmap[offse
77f0: 74 5d 3b 0a 20 20 69 66 28 20 70 50 67 6e 6f 20 t];. if( pPgno
7800: 29 20 2a 70 50 67 6e 6f 20 3d 20 67 65 74 34 62 ) *pPgno = get4b
7810: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
7820: 73 65 74 2b 31 5d 29 3b 0a 0a 20 20 73 71 6c 69 set+1]);.. sqli
7830: 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 te3PagerUnref(pD
7840: 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 2a 70 bPage);. if( *p
7850: 45 54 79 70 65 3c 31 20 7c 7c 20 2a 70 45 54 79 EType<1 || *pETy
7860: 70 65 3e 35 20 29 20 72 65 74 75 72 6e 20 53 51 pe>5 ) return SQ
7870: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
7880: 54 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 T;. return SQLI
7890: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6c 73 65 20 TE_OK;.}..#else
78a0: 2f 2a 20 69 66 20 64 65 66 69 6e 65 64 20 53 51 /* if defined SQ
78b0: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
78c0: 43 55 55 4d 20 2a 2f 0a 20 20 23 64 65 66 69 6e CUUM */. #defin
78d0: 65 20 70 74 72 6d 61 70 50 75 74 28 77 2c 78 2c e ptrmapPut(w,x,
78e0: 79 2c 7a 2c 72 63 29 0a 20 20 23 64 65 66 69 6e y,z,rc). #defin
78f0: 65 20 70 74 72 6d 61 70 47 65 74 28 77 2c 78 2c e ptrmapGet(w,x,
7900: 79 2c 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 y,z) SQLITE_OK.
7910: 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 50 #define ptrmapP
7920: 75 74 4f 76 66 6c 50 74 72 28 78 2c 20 79 2c 20 utOvflPtr(x, y,
7930: 72 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a rc).#endif../*.*
7940: 2a 20 47 69 76 65 6e 20 61 20 62 74 72 65 65 20 * Given a btree
7950: 70 61 67 65 20 61 6e 64 20 61 20 63 65 6c 6c 20 page and a cell
7960: 69 6e 64 65 78 20 28 30 20 6d 65 61 6e 73 20 74 index (0 means t
7970: 68 65 20 66 69 72 73 74 20 63 65 6c 6c 20 6f 6e he first cell on
7980: 0a 2a 2a 20 74 68 65 20 70 61 67 65 2c 20 31 20 .** the page, 1
7990: 6d 65 61 6e 73 20 74 68 65 20 73 65 63 6f 6e 64 means the second
79a0: 20 63 65 6c 6c 2c 20 61 6e 64 20 73 6f 20 66 6f cell, and so fo
79b0: 72 74 68 29 20 72 65 74 75 72 6e 20 61 20 70 6f rth) return a po
79c0: 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 inter.** to the
79d0: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e 0a 2a 2a cell content..**
79e0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
79f0: 20 77 6f 72 6b 73 20 6f 6e 6c 79 20 66 6f 72 20 works only for
7a00: 70 61 67 65 73 20 74 68 61 74 20 64 6f 20 6e 6f pages that do no
7a10: 74 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 66 6c t contain overfl
7a20: 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 23 64 65 ow cells..*/.#de
7a30: 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c 28 50 2c fine findCell(P,
7a40: 49 29 20 5c 0a 20 20 28 28 50 29 2d 3e 61 44 61 I) \. ((P)->aDa
7a50: 74 61 20 2b 20 28 28 50 29 2d 3e 6d 61 73 6b 50 ta + ((P)->maskP
7a60: 61 67 65 20 26 20 67 65 74 32 62 79 74 65 28 26 age & get2byte(&
7a70: 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a (P)->aCellIdx[2*
7a80: 28 49 29 5d 29 29 29 0a 23 64 65 66 69 6e 65 20 (I)]))).#define
7a90: 66 69 6e 64 43 65 6c 6c 76 32 28 44 2c 4d 2c 4f findCellv2(D,M,O
7aa0: 2c 49 29 20 28 44 2b 28 4d 26 67 65 74 32 62 79 ,I) (D+(M&get2by
7ab0: 74 65 28 44 2b 28 4f 2b 32 2a 28 49 29 29 29 29 te(D+(O+2*(I))))
7ac0: 29 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 61 ).../*.** This a
7ad0: 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 76 65 more complex ve
7ae0: 72 73 69 6f 6e 20 6f 66 20 66 69 6e 64 43 65 6c rsion of findCel
7af0: 6c 28 29 20 74 68 61 74 20 77 6f 72 6b 73 20 66 l() that works f
7b00: 6f 72 0a 2a 2a 20 70 61 67 65 73 20 74 68 61 74 or.** pages that
7b10: 20 64 6f 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 do contain over
7b20: 66 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 73 flow cells..*/.s
7b30: 74 61 74 69 63 20 75 38 20 2a 66 69 6e 64 4f 76 tatic u8 *findOv
7b40: 65 72 66 6c 6f 77 43 65 6c 6c 28 4d 65 6d 50 61 erflowCell(MemPa
7b50: 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 ge *pPage, int i
7b60: 43 65 6c 6c 29 7b 0a 20 20 69 6e 74 20 69 3b 0a Cell){. int i;.
7b70: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
7b80: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
7b90: 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
7ba0: 29 3b 0a 20 20 66 6f 72 28 69 3d 70 50 61 67 65 );. for(i=pPage
7bb0: 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2d 31 3b 20 69 ->nOverflow-1; i
7bc0: 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 69 >=0; i--){. i
7bd0: 6e 74 20 6b 3b 0a 20 20 20 20 6b 20 3d 20 70 50 nt k;. k = pP
7be0: 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 69 5d 3b 0a age->aiOvfl[i];.
7bf0: 20 20 20 20 69 66 28 20 6b 3c 3d 69 43 65 6c 6c if( k<=iCell
7c00: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6b 3d ){. if( k=
7c10: 3d 69 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 =iCell ){.
7c20: 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 2d 3e return pPage->
7c30: 61 70 4f 76 66 6c 5b 69 5d 3b 0a 20 20 20 20 20 apOvfl[i];.
7c40: 20 7d 0a 20 20 20 20 20 20 69 43 65 6c 6c 2d 2d }. iCell--
7c50: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
7c60: 74 75 72 6e 20 66 69 6e 64 43 65 6c 6c 28 70 50 turn findCell(pP
7c70: 61 67 65 2c 20 69 43 65 6c 6c 29 3b 0a 7d 0a 0a age, iCell);.}..
7c80: 2f 2a 0a 2a 2a 20 50 61 72 73 65 20 61 20 63 65 /*.** Parse a ce
7c90: 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 6c 6f 63 6b ll content block
7ca0: 20 61 6e 64 20 66 69 6c 6c 20 69 6e 20 74 68 65 and fill in the
7cb0: 20 43 65 6c 6c 49 6e 66 6f 20 73 74 72 75 63 74 CellInfo struct
7cc0: 75 72 65 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 ure. There.** a
7cd0: 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73 20 re two versions
7ce0: 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e of this function
7cf0: 2e 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c . btreeParseCel
7d00: 6c 28 29 20 74 61 6b 65 73 20 61 20 0a 2a 2a 20 l() takes a .**
7d10: 63 65 6c 6c 20 69 6e 64 65 78 20 61 73 20 74 68 cell index as th
7d20: 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
7d30: 74 20 61 6e 64 20 62 74 72 65 65 50 61 72 73 65 t and btreeParse
7d40: 43 65 6c 6c 50 74 72 28 29 20 0a 2a 2a 20 74 61 CellPtr() .** ta
7d50: 6b 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f kes a pointer to
7d60: 20 74 68 65 20 62 6f 64 79 20 6f 66 20 74 68 65 the body of the
7d70: 20 63 65 6c 6c 20 61 73 20 69 74 73 20 73 65 63 cell as its sec
7d80: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f ond argument..*/
7d90: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 .static void btr
7da0: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 0a eeParseCellPtr(.
7db0: 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
7dc0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 , /* Pag
7dd0: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
7de0: 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 cell */. u8 *p
7df0: 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Cell,
7e00: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
7e10: 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 the cell text.
7e20: 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 */. CellInfo *p
7e30: 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 Info /*
7e40: 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 Fill in this str
7e50: 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 ucture */.){. u
7e60: 38 20 2a 70 49 74 65 72 3b 20 20 20 20 20 20 20 8 *pIter;
7e70: 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 73 63 /* For sc
7e80: 61 6e 6e 69 6e 67 20 74 68 72 6f 75 67 68 20 70 anning through p
7e90: 43 65 6c 6c 20 2a 2f 0a 20 20 75 33 32 20 6e 50 Cell */. u32 nP
7ea0: 61 79 6c 6f 61 64 3b 20 20 20 20 20 20 20 20 20 ayload;
7eb0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 /* Number of b
7ec0: 79 74 65 73 20 6f 66 20 63 65 6c 6c 20 70 61 79 ytes of cell pay
7ed0: 6c 6f 61 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 load */.. asser
7ee0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
7ef0: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
7f00: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
7f10: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 sert( pPage->lea
7f20: 66 3d 3d 30 20 7c 7c 20 70 50 61 67 65 2d 3e 6c f==0 || pPage->l
7f30: 65 61 66 3d 3d 31 20 29 3b 0a 20 20 69 66 28 20 eaf==1 );. if(
7f40: 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 pPage->intKeyLea
7f50: 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 f ){. assert(
7f60: 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
7f70: 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 70 Size==0 );. p
7f80: 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b 20 67 Iter = pCell + g
7f90: 65 74 56 61 72 69 6e 74 33 32 28 70 43 65 6c 6c etVarint32(pCell
7fa0: 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 , nPayload);.
7fb0: 20 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 72 pIter += getVar
7fc0: 69 6e 74 28 70 49 74 65 72 2c 20 28 75 36 34 2a int(pIter, (u64*
7fd0: 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a )&pInfo->nKey);.
7fe0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 50 61 67 }else if( pPag
7ff0: 65 2d 3e 6e 6f 50 61 79 6c 6f 61 64 20 29 7b 0a e->noPayload ){.
8000: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
8010: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
8020: 3d 34 20 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d =4 );. pInfo-
8030: 3e 6e 53 69 7a 65 20 3d 20 34 20 2b 20 67 65 74 >nSize = 4 + get
8040: 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 34 5d Varint(&pCell[4]
8050: 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d 3e , (u64*)&pInfo->
8060: 6e 4b 65 79 29 3b 0a 20 20 20 20 70 49 6e 66 6f nKey);. pInfo
8070: 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 30 3b 0a ->nPayload = 0;.
8080: 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 pInfo->nLoca
8090: 6c 20 3d 20 30 3b 0a 20 20 20 20 70 49 6e 66 6f l = 0;. pInfo
80a0: 2d 3e 69 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b ->iOverflow = 0;
80b0: 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 . pInfo->pPay
80c0: 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 20 20 72 65 load = 0;. re
80d0: 74 75 72 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 turn;. }else{.
80e0: 20 20 20 70 49 74 65 72 20 3d 20 70 43 65 6c 6c pIter = pCell
80f0: 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 + pPage->childP
8100: 74 72 53 69 7a 65 3b 0a 20 20 20 20 70 49 74 65 trSize;. pIte
8110: 72 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 32 r += getVarint32
8120: 28 70 49 74 65 72 2c 20 6e 50 61 79 6c 6f 61 64 (pIter, nPayload
8130: 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4b );. pInfo->nK
8140: 65 79 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 ey = nPayload;.
8150: 20 7d 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 }. pInfo->nPay
8160: 6c 6f 61 64 20 3d 20 6e 50 61 79 6c 6f 61 64 3b load = nPayload;
8170: 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f . pInfo->pPaylo
8180: 61 64 20 3d 20 70 49 74 65 72 3b 0a 20 20 74 65 ad = pIter;. te
8190: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
81a0: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
81b0: 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 l );. testcase(
81c0: 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 nPayload==pPage
81d0: 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a ->maxLocal+1 );.
81e0: 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d if( nPayload<=
81f0: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
8200: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 ){. /* This i
8210: 73 20 74 68 65 20 28 65 61 73 79 29 20 63 6f 6d s the (easy) com
8220: 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 mon case where t
8230: 68 65 20 65 6e 74 69 72 65 20 70 61 79 6c 6f 61 he entire payloa
8240: 64 20 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f 6e d fits. ** on
8250: 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2e the local page.
8260: 20 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 73 No overflow is
8270: 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 2a required.. *
8280: 2f 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 /. pInfo->nSi
8290: 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 64 20 2b 20 ze = nPayload +
82a0: 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 (u16)(pIter - pC
82b0: 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 70 49 ell);. if( pI
82c0: 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 20 29 20 70 nfo->nSize<4 ) p
82d0: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 3b Info->nSize = 4;
82e0: 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 . pInfo->nLoc
82f0: 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 79 6c 6f al = (u16)nPaylo
8300: 61 64 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 69 ad;. pInfo->i
8310: 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 Overflow = 0;.
8320: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 }else{. /* If
8330: 20 74 68 65 20 70 61 79 6c 6f 61 64 20 77 69 6c the payload wil
8340: 6c 20 6e 6f 74 20 66 69 74 20 63 6f 6d 70 6c 65 l not fit comple
8350: 74 65 6c 79 20 6f 6e 20 74 68 65 20 6c 6f 63 61 tely on the loca
8360: 6c 20 70 61 67 65 2c 20 77 65 20 68 61 76 65 0a l page, we have.
8370: 20 20 20 20 2a 2a 20 74 6f 20 64 65 63 69 64 65 ** to decide
8380: 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 74 6f how much to sto
8390: 72 65 20 6c 6f 63 61 6c 6c 79 20 61 6e 64 20 68 re locally and h
83a0: 6f 77 20 6d 75 63 68 20 74 6f 20 73 70 69 6c 6c ow much to spill
83b0: 20 6f 6e 74 6f 0a 20 20 20 20 2a 2a 20 6f 76 65 onto. ** ove
83c0: 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 68 rflow pages. Th
83d0: 65 20 73 74 72 61 74 65 67 79 20 69 73 20 74 6f e strategy is to
83e0: 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 20 61 6d minimize the am
83f0: 6f 75 6e 74 20 6f 66 20 75 6e 75 73 65 64 0a 20 ount of unused.
8400: 20 20 20 2a 2a 20 73 70 61 63 65 20 6f 6e 20 6f ** space on o
8410: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 77 68 verflow pages wh
8420: 69 6c 65 20 6b 65 65 70 69 6e 67 20 74 68 65 20 ile keeping the
8430: 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 63 61 6c 20 amount of local
8440: 73 74 6f 72 61 67 65 0a 20 20 20 20 2a 2a 20 69 storage. ** i
8450: 6e 20 62 65 74 77 65 65 6e 20 6d 69 6e 4c 6f 63 n between minLoc
8460: 61 6c 20 61 6e 64 20 6d 61 78 4c 6f 63 61 6c 2e al and maxLocal.
8470: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 . **. ** W
8480: 61 72 6e 69 6e 67 3a 20 20 63 68 61 6e 67 69 6e arning: changin
8490: 67 20 74 68 65 20 77 61 79 20 6f 76 65 72 66 6c g the way overfl
84a0: 6f 77 20 70 61 79 6c 6f 61 64 20 69 73 20 64 69 ow payload is di
84b0: 73 74 72 69 62 75 74 65 64 20 69 6e 20 61 6e 79 stributed in any
84c0: 0a 20 20 20 20 2a 2a 20 77 61 79 20 77 69 6c 6c . ** way will
84d0: 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 69 6e result in an in
84e0: 63 6f 6d 70 61 74 69 62 6c 65 20 66 69 6c 65 20 compatible file
84f0: 66 6f 72 6d 61 74 2e 0a 20 20 20 20 2a 2f 0a 20 format.. */.
8500: 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 3b int minLocal;
8510: 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 61 6d 6f /* Minimum amo
8520: 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 unt of payload h
8530: 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 eld locally */.
8540: 20 20 20 69 6e 74 20 6d 61 78 4c 6f 63 61 6c 3b int maxLocal;
8550: 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f /* Maximum amo
8560: 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 unt of payload h
8570: 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 eld locally */.
8580: 20 20 20 69 6e 74 20 73 75 72 70 6c 75 73 3b 20 int surplus;
8590: 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 61 /* Overflow pa
85a0: 79 6c 6f 61 64 20 61 76 61 69 6c 61 62 6c 65 20 yload available
85b0: 66 6f 72 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 for local storag
85c0: 65 20 2a 2f 0a 0a 20 20 20 20 6d 69 6e 4c 6f 63 e */.. minLoc
85d0: 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c al = pPage->minL
85e0: 6f 63 61 6c 3b 0a 20 20 20 20 6d 61 78 4c 6f 63 ocal;. maxLoc
85f0: 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 61 78 4c al = pPage->maxL
8600: 6f 63 61 6c 3b 0a 20 20 20 20 73 75 72 70 6c 75 ocal;. surplu
8610: 73 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 s = minLocal + (
8620: 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c 6f nPayload - minLo
8630: 63 61 6c 29 25 28 70 50 61 67 65 2d 3e 70 42 74 cal)%(pPage->pBt
8640: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 ->usableSize - 4
8650: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
8660: 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 surplus==maxLoc
8670: 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 al );. testca
8680: 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 se( surplus==max
8690: 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 69 Local+1 );. i
86a0: 66 28 20 73 75 72 70 6c 75 73 20 3c 3d 20 6d 61 f( surplus <= ma
86b0: 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 xLocal ){.
86c0: 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 pInfo->nLocal =
86d0: 28 75 31 36 29 73 75 72 70 6c 75 73 3b 0a 20 20 (u16)surplus;.
86e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
86f0: 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 Info->nLocal = (
8700: 75 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 u16)minLocal;.
8710: 20 20 7d 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 69 }. pInfo->i
8720: 4f 76 65 72 66 6c 6f 77 20 3d 20 28 75 31 36 29 Overflow = (u16)
8730: 28 26 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 (&pInfo->pPayloa
8740: 64 5b 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 5d d[pInfo->nLocal]
8750: 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 70 - pCell);. p
8760: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 70 49 Info->nSize = pI
8770: 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f 77 20 2b nfo->iOverflow +
8780: 20 34 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 4;. }.}.static
8790: 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 void btreeParse
87a0: 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 Cell(. MemPage
87b0: 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 *pPage,
87c0: 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 /* Page containi
87d0: 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 ng the cell */.
87e0: 20 69 6e 74 20 69 43 65 6c 6c 2c 20 20 20 20 20 int iCell,
87f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
8800: 63 65 6c 6c 20 69 6e 64 65 78 2e 20 20 46 69 72 cell index. Fir
8810: 73 74 20 63 65 6c 6c 20 69 73 20 30 20 2a 2f 0a st cell is 0 */.
8820: 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 CellInfo *pInf
8830: 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c o /* Fil
8840: 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 l in this struct
8850: 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 62 74 72 65 ure */.){. btre
8860: 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 eParseCellPtr(pP
8870: 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 50 age, findCell(pP
8880: 61 67 65 2c 20 69 43 65 6c 6c 29 2c 20 70 49 6e age, iCell), pIn
8890: 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f fo);.}../*.** Co
88a0: 6d 70 75 74 65 20 74 68 65 20 74 6f 74 61 6c 20 mpute the total
88b0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
88c0: 74 68 61 74 20 61 20 43 65 6c 6c 20 6e 65 65 64 that a Cell need
88d0: 73 20 69 6e 20 74 68 65 20 63 65 6c 6c 0a 2a 2a s in the cell.**
88e0: 20 64 61 74 61 20 61 72 65 61 20 6f 66 20 74 68 data area of th
88f0: 65 20 62 74 72 65 65 2d 70 61 67 65 2e 20 20 54 e btree-page. T
8900: 68 65 20 72 65 74 75 72 6e 20 6e 75 6d 62 65 72 he return number
8910: 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 63 65 includes the ce
8920: 6c 6c 0a 2a 2a 20 64 61 74 61 20 68 65 61 64 65 ll.** data heade
8930: 72 20 61 6e 64 20 74 68 65 20 6c 6f 63 61 6c 20 r and the local
8940: 70 61 79 6c 6f 61 64 2c 20 62 75 74 20 6e 6f 74 payload, but not
8950: 20 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 any overflow pa
8960: 67 65 20 6f 72 0a 2a 2a 20 74 68 65 20 73 70 61 ge or.** the spa
8970: 63 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 ce used by the c
8980: 65 6c 6c 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a ell pointer..*/.
8990: 73 74 61 74 69 63 20 75 31 36 20 63 65 6c 6c 53 static u16 cellS
89a0: 69 7a 65 50 74 72 28 4d 65 6d 50 61 67 65 20 2a izePtr(MemPage *
89b0: 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c pPage, u8 *pCell
89c0: 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 20 3d ){. u8 *pIter =
89d0: 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 2d 3e pCell + pPage->
89e0: 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 20 2f 2a childPtrSize; /*
89f0: 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 For looping ove
8a00: 72 20 62 79 74 65 73 20 6f 66 20 70 43 65 6c 6c r bytes of pCell
8a10: 20 2a 2f 0a 20 20 75 38 20 2a 70 45 6e 64 3b 20 */. u8 *pEnd;
8a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8a30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8a40: 2a 20 45 6e 64 20 6d 61 72 6b 20 66 6f 72 20 61 * End mark for a
8a50: 20 76 61 72 69 6e 74 20 2a 2f 0a 20 20 75 33 32 varint */. u32
8a60: 20 6e 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 nSize;
8a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8a80: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 76 61 /* Size va
8a90: 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f lue to return */
8aa0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
8ab0: 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 DEBUG. /* The v
8ac0: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
8ad0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 this function s
8ae0: 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 hould always be
8af0: 74 68 65 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a the same as. **
8b00: 20 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e the (CellInfo.n
8b10: 53 69 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 6e Size) value foun
8b20: 64 20 62 79 20 64 6f 69 6e 67 20 61 20 66 75 6c d by doing a ful
8b30: 6c 20 70 61 72 73 65 20 6f 66 20 74 68 65 0a 20 l parse of the.
8b40: 20 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c ** cell. If SQL
8b50: 49 54 45 5f 44 45 42 55 47 20 69 73 20 64 65 66 ITE_DEBUG is def
8b60: 69 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 ined, an assert(
8b70: 29 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 ) at the bottom
8b80: 6f 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 6e of. ** this fun
8b90: 63 74 69 6f 6e 20 76 65 72 69 66 69 65 73 20 74 ction verifies t
8ba0: 68 61 74 20 74 68 69 73 20 69 6e 76 61 72 69 61 hat this invaria
8bb0: 6e 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 nt is not violat
8bc0: 65 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 ed. */. CellInf
8bd0: 6f 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 62 o debuginfo;. b
8be0: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
8bf0: 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
8c00: 64 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6e 64 debuginfo);.#end
8c10: 69 66 0a 0a 20 20 69 66 28 20 70 50 61 67 65 2d if.. if( pPage-
8c20: 3e 6e 6f 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 >noPayload ){.
8c30: 20 20 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b pEnd = &pIter[
8c40: 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 9];. while( (
8c50: 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 30 20 26 *pIter++)&0x80 &
8c60: 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a & pIter<pEnd );.
8c70: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
8c80: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
8c90: 3d 34 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e =4 );. return
8ca0: 20 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 (u16)(pIter - p
8cb0: 43 65 6c 6c 29 3b 0a 20 20 7d 0a 20 20 6e 53 69 Cell);. }. nSi
8cc0: 7a 65 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 ze = *pIter;. i
8cd0: 66 28 20 6e 53 69 7a 65 3e 3d 30 78 38 30 20 29 f( nSize>=0x80 )
8ce0: 7b 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 {. pEnd = &pI
8cf0: 74 65 72 5b 39 5d 3b 0a 20 20 20 20 6e 53 69 7a ter[9];. nSiz
8d00: 65 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 64 e &= 0x7f;. d
8d10: 6f 7b 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d o{. nSize =
8d20: 20 28 6e 53 69 7a 65 3c 3c 37 29 20 7c 20 28 2a (nSize<<7) | (*
8d30: 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b ++pIter & 0x7f);
8d40: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 . }while( *(p
8d50: 49 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 Iter)>=0x80 && p
8d60: 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d Iter<pEnd );. }
8d70: 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 20 20 69 66 . pIter++;. if
8d80: 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 ( pPage->intKey
8d90: 29 7b 0a 20 20 20 20 2f 2a 20 70 49 74 65 72 20 ){. /* pIter
8da0: 6e 6f 77 20 70 6f 69 6e 74 73 20 61 74 20 74 68 now points at th
8db0: 65 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 e 64-bit integer
8dc0: 20 6b 65 79 20 76 61 6c 75 65 2c 20 61 20 76 61 key value, a va
8dd0: 72 69 61 62 6c 65 20 6c 65 6e 67 74 68 20 0a 20 riable length .
8de0: 20 20 20 2a 2a 20 69 6e 74 65 67 65 72 2e 20 54 ** integer. T
8df0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f he following blo
8e00: 63 6b 20 6d 6f 76 65 73 20 70 49 74 65 72 20 74 ck moves pIter t
8e10: 6f 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 66 o point at the f
8e20: 69 72 73 74 20 62 79 74 65 0a 20 20 20 20 2a 2a irst byte. **
8e30: 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
8e40: 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 2e 20 the key value.
8e50: 2a 2f 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 */. pEnd = &p
8e60: 49 74 65 72 5b 39 5d 3b 0a 20 20 20 20 77 68 69 Iter[9];. whi
8e70: 6c 65 28 20 28 2a 70 49 74 65 72 2b 2b 29 26 30 le( (*pIter++)&0
8e80: 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e x80 && pIter<pEn
8e90: 64 20 29 3b 0a 20 20 7d 0a 20 20 74 65 73 74 63 d );. }. testc
8ea0: 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 ase( nSize==pPag
8eb0: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 e->maxLocal );.
8ec0: 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 testcase( nSize
8ed0: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
8ee0: 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 53 69 l+1 );. if( nSi
8ef0: 7a 65 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f ze<=pPage->maxLo
8f00: 63 61 6c 20 29 7b 0a 20 20 20 20 6e 53 69 7a 65 cal ){. nSize
8f10: 20 2b 3d 20 28 75 33 32 29 28 70 49 74 65 72 20 += (u32)(pIter
8f20: 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 - pCell);. if
8f30: 28 20 6e 53 69 7a 65 3c 34 20 29 20 6e 53 69 7a ( nSize<4 ) nSiz
8f40: 65 20 3d 20 34 3b 0a 20 20 7d 65 6c 73 65 7b 0a e = 4;. }else{.
8f50: 20 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c int minLocal
8f60: 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 = pPage->minLoc
8f70: 61 6c 3b 0a 20 20 20 20 6e 53 69 7a 65 20 3d 20 al;. nSize =
8f80: 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 6e 53 69 7a minLocal + (nSiz
8f90: 65 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 20 25 20 e - minLocal) %
8fa0: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 (pPage->pBt->usa
8fb0: 62 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 bleSize - 4);.
8fc0: 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a testcase( nSiz
8fd0: 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 e==pPage->maxLoc
8fe0: 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 al );. testca
8ff0: 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 se( nSize==pPage
9000: 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a ->maxLocal+1 );.
9010: 20 20 20 20 69 66 28 20 6e 53 69 7a 65 3e 70 50 if( nSize>pP
9020: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b age->maxLocal ){
9030: 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d . nSize = m
9040: 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 inLocal;. }.
9050: 20 20 20 6e 53 69 7a 65 20 2b 3d 20 34 20 2b 20 nSize += 4 +
9060: 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 (u16)(pIter - pC
9070: 65 6c 6c 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 ell);. }. asse
9080: 72 74 28 20 6e 53 69 7a 65 3d 3d 64 65 62 75 67 rt( nSize==debug
9090: 69 6e 66 6f 2e 6e 53 69 7a 65 20 7c 7c 20 43 4f info.nSize || CO
90a0: 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 72 65 RRUPT_DB );. re
90b0: 74 75 72 6e 20 28 75 31 36 29 6e 53 69 7a 65 3b turn (u16)nSize;
90c0: 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .}..#ifdef SQLIT
90d0: 45 5f 44 45 42 55 47 0a 2f 2a 20 54 68 69 73 20 E_DEBUG./* This
90e0: 76 61 72 69 61 74 69 6f 6e 20 6f 6e 20 63 65 6c variation on cel
90f0: 6c 53 69 7a 65 50 74 72 28 29 20 69 73 20 75 73 lSizePtr() is us
9100: 65 64 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 ed inside of ass
9110: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
9120: 0a 2a 2a 20 6f 6e 6c 79 2e 20 2a 2f 0a 73 74 61 .** only. */.sta
9130: 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 tic u16 cellSize
9140: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
9150: 20 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 20 72 int iCell){. r
9160: 65 74 75 72 6e 20 63 65 6c 6c 53 69 7a 65 50 74 eturn cellSizePt
9170: 72 28 70 50 61 67 65 2c 20 66 69 6e 64 43 65 6c r(pPage, findCel
9180: 6c 28 70 50 61 67 65 2c 20 69 43 65 6c 6c 29 29 l(pPage, iCell))
9190: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e ;.}.#endif..#ifn
91a0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
91b0: 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a AUTOVACUUM./*.**
91c0: 20 49 66 20 74 68 65 20 63 65 6c 6c 20 70 43 65 If the cell pCe
91d0: 6c 6c 2c 20 70 61 72 74 20 6f 66 20 70 61 67 65 ll, part of page
91e0: 20 70 50 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 pPage contains
91f0: 61 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 a pointer.** to
9200: 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
9210: 2c 20 69 6e 73 65 72 74 20 61 6e 20 65 6e 74 72 , insert an entr
9220: 79 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 y into the point
9230: 65 72 2d 6d 61 70 0a 2a 2a 20 66 6f 72 20 74 68 er-map.** for th
9240: 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e e overflow page.
9250: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
9260: 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 ptrmapPutOvflPtr
9270: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
9280: 20 75 38 20 2a 70 43 65 6c 6c 2c 20 69 6e 74 20 u8 *pCell, int
9290: 2a 70 52 43 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 *pRC){. CellInf
92a0: 6f 20 69 6e 66 6f 3b 0a 20 20 69 66 28 20 2a 70 o info;. if( *p
92b0: 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 RC ) return;. a
92c0: 73 73 65 72 74 28 20 70 43 65 6c 6c 21 3d 30 20 ssert( pCell!=0
92d0: 29 3b 0a 20 20 62 74 72 65 65 50 61 72 73 65 43 );. btreeParseC
92e0: 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 ellPtr(pPage, pC
92f0: 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 69 ell, &info);. i
9300: 66 28 20 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f f( info.iOverflo
9310: 77 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6f 76 w ){. Pgno ov
9320: 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 fl = get4byte(&p
9330: 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 Cell[info.iOverf
9340: 6c 6f 77 5d 29 3b 0a 20 20 20 20 70 74 72 6d 61 low]);. ptrma
9350: 70 50 75 74 28 70 50 61 67 65 2d 3e 70 42 74 2c pPut(pPage->pBt,
9360: 20 6f 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 ovfl, PTRMAP_OV
9370: 45 52 46 4c 4f 57 31 2c 20 70 50 61 67 65 2d 3e ERFLOW1, pPage->
9380: 70 67 6e 6f 2c 20 70 52 43 29 3b 0a 20 20 7d 0a pgno, pRC);. }.
9390: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a }.#endif.../*.**
93a0: 20 44 65 66 72 61 67 6d 65 6e 74 20 74 68 65 20 Defragment the
93b0: 70 61 67 65 20 67 69 76 65 6e 2e 20 20 41 6c 6c page given. All
93c0: 20 43 65 6c 6c 73 20 61 72 65 20 6d 6f 76 65 64 Cells are moved
93d0: 20 74 6f 20 74 68 65 0a 2a 2a 20 65 6e 64 20 6f to the.** end o
93e0: 66 20 74 68 65 20 70 61 67 65 20 61 6e 64 20 61 f the page and a
93f0: 6c 6c 20 66 72 65 65 20 73 70 61 63 65 20 69 73 ll free space is
9400: 20 63 6f 6c 6c 65 63 74 65 64 20 69 6e 74 6f 20 collected into
9410: 6f 6e 65 0a 2a 2a 20 62 69 67 20 46 72 65 65 42 one.** big FreeB
9420: 6c 6b 20 74 68 61 74 20 6f 63 63 75 72 73 20 69 lk that occurs i
9430: 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 68 65 n between the he
9440: 61 64 65 72 20 61 6e 64 20 63 65 6c 6c 0a 2a 2a ader and cell.**
9450: 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 20 61 pointer array a
9460: 6e 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 nd the cell cont
9470: 65 6e 74 20 61 72 65 61 2e 0a 2a 2f 0a 73 74 61 ent area..*/.sta
9480: 74 69 63 20 69 6e 74 20 64 65 66 72 61 67 6d 65 tic int defragme
9490: 6e 74 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a ntPage(MemPage *
94a0: 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 69 3b pPage){. int i;
94b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
94c0: 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 /* Loop cou
94d0: 6e 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 70 63 nter */. int pc
94e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
94f0: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
9500: 6f 66 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c of the i-th cell
9510: 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 */. int hdr;
9520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9530: 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 68 /* Offset to th
9540: 65 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f e page header */
9550: 0a 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 20 20 . int size;
9560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9570: 20 53 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 Size of a cell
9580: 2a 2f 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 53 */. int usableS
9590: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ize;
95a0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 61 /* Number of usa
95b0: 62 6c 65 20 62 79 74 65 73 20 6f 6e 20 61 20 70 ble bytes on a p
95c0: 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 63 65 6c age */. int cel
95d0: 6c 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 lOffset;
95e0: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f /* Offset to
95f0: 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 the cell pointe
9600: 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 69 6e 74 r array */. int
9610: 20 63 62 72 6b 3b 20 20 20 20 20 20 20 20 20 20 cbrk;
9620: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
9630: 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f t to the cell co
9640: 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 ntent area */.
9650: 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 20 20 int nCell;
9660: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
9670: 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 6f 6e mber of cells on
9680: 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 the page */. u
9690: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 nsigned char *da
96a0: 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ta; /* The
96b0: 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 20 page data */.
96c0: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 74 unsigned char *t
96d0: 65 6d 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 65 emp; /* Te
96e0: 6d 70 20 61 72 65 61 20 66 6f 72 20 63 65 6c 6c mp area for cell
96f0: 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 69 6e content */. in
9700: 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 20 20 t iCellFirst;
9710: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
9720: 74 20 61 6c 6c 6f 77 61 62 6c 65 20 63 65 6c 6c t allowable cell
9730: 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 index */. int
9740: 69 43 65 6c 6c 4c 61 73 74 3b 20 20 20 20 20 20 iCellLast;
9750: 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 70 /* Last p
9760: 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 69 6e 64 ossible cell ind
9770: 65 78 20 2a 2f 0a 0a 0a 20 20 61 73 73 65 72 74 ex */... assert
9780: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
9790: 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
97a0: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
97b0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 ssert( pPage->pB
97c0: 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 t!=0 );. assert
97d0: 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 ( pPage->pBt->us
97e0: 61 62 6c 65 53 69 7a 65 20 3c 3d 20 53 51 4c 49 ableSize <= SQLI
97f0: 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 TE_MAX_PAGE_SIZE
9800: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
9810: 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d age->nOverflow==
9820: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 0 );. assert( s
9830: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
9840: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
9850: 74 65 78 29 20 29 3b 0a 20 20 74 65 6d 70 20 3d tex) );. temp =
9860: 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 65 6d sqlite3PagerTem
9870: 70 53 70 61 63 65 28 70 50 61 67 65 2d 3e 70 42 pSpace(pPage->pB
9880: 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 64 61 t->pPager);. da
9890: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
98a0: 61 3b 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 a;. hdr = pPage
98b0: 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 63 ->hdrOffset;. c
98c0: 65 6c 6c 4f 66 66 73 65 74 20 3d 20 70 50 61 67 ellOffset = pPag
98d0: 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 3b 0a 20 e->cellOffset;.
98e0: 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e nCell = pPage->
98f0: 6e 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 nCell;. assert(
9900: 20 6e 43 65 6c 6c 3d 3d 67 65 74 32 62 79 74 65 nCell==get2byte
9910: 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 20 29 (&data[hdr+3]) )
9920: 3b 0a 20 20 75 73 61 62 6c 65 53 69 7a 65 20 3d ;. usableSize =
9930: 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 pPage->pBt->usa
9940: 62 6c 65 53 69 7a 65 3b 0a 20 20 63 62 72 6b 20 bleSize;. cbrk
9950: 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
9960: 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 6d 65 6d 63 [hdr+5]);. memc
9970: 70 79 28 26 74 65 6d 70 5b 63 62 72 6b 5d 2c 20 py(&temp[cbrk],
9980: 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 75 73 61 &data[cbrk], usa
9990: 62 6c 65 53 69 7a 65 20 2d 20 63 62 72 6b 29 3b bleSize - cbrk);
99a0: 0a 20 20 63 62 72 6b 20 3d 20 75 73 61 62 6c 65 . cbrk = usable
99b0: 53 69 7a 65 3b 0a 20 20 69 43 65 6c 6c 46 69 72 Size;. iCellFir
99c0: 73 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 st = cellOffset
99d0: 2b 20 32 2a 6e 43 65 6c 6c 3b 0a 20 20 69 43 65 + 2*nCell;. iCe
99e0: 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c 65 53 llLast = usableS
99f0: 69 7a 65 20 2d 20 34 3b 0a 20 20 66 6f 72 28 69 ize - 4;. for(i
9a00: 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b =0; i<nCell; i++
9a10: 29 7b 0a 20 20 20 20 75 38 20 2a 70 41 64 64 72 ){. u8 *pAddr
9a20: 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 69 2d 74 ; /* The i-t
9a30: 68 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 2a h cell pointer *
9a40: 2f 0a 20 20 20 20 70 41 64 64 72 20 3d 20 26 64 /. pAddr = &d
9a50: 61 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 20 2b ata[cellOffset +
9a60: 20 69 2a 32 5d 3b 0a 20 20 20 20 70 63 20 3d 20 i*2];. pc =
9a70: 67 65 74 32 62 79 74 65 28 70 41 64 64 72 29 3b get2byte(pAddr);
9a80: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 . testcase( p
9a90: 63 3d 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b c==iCellFirst );
9aa0: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 . testcase( p
9ab0: 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a c==iCellLast );.
9ac0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
9ad0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 ITE_ENABLE_OVERS
9ae0: 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 0a IZE_CELL_CHECK).
9af0: 20 20 20 20 2f 2a 20 54 68 65 73 65 20 63 6f 6e /* These con
9b00: 64 69 74 69 6f 6e 73 20 68 61 76 65 20 61 6c 72 ditions have alr
9b10: 65 61 64 79 20 62 65 65 6e 20 76 65 72 69 66 69 eady been verifi
9b20: 65 64 20 69 6e 20 62 74 72 65 65 49 6e 69 74 50 ed in btreeInitP
9b30: 61 67 65 28 29 0a 20 20 20 20 2a 2a 20 69 66 20 age(). ** if
9b40: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 SQLITE_ENABLE_OV
9b50: 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 ERSIZE_CELL_CHEC
9b60: 4b 20 69 73 20 64 65 66 69 6e 65 64 20 0a 20 20 K is defined .
9b70: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 63 3c */. if( pc<
9b80: 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 iCellFirst || pc
9b90: 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 >iCellLast ){.
9ba0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
9bb0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
9bc0: 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
9bd0: 20 61 73 73 65 72 74 28 20 70 63 3e 3d 69 43 65 assert( pc>=iCe
9be0: 6c 6c 46 69 72 73 74 20 26 26 20 70 63 3c 3d 69 llFirst && pc<=i
9bf0: 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 CellLast );.
9c00: 73 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 50 size = cellSizeP
9c10: 74 72 28 70 50 61 67 65 2c 20 26 74 65 6d 70 5b tr(pPage, &temp[
9c20: 70 63 5d 29 3b 0a 20 20 20 20 63 62 72 6b 20 2d pc]);. cbrk -
9c30: 3d 20 73 69 7a 65 3b 0a 23 69 66 20 64 65 66 69 = size;.#if defi
9c40: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
9c50: 45 5f 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f E_OVERSIZE_CELL_
9c60: 43 48 45 43 4b 29 0a 20 20 20 20 69 66 28 20 63 CHECK). if( c
9c70: 62 72 6b 3c 69 43 65 6c 6c 46 69 72 73 74 20 29 brk<iCellFirst )
9c80: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
9c90: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
9ca0: 50 54 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a PT;. }.#else.
9cb0: 20 20 20 20 69 66 28 20 63 62 72 6b 3c 69 43 65 if( cbrk<iCe
9cc0: 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 2b 73 69 llFirst || pc+si
9cd0: 7a 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b ze>usableSize ){
9ce0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
9cf0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
9d00: 54 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a T;. }.#endif.
9d10: 20 20 20 20 61 73 73 65 72 74 28 20 63 62 72 6b assert( cbrk
9d20: 2b 73 69 7a 65 3c 3d 75 73 61 62 6c 65 53 69 7a +size<=usableSiz
9d30: 65 20 26 26 20 63 62 72 6b 3e 3d 69 43 65 6c 6c e && cbrk>=iCell
9d40: 46 69 72 73 74 20 29 3b 0a 20 20 20 20 74 65 73 First );. tes
9d50: 74 63 61 73 65 28 20 63 62 72 6b 2b 73 69 7a 65 tcase( cbrk+size
9d60: 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ==usableSize );.
9d70: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
9d80: 2b 73 69 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a +size==usableSiz
9d90: 65 20 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 e );. memcpy(
9da0: 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 26 74 65 &data[cbrk], &te
9db0: 6d 70 5b 70 63 5d 2c 20 73 69 7a 65 29 3b 0a 20 mp[pc], size);.
9dc0: 20 20 20 70 75 74 32 62 79 74 65 28 70 41 64 64 put2byte(pAdd
9dd0: 72 2c 20 63 62 72 6b 29 3b 0a 20 20 7d 0a 20 20 r, cbrk);. }.
9de0: 61 73 73 65 72 74 28 20 63 62 72 6b 3e 3d 69 43 assert( cbrk>=iC
9df0: 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 70 75 ellFirst );. pu
9e00: 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 t2byte(&data[hdr
9e10: 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a 20 20 64 61 +5], cbrk);. da
9e20: 74 61 5b 68 64 72 2b 31 5d 20 3d 20 30 3b 0a 20 ta[hdr+1] = 0;.
9e30: 20 64 61 74 61 5b 68 64 72 2b 32 5d 20 3d 20 30 data[hdr+2] = 0
9e40: 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 ;. data[hdr+7]
9e50: 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 = 0;. memset(&d
9e60: 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 74 5d 2c ata[iCellFirst],
9e70: 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 0, cbrk-iCellFi
9e80: 72 73 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20 rst);. assert(
9e90: 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
9ea0: 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
9eb0: 44 62 50 61 67 65 29 20 29 3b 0a 20 20 69 66 28 DbPage) );. if(
9ec0: 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 72 73 74 cbrk-iCellFirst
9ed0: 21 3d 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 29 !=pPage->nFree )
9ee0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
9ef0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
9f00: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
9f10: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
9f20: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6e 42 79 74 ** Allocate nByt
9f30: 65 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 e bytes of space
9f40: 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 from within the
9f50: 20 42 2d 54 72 65 65 20 70 61 67 65 20 70 61 73 B-Tree page pas
9f60: 73 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69 sed.** as the fi
9f70: 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 20 57 72 rst argument. Wr
9f80: 69 74 65 20 69 6e 74 6f 20 2a 70 49 64 78 20 74 ite into *pIdx t
9f90: 68 65 20 69 6e 64 65 78 20 69 6e 74 6f 20 70 50 he index into pP
9fa0: 61 67 65 2d 3e 61 44 61 74 61 5b 5d 0a 2a 2a 20 age->aData[].**
9fb0: 6f 66 20 74 68 65 20 66 69 72 73 74 20 62 79 74 of the first byt
9fc0: 65 20 6f 66 20 61 6c 6c 6f 63 61 74 65 64 20 73 e of allocated s
9fd0: 70 61 63 65 2e 20 52 65 74 75 72 6e 20 65 69 74 pace. Return eit
9fe0: 68 65 72 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 her SQLITE_OK or
9ff0: 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 .** an error cod
a000: 65 20 28 75 73 75 61 6c 6c 79 20 53 51 4c 49 54 e (usually SQLIT
a010: 45 5f 43 4f 52 52 55 50 54 29 2e 0a 2a 2a 0a 2a E_CORRUPT)..**.*
a020: 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 67 75 61 * The caller gua
a030: 72 61 6e 74 65 65 73 20 74 68 61 74 20 74 68 65 rantees that the
a040: 72 65 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 re is sufficient
a050: 20 73 70 61 63 65 20 74 6f 20 6d 61 6b 65 20 74 space to make t
a060: 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e he.** allocation
a070: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
a080: 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 64 65 might need to de
a090: 66 72 61 67 6d 65 6e 74 20 69 6e 20 6f 72 64 65 fragment in orde
a0a0: 72 20 74 6f 20 62 72 69 6e 67 0a 2a 2a 20 61 6c r to bring.** al
a0b0: 6c 20 74 68 65 20 73 70 61 63 65 20 74 6f 67 65 l the space toge
a0c0: 74 68 65 72 2c 20 68 6f 77 65 76 65 72 2e 20 20 ther, however.
a0d0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c This routine wil
a0e0: 6c 20 61 76 6f 69 64 20 75 73 69 6e 67 0a 2a 2a l avoid using.**
a0f0: 20 74 68 65 20 66 69 72 73 74 20 74 77 6f 20 62 the first two b
a100: 79 74 65 73 20 70 61 73 74 20 74 68 65 20 63 65 ytes past the ce
a110: 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 65 61 20 ll pointer area
a120: 73 69 6e 63 65 20 70 72 65 73 75 6d 61 62 6c 79 since presumably
a130: 20 74 68 69 73 0a 2a 2a 20 61 6c 6c 6f 63 61 74 this.** allocat
a140: 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 6d 61 64 ion is being mad
a150: 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e e in order to in
a160: 73 65 72 74 20 61 20 6e 65 77 20 63 65 6c 6c 2c sert a new cell,
a170: 20 73 6f 20 77 65 20 77 69 6c 6c 0a 2a 2a 20 61 so we will.** a
a180: 6c 73 6f 20 65 6e 64 20 75 70 20 6e 65 65 64 69 lso end up needi
a190: 6e 67 20 61 20 6e 65 77 20 63 65 6c 6c 20 70 6f ng a new cell po
a1a0: 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 inter..*/.static
a1b0: 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 53 70 61 int allocateSpa
a1c0: 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ce(MemPage *pPag
a1d0: 65 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 69 6e e, int nByte, in
a1e0: 74 20 2a 70 49 64 78 29 7b 0a 20 20 63 6f 6e 73 t *pIdx){. cons
a1f0: 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 61 67 t int hdr = pPag
a200: 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 20 20 e->hdrOffset;
a210: 20 2f 2a 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 /* Local cache
a220: 6f 66 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 of pPage->hdrOff
a230: 73 65 74 20 2a 2f 0a 20 20 75 38 20 2a 20 63 6f set */. u8 * co
a240: 6e 73 74 20 64 61 74 61 20 3d 20 70 50 61 67 65 nst data = pPage
a250: 2d 3e 61 44 61 74 61 3b 20 20 20 20 20 20 2f 2a ->aData; /*
a260: 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 Local cache of
a270: 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a pPage->aData */.
a280: 20 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 int top;
a290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a2a0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
a2b0: 62 79 74 65 20 6f 66 20 63 65 6c 6c 20 63 6f 6e byte of cell con
a2c0: 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 69 tent area */. i
a2d0: 6e 74 20 67 61 70 3b 20 20 20 20 20 20 20 20 2f nt gap; /
a2e0: 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 * First byte of
a2f0: 67 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c gap between cell
a300: 20 70 6f 69 6e 74 65 72 73 20 61 6e 64 20 63 65 pointers and ce
a310: 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 ll content */.
a320: 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
a330: 2f 2a 20 49 6e 74 65 67 65 72 20 72 65 74 75 72 /* Integer retur
a340: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 n code */. int
a350: 75 73 61 62 6c 65 53 69 7a 65 3b 20 2f 2a 20 55 usableSize; /* U
a360: 73 61 62 6c 65 20 73 69 7a 65 20 6f 66 20 74 68 sable size of th
a370: 65 20 70 61 67 65 20 2a 2f 0a 20 20 0a 20 20 61 e page */. . a
a380: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
a390: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
a3a0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
a3b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
a3c0: 65 2d 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 65 e->pBt );. asse
a3d0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
a3e0: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
a3f0: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
a400: 73 73 65 72 74 28 20 6e 42 79 74 65 3e 3d 30 20 ssert( nByte>=0
a410: 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 63 ); /* Minimum c
a420: 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a 2f ell size is 4 */
a430: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
a440: 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 74 65 20 29 ->nFree>=nByte )
a450: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
a460: 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 e->nOverflow==0
a470: 29 3b 0a 20 20 75 73 61 62 6c 65 53 69 7a 65 20 );. usableSize
a480: 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 = pPage->pBt->us
a490: 61 62 6c 65 53 69 7a 65 3b 0a 20 20 61 73 73 65 ableSize;. asse
a4a0: 72 74 28 20 6e 42 79 74 65 20 3c 20 75 73 61 62 rt( nByte < usab
a4b0: 6c 65 53 69 7a 65 2d 38 20 29 3b 0a 0a 20 20 61 leSize-8 );.. a
a4c0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 65 ssert( pPage->ce
a4d0: 6c 6c 4f 66 66 73 65 74 20 3d 3d 20 68 64 72 20 llOffset == hdr
a4e0: 2b 20 31 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e + 12 - 4*pPage->
a4f0: 6c 65 61 66 20 29 3b 0a 20 20 67 61 70 20 3d 20 leaf );. gap =
a500: 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
a510: 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e 43 65 t + 2*pPage->nCe
a520: 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 67 61 ll;. assert( ga
a530: 70 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 74 6f p<=65536 );. to
a540: 70 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 p = get2byte(&da
a550: 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 66 ta[hdr+5]);. if
a560: 28 20 67 61 70 3e 74 6f 70 20 29 7b 0a 20 20 20 ( gap>top ){.
a570: 20 69 66 28 20 74 6f 70 3d 3d 30 20 29 7b 0a 20 if( top==0 ){.
a580: 20 20 20 20 20 74 6f 70 20 3d 20 36 35 35 33 36 top = 65536
a590: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
a5a0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a5b0: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
a5c0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 }. }.. /* I
a5d0: 66 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 f there is enoug
a5e0: 68 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 h space between
a5f0: 67 61 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 gap and top for
a600: 6f 6e 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f one more cell po
a610: 69 6e 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 inter. ** array
a620: 20 65 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 entry offset, a
a630: 6e 64 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 nd if the freeli
a640: 73 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c st is not empty,
a650: 20 74 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 then search the
a660: 0a 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c . ** freelist l
a670: 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 ooking for a fre
a680: 65 20 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 e slot big enoug
a690: 68 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 h to satisfy the
a6a0: 20 72 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 request.. */.
a6b0: 20 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 testcase( gap+2
a6c0: 3d 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 ==top );. testc
a6d0: 61 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 ase( gap+1==top
a6e0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 );. testcase( g
a6f0: 61 70 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 ap==top );. if(
a700: 20 67 61 70 2b 32 3c 3d 74 6f 70 20 26 26 20 28 gap+2<=top && (
a710: 64 61 74 61 5b 68 64 72 2b 31 5d 20 7c 7c 20 64 data[hdr+1] || d
a720: 61 74 61 5b 68 64 72 2b 32 5d 29 20 29 7b 0a 20 ata[hdr+2]) ){.
a730: 20 20 20 69 6e 74 20 70 63 2c 20 61 64 64 72 3b int pc, addr;
a740: 0a 20 20 20 20 66 6f 72 28 61 64 64 72 3d 68 64 . for(addr=hd
a750: 72 2b 31 3b 20 28 70 63 20 3d 20 67 65 74 32 62 r+1; (pc = get2b
a760: 79 74 65 28 26 64 61 74 61 5b 61 64 64 72 5d 29 yte(&data[addr])
a770: 29 3e 30 3b 20 61 64 64 72 3d 70 63 29 7b 0a 20 )>0; addr=pc){.
a780: 20 20 20 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 int size;
a790: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a /* Siz
a7a0: 65 20 6f 66 20 74 68 65 20 66 72 65 65 20 73 6c e of the free sl
a7b0: 6f 74 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 ot */. if(
a7c0: 70 63 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 pc>usableSize-4
a7d0: 7c 7c 20 70 63 3c 61 64 64 72 2b 34 20 29 7b 0a || pc<addr+4 ){.
a7e0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
a7f0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
a800: 50 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 PT;. }.
a810: 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 79 74 size = get2byt
a820: 65 28 26 64 61 74 61 5b 70 63 2b 32 5d 29 3b 0a e(&data[pc+2]);.
a830: 20 20 20 20 20 20 69 66 28 20 73 69 7a 65 3e 3d if( size>=
a840: 6e 42 79 74 65 20 29 7b 0a 20 20 20 20 20 20 20 nByte ){.
a850: 20 69 6e 74 20 78 20 3d 20 73 69 7a 65 20 2d 20 int x = size -
a860: 6e 42 79 74 65 3b 0a 20 20 20 20 20 20 20 20 74 nByte;. t
a870: 65 73 74 63 61 73 65 28 20 78 3d 3d 34 20 29 3b estcase( x==4 );
a880: 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 . testcas
a890: 65 28 20 78 3d 3d 33 20 29 3b 0a 20 20 20 20 20 e( x==3 );.
a8a0: 20 20 20 69 66 28 20 78 3c 34 20 29 7b 0a 20 20 if( x<4 ){.
a8b0: 20 20 20 20 20 20 20 20 69 66 28 20 64 61 74 61 if( data
a8c0: 5b 68 64 72 2b 37 5d 3e 3d 36 30 20 29 20 67 6f [hdr+7]>=60 ) go
a8d0: 74 6f 20 64 65 66 72 61 67 6d 65 6e 74 5f 70 61 to defragment_pa
a8e0: 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a ge;. /*
a8f0: 20 52 65 6d 6f 76 65 20 74 68 65 20 73 6c 6f 74 Remove the slot
a900: 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c from the free-l
a910: 69 73 74 2e 20 55 70 64 61 74 65 20 74 68 65 20 ist. Update the
a920: 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 20 20 20 number of.
a930: 20 20 20 20 2a 2a 20 66 72 61 67 6d 65 6e 74 65 ** fragmente
a940: 64 20 62 79 74 65 73 20 77 69 74 68 69 6e 20 74 d bytes within t
a950: 68 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 he page. */.
a960: 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 memcpy(&da
a970: 74 61 5b 61 64 64 72 5d 2c 20 26 64 61 74 61 5b ta[addr], &data[
a980: 70 63 5d 2c 20 32 29 3b 0a 20 20 20 20 20 20 20 pc], 2);.
a990: 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2b data[hdr+7] +
a9a0: 3d 20 28 75 38 29 78 3b 0a 20 20 20 20 20 20 20 = (u8)x;.
a9b0: 20 7d 65 6c 73 65 20 69 66 28 20 73 69 7a 65 2b }else if( size+
a9c0: 70 63 20 3e 20 75 73 61 62 6c 65 53 69 7a 65 20 pc > usableSize
a9d0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 ){. ret
a9e0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
a9f0: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 PT_BKPT;.
aa00: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
aa10: 20 20 2f 2a 20 54 68 65 20 73 6c 6f 74 20 72 65 /* The slot re
aa20: 6d 61 69 6e 73 20 6f 6e 20 74 68 65 20 66 72 65 mains on the fre
aa30: 65 2d 6c 69 73 74 2e 20 52 65 64 75 63 65 20 69 e-list. Reduce i
aa40: 74 73 20 73 69 7a 65 20 74 6f 20 61 63 63 6f 75 ts size to accou
aa50: 6e 74 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 nt. **
aa60: 66 6f 72 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 for the portion
aa70: 75 73 65 64 20 62 79 20 74 68 65 20 6e 65 77 20 used by the new
aa80: 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 2a 2f 0a 20 allocation. */.
aa90: 20 20 20 20 20 20 20 20 20 70 75 74 32 62 79 74 put2byt
aaa0: 65 28 26 64 61 74 61 5b 70 63 2b 32 5d 2c 20 78 e(&data[pc+2], x
aab0: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
aac0: 20 20 20 20 20 2a 70 49 64 78 20 3d 20 70 63 20 *pIdx = pc
aad0: 2b 20 78 3b 0a 20 20 20 20 20 20 20 20 72 65 74 + x;. ret
aae0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
aaf0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
ab00: 0a 0a 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65 .. /* The reque
ab10: 73 74 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 st could not be
ab20: 66 75 6c 66 69 6c 6c 65 64 20 75 73 69 6e 67 20 fulfilled using
ab30: 61 20 66 72 65 65 6c 69 73 74 20 73 6c 6f 74 2e a freelist slot.
ab40: 20 20 43 68 65 63 6b 0a 20 20 2a 2a 20 74 6f 20 Check. ** to
ab50: 73 65 65 20 69 66 20 64 65 66 72 61 67 6d 65 6e see if defragmen
ab60: 74 61 74 69 6f 6e 20 69 73 20 6e 65 63 65 73 73 tation is necess
ab70: 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 74 65 73 74 ary.. */. test
ab80: 63 61 73 65 28 20 67 61 70 2b 32 2b 6e 42 79 74 case( gap+2+nByt
ab90: 65 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 e==top );. if(
aba0: 67 61 70 2b 32 2b 6e 42 79 74 65 3e 74 6f 70 20 gap+2+nByte>top
abb0: 29 7b 0a 64 65 66 72 61 67 6d 65 6e 74 5f 70 61 ){.defragment_pa
abc0: 67 65 3a 0a 20 20 20 20 74 65 73 74 63 61 73 65 ge:. testcase
abd0: 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d ( pPage->nCell==
abe0: 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 64 65 0 );. rc = de
abf0: 66 72 61 67 6d 65 6e 74 50 61 67 65 28 70 50 61 fragmentPage(pPa
ac00: 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 ge);. if( rc
ac10: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
ac20: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
ac30: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
ac40: 2b 35 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 +5]);. assert
ac50: 28 20 67 61 70 2b 6e 42 79 74 65 3c 3d 74 6f 70 ( gap+nByte<=top
ac60: 20 29 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 41 );. }... /* A
ac70: 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20 66 llocate memory f
ac80: 72 6f 6d 20 74 68 65 20 67 61 70 20 69 6e 20 62 rom the gap in b
ac90: 65 74 77 65 65 6e 20 74 68 65 20 63 65 6c 6c 20 etween the cell
aca0: 70 6f 69 6e 74 65 72 20 61 72 72 61 79 0a 20 20 pointer array.
acb0: 2a 2a 20 61 6e 64 20 74 68 65 20 63 65 6c 6c 20 ** and the cell
acc0: 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 20 54 content area. T
acd0: 68 65 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 he btreeInitPage
ace0: 28 29 20 63 61 6c 6c 20 68 61 73 20 61 6c 72 65 () call has alre
acf0: 61 64 79 0a 20 20 2a 2a 20 76 61 6c 69 64 61 74 ady. ** validat
ad00: 65 64 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e ed the freelist.
ad10: 20 20 47 69 76 65 6e 20 74 68 61 74 20 74 68 65 Given that the
ad20: 20 66 72 65 65 6c 69 73 74 20 69 73 20 76 61 6c freelist is val
ad30: 69 64 2c 20 74 68 65 72 65 0a 20 20 2a 2a 20 69 id, there. ** i
ad40: 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 74 68 s no way that th
ad50: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 63 61 6e e allocation can
ad60: 20 65 78 74 65 6e 64 20 6f 66 66 20 74 68 65 20 extend off the
ad70: 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 2e end of the page.
ad80: 0a 20 20 2a 2a 20 54 68 65 20 61 73 73 65 72 74 . ** The assert
ad90: 28 29 20 62 65 6c 6f 77 20 76 65 72 69 66 69 65 () below verifie
ada0: 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 s the previous s
adb0: 65 6e 74 65 6e 63 65 2e 0a 20 20 2a 2f 0a 20 20 entence.. */.
adc0: 74 6f 70 20 2d 3d 20 6e 42 79 74 65 3b 0a 20 20 top -= nByte;.
add0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
ade0: 64 72 2b 35 5d 2c 20 74 6f 70 29 3b 0a 20 20 61 dr+5], top);. a
adf0: 73 73 65 72 74 28 20 74 6f 70 2b 6e 42 79 74 65 ssert( top+nByte
ae00: 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 2d 3e <= (int)pPage->
ae10: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
ae20: 29 3b 0a 20 20 2a 70 49 64 78 20 3d 20 74 6f 70 );. *pIdx = top
ae30: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
ae40: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 E_OK;.}../*.** R
ae50: 65 74 75 72 6e 20 61 20 73 65 63 74 69 6f 6e 20 eturn a section
ae60: 6f 66 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 of the pPage->aD
ae70: 61 74 61 20 74 6f 20 74 68 65 20 66 72 65 65 6c ata to the freel
ae80: 69 73 74 2e 0a 2a 2a 20 54 68 65 20 66 69 72 73 ist..** The firs
ae90: 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 6e 65 t byte of the ne
aea0: 77 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 73 20 w free block is
aeb0: 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 69 53 74 pPage->aData[iSt
aec0: 61 72 74 5d 0a 2a 2a 20 61 6e 64 20 74 68 65 20 art].** and the
aed0: 73 69 7a 65 20 6f 66 20 74 68 65 20 62 6c 6f 63 size of the bloc
aee0: 6b 20 69 73 20 69 53 69 7a 65 20 62 79 74 65 73 k is iSize bytes
aef0: 2e 0a 2a 2a 0a 2a 2a 20 41 64 6a 61 63 65 6e 74 ..**.** Adjacent
af00: 20 66 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 20 freeblocks are
af10: 63 6f 61 6c 65 73 63 65 64 2e 0a 2a 2a 0a 2a 2a coalesced..**.**
af20: 20 4e 6f 74 65 20 74 68 61 74 20 65 76 65 6e 20 Note that even
af30: 74 68 6f 75 67 68 20 74 68 65 20 66 72 65 65 62 though the freeb
af40: 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 20 63 68 lock list was ch
af50: 65 63 6b 65 64 20 62 79 20 62 74 72 65 65 49 6e ecked by btreeIn
af60: 69 74 50 61 67 65 28 29 2c 0a 2a 2a 20 74 68 61 itPage(),.** tha
af70: 74 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6e t routine will n
af80: 6f 74 20 64 65 74 65 63 74 20 6f 76 65 72 6c 61 ot detect overla
af90: 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c 73 20 p between cells
afa0: 6f 72 20 66 72 65 65 62 6c 6f 63 6b 73 2e 20 20 or freeblocks.
afb0: 4e 6f 72 0a 2a 2a 20 64 6f 65 73 20 69 74 20 64 Nor.** does it d
afc0: 65 74 65 63 74 20 63 65 6c 6c 73 20 6f 72 20 66 etect cells or f
afd0: 72 65 65 62 6c 6f 63 6b 73 20 74 68 61 74 20 65 reeblocks that e
afe0: 6e 63 72 6f 75 63 68 20 69 6e 74 6f 20 74 68 65 ncrouch into the
aff0: 20 72 65 73 65 72 76 65 64 20 62 79 74 65 73 0a reserved bytes.
b000: 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 ** at the end of
b010: 20 74 68 65 20 70 61 67 65 2e 20 20 53 6f 20 64 the page. So d
b020: 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6f 72 o additional cor
b030: 72 75 70 74 69 6f 6e 20 63 68 65 63 6b 73 20 69 ruption checks i
b040: 6e 73 69 64 65 20 74 68 69 73 0a 2a 2a 20 72 6f nside this.** ro
b050: 75 74 69 6e 65 20 61 6e 64 20 72 65 74 75 72 6e utine and return
b060: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 SQLITE_CORRUPT
b070: 69 66 20 61 6e 79 20 70 72 6f 62 6c 65 6d 73 20 if any problems
b080: 61 72 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 are found..*/.st
b090: 61 74 69 63 20 69 6e 74 20 66 72 65 65 53 70 61 atic int freeSpa
b0a0: 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ce(MemPage *pPag
b0b0: 65 2c 20 75 31 36 20 69 53 74 61 72 74 2c 20 75 e, u16 iStart, u
b0c0: 31 36 20 69 53 69 7a 65 29 7b 0a 20 20 75 31 36 16 iSize){. u16
b0d0: 20 69 50 74 72 3b 20 20 20 20 20 20 20 20 20 20 iPtr;
b0e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b0f0: 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 /* Address of
b100: 20 70 74 72 20 74 6f 20 6e 65 78 74 20 66 72 65 ptr to next fre
b110: 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 31 36 20 eblock */. u16
b120: 69 46 72 65 65 42 6c 6b 3b 20 20 20 20 20 20 20 iFreeBlk;
b130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b140: 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 /* Address of
b150: 74 68 65 20 6e 65 78 74 20 66 72 65 65 62 6c 6f the next freeblo
b160: 63 6b 20 2a 2f 0a 20 20 75 38 20 68 64 72 3b 20 ck */. u8 hdr;
b170: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
b190: 20 50 61 67 65 20 68 65 61 64 65 72 20 73 69 7a Page header siz
b1a0: 65 2e 20 20 30 20 6f 72 20 31 30 30 20 2a 2f 0a e. 0 or 100 */.
b1b0: 20 20 75 38 20 6e 46 72 61 67 20 3d 20 30 3b 20 u8 nFrag = 0;
b1c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b1d0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 64 75 63 /* Reduc
b1e0: 74 69 6f 6e 20 69 6e 20 66 72 61 67 6d 65 6e 74 tion in fragment
b1f0: 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 36 20 69 ation */. u16 i
b200: 4f 72 69 67 53 69 7a 65 20 3d 20 69 53 69 7a 65 OrigSize = iSize
b210: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b220: 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 61 6c /* Original val
b230: 75 65 20 6f 66 20 69 53 69 7a 65 20 2a 2f 0a 20 ue of iSize */.
b240: 20 75 33 32 20 69 4c 61 73 74 20 3d 20 70 50 61 u32 iLast = pPa
b250: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
b260: 69 7a 65 2d 34 3b 20 2f 2a 20 4c 61 72 67 65 73 ize-4; /* Larges
b270: 74 20 70 6f 73 73 69 62 6c 65 20 66 72 65 65 62 t possible freeb
b280: 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 20 lock offset */.
b290: 20 75 33 32 20 69 45 6e 64 20 3d 20 69 53 74 61 u32 iEnd = iSta
b2a0: 72 74 20 2b 20 69 53 69 7a 65 3b 20 20 20 20 20 rt + iSize;
b2b0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
b2c0: 62 79 74 65 20 70 61 73 74 20 74 68 65 20 69 53 byte past the iS
b2d0: 74 61 72 74 20 62 75 66 66 65 72 20 2a 2f 0a 20 tart buffer */.
b2e0: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
b2f0: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
b300: 61 74 61 3b 20 20 20 2f 2a 20 50 61 67 65 20 63 ata; /* Page c
b310: 6f 6e 74 65 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 ontent */.. ass
b320: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 21 ert( pPage->pBt!
b330: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
b340: 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
b350: 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
b360: 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 DbPage) );. ass
b370: 65 72 74 28 20 69 53 74 61 72 74 3e 3d 70 50 61 ert( iStart>=pPa
b380: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 36 2b ge->hdrOffset+6+
b390: 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
b3a0: 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ize );. assert(
b3b0: 20 69 45 6e 64 20 3c 3d 20 70 50 61 67 65 2d 3e iEnd <= pPage->
b3c0: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
b3d0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
b3e0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
b3f0: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
b400: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
b410: 69 53 69 7a 65 3e 3d 34 20 29 3b 20 20 20 2f 2a iSize>=4 ); /*
b420: 20 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 73 69 Minimum cell si
b430: 7a 65 20 69 73 20 34 20 2a 2f 0a 20 20 61 73 73 ze is 4 */. ass
b440: 65 72 74 28 20 69 53 74 61 72 74 3c 3d 69 4c 61 ert( iStart<=iLa
b450: 73 74 20 29 3b 0a 0a 20 20 2f 2a 20 4f 76 65 72 st );.. /* Over
b460: 77 72 69 74 65 20 64 65 6c 65 74 65 64 20 69 6e write deleted in
b470: 66 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 20 7a formation with z
b480: 65 72 6f 73 20 77 68 65 6e 20 74 68 65 20 73 65 eros when the se
b490: 63 75 72 65 5f 64 65 6c 65 74 65 0a 20 20 2a 2a cure_delete. **
b4a0: 20 6f 70 74 69 6f 6e 20 69 73 20 65 6e 61 62 6c option is enabl
b4b0: 65 64 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 ed */. if( pPag
b4c0: 65 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 e->pBt->btsFlags
b4d0: 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 & BTS_SECURE_DE
b4e0: 4c 45 54 45 20 29 7b 0a 20 20 20 20 6d 65 6d 73 LETE ){. mems
b4f0: 65 74 28 26 64 61 74 61 5b 69 53 74 61 72 74 5d et(&data[iStart]
b500: 2c 20 30 2c 20 69 53 69 7a 65 29 3b 0a 20 20 7d , 0, iSize);. }
b510: 0a 0a 20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 .. /* The list
b520: 6f 66 20 66 72 65 65 62 6c 6f 63 6b 73 20 6d 75 of freeblocks mu
b530: 73 74 20 62 65 20 69 6e 20 61 73 63 65 6e 64 69 st be in ascendi
b540: 6e 67 20 6f 72 64 65 72 2e 20 20 46 69 6e 64 20 ng order. Find
b550: 74 68 65 20 0a 20 20 2a 2a 20 73 70 6f 74 20 6f the . ** spot o
b560: 6e 20 74 68 65 20 6c 69 73 74 20 77 68 65 72 65 n the list where
b570: 20 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 iStart should b
b580: 65 20 69 6e 73 65 72 74 65 64 2e 0a 20 20 2a 2f e inserted.. */
b590: 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e . hdr = pPage->
b5a0: 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 69 50 74 hdrOffset;. iPt
b5b0: 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 r = hdr + 1;. i
b5c0: 66 28 20 64 61 74 61 5b 69 50 74 72 2b 31 5d 3d f( data[iPtr+1]=
b5d0: 3d 30 20 26 26 20 64 61 74 61 5b 69 50 74 72 5d =0 && data[iPtr]
b5e0: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 46 72 65 65 ==0 ){. iFree
b5f0: 42 6c 6b 20 3d 20 30 3b 20 20 2f 2a 20 53 68 6f Blk = 0; /* Sho
b600: 72 74 63 75 74 20 66 6f 72 20 74 68 65 20 63 61 rtcut for the ca
b610: 73 65 20 77 68 65 6e 20 74 68 65 20 66 72 65 65 se when the free
b620: 6c 69 73 74 20 69 73 20 65 6d 70 74 79 20 2a 2f list is empty */
b630: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 77 68 . }else{. wh
b640: 69 6c 65 28 20 28 69 46 72 65 65 42 6c 6b 20 3d ile( (iFreeBlk =
b650: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
b660: 69 50 74 72 5d 29 29 3e 30 20 26 26 20 69 46 72 iPtr]))>0 && iFr
b670: 65 65 42 6c 6b 3c 69 53 74 61 72 74 20 29 7b 0a eeBlk<iStart ){.
b680: 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 42 if( iFreeB
b690: 6c 6b 3c 69 50 74 72 2b 34 20 29 20 72 65 74 75 lk<iPtr+4 ) retu
b6a0: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
b6b0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 69 50 T_BKPT;. iP
b6c0: 74 72 20 3d 20 69 46 72 65 65 42 6c 6b 3b 0a 20 tr = iFreeBlk;.
b6d0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 46 72 }. if( iFr
b6e0: 65 65 42 6c 6b 3e 69 4c 61 73 74 20 29 20 72 65 eeBlk>iLast ) re
b6f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
b700: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 61 73 UPT_BKPT;. as
b710: 73 65 72 74 28 20 69 46 72 65 65 42 6c 6b 3e 69 sert( iFreeBlk>i
b720: 50 74 72 20 7c 7c 20 69 46 72 65 65 42 6c 6b 3d Ptr || iFreeBlk=
b730: 3d 30 20 29 3b 0a 20 20 0a 20 20 20 20 2f 2a 20 =0 );. . /*
b740: 41 74 20 74 68 69 73 20 70 6f 69 6e 74 3a 0a 20 At this point:.
b750: 20 20 20 2a 2a 20 20 20 20 69 46 72 65 65 42 6c ** iFreeBl
b760: 6b 3a 20 20 20 46 69 72 73 74 20 66 72 65 65 62 k: First freeb
b770: 6c 6f 63 6b 20 61 66 74 65 72 20 69 53 74 61 72 lock after iStar
b780: 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 20 6e 6f t, or zero if no
b790: 6e 65 0a 20 20 20 20 2a 2a 20 20 20 20 69 50 74 ne. ** iPt
b7a0: 72 3a 20 20 20 20 20 20 20 54 68 65 20 61 64 64 r: The add
b7b0: 72 65 73 73 20 6f 66 20 61 20 70 6f 69 6e 74 65 ress of a pointe
b7c0: 72 20 69 46 72 65 65 42 6c 6b 0a 20 20 20 20 2a r iFreeBlk. *
b7d0: 2a 0a 20 20 20 20 2a 2a 20 43 68 65 63 6b 20 74 *. ** Check t
b7e0: 6f 20 73 65 65 20 69 66 20 69 46 72 65 65 42 6c o see if iFreeBl
b7f0: 6b 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 61 6c k should be coal
b800: 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 esced onto the e
b810: 6e 64 20 6f 66 20 69 53 74 61 72 74 2e 0a 20 20 nd of iStart..
b820: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 46 72 */. if( iFr
b830: 65 65 42 6c 6b 20 26 26 20 69 45 6e 64 2b 33 3e eeBlk && iEnd+3>
b840: 3d 69 46 72 65 65 42 6c 6b 20 29 7b 0a 20 20 20 =iFreeBlk ){.
b850: 20 20 20 6e 46 72 61 67 20 3d 20 69 46 72 65 65 nFrag = iFree
b860: 42 6c 6b 20 2d 20 69 45 6e 64 3b 0a 20 20 20 20 Blk - iEnd;.
b870: 20 20 69 66 28 20 69 45 6e 64 3e 69 46 72 65 65 if( iEnd>iFree
b880: 42 6c 6b 20 29 20 72 65 74 75 72 6e 20 53 51 4c Blk ) return SQL
b890: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
b8a0: 3b 0a 20 20 20 20 20 20 69 45 6e 64 20 3d 20 69 ;. iEnd = i
b8b0: 46 72 65 65 42 6c 6b 20 2b 20 67 65 74 32 62 79 FreeBlk + get2by
b8c0: 74 65 28 26 64 61 74 61 5b 69 46 72 65 65 42 6c te(&data[iFreeBl
b8d0: 6b 2b 32 5d 29 3b 0a 20 20 20 20 20 20 69 53 69 k+2]);. iSi
b8e0: 7a 65 20 3d 20 69 45 6e 64 20 2d 20 69 53 74 61 ze = iEnd - iSta
b8f0: 72 74 3b 0a 20 20 20 20 20 20 69 46 72 65 65 42 rt;. iFreeB
b900: 6c 6b 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 lk = get2byte(&d
b910: 61 74 61 5b 69 46 72 65 65 42 6c 6b 5d 29 3b 0a ata[iFreeBlk]);.
b920: 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 }. . /*
b930: 49 66 20 69 50 74 72 20 69 73 20 61 6e 6f 74 68 If iPtr is anoth
b940: 65 72 20 66 72 65 65 62 6c 6f 63 6b 20 28 74 68 er freeblock (th
b950: 61 74 20 69 73 2c 20 69 66 20 69 50 74 72 20 69 at is, if iPtr i
b960: 73 20 6e 6f 74 20 74 68 65 20 66 72 65 65 6c 69 s not the freeli
b970: 73 74 0a 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 st. ** pointe
b980: 72 20 69 6e 20 74 68 65 20 70 61 67 65 20 68 65 r in the page he
b990: 61 64 65 72 29 20 74 68 65 6e 20 63 68 65 63 6b ader) then check
b9a0: 20 74 6f 20 73 65 65 20 69 66 20 69 53 74 61 72 to see if iStar
b9b0: 74 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 t should be.
b9c0: 2a 2a 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 ** coalesced ont
b9d0: 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 69 50 74 o the end of iPt
b9e0: 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 r.. */. if
b9f0: 28 20 69 50 74 72 3e 68 64 72 2b 31 20 29 7b 0a ( iPtr>hdr+1 ){.
ba00: 20 20 20 20 20 20 69 6e 74 20 69 50 74 72 45 6e int iPtrEn
ba10: 64 20 3d 20 69 50 74 72 20 2b 20 67 65 74 32 62 d = iPtr + get2b
ba20: 79 74 65 28 26 64 61 74 61 5b 69 50 74 72 2b 32 yte(&data[iPtr+2
ba30: 5d 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 50 ]);. if( iP
ba40: 74 72 45 6e 64 2b 33 3e 3d 69 53 74 61 72 74 20 trEnd+3>=iStart
ba50: 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 ){. if( i
ba60: 50 74 72 45 6e 64 3e 69 53 74 61 72 74 20 29 20 PtrEnd>iStart )
ba70: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
ba80: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
ba90: 20 20 20 20 6e 46 72 61 67 20 2b 3d 20 69 53 74 nFrag += iSt
baa0: 61 72 74 20 2d 20 69 50 74 72 45 6e 64 3b 0a 20 art - iPtrEnd;.
bab0: 20 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 69 iSize = i
bac0: 45 6e 64 20 2d 20 69 50 74 72 3b 0a 20 20 20 20 End - iPtr;.
bad0: 20 20 20 20 69 53 74 61 72 74 20 3d 20 69 50 74 iStart = iPt
bae0: 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d r;. }. }
baf0: 0a 20 20 20 20 69 66 28 20 6e 46 72 61 67 3e 64 . if( nFrag>d
bb00: 61 74 61 5b 68 64 72 2b 37 5d 20 29 20 72 65 74 ata[hdr+7] ) ret
bb10: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
bb20: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 64 61 74 PT_BKPT;. dat
bb30: 61 5b 68 64 72 2b 37 5d 20 2d 3d 20 6e 46 72 61 a[hdr+7] -= nFra
bb40: 67 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 53 74 g;. }. if( iSt
bb50: 61 72 74 3d 3d 67 65 74 32 62 79 74 65 28 26 64 art==get2byte(&d
bb60: 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 7b 0a 20 ata[hdr+5]) ){.
bb70: 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 20 66 72 /* The new fr
bb80: 65 65 62 6c 6f 63 6b 20 69 73 20 61 74 20 74 68 eeblock is at th
bb90: 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 e beginning of t
bba0: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
bbb0: 61 72 65 61 2c 0a 20 20 20 20 2a 2a 20 73 6f 20 area,. ** so
bbc0: 6a 75 73 74 20 65 78 74 65 6e 64 20 74 68 65 20 just extend the
bbd0: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 cell content are
bbe0: 61 20 72 61 74 68 65 72 20 74 68 61 6e 20 63 72 a rather than cr
bbf0: 65 61 74 65 20 61 6e 6f 74 68 65 72 0a 20 20 20 eate another.
bc00: 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 65 6e 74 ** freelist ent
bc10: 72 79 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 ry */. if( iP
bc20: 74 72 21 3d 68 64 72 2b 31 20 29 20 72 65 74 75 tr!=hdr+1 ) retu
bc30: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
bc40: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 70 75 74 32 T_BKPT;. put2
bc50: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 31 byte(&data[hdr+1
bc60: 5d 2c 20 69 46 72 65 65 42 6c 6b 29 3b 0a 20 20 ], iFreeBlk);.
bc70: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
bc80: 5b 68 64 72 2b 35 5d 2c 20 69 45 6e 64 29 3b 0a [hdr+5], iEnd);.
bc90: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 }else{. /*
bca0: 49 6e 73 65 72 74 20 74 68 65 20 6e 65 77 20 66 Insert the new f
bcb0: 72 65 65 62 6c 6f 63 6b 20 69 6e 74 6f 20 74 68 reeblock into th
bcc0: 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a 20 20 e freelist */.
bcd0: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
bce0: 5b 69 50 74 72 5d 2c 20 69 53 74 61 72 74 29 3b [iPtr], iStart);
bcf0: 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 64 . put2byte(&d
bd00: 61 74 61 5b 69 53 74 61 72 74 5d 2c 20 69 46 72 ata[iStart], iFr
bd10: 65 65 42 6c 6b 29 3b 0a 20 20 20 20 70 75 74 32 eeBlk);. put2
bd20: 62 79 74 65 28 26 64 61 74 61 5b 69 53 74 61 72 byte(&data[iStar
bd30: 74 2b 32 5d 2c 20 69 53 69 7a 65 29 3b 0a 20 20 t+2], iSize);.
bd40: 7d 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 }. pPage->nFree
bd50: 20 2b 3d 20 69 4f 72 69 67 53 69 7a 65 3b 0a 20 += iOrigSize;.
bd60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
bd70: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6f K;.}../*.** Deco
bd80: 64 65 20 74 68 65 20 66 6c 61 67 73 20 62 79 74 de the flags byt
bd90: 65 20 28 74 68 65 20 66 69 72 73 74 20 62 79 74 e (the first byt
bda0: 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 29 e of the header)
bdb0: 20 66 6f 72 20 61 20 70 61 67 65 0a 2a 2a 20 61 for a page.** a
bdc0: 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 66 69 nd initialize fi
bdd0: 65 6c 64 73 20 6f 66 20 74 68 65 20 4d 65 6d 50 elds of the MemP
bde0: 61 67 65 20 73 74 72 75 63 74 75 72 65 20 61 63 age structure ac
bdf0: 63 6f 72 64 69 6e 67 6c 79 2e 0a 2a 2a 0a 2a 2a cordingly..**.**
be00: 20 4f 6e 6c 79 20 74 68 65 20 66 6f 6c 6c 6f 77 Only the follow
be10: 69 6e 67 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 ing combinations
be20: 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e 20 are supported.
be30: 20 41 6e 79 74 68 69 6e 67 20 64 69 66 66 65 72 Anything differ
be40: 65 6e 74 0a 2a 2a 20 69 6e 64 69 63 61 74 65 73 ent.** indicates
be50: 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 a corrupt datab
be60: 61 73 65 20 66 69 6c 65 73 3a 0a 2a 2a 0a 2a 2a ase files:.**.**
be70: 20 20 20 20 20 20 20 20 20 50 54 46 5f 5a 45 52 PTF_ZER
be80: 4f 44 41 54 41 0a 2a 2a 20 20 20 20 20 20 20 20 ODATA.**
be90: 20 50 54 46 5f 5a 45 52 4f 44 41 54 41 20 7c 20 PTF_ZERODATA |
bea0: 50 54 46 5f 4c 45 41 46 0a 2a 2a 20 20 20 20 20 PTF_LEAF.**
beb0: 20 20 20 20 50 54 46 5f 4c 45 41 46 44 41 54 41 PTF_LEAFDATA
bec0: 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 0a 2a 2a | PTF_INTKEY.**
bed0: 20 20 20 20 20 20 20 20 20 50 54 46 5f 4c 45 41 PTF_LEA
bee0: 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 4b FDATA | PTF_INTK
bef0: 45 59 20 7c 20 50 54 46 5f 4c 45 41 46 0a 2a 2f EY | PTF_LEAF.*/
bf00: 0a 73 74 61 74 69 63 20 69 6e 74 20 64 65 63 6f .static int deco
bf10: 64 65 46 6c 61 67 73 28 4d 65 6d 50 61 67 65 20 deFlags(MemPage
bf20: 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 6c 61 67 *pPage, int flag
bf30: 42 79 74 65 29 7b 0a 20 20 42 74 53 68 61 72 65 Byte){. BtShare
bf40: 64 20 2a 70 42 74 3b 20 20 20 20 20 2f 2a 20 41 d *pBt; /* A
bf50: 20 63 6f 70 79 20 6f 66 20 70 50 61 67 65 2d 3e copy of pPage->
bf60: 70 42 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 pBt */.. assert
bf70: 28 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 ( pPage->hdrOffs
bf80: 65 74 3d 3d 28 70 50 61 67 65 2d 3e 70 67 6e 6f et==(pPage->pgno
bf90: 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 29 20 29 ==1 ? 100 : 0) )
bfa0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
bfb0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
bfc0: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
bfd0: 29 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6c 65 ) );. pPage->le
bfe0: 61 66 20 3d 20 28 75 38 29 28 66 6c 61 67 42 79 af = (u8)(flagBy
bff0: 74 65 3e 3e 33 29 3b 20 20 61 73 73 65 72 74 28 te>>3); assert(
c000: 20 50 54 46 5f 4c 45 41 46 20 3d 3d 20 31 3c 3c PTF_LEAF == 1<<
c010: 33 20 29 3b 0a 20 20 66 6c 61 67 42 79 74 65 20 3 );. flagByte
c020: 26 3d 20 7e 50 54 46 5f 4c 45 41 46 3b 0a 20 20 &= ~PTF_LEAF;.
c030: 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
c040: 69 7a 65 20 3d 20 34 2d 34 2a 70 50 61 67 65 2d ize = 4-4*pPage-
c050: 3e 6c 65 61 66 3b 0a 20 20 70 42 74 20 3d 20 70 >leaf;. pBt = p
c060: 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 69 66 28 Page->pBt;. if(
c070: 20 66 6c 61 67 42 79 74 65 3d 3d 28 50 54 46 5f flagByte==(PTF_
c080: 4c 45 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 LEAFDATA | PTF_I
c090: 4e 54 4b 45 59 29 20 29 7b 0a 20 20 20 20 70 50 NTKEY) ){. pP
c0a0: 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 31 3b age->intKey = 1;
c0b0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b . pPage->intK
c0c0: 65 79 4c 65 61 66 20 3d 20 70 50 61 67 65 2d 3e eyLeaf = pPage->
c0d0: 6c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d leaf;. pPage-
c0e0: 3e 6e 6f 50 61 79 6c 6f 61 64 20 3d 20 21 70 50 >noPayload = !pP
c0f0: 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 20 20 70 age->leaf;. p
c100: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d Page->maxLocal =
c110: 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 3b 0a 20 pBt->maxLeaf;.
c120: 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 pPage->minLoc
c130: 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c 65 61 al = pBt->minLea
c140: 66 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 f;. }else if( f
c150: 6c 61 67 42 79 74 65 3d 3d 50 54 46 5f 5a 45 52 lagByte==PTF_ZER
c160: 4f 44 41 54 41 20 29 7b 0a 20 20 20 20 70 50 61 ODATA ){. pPa
c170: 67 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 30 3b 0a ge->intKey = 0;.
c180: 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 pPage->intKe
c190: 79 4c 65 61 66 20 3d 20 30 3b 0a 20 20 20 20 70 yLeaf = 0;. p
c1a0: 50 61 67 65 2d 3e 6e 6f 50 61 79 6c 6f 61 64 20 Page->noPayload
c1b0: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e = 0;. pPage->
c1c0: 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e maxLocal = pBt->
c1d0: 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 20 20 70 50 maxLocal;. pP
c1e0: 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 age->minLocal =
c1f0: 70 42 74 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 pBt->minLocal;.
c200: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
c210: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
c220: 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 70 50 T_BKPT;. }. pP
c230: 61 67 65 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 age->max1bytePay
c240: 6c 6f 61 64 20 3d 20 70 42 74 2d 3e 6d 61 78 31 load = pBt->max1
c250: 62 79 74 65 50 61 79 6c 6f 61 64 3b 0a 20 20 72 bytePayload;. r
c260: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
c270: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 .}../*.** Initia
c280: 6c 69 7a 65 20 74 68 65 20 61 75 78 69 6c 69 61 lize the auxilia
c290: 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 ry information f
c2a0: 6f 72 20 61 20 64 69 73 6b 20 62 6c 6f 63 6b 2e or a disk block.
c2b0: 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 .**.** Return SQ
c2c0: 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 LITE_OK on succe
c2d0: 73 73 2e 20 20 49 66 20 77 65 20 73 65 65 20 74 ss. If we see t
c2e0: 68 61 74 20 74 68 65 20 70 61 67 65 20 64 6f 65 hat the page doe
c2f0: 73 0a 2a 2a 20 6e 6f 74 20 63 6f 6e 74 61 69 6e s.** not contain
c300: 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 a well-formed d
c310: 61 74 61 62 61 73 65 20 70 61 67 65 2c 20 74 68 atabase page, th
c320: 65 6e 20 72 65 74 75 72 6e 20 0a 2a 2a 20 53 51 en return .** SQ
c330: 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e 20 20 4e LITE_CORRUPT. N
c340: 6f 74 65 20 74 68 61 74 20 61 20 72 65 74 75 72 ote that a retur
c350: 6e 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4b 20 64 n of SQLITE_OK d
c360: 6f 65 73 20 6e 6f 74 0a 2a 2a 20 67 75 61 72 61 oes not.** guara
c370: 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 70 61 ntee that the pa
c380: 67 65 20 69 73 20 77 65 6c 6c 2d 66 6f 72 6d 65 ge is well-forme
c390: 64 2e 20 20 49 74 20 6f 6e 6c 79 20 73 68 6f 77 d. It only show
c3a0: 73 20 74 68 61 74 0a 2a 2a 20 77 65 20 66 61 69 s that.** we fai
c3b0: 6c 65 64 20 74 6f 20 64 65 74 65 63 74 20 61 6e led to detect an
c3c0: 79 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f y corruption..*/
c3d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
c3e0: 65 49 6e 69 74 50 61 67 65 28 4d 65 6d 50 61 67 eInitPage(MemPag
c3f0: 65 20 2a 70 50 61 67 65 29 7b 0a 0a 20 20 61 73 e *pPage){.. as
c400: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 sert( pPage->pBt
c410: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
c420: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
c430: 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
c440: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
c450: 72 74 28 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3d rt( pPage->pgno=
c460: 3d 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 =sqlite3PagerPag
c470: 65 6e 75 6d 62 65 72 28 70 50 61 67 65 2d 3e 70 enumber(pPage->p
c480: 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 DbPage) );. ass
c490: 65 72 74 28 20 70 50 61 67 65 20 3d 3d 20 73 71 ert( pPage == sq
c4a0: 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
c4b0: 72 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ra(pPage->pDbPag
c4c0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
c4d0: 70 50 61 67 65 2d 3e 61 44 61 74 61 20 3d 3d 20 pPage->aData ==
c4e0: 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 sqlite3PagerGetD
c4f0: 61 74 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ata(pPage->pDbPa
c500: 67 65 29 20 29 3b 0a 0a 20 20 69 66 28 20 21 70 ge) );.. if( !p
c510: 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a Page->isInit ){.
c520: 20 20 20 20 75 31 36 20 70 63 3b 20 20 20 20 20 u16 pc;
c530: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 /* Addres
c540: 73 20 6f 66 20 61 20 66 72 65 65 62 6c 6f 63 6b s of a freeblock
c550: 20 77 69 74 68 69 6e 20 70 50 61 67 65 2d 3e 61 within pPage->a
c560: 44 61 74 61 5b 5d 20 2a 2f 0a 20 20 20 20 75 38 Data[] */. u8
c570: 20 68 64 72 3b 20 20 20 20 20 20 20 20 20 20 20 hdr;
c580: 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 62 65 /* Offset to be
c590: 67 69 6e 6e 69 6e 67 20 6f 66 20 70 61 67 65 20 ginning of page
c5a0: 68 65 61 64 65 72 20 2a 2f 0a 20 20 20 20 75 38 header */. u8
c5b0: 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 20 20 *data;
c5c0: 20 2f 2a 20 45 71 75 61 6c 20 74 6f 20 70 50 61 /* Equal to pPa
c5d0: 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 20 ge->aData */.
c5e0: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b 20 BtShared *pBt;
c5f0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 /* The ma
c600: 69 6e 20 62 74 72 65 65 20 73 74 72 75 63 74 75 in btree structu
c610: 72 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 75 73 re */. int us
c620: 61 62 6c 65 53 69 7a 65 3b 20 20 20 20 2f 2a 20 ableSize; /*
c630: 41 6d 6f 75 6e 74 20 6f 66 20 75 73 61 62 6c 65 Amount of usable
c640: 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 space on each p
c650: 61 67 65 20 2a 2f 0a 20 20 20 20 75 31 36 20 63 age */. u16 c
c660: 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a ellOffset; /*
c670: 20 4f 66 66 73 65 74 20 66 72 6f 6d 20 73 74 61 Offset from sta
c680: 72 74 20 6f 66 20 70 61 67 65 20 74 6f 20 66 69 rt of page to fi
c690: 72 73 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 rst cell pointer
c6a0: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72 65 */. int nFre
c6b0: 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 e; /* Nu
c6c0: 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 mber of unused b
c6d0: 79 74 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 ytes on the page
c6e0: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 74 6f 70 3b */. int top;
c6f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
c700: 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 rst byte of the
c710: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 cell content are
c720: 61 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 65 a */. int iCe
c730: 6c 6c 46 69 72 73 74 3b 20 20 20 20 2f 2a 20 46 llFirst; /* F
c740: 69 72 73 74 20 61 6c 6c 6f 77 61 62 6c 65 20 63 irst allowable c
c750: 65 6c 6c 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b ell or freeblock
c760: 20 6f 66 66 73 65 74 20 2a 2f 0a 20 20 20 20 69 offset */. i
c770: 6e 74 20 69 43 65 6c 6c 4c 61 73 74 3b 20 20 20 nt iCellLast;
c780: 20 20 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 /* Last possib
c790: 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 65 65 62 le cell or freeb
c7a0: 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 0a lock offset */..
c7b0: 20 20 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d pBt = pPage-
c7c0: 3e 70 42 74 3b 0a 0a 20 20 20 20 68 64 72 20 3d >pBt;.. hdr =
c7d0: 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 pPage->hdrOffse
c7e0: 74 3b 0a 20 20 20 20 64 61 74 61 20 3d 20 70 50 t;. data = pP
c7f0: 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 age->aData;.
c800: 69 66 28 20 64 65 63 6f 64 65 46 6c 61 67 73 28 if( decodeFlags(
c810: 70 50 61 67 65 2c 20 64 61 74 61 5b 68 64 72 5d pPage, data[hdr]
c820: 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ) ) return SQLIT
c830: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
c840: 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
c850: 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 >pageSize>=512 &
c860: 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c & pBt->pageSize<
c870: 3d 36 35 35 33 36 20 29 3b 0a 20 20 20 20 70 50 =65536 );. pP
c880: 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 age->maskPage =
c890: 28 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 (u16)(pBt->pageS
c8a0: 69 7a 65 20 2d 20 31 29 3b 0a 20 20 20 20 70 50 ize - 1);. pP
c8b0: 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d age->nOverflow =
c8c0: 20 30 3b 0a 20 20 20 20 75 73 61 62 6c 65 53 69 0;. usableSi
c8d0: 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 ze = pBt->usable
c8e0: 53 69 7a 65 3b 0a 20 20 20 20 70 50 61 67 65 2d Size;. pPage-
c8f0: 3e 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 63 65 >cellOffset = ce
c900: 6c 6c 4f 66 66 73 65 74 20 3d 20 68 64 72 20 2b llOffset = hdr +
c910: 20 31 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 12 - 4*pPage->l
c920: 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e eaf;. pPage->
c930: 61 44 61 74 61 45 6e 64 20 3d 20 26 64 61 74 61 aDataEnd = &data
c940: 5b 75 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 [usableSize];.
c950: 20 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 pPage->aCellId
c960: 78 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 x = &data[cellOf
c970: 66 73 65 74 5d 3b 0a 20 20 20 20 74 6f 70 20 3d fset];. top =
c980: 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f get2byteNotZero
c990: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a (&data[hdr+5]);.
c9a0: 20 20 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c pPage->nCell
c9b0: 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 = get2byte(&dat
c9c0: 61 5b 68 64 72 2b 33 5d 29 3b 0a 20 20 20 20 69 a[hdr+3]);. i
c9d0: 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e f( pPage->nCell>
c9e0: 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 7b 0a MX_CELL(pBt) ){.
c9f0: 20 20 20 20 20 20 2f 2a 20 54 6f 20 6d 61 6e 79 /* To many
ca00: 20 63 65 6c 6c 73 20 66 6f 72 20 61 20 73 69 6e cells for a sin
ca10: 67 6c 65 20 70 61 67 65 2e 20 20 54 68 65 20 70 gle page. The p
ca20: 61 67 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 age must be corr
ca30: 75 70 74 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 upt */. ret
ca40: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
ca50: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 PT_BKPT;. }.
ca60: 20 20 20 74 65 73 74 63 61 73 65 28 20 70 50 61 testcase( pPa
ca70: 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 4d 58 5f 43 45 ge->nCell==MX_CE
ca80: 4c 4c 28 70 42 74 29 20 29 3b 0a 0a 20 20 20 20 LL(pBt) );..
ca90: 2f 2a 20 41 20 6d 61 6c 66 6f 72 6d 65 64 20 64 /* A malformed d
caa0: 61 74 61 62 61 73 65 20 70 61 67 65 20 6d 69 67 atabase page mig
cab0: 68 74 20 63 61 75 73 65 20 75 73 20 74 6f 20 72 ht cause us to r
cac0: 65 61 64 20 70 61 73 74 20 74 68 65 20 65 6e 64 ead past the end
cad0: 0a 20 20 20 20 2a 2a 20 6f 66 20 70 61 67 65 20 . ** of page
cae0: 77 68 65 6e 20 70 61 72 73 69 6e 67 20 61 20 63 when parsing a c
caf0: 65 6c 6c 2e 20 20 0a 20 20 20 20 2a 2a 0a 20 20 ell. . **.
cb00: 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 ** The followi
cb10: 6e 67 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 ng block of code
cb20: 20 63 68 65 63 6b 73 20 65 61 72 6c 79 20 74 6f checks early to
cb30: 20 73 65 65 20 69 66 20 61 20 63 65 6c 6c 20 65 see if a cell e
cb40: 78 74 65 6e 64 73 0a 20 20 20 20 2a 2a 20 70 61 xtends. ** pa
cb50: 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 st the end of a
cb60: 70 61 67 65 20 62 6f 75 6e 64 61 72 79 20 61 6e page boundary an
cb70: 64 20 63 61 75 73 65 73 20 53 51 4c 49 54 45 5f d causes SQLITE_
cb80: 43 4f 52 52 55 50 54 20 74 6f 20 62 65 20 0a 20 CORRUPT to be .
cb90: 20 20 20 2a 2a 20 72 65 74 75 72 6e 65 64 20 69 ** returned i
cba0: 66 20 69 74 20 64 6f 65 73 2e 0a 20 20 20 20 2a f it does.. *
cbb0: 2f 0a 20 20 20 20 69 43 65 6c 6c 46 69 72 73 74 /. iCellFirst
cbc0: 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 = cellOffset +
cbd0: 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 2*pPage->nCell;.
cbe0: 20 20 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 iCellLast =
cbf0: 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a usableSize - 4;.
cc00: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
cc10: 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 TE_ENABLE_OVERSI
cc20: 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 0a 20 ZE_CELL_CHECK).
cc30: 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 {. int i
cc40: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
cc50: 49 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20 63 Index into the c
cc60: 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 ell pointer arra
cc70: 79 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 y */. int s
cc80: 7a 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 z; /*
cc90: 53 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a Size of a cell *
cca0: 2f 0a 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 /.. if( !pP
ccb0: 61 67 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c age->leaf ) iCel
ccc0: 6c 4c 61 73 74 2d 2d 3b 0a 20 20 20 20 20 20 66 lLast--;. f
ccd0: 6f 72 28 69 3d 30 3b 20 69 3c 70 50 61 67 65 2d or(i=0; i<pPage-
cce0: 3e 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 >nCell; i++){.
ccf0: 20 20 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 pc = get2b
cd00: 79 74 65 28 26 64 61 74 61 5b 63 65 6c 6c 4f 66 yte(&data[cellOf
cd10: 66 73 65 74 2b 69 2a 32 5d 29 3b 0a 20 20 20 20 fset+i*2]);.
cd20: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
cd30: 3d 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a ==iCellFirst );.
cd40: 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
cd50: 28 20 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 ( pc==iCellLast
cd60: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
cd70: 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 c<iCellFirst ||
cd80: 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
cd90: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
cda0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
cdb0: 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a BKPT;. }.
cdc0: 20 20 20 20 20 20 20 20 73 7a 20 3d 20 63 65 6c sz = cel
cdd0: 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 lSizePtr(pPage,
cde0: 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 &data[pc]);.
cdf0: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
ce00: 2b 73 7a 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 +sz==usableSize
ce10: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
ce20: 63 2b 73 7a 3e 75 73 61 62 6c 65 53 69 7a 65 20 c+sz>usableSize
ce30: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 ){. ret
ce40: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
ce50: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 PT_BKPT;.
ce60: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
ce70: 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
ce80: 66 20 29 20 69 43 65 6c 6c 4c 61 73 74 2b 2b 3b f ) iCellLast++;
ce90: 0a 20 20 20 20 7d 20 20 0a 23 65 6e 64 69 66 0a . } .#endif.
cea0: 0a 20 20 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 . /* Compute
ceb0: 74 68 65 20 74 6f 74 61 6c 20 66 72 65 65 20 73 the total free s
cec0: 70 61 63 65 20 6f 6e 20 74 68 65 20 70 61 67 65 pace on the page
ced0: 20 2a 2f 0a 20 20 20 20 70 63 20 3d 20 67 65 74 */. pc = get
cee0: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
cef0: 31 5d 29 3b 0a 20 20 20 20 6e 46 72 65 65 20 3d 1]);. nFree =
cf00: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2b 20 74 data[hdr+7] + t
cf10: 6f 70 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 op;. while( p
cf20: 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 75 31 36 c>0 ){. u16
cf30: 20 6e 65 78 74 2c 20 73 69 7a 65 3b 0a 20 20 20 next, size;.
cf40: 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 if( pc<iCellF
cf50: 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c irst || pc>iCell
cf60: 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 Last ){.
cf70: 2f 2a 20 53 74 61 72 74 20 6f 66 20 66 72 65 65 /* Start of free
cf80: 20 62 6c 6f 63 6b 20 69 73 20 6f 66 66 20 74 68 block is off th
cf90: 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 e page */.
cfa0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
cfb0: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 CORRUPT_BKPT; .
cfc0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 65 78 }. nex
cfd0: 74 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 t = get2byte(&da
cfe0: 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 73 ta[pc]);. s
cff0: 69 7a 65 20 3d 20 67 65 74 32 62 79 74 65 28 26 ize = get2byte(&
d000: 64 61 74 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 data[pc+2]);.
d010: 20 20 20 69 66 28 20 28 6e 65 78 74 3e 30 20 26 if( (next>0 &
d020: 26 20 6e 65 78 74 3c 3d 70 63 2b 73 69 7a 65 2b & next<=pc+size+
d030: 33 29 20 7c 7c 20 70 63 2b 73 69 7a 65 3e 75 73 3) || pc+size>us
d040: 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 ableSize ){.
d050: 20 20 20 20 2f 2a 20 46 72 65 65 20 62 6c 6f 63 /* Free bloc
d060: 6b 73 20 6d 75 73 74 20 62 65 20 69 6e 20 61 73 ks must be in as
d070: 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 20 41 cending order. A
d080: 6e 64 20 74 68 65 20 6c 61 73 74 20 62 79 74 65 nd the last byte
d090: 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 of. ** t
d0a0: 68 65 20 66 72 65 65 2d 62 6c 6f 63 6b 20 6d 75 he free-block mu
d0b0: 73 74 20 6c 69 65 20 6f 6e 20 74 68 65 20 64 61 st lie on the da
d0c0: 74 61 62 61 73 65 20 70 61 67 65 2e 20 20 2a 2f tabase page. */
d0d0: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
d0e0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
d0f0: 4b 50 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 KPT; . }.
d100: 20 20 20 20 6e 46 72 65 65 20 3d 20 6e 46 72 65 nFree = nFre
d110: 65 20 2b 20 73 69 7a 65 3b 0a 20 20 20 20 20 20 e + size;.
d120: 70 63 20 3d 20 6e 65 78 74 3b 0a 20 20 20 20 7d pc = next;. }
d130: 0a 0a 20 20 20 20 2f 2a 20 41 74 20 74 68 69 73 .. /* At this
d140: 20 70 6f 69 6e 74 2c 20 6e 46 72 65 65 20 63 6f point, nFree co
d150: 6e 74 61 69 6e 73 20 74 68 65 20 73 75 6d 20 6f ntains the sum o
d160: 66 20 74 68 65 20 6f 66 66 73 65 74 20 74 6f 20 f the offset to
d170: 74 68 65 20 73 74 61 72 74 0a 20 20 20 20 2a 2a the start. **
d180: 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e of the cell-con
d190: 74 65 6e 74 20 61 72 65 61 20 70 6c 75 73 20 74 tent area plus t
d1a0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 65 he number of fre
d1b0: 65 20 62 79 74 65 73 20 77 69 74 68 69 6e 0a 20 e bytes within.
d1c0: 20 20 20 2a 2a 20 74 68 65 20 63 65 6c 6c 2d 63 ** the cell-c
d1d0: 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 49 66 20 ontent area. If
d1e0: 74 68 69 73 20 69 73 20 67 72 65 61 74 65 72 20 this is greater
d1f0: 74 68 61 6e 20 74 68 65 20 75 73 61 62 6c 65 2d than the usable-
d200: 73 69 7a 65 0a 20 20 20 20 2a 2a 20 6f 66 20 74 size. ** of t
d210: 68 65 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 he page, then th
d220: 65 20 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 e page must be c
d230: 6f 72 72 75 70 74 65 64 2e 20 54 68 69 73 20 63 orrupted. This c
d240: 68 65 63 6b 20 61 6c 73 6f 0a 20 20 20 20 2a 2a heck also. **
d250: 20 73 65 72 76 65 73 20 74 6f 20 76 65 72 69 66 serves to verif
d260: 79 20 74 68 61 74 20 74 68 65 20 6f 66 66 73 65 y that the offse
d270: 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f t to the start o
d280: 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 65 f the cell-conte
d290: 6e 74 0a 20 20 20 20 2a 2a 20 61 72 65 61 2c 20 nt. ** area,
d2a0: 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 according to the
d2b0: 20 70 61 67 65 20 68 65 61 64 65 72 2c 20 6c 69 page header, li
d2c0: 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 es within the pa
d2d0: 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ge.. */. i
d2e0: 66 28 20 6e 46 72 65 65 3e 75 73 61 62 6c 65 53 f( nFree>usableS
d2f0: 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72 65 74 ize ){. ret
d300: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
d310: 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 20 7d 0a PT_BKPT; . }.
d320: 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 pPage->nFree
d330: 20 3d 20 28 75 31 36 29 28 6e 46 72 65 65 20 2d = (u16)(nFree -
d340: 20 69 43 65 6c 6c 46 69 72 73 74 29 3b 0a 20 20 iCellFirst);.
d350: 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 pPage->isInit
d360: 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 = 1;. }. retur
d370: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
d380: 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 20 61 20 72 /*.** Set up a r
d390: 61 77 20 70 61 67 65 20 73 6f 20 74 68 61 74 20 aw page so that
d3a0: 69 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 61 20 it looks like a
d3b0: 64 61 74 61 62 61 73 65 20 70 61 67 65 20 68 6f database page ho
d3c0: 6c 64 69 6e 67 0a 2a 2a 20 6e 6f 20 65 6e 74 72 lding.** no entr
d3d0: 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ies..*/.static v
d3e0: 6f 69 64 20 7a 65 72 6f 50 61 67 65 28 4d 65 6d oid zeroPage(Mem
d3f0: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
d400: 20 66 6c 61 67 73 29 7b 0a 20 20 75 6e 73 69 67 flags){. unsig
d410: 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d ned char *data =
d420: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 pPage->aData;.
d430: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
d440: 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 75 pPage->pBt;. u
d450: 38 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 8 hdr = pPage->h
d460: 64 72 4f 66 66 73 65 74 3b 0a 20 20 75 31 36 20 drOffset;. u16
d470: 66 69 72 73 74 3b 0a 0a 20 20 61 73 73 65 72 74 first;.. assert
d480: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ( sqlite3PagerPa
d490: 67 65 6e 75 6d 62 65 72 28 70 50 61 67 65 2d 3e genumber(pPage->
d4a0: 70 44 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d pDbPage)==pPage-
d4b0: 3e 70 67 6e 6f 20 29 3b 0a 20 20 61 73 73 65 72 >pgno );. asser
d4c0: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
d4d0: 65 74 45 78 74 72 61 28 70 50 61 67 65 2d 3e 70 etExtra(pPage->p
d4e0: 44 62 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 64 DbPage) == (void
d4f0: 2a 29 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 *)pPage );. ass
d500: 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
d510: 72 47 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e rGetData(pPage->
d520: 70 44 62 50 61 67 65 29 20 3d 3d 20 64 61 74 61 pDbPage) == data
d530: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
d540: 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
d550: 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
d560: 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 Page) );. asser
d570: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
d580: 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
d590: 29 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e ) );. if( pBt->
d5a0: 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 btsFlags & BTS_S
d5b0: 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a ECURE_DELETE ){.
d5c0: 20 20 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 memset(&data
d5d0: 5b 68 64 72 5d 2c 20 30 2c 20 70 42 74 2d 3e 75 [hdr], 0, pBt->u
d5e0: 73 61 62 6c 65 53 69 7a 65 20 2d 20 68 64 72 29 sableSize - hdr)
d5f0: 3b 0a 20 20 7d 0a 20 20 64 61 74 61 5b 68 64 72 ;. }. data[hdr
d600: 5d 20 3d 20 28 63 68 61 72 29 66 6c 61 67 73 3b ] = (char)flags;
d610: 0a 20 20 66 69 72 73 74 20 3d 20 68 64 72 20 2b . first = hdr +
d620: 20 28 28 66 6c 61 67 73 26 50 54 46 5f 4c 45 41 ((flags&PTF_LEA
d630: 46 29 3d 3d 30 20 3f 20 31 32 20 3a 20 38 29 3b F)==0 ? 12 : 8);
d640: 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b . memset(&data[
d650: 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a 20 hdr+1], 0, 4);.
d660: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 data[hdr+7] = 0
d670: 3b 0a 20 20 70 75 74 32 62 79 74 65 28 26 64 61 ;. put2byte(&da
d680: 74 61 5b 68 64 72 2b 35 5d 2c 20 70 42 74 2d 3e ta[hdr+5], pBt->
d690: 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 70 usableSize);. p
d6a0: 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 75 Page->nFree = (u
d6b0: 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 16)(pBt->usableS
d6c0: 69 7a 65 20 2d 20 66 69 72 73 74 29 3b 0a 20 20 ize - first);.
d6d0: 64 65 63 6f 64 65 46 6c 61 67 73 28 70 50 61 67 decodeFlags(pPag
d6e0: 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 70 50 61 e, flags);. pPa
d6f0: 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 3d ge->cellOffset =
d700: 20 66 69 72 73 74 3b 0a 20 20 70 50 61 67 65 2d first;. pPage-
d710: 3e 61 44 61 74 61 45 6e 64 20 3d 20 26 64 61 74 >aDataEnd = &dat
d720: 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a a[pBt->usableSiz
d730: 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 61 43 65 e];. pPage->aCe
d740: 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b 66 69 llIdx = &data[fi
d750: 72 73 74 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 6e rst];. pPage->n
d760: 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 Overflow = 0;.
d770: 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 67 assert( pBt->pag
d780: 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 42 eSize>=512 && pB
d790: 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 35 t->pageSize<=655
d7a0: 33 36 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6d 36 );. pPage->m
d7b0: 61 73 6b 50 61 67 65 20 3d 20 28 75 31 36 29 28 askPage = (u16)(
d7c0: 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 pBt->pageSize -
d7d0: 31 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 43 65 1);. pPage->nCe
d7e0: 6c 6c 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d ll = 0;. pPage-
d7f0: 3e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 7d 0a 0a >isInit = 1;.}..
d800: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61 ./*.** Convert a
d810: 20 44 62 50 61 67 65 20 6f 62 74 61 69 6e 65 64 DbPage obtained
d820: 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 from the pager
d830: 69 6e 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 75 into a MemPage u
d840: 73 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 62 74 sed by.** the bt
d850: 72 65 65 20 6c 61 79 65 72 2e 0a 2a 2f 0a 73 74 ree layer..*/.st
d860: 61 74 69 63 20 4d 65 6d 50 61 67 65 20 2a 62 74 atic MemPage *bt
d870: 72 65 65 50 61 67 65 46 72 6f 6d 44 62 50 61 67 reePageFromDbPag
d880: 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 e(DbPage *pDbPag
d890: 65 2c 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 42 74 e, Pgno pgno, Bt
d8a0: 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 Shared *pBt){.
d8b0: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
d8c0: 20 28 4d 65 6d 50 61 67 65 2a 29 73 71 6c 69 74 (MemPage*)sqlit
d8d0: 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 e3PagerGetExtra(
d8e0: 70 44 62 50 61 67 65 29 3b 0a 20 20 70 50 61 67 pDbPage);. pPag
d8f0: 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c 69 74 e->aData = sqlit
d900: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
d910: 44 62 50 61 67 65 29 3b 0a 20 20 70 50 61 67 65 DbPage);. pPage
d920: 2d 3e 70 44 62 50 61 67 65 20 3d 20 70 44 62 50 ->pDbPage = pDbP
d930: 61 67 65 3b 0a 20 20 70 50 61 67 65 2d 3e 70 42 age;. pPage->pB
d940: 74 20 3d 20 70 42 74 3b 0a 20 20 70 50 61 67 65 t = pBt;. pPage
d950: 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b 0a 20 ->pgno = pgno;.
d960: 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 pPage->hdrOffse
d970: 74 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3d t = pPage->pgno=
d980: 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b 0a 20 20 =1 ? 100 : 0;.
d990: 72 65 74 75 72 6e 20 70 50 61 67 65 3b 20 0a 7d return pPage; .}
d9a0: 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 ../*.** Get a pa
d9b0: 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ge from the page
d9c0: 72 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 r. Initialize t
d9d0: 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 he MemPage.pBt a
d9e0: 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 nd.** MemPage.aD
d9f0: 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 ata elements if
da00: 6e 65 65 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 needed..**.** If
da10: 20 74 68 65 20 6e 6f 43 6f 6e 74 65 6e 74 20 66 the noContent f
da20: 6c 61 67 20 69 73 20 73 65 74 2c 20 69 74 20 6d lag is set, it m
da30: 65 61 6e 73 20 74 68 61 74 20 77 65 20 64 6f 20 eans that we do
da40: 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 0a 2a not care about.*
da50: 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 * the content of
da60: 20 74 68 65 20 70 61 67 65 20 61 74 20 74 68 69 the page at thi
da70: 73 20 74 69 6d 65 2e 20 20 53 6f 20 64 6f 20 6e s time. So do n
da80: 6f 74 20 67 6f 20 74 6f 20 74 68 65 20 64 69 73 ot go to the dis
da90: 6b 0a 2a 2a 20 74 6f 20 66 65 74 63 68 20 74 68 k.** to fetch th
daa0: 65 20 63 6f 6e 74 65 6e 74 2e 20 20 4a 75 73 74 e content. Just
dab0: 20 66 69 6c 6c 20 69 6e 20 74 68 65 20 63 6f 6e fill in the con
dac0: 74 65 6e 74 20 77 69 74 68 20 7a 65 72 6f 73 20 tent with zeros
dad0: 66 6f 72 20 6e 6f 77 2e 0a 2a 2a 20 49 66 20 69 for now..** If i
dae0: 6e 20 74 68 65 20 66 75 74 75 72 65 20 77 65 20 n the future we
daf0: 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 65 call sqlite3Page
db00: 72 57 72 69 74 65 28 29 20 6f 6e 20 74 68 69 73 rWrite() on this
db10: 20 70 61 67 65 2c 20 74 68 61 74 0a 2a 2a 20 6d page, that.** m
db20: 65 61 6e 73 20 77 65 20 68 61 76 65 20 73 74 61 eans we have sta
db30: 72 74 65 64 20 74 6f 20 62 65 20 63 6f 6e 63 65 rted to be conce
db40: 72 6e 65 64 20 61 62 6f 75 74 20 63 6f 6e 74 65 rned about conte
db50: 6e 74 20 61 6e 64 20 74 68 65 20 64 69 73 6b 0a nt and the disk.
db60: 2a 2a 20 72 65 61 64 20 73 68 6f 75 6c 64 20 6f ** read should o
db70: 63 63 75 72 20 61 74 20 74 68 61 74 20 70 6f 69 ccur at that poi
db80: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nt..*/.static in
db90: 74 20 62 74 72 65 65 47 65 74 50 61 67 65 28 0a t btreeGetPage(.
dba0: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c BtShared *pBt,
dbb0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 /* The bt
dbc0: 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 ree */. Pgno pg
dbd0: 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a no, /*
dbe0: 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 70 Number of the p
dbf0: 61 67 65 20 74 6f 20 66 65 74 63 68 20 2a 2f 0a age to fetch */.
dc00: 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 MemPage **ppPa
dc10: 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 75 72 6e ge, /* Return
dc20: 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 69 the page in thi
dc30: 73 20 70 61 72 61 6d 65 74 65 72 20 2a 2f 0a 20 s parameter */.
dc40: 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 20 20 int flags
dc50: 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f 47 /* PAGER_G
dc60: 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 6f 72 20 ET_NOCONTENT or
dc70: 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e PAGER_GET_READON
dc80: 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 LY */.){. int r
dc90: 63 3b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 c;. DbPage *pDb
dca0: 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 Page;.. assert(
dcb0: 20 66 6c 61 67 73 3d 3d 30 20 7c 7c 20 66 6c 61 flags==0 || fla
dcc0: 67 73 3d 3d 50 41 47 45 52 5f 47 45 54 5f 4e 4f gs==PAGER_GET_NO
dcd0: 43 4f 4e 54 45 4e 54 20 7c 7c 20 66 6c 61 67 73 CONTENT || flags
dce0: 3d 3d 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 ==PAGER_GET_READ
dcf0: 4f 4e 4c 59 20 29 3b 0a 20 20 61 73 73 65 72 74 ONLY );. assert
dd00: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
dd10: 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
dd20: 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 );. rc = sqlit
dd30: 65 33 50 61 67 65 72 41 63 71 75 69 72 65 28 70 e3PagerAcquire(p
dd40: 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f Bt->pPager, pgno
dd50: 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 62 , (DbPage**)&pDb
dd60: 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
dd70: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
dd80: 72 63 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 rc;. *ppPage =
dd90: 62 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 50 btreePageFromDbP
dda0: 61 67 65 28 70 44 62 50 61 67 65 2c 20 70 67 6e age(pDbPage, pgn
ddb0: 6f 2c 20 70 42 74 29 3b 0a 20 20 72 65 74 75 72 o, pBt);. retur
ddc0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
ddd0: 2f 2a 0a 2a 2a 20 52 65 74 72 69 65 76 65 20 61 /*.** Retrieve a
dde0: 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 page from the p
ddf0: 61 67 65 72 20 63 61 63 68 65 2e 20 49 66 20 74 ager cache. If t
de00: 68 65 20 72 65 71 75 65 73 74 65 64 20 70 61 67 he requested pag
de10: 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 e is not.** alre
de20: 61 64 79 20 69 6e 20 74 68 65 20 70 61 67 65 72 ady in the pager
de30: 20 63 61 63 68 65 20 72 65 74 75 72 6e 20 4e 55 cache return NU
de40: 4c 4c 2e 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 LL. Initialize t
de50: 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 he MemPage.pBt a
de60: 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 nd.** MemPage.aD
de70: 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 ata elements if
de80: 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 needed..*/.stati
de90: 63 20 4d 65 6d 50 61 67 65 20 2a 62 74 72 65 65 c MemPage *btree
dea0: 50 61 67 65 4c 6f 6f 6b 75 70 28 42 74 53 68 61 PageLookup(BtSha
deb0: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 red *pBt, Pgno p
dec0: 67 6e 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 2a gno){. DbPage *
ded0: 70 44 62 50 61 67 65 3b 0a 20 20 61 73 73 65 72 pDbPage;. asser
dee0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
def0: 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
df00: 29 20 29 3b 0a 20 20 70 44 62 50 61 67 65 20 3d ) );. pDbPage =
df10: 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f sqlite3PagerLoo
df20: 6b 75 70 28 70 42 74 2d 3e 70 50 61 67 65 72 2c kup(pBt->pPager,
df30: 20 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 70 44 pgno);. if( pD
df40: 62 50 61 67 65 20 29 7b 0a 20 20 20 20 72 65 74 bPage ){. ret
df50: 75 72 6e 20 62 74 72 65 65 50 61 67 65 46 72 6f urn btreePageFro
df60: 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 2c mDbPage(pDbPage,
df70: 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 7d pgno, pBt);. }
df80: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a . return 0;.}..
df90: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
dfa0: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
dfb0: 61 62 61 73 65 20 66 69 6c 65 20 69 6e 20 70 61 abase file in pa
dfc0: 67 65 73 2e 20 49 66 20 74 68 65 72 65 20 69 73 ges. If there is
dfd0: 20 61 6e 79 20 6b 69 6e 64 20 6f 66 0a 2a 2a 20 any kind of.**
dfe0: 65 72 72 6f 72 2c 20 72 65 74 75 72 6e 20 28 28 error, return ((
dff0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 2d 31 29 unsigned int)-1)
e000: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f ..*/.static Pgno
e010: 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 btreePagecount(
e020: 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
e030: 20 20 72 65 74 75 72 6e 20 70 42 74 2d 3e 6e 50 return pBt->nP
e040: 61 67 65 3b 0a 7d 0a 75 33 32 20 73 71 6c 69 74 age;.}.u32 sqlit
e050: 65 33 42 74 72 65 65 4c 61 73 74 50 61 67 65 28 e3BtreeLastPage(
e060: 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 61 73 73 Btree *p){. ass
e070: 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 ert( sqlite3Btre
e080: 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 eHoldsMutex(p) )
e090: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 28 70 2d ;. assert( ((p-
e0a0: 3e 70 42 74 2d 3e 6e 50 61 67 65 29 26 30 78 38 >pBt->nPage)&0x8
e0b0: 30 30 30 30 30 30 29 3d 3d 30 20 29 3b 0a 20 20 000000)==0 );.
e0c0: 72 65 74 75 72 6e 20 62 74 72 65 65 50 61 67 65 return btreePage
e0d0: 63 6f 75 6e 74 28 70 2d 3e 70 42 74 29 3b 0a 7d count(p->pBt);.}
e0e0: 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 ../*.** Get a pa
e0f0: 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ge from the page
e100: 72 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 r and initialize
e110: 20 69 74 2e 20 20 54 68 69 73 20 72 6f 75 74 69 it. This routi
e120: 6e 65 20 69 73 20 6a 75 73 74 20 61 0a 2a 2a 20 ne is just a.**
e130: 63 6f 6e 76 65 6e 69 65 6e 63 65 20 77 72 61 70 convenience wrap
e140: 70 65 72 20 61 72 6f 75 6e 64 20 73 65 70 61 72 per around separ
e150: 61 74 65 20 63 61 6c 6c 73 20 74 6f 20 62 74 72 ate calls to btr
e160: 65 65 47 65 74 50 61 67 65 28 29 20 61 6e 64 20 eeGetPage() and
e170: 0a 2a 2a 20 62 74 72 65 65 49 6e 69 74 50 61 67 .** btreeInitPag
e180: 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e e()..**.** If an
e190: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 error occurs, t
e1a0: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 2a 70 hen the value *p
e1b0: 70 50 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 pPage is set to
e1c0: 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 49 74 is undefined. It
e1d0: 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e 20 75 .** may remain u
e1e0: 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 74 20 nchanged, or it
e1f0: 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 61 6e may be set to an
e200: 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 2e 0a invalid value..
e210: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 65 */.static int ge
e220: 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a 20 20 tAndInitPage(.
e230: 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 BtShared *pBt,
e240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e250: 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 /* The database
e260: 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 file */. Pgno p
e270: 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 gno,
e280: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
e290: 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 ber of the page
e2a0: 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 6d 50 to get */. MemP
e2b0: 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
e2c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
e2d0: 72 69 74 65 20 74 68 65 20 70 61 67 65 20 70 6f rite the page po
e2e0: 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a 20 20 inter here */.
e2f0: 69 6e 74 20 62 52 65 61 64 6f 6e 6c 79 20 20 20 int bReadonly
e300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e310: 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 /* PAGER_GET_REA
e320: 44 4f 4e 4c 59 20 6f 72 20 30 20 2a 2f 0a 29 7b DONLY or 0 */.){
e330: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 . int rc;. ass
e340: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
e350: 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
e360: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
e370: 20 62 52 65 61 64 6f 6e 6c 79 3d 3d 50 41 47 45 bReadonly==PAGE
e380: 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 7c R_GET_READONLY |
e390: 7c 20 62 52 65 61 64 6f 6e 6c 79 3d 3d 30 20 29 | bReadonly==0 )
e3a0: 3b 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 74 ;.. if( pgno>bt
e3b0: 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
e3c0: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 ) ){. rc = SQ
e3d0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
e3e0: 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 T;. }else{.
e3f0: 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
e400: 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 50 e(pBt, pgno, ppP
e410: 61 67 65 2c 20 62 52 65 61 64 6f 6e 6c 79 29 3b age, bReadonly);
e420: 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
e430: 49 54 45 5f 4f 4b 20 26 26 20 28 2a 70 70 50 61 ITE_OK && (*ppPa
e440: 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 ge)->isInit==0 )
e450: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 {. rc = btr
e460: 65 65 49 6e 69 74 50 61 67 65 28 2a 70 70 50 61 eeInitPage(*ppPa
e470: 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 ge);. if( r
e480: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
e490: 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
e4a0: 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 age(*ppPage);.
e4b0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
e4c0: 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e . testcase( pgn
e4d0: 6f 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 o==0 );. assert
e4e0: 28 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d ( pgno!=0 || rc=
e4f0: 3d 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 =SQLITE_CORRUPT
e500: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
e510: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 }../*.** Release
e520: 20 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 a MemPage. Thi
e530: 73 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c s should be call
e540: 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 ed once for each
e550: 20 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 prior.** call t
e560: 6f 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a o btreeGetPage..
e570: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 */.static void r
e580: 65 6c 65 61 73 65 50 61 67 65 28 4d 65 6d 50 61 eleasePage(MemPa
e590: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 66 ge *pPage){. if
e5a0: 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 61 ( pPage ){. a
e5b0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
e5c0: 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ata );. asser
e5d0: 74 28 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b t( pPage->pBt );
e5e0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
e5f0: 67 65 2d 3e 70 44 62 50 61 67 65 21 3d 30 20 29 ge->pDbPage!=0 )
e600: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 ;. assert( sq
e610: 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
e620: 72 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ra(pPage->pDbPag
e630: 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 70 50 61 e) == (void*)pPa
e640: 67 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 ge );. assert
e650: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 ( sqlite3PagerGe
e660: 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 62 tData(pPage->pDb
e670: 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 44 Page)==pPage->aD
e680: 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ata );. asser
e690: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
e6a0: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
e6b0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 ->mutex) );.
e6c0: 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
e6d0: 66 4e 6f 74 4e 75 6c 6c 28 70 50 61 67 65 2d 3e fNotNull(pPage->
e6e0: 70 44 62 50 61 67 65 29 3b 0a 20 20 7d 0a 7d 0a pDbPage);. }.}.
e6f0: 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 20 ./*.** During a
e700: 72 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 74 rollback, when t
e710: 68 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 73 he pager reloads
e720: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 information int
e730: 6f 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 73 o the cache.** s
e740: 6f 20 74 68 61 74 20 74 68 65 20 63 61 63 68 65 o that the cache
e750: 20 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 is restored to
e760: 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 its original sta
e770: 74 65 20 61 74 20 74 68 65 20 73 74 61 72 74 20 te at the start
e780: 6f 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 of.** the transa
e790: 63 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 20 ction, for each
e7a0: 70 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 68 page restored th
e7b0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 is routine is ca
e7c0: 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 lled..**.** This
e7d0: 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 routine needs t
e7e0: 6f 20 72 65 73 65 74 20 74 68 65 20 65 78 74 72 o reset the extr
e7f0: 61 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 61 a data section a
e800: 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
e810: 0a 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 65 .** page to agre
e820: 65 20 77 69 74 68 20 74 68 65 20 72 65 73 74 6f e with the resto
e830: 72 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 red data..*/.sta
e840: 74 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 69 tic void pageRei
e850: 6e 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 74 nit(DbPage *pDat
e860: 61 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 a){. MemPage *p
e870: 50 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d 20 Page;. pPage =
e880: 28 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 74 (MemPage *)sqlit
e890: 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 e3PagerGetExtra(
e8a0: 70 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74 pData);. assert
e8b0: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ( sqlite3PagerPa
e8c0: 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 geRefcount(pData
e8d0: 29 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 61 )>0 );. if( pPa
e8e0: 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 ge->isInit ){.
e8f0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
e900: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
e910: 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
e920: 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 );. pPage->is
e930: 49 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 Init = 0;. if
e940: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ( sqlite3PagerPa
e950: 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 geRefcount(pData
e960: 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 )>1 ){. /*
e970: 70 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 20 pPage might not
e980: 62 65 20 61 20 62 74 72 65 65 20 70 61 67 65 3b be a btree page;
e990: 20 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 6e it might be an
e9a0: 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 overflow page.
e9b0: 20 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d 61 ** or ptrma
e9c0: 70 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 65 p page or a free
e9d0: 20 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 65 page. In those
e9e0: 20 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c 6c cases, the foll
e9f0: 6f 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 63 owing. ** c
ea00: 61 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 74 all to btreeInit
ea10: 50 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b 65 Page() will like
ea20: 6c 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ly return SQLITE
ea30: 5f 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 20 _CORRUPT..
ea40: 2a 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 69 ** But no harm i
ea50: 73 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e 20 s done by this.
ea60: 20 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 20 And it is very
ea70: 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a 20 important that.
ea80: 20 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e 69 ** btreeIni
ea90: 74 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c 65 tPage() be calle
eaa0: 64 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 65 d on every btree
eab0: 20 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b 65 page so we make
eac0: 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 61 . ** the ca
ead0: 6c 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 67 ll for every pag
eae0: 65 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e 20 e that comes in
eaf0: 66 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e 20 for re-initing.
eb00: 2a 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 6e */. btreeIn
eb10: 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 itPage(pPage);.
eb20: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a }. }.}../*.*
eb30: 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 * Invoke the bus
eb40: 79 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 20 y handler for a
eb50: 62 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 btree..*/.static
eb60: 20 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b 65 int btreeInvoke
eb70: 42 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64 BusyHandler(void
eb80: 20 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 61 *pArg){. BtSha
eb90: 72 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 68 red *pBt = (BtSh
eba0: 61 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 73 ared*)pArg;. as
ebb0: 73 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 3b sert( pBt->db );
ebc0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
ebd0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
ebe0: 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b t->db->mutex) );
ebf0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
ec00: 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 3InvokeBusyHandl
ec10: 65 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 73 er(&pBt->db->bus
ec20: 79 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a 2f 2a yHandler);.}../*
ec30: 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 62 .** Open a datab
ec40: 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a ase file..** .**
ec50: 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 zFilename is th
ec60: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 e name of the da
ec70: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
ec80: 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 zFilename is NU
ec90: 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 70 LL.** then an ep
eca0: 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 hemeral database
ecb0: 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 is created. Th
ecc0: 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 e ephemeral data
ecd0: 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 65 base might.** be
ece0: 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e 20 exclusively in
ecf0: 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d 69 memory, or it mi
ed00: 67 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d 62 ght use a disk-b
ed10: 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 68 ased memory cach
ed20: 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 79 e..** Either way
ed30: 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c 20 , the ephemeral
ed40: 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 database will be
ed50: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
ed60: 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e 20 eleted .** when
ed70: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
ed80: 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a e() is called..*
ed90: 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d *.** If zFilenam
eda0: 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 e is ":memory:"
edb0: 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 then an in-memor
edc0: 79 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 y database is cr
edd0: 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 73 eated.** that is
ede0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
edf0: 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 74 estroyed when it
ee00: 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a is closed..**.*
ee10: 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 61 * The "flags" pa
ee20: 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 74 rameter is a bit
ee30: 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 20 mask that might
ee40: 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 6b contain bits lik
ee50: 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 5f e.** BTREE_OMIT_
ee60: 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 42 JOURNAL and/or B
ee70: 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a 0a TREE_MEMORY..**.
ee80: 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
ee90: 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 se is already op
eea0: 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 ened in the same
eeb0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
eec0: 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 61 tion.** and we a
eed0: 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 re in shared cac
eee0: 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 he mode, then th
eef0: 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 6c e open will fail
ef00: 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c 49 with an.** SQLI
ef10: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 72 TE_CONSTRAINT er
ef20: 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 20 ror. We cannot
ef30: 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f 72 allow two or mor
ef40: 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f 62 e BtShared.** ob
ef50: 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 6d jects in the sam
ef60: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
ef70: 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 6e ction since doin
ef80: 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a 2a g so will lead.*
ef90: 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 69 * to problems wi
efa0: 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 th locking..*/.i
efb0: 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f nt sqlite3BtreeO
efc0: 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 pen(. sqlite3_v
efd0: 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 2f fs *pVfs, /
efe0: 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f 72 * VFS to use for
eff0: 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f 0a this b-tree */.
f000: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
f010: 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 6d ilename, /* Nam
f020: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f e of the file co
f030: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 ntaining the BTr
f040: 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ee database */.
f050: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
f060: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 6f /* Asso
f070: 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 ciated database
f080: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65 handle */. Btre
f090: 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 20 e **ppBtree,
f0a0: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
f0b0: 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 o new Btree obje
f0c0: 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 ct written here
f0d0: 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 */. int flags,
f0e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
f0f0: 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 Options */. int
f100: 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 20 vfsFlags
f110: 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 /* Flags pa
f120: 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 ssed through to
f130: 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
f140: 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 n() */.){. BtSh
f150: 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 20 ared *pBt = 0;
f160: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
f170: 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 72 ared part of btr
f180: 65 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a ee structure */.
f190: 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 20 Btree *p;
f1a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f1b0: 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 65 /* Handle to re
f1c0: 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 turn */. sqlite
f1d0: 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f 70 3_mutex *mutexOp
f1e0: 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 76 en = 0; /* Prev
f1f0: 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e 64 ents a race cond
f200: 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 33 ition. Ticket #3
f210: 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 537 */. int rc
f220: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
f230: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c /* Resul
f240: 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 73 t code from this
f250: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 function */. u
f260: 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 8 nReserve;
f270: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
f280: 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 20 Byte of unused
f290: 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 space on each pa
f2a0: 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ge */. unsigned
f2b0: 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 5b char zDbHeader[
f2c0: 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 61 100]; /* Databa
f2d0: 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 6e se header conten
f2e0: 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 20 t */.. /* True
f2f0: 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 70 if opening an ep
f300: 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 61 hemeral, tempora
f310: 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ry database */.
f320: 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 6d const int isTem
f330: 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3d pDb = zFilename=
f340: 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b =0 || zFilename[
f350: 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 74 0]==0;.. /* Set
f360: 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 the variable is
f370: 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 6f Memdb to true fo
f380: 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 r an in-memory d
f390: 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 2a atabase, or . *
f3a0: 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 69 * false for a fi
f3b0: 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 73 le-based databas
f3c0: 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 e.. */.#ifdef S
f3d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
f3e0: 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 YDB. const int
f3f0: 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 6c isMemdb = 0;.#el
f400: 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 se. const int i
f410: 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 6e sMemdb = (zFilen
f420: 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a 46 ame && strcmp(zF
f430: 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f 72 ilename, ":memor
f440: 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 20 y:")==0).
f450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f460: 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 20 || (isTempDb &&
f470: 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d sqlite3TempInMem
f480: 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 20 ory(db)).
f490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f4a0: 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 53 || (vfsFlags & S
f4b0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
f4c0: 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 Y)!=0;.#endif..
f4d0: 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 assert( db!=0 )
f4e0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 73 ;. assert( pVfs
f4f0: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
f500: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
f510: 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
f520: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 ;. assert( (fla
f530: 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 20 gs&0xff)==flags
f540: 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 ); /* flags fi
f550: 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a 0a t in 8 bits */..
f560: 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 45 /* Only a BTRE
f570: 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 E_SINGLE databas
f580: 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f 55 e can be BTREE_U
f590: 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 73 NORDERED */. as
f5a0: 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 sert( (flags & B
f5b0: 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 3d TREE_UNORDERED)=
f5c0: 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 42 =0 || (flags & B
f5d0: 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 20 TREE_SINGLE)!=0
f5e0: 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 45 );.. /* A BTREE
f5f0: 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 _SINGLE database
f600: 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 6d is always a tem
f610: 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 70 porary and/or ep
f620: 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 73 hemeral */. ass
f630: 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 ert( (flags & BT
f640: 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 7c REE_SINGLE)==0 |
f650: 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a 20 | isTempDb );..
f660: 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a if( isMemdb ){.
f670: 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 52 flags |= BTR
f680: 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 20 EE_MEMORY;. }.
f690: 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 if( (vfsFlags &
f6a0: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
f6b0: 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 4d N_DB)!=0 && (isM
f6c0: 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 62 emdb || isTempDb
f6d0: 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 ) ){. vfsFlag
f6e0: 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 s = (vfsFlags &
f6f0: 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 ~SQLITE_OPEN_MAI
f700: 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f N_DB) | SQLITE_O
f710: 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d PEN_TEMP_DB;. }
f720: 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 . p = sqlite3Ma
f730: 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 llocZero(sizeof(
f740: 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 21 Btree));. if( !
f750: 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 p ){. return
f760: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
f770: 7d 0a 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d }. p->inTrans =
f780: 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 70 TRANS_NONE;. p
f790: 2d 3e 64 62 20 3d 20 64 62 3b 0a 23 69 66 6e 64 ->db = db;.#ifnd
f7a0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
f7b0: 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 70 2d HARED_CACHE. p-
f7c0: 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 20 3d 20 70 >lock.pBtree = p
f7d0: 3b 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 62 ;. p->lock.iTab
f7e0: 6c 65 20 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 0a le = 1;.#endif..
f7f0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
f800: 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
f810: 43 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e CACHE) && !defin
f820: 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ed(SQLITE_OMIT_D
f830: 49 53 4b 49 4f 29 0a 20 20 2f 2a 0a 20 20 2a 2a ISKIO). /*. **
f840: 20 49 66 20 74 68 69 73 20 42 74 72 65 65 20 69 If this Btree i
f850: 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 66 6f s a candidate fo
f860: 72 20 73 68 61 72 65 64 20 63 61 63 68 65 2c 20 r shared cache,
f870: 74 72 79 20 74 6f 20 66 69 6e 64 20 61 6e 0a 20 try to find an.
f880: 20 2a 2a 20 65 78 69 73 74 69 6e 67 20 42 74 53 ** existing BtS
f890: 68 61 72 65 64 20 6f 62 6a 65 63 74 20 74 68 61 hared object tha
f8a0: 74 20 77 65 20 63 61 6e 20 73 68 61 72 65 20 77 t we can share w
f8b0: 69 74 68 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 ith. */. if( i
f8c0: 73 54 65 6d 70 44 62 3d 3d 30 20 26 26 20 28 69 sTempDb==0 && (i
f8d0: 73 4d 65 6d 64 62 3d 3d 30 20 7c 7c 20 28 76 66 sMemdb==0 || (vf
f8e0: 73 46 6c 61 67 73 26 53 51 4c 49 54 45 5f 4f 50 sFlags&SQLITE_OP
f8f0: 45 4e 5f 55 52 49 29 21 3d 30 29 20 29 7b 0a 20 EN_URI)!=0) ){.
f900: 20 20 20 69 66 28 20 76 66 73 46 6c 61 67 73 20 if( vfsFlags
f910: 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 & SQLITE_OPEN_SH
f920: 41 52 45 44 43 41 43 48 45 20 29 7b 0a 20 20 20 AREDCACHE ){.
f930: 20 20 20 69 6e 74 20 6e 46 75 6c 6c 50 61 74 68 int nFullPath
f940: 6e 61 6d 65 20 3d 20 70 56 66 73 2d 3e 6d 78 50 name = pVfs->mxP
f950: 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 20 20 20 athname+1;.
f960: 20 63 68 61 72 20 2a 7a 46 75 6c 6c 50 61 74 68 char *zFullPath
f970: 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 4d 61 name = sqlite3Ma
f980: 6c 6c 6f 63 28 6e 46 75 6c 6c 50 61 74 68 6e 61 lloc(nFullPathna
f990: 6d 65 29 3b 0a 20 20 20 20 20 20 4d 55 54 45 58 me);. MUTEX
f9a0: 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 5f _LOGIC( sqlite3_
f9b0: 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 61 72 mutex *mutexShar
f9c0: 65 64 3b 20 29 0a 20 20 20 20 20 20 70 2d 3e 73 ed; ). p->s
f9d0: 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 20 20 harable = 1;.
f9e0: 20 20 20 69 66 28 20 21 7a 46 75 6c 6c 50 61 74 if( !zFullPat
f9f0: 68 6e 61 6d 65 20 29 7b 0a 20 20 20 20 20 20 20 hname ){.
fa00: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 sqlite3_free(p)
fa10: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
fa20: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
fa30: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 }. if(
fa40: 20 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 isMemdb ){.
fa50: 20 20 20 20 6d 65 6d 63 70 79 28 7a 46 75 6c 6c memcpy(zFull
fa60: 50 61 74 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 6e Pathname, zFilen
fa70: 61 6d 65 2c 20 73 71 6c 69 74 65 33 53 74 72 6c ame, sqlite3Strl
fa80: 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 2b en30(zFilename)+
fa90: 31 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 1);. }else{
faa0: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
fab0: 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 68 6e lite3OsFullPathn
fac0: 61 6d 65 28 70 56 66 73 2c 20 7a 46 69 6c 65 6e ame(pVfs, zFilen
fad0: 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ame,.
fae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
faf0: 20 20 20 20 20 20 20 20 6e 46 75 6c 6c 50 61 74 nFullPat
fb00: 68 6e 61 6d 65 2c 20 7a 46 75 6c 6c 50 61 74 68 hname, zFullPath
fb10: 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 69 name);. i
fb20: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
fb30: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
fb40: 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a zFullPathname);.
fb50: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
fb60: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 3_free(p);.
fb70: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
fb80: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
fb90: 7d 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52 }.#if SQLITE_THR
fba0: 45 41 44 53 41 46 45 0a 20 20 20 20 20 20 6d 75 EADSAFE. mu
fbb0: 74 65 78 4f 70 65 6e 20 3d 20 73 71 6c 69 74 65 texOpen = sqlite
fbc0: 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 3MutexAlloc(SQLI
fbd0: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f TE_MUTEX_STATIC_
fbe0: 4f 50 45 4e 29 3b 0a 20 20 20 20 20 20 73 71 6c OPEN);. sql
fbf0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
fc00: 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 20 (mutexOpen);.
fc10: 20 20 20 6d 75 74 65 78 53 68 61 72 65 64 20 3d mutexShared =
fc20: 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c sqlite3MutexAll
fc30: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
fc40: 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 0a STATIC_MASTER);.
fc50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
fc60: 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 53 tex_enter(mutexS
fc70: 68 61 72 65 64 29 3b 0a 23 65 6e 64 69 66 0a 20 hared);.#endif.
fc80: 20 20 20 20 20 66 6f 72 28 70 42 74 3d 47 4c 4f for(pBt=GLO
fc90: 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 71 BAL(BtShared*,sq
fca0: 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 65 lite3SharedCache
fcb0: 4c 69 73 74 29 3b 20 70 42 74 3b 20 70 42 74 3d List); pBt; pBt=
fcc0: 70 42 74 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 pBt->pNext){.
fcd0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 assert( pBt
fce0: 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20 20 20 ->nRef>0 );.
fcf0: 20 20 20 20 69 66 28 20 30 3d 3d 73 74 72 63 6d if( 0==strcm
fd00: 70 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c p(zFullPathname,
fd10: 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 6c sqlite3PagerFil
fd20: 65 6e 61 6d 65 28 70 42 74 2d 3e 70 50 61 67 65 ename(pBt->pPage
fd30: 72 2c 20 30 29 29 0a 20 20 20 20 20 20 20 20 20 r, 0)).
fd40: 20 20 20 20 20 20 20 20 26 26 20 73 71 6c 69 74 && sqlit
fd50: 65 33 50 61 67 65 72 56 66 73 28 70 42 74 2d 3e e3PagerVfs(pBt->
fd60: 70 50 61 67 65 72 29 3d 3d 70 56 66 73 20 29 7b pPager)==pVfs ){
fd70: 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 . int i
fd80: 44 62 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f Db;. fo
fd90: 72 28 69 44 62 3d 64 62 2d 3e 6e 44 62 2d 31 3b r(iDb=db->nDb-1;
fda0: 20 69 44 62 3e 3d 30 3b 20 69 44 62 2d 2d 29 7b iDb>=0; iDb--){
fdb0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 42 74 72 . Btr
fdc0: 65 65 20 2a 70 45 78 69 73 74 69 6e 67 20 3d 20 ee *pExisting =
fdd0: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
fde0: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
fdf0: 28 20 70 45 78 69 73 74 69 6e 67 20 26 26 20 70 ( pExisting && p
fe00: 45 78 69 73 74 69 6e 67 2d 3e 70 42 74 3d 3d 70 Existing->pBt==p
fe10: 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 Bt ){.
fe20: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
fe30: 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 61 x_leave(mutexSha
fe40: 72 65 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 red);.
fe50: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
fe60: 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 4f 70 65 x_leave(mutexOpe
fe70: 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 n);.
fe80: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a sqlite3_free(z
fe90: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 FullPathname);.
fea0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c sql
feb0: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 ite3_free(p);.
fec0: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
fed0: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 rn SQLITE_CONSTR
fee0: 41 49 4e 54 3b 0a 20 20 20 20 20 20 20 20 20 20 AINT;.
fef0: 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a }. }.
ff00: 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 42 74 p->pBt
ff10: 20 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 20 20 = pBt;.
ff20: 20 20 70 42 74 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 pBt->nRef++;.
ff30: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
ff40: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
ff50: 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f }. sqlite3_
ff60: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 mutex_leave(mute
ff70: 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 20 20 xShared);.
ff80: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 75 sqlite3_free(zFu
ff90: 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 llPathname);.
ffa0: 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }.#ifdef SQLITE
ffb0: 5f 44 45 42 55 47 0a 20 20 20 20 65 6c 73 65 7b _DEBUG. else{
ffc0: 0a 20 20 20 20 20 20 2f 2a 20 49 6e 20 64 65 62 . /* In deb
ffd0: 75 67 20 6d 6f 64 65 2c 20 77 65 20 6d 61 72 6b ug mode, we mark
ffe0: 20 61 6c 6c 20 70 65 72 73 69 73 74 65 6e 74 20 all persistent
fff0: 64 61 74 61 62 61 73 65 73 20 61 73 20 73 68 61 databases as sha
10000 72 61 62 6c 65 0a 20 20 20 20 20 20 2a 2a 20 65 rable. ** e
10010 76 65 6e 20 77 68 65 6e 20 74 68 65 79 20 61 72 ven when they ar
10020 65 20 6e 6f 74 2e 20 20 54 68 69 73 20 65 78 65 e not. This exe
10030 72 63 69 73 65 73 20 74 68 65 20 6c 6f 63 6b 69 rcises the locki
10040 6e 67 20 63 6f 64 65 20 61 6e 64 0a 20 20 20 20 ng code and.
10050 20 20 2a 2a 20 67 69 76 65 73 20 6d 6f 72 65 20 ** gives more
10060 6f 70 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 20 opportunity for
10070 61 73 73 65 72 74 73 28 73 71 6c 69 74 65 33 5f asserts(sqlite3_
10080 6d 75 74 65 78 5f 68 65 6c 64 28 29 29 0a 20 20 mutex_held()).
10090 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 ** statement
100a0 73 20 74 6f 20 66 69 6e 64 20 6c 6f 63 6b 69 6e s to find lockin
100b0 67 20 70 72 6f 62 6c 65 6d 73 2e 0a 20 20 20 20 g problems..
100c0 20 20 2a 2f 0a 20 20 20 20 20 20 70 2d 3e 73 68 */. p->sh
100d0 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 20 20 20 arable = 1;.
100e0 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 23 65 6e }.#endif. }.#en
100f0 64 69 66 0a 20 20 69 66 28 20 70 42 74 3d 3d 30 dif. if( pBt==0
10100 20 29 7b 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a ){. /*. *
10110 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
10120 61 73 73 65 72 74 73 20 6d 61 6b 65 20 73 75 72 asserts make sur
10130 65 20 74 68 61 74 20 73 74 72 75 63 74 75 72 65 e that structure
10140 73 20 75 73 65 64 20 62 79 20 74 68 65 20 62 74 s used by the bt
10150 72 65 65 20 61 72 65 0a 20 20 20 20 2a 2a 20 74 ree are. ** t
10160 68 65 20 72 69 67 68 74 20 73 69 7a 65 2e 20 20 he right size.
10170 54 68 69 73 20 69 73 20 74 6f 20 67 75 61 72 64 This is to guard
10180 20 61 67 61 69 6e 73 74 20 73 69 7a 65 20 63 68 against size ch
10190 61 6e 67 65 73 20 74 68 61 74 20 72 65 73 75 6c anges that resul
101a0 74 0a 20 20 20 20 2a 2a 20 77 68 65 6e 20 63 6f t. ** when co
101b0 6d 70 69 6c 69 6e 67 20 6f 6e 20 61 20 64 69 66 mpiling on a dif
101c0 66 65 72 65 6e 74 20 61 72 63 68 69 74 65 63 74 ferent architect
101d0 75 72 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ure.. */.
101e0 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 69 assert( sizeof(i
101f0 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 6f 66 64)==8 || sizeof
10200 28 69 36 34 29 3d 3d 34 20 29 3b 0a 20 20 20 20 (i64)==4 );.
10210 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 assert( sizeof(u
10220 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 6f 66 64)==8 || sizeof
10230 28 75 36 34 29 3d 3d 34 20 29 3b 0a 20 20 20 20 (u64)==4 );.
10240 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 assert( sizeof(u
10250 33 32 29 3d 3d 34 20 29 3b 0a 20 20 20 20 61 73 32)==4 );. as
10260 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 31 36 sert( sizeof(u16
10270 29 3d 3d 32 20 29 3b 0a 20 20 20 20 61 73 73 65 )==2 );. asse
10280 72 74 28 20 73 69 7a 65 6f 66 28 50 67 6e 6f 29 rt( sizeof(Pgno)
10290 3d 3d 34 20 29 3b 0a 20 20 0a 20 20 20 20 70 42 ==4 );. . pB
102a0 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f t = sqlite3Mallo
102b0 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 2a 70 cZero( sizeof(*p
102c0 42 74 29 20 29 3b 0a 20 20 20 20 69 66 28 20 70 Bt) );. if( p
102d0 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 Bt==0 ){. r
102e0 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
102f0 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 ;. goto btr
10300 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
10310 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 }. rc = sqli
10320 74 65 33 50 61 67 65 72 4f 70 65 6e 28 70 56 66 te3PagerOpen(pVf
10330 73 2c 20 26 70 42 74 2d 3e 70 50 61 67 65 72 2c s, &pBt->pPager,
10340 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 zFilename,.
10350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10360 20 20 20 20 20 20 45 58 54 52 41 5f 53 49 5a 45 EXTRA_SIZE
10370 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 67 , flags, vfsFlag
10380 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b 0a s, pageReinit);.
10390 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
103a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 TE_OK ){. s
103b0 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d 6d qlite3PagerSetMm
103c0 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 61 apLimit(pBt->pPa
103d0 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 29 ger, db->szMmap)
103e0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
103f0 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 6c ite3PagerReadFil
10400 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 61 eheader(pBt->pPa
10410 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 65 ger,sizeof(zDbHe
10420 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 29 ader),zDbHeader)
10430 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
10440 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
10450 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 65 . goto btre
10460 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 e_open_out;.
10470 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e 46 }. pBt->openF
10480 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 73 lags = (u8)flags
10490 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d 20 ;. pBt->db =
104a0 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 db;. sqlite3P
104b0 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 64 6c agerSetBusyhandl
104c0 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 er(pBt->pPager,
104d0 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 btreeInvokeBusyH
104e0 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 20 andler, pBt);.
104f0 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a p->pBt = pBt;.
10500 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 72 . pBt->pCur
10510 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 sor = 0;. pBt
10520 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 ->pPage1 = 0;.
10530 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 if( sqlite3Pag
10540 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 74 erIsreadonly(pBt
10550 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 2d ->pPager) ) pBt-
10560 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
10570 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 64 _READ_ONLY;.#ifd
10580 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 52 45 ef SQLITE_SECURE
10590 5f 44 45 4c 45 54 45 0a 20 20 20 20 70 42 74 2d _DELETE. pBt-
105a0 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
105b0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a _SECURE_DELETE;.
105c0 23 65 6e 64 69 66 0a 20 20 20 20 70 42 74 2d 3e #endif. pBt->
105d0 70 61 67 65 53 69 7a 65 20 3d 20 28 7a 44 62 48 pageSize = (zDbH
105e0 65 61 64 65 72 5b 31 36 5d 3c 3c 38 29 20 7c 20 eader[16]<<8) |
105f0 28 7a 44 62 48 65 61 64 65 72 5b 31 37 5d 3c 3c (zDbHeader[17]<<
10600 31 36 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 16);. if( pBt
10610 2d 3e 70 61 67 65 53 69 7a 65 3c 35 31 32 20 7c ->pageSize<512 |
10620 7c 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e | pBt->pageSize>
10630 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f SQLITE_MAX_PAGE_
10640 53 49 5a 45 0a 20 20 20 20 20 20 20 20 20 7c 7c SIZE. ||
10650 20 28 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 ((pBt->pageSize
10660 2d 31 29 26 70 42 74 2d 3e 70 61 67 65 53 69 7a -1)&pBt->pageSiz
10670 65 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 e)!=0 ){. p
10680 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 30 Bt->pageSize = 0
10690 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
106a0 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
106b0 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 . /* If the
106c0 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 magic name ":me
106d0 6d 6f 72 79 3a 22 20 77 69 6c 6c 20 63 72 65 61 mory:" will crea
106e0 74 65 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 te an in-memory
106f0 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 20 database, then.
10700 20 20 20 20 20 2a 2a 20 6c 65 61 76 65 20 74 68 ** leave th
10710 65 20 61 75 74 6f 56 61 63 75 75 6d 20 6d 6f 64 e autoVacuum mod
10720 65 20 61 74 20 30 20 28 64 6f 20 6e 6f 74 20 61 e at 0 (do not a
10730 75 74 6f 2d 76 61 63 75 75 6d 29 2c 20 65 76 65 uto-vacuum), eve
10740 6e 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 53 51 n if. ** SQ
10750 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 LITE_DEFAULT_AUT
10760 4f 56 41 43 55 55 4d 20 69 73 20 74 72 75 65 2e OVACUUM is true.
10770 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 On the other ha
10780 6e 64 2c 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 nd, if. **
10790 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f SQLITE_OMIT_MEMO
107a0 52 59 44 42 20 68 61 73 20 62 65 65 6e 20 64 65 RYDB has been de
107b0 66 69 6e 65 64 2c 20 74 68 65 6e 20 22 3a 6d 65 fined, then ":me
107c0 6d 6f 72 79 3a 22 20 69 73 20 6a 75 73 74 20 61 mory:" is just a
107d0 0a 20 20 20 20 20 20 2a 2a 20 72 65 67 75 6c 61 . ** regula
107e0 72 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 49 6e 20 r file-name. In
107f0 74 68 69 73 20 63 61 73 65 20 74 68 65 20 61 75 this case the au
10800 74 6f 2d 76 61 63 75 75 6d 20 61 70 70 6c 69 65 to-vacuum applie
10810 73 20 61 73 20 70 65 72 20 6e 6f 72 6d 61 6c 2e s as per normal.
10820 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
10830 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 26 26 if( zFilename &&
10840 20 21 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 !isMemdb ){.
10850 20 20 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 pBt->autoVa
10860 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 cuum = (SQLITE_D
10870 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 EFAULT_AUTOVACUU
10880 4d 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20 M ? 1 : 0);.
10890 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 pBt->incrVac
108a0 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 45 uum = (SQLITE_DE
108b0 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d FAULT_AUTOVACUUM
108c0 3d 3d 32 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 ==2 ? 1 : 0);.
108d0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
108e0 20 20 20 6e 52 65 73 65 72 76 65 20 3d 20 30 3b nReserve = 0;
108f0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
10900 20 20 6e 52 65 73 65 72 76 65 20 3d 20 7a 44 62 nReserve = zDb
10910 48 65 61 64 65 72 5b 32 30 5d 3b 0a 20 20 20 20 Header[20];.
10920 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
10930 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f |= BTS_PAGESIZE_
10940 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 20 53 FIXED;.#ifndef S
10950 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
10960 41 43 55 55 4d 0a 20 20 20 20 20 20 70 42 74 2d ACUUM. pBt-
10970 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 >autoVacuum = (g
10980 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 61 64 et4byte(&zDbHead
10990 65 72 5b 33 36 20 2b 20 34 2a 34 5d 29 3f 31 3a er[36 + 4*4])?1:
109a0 30 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 0);. pBt->i
109b0 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 74 ncrVacuum = (get
109c0 34 62 79 74 65 28 26 7a 44 62 48 65 61 64 65 72 4byte(&zDbHeader
109d0 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 [36 + 7*4])?1:0)
109e0 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 ;.#endif. }.
109f0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
10a00 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 agerSetPagesize(
10a10 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 pBt->pPager, &pB
10a20 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e 52 65 t->pageSize, nRe
10a30 73 65 72 76 65 29 3b 0a 20 20 20 20 69 66 28 20 serve);. if(
10a40 72 63 20 29 20 67 6f 74 6f 20 62 74 72 65 65 5f rc ) goto btree_
10a50 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 70 42 open_out;. pB
10a60 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 t->usableSize =
10a70 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 pBt->pageSize -
10a80 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 nReserve;. as
10a90 73 65 72 74 28 20 28 70 42 74 2d 3e 70 61 67 65 sert( (pBt->page
10aa0 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 20 Size & 7)==0 );
10ab0 20 2f 2a 20 38 2d 62 79 74 65 20 61 6c 69 67 6e /* 8-byte align
10ac0 6d 65 6e 74 20 6f 66 20 70 61 67 65 53 69 7a 65 ment of pageSize
10ad0 20 2a 2f 0a 20 20 20 0a 23 69 66 20 21 64 65 66 */. .#if !def
10ae0 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
10af0 5f 53 48 41 52 45 44 5f 43 41 43 48 45 29 20 26 _SHARED_CACHE) &
10b00 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 & !defined(SQLIT
10b10 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 E_OMIT_DISKIO).
10b20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 6e 65 /* Add the ne
10b30 77 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 w BtShared objec
10b40 74 20 74 6f 20 74 68 65 20 6c 69 6e 6b 65 64 20 t to the linked
10b50 6c 69 73 74 20 73 68 61 72 61 62 6c 65 20 42 74 list sharable Bt
10b60 53 68 61 72 65 64 73 2e 0a 20 20 20 20 2a 2f 0a Shareds.. */.
10b70 20 20 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 if( p->shara
10b80 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 4d 55 54 ble ){. MUT
10b90 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 EX_LOGIC( sqlite
10ba0 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 3_mutex *mutexSh
10bb0 61 72 65 64 3b 20 29 0a 20 20 20 20 20 20 70 42 ared; ). pB
10bc0 74 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 t->nRef = 1;.
10bd0 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
10be0 6d 75 74 65 78 53 68 61 72 65 64 20 3d 20 73 71 mutexShared = sq
10bf0 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 lite3MutexAlloc(
10c00 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 SQLITE_MUTEX_STA
10c10 54 49 43 5f 4d 41 53 54 45 52 29 3b 29 0a 20 20 TIC_MASTER);).
10c20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 54 if( SQLITE_T
10c30 48 52 45 41 44 53 41 46 45 20 26 26 20 73 71 6c HREADSAFE && sql
10c40 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
10c50 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 .bCoreMutex ){.
10c60 20 20 20 20 20 20 20 70 42 74 2d 3e 6d 75 74 65 pBt->mute
10c70 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 x = sqlite3Mutex
10c80 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 Alloc(SQLITE_MUT
10c90 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 20 20 EX_FAST);.
10ca0 20 20 69 66 28 20 70 42 74 2d 3e 6d 75 74 65 78 if( pBt->mutex
10cb0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
10cc0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
10cd0 45 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 64 62 EM;. db
10ce0 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d ->mallocFailed =
10cf0 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 0;. go
10d00 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 to btree_open_ou
10d10 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 t;. }.
10d20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 }. sqlit
10d30 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d e3_mutex_enter(m
10d40 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 utexShared);.
10d50 20 20 20 70 42 74 2d 3e 70 4e 65 78 74 20 3d 20 pBt->pNext =
10d60 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a GLOBAL(BtShared*
10d70 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 ,sqlite3SharedCa
10d80 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 cheList);.
10d90 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a GLOBAL(BtShared*
10da0 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 ,sqlite3SharedCa
10db0 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 3b 0a cheList) = pBt;.
10dc0 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
10dd0 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 tex_leave(mutexS
10de0 68 61 72 65 64 29 3b 0a 20 20 20 20 7d 0a 23 65 hared);. }.#e
10df0 6e 64 69 66 0a 20 20 7d 0a 0a 23 69 66 20 21 64 ndif. }..#if !d
10e00 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
10e10 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 29 IT_SHARED_CACHE)
10e20 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c && !defined(SQL
10e30 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 ITE_OMIT_DISKIO)
10e40 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 6e 65 77 . /* If the new
10e50 20 42 74 72 65 65 20 75 73 65 73 20 61 20 73 68 Btree uses a sh
10e60 61 72 61 62 6c 65 20 70 42 74 53 68 61 72 65 64 arable pBtShared
10e70 2c 20 74 68 65 6e 20 6c 69 6e 6b 20 74 68 65 20 , then link the
10e80 6e 65 77 0a 20 20 2a 2a 20 42 74 72 65 65 20 69 new. ** Btree i
10e90 6e 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 20 nto the list of
10ea0 61 6c 6c 20 73 68 61 72 61 62 6c 65 20 42 74 72 all sharable Btr
10eb0 65 65 73 20 66 6f 72 20 74 68 65 20 73 61 6d 65 ees for the same
10ec0 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 20 20 2a connection.. *
10ed0 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 6b 65 * The list is ke
10ee0 70 74 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 pt in ascending
10ef0 6f 72 64 65 72 20 62 79 20 70 42 74 20 61 64 64 order by pBt add
10f00 72 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 ress.. */. if(
10f10 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a p->sharable ){.
10f20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 42 int i;. B
10f30 74 72 65 65 20 2a 70 53 69 62 3b 0a 20 20 20 20 tree *pSib;.
10f40 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e for(i=0; i<db->n
10f50 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 Db; i++){.
10f60 69 66 28 20 28 70 53 69 62 20 3d 20 64 62 2d 3e if( (pSib = db->
10f70 61 44 62 5b 69 5d 2e 70 42 74 29 21 3d 30 20 26 aDb[i].pBt)!=0 &
10f80 26 20 70 53 69 62 2d 3e 73 68 61 72 61 62 6c 65 & pSib->sharable
10f90 20 29 7b 0a 20 20 20 20 20 20 20 20 77 68 69 6c ){. whil
10fa0 65 28 20 70 53 69 62 2d 3e 70 50 72 65 76 20 29 e( pSib->pPrev )
10fb0 7b 20 70 53 69 62 20 3d 20 70 53 69 62 2d 3e 70 { pSib = pSib->p
10fc0 50 72 65 76 3b 20 7d 0a 20 20 20 20 20 20 20 20 Prev; }.
10fd0 69 66 28 20 70 2d 3e 70 42 74 3c 70 53 69 62 2d if( p->pBt<pSib-
10fe0 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 >pBt ){.
10ff0 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 53 69 p->pNext = pSi
11000 62 3b 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e b;. p->
11010 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 20 20 pPrev = 0;.
11020 20 20 20 20 20 70 53 69 62 2d 3e 70 50 72 65 76 pSib->pPrev
11030 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 7d 65 = p;. }e
11040 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 77 lse{. w
11050 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 4e 65 78 hile( pSib->pNex
11060 74 20 26 26 20 70 53 69 62 2d 3e 70 4e 65 78 74 t && pSib->pNext
11070 2d 3e 70 42 74 3c 70 2d 3e 70 42 74 20 29 7b 0a ->pBt<p->pBt ){.
11080 20 20 20 20 20 20 20 20 20 20 20 20 70 53 69 62 pSib
11090 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a = pSib->pNext;.
110a0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
110b0 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d p->pNext =
110c0 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 20 pSib->pNext;.
110d0 20 20 20 20 20 20 20 20 70 2d 3e 70 50 72 65 76 p->pPrev
110e0 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 = pSib;.
110f0 20 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 if( p->pNext
11100 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 ){. p
11110 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d ->pNext->pPrev =
11120 20 70 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a p;. }.
11130 20 20 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e pSib->
11140 70 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 20 20 pNext = p;.
11150 20 20 20 7d 0a 20 20 20 20 20 20 20 20 62 72 65 }. bre
11160 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ak;. }.
11170 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 2a }. }.#endif. *
11180 70 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a 62 74 ppBtree = p;..bt
11190 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a 20 20 ree_open_out:.
111a0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
111b0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 42 74 K ){. if( pBt
111c0 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 72 20 && pBt->pPager
111d0 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
111e0 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e PagerClose(pBt->
111f0 70 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 pPager);. }.
11200 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
11210 70 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 pBt);. sqlite
11220 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 2a 3_free(p);. *
11230 70 70 42 74 72 65 65 20 3d 20 30 3b 0a 20 20 7d ppBtree = 0;. }
11240 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 else{. /* If
11250 74 68 65 20 42 2d 54 72 65 65 20 77 61 73 20 73 the B-Tree was s
11260 75 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 65 6e uccessfully open
11270 65 64 2c 20 73 65 74 20 74 68 65 20 70 61 67 65 ed, set the page
11280 72 2d 63 61 63 68 65 20 73 69 7a 65 20 74 6f 20 r-cache size to
11290 74 68 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 the. ** defau
112a0 6c 74 20 76 61 6c 75 65 2e 20 45 78 63 65 70 74 lt value. Except
112b0 2c 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 6f , when opening o
112c0 6e 20 61 6e 20 65 78 69 73 74 69 6e 67 20 73 68 n an existing sh
112d0 61 72 65 64 20 70 61 67 65 72 2d 63 61 63 68 65 ared pager-cache
112e0 2c 0a 20 20 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 ,. ** do not
112f0 63 68 61 6e 67 65 20 74 68 65 20 70 61 67 65 72 change the pager
11300 2d 63 61 63 68 65 20 73 69 7a 65 2e 0a 20 20 20 -cache size..
11310 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 6c 69 */. if( sqli
11320 74 65 33 42 74 72 65 65 53 63 68 65 6d 61 28 70 te3BtreeSchema(p
11330 2c 20 30 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 , 0, 0)==0 ){.
11340 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 sqlite3Pager
11350 53 65 74 43 61 63 68 65 73 69 7a 65 28 70 2d 3e SetCachesize(p->
11360 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 51 4c pBt->pPager, SQL
11370 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 ITE_DEFAULT_CACH
11380 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 20 E_SIZE);. }.
11390 20 7d 0a 20 20 69 66 28 20 6d 75 74 65 78 4f 70 }. if( mutexOp
113a0 65 6e 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 en ){. assert
113b0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
113c0 68 65 6c 64 28 6d 75 74 65 78 4f 70 65 6e 29 20 held(mutexOpen)
113d0 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
113e0 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 utex_leave(mutex
113f0 4f 70 65 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 Open);. }. ret
11400 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
11410 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 42 Decrement the B
11420 74 53 68 61 72 65 64 2e 6e 52 65 66 20 63 6f 75 tShared.nRef cou
11430 6e 74 65 72 2e 20 20 57 68 65 6e 20 69 74 20 72 nter. When it r
11440 65 61 63 68 65 73 20 7a 65 72 6f 2c 0a 2a 2a 20 eaches zero,.**
11450 72 65 6d 6f 76 65 20 74 68 65 20 42 74 53 68 61 remove the BtSha
11460 72 65 64 20 73 74 72 75 63 74 75 72 65 20 66 72 red structure fr
11470 6f 6d 20 74 68 65 20 73 68 61 72 69 6e 67 20 6c om the sharing l
11480 69 73 74 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 ist. Return.**
11490 74 72 75 65 20 69 66 20 74 68 65 20 42 74 53 68 true if the BtSh
114a0 61 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e 74 65 ared.nRef counte
114b0 72 20 72 65 61 63 68 65 73 20 7a 65 72 6f 20 61 r reaches zero a
114c0 6e 64 20 72 65 74 75 72 6e 0a 2a 2a 20 66 61 6c nd return.** fal
114d0 73 65 20 69 66 20 69 74 20 69 73 20 73 74 69 6c se if it is stil
114e0 6c 20 70 6f 73 69 74 69 76 65 2e 0a 2a 2f 0a 73 l positive..*/.s
114f0 74 61 74 69 63 20 69 6e 74 20 72 65 6d 6f 76 65 tatic int remove
11500 46 72 6f 6d 53 68 61 72 69 6e 67 4c 69 73 74 28 FromSharingList(
11510 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
11520 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
11530 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
11540 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 . MUTEX_LOGIC(
11550 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 sqlite3_mutex *p
11560 4d 61 73 74 65 72 3b 20 29 0a 20 20 42 74 53 68 Master; ). BtSh
11570 61 72 65 64 20 2a 70 4c 69 73 74 3b 0a 20 20 69 ared *pList;. i
11580 6e 74 20 72 65 6d 6f 76 65 64 20 3d 20 30 3b 0a nt removed = 0;.
11590 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
115a0 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 e3_mutex_notheld
115b0 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
115c0 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 70 MUTEX_LOGIC( p
115d0 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65 33 Master = sqlite3
115e0 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
115f0 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d E_MUTEX_STATIC_M
11600 41 53 54 45 52 29 3b 20 29 0a 20 20 73 71 6c 69 ASTER); ). sqli
11610 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
11620 70 4d 61 73 74 65 72 29 3b 0a 20 20 70 42 74 2d pMaster);. pBt-
11630 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 >nRef--;. if( p
11640 42 74 2d 3e 6e 52 65 66 3c 3d 30 20 29 7b 0a 20 Bt->nRef<=0 ){.
11650 20 20 20 69 66 28 20 47 4c 4f 42 41 4c 28 42 74 if( GLOBAL(Bt
11660 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
11670 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3d haredCacheList)=
11680 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 20 47 4c =pBt ){. GL
11690 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 OBAL(BtShared*,s
116a0 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 qlite3SharedCach
116b0 65 4c 69 73 74 29 20 3d 20 70 42 74 2d 3e 70 4e eList) = pBt->pN
116c0 65 78 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a ext;. }else{.
116d0 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 47 4c pList = GL
116e0 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 OBAL(BtShared*,s
116f0 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 qlite3SharedCach
11700 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 77 68 eList);. wh
11710 69 6c 65 28 20 41 4c 57 41 59 53 28 70 4c 69 73 ile( ALWAYS(pLis
11720 74 29 20 26 26 20 70 4c 69 73 74 2d 3e 70 4e 65 t) && pList->pNe
11730 78 74 21 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 xt!=pBt ){.
11740 20 20 20 70 4c 69 73 74 3d 70 4c 69 73 74 2d 3e pList=pList->
11750 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 pNext;. }.
11760 20 20 20 20 20 69 66 28 20 41 4c 57 41 59 53 28 if( ALWAYS(
11770 70 4c 69 73 74 29 20 29 7b 0a 20 20 20 20 20 20 pList) ){.
11780 20 20 70 4c 69 73 74 2d 3e 70 4e 65 78 74 20 3d pList->pNext =
11790 20 70 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 pBt->pNext;.
117a0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 }. }. i
117b0 66 28 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 f( SQLITE_THREAD
117c0 53 41 46 45 20 29 7b 0a 20 20 20 20 20 20 73 71 SAFE ){. sq
117d0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 lite3_mutex_free
117e0 28 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 (pBt->mutex);.
117f0 20 20 7d 0a 20 20 20 20 72 65 6d 6f 76 65 64 20 }. removed
11800 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 = 1;. }. sqlit
11810 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 e3_mutex_leave(p
11820 4d 61 73 74 65 72 29 3b 0a 20 20 72 65 74 75 72 Master);. retur
11830 6e 20 72 65 6d 6f 76 65 64 3b 0a 23 65 6c 73 65 n removed;.#else
11840 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e . return 1;.#en
11850 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b dif.}../*.** Mak
11860 65 20 73 75 72 65 20 70 42 74 2d 3e 70 54 6d 70 e sure pBt->pTmp
11870 53 70 61 63 65 20 70 6f 69 6e 74 73 20 74 6f 20 Space points to
11880 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 an allocation of
11890 20 0a 2a 2a 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a .** MX_CELL_SIZ
118a0 45 28 70 42 74 29 20 62 79 74 65 73 2e 0a 2a 2f E(pBt) bytes..*/
118b0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61 6c 6c .static void all
118c0 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 42 ocateTempSpace(B
118d0 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
118e0 20 69 66 28 20 21 70 42 74 2d 3e 70 54 6d 70 53 if( !pBt->pTmpS
118f0 70 61 63 65 20 29 7b 0a 20 20 20 20 70 42 74 2d pace ){. pBt-
11900 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 73 71 6c >pTmpSpace = sql
11910 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 20 ite3PageMalloc(
11920 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b pBt->pageSize );
11930 0a 0a 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 .. /* One of
11940 74 68 65 20 75 73 65 73 20 6f 66 20 70 42 74 2d the uses of pBt-
11950 3e 70 54 6d 70 53 70 61 63 65 20 69 73 20 74 6f >pTmpSpace is to
11960 20 66 6f 72 6d 61 74 20 63 65 6c 6c 73 20 62 65 format cells be
11970 66 6f 72 65 0a 20 20 20 20 2a 2a 20 69 6e 73 65 fore. ** inse
11980 72 74 69 6e 67 20 74 68 65 6d 20 69 6e 74 6f 20 rting them into
11990 61 20 6c 65 61 66 20 70 61 67 65 20 28 66 75 6e a leaf page (fun
119a0 63 74 69 6f 6e 20 66 69 6c 6c 49 6e 43 65 6c 6c ction fillInCell
119b0 28 29 29 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 ()). If. ** a
119c0 20 63 65 6c 6c 20 69 73 20 6c 65 73 73 20 74 68 cell is less th
119d0 61 6e 20 34 20 62 79 74 65 73 20 69 6e 20 73 69 an 4 bytes in si
119e0 7a 65 2c 20 69 74 20 69 73 20 72 6f 75 6e 64 65 ze, it is rounde
119f0 64 20 75 70 20 74 6f 20 34 20 62 79 74 65 73 0a d up to 4 bytes.
11a00 20 20 20 20 2a 2a 20 62 79 20 74 68 65 20 76 61 ** by the va
11a10 72 69 6f 75 73 20 72 6f 75 74 69 6e 65 73 20 74 rious routines t
11a20 68 61 74 20 6d 61 6e 69 70 75 6c 61 74 65 20 62 hat manipulate b
11a30 69 6e 61 72 79 20 63 65 6c 6c 73 2e 20 57 68 69 inary cells. Whi
11a40 63 68 0a 20 20 20 20 2a 2a 20 63 61 6e 20 6d 65 ch. ** can me
11a50 61 6e 20 74 68 61 74 20 66 69 6c 6c 49 6e 43 65 an that fillInCe
11a60 6c 6c 28 29 20 6f 6e 6c 79 20 69 6e 69 74 69 61 ll() only initia
11a70 6c 69 7a 65 73 20 74 68 65 20 66 69 72 73 74 20 lizes the first
11a80 32 20 6f 72 20 33 0a 20 20 20 20 2a 2a 20 62 79 2 or 3. ** by
11a90 74 65 73 20 6f 66 20 70 54 6d 70 53 70 61 63 65 tes of pTmpSpace
11aa0 2c 20 62 75 74 20 74 68 61 74 20 74 68 65 20 66 , but that the f
11ab0 69 72 73 74 20 34 20 62 79 74 65 73 20 61 72 65 irst 4 bytes are
11ac0 20 63 6f 70 69 65 64 20 66 72 6f 6d 0a 20 20 20 copied from.
11ad0 20 2a 2a 20 69 74 20 69 6e 74 6f 20 61 20 64 61 ** it into a da
11ae0 74 61 62 61 73 65 20 70 61 67 65 2e 20 54 68 69 tabase page. Thi
11af0 73 20 69 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c s is not actuall
11b00 79 20 61 20 70 72 6f 62 6c 65 6d 2c 20 62 75 74 y a problem, but
11b10 20 69 74 0a 20 20 20 20 2a 2a 20 64 6f 65 73 20 it. ** does
11b20 63 61 75 73 65 20 61 20 76 61 6c 67 72 69 6e 64 cause a valgrind
11b30 20 65 72 72 6f 72 20 77 68 65 6e 20 74 68 65 20 error when the
11b40 31 20 6f 72 20 32 20 62 79 74 65 73 20 6f 66 20 1 or 2 bytes of
11b50 75 6e 69 74 69 61 6c 69 7a 65 64 20 0a 20 20 20 unitialized .
11b60 20 2a 2a 20 64 61 74 61 20 69 73 20 70 61 73 73 ** data is pass
11b70 65 64 20 74 6f 20 73 79 73 74 65 6d 20 63 61 6c ed to system cal
11b80 6c 20 77 72 69 74 65 28 29 2e 20 53 6f 20 74 6f l write(). So to
11b90 20 61 76 6f 69 64 20 74 68 69 73 20 65 72 72 6f avoid this erro
11ba0 72 2c 0a 20 20 20 20 2a 2a 20 7a 65 72 6f 20 74 r,. ** zero t
11bb0 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 he first 4 bytes
11bc0 20 6f 66 20 74 65 6d 70 20 73 70 61 63 65 20 68 of temp space h
11bd0 65 72 65 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28 ere. */. if(
11be0 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
11bf0 29 20 6d 65 6d 73 65 74 28 70 42 74 2d 3e 70 54 ) memset(pBt->pT
11c00 6d 70 53 70 61 63 65 2c 20 30 2c 20 34 29 3b 0a mpSpace, 0, 4);.
11c10 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 }.}../*.** Fre
11c20 65 20 74 68 65 20 70 42 74 2d 3e 70 54 6d 70 53 e the pBt->pTmpS
11c30 70 61 63 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a pace allocation.
11c40 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 */.static void f
11c50 72 65 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 reeTempSpace(BtS
11c60 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 73 hared *pBt){. s
11c70 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 20 qlite3PageFree(
11c80 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 29 3b pBt->pTmpSpace);
11c90 0a 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 . pBt->pTmpSpac
11ca0 65 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 e = 0;.}../*.**
11cb0 43 6c 6f 73 65 20 61 6e 20 6f 70 65 6e 20 64 61 Close an open da
11cc0 74 61 62 61 73 65 20 61 6e 64 20 69 6e 76 61 6c tabase and inval
11cd0 69 64 61 74 65 20 61 6c 6c 20 63 75 72 73 6f 72 idate all cursor
11ce0 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
11cf0 33 42 74 72 65 65 43 6c 6f 73 65 28 42 74 72 65 3BtreeClose(Btre
11d00 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
11d10 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
11d20 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
11d30 72 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 r;.. /* Close a
11d40 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 ll cursors opene
11d50 64 20 76 69 61 20 74 68 69 73 20 68 61 6e 64 6c d via this handl
11d60 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 e. */. assert(
11d70 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
11d80 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
11d90 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ) );. sqlite3Bt
11da0 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
11db0 43 75 72 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 Cur = pBt->pCurs
11dc0 6f 72 3b 0a 20 20 77 68 69 6c 65 28 20 70 43 75 or;. while( pCu
11dd0 72 20 29 7b 0a 20 20 20 20 42 74 43 75 72 73 6f r ){. BtCurso
11de0 72 20 2a 70 54 6d 70 20 3d 20 70 43 75 72 3b 0a r *pTmp = pCur;.
11df0 20 20 20 20 70 43 75 72 20 3d 20 70 43 75 72 2d pCur = pCur-
11e00 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 66 28 20 >pNext;. if(
11e10 70 54 6d 70 2d 3e 70 42 74 72 65 65 3d 3d 70 20 pTmp->pBtree==p
11e20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
11e30 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 BtreeCloseCursor
11e40 28 70 54 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20 (pTmp);. }.
11e50 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b }.. /* Rollback
11e60 20 61 6e 79 20 61 63 74 69 76 65 20 74 72 61 6e any active tran
11e70 73 61 63 74 69 6f 6e 20 61 6e 64 20 66 72 65 65 saction and free
11e80 20 74 68 65 20 68 61 6e 64 6c 65 20 73 74 72 75 the handle stru
11e90 63 74 75 72 65 2e 0a 20 20 2a 2a 20 54 68 65 20 cture.. ** The
11ea0 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 call to sqlite3B
11eb0 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 20 64 treeRollback() d
11ec0 72 6f 70 73 20 61 6e 79 20 74 61 62 6c 65 2d 6c rops any table-l
11ed0 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a 20 20 2a ocks held by. *
11ee0 2a 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 0a 20 * this handle..
11ef0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 */. sqlite3Btr
11f00 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c 20 53 51 eeRollback(p, SQ
11f10 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 73 71 6c 69 LITE_OK);. sqli
11f20 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
11f30 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 ;.. /* If there
11f40 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 68 65 72 are still other
11f50 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 outstanding ref
11f60 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 73 erences to the s
11f70 68 61 72 65 64 2d 62 74 72 65 65 0a 20 20 2a 2a hared-btree. **
11f80 20 73 74 72 75 63 74 75 72 65 2c 20 72 65 74 75 structure, retu
11f90 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 65 6d 61 rn now. The rema
11fa0 69 6e 64 65 72 20 6f 66 20 74 68 69 73 20 70 72 inder of this pr
11fb0 6f 63 65 64 75 72 65 20 63 6c 65 61 6e 73 20 0a ocedure cleans .
11fc0 20 20 2a 2a 20 75 70 20 74 68 65 20 73 68 61 72 ** up the shar
11fd0 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a 2f 0a 20 ed-btree.. */.
11fe0 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e 74 assert( p->want
11ff0 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 70 2d 3e ToLock==0 && p->
12000 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 69 locked==0 );. i
12010 66 28 20 21 70 2d 3e 73 68 61 72 61 62 6c 65 20 f( !p->sharable
12020 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 || removeFromSha
12030 72 69 6e 67 4c 69 73 74 28 70 42 74 29 20 29 7b ringList(pBt) ){
12040 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 42 74 20 . /* The pBt
12050 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6f 6e 20 is no longer on
12060 74 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 the sharing list
12070 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 63 63 65 , so we can acce
12080 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 77 69 74 ss. ** it wit
12090 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 68 hout having to h
120a0 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 2e 0a 20 old the mutex..
120b0 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 6c 65 **. ** Cle
120c0 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 6c 65 74 an out and delet
120d0 65 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6f e the BtShared o
120e0 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 bject.. */.
120f0 20 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e assert( !pBt->
12100 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 20 73 pCursor );. s
12110 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 qlite3PagerClose
12120 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 (pBt->pPager);.
12130 20 20 20 69 66 28 20 70 42 74 2d 3e 78 46 72 65 if( pBt->xFre
12140 65 53 63 68 65 6d 61 20 26 26 20 70 42 74 2d 3e eSchema && pBt->
12150 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 20 pSchema ){.
12160 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 6d pBt->xFreeSchem
12170 61 28 70 42 74 2d 3e 70 53 63 68 65 6d 61 29 3b a(pBt->pSchema);
12180 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
12190 65 33 44 62 46 72 65 65 28 30 2c 20 70 42 74 2d e3DbFree(0, pBt-
121a0 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 66 >pSchema);. f
121b0 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 reeTempSpace(pBt
121c0 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 );. sqlite3_f
121d0 72 65 65 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 23 ree(pBt);. }..#
121e0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
121f0 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
12200 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e assert( p->wan
12210 74 54 6f 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20 20 tToLock==0 );.
12220 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b 65 assert( p->locke
12230 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 2d d==0 );. if( p-
12240 3e 70 50 72 65 76 20 29 20 70 2d 3e 70 50 72 65 >pPrev ) p->pPre
12250 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e v->pNext = p->pN
12260 65 78 74 3b 0a 20 20 69 66 28 20 70 2d 3e 70 4e ext;. if( p->pN
12270 65 78 74 20 29 20 70 2d 3e 70 4e 65 78 74 2d 3e ext ) p->pNext->
12280 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65 76 pPrev = p->pPrev
12290 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 ;.#endif.. sqli
122a0 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 72 te3_free(p);. r
122b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
122c0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 .}../*.** Change
122d0 20 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 68 the limit on th
122e0 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 e number of page
122f0 73 20 61 6c 6c 6f 77 65 64 20 69 6e 20 74 68 65 s allowed in the
12300 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 cache..**.** Th
12310 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 e maximum number
12320 20 6f 66 20 63 61 63 68 65 20 70 61 67 65 73 20 of cache pages
12330 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 61 62 is set to the ab
12340 73 6f 6c 75 74 65 0a 2a 2a 20 76 61 6c 75 65 20 solute.** value
12350 6f 66 20 6d 78 50 61 67 65 2e 20 20 49 66 20 6d of mxPage. If m
12360 78 50 61 67 65 20 69 73 20 6e 65 67 61 74 69 76 xPage is negativ
12370 65 2c 20 74 68 65 20 70 61 67 65 72 20 77 69 6c e, the pager wil
12380 6c 0a 2a 2a 20 6f 70 65 72 61 74 65 20 61 73 79 l.** operate asy
12390 6e 63 68 72 6f 6e 6f 75 73 6c 79 20 2d 20 69 74 nchronously - it
123a0 20 77 69 6c 6c 20 6e 6f 74 20 73 74 6f 70 20 74 will not stop t
123b0 6f 20 64 6f 20 66 73 79 6e 63 28 29 73 0a 2a 2a o do fsync()s.**
123c0 20 74 6f 20 69 6e 73 75 72 65 20 64 61 74 61 20 to insure data
123d0 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 is written to th
123e0 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 20 62 e disk surface b
123f0 65 66 6f 72 65 0a 2a 2a 20 63 6f 6e 74 69 6e 75 efore.** continu
12400 69 6e 67 2e 20 20 54 72 61 6e 73 61 63 74 69 6f ing. Transactio
12410 6e 73 20 73 74 69 6c 6c 20 77 6f 72 6b 20 69 66 ns still work if
12420 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 69 73 20 synchronous is
12430 6f 66 66 2c 0a 2a 2a 20 61 6e 64 20 74 68 65 20 off,.** and the
12440 64 61 74 61 62 61 73 65 20 63 61 6e 6e 6f 74 20 database cannot
12450 62 65 20 63 6f 72 72 75 70 74 65 64 20 69 66 20 be corrupted if
12460 74 68 69 73 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 this program.**
12470 63 72 61 73 68 65 73 2e 20 20 42 75 74 20 69 66 crashes. But if
12480 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 the operating s
12490 79 73 74 65 6d 20 63 72 61 73 68 65 73 20 6f 72 ystem crashes or
124a0 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6e 20 there is.** an
124b0 61 62 72 75 70 74 20 70 6f 77 65 72 20 66 61 69 abrupt power fai
124c0 6c 75 72 65 20 77 68 65 6e 20 73 79 6e 63 68 72 lure when synchr
124d0 6f 6e 6f 75 73 20 69 73 20 6f 66 66 2c 20 74 68 onous is off, th
124e0 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f e database.** co
124f0 75 6c 64 20 62 65 20 6c 65 66 74 20 69 6e 20 61 uld be left in a
12500 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 61 n inconsistent a
12510 6e 64 20 75 6e 72 65 63 6f 76 65 72 61 62 6c 65 nd unrecoverable
12520 20 73 74 61 74 65 2e 0a 2a 2a 20 53 79 6e 63 68 state..** Synch
12530 72 6f 6e 6f 75 73 20 69 73 20 6f 6e 20 62 79 20 ronous is on by
12540 64 65 66 61 75 6c 74 20 73 6f 20 64 61 74 61 62 default so datab
12550 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 ase corruption i
12560 73 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c s not.** normall
12570 79 20 61 20 77 6f 72 72 79 2e 0a 2a 2f 0a 69 6e y a worry..*/.in
12580 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
12590 74 43 61 63 68 65 53 69 7a 65 28 42 74 72 65 65 tCacheSize(Btree
125a0 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 *p, int mxPage)
125b0 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
125c0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 t = p->pBt;. as
125d0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
125e0 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e tex_held(p->db->
125f0 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
12600 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
12610 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
12620 53 65 74 43 61 63 68 65 73 69 7a 65 28 70 42 74 SetCachesize(pBt
12630 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 61 67 65 ->pPager, mxPage
12640 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
12650 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
12660 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
12670 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 ..#if SQLITE_MAX
12680 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 2f 2a 0a _MMAP_SIZE>0./*.
12690 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 6c 69 ** Change the li
126a0 6d 69 74 20 6f 6e 20 74 68 65 20 61 6d 6f 75 6e mit on the amoun
126b0 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 t of the databas
126c0 65 20 66 69 6c 65 20 74 68 61 74 20 6d 61 79 20 e file that may
126d0 62 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 6d 61 70 be.** memory map
126e0 70 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ped..*/.int sqli
126f0 74 65 33 42 74 72 65 65 53 65 74 4d 6d 61 70 4c te3BtreeSetMmapL
12700 69 6d 69 74 28 42 74 72 65 65 20 2a 70 2c 20 73 imit(Btree *p, s
12710 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d qlite3_int64 szM
12720 6d 61 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 map){. BtShared
12730 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
12740 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
12750 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 3_mutex_held(p->
12760 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
12770 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
12780 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 r(p);. sqlite3P
12790 61 67 65 72 53 65 74 4d 6d 61 70 4c 69 6d 69 74 agerSetMmapLimit
127a0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 73 7a (pBt->pPager, sz
127b0 4d 6d 61 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 Mmap);. sqlite3
127c0 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
127d0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
127e0 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 K;.}.#endif /* S
127f0 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
12800 49 5a 45 3e 30 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 IZE>0 */../*.**
12810 43 68 61 6e 67 65 20 74 68 65 20 77 61 79 20 64 Change the way d
12820 61 74 61 20 69 73 20 73 79 6e 63 65 64 20 74 6f ata is synced to
12830 20 64 69 73 6b 20 69 6e 20 6f 72 64 65 72 20 74 disk in order t
12840 6f 20 69 6e 63 72 65 61 73 65 20 6f 72 20 64 65 o increase or de
12850 63 72 65 61 73 65 0a 2a 2a 20 68 6f 77 20 77 65 crease.** how we
12860 6c 6c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ll the database
12870 72 65 73 69 73 74 73 20 64 61 6d 61 67 65 20 64 resists damage d
12880 75 65 20 74 6f 20 4f 53 20 63 72 61 73 68 65 73 ue to OS crashes
12890 20 61 6e 64 20 70 6f 77 65 72 0a 2a 2a 20 66 61 and power.** fa
128a0 69 6c 75 72 65 73 2e 20 20 4c 65 76 65 6c 20 31 ilures. Level 1
128b0 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 is the same as
128c0 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 28 6e 6f asynchronous (no
128d0 20 73 79 6e 63 73 28 29 20 6f 63 63 75 72 20 61 syncs() occur a
128e0 6e 64 0a 2a 2a 20 74 68 65 72 65 20 69 73 20 61 nd.** there is a
128f0 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c 69 74 high probabilit
12900 79 20 6f 66 20 64 61 6d 61 67 65 29 20 20 4c 65 y of damage) Le
12910 76 65 6c 20 32 20 69 73 20 74 68 65 20 64 65 66 vel 2 is the def
12920 61 75 6c 74 2e 20 20 54 68 65 72 65 0a 2a 2a 20 ault. There.**
12930 69 73 20 61 20 76 65 72 79 20 6c 6f 77 20 62 75 is a very low bu
12940 74 20 6e 6f 6e 2d 7a 65 72 6f 20 70 72 6f 62 61 t non-zero proba
12950 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 65 bility of damage
12960 2e 20 20 4c 65 76 65 6c 20 33 20 72 65 64 75 63 . Level 3 reduc
12970 65 73 20 74 68 65 0a 2a 2a 20 70 72 6f 62 61 62 es the.** probab
12980 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 65 20 ility of damage
12990 74 6f 20 6e 65 61 72 20 7a 65 72 6f 20 62 75 74 to near zero but
129a0 20 77 69 74 68 20 61 20 77 72 69 74 65 20 70 65 with a write pe
129b0 72 66 6f 72 6d 61 6e 63 65 20 72 65 64 75 63 74 rformance reduct
129c0 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ion..*/.#ifndef
129d0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 SQLITE_OMIT_PAGE
129e0 52 5f 50 52 41 47 4d 41 53 0a 69 6e 74 20 73 71 R_PRAGMAS.int sq
129f0 6c 69 74 65 33 42 74 72 65 65 53 65 74 50 61 67 lite3BtreeSetPag
12a00 65 72 46 6c 61 67 73 28 0a 20 20 42 74 72 65 65 erFlags(. Btree
12a10 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 *p,
12a20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 74 /* The btree t
12a30 6f 20 73 65 74 20 74 68 65 20 73 61 66 65 74 79 o set the safety
12a40 20 6c 65 76 65 6c 20 6f 6e 20 2a 2f 0a 20 20 75 level on */. u
12a50 6e 73 69 67 6e 65 64 20 70 67 46 6c 61 67 73 20 nsigned pgFlags
12a60 20 20 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 /* Various
12a70 20 50 41 47 45 52 5f 2a 20 66 6c 61 67 73 20 2a PAGER_* flags *
12a80 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 /.){. BtShared
12a90 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
12aa0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
12ab0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 _mutex_held(p->d
12ac0 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
12ad0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
12ae0 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 (p);. sqlite3Pa
12af0 67 65 72 53 65 74 46 6c 61 67 73 28 70 42 74 2d gerSetFlags(pBt-
12b00 3e 70 50 61 67 65 72 2c 20 70 67 46 6c 61 67 73 >pPager, pgFlags
12b10 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
12b20 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
12b30 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
12b40 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 .#endif../*.** R
12b50 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 eturn TRUE if th
12b60 65 20 67 69 76 65 6e 20 62 74 72 65 65 20 69 73 e given btree is
12b70 20 73 65 74 20 74 6f 20 73 61 66 65 74 79 20 6c set to safety l
12b80 65 76 65 6c 20 31 2e 20 20 49 6e 20 6f 74 68 65 evel 1. In othe
12b90 72 0a 2a 2a 20 77 6f 72 64 73 2c 20 72 65 74 75 r.** words, retu
12ba0 72 6e 20 54 52 55 45 20 69 66 20 6e 6f 20 73 79 rn TRUE if no sy
12bb0 6e 63 28 29 20 6f 63 63 75 72 73 20 6f 6e 20 74 nc() occurs on t
12bc0 68 65 20 64 69 73 6b 20 66 69 6c 65 73 2e 0a 2a he disk files..*
12bd0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
12be0 65 65 53 79 6e 63 44 69 73 61 62 6c 65 64 28 42 eeSyncDisabled(B
12bf0 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 tree *p){. BtSh
12c00 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
12c10 42 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 Bt;. int rc;.
12c20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
12c30 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 mutex_held(p->db
12c40 2d 3e 6d 75 74 65 78 29 20 29 3b 20 20 0a 20 20 ->mutex) ); .
12c50 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
12c60 72 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r(p);. assert(
12c70 70 42 74 20 26 26 20 70 42 74 2d 3e 70 50 61 67 pBt && pBt->pPag
12c80 65 72 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c er );. rc = sql
12c90 69 74 65 33 50 61 67 65 72 4e 6f 73 79 6e 63 28 ite3PagerNosync(
12ca0 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 pBt->pPager);.
12cb0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
12cc0 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
12cd0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e c;.}../*.** Chan
12ce0 67 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 ge the default p
12cf0 61 67 65 73 20 73 69 7a 65 20 61 6e 64 20 74 68 ages size and th
12d00 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 e number of rese
12d10 72 76 65 64 20 62 79 74 65 73 20 70 65 72 20 70 rved bytes per p
12d20 61 67 65 2e 0a 2a 2a 20 4f 72 2c 20 69 66 20 74 age..** Or, if t
12d30 68 65 20 70 61 67 65 20 73 69 7a 65 20 68 61 73 he page size has
12d40 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 66 69 already been fi
12d50 78 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 xed, return SQLI
12d60 54 45 5f 52 45 41 44 4f 4e 4c 59 20 0a 2a 2a 20 TE_READONLY .**
12d70 77 69 74 68 6f 75 74 20 63 68 61 6e 67 69 6e 67 without changing
12d80 20 61 6e 79 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a anything..**.**
12d90 20 54 68 65 20 70 61 67 65 20 73 69 7a 65 20 6d The page size m
12da0 75 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 6f ust be a power o
12db0 66 20 32 20 62 65 74 77 65 65 6e 20 35 31 32 20 f 2 between 512
12dc0 61 6e 64 20 36 35 35 33 36 2e 20 20 49 66 20 74 and 65536. If t
12dd0 68 65 20 70 61 67 65 0a 2a 2a 20 73 69 7a 65 20 he page.** size
12de0 73 75 70 70 6c 69 65 64 20 64 6f 65 73 20 6e 6f supplied does no
12df0 74 20 6d 65 65 74 20 74 68 69 73 20 63 6f 6e 73 t meet this cons
12e00 74 72 61 69 6e 74 20 74 68 65 6e 20 74 68 65 20 traint then the
12e10 70 61 67 65 20 73 69 7a 65 20 69 73 20 6e 6f 74 page size is not
12e20 0a 2a 2a 20 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a .** changed..**.
12e30 2a 2a 20 50 61 67 65 20 73 69 7a 65 73 20 61 72 ** Page sizes ar
12e40 65 20 63 6f 6e 73 74 72 61 69 6e 65 64 20 74 6f e constrained to
12e50 20 62 65 20 61 20 70 6f 77 65 72 20 6f 66 20 74 be a power of t
12e60 77 6f 20 73 6f 20 74 68 61 74 20 74 68 65 20 72 wo so that the r
12e70 65 67 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 egion.** of the
12e80 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 75 73 database file us
12e90 65 64 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 20 28 ed for locking (
12ea0 62 65 67 69 6e 6e 69 6e 67 20 61 74 20 50 45 4e beginning at PEN
12eb0 44 49 4e 47 5f 42 59 54 45 2c 0a 2a 2a 20 74 68 DING_BYTE,.** th
12ec0 65 20 66 69 72 73 74 20 62 79 74 65 20 70 61 73 e first byte pas
12ed0 74 20 74 68 65 20 31 47 42 20 62 6f 75 6e 64 61 t the 1GB bounda
12ee0 72 79 2c 20 30 78 34 30 30 30 30 30 30 30 29 20 ry, 0x40000000)
12ef0 6e 65 65 64 73 20 74 6f 20 6f 63 63 75 72 0a 2a needs to occur.*
12f00 2a 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 * at the beginni
12f10 6e 67 20 6f 66 20 61 20 70 61 67 65 2e 0a 2a 2a ng of a page..**
12f20 0a 2a 2a 20 49 66 20 70 61 72 61 6d 65 74 65 72 .** If parameter
12f30 20 6e 52 65 73 65 72 76 65 20 69 73 20 6c 65 73 nReserve is les
12f40 73 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 s than zero, the
12f50 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
12f60 72 65 73 65 72 76 65 64 0a 2a 2a 20 62 79 74 65 reserved.** byte
12f70 73 20 70 65 72 20 70 61 67 65 20 69 73 20 6c 65 s per page is le
12f80 66 74 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a ft unchanged..**
12f90 0a 2a 2a 20 49 66 20 74 68 65 20 69 46 69 78 21 .** If the iFix!
12fa0 3d 30 20 74 68 65 6e 20 74 68 65 20 42 54 53 5f =0 then the BTS_
12fb0 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 20 66 PAGESIZE_FIXED f
12fc0 6c 61 67 20 69 73 20 73 65 74 20 73 6f 20 74 68 lag is set so th
12fd0 61 74 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 at the page size
12fe0 0a 2a 2a 20 61 6e 64 20 61 75 74 6f 76 61 63 75 .** and autovacu
12ff0 75 6d 20 6d 6f 64 65 20 63 61 6e 20 6e 6f 20 6c um mode can no l
13000 6f 6e 67 65 72 20 62 65 20 63 68 61 6e 67 65 64 onger be changed
13010 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
13020 42 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 BtreeSetPageSize
13030 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 70 (Btree *p, int p
13040 61 67 65 53 69 7a 65 2c 20 69 6e 74 20 6e 52 65 ageSize, int nRe
13050 73 65 72 76 65 2c 20 69 6e 74 20 69 46 69 78 29 serve, int iFix)
13060 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
13070 49 54 45 5f 4f 4b 3b 0a 20 20 42 74 53 68 61 72 ITE_OK;. BtShar
13080 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
13090 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 ;. assert( nRes
130a0 65 72 76 65 3e 3d 2d 31 20 26 26 20 6e 52 65 73 erve>=-1 && nRes
130b0 65 72 76 65 3c 3d 32 35 35 20 29 3b 0a 20 20 73 erve<=255 );. s
130c0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
130d0 28 70 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e (p);. if( pBt->
130e0 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 btsFlags & BTS_P
130f0 41 47 45 53 49 5a 45 5f 46 49 58 45 44 20 29 7b AGESIZE_FIXED ){
13100 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
13110 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 72 eLeave(p);. r
13120 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 eturn SQLITE_REA
13130 44 4f 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 DONLY;. }. if(
13140 20 6e 52 65 73 65 72 76 65 3c 30 20 29 7b 0a 20 nReserve<0 ){.
13150 20 20 20 6e 52 65 73 65 72 76 65 20 3d 20 70 42 nReserve = pB
13160 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 42 t->pageSize - pB
13170 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 t->usableSize;.
13180 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 }. assert( nRe
13190 73 65 72 76 65 3e 3d 30 20 26 26 20 6e 52 65 73 serve>=0 && nRes
131a0 65 72 76 65 3c 3d 32 35 35 20 29 3b 0a 20 20 69 erve<=255 );. i
131b0 66 28 20 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 f( pageSize>=512
131c0 20 26 26 20 70 61 67 65 53 69 7a 65 3c 3d 53 51 && pageSize<=SQ
131d0 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
131e0 5a 45 20 26 26 0a 20 20 20 20 20 20 20 20 28 28 ZE &&. ((
131f0 70 61 67 65 53 69 7a 65 2d 31 29 26 70 61 67 65 pageSize-1)&page
13200 53 69 7a 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 Size)==0 ){.
13210 61 73 73 65 72 74 28 20 28 70 61 67 65 53 69 7a assert( (pageSiz
13220 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 e & 7)==0 );.
13230 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e 70 assert( !pBt->p
13240 50 61 67 65 31 20 26 26 20 21 70 42 74 2d 3e 70 Page1 && !pBt->p
13250 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 20 70 42 Cursor );. pB
13260 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 75 t->pageSize = (u
13270 33 32 29 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 32)pageSize;.
13280 20 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 freeTempSpace(p
13290 42 74 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 Bt);. }. rc =
132a0 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 sqlite3PagerSetP
132b0 61 67 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 agesize(pBt->pPa
132c0 67 65 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 ger, &pBt->pageS
132d0 69 7a 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a ize, nReserve);.
132e0 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a pBt->usableSiz
132f0 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a e = pBt->pageSiz
13300 65 20 2d 20 28 75 31 36 29 6e 52 65 73 65 72 76 e - (u16)nReserv
13310 65 3b 0a 20 20 69 66 28 20 69 46 69 78 20 29 20 e;. if( iFix )
13320 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
13330 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 BTS_PAGESIZE_FI
13340 58 45 44 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 XED;. sqlite3Bt
13350 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
13360 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
13370 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 75 ** Return the cu
13380 72 72 65 6e 74 6c 79 20 64 65 66 69 6e 65 64 20 rrently defined
13390 70 61 67 65 20 73 69 7a 65 0a 2a 2f 0a 69 6e 74 page size.*/.int
133a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
133b0 50 61 67 65 53 69 7a 65 28 42 74 72 65 65 20 2a PageSize(Btree *
133c0 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e p){. return p->
133d0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 7d pBt->pageSize;.}
133e0 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 ..#if defined(SQ
133f0 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 29 20 LITE_HAS_CODEC)
13400 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
13410 45 5f 44 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 54 E_DEBUG)./*.** T
13420 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
13430 73 69 6d 69 6c 61 72 20 74 6f 20 73 71 6c 69 74 similar to sqlit
13440 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 76 e3BtreeGetReserv
13450 65 28 29 2c 20 65 78 63 65 70 74 20 74 68 61 74 e(), except that
13460 20 69 74 0a 2a 2a 20 6d 61 79 20 6f 6e 6c 79 20 it.** may only
13470 62 65 20 63 61 6c 6c 65 64 20 69 66 20 69 74 20 be called if it
13480 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 68 is guaranteed th
13490 61 74 20 74 68 65 20 62 2d 74 72 65 65 20 6d 75 at the b-tree mu
134a0 74 65 78 20 69 73 20 61 6c 72 65 61 64 79 0a 2a tex is already.*
134b0 2a 20 68 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 * held..**.** Th
134c0 69 73 20 69 73 20 75 73 65 66 75 6c 20 69 6e 20 is is useful in
134d0 6f 6e 65 20 73 70 65 63 69 61 6c 20 63 61 73 65 one special case
134e0 20 69 6e 20 74 68 65 20 62 61 63 6b 75 70 20 41 in the backup A
134f0 50 49 20 63 6f 64 65 20 77 68 65 72 65 20 69 74 PI code where it
13500 20 69 73 0a 2a 2a 20 6b 6e 6f 77 6e 20 74 68 61 is.** known tha
13510 74 20 74 68 65 20 73 68 61 72 65 64 20 62 2d 74 t the shared b-t
13520 72 65 65 20 6d 75 74 65 78 20 69 73 20 68 65 6c ree mutex is hel
13530 64 2c 20 62 75 74 20 74 68 65 20 6d 75 74 65 78 d, but the mutex
13540 20 6f 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 on the .** data
13550 62 61 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 base handle that
13560 20 6f 77 6e 73 20 2a 70 20 69 73 20 6e 6f 74 2e owns *p is not.
13570 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 69 66 In this case if
13580 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
13590 65 72 28 29 0a 2a 2a 20 77 65 72 65 20 74 6f 20 er().** were to
135a0 62 65 20 63 61 6c 6c 65 64 2c 20 69 74 20 6d 69 be called, it mi
135b0 67 68 74 20 63 6f 6c 6c 69 64 65 20 77 69 74 68 ght collide with
135c0 20 73 6f 6d 65 20 6f 74 68 65 72 20 6f 70 65 72 some other oper
135d0 61 74 69 6f 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 ation on the.**
135e0 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
135f0 74 68 61 74 20 6f 77 6e 73 20 2a 70 2c 20 63 61 that owns *p, ca
13600 75 73 69 6e 67 20 75 6e 64 65 66 69 6e 65 64 20 using undefined
13610 62 65 68 61 76 69 6f 72 2e 0a 2a 2f 0a 69 6e 74 behavior..*/.int
13620 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
13630 52 65 73 65 72 76 65 4e 6f 4d 75 74 65 78 28 42 ReserveNoMutex(B
13640 74 72 65 65 20 2a 70 29 7b 0a 20 20 61 73 73 65 tree *p){. asse
13650 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
13660 78 5f 68 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d x_held(p->pBt->m
13670 75 74 65 78 29 20 29 3b 0a 20 20 72 65 74 75 72 utex) );. retur
13680 6e 20 70 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 n p->pBt->pageSi
13690 7a 65 20 2d 20 70 2d 3e 70 42 74 2d 3e 75 73 61 ze - p->pBt->usa
136a0 62 6c 65 53 69 7a 65 3b 0a 7d 0a 23 65 6e 64 69 bleSize;.}.#endi
136b0 66 20 2f 2a 20 53 51 4c 49 54 45 5f 48 41 53 5f f /* SQLITE_HAS_
136c0 43 4f 44 45 43 20 7c 7c 20 53 51 4c 49 54 45 5f CODEC || SQLITE_
136d0 44 45 42 55 47 20 2a 2f 0a 0a 23 69 66 20 21 64 DEBUG */..#if !d
136e0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
136f0 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 IT_PAGER_PRAGMAS
13700 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 53 51 ) || !defined(SQ
13710 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55 55 4d LITE_OMIT_VACUUM
13720 29 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 )./*.** Return t
13730 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
13740 65 73 20 6f 66 20 73 70 61 63 65 20 61 74 20 74 es of space at t
13750 68 65 20 65 6e 64 20 6f 66 20 65 76 65 72 79 20 he end of every
13760 70 61 67 65 20 74 68 61 74 0a 2a 2a 20 61 72 65 page that.** are
13770 20 69 6e 74 65 6e 74 75 61 6c 6c 79 20 6c 65 66 intentually lef
13780 74 20 75 6e 75 73 65 64 2e 20 20 54 68 69 73 20 t unused. This
13790 69 73 20 74 68 65 20 22 72 65 73 65 72 76 65 64 is the "reserved
137a0 22 20 73 70 61 63 65 20 74 68 61 74 20 69 73 0a " space that is.
137b0 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 ** sometimes use
137c0 64 20 62 79 20 65 78 74 65 6e 73 69 6f 6e 73 2e d by extensions.
137d0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
137e0 74 72 65 65 47 65 74 52 65 73 65 72 76 65 28 42 treeGetReserve(B
137f0 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 tree *p){. int
13800 6e 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 n;. sqlite3Btre
13810 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 6e 20 3d eEnter(p);. n =
13820 20 70 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a p->pBt->pageSiz
13830 65 20 2d 20 70 2d 3e 70 42 74 2d 3e 75 73 61 62 e - p->pBt->usab
13840 6c 65 53 69 7a 65 3b 0a 20 20 73 71 6c 69 74 65 leSize;. sqlite
13850 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
13860 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f return n;.}../
13870 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 6d 61 78 *.** Set the max
13880 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 20 imum page count
13890 66 6f 72 20 61 20 64 61 74 61 62 61 73 65 20 69 for a database i
138a0 66 20 6d 78 50 61 67 65 20 69 73 20 70 6f 73 69 f mxPage is posi
138b0 74 69 76 65 2e 0a 2a 2a 20 4e 6f 20 63 68 61 6e tive..** No chan
138c0 67 65 73 20 61 72 65 20 6d 61 64 65 20 69 66 20 ges are made if
138d0 6d 78 50 61 67 65 20 69 73 20 30 20 6f 72 20 6e mxPage is 0 or n
138e0 65 67 61 74 69 76 65 2e 0a 2a 2a 20 52 65 67 61 egative..** Rega
138f0 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 76 61 rdless of the va
13900 6c 75 65 20 6f 66 20 6d 78 50 61 67 65 2c 20 72 lue of mxPage, r
13910 65 74 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 eturn the maximu
13920 6d 20 70 61 67 65 20 63 6f 75 6e 74 2e 0a 2a 2f m page count..*/
13930 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
13940 65 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 42 74 eMaxPageCount(Bt
13950 72 65 65 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 ree *p, int mxPa
13960 67 65 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 ge){. int n;.
13970 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
13980 72 28 70 29 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 r(p);. n = sqli
13990 74 65 33 50 61 67 65 72 4d 61 78 50 61 67 65 43 te3PagerMaxPageC
139a0 6f 75 6e 74 28 70 2d 3e 70 42 74 2d 3e 70 50 61 ount(p->pBt->pPa
139b0 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 ger, mxPage);.
139c0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
139d0 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 6e e(p);. return n
139e0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 ;.}../*.** Set t
139f0 68 65 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 he BTS_SECURE_DE
13a00 4c 45 54 45 20 66 6c 61 67 20 69 66 20 6e 65 77 LETE flag if new
13a10 46 6c 61 67 20 69 73 20 30 20 6f 72 20 31 2e 20 Flag is 0 or 1.
13a20 20 49 66 20 6e 65 77 46 6c 61 67 20 69 73 20 2d If newFlag is -
13a30 31 2c 0a 2a 2a 20 74 68 65 6e 20 6d 61 6b 65 20 1,.** then make
13a40 6e 6f 20 63 68 61 6e 67 65 73 2e 20 20 41 6c 77 no changes. Alw
13a50 61 79 73 20 72 65 74 75 72 6e 20 74 68 65 20 76 ays return the v
13a60 61 6c 75 65 20 6f 66 20 74 68 65 20 42 54 53 5f alue of the BTS_
13a70 53 45 43 55 52 45 5f 44 45 4c 45 54 45 0a 2a 2a SECURE_DELETE.**
13a80 20 73 65 74 74 69 6e 67 20 61 66 74 65 72 20 74 setting after t
13a90 68 65 20 63 68 61 6e 67 65 2e 0a 2a 2f 0a 69 6e he change..*/.in
13aa0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
13ab0 63 75 72 65 44 65 6c 65 74 65 28 42 74 72 65 65 cureDelete(Btree
13ac0 20 2a 70 2c 20 69 6e 74 20 6e 65 77 46 6c 61 67 *p, int newFlag
13ad0 29 7b 0a 20 20 69 6e 74 20 62 3b 0a 20 20 69 66 ){. int b;. if
13ae0 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 ( p==0 ) return
13af0 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 0;. sqlite3Btre
13b00 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 69 66 28 eEnter(p);. if(
13b10 20 6e 65 77 46 6c 61 67 3e 3d 30 20 29 7b 0a 20 newFlag>=0 ){.
13b20 20 20 20 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c p->pBt->btsFl
13b30 61 67 73 20 26 3d 20 7e 42 54 53 5f 53 45 43 55 ags &= ~BTS_SECU
13b40 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 20 20 69 RE_DELETE;. i
13b50 66 28 20 6e 65 77 46 6c 61 67 20 29 20 70 2d 3e f( newFlag ) p->
13b60 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
13b70 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
13b80 54 45 3b 0a 20 20 7d 20 0a 20 20 62 20 3d 20 28 TE;. } . b = (
13b90 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 p->pBt->btsFlags
13ba0 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 & BTS_SECURE_DE
13bb0 4c 45 54 45 29 21 3d 30 3b 0a 20 20 73 71 6c 69 LETE)!=0;. sqli
13bc0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
13bd0 3b 0a 20 20 72 65 74 75 72 6e 20 62 3b 0a 7d 0a ;. return b;.}.
13be0 23 65 6e 64 69 66 20 2f 2a 20 21 64 65 66 69 6e #endif /* !defin
13bf0 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 ed(SQLITE_OMIT_P
13c00 41 47 45 52 5f 50 52 41 47 4d 41 53 29 20 7c 7c AGER_PRAGMAS) ||
13c10 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
13c20 5f 4f 4d 49 54 5f 56 41 43 55 55 4d 29 20 2a 2f _OMIT_VACUUM) */
13c30 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 ../*.** Change t
13c40 68 65 20 27 61 75 74 6f 2d 76 61 63 75 75 6d 27 he 'auto-vacuum'
13c50 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 68 65 property of the
13c60 20 64 61 74 61 62 61 73 65 2e 20 49 66 20 74 68 database. If th
13c70 65 20 27 61 75 74 6f 56 61 63 75 75 6d 27 0a 2a e 'autoVacuum'.*
13c80 2a 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e * parameter is n
13c90 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 61 75 on-zero, then au
13ca0 74 6f 2d 76 61 63 75 75 6d 20 6d 6f 64 65 20 69 to-vacuum mode i
13cb0 73 20 65 6e 61 62 6c 65 64 2e 20 49 66 20 7a 65 s enabled. If ze
13cc0 72 6f 2c 20 69 74 0a 2a 2a 20 69 73 20 64 69 73 ro, it.** is dis
13cd0 61 62 6c 65 64 2e 20 54 68 65 20 64 65 66 61 75 abled. The defau
13ce0 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 lt value for the
13cf0 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 70 72 6f auto-vacuum pro
13d00 70 65 72 74 79 20 69 73 20 0a 2a 2a 20 64 65 74 perty is .** det
13d10 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 53 ermined by the S
13d20 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 QLITE_DEFAULT_AU
13d30 54 4f 56 41 43 55 55 4d 20 6d 61 63 72 6f 2e 0a TOVACUUM macro..
13d40 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
13d50 72 65 65 53 65 74 41 75 74 6f 56 61 63 75 75 6d reeSetAutoVacuum
13d60 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 61 (Btree *p, int a
13d70 75 74 6f 56 61 63 75 75 6d 29 7b 0a 23 69 66 64 utoVacuum){.#ifd
13d80 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
13d90 55 54 4f 56 41 43 55 55 4d 0a 20 20 72 65 74 75 UTOVACUUM. retu
13da0 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e rn SQLITE_READON
13db0 4c 59 3b 0a 23 65 6c 73 65 0a 20 20 42 74 53 68 LY;.#else. BtSh
13dc0 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
13dd0 42 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 Bt;. int rc = S
13de0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 38 20 61 QLITE_OK;. u8 a
13df0 76 20 3d 20 28 75 38 29 61 75 74 6f 56 61 63 75 v = (u8)autoVacu
13e00 75 6d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 um;.. sqlite3Bt
13e10 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 69 reeEnter(p);. i
13e20 66 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 f( (pBt->btsFlag
13e30 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 5a 45 s & BTS_PAGESIZE
13e40 5f 46 49 58 45 44 29 21 3d 30 20 26 26 20 28 61 _FIXED)!=0 && (a
13e50 76 20 3f 31 3a 30 29 21 3d 70 42 74 2d 3e 61 75 v ?1:0)!=pBt->au
13e60 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 toVacuum ){.
13e70 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 rc = SQLITE_READ
13e80 4f 4e 4c 59 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 ONLY;. }else{.
13e90 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
13ea0 75 6d 20 3d 20 61 76 20 3f 31 3a 30 3b 0a 20 20 um = av ?1:0;.
13eb0 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 pBt->incrVacuu
13ec0 6d 20 3d 20 61 76 3d 3d 32 20 3f 31 3a 30 3b 0a m = av==2 ?1:0;.
13ed0 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 }. sqlite3Btr
13ee0 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
13ef0 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a turn rc;.#endif.
13f00 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
13f10 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 the value of the
13f20 20 27 61 75 74 6f 2d 76 61 63 75 75 6d 27 20 70 'auto-vacuum' p
13f30 72 6f 70 65 72 74 79 2e 20 49 66 20 61 75 74 6f roperty. If auto
13f40 2d 76 61 63 75 75 6d 20 69 73 20 0a 2a 2a 20 65 -vacuum is .** e
13f50 6e 61 62 6c 65 64 20 31 20 69 73 20 72 65 74 75 nabled 1 is retu
13f60 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 65 20 rned. Otherwise
13f70 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 0..*/.int sqlite
13f80 33 42 74 72 65 65 47 65 74 41 75 74 6f 56 61 63 3BtreeGetAutoVac
13f90 75 75 6d 28 42 74 72 65 65 20 2a 70 29 7b 0a 23 uum(Btree *p){.#
13fa0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 ifdef SQLITE_OMI
13fb0 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 72 T_AUTOVACUUM. r
13fc0 65 74 75 72 6e 20 42 54 52 45 45 5f 41 55 54 4f eturn BTREE_AUTO
13fd0 56 41 43 55 55 4d 5f 4e 4f 4e 45 3b 0a 23 65 6c VACUUM_NONE;.#el
13fe0 73 65 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 se. int rc;. s
13ff0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
14000 28 70 29 3b 0a 20 20 72 63 20 3d 20 28 0a 20 20 (p);. rc = (.
14010 20 20 28 21 70 2d 3e 70 42 74 2d 3e 61 75 74 6f (!p->pBt->auto
14020 56 61 63 75 75 6d 29 3f 42 54 52 45 45 5f 41 55 Vacuum)?BTREE_AU
14030 54 4f 56 41 43 55 55 4d 5f 4e 4f 4e 45 3a 0a 20 TOVACUUM_NONE:.
14040 20 20 20 28 21 70 2d 3e 70 42 74 2d 3e 69 6e 63 (!p->pBt->inc
14050 72 56 61 63 75 75 6d 29 3f 42 54 52 45 45 5f 41 rVacuum)?BTREE_A
14060 55 54 4f 56 41 43 55 55 4d 5f 46 55 4c 4c 3a 0a UTOVACUUM_FULL:.
14070 20 20 20 20 42 54 52 45 45 5f 41 55 54 4f 56 41 BTREE_AUTOVA
14080 43 55 55 4d 5f 49 4e 43 52 0a 20 20 29 3b 0a 20 CUUM_INCR. );.
14090 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
140a0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
140b0 72 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f rc;.#endif.}.../
140c0 2a 0a 2a 2a 20 47 65 74 20 61 20 72 65 66 65 72 *.** Get a refer
140d0 65 6e 63 65 20 74 6f 20 70 50 61 67 65 31 20 6f ence to pPage1 o
140e0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
140f0 69 6c 65 2e 20 20 54 68 69 73 20 77 69 6c 6c 0a ile. This will.
14100 2a 2a 20 61 6c 73 6f 20 61 63 71 75 69 72 65 20 ** also acquire
14110 61 20 72 65 61 64 6c 6f 63 6b 20 6f 6e 20 74 68 a readlock on th
14120 61 74 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 at file..**.** S
14130 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
14140 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 73 2e rned on success.
14150 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 69 73 If the file is
14160 20 6e 6f 74 20 61 0a 2a 2a 20 77 65 6c 6c 2d 66 not a.** well-f
14170 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 66 ormed database f
14180 69 6c 65 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 ile, then SQLITE
14190 5f 43 4f 52 52 55 50 54 20 69 73 20 72 65 74 75 _CORRUPT is retu
141a0 72 6e 65 64 2e 0a 2a 2a 20 53 51 4c 49 54 45 5f rned..** SQLITE_
141b0 42 55 53 59 20 69 73 20 72 65 74 75 72 6e 65 64 BUSY is returned
141c0 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 if the database
141d0 20 69 73 20 6c 6f 63 6b 65 64 2e 20 20 53 51 4c is locked. SQL
141e0 49 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a 20 69 73 20 ITE_NOMEM.** is
141f0 72 65 74 75 72 6e 65 64 20 69 66 20 77 65 20 72 returned if we r
14200 75 6e 20 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 un out of memory
14210 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 . .*/.static int
14220 20 6c 6f 63 6b 42 74 72 65 65 28 42 74 53 68 61 lockBtree(BtSha
14230 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 6e 74 red *pBt){. int
14240 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
14250 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 /* Result code
14260 20 66 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 6f from subfunctio
14270 6e 73 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 ns */. MemPage
14280 2a 70 50 61 67 65 31 3b 20 20 20 20 20 2f 2a 20 *pPage1; /*
14290 50 61 67 65 20 31 20 6f 66 20 74 68 65 20 64 61 Page 1 of the da
142a0 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
142b0 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20 20 20 int nPage;
142c0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
142d0 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 of pages in the
142e0 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e database */. in
142f0 74 20 6e 50 61 67 65 46 69 6c 65 20 3d 20 30 3b t nPageFile = 0;
14300 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
14310 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 pages in the dat
14320 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
14330 69 6e 74 20 6e 50 61 67 65 48 65 61 64 65 72 3b int nPageHeader;
14340 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
14350 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 f pages in the d
14360 61 74 61 62 61 73 65 20 61 63 63 6f 72 64 69 6e atabase accordin
14370 67 20 74 6f 20 68 64 72 20 2a 2f 0a 0a 20 20 61 g to hdr */.. a
14380 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
14390 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
143a0 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
143b0 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 3d 3d t( pBt->pPage1==
143c0 30 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 0 );. rc = sqli
143d0 74 65 33 50 61 67 65 72 53 68 61 72 65 64 4c 6f te3PagerSharedLo
143e0 63 6b 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b ck(pBt->pPager);
143f0 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
14400 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 E_OK ) return rc
14410 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 ;. rc = btreeGe
14420 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 70 tPage(pBt, 1, &p
14430 50 61 67 65 31 2c 20 30 29 3b 0a 20 20 69 66 28 Page1, 0);. if(
14440 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
14450 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f return rc;.. /
14460 2a 20 44 6f 20 73 6f 6d 65 20 63 68 65 63 6b 69 * Do some checki
14470 6e 67 20 74 6f 20 68 65 6c 70 20 69 6e 73 75 72 ng to help insur
14480 65 20 74 68 65 20 66 69 6c 65 20 77 65 20 6f 70 e the file we op
14490 65 6e 65 64 20 72 65 61 6c 6c 79 20 69 73 0a 20 ened really is.
144a0 20 2a 2a 20 61 20 76 61 6c 69 64 20 64 61 74 61 ** a valid data
144b0 62 61 73 65 20 66 69 6c 65 2e 20 0a 20 20 2a 2f base file. . */
144c0 0a 20 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 . nPage = nPage
144d0 48 65 61 64 65 72 20 3d 20 67 65 74 34 62 79 74 Header = get4byt
144e0 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 65 31 e(28+(u8*)pPage1
144f0 2d 3e 61 44 61 74 61 29 3b 0a 20 20 73 71 6c 69 ->aData);. sqli
14500 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e te3PagerPagecoun
14510 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 t(pBt->pPager, &
14520 6e 50 61 67 65 46 69 6c 65 29 3b 0a 20 20 69 66 nPageFile);. if
14530 28 20 6e 50 61 67 65 3d 3d 30 20 7c 7c 20 6d 65 ( nPage==0 || me
14540 6d 63 6d 70 28 32 34 2b 28 75 38 2a 29 70 50 61 mcmp(24+(u8*)pPa
14550 67 65 31 2d 3e 61 44 61 74 61 2c 20 39 32 2b 28 ge1->aData, 92+(
14560 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 u8*)pPage1->aDat
14570 61 2c 34 29 21 3d 30 20 29 7b 0a 20 20 20 20 6e a,4)!=0 ){. n
14580 50 61 67 65 20 3d 20 6e 50 61 67 65 46 69 6c 65 Page = nPageFile
14590 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 50 61 67 ;. }. if( nPag
145a0 65 3e 30 20 29 7b 0a 20 20 20 20 75 33 32 20 70 e>0 ){. u32 p
145b0 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 75 33 32 ageSize;. u32
145c0 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 20 usableSize;.
145d0 20 75 38 20 2a 70 61 67 65 31 20 3d 20 70 50 61 u8 *page1 = pPa
145e0 67 65 31 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 ge1->aData;.
145f0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 41 rc = SQLITE_NOTA
14600 44 42 3b 0a 20 20 20 20 69 66 28 20 6d 65 6d 63 DB;. if( memc
14610 6d 70 28 70 61 67 65 31 2c 20 7a 4d 61 67 69 63 mp(page1, zMagic
14620 48 65 61 64 65 72 2c 20 31 36 29 21 3d 30 20 29 Header, 16)!=0 )
14630 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
14640 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
14650 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }..#ifdef SQ
14660 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 LITE_OMIT_WAL.
14670 20 20 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e if( page1[18]>
14680 31 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 1 ){. pBt->
14690 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
146a0 52 45 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d READ_ONLY;. }
146b0 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 . if( page1[1
146c0 39 5d 3e 31 20 29 7b 0a 20 20 20 20 20 20 67 6f 9]>1 ){. go
146d0 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 to page1_init_fa
146e0 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 iled;. }.#els
146f0 65 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 5b e. if( page1[
14700 31 38 5d 3e 32 20 29 7b 0a 20 20 20 20 20 20 70 18]>2 ){. p
14710 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 Bt->btsFlags |=
14720 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 20 BTS_READ_ONLY;.
14730 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 61 67 }. if( pag
14740 65 31 5b 31 39 5d 3e 32 20 29 7b 0a 20 20 20 20 e1[19]>2 ){.
14750 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
14760 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
14770 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 77 . /* If the w
14780 72 69 74 65 20 76 65 72 73 69 6f 6e 20 69 73 20 rite version is
14790 73 65 74 20 74 6f 20 32 2c 20 74 68 69 73 20 64 set to 2, this d
147a0 61 74 61 62 61 73 65 20 73 68 6f 75 6c 64 20 62 atabase should b
147b0 65 20 61 63 63 65 73 73 65 64 0a 20 20 20 20 2a e accessed. *
147c0 2a 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 20 49 * in WAL mode. I
147d0 66 20 74 68 65 20 6c 6f 67 20 69 73 20 6e 6f 74 f the log is not
147e0 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 6f already open, o
147f0 70 65 6e 20 69 74 20 6e 6f 77 2e 20 54 68 65 6e pen it now. Then
14800 20 0a 20 20 20 20 2a 2a 20 72 65 74 75 72 6e 20 . ** return
14810 53 51 4c 49 54 45 5f 4f 4b 20 61 6e 64 20 72 65 SQLITE_OK and re
14820 74 75 72 6e 20 77 69 74 68 6f 75 74 20 70 6f 70 turn without pop
14830 75 6c 61 74 69 6e 67 20 42 74 53 68 61 72 65 64 ulating BtShared
14840 2e 70 50 61 67 65 31 2e 0a 20 20 20 20 2a 2a 20 .pPage1.. **
14850 54 68 65 20 63 61 6c 6c 65 72 20 64 65 74 65 63 The caller detec
14860 74 73 20 74 68 69 73 20 61 6e 64 20 63 61 6c 6c ts this and call
14870 73 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 s this function
14880 61 67 61 69 6e 2e 20 54 68 69 73 20 69 73 0a 20 again. This is.
14890 20 20 20 2a 2a 20 72 65 71 75 69 72 65 64 20 61 ** required a
148a0 73 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 s the version of
148b0 20 70 61 67 65 20 31 20 63 75 72 72 65 6e 74 6c page 1 currentl
148c0 79 20 69 6e 20 74 68 65 20 70 61 67 65 31 20 62 y in the page1 b
148d0 75 66 66 65 72 0a 20 20 20 20 2a 2a 20 6d 61 79 uffer. ** may
148e0 20 6e 6f 74 20 62 65 20 74 68 65 20 6c 61 74 65 not be the late
148f0 73 74 20 76 65 72 73 69 6f 6e 20 2d 20 74 68 65 st version - the
14900 72 65 20 6d 61 79 20 62 65 20 61 20 6e 65 77 65 re may be a newe
14910 72 20 6f 6e 65 20 69 6e 20 74 68 65 20 6c 6f 67 r one in the log
14920 0a 20 20 20 20 2a 2a 20 66 69 6c 65 2e 0a 20 20 . ** file..
14930 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 61 67 */. if( pag
14940 65 31 5b 31 39 5d 3d 3d 32 20 26 26 20 28 70 42 e1[19]==2 && (pB
14950 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
14960 53 5f 4e 4f 5f 57 41 4c 29 3d 3d 30 20 29 7b 0a S_NO_WAL)==0 ){.
14970 20 20 20 20 20 20 69 6e 74 20 69 73 4f 70 65 6e int isOpen
14980 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 63 20 3d = 0;. rc =
14990 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 sqlite3PagerOpe
149a0 6e 57 61 6c 28 70 42 74 2d 3e 70 50 61 67 65 72 nWal(pBt->pPager
149b0 2c 20 26 69 73 4f 70 65 6e 29 3b 0a 20 20 20 20 , &isOpen);.
149c0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
149d0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 _OK ){. g
149e0 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 oto page1_init_f
149f0 61 69 6c 65 64 3b 0a 20 20 20 20 20 20 7d 65 6c ailed;. }el
14a00 73 65 20 69 66 28 20 69 73 4f 70 65 6e 3d 3d 30 se if( isOpen==0
14a10 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 ){. rele
14a20 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b asePage(pPage1);
14a30 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
14a40 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 SQLITE_OK;.
14a50 20 7d 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 }. rc = SQ
14a60 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 LITE_NOTADB;.
14a70 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f }.#endif.. /
14a80 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 65 6d * The maximum em
14a90 62 65 64 64 65 64 20 66 72 61 63 74 69 6f 6e 20 bedded fraction
14aa0 6d 75 73 74 20 62 65 20 65 78 61 63 74 6c 79 20 must be exactly
14ab0 32 35 25 2e 20 20 41 6e 64 20 74 68 65 20 6d 69 25%. And the mi
14ac0 6e 69 6d 75 6d 0a 20 20 20 20 2a 2a 20 65 6d 62 nimum. ** emb
14ad0 65 64 64 65 64 20 66 72 61 63 74 69 6f 6e 20 6d edded fraction m
14ae0 75 73 74 20 62 65 20 31 32 2e 35 25 20 66 6f 72 ust be 12.5% for
14af0 20 62 6f 74 68 20 6c 65 61 66 2d 64 61 74 61 20 both leaf-data
14b00 61 6e 64 20 6e 6f 6e 2d 6c 65 61 66 2d 64 61 74 and non-leaf-dat
14b10 61 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 6f 72 a.. ** The or
14b20 69 67 69 6e 61 6c 20 64 65 73 69 67 6e 20 61 6c iginal design al
14b30 6c 6f 77 65 64 20 74 68 65 73 65 20 61 6d 6f 75 lowed these amou
14b40 6e 74 73 20 74 6f 20 76 61 72 79 2c 20 62 75 74 nts to vary, but
14b50 20 61 73 20 6f 66 0a 20 20 20 20 2a 2a 20 76 65 as of. ** ve
14b60 72 73 69 6f 6e 20 33 2e 36 2e 30 2c 20 77 65 20 rsion 3.6.0, we
14b70 72 65 71 75 69 72 65 20 74 68 65 6d 20 74 6f 20 require them to
14b80 62 65 20 66 69 78 65 64 2e 0a 20 20 20 20 2a 2f be fixed.. */
14b90 0a 20 20 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 . if( memcmp(
14ba0 26 70 61 67 65 31 5b 32 31 5d 2c 20 22 5c 31 30 &page1[21], "\10
14bb0 30 5c 30 34 30 5c 30 34 30 22 2c 33 29 21 3d 30 0\040\040",3)!=0
14bc0 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 ){. goto p
14bd0 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 age1_init_failed
14be0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 65 ;. }. page
14bf0 53 69 7a 65 20 3d 20 28 70 61 67 65 31 5b 31 36 Size = (page1[16
14c00 5d 3c 3c 38 29 20 7c 20 28 70 61 67 65 31 5b 31 ]<<8) | (page1[1
14c10 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 7]<<16);. if(
14c20 20 28 28 70 61 67 65 53 69 7a 65 2d 31 29 26 70 ((pageSize-1)&p
14c30 61 67 65 53 69 7a 65 29 21 3d 30 0a 20 20 20 20 ageSize)!=0.
14c40 20 7c 7c 20 70 61 67 65 53 69 7a 65 3e 53 51 4c || pageSize>SQL
14c50 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a ITE_MAX_PAGE_SIZ
14c60 45 20 0a 20 20 20 20 20 7c 7c 20 70 61 67 65 53 E . || pageS
14c70 69 7a 65 3c 3d 32 35 36 20 0a 20 20 20 20 29 7b ize<=256 . ){
14c80 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
14c90 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 1_init_failed;.
14ca0 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 }. assert(
14cb0 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d (pageSize & 7)=
14cc0 3d 30 20 29 3b 0a 20 20 20 20 75 73 61 62 6c 65 =0 );. usable
14cd0 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a 65 20 Size = pageSize
14ce0 2d 20 70 61 67 65 31 5b 32 30 5d 3b 0a 20 20 20 - page1[20];.
14cf0 20 69 66 28 20 28 75 33 32 29 70 61 67 65 53 69 if( (u32)pageSi
14d00 7a 65 21 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a ze!=pBt->pageSiz
14d10 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 41 66 e ){. /* Af
14d20 74 65 72 20 72 65 61 64 69 6e 67 20 74 68 65 20 ter reading the
14d30 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 first page of th
14d40 65 20 64 61 74 61 62 61 73 65 20 61 73 73 75 6d e database assum
14d50 69 6e 67 20 61 20 70 61 67 65 20 73 69 7a 65 0a ing a page size.
14d60 20 20 20 20 20 20 2a 2a 20 6f 66 20 42 74 53 68 ** of BtSh
14d70 61 72 65 64 2e 70 61 67 65 53 69 7a 65 2c 20 77 ared.pageSize, w
14d80 65 20 68 61 76 65 20 64 69 73 63 6f 76 65 72 65 e have discovere
14d90 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 2d d that the page-
14da0 73 69 7a 65 20 69 73 0a 20 20 20 20 20 20 2a 2a size is. **
14db0 20 61 63 74 75 61 6c 6c 79 20 70 61 67 65 53 69 actually pageSi
14dc0 7a 65 2e 20 55 6e 6c 6f 63 6b 20 74 68 65 20 64 ze. Unlock the d
14dd0 61 74 61 62 61 73 65 2c 20 6c 65 61 76 65 20 70 atabase, leave p
14de0 42 74 2d 3e 70 50 61 67 65 31 20 61 74 0a 20 20 Bt->pPage1 at.
14df0 20 20 20 20 2a 2a 20 7a 65 72 6f 20 61 6e 64 20 ** zero and
14e00 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
14e10 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c . The caller wil
14e20 6c 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 l call this func
14e30 74 69 6f 6e 0a 20 20 20 20 20 20 2a 2a 20 61 67 tion. ** ag
14e40 61 69 6e 20 77 69 74 68 20 74 68 65 20 63 6f 72 ain with the cor
14e50 72 65 63 74 20 70 61 67 65 2d 73 69 7a 65 2e 0a rect page-size..
14e60 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 */. r
14e70 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
14e80 31 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 75 1);. pBt->u
14e90 73 61 62 6c 65 53 69 7a 65 20 3d 20 75 73 61 62 sableSize = usab
14ea0 6c 65 53 69 7a 65 3b 0a 20 20 20 20 20 20 70 42 leSize;. pB
14eb0 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 70 61 t->pageSize = pa
14ec0 67 65 53 69 7a 65 3b 0a 20 20 20 20 20 20 66 72 geSize;. fr
14ed0 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 29 eeTempSpace(pBt)
14ee0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
14ef0 69 74 65 33 50 61 67 65 72 53 65 74 50 61 67 65 ite3PagerSetPage
14f00 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 size(pBt->pPager
14f10 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 , &pBt->pageSize
14f20 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
14f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14f40 20 20 20 20 20 70 61 67 65 53 69 7a 65 2d 75 73 pageSize-us
14f50 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 ableSize);.
14f60 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
14f70 7d 0a 20 20 20 20 69 66 28 20 28 70 42 74 2d 3e }. if( (pBt->
14f80 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 db->flags & SQLI
14f90 54 45 5f 52 65 63 6f 76 65 72 79 4d 6f 64 65 29 TE_RecoveryMode)
14fa0 3d 3d 30 20 26 26 20 6e 50 61 67 65 3e 6e 50 61 ==0 && nPage>nPa
14fb0 67 65 46 69 6c 65 20 29 7b 0a 20 20 20 20 20 20 geFile ){.
14fc0 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
14fd0 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
14fe0 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f goto page1_init_
14ff0 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 failed;. }.
15000 20 20 69 66 28 20 75 73 61 62 6c 65 53 69 7a 65 if( usableSize
15010 3c 34 38 30 20 29 7b 0a 20 20 20 20 20 20 67 6f <480 ){. go
15020 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 to page1_init_fa
15030 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 iled;. }.
15040 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 pBt->pageSize =
15050 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 70 42 pageSize;. pB
15060 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 t->usableSize =
15070 75 73 61 62 6c 65 53 69 7a 65 3b 0a 23 69 66 6e usableSize;.#ifn
15080 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
15090 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 70 AUTOVACUUM. p
150a0 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d Bt->autoVacuum =
150b0 20 28 67 65 74 34 62 79 74 65 28 26 70 61 67 65 (get4byte(&page
150c0 31 5b 33 36 20 2b 20 34 2a 34 5d 29 3f 31 3a 30 1[36 + 4*4])?1:0
150d0 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 );. pBt->incr
150e0 56 61 63 75 75 6d 20 3d 20 28 67 65 74 34 62 79 Vacuum = (get4by
150f0 74 65 28 26 70 61 67 65 31 5b 33 36 20 2b 20 37 te(&page1[36 + 7
15100 2a 34 5d 29 3f 31 3a 30 29 3b 0a 23 65 6e 64 69 *4])?1:0);.#endi
15110 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 6d 61 78 4c f. }.. /* maxL
15120 6f 63 61 6c 20 69 73 20 74 68 65 20 6d 61 78 69 ocal is the maxi
15130 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61 mum amount of pa
15140 79 6c 6f 61 64 20 74 6f 20 73 74 6f 72 65 20 6c yload to store l
15150 6f 63 61 6c 6c 79 20 66 6f 72 0a 20 20 2a 2a 20 ocally for. **
15160 61 20 63 65 6c 6c 2e 20 20 4d 61 6b 65 20 73 75 a cell. Make su
15170 72 65 20 69 74 20 69 73 20 73 6d 61 6c 6c 20 65 re it is small e
15180 6e 6f 75 67 68 20 73 6f 20 74 68 61 74 20 61 74 nough so that at
15190 20 6c 65 61 73 74 20 6d 69 6e 46 61 6e 6f 75 74 least minFanout
151a0 0a 20 20 2a 2a 20 63 65 6c 6c 73 20 63 61 6e 20 . ** cells can
151b0 77 69 6c 6c 20 66 69 74 20 6f 6e 20 6f 6e 65 20 will fit on one
151c0 70 61 67 65 2e 20 20 57 65 20 61 73 73 75 6d 65 page. We assume
151d0 20 61 20 31 30 2d 62 79 74 65 20 70 61 67 65 20 a 10-byte page
151e0 68 65 61 64 65 72 2e 0a 20 20 2a 2a 20 42 65 73 header.. ** Bes
151f0 69 64 65 73 20 74 68 65 20 70 61 79 6c 6f 61 64 ides the payload
15200 2c 20 74 68 65 20 63 65 6c 6c 20 6d 75 73 74 20 , the cell must
15210 73 74 6f 72 65 3a 0a 20 20 2a 2a 20 20 20 20 20 store:. **
15220 32 2d 62 79 74 65 20 70 6f 69 6e 74 65 72 20 74 2-byte pointer t
15230 6f 20 74 68 65 20 63 65 6c 6c 0a 20 20 2a 2a 20 o the cell. **
15240 20 20 20 20 34 2d 62 79 74 65 20 63 68 69 6c 64 4-byte child
15250 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 20 20 pointer. **
15260 20 20 39 2d 62 79 74 65 20 6e 4b 65 79 20 76 61 9-byte nKey va
15270 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 lue. ** 4-b
15280 79 74 65 20 6e 44 61 74 61 20 76 61 6c 75 65 0a yte nData value.
15290 20 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 ** 4-byte
152a0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 70 6f overflow page po
152b0 69 6e 74 65 72 0a 20 20 2a 2a 20 53 6f 20 61 20 inter. ** So a
152c0 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 20 6f 66 cell consists of
152d0 20 61 20 32 2d 62 79 74 65 20 70 6f 69 6e 74 65 a 2-byte pointe
152e0 72 2c 20 61 20 68 65 61 64 65 72 20 77 68 69 63 r, a header whic
152f0 68 20 69 73 20 61 73 20 6d 75 63 68 20 61 73 0a h is as much as.
15300 20 20 2a 2a 20 31 37 20 62 79 74 65 73 20 6c 6f ** 17 bytes lo
15310 6e 67 2c 20 30 20 74 6f 20 4e 20 62 79 74 65 73 ng, 0 to N bytes
15320 20 6f 66 20 70 61 79 6c 6f 61 64 2c 20 61 6e 64 of payload, and
15330 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 34 20 62 an optional 4 b
15340 79 74 65 20 6f 76 65 72 66 6c 6f 77 0a 20 20 2a yte overflow. *
15350 2a 20 70 61 67 65 20 70 6f 69 6e 74 65 72 2e 0a * page pointer..
15360 20 20 2a 2f 0a 20 20 70 42 74 2d 3e 6d 61 78 4c */. pBt->maxL
15370 6f 63 61 6c 20 3d 20 28 75 31 36 29 28 28 70 42 ocal = (u16)((pB
15380 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 t->usableSize-12
15390 29 2a 36 34 2f 32 35 35 20 2d 20 32 33 29 3b 0a )*64/255 - 23);.
153a0 20 20 70 42 74 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 pBt->minLocal
153b0 3d 20 28 75 31 36 29 28 28 70 42 74 2d 3e 75 73 = (u16)((pBt->us
153c0 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a 33 32 2f ableSize-12)*32/
153d0 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 70 42 74 255 - 23);. pBt
153e0 2d 3e 6d 61 78 4c 65 61 66 20 3d 20 28 75 31 36 ->maxLeaf = (u16
153f0 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a )(pBt->usableSiz
15400 65 20 2d 20 33 35 29 3b 0a 20 20 70 42 74 2d 3e e - 35);. pBt->
15410 6d 69 6e 4c 65 61 66 20 3d 20 28 75 31 36 29 28 minLeaf = (u16)(
15420 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 (pBt->usableSize
15430 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d 20 32 33 -12)*32/255 - 23
15440 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 6d 61 );. if( pBt->ma
15450 78 4c 6f 63 61 6c 3e 31 32 37 20 29 7b 0a 20 20 xLocal>127 ){.
15460 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 pBt->max1byteP
15470 61 79 6c 6f 61 64 20 3d 20 31 32 37 3b 0a 20 20 ayload = 127;.
15480 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 2d 3e }else{. pBt->
15490 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 20 max1bytePayload
154a0 3d 20 28 75 38 29 70 42 74 2d 3e 6d 61 78 4c 6f = (u8)pBt->maxLo
154b0 63 61 6c 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 cal;. }. asser
154c0 74 28 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 t( pBt->maxLeaf
154d0 2b 20 32 33 20 3c 3d 20 4d 58 5f 43 45 4c 4c 5f + 23 <= MX_CELL_
154e0 53 49 5a 45 28 70 42 74 29 20 29 3b 0a 20 20 70 SIZE(pBt) );. p
154f0 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 70 50 61 Bt->pPage1 = pPa
15500 67 65 31 3b 0a 20 20 70 42 74 2d 3e 6e 50 61 67 ge1;. pBt->nPag
15510 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 72 65 74 e = nPage;. ret
15520 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a urn SQLITE_OK;..
15530 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 page1_init_faile
15540 64 3a 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 d:. releasePage
15550 28 70 50 61 67 65 31 29 3b 0a 20 20 70 42 74 2d (pPage1);. pBt-
15560 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 72 >pPage1 = 0;. r
15570 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 eturn rc;.}..#if
15580 6e 64 65 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a ndef NDEBUG./*.*
15590 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
155a0 62 65 72 20 6f 66 20 63 75 72 73 6f 72 73 20 6f ber of cursors o
155b0 70 65 6e 20 6f 6e 20 70 42 74 2e 20 54 68 69 73 pen on pBt. This
155c0 20 69 73 20 66 6f 72 20 75 73 65 0a 2a 2a 20 69 is for use.** i
155d0 6e 20 61 73 73 65 72 74 28 29 20 65 78 70 72 65 n assert() expre
155e0 73 73 69 6f 6e 73 2c 20 73 6f 20 69 74 20 69 73 ssions, so it is
155f0 20 6f 6e 6c 79 20 63 6f 6d 70 69 6c 65 64 20 69 only compiled i
15600 66 20 4e 44 45 42 55 47 20 69 73 20 6e 6f 74 0a f NDEBUG is not.
15610 2a 2a 20 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a 2a ** defined..**.*
15620 2a 20 4f 6e 6c 79 20 77 72 69 74 65 20 63 75 72 * Only write cur
15630 73 6f 72 73 20 61 72 65 20 63 6f 75 6e 74 65 64 sors are counted
15640 20 69 66 20 77 72 4f 6e 6c 79 20 69 73 20 74 72 if wrOnly is tr
15650 75 65 2e 20 20 49 66 20 77 72 4f 6e 6c 79 20 69 ue. If wrOnly i
15660 73 0a 2a 2a 20 66 61 6c 73 65 20 74 68 65 6e 20 s.** false then
15670 61 6c 6c 20 63 75 72 73 6f 72 73 20 61 72 65 20 all cursors are
15680 63 6f 75 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 46 counted..**.** F
15690 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 or the purposes
156a0 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2c of this routine,
156b0 20 61 20 63 75 72 73 6f 72 20 69 73 20 61 6e 79 a cursor is any
156c0 20 63 75 72 73 6f 72 20 74 68 61 74 0a 2a 2a 20 cursor that.**
156d0 69 73 20 63 61 70 61 62 6c 65 20 6f 66 20 72 65 is capable of re
156e0 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 ading or writing
156f0 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
15700 2e 20 20 43 75 72 73 6f 72 73 20 74 68 61 74 0a . Cursors that.
15710 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 74 72 69 ** have been tri
15720 70 70 65 64 20 69 6e 74 6f 20 74 68 65 20 43 55 pped into the CU
15730 52 53 4f 52 5f 46 41 55 4c 54 20 73 74 61 74 65 RSOR_FAULT state
15740 20 61 72 65 20 6e 6f 74 20 63 6f 75 6e 74 65 64 are not counted
15750 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
15760 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 countValidCursor
15770 73 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c s(BtShared *pBt,
15780 20 69 6e 74 20 77 72 4f 6e 6c 79 29 7b 0a 20 20 int wrOnly){.
15790 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a BtCursor *pCur;.
157a0 20 20 69 6e 74 20 72 20 3d 20 30 3b 0a 20 20 66 int r = 0;. f
157b0 6f 72 28 70 43 75 72 3d 70 42 74 2d 3e 70 43 75 or(pCur=pBt->pCu
157c0 72 73 6f 72 3b 20 70 43 75 72 3b 20 70 43 75 72 rsor; pCur; pCur
157d0 3d 70 43 75 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 =pCur->pNext){.
157e0 20 20 20 69 66 28 20 28 77 72 4f 6e 6c 79 3d 3d if( (wrOnly==
157f0 30 20 7c 7c 20 28 70 43 75 72 2d 3e 63 75 72 46 0 || (pCur->curF
15800 6c 61 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 lags & BTCF_Writ
15810 65 46 6c 61 67 29 21 3d 30 29 0a 20 20 20 20 20 eFlag)!=0).
15820 26 26 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 && pCur->eState!
15830 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 20 =CURSOR_FAULT )
15840 72 2b 2b 3b 20 0a 20 20 7d 0a 20 20 72 65 74 75 r++; . }. retu
15850 72 6e 20 72 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a rn r;.}.#endif..
15860 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 /*.** If there a
15870 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e re no outstandin
15880 67 20 63 75 72 73 6f 72 73 20 61 6e 64 20 77 65 g cursors and we
15890 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 are not in the
158a0 6d 69 64 64 6c 65 0a 2a 2a 20 6f 66 20 61 20 74 middle.** of a t
158b0 72 61 6e 73 61 63 74 69 6f 6e 20 62 75 74 20 74 ransaction but t
158c0 68 65 72 65 20 69 73 20 61 20 72 65 61 64 20 6c here is a read l
158d0 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 ock on the datab
158e0 61 73 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 ase, then.** thi
158f0 73 20 72 6f 75 74 69 6e 65 20 75 6e 72 65 66 73 s routine unrefs
15900 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 the first page
15910 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
15920 66 69 6c 65 20 77 68 69 63 68 20 0a 2a 2a 20 68 file which .** h
15930 61 73 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 as the effect of
15940 20 72 65 6c 65 61 73 69 6e 67 20 74 68 65 20 72 releasing the r
15950 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 ead lock..**.**
15960 49 66 20 74 68 65 72 65 20 69 73 20 61 20 74 72 If there is a tr
15970 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f ansaction in pro
15980 67 72 65 73 73 2c 20 74 68 69 73 20 72 6f 75 74 gress, this rout
15990 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a ine is a no-op..
159a0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 */.static void u
159b0 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 nlockBtreeIfUnus
159c0 65 64 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 ed(BtShared *pBt
159d0 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ){. assert( sql
159e0 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
159f0 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
15a00 20 61 73 73 65 72 74 28 20 63 6f 75 6e 74 56 61 assert( countVa
15a10 6c 69 64 43 75 72 73 6f 72 73 28 70 42 74 2c 30 lidCursors(pBt,0
15a20 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 )==0 || pBt->inT
15a30 72 61 6e 73 61 63 74 69 6f 6e 3e 54 52 41 4e 53 ransaction>TRANS
15a40 5f 4e 4f 4e 45 20 29 3b 0a 20 20 69 66 28 20 70 _NONE );. if( p
15a50 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
15a60 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 n==TRANS_NONE &&
15a70 20 70 42 74 2d 3e 70 50 61 67 65 31 21 3d 30 20 pBt->pPage1!=0
15a80 29 7b 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a ){. MemPage *
15a90 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 pPage1 = pBt->pP
15aa0 61 67 65 31 3b 0a 20 20 20 20 61 73 73 65 72 74 age1;. assert
15ab0 28 20 70 50 61 67 65 31 2d 3e 61 44 61 74 61 20 ( pPage1->aData
15ac0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
15ad0 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 6f qlite3PagerRefco
15ae0 75 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 29 unt(pBt->pPager)
15af0 3d 3d 31 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e ==1 );. pBt->
15b00 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 20 20 pPage1 = 0;.
15b10 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 releasePage(pPag
15b20 65 31 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a e1);. }.}../*.*
15b30 2a 20 49 66 20 70 42 74 20 70 6f 69 6e 74 73 20 * If pBt points
15b40 74 6f 20 61 6e 20 65 6d 70 74 79 20 66 69 6c 65 to an empty file
15b50 20 74 68 65 6e 20 63 6f 6e 76 65 72 74 20 74 68 then convert th
15b60 61 74 20 65 6d 70 74 79 20 66 69 6c 65 0a 2a 2a at empty file.**
15b70 20 69 6e 74 6f 20 61 20 6e 65 77 20 65 6d 70 74 into a new empt
15b80 79 20 64 61 74 61 62 61 73 65 20 62 79 20 69 6e y database by in
15b90 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 66 itializing the f
15ba0 69 72 73 74 20 70 61 67 65 20 6f 66 0a 2a 2a 20 irst page of.**
15bb0 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f the database..*/
15bc0 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 65 77 44 .static int newD
15bd0 61 74 61 62 61 73 65 28 42 74 53 68 61 72 65 64 atabase(BtShared
15be0 20 2a 70 42 74 29 7b 0a 20 20 4d 65 6d 50 61 67 *pBt){. MemPag
15bf0 65 20 2a 70 50 31 3b 0a 20 20 75 6e 73 69 67 6e e *pP1;. unsign
15c00 65 64 20 63 68 61 72 20 2a 64 61 74 61 3b 0a 20 ed char *data;.
15c10 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
15c20 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
15c30 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
15c40 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d x) );. if( pBt-
15c50 3e 6e 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 >nPage>0 ){.
15c60 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
15c70 3b 0a 20 20 7d 0a 20 20 70 50 31 20 3d 20 70 42 ;. }. pP1 = pB
15c80 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 61 73 73 t->pPage1;. ass
15c90 65 72 74 28 20 70 50 31 21 3d 30 20 29 3b 0a 20 ert( pP1!=0 );.
15ca0 20 64 61 74 61 20 3d 20 70 50 31 2d 3e 61 44 61 data = pP1->aDa
15cb0 74 61 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 ta;. rc = sqlit
15cc0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 31 e3PagerWrite(pP1
15cd0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 ->pDbPage);. if
15ce0 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
15cf0 3b 0a 20 20 6d 65 6d 63 70 79 28 64 61 74 61 2c ;. memcpy(data,
15d00 20 7a 4d 61 67 69 63 48 65 61 64 65 72 2c 20 73 zMagicHeader, s
15d10 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 61 64 izeof(zMagicHead
15d20 65 72 29 29 3b 0a 20 20 61 73 73 65 72 74 28 20 er));. assert(
15d30 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 61 sizeof(zMagicHea
15d40 64 65 72 29 3d 3d 31 36 20 29 3b 0a 20 20 64 61 der)==16 );. da
15d50 74 61 5b 31 36 5d 20 3d 20 28 75 38 29 28 28 70 ta[16] = (u8)((p
15d60 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 38 29 Bt->pageSize>>8)
15d70 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 &0xff);. data[1
15d80 37 5d 20 3d 20 28 75 38 29 28 28 70 42 74 2d 3e 7] = (u8)((pBt->
15d90 70 61 67 65 53 69 7a 65 3e 3e 31 36 29 26 30 78 pageSize>>16)&0x
15da0 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 38 5d 20 ff);. data[18]
15db0 3d 20 31 3b 0a 20 20 64 61 74 61 5b 31 39 5d 20 = 1;. data[19]
15dc0 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 = 1;. assert( p
15dd0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3c 3d Bt->usableSize<=
15de0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 26 26 pBt->pageSize &&
15df0 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
15e00 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 61 67 65 53 +255>=pBt->pageS
15e10 69 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 30 5d ize);. data[20]
15e20 20 3d 20 28 75 38 29 28 70 42 74 2d 3e 70 61 67 = (u8)(pBt->pag
15e30 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 61 eSize - pBt->usa
15e40 62 6c 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 bleSize);. data
15e50 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 20 64 61 74 [21] = 64;. dat
15e60 61 5b 32 32 5d 20 3d 20 33 32 3b 0a 20 20 64 61 a[22] = 32;. da
15e70 74 61 5b 32 33 5d 20 3d 20 33 32 3b 0a 20 20 6d ta[23] = 32;. m
15e80 65 6d 73 65 74 28 26 64 61 74 61 5b 32 34 5d 2c emset(&data[24],
15e90 20 30 2c 20 31 30 30 2d 32 34 29 3b 0a 20 20 7a 0, 100-24);. z
15ea0 65 72 6f 50 61 67 65 28 70 50 31 2c 20 50 54 46 eroPage(pP1, PTF
15eb0 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 _INTKEY|PTF_LEAF
15ec0 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 20 29 3b |PTF_LEAFDATA );
15ed0 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 . pBt->btsFlags
15ee0 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a 45 |= BTS_PAGESIZE
15ef0 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 20 _FIXED;.#ifndef
15f00 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
15f10 56 41 43 55 55 4d 0a 20 20 61 73 73 65 72 74 28 VACUUM. assert(
15f20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
15f30 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 61 75 74 6f ==1 || pBt->auto
15f40 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 61 Vacuum==0 );. a
15f50 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 63 72 ssert( pBt->incr
15f60 56 61 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 74 Vacuum==1 || pBt
15f70 2d 3e 69 6e 63 72 56 61 63 75 75 6d 3d 3d 30 20 ->incrVacuum==0
15f80 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 64 );. put4byte(&d
15f90 61 74 61 5b 33 36 20 2b 20 34 2a 34 5d 2c 20 70 ata[36 + 4*4], p
15fa0 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 3b Bt->autoVacuum);
15fb0 0a 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 . put4byte(&dat
15fc0 61 5b 33 36 20 2b 20 37 2a 34 5d 2c 20 70 42 74 a[36 + 7*4], pBt
15fd0 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 3b 0a 23 ->incrVacuum);.#
15fe0 65 6e 64 69 66 0a 20 20 70 42 74 2d 3e 6e 50 61 endif. pBt->nPa
15ff0 67 65 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 33 ge = 1;. data[3
16000 31 5d 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 1] = 1;. return
16010 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
16020 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 *.** Initialize
16030 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f the first page o
16040 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
16050 69 6c 65 20 28 63 72 65 61 74 69 6e 67 20 61 20 ile (creating a
16060 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 73 database.** cons
16070 69 73 74 69 6e 67 20 6f 66 20 61 20 73 69 6e 67 isting of a sing
16080 6c 65 20 70 61 67 65 20 61 6e 64 20 6e 6f 20 73 le page and no s
16090 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 29 2e 20 chema objects).
160a0 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b Return SQLITE_OK
160b0 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 66 75 .** if successfu
160c0 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 l, or an SQLite
160d0 65 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 error code other
160e0 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c wise..*/.int sql
160f0 69 74 65 33 42 74 72 65 65 4e 65 77 44 62 28 42 ite3BtreeNewDb(B
16100 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 tree *p){. int
16110 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 rc;. sqlite3Btr
16120 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 2d eeEnter(p);. p-
16130 3e 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 30 3b >pBt->nPage = 0;
16140 0a 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 . rc = newDatab
16150 61 73 65 28 70 2d 3e 70 42 74 29 3b 0a 20 20 73 ase(p->pBt);. s
16160 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
16170 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
16180 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d ;.}../*.** Attem
16190 70 74 20 74 6f 20 73 74 61 72 74 20 61 20 6e 65 pt to start a ne
161a0 77 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 41 w transaction. A
161b0 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
161c0 6f 6e 0a 2a 2a 20 69 73 20 73 74 61 72 74 65 64 on.** is started
161d0 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 if the second a
161e0 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 7a 65 rgument is nonze
161f0 72 6f 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20 ro, otherwise a
16200 72 65 61 64 2d 0a 2a 2a 20 74 72 61 6e 73 61 63 read-.** transac
16210 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 73 65 tion. If the se
16220 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 cond argument is
16230 20 32 20 6f 72 20 6d 6f 72 65 20 61 6e 64 20 65 2 or more and e
16240 78 63 6c 75 73 69 76 65 0a 2a 2a 20 74 72 61 6e xclusive.** tran
16250 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 saction is start
16260 65 64 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 ed, meaning that
16270 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 73 no other proces
16280 73 20 69 73 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 s is allowed.**
16290 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 61 to access the da
162a0 74 61 62 61 73 65 2e 20 20 41 20 70 72 65 65 78 tabase. A preex
162b0 69 73 74 69 6e 67 20 74 72 61 6e 73 61 63 74 69 isting transacti
162c0 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 0a 2a 2a on may not be.**
162d0 20 75 70 67 72 61 64 65 64 20 74 6f 20 65 78 63 upgraded to exc
162e0 6c 75 73 69 76 65 20 62 79 20 63 61 6c 6c 69 6e lusive by callin
162f0 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 61 g this routine a
16300 20 73 65 63 6f 6e 64 20 74 69 6d 65 20 2d 20 74 second time - t
16310 68 65 0a 2a 2a 20 65 78 63 6c 75 73 69 76 69 74 he.** exclusivit
16320 79 20 66 6c 61 67 20 6f 6e 6c 79 20 77 6f 72 6b y flag only work
16330 73 20 66 6f 72 20 61 20 6e 65 77 20 74 72 61 6e s for a new tran
16340 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 saction..**.** A
16350 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
16360 6f 6e 20 6d 75 73 74 20 62 65 20 73 74 61 72 74 on must be start
16370 65 64 20 62 65 66 6f 72 65 20 61 74 74 65 6d 70 ed before attemp
16380 74 69 6e 67 20 61 6e 79 20 0a 2a 2a 20 63 68 61 ting any .** cha
16390 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 74 61 nges to the data
163a0 62 61 73 65 2e 20 20 4e 6f 6e 65 20 6f 66 20 74 base. None of t
163b0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 he following rou
163c0 74 69 6e 65 73 20 0a 2a 2a 20 77 69 6c 6c 20 77 tines .** will w
163d0 6f 72 6b 20 75 6e 6c 65 73 73 20 61 20 74 72 61 ork unless a tra
163e0 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 72 nsaction is star
163f0 74 65 64 20 66 69 72 73 74 3a 0a 2a 2a 0a 2a 2a ted first:.**.**
16400 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
16410 65 65 43 72 65 61 74 65 54 61 62 6c 65 28 29 0a eeCreateTable().
16420 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
16430 74 72 65 65 43 72 65 61 74 65 49 6e 64 65 78 28 treeCreateIndex(
16440 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 ).** sqlite
16450 33 42 74 72 65 65 43 6c 65 61 72 54 61 62 6c 65 3BtreeClearTable
16460 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 ().** sqlit
16470 65 33 42 74 72 65 65 44 72 6f 70 54 61 62 6c 65 e3BtreeDropTable
16480 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 ().** sqlit
16490 65 33 42 74 72 65 65 49 6e 73 65 72 74 28 29 0a e3BtreeInsert().
164a0 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
164b0 74 72 65 65 44 65 6c 65 74 65 28 29 0a 2a 2a 20 treeDelete().**
164c0 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
164d0 65 55 70 64 61 74 65 4d 65 74 61 28 29 0a 2a 2a eUpdateMeta().**
164e0 0a 2a 2a 20 49 66 20 61 6e 20 69 6e 69 74 69 61 .** If an initia
164f0 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 61 63 71 l attempt to acq
16500 75 69 72 65 20 74 68 65 20 6c 6f 63 6b 20 66 61 uire the lock fa
16510 69 6c 73 20 62 65 63 61 75 73 65 20 6f 66 20 6c ils because of l
16520 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 0a 2a ock contention.*
16530 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 * and the databa
16540 73 65 20 77 61 73 20 70 72 65 76 69 6f 75 73 6c se was previousl
16550 79 20 75 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 6e y unlocked, then
16560 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 invoke the busy
16570 20 68 61 6e 64 6c 65 72 0a 2a 2a 20 69 66 20 74 handler.** if t
16580 68 65 72 65 20 69 73 20 6f 6e 65 2e 20 20 42 75 here is one. Bu
16590 74 20 69 66 20 74 68 65 72 65 20 77 61 73 20 70 t if there was p
165a0 72 65 76 69 6f 75 73 6c 79 20 61 20 72 65 61 64 reviously a read
165b0 2d 6c 6f 63 6b 2c 20 64 6f 20 6e 6f 74 0a 2a 2a -lock, do not.**
165c0 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 invoke the busy
165d0 20 68 61 6e 64 6c 65 72 20 2d 20 6a 75 73 74 20 handler - just
165e0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
165f0 53 59 2e 20 20 53 51 4c 49 54 45 5f 42 55 53 59 SY. SQLITE_BUSY
16600 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 64 is .** returned
16610 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 20 61 when there is a
16620 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d 6c 6f lready a read-lo
16630 63 6b 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 ck in order to a
16640 76 6f 69 64 20 61 20 64 65 61 64 6c 6f 63 6b 2e void a deadlock.
16650 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20 74 .**.** Suppose t
16660 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 72 6f here are two pro
16670 63 65 73 73 65 73 20 41 20 61 6e 64 20 42 2e 20 cesses A and B.
16680 20 41 20 68 61 73 20 61 20 72 65 61 64 20 6c 6f A has a read lo
16690 63 6b 20 61 6e 64 20 42 20 68 61 73 0a 2a 2a 20 ck and B has.**
166a0 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b 2e a reserved lock.
166b0 20 20 42 20 74 72 69 65 73 20 74 6f 20 70 72 6f B tries to pro
166c0 6d 6f 74 65 20 74 6f 20 65 78 63 6c 75 73 69 76 mote to exclusiv
166d0 65 20 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 e but is blocked
166e0 20 62 65 63 61 75 73 65 0a 2a 2a 20 6f 66 20 41 because.** of A
166f0 27 73 20 72 65 61 64 20 6c 6f 63 6b 2e 20 20 41 's read lock. A
16700 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 tries to promot
16710 65 20 74 6f 20 72 65 73 65 72 76 65 64 20 62 75 e to reserved bu
16720 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 79 20 t is blocked by
16730 42 2e 0a 2a 2a 20 4f 6e 65 20 6f 72 20 74 68 65 B..** One or the
16740 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 74 77 other of the tw
16750 6f 20 70 72 6f 63 65 73 73 65 73 20 6d 75 73 74 o processes must
16760 20 67 69 76 65 20 77 61 79 20 6f 72 20 74 68 65 give way or the
16770 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 6e 6f 20 re can be.** no
16780 70 72 6f 67 72 65 73 73 2e 20 20 42 79 20 72 65 progress. By re
16790 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f 42 turning SQLITE_B
167a0 55 53 59 20 61 6e 64 20 6e 6f 74 20 69 6e 76 6f USY and not invo
167b0 6b 69 6e 67 20 74 68 65 20 62 75 73 79 20 63 61 king the busy ca
167c0 6c 6c 62 61 63 6b 0a 2a 2a 20 77 68 65 6e 20 41 llback.** when A
167d0 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 72 already has a r
167e0 65 61 64 20 6c 6f 63 6b 2c 20 77 65 20 65 6e 63 ead lock, we enc
167f0 6f 75 72 61 67 65 20 41 20 74 6f 20 67 69 76 65 ourage A to give
16800 20 75 70 20 61 6e 64 20 6c 65 74 20 42 0a 2a 2a up and let B.**
16810 20 70 72 6f 63 65 65 64 2e 0a 2a 2f 0a 69 6e 74 proceed..*/.int
16820 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 sqlite3BtreeBeg
16830 69 6e 54 72 61 6e 73 28 42 74 72 65 65 20 2a 70 inTrans(Btree *p
16840 2c 20 69 6e 74 20 77 72 66 6c 61 67 29 7b 0a 20 , int wrflag){.
16850 20 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b sqlite3 *pBlock
16860 20 3d 20 30 3b 0a 20 20 42 74 53 68 61 72 65 64 = 0;. BtShared
16870 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
16880 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
16890 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c 69 74 65 33 E_OK;.. sqlite3
168a0 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
168b0 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 btreeIntegrity(
168c0 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 p);.. /* If the
168d0 20 62 74 72 65 65 20 69 73 20 61 6c 72 65 61 64 btree is alread
168e0 79 20 69 6e 20 61 20 77 72 69 74 65 2d 74 72 61 y in a write-tra
168f0 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 20 69 74 0a nsaction, or it.
16900 20 20 2a 2a 20 69 73 20 61 6c 72 65 61 64 79 20 ** is already
16910 69 6e 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 in a read-transa
16920 63 74 69 6f 6e 20 61 6e 64 20 61 20 72 65 61 64 ction and a read
16930 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a -transaction. *
16940 2a 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 * is requested,
16950 74 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e this is a no-op.
16960 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 . */. if( p->i
16970 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 nTrans==TRANS_WR
16980 49 54 45 20 7c 7c 20 28 70 2d 3e 69 6e 54 72 61 ITE || (p->inTra
16990 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 41 44 20 26 ns==TRANS_READ &
169a0 26 20 21 77 72 66 6c 61 67 29 20 29 7b 0a 20 20 & !wrflag) ){.
169b0 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 goto trans_beg
169c0 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 un;. }. assert
169d0 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 ( pBt->inTransac
169e0 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 tion==TRANS_WRIT
169f0 45 20 7c 7c 20 49 66 4e 6f 74 4f 6d 69 74 41 56 E || IfNotOmitAV
16a00 28 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 (pBt->bDoTruncat
16a10 65 29 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 57 e)==0 );.. /* W
16a20 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
16a30 73 20 61 72 65 20 6e 6f 74 20 70 6f 73 73 69 62 s are not possib
16a40 6c 65 20 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c le on a read-onl
16a50 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 y database */.
16a60 69 66 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 if( (pBt->btsFla
16a70 67 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e gs & BTS_READ_ON
16a80 4c 59 29 21 3d 30 20 26 26 20 77 72 66 6c 61 67 LY)!=0 && wrflag
16a90 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
16aa0 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 ITE_READONLY;.
16ab0 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 goto trans_beg
16ac0 75 6e 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 un;. }..#ifndef
16ad0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
16ae0 52 45 44 5f 43 41 43 48 45 0a 20 20 2f 2a 20 49 RED_CACHE. /* I
16af0 66 20 61 6e 6f 74 68 65 72 20 64 61 74 61 62 61 f another databa
16b00 73 65 20 68 61 6e 64 6c 65 20 68 61 73 20 61 6c se handle has al
16b10 72 65 61 64 79 20 6f 70 65 6e 65 64 20 61 20 77 ready opened a w
16b20 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
16b30 20 0a 20 20 2a 2a 20 6f 6e 20 74 68 69 73 20 73 . ** on this s
16b40 68 61 72 65 64 2d 62 74 72 65 65 20 73 74 72 75 hared-btree stru
16b50 63 74 75 72 65 20 61 6e 64 20 61 20 73 65 63 6f cture and a seco
16b60 6e 64 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 nd write transac
16b70 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 72 65 71 tion is. ** req
16b80 75 65 73 74 65 64 2c 20 72 65 74 75 72 6e 20 53 uested, return S
16b90 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 QLITE_LOCKED..
16ba0 2a 2f 0a 20 20 69 66 28 20 28 77 72 66 6c 61 67 */. if( (wrflag
16bb0 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 && pBt->inTrans
16bc0 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
16bd0 49 54 45 29 0a 20 20 20 7c 7c 20 28 70 42 74 2d ITE). || (pBt-
16be0 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
16bf0 50 45 4e 44 49 4e 47 29 21 3d 30 0a 20 20 29 7b PENDING)!=0. ){
16c00 0a 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 . pBlock = pB
16c10 74 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a t->pWriter->db;.
16c20 20 20 7d 65 6c 73 65 20 69 66 28 20 77 72 66 6c }else if( wrfl
16c30 61 67 3e 31 20 29 7b 0a 20 20 20 20 42 74 4c 6f ag>1 ){. BtLo
16c40 63 6b 20 2a 70 49 74 65 72 3b 0a 20 20 20 20 66 ck *pIter;. f
16c50 6f 72 28 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c or(pIter=pBt->pL
16c60 6f 63 6b 3b 20 70 49 74 65 72 3b 20 70 49 74 65 ock; pIter; pIte
16c70 72 3d 70 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b r=pIter->pNext){
16c80 0a 20 20 20 20 20 20 69 66 28 20 70 49 74 65 72 . if( pIter
16c90 2d 3e 70 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 ->pBtree!=p ){.
16ca0 20 20 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 pBlock =
16cb0 70 49 74 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 pIter->pBtree->d
16cc0 62 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b b;. break
16cd0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
16ce0 20 20 7d 0a 20 20 69 66 28 20 70 42 6c 6f 63 6b }. if( pBlock
16cf0 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 ){. sqlite3C
16d00 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 onnectionBlocked
16d10 28 70 2d 3e 64 62 2c 20 70 42 6c 6f 63 6b 29 3b (p->db, pBlock);
16d20 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
16d30 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 _LOCKED_SHAREDCA
16d40 43 48 45 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 CHE;. goto tr
16d50 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 23 ans_begun;. }.#
16d60 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 endif.. /* Any
16d70 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 read-only or rea
16d80 64 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 d-write transact
16d90 69 6f 6e 20 69 6d 70 6c 69 65 73 20 61 20 72 65 ion implies a re
16da0 61 64 2d 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a ad-lock on . **
16db0 20 70 61 67 65 20 31 2e 20 53 6f 20 69 66 20 73 page 1. So if s
16dc0 6f 6d 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 ome other shared
16dd0 2d 63 61 63 68 65 20 63 6c 69 65 6e 74 20 61 6c -cache client al
16de0 72 65 61 64 79 20 68 61 73 20 61 20 77 72 69 74 ready has a writ
16df0 65 2d 6c 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 e-lock . ** on
16e00 70 61 67 65 20 31 2c 20 74 68 65 20 74 72 61 6e page 1, the tran
16e10 73 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 saction cannot b
16e20 65 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 e opened. */. r
16e30 63 20 3d 20 71 75 65 72 79 53 68 61 72 65 64 43 c = querySharedC
16e40 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c acheTableLock(p,
16e50 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 MASTER_ROOT, RE
16e60 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 AD_LOCK);. if(
16e70 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 SQLITE_OK!=rc )
16e80 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e goto trans_begun
16e90 3b 0a 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 ;.. pBt->btsFla
16ea0 67 73 20 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 gs &= ~BTS_INITI
16eb0 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 ALLY_EMPTY;. if
16ec0 28 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 ( pBt->nPage==0
16ed0 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ) pBt->btsFlags
16ee0 7c 3d 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 |= BTS_INITIALLY
16ef0 5f 45 4d 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 _EMPTY;. do {.
16f00 20 20 20 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 /* Call lockB
16f10 74 72 65 65 28 29 20 75 6e 74 69 6c 20 65 69 74 tree() until eit
16f20 68 65 72 20 70 42 74 2d 3e 70 50 61 67 65 31 20 her pBt->pPage1
16f30 69 73 20 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a is populated or.
16f40 20 20 20 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 ** lockBtree
16f50 28 29 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 () returns somet
16f60 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 hing other than
16f70 53 51 4c 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 SQLITE_OK. lockB
16f80 74 72 65 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 tree(). ** ma
16f90 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f y return SQLITE_
16fa0 4f 4b 20 62 75 74 20 6c 65 61 76 65 20 70 42 74 OK but leave pBt
16fb0 2d 3e 70 50 61 67 65 31 20 73 65 74 20 74 6f 20 ->pPage1 set to
16fc0 30 20 69 66 20 61 66 74 65 72 0a 20 20 20 20 2a 0 if after. *
16fd0 2a 20 72 65 61 64 69 6e 67 20 70 61 67 65 20 31 * reading page 1
16fe0 20 69 74 20 64 69 73 63 6f 76 65 72 73 20 74 68 it discovers th
16ff0 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 at the page-size
17000 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
17010 20 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 . ** file is
17020 20 6e 6f 74 20 70 42 74 2d 3e 70 61 67 65 53 69 not pBt->pageSi
17030 7a 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ze. In this case
17040 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 77 69 6c lockBtree() wil
17050 6c 20 75 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 l update. **
17060 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f pBt->pageSize to
17070 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f the page-size o
17080 66 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 f the file on di
17090 73 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 sk.. */. w
170a0 68 69 6c 65 28 20 70 42 74 2d 3e 70 50 61 67 65 hile( pBt->pPage
170b0 31 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 1==0 && SQLITE_O
170c0 4b 3d 3d 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 K==(rc = lockBtr
170d0 65 65 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 ee(pBt)) );..
170e0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
170f0 4f 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a OK && wrflag ){.
17100 20 20 20 20 20 20 69 66 28 20 28 70 42 74 2d 3e if( (pBt->
17110 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 btsFlags & BTS_R
17120 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a EAD_ONLY)!=0 ){.
17130 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
17140 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 ITE_READONLY;.
17150 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
17160 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
17170 61 67 65 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 agerBegin(pBt->p
17180 50 61 67 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 Pager,wrflag>1,s
17190 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f qlite3TempInMemo
171a0 72 79 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 ry(p->db));.
171b0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
171c0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
171d0 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 rc = newDatab
171e0 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 ase(pBt);.
171f0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
17200 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 72 63 21 }. . if( rc!
17210 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
17220 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 unlockBtreeI
17230 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 fUnused(pBt);.
17240 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 }. }while( (r
17250 63 26 30 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f c&0xFF)==SQLITE_
17260 42 55 53 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 BUSY && pBt->inT
17270 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
17280 53 5f 4e 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 S_NONE &&.
17290 20 20 20 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 btreeInvokeB
172a0 75 73 79 48 61 6e 64 6c 65 72 28 70 42 74 29 20 usyHandler(pBt)
172b0 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );.. if( rc==SQ
172c0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
172d0 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
172e0 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 RANS_NONE ){.
172f0 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 pBt->nTransac
17300 74 69 6f 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 tion++;.#ifndef
17310 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
17320 45 44 5f 43 41 43 48 45 0a 20 20 20 20 20 20 69 ED_CACHE. i
17330 66 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 f( p->sharable )
17340 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
17350 28 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 ( p->lock.pBtree
17360 3d 3d 70 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 ==p && p->lock.i
17370 54 61 62 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 20 Table==1 );.
17380 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 p->lock.eLoc
17390 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 k = READ_LOCK;.
173a0 20 20 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 p->lock.p
173b0 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 Next = pBt->pLoc
173c0 6b 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e k;. pBt->
173d0 70 4c 6f 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b pLock = &p->lock
173e0 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 ;. }.#endif
173f0 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 6e . }. p->in
17400 54 72 61 6e 73 20 3d 20 28 77 72 66 6c 61 67 3f Trans = (wrflag?
17410 54 52 41 4e 53 5f 57 52 49 54 45 3a 54 52 41 4e TRANS_WRITE:TRAN
17420 53 5f 52 45 41 44 29 3b 0a 20 20 20 20 69 66 28 S_READ);. if(
17430 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 70 42 74 2d p->inTrans>pBt-
17440 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 >inTransaction )
17450 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 {. pBt->inT
17460 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 70 2d 3e ransaction = p->
17470 69 6e 54 72 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 inTrans;. }.
17480 20 20 20 69 66 28 20 77 72 66 6c 61 67 20 29 7b if( wrflag ){
17490 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a . MemPage *
174a0 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 pPage1 = pBt->pP
174b0 61 67 65 31 3b 0a 23 69 66 6e 64 65 66 20 53 51 age1;.#ifndef SQ
174c0 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
174d0 5f 43 41 43 48 45 0a 20 20 20 20 20 20 61 73 73 _CACHE. ass
174e0 65 72 74 28 20 21 70 42 74 2d 3e 70 57 72 69 74 ert( !pBt->pWrit
174f0 65 72 20 29 3b 0a 20 20 20 20 20 20 70 42 74 2d er );. pBt-
17500 3e 70 57 72 69 74 65 72 20 3d 20 70 3b 0a 20 20 >pWriter = p;.
17510 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
17520 73 20 26 3d 20 7e 42 54 53 5f 45 58 43 4c 55 53 s &= ~BTS_EXCLUS
17530 49 56 45 3b 0a 20 20 20 20 20 20 69 66 28 20 77 IVE;. if( w
17540 72 66 6c 61 67 3e 31 20 29 20 70 42 74 2d 3e 62 rflag>1 ) pBt->b
17550 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 45 tsFlags |= BTS_E
17560 58 43 4c 55 53 49 56 45 3b 0a 23 65 6e 64 69 66 XCLUSIVE;.#endif
17570 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 .. /* If th
17580 65 20 64 62 2d 73 69 7a 65 20 68 65 61 64 65 72 e db-size header
17590 20 66 69 65 6c 64 20 69 73 20 69 6e 63 6f 72 72 field is incorr
175a0 65 63 74 20 28 61 73 20 69 74 20 6d 61 79 20 62 ect (as it may b
175b0 65 20 69 66 20 61 6e 20 6f 6c 64 0a 20 20 20 20 e if an old.
175c0 20 20 2a 2a 20 63 6c 69 65 6e 74 20 68 61 73 20 ** client has
175d0 62 65 65 6e 20 77 72 69 74 69 6e 67 20 74 68 65 been writing the
175e0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 2c database file),
175f0 20 75 70 64 61 74 65 20 69 74 20 6e 6f 77 2e 20 update it now.
17600 44 6f 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 74 Doing. ** t
17610 68 69 73 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 his sooner rathe
17620 72 20 74 68 61 6e 20 6c 61 74 65 72 20 6d 65 61 r than later mea
17630 6e 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ns the database
17640 73 69 7a 65 20 63 61 6e 20 73 61 66 65 6c 79 20 size can safely
17650 0a 20 20 20 20 20 20 2a 2a 20 72 65 2d 72 65 61 . ** re-rea
17660 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 d the database s
17670 69 7a 65 20 66 72 6f 6d 20 70 61 67 65 20 31 20 ize from page 1
17680 69 66 20 61 20 73 61 76 65 70 6f 69 6e 74 20 6f if a savepoint o
17690 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 r transaction.
176a0 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 ** rollback
176b0 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 occurs within th
176c0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 e transaction..
176d0 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 */. if
176e0 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 67 65 ( pBt->nPage!=ge
176f0 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
17700 61 44 61 74 61 5b 32 38 5d 29 20 29 7b 0a 20 20 aData[28]) ){.
17710 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
17720 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 e3PagerWrite(pPa
17730 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
17740 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 if( rc==S
17750 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
17760 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 put4byte(&
17770 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 pPage1->aData[28
17780 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a ], pBt->nPage);.
17790 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
177a0 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 }. }. }...tr
177b0 61 6e 73 5f 62 65 67 75 6e 3a 0a 20 20 69 66 28 ans_begun:. if(
177c0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
177d0 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 20 & wrflag ){.
177e0 2f 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 61 6b /* This call mak
177f0 65 73 20 73 75 72 65 20 74 68 61 74 20 74 68 65 es sure that the
17800 20 70 61 67 65 72 20 68 61 73 20 74 68 65 20 63 pager has the c
17810 6f 72 72 65 63 74 20 6e 75 6d 62 65 72 20 6f 66 orrect number of
17820 0a 20 20 20 20 2a 2a 20 6f 70 65 6e 20 73 61 76 . ** open sav
17830 65 70 6f 69 6e 74 73 2e 20 49 66 20 74 68 65 20 epoints. If the
17840 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 second parameter
17850 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
17860 20 30 20 61 6e 64 0a 20 20 20 20 2a 2a 20 74 68 0 and. ** th
17870 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 e sub-journal is
17880 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 not already ope
17890 6e 2c 20 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 n, then it will
178a0 62 65 20 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a be opened here..
178b0 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 */. rc =
178c0 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e sqlite3PagerOpen
178d0 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 Savepoint(pBt->p
178e0 50 61 67 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 Pager, p->db->nS
178f0 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a avepoint);. }..
17900 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 btreeIntegrity
17910 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 (p);. sqlite3Bt
17920 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
17930 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 eturn rc;.}..#if
17940 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
17950 5f 41 55 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a _AUTOVACUUM../*.
17960 2a 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e 74 ** Set the point
17970 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 20 66 er-map entries f
17980 6f 72 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 or all children
17990 6f 66 20 70 61 67 65 20 70 50 61 67 65 2e 20 41 of page pPage. A
179a0 6c 73 6f 2c 20 69 66 0a 2a 2a 20 70 50 61 67 65 lso, if.** pPage
179b0 20 63 6f 6e 74 61 69 6e 73 20 63 65 6c 6c 73 20 contains cells
179c0 74 68 61 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 that point to ov
179d0 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 73 65 erflow pages, se
179e0 74 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a t the pointer.**
179f0 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 map entries for
17a00 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
17a10 67 65 73 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a ges as well..*/.
17a20 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 43 68 static int setCh
17a30 69 6c 64 50 74 72 6d 61 70 73 28 4d 65 6d 50 61 ildPtrmaps(MemPa
17a40 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
17a50 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
17a60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17a70 20 2f 2a 20 43 6f 75 6e 74 65 72 20 76 61 72 69 /* Counter vari
17a80 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 able */. int nC
17a90 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
17aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
17ab0 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 Number of cells
17ac0 69 6e 20 70 61 67 65 20 70 50 61 67 65 20 2a 2f in page pPage */
17ad0 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
17ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17af0 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
17b00 63 6f 64 65 20 2a 2f 0a 20 20 42 74 53 68 61 72 code */. BtShar
17b10 65 64 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d ed *pBt = pPage-
17b20 3e 70 42 74 3b 0a 20 20 75 38 20 69 73 49 6e 69 >pBt;. u8 isIni
17b30 74 4f 72 69 67 20 3d 20 70 50 61 67 65 2d 3e 69 tOrig = pPage->i
17b40 73 49 6e 69 74 3b 0a 20 20 50 67 6e 6f 20 70 67 sInit;. Pgno pg
17b50 6e 6f 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f no = pPage->pgno
17b60 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
17b70 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
17b80 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
17b90 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 x) );. rc = btr
17ba0 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 eeInitPage(pPage
17bb0 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
17bc0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f ITE_OK ){. go
17bd0 74 6f 20 73 65 74 5f 63 68 69 6c 64 5f 70 74 72 to set_child_ptr
17be0 6d 61 70 73 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 maps_out;. }.
17bf0 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e nCell = pPage->n
17c00 43 65 6c 6c 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 Cell;.. for(i=0
17c10 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b ; i<nCell; i++){
17c20 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d . u8 *pCell =
17c30 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c findCell(pPage,
17c40 20 69 29 3b 0a 0a 20 20 20 20 70 74 72 6d 61 70 i);.. ptrmap
17c50 50 75 74 4f 76 66 6c 50 74 72 28 70 50 61 67 65 PutOvflPtr(pPage
17c60 2c 20 70 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a , pCell, &rc);..
17c70 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e if( !pPage->
17c80 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 50 67 leaf ){. Pg
17c90 6e 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 no childPgno = g
17ca0 65 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a et4byte(pCell);.
17cb0 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 ptrmapPut(
17cc0 70 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 pBt, childPgno,
17cd0 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 PTRMAP_BTREE, pg
17ce0 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a no, &rc);. }.
17cf0 20 20 7d 0a 0a 20 20 69 66 28 20 21 70 50 61 67 }.. if( !pPag
17d00 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 e->leaf ){. P
17d10 67 6e 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 gno childPgno =
17d20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d get4byte(&pPage-
17d30 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 >aData[pPage->hd
17d40 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 rOffset+8]);.
17d50 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 ptrmapPut(pBt,
17d60 63 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 childPgno, PTRMA
17d70 50 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 P_BTREE, pgno, &
17d80 72 63 29 3b 0a 20 20 7d 0a 0a 73 65 74 5f 63 68 rc);. }..set_ch
17d90 69 6c 64 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3a ild_ptrmaps_out:
17da0 0a 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 . pPage->isInit
17db0 20 3d 20 69 73 49 6e 69 74 4f 72 69 67 3b 0a 20 = isInitOrig;.
17dc0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
17dd0 2a 0a 2a 2a 20 53 6f 6d 65 77 68 65 72 65 20 6f *.** Somewhere o
17de0 6e 20 70 50 61 67 65 20 69 73 20 61 20 70 6f 69 n pPage is a poi
17df0 6e 74 65 72 20 74 6f 20 70 61 67 65 20 69 46 72 nter to page iFr
17e00 6f 6d 2e 20 20 4d 6f 64 69 66 79 20 74 68 69 73 om. Modify this
17e10 20 70 6f 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 74 pointer so.** t
17e20 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 6f hat it points to
17e30 20 69 54 6f 2e 20 50 61 72 61 6d 65 74 65 72 20 iTo. Parameter
17e40 65 54 79 70 65 20 64 65 73 63 72 69 62 65 73 20 eType describes
17e50 74 68 65 20 74 79 70 65 20 6f 66 20 70 6f 69 6e the type of poin
17e60 74 65 72 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f 64 ter to.** be mod
17e70 69 66 69 65 64 2c 20 61 73 20 20 66 6f 6c 6c 6f ified, as follo
17e80 77 73 3a 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 ws:.**.** PTRMAP
17e90 5f 42 54 52 45 45 3a 20 20 20 20 20 70 50 61 67 _BTREE: pPag
17ea0 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 67 e is a btree-pag
17eb0 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 e. The pointer p
17ec0 6f 69 6e 74 73 20 61 74 20 61 20 63 68 69 6c 64 oints at a child
17ed0 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 .**
17ee0 20 20 20 20 20 20 20 70 61 67 65 20 6f 66 20 70 page of p
17ef0 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d Page..**.** PTRM
17f00 41 50 5f 4f 56 45 52 46 4c 4f 57 31 3a 20 70 50 AP_OVERFLOW1: pP
17f10 61 67 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 age is a btree-p
17f20 61 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 age. The pointer
17f30 20 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 6f 76 points at an ov
17f40 65 72 66 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 20 erflow.**
17f50 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 page
17f60 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 6f pointed to by o
17f70 6e 65 20 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 ne of the cells
17f80 6f 6e 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 on pPage..**.**
17f90 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
17fa0 3a 20 70 50 61 67 65 20 69 73 20 61 6e 20 6f 76 : pPage is an ov
17fb0 65 72 66 6c 6f 77 2d 70 61 67 65 2e 20 54 68 65 erflow-page. The
17fc0 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 pointer points
17fd0 61 74 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 20 at the next.**
17fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17ff0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 overflow page i
18000 6e 20 74 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 n the list..*/.s
18010 74 61 74 69 63 20 69 6e 74 20 6d 6f 64 69 66 79 tatic int modify
18020 50 61 67 65 50 6f 69 6e 74 65 72 28 4d 65 6d 50 PagePointer(MemP
18030 61 67 65 20 2a 70 50 61 67 65 2c 20 50 67 6e 6f age *pPage, Pgno
18040 20 69 46 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 6f iFrom, Pgno iTo
18050 2c 20 75 38 20 65 54 79 70 65 29 7b 0a 20 20 61 , u8 eType){. a
18060 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
18070 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
18080 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
18090 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
180a0 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
180b0 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
180c0 29 20 29 3b 0a 20 20 69 66 28 20 65 54 79 70 65 ) );. if( eType
180d0 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f ==PTRMAP_OVERFLO
180e0 57 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 W2 ){. /* The
180f0 20 70 6f 69 6e 74 65 72 20 69 73 20 61 6c 77 61 pointer is alwa
18100 79 73 20 74 68 65 20 66 69 72 73 74 20 34 20 62 ys the first 4 b
18110 79 74 65 73 20 6f 66 20 74 68 65 20 70 61 67 65 ytes of the page
18120 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 in this case.
18130 2a 2f 0a 20 20 20 20 69 66 28 20 67 65 74 34 62 */. if( get4b
18140 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 yte(pPage->aData
18150 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 )!=iFrom ){.
18160 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
18170 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
18180 20 20 7d 0a 20 20 20 20 70 75 74 34 62 79 74 65 }. put4byte
18190 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 (pPage->aData, i
181a0 54 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 To);. }else{.
181b0 20 20 75 38 20 69 73 49 6e 69 74 4f 72 69 67 20 u8 isInitOrig
181c0 3d 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 3b = pPage->isInit;
181d0 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 . int i;.
181e0 69 6e 74 20 6e 43 65 6c 6c 3b 0a 0a 20 20 20 20 int nCell;..
181f0 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 btreeInitPage(pP
18200 61 67 65 29 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 age);. nCell
18210 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a = pPage->nCell;.
18220 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c . for(i=0; i<
18230 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 nCell; i++){.
18240 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 u8 *pCell = f
18250 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 indCell(pPage, i
18260 29 3b 0a 20 20 20 20 20 20 69 66 28 20 65 54 79 );. if( eTy
18270 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 pe==PTRMAP_OVERF
18280 4c 4f 57 31 20 29 7b 0a 20 20 20 20 20 20 20 20 LOW1 ){.
18290 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 CellInfo info;.
182a0 20 20 20 20 20 20 20 62 74 72 65 65 50 61 72 73 btreePars
182b0 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 eCellPtr(pPage,
182c0 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 pCell, &info);.
182d0 20 20 20 20 20 20 20 69 66 28 20 69 6e 66 6f 2e if( info.
182e0 69 4f 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 iOverflow.
182f0 20 20 20 26 26 20 70 43 65 6c 6c 2b 69 6e 66 6f && pCell+info
18300 2e 69 4f 76 65 72 66 6c 6f 77 2b 33 3c 3d 70 50 .iOverflow+3<=pP
18310 61 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 age->aData+pPage
18320 2d 3e 6d 61 73 6b 50 61 67 65 0a 20 20 20 20 20 ->maskPage.
18330 20 20 20 20 26 26 20 69 46 72 6f 6d 3d 3d 67 65 && iFrom==ge
18340 74 34 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e t4byte(&pCell[in
18350 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d 29 0a 20 fo.iOverflow]).
18360 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 ){.
18370 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 43 put4byte(&pC
18380 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c ell[info.iOverfl
18390 6f 77 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 ow], iTo);.
183a0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
183b0 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 }. }els
183c0 65 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 67 e{. if( g
183d0 65 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3d 3d et4byte(pCell)==
183e0 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 iFrom ){.
183f0 20 20 20 70 75 74 34 62 79 74 65 28 70 43 65 6c put4byte(pCel
18400 6c 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 l, iTo);.
18410 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
18420 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
18430 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 69 3d 3d }. . if( i==
18440 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 69 nCell ){. i
18450 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 f( eType!=PTRMAP
18460 5f 42 54 52 45 45 20 7c 7c 20 0a 20 20 20 20 20 _BTREE || .
18470 20 20 20 20 20 67 65 74 34 62 79 74 65 28 26 70 get4byte(&p
18480 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
18490 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
184a0 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 !=iFrom ){.
184b0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
184c0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
184d0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 75 74 }. put
184e0 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 4byte(&pPage->aD
184f0 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 ata[pPage->hdrOf
18500 66 73 65 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 fset+8], iTo);.
18510 20 20 20 7d 0a 0a 20 20 20 20 70 50 61 67 65 2d }.. pPage-
18520 3e 69 73 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 >isInit = isInit
18530 4f 72 69 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 Orig;. }. retu
18540 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
18550 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
18560 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 70 open database p
18570 61 67 65 20 70 44 62 50 61 67 65 20 74 6f 20 6c age pDbPage to l
18580 6f 63 61 74 69 6f 6e 20 69 46 72 65 65 50 61 67 ocation iFreePag
18590 65 20 69 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 e in the .** dat
185a0 61 62 61 73 65 2e 20 54 68 65 20 70 44 62 50 61 abase. The pDbPa
185b0 67 65 20 72 65 66 65 72 65 6e 63 65 20 72 65 6d ge reference rem
185c0 61 69 6e 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a ains valid..**.*
185d0 2a 20 54 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 * The isCommit f
185e0 6c 61 67 20 69 6e 64 69 63 61 74 65 73 20 74 68 lag indicates th
185f0 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e at there is no n
18600 65 65 64 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 eed to remember
18610 74 68 61 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 that.** the jour
18620 6e 61 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 20 nal needs to be
18630 73 79 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 sync()ed before
18640 64 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 database page pD
18650 62 50 61 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 bPage->pgno .**
18660 63 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 74 can be written t
18670 6f 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 68 61 o. The caller ha
18680 73 20 61 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 s already promis
18690 65 64 20 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 ed not to write
186a0 74 6f 20 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e to that.** page.
186b0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 .*/.static int r
186c0 65 6c 6f 63 61 74 65 50 61 67 65 28 0a 20 20 42 elocatePage(. B
186d0 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 tShared *pBt,
186e0 20 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 65 /* Btree
186f0 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 */. MemPage *p
18700 44 62 50 61 67 65 2c 20 20 20 20 20 20 20 20 2f DbPage, /
18710 2a 20 4f 70 65 6e 20 70 61 67 65 20 74 6f 20 6d * Open page to m
18720 6f 76 65 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 ove */. u8 eTyp
18730 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
18740 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 /* Pointer map
18750 20 27 74 79 70 65 27 20 65 6e 74 72 79 20 66 6f 'type' entry fo
18760 72 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 r pDbPage */. P
18770 67 6e 6f 20 69 50 74 72 50 61 67 65 2c 20 20 20 gno iPtrPage,
18780 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
18790 65 72 20 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 er map 'page-no'
187a0 20 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 61 entry for pDbPa
187b0 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 ge */. Pgno iFr
187c0 65 65 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 eePage,
187d0 20 2f 2a 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e /* The location
187e0 20 74 6f 20 6d 6f 76 65 20 70 44 62 50 61 67 65 to move pDbPage
187f0 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 to */. int isC
18800 6f 6d 6d 69 74 20 20 20 20 20 20 20 20 20 20 20 ommit
18810 20 20 2f 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c /* isCommit fl
18820 61 67 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c ag passed to sql
18830 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 ite3PagerMovepag
18840 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 e */.){. MemPag
18850 65 20 2a 70 50 74 72 50 61 67 65 3b 20 20 20 2f e *pPtrPage; /
18860 2a 20 54 68 65 20 70 61 67 65 20 74 68 61 74 20 * The page that
18870 63 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 contains a point
18880 65 72 20 74 6f 20 70 44 62 50 61 67 65 20 2a 2f er to pDbPage */
18890 0a 20 20 50 67 6e 6f 20 69 44 62 50 61 67 65 20 . Pgno iDbPage
188a0 3d 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b = pDbPage->pgno;
188b0 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
188c0 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a = pBt->pPager;.
188d0 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 int rc;.. ass
188e0 65 72 74 28 20 65 54 79 70 65 3d 3d 50 54 52 4d ert( eType==PTRM
188f0 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 AP_OVERFLOW2 ||
18900 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 eType==PTRMAP_OV
18910 45 52 46 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 ERFLOW1 || .
18920 20 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f eType==PTRMAP_
18930 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d BTREE || eType==
18940 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 PTRMAP_ROOTPAGE
18950 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
18960 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
18970 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
18980 20 61 73 73 65 72 74 28 20 70 44 62 50 61 67 65 assert( pDbPage
18990 2d 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 ->pBt==pBt );..
189a0 20 2f 2a 20 4d 6f 76 65 20 70 61 67 65 20 69 44 /* Move page iD
189b0 62 50 61 67 65 20 66 72 6f 6d 20 69 74 73 20 63 bPage from its c
189c0 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 urrent location
189d0 74 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 to page number i
189e0 46 72 65 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 FreePage */. TR
189f0 41 43 45 28 28 22 41 55 54 4f 56 41 43 55 55 4d ACE(("AUTOVACUUM
18a00 3a 20 4d 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 : Moving %d to f
18a10 72 65 65 20 70 61 67 65 20 25 64 20 28 70 74 72 ree page %d (ptr
18a20 20 70 61 67 65 20 25 64 20 74 79 70 65 20 25 64 page %d type %d
18a30 29 5c 6e 22 2c 20 0a 20 20 20 20 20 20 69 44 62 )\n", . iDb
18a40 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c Page, iFreePage,
18a50 20 69 50 74 72 50 61 67 65 2c 20 65 54 79 70 65 iPtrPage, eType
18a60 29 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 ));. rc = sqlit
18a70 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 e3PagerMovepage(
18a80 70 50 61 67 65 72 2c 20 70 44 62 50 61 67 65 2d pPager, pDbPage-
18a90 3e 70 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 >pDbPage, iFreeP
18aa0 61 67 65 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a age, isCommit);.
18ab0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
18ac0 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 _OK ){. retur
18ad0 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 n rc;. }. pDbP
18ae0 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 age->pgno = iFre
18af0 65 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 ePage;.. /* If
18b00 70 44 62 50 61 67 65 20 77 61 73 20 61 20 62 74 pDbPage was a bt
18b10 72 65 65 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 ree-page, then i
18b20 74 20 6d 61 79 20 68 61 76 65 20 63 68 69 6c 64 t may have child
18b30 20 70 61 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 pages and/or ce
18b40 6c 6c 73 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f lls. ** that po
18b50 69 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 int to overflow
18b60 70 61 67 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 pages. The point
18b70 65 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 er map entries f
18b80 6f 72 20 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a or all these. *
18b90 2a 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f 20 * pages need to
18ba0 62 65 20 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a be changed.. **
18bb0 0a 20 20 2a 2a 20 49 66 20 70 44 62 50 61 67 65 . ** If pDbPage
18bc0 20 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 is an overflow
18bd0 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 66 page, then the f
18be0 69 72 73 74 20 34 20 62 79 74 65 73 20 6d 61 79 irst 4 bytes may
18bf0 20 73 74 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f store a. ** po
18c00 69 6e 74 65 72 20 74 6f 20 61 20 73 75 62 73 65 inter to a subse
18c10 71 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 quent overflow p
18c20 61 67 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 age. If this is
18c30 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 the case, then.
18c40 20 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 20 ** the pointer
18c50 6d 61 70 20 6e 65 65 64 73 20 74 6f 20 62 65 20 map needs to be
18c60 75 70 64 61 74 65 64 20 66 6f 72 20 74 68 65 20 updated for the
18c70 73 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 66 subsequent overf
18c80 6c 6f 77 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 low page.. */.
18c90 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d if( eType==PTRM
18ca0 41 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 70 AP_BTREE || eTyp
18cb0 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 e==PTRMAP_ROOTPA
18cc0 47 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 GE ){. rc = s
18cd0 65 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 70 etChildPtrmaps(p
18ce0 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 DbPage);. if(
18cf0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
18d00 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
18d10 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 c;. }. }else
18d20 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f {. Pgno nextO
18d30 76 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 70 vfl = get4byte(p
18d40 44 62 50 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a DbPage->aData);.
18d50 20 20 20 20 69 66 28 20 6e 65 78 74 4f 76 66 6c if( nextOvfl
18d60 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 74 72 !=0 ){. ptr
18d70 6d 61 70 50 75 74 28 70 42 74 2c 20 6e 65 78 74 mapPut(pBt, next
18d80 4f 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 Ovfl, PTRMAP_OVE
18d90 52 46 4c 4f 57 32 2c 20 69 46 72 65 65 50 61 67 RFLOW2, iFreePag
18da0 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 69 e, &rc);. i
18db0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
18dc0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ){. retu
18dd0 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 rn rc;. }.
18de0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 }. }.. /* F
18df0 69 78 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ix the database
18e00 70 6f 69 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 pointer on page
18e10 69 50 74 72 50 61 67 65 20 74 68 61 74 20 70 6f iPtrPage that po
18e20 69 6e 74 65 64 20 61 74 20 69 44 62 50 61 67 65 inted at iDbPage
18e30 20 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 so. ** that it
18e40 20 70 6f 69 6e 74 73 20 61 74 20 69 46 72 65 65 points at iFree
18e50 50 61 67 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 Page. Also fix t
18e60 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 he pointer map e
18e70 6e 74 72 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 ntry for. ** iP
18e80 74 72 50 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 trPage.. */. i
18e90 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 f( eType!=PTRMAP
18ea0 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 _ROOTPAGE ){.
18eb0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
18ec0 67 65 28 70 42 74 2c 20 69 50 74 72 50 61 67 65 ge(pBt, iPtrPage
18ed0 2c 20 26 70 50 74 72 50 61 67 65 2c 20 30 29 3b , &pPtrPage, 0);
18ee0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
18ef0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
18f00 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
18f10 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
18f20 33 50 61 67 65 72 57 72 69 74 65 28 70 50 74 72 3PagerWrite(pPtr
18f30 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a Page->pDbPage);.
18f40 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
18f50 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
18f60 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 50 eleasePage(pPtrP
18f70 61 67 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 age);. retu
18f80 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
18f90 20 72 63 20 3d 20 6d 6f 64 69 66 79 50 61 67 65 rc = modifyPage
18fa0 50 6f 69 6e 74 65 72 28 70 50 74 72 50 61 67 65 Pointer(pPtrPage
18fb0 2c 20 69 44 62 50 61 67 65 2c 20 69 46 72 65 65 , iDbPage, iFree
18fc0 50 61 67 65 2c 20 65 54 79 70 65 29 3b 0a 20 20 Page, eType);.
18fd0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
18fe0 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 trPage);. if(
18ff0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
19000 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 {. ptrmapPu
19010 74 28 70 42 74 2c 20 69 46 72 65 65 50 61 67 65 t(pBt, iFreePage
19020 2c 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 , eType, iPtrPag
19030 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 e, &rc);. }.
19040 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
19050 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 }../* Forward de
19060 63 6c 61 72 61 74 69 6f 6e 20 72 65 71 75 69 72 claration requir
19070 65 64 20 62 79 20 69 6e 63 72 56 61 63 75 75 6d ed by incrVacuum
19080 53 74 65 70 28 29 2e 20 2a 2f 0a 73 74 61 74 69 Step(). */.stati
19090 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 c int allocateBt
190a0 72 65 65 50 61 67 65 28 42 74 53 68 61 72 65 64 reePage(BtShared
190b0 20 2a 2c 20 4d 65 6d 50 61 67 65 20 2a 2a 2c 20 *, MemPage **,
190c0 50 67 6e 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 38 Pgno *, Pgno, u8
190d0 29 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 72 );../*.** Perfor
190e0 6d 20 61 20 73 69 6e 67 6c 65 20 73 74 65 70 20 m a single step
190f0 6f 66 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 of an incrementa
19100 6c 2d 76 61 63 75 75 6d 2e 20 49 66 20 73 75 63 l-vacuum. If suc
19110 63 65 73 73 66 75 6c 2c 20 72 65 74 75 72 6e 0a cessful, return.
19120 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 ** SQLITE_OK. If
19130 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 6f 72 there is no wor
19140 6b 20 74 6f 20 64 6f 20 28 61 6e 64 20 74 68 65 k to do (and the
19150 72 65 66 6f 72 65 20 6e 6f 20 70 6f 69 6e 74 20 refore no point
19160 69 6e 20 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 74 in .** calling t
19170 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 his function aga
19180 69 6e 29 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 in), return SQLI
19190 54 45 5f 44 4f 4e 45 2e 20 4f 72 2c 20 69 66 20 TE_DONE. Or, if
191a0 61 6e 20 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 63 an error .** occ
191b0 75 72 73 2c 20 72 65 74 75 72 6e 20 73 6f 6d 65 urs, return some
191c0 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 other error cod
191d0 65 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 73 70 e..**.** More sp
191e0 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 ecifically, this
191f0 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 function attemp
19200 74 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a ts to re-organiz
19210 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 e the database s
19220 6f 20 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 6c o .** that the l
19230 61 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 ast page of the
19240 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 69 file currently i
19250 6e 20 75 73 65 20 69 73 20 6e 6f 20 6c 6f 6e 67 n use is no long
19260 65 72 20 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a 2a er in use..**.**
19270 20 50 61 72 61 6d 65 74 65 72 20 6e 46 69 6e 20 Parameter nFin
19280 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
19290 20 70 61 67 65 73 20 74 68 61 74 20 74 68 69 73 pages that this
192a0 20 64 61 74 61 62 61 73 65 20 77 6f 75 6c 64 20 database would
192b0 63 6f 6e 74 61 69 6e 0a 2a 2a 20 77 65 72 65 20 contain.** were
192c0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 this function ca
192d0 6c 6c 65 64 20 75 6e 74 69 6c 20 69 74 20 72 65 lled until it re
192e0 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e turns SQLITE_DON
192f0 45 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 E..**.** If the
19300 62 43 6f 6d 6d 69 74 20 70 61 72 61 6d 65 74 65 bCommit paramete
19310 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 r is non-zero, t
19320 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 his function ass
19330 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 0a 2a umes that the .*
19340 2a 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6b 65 * caller will ke
19350 65 70 20 63 61 6c 6c 69 6e 67 20 69 6e 63 72 56 ep calling incrV
19360 61 63 75 75 6d 53 74 65 70 28 29 20 75 6e 74 69 acuumStep() unti
19370 6c 20 69 74 20 72 65 74 75 72 6e 73 20 53 51 4c l it returns SQL
19380 49 54 45 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 20 ITE_DONE .** or
19390 61 6e 20 65 72 72 6f 72 2e 20 62 43 6f 6d 6d 69 an error. bCommi
193a0 74 20 69 73 20 70 61 73 73 65 64 20 74 72 75 65 t is passed true
193b0 20 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 for an auto-vac
193c0 75 75 6d 2d 6f 6e 2d 63 6f 6d 6d 69 74 20 0a 2a uum-on-commit .*
193d0 2a 20 6f 70 65 72 61 74 69 6f 6e 2c 20 6f 72 20 * operation, or
193e0 66 61 6c 73 65 20 66 6f 72 20 61 6e 20 69 6e 63 false for an inc
193f0 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e remental vacuum.
19400 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 69 .*/.static int i
19410 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 42 74 ncrVacuumStep(Bt
19420 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e Shared *pBt, Pgn
19430 6f 20 6e 46 69 6e 2c 20 50 67 6e 6f 20 69 4c 61 o nFin, Pgno iLa
19440 73 74 50 67 2c 20 69 6e 74 20 62 43 6f 6d 6d 69 stPg, int bCommi
19450 74 29 7b 0a 20 20 50 67 6e 6f 20 6e 46 72 65 65 t){. Pgno nFree
19460 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 List;
19470 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
19480 65 73 20 73 74 69 6c 6c 20 6f 6e 20 74 68 65 20 es still on the
19490 66 72 65 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 69 free-list */. i
194a0 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
194b0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
194c0 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
194d0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 4c );. assert( iL
194e0 61 73 74 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a 20 astPg>nFin );..
194f0 20 69 66 28 20 21 50 54 52 4d 41 50 5f 49 53 50 if( !PTRMAP_ISP
19500 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 67 AGE(pBt, iLastPg
19510 29 20 26 26 20 69 4c 61 73 74 50 67 21 3d 50 45 ) && iLastPg!=PE
19520 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
19530 70 42 74 29 20 29 7b 0a 20 20 20 20 75 38 20 65 pBt) ){. u8 e
19540 54 79 70 65 3b 0a 20 20 20 20 50 67 6e 6f 20 69 Type;. Pgno i
19550 50 74 72 50 61 67 65 3b 0a 0a 20 20 20 20 6e 46 PtrPage;.. nF
19560 72 65 65 4c 69 73 74 20 3d 20 67 65 74 34 62 79 reeList = get4by
19570 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d te(&pBt->pPage1-
19580 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 >aData[36]);.
19590 20 69 66 28 20 6e 46 72 65 65 4c 69 73 74 3d 3d if( nFreeList==
195a0 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 0 ){. retur
195b0 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 n SQLITE_DONE;.
195c0 20 20 20 7d 0a 0a 20 20 20 20 72 63 20 3d 20 70 }.. rc = p
195d0 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 69 4c trmapGet(pBt, iL
195e0 61 73 74 50 67 2c 20 26 65 54 79 70 65 2c 20 26 astPg, &eType, &
195f0 69 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 iPtrPage);. i
19600 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
19610 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
19620 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 rc;. }. i
19630 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 f( eType==PTRMAP
19640 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 _ROOTPAGE ){.
19650 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
19660 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
19670 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 65 54 }.. if( eT
19680 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 ype==PTRMAP_FREE
19690 50 41 47 45 20 29 7b 0a 20 20 20 20 20 20 69 66 PAGE ){. if
196a0 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a ( bCommit==0 ){.
196b0 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 /* Remov
196c0 65 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 e the page from
196d0 74 68 65 20 66 69 6c 65 73 20 66 72 65 65 2d 6c the files free-l
196e0 69 73 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 ist. This is not
196f0 20 72 65 71 75 69 72 65 64 0a 20 20 20 20 20 20 required.
19700 20 20 2a 2a 20 69 66 20 62 43 6f 6d 6d 69 74 20 ** if bCommit
19710 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e 20 is non-zero. In
19720 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 66 that case, the f
19730 72 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 ree-list will be
19740 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 75 6e . ** trun
19750 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 61 66 cated to zero af
19760 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
19770 6e 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 69 74 n returns, so it
19780 20 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 20 20 doesn't .
19790 20 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 20 69 ** matter if i
197a0 74 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 6e 73 t still contains
197b0 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 65 6e some garbage en
197c0 74 72 69 65 73 2e 0a 20 20 20 20 20 20 20 20 2a tries.. *
197d0 2f 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 /. Pgno i
197e0 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 FreePg;.
197f0 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 67 MemPage *pFreePg
19800 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 ;. rc = a
19810 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
19820 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c 20 (pBt, &pFreePg,
19830 26 69 46 72 65 65 50 67 2c 20 69 4c 61 73 74 50 &iFreePg, iLastP
19840 67 2c 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 g, BTALLOC_EXACT
19850 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
19860 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
19870 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
19880 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 rc;. }.
19890 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 assert( i
198a0 46 72 65 65 50 67 3d 3d 69 4c 61 73 74 50 67 20 FreePg==iLastPg
198b0 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 );. relea
198c0 73 65 50 61 67 65 28 70 46 72 65 65 50 67 29 3b sePage(pFreePg);
198d0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 . }. } e
198e0 6c 73 65 20 7b 0a 20 20 20 20 20 20 50 67 6e 6f lse {. Pgno
198f0 20 69 46 72 65 65 50 67 3b 20 20 20 20 20 20 20 iFreePg;
19900 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f /* Index o
19910 66 20 66 72 65 65 20 70 61 67 65 20 74 6f 20 6d f free page to m
19920 6f 76 65 20 70 4c 61 73 74 50 67 20 74 6f 20 2a ove pLastPg to *
19930 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 /. MemPage
19940 2a 70 4c 61 73 74 50 67 3b 0a 20 20 20 20 20 20 *pLastPg;.
19950 75 38 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c u8 eMode = BTALL
19960 4f 43 5f 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f 64 OC_ANY; /* Mod
19970 65 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 e parameter for
19980 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
19990 65 28 29 20 2a 2f 0a 20 20 20 20 20 20 50 67 6e e() */. Pgn
199a0 6f 20 69 4e 65 61 72 20 3d 20 30 3b 20 20 20 20 o iNear = 0;
199b0 20 20 20 20 20 20 20 2f 2a 20 6e 65 61 72 62 79 /* nearby
199c0 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 parameter for a
199d0 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
199e0 28 29 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 20 () */.. rc
199f0 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 = btreeGetPage(p
19a00 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 70 4c Bt, iLastPg, &pL
19a10 61 73 74 50 67 2c 20 30 29 3b 0a 20 20 20 20 20 astPg, 0);.
19a20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
19a30 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 OK ){. re
19a40 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
19a50 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 62 43 .. /* If bC
19a60 6f 6d 6d 69 74 20 69 73 20 7a 65 72 6f 2c 20 74 ommit is zero, t
19a70 68 69 73 20 6c 6f 6f 70 20 72 75 6e 73 20 65 78 his loop runs ex
19a80 61 63 74 6c 79 20 6f 6e 63 65 20 61 6e 64 20 70 actly once and p
19a90 61 67 65 20 70 4c 61 73 74 50 67 0a 20 20 20 20 age pLastPg.
19aa0 20 20 2a 2a 20 69 73 20 73 77 61 70 70 65 64 20 ** is swapped
19ab0 77 69 74 68 20 74 68 65 20 66 69 72 73 74 20 66 with the first f
19ac0 72 65 65 20 70 61 67 65 20 70 75 6c 6c 65 64 20 ree page pulled
19ad0 6f 66 66 20 74 68 65 20 66 72 65 65 20 6c 69 73 off the free lis
19ae0 74 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 t.. **.
19af0 20 20 2a 2a 20 4f 6e 20 74 68 65 20 6f 74 68 65 ** On the othe
19b00 72 20 68 61 6e 64 2c 20 69 66 20 62 43 6f 6d 6d r hand, if bComm
19b10 69 74 20 69 73 20 67 72 65 61 74 65 72 20 74 68 it is greater th
19b20 61 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6b 65 an zero, then ke
19b30 65 70 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 6f 70 ep. ** loop
19b40 69 6e 67 20 75 6e 74 69 6c 20 61 20 66 72 65 65 ing until a free
19b50 2d 70 61 67 65 20 6c 6f 63 61 74 65 64 20 77 69 -page located wi
19b60 74 68 69 6e 20 74 68 65 20 66 69 72 73 74 20 6e thin the first n
19b70 46 69 6e 20 70 61 67 65 73 0a 20 20 20 20 20 20 Fin pages.
19b80 2a 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 ** of the file i
19b90 73 20 66 6f 75 6e 64 2e 0a 20 20 20 20 20 20 2a s found.. *
19ba0 2f 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f 6d /. if( bCom
19bb0 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 mit==0 ){.
19bc0 20 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f eMode = BTALLO
19bd0 43 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 69 4e C_LE;. iN
19be0 65 61 72 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 ear = nFin;.
19bf0 20 20 7d 0a 20 20 20 20 20 20 64 6f 20 7b 0a 20 }. do {.
19c00 20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a MemPage *
19c10 70 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 pFreePg;.
19c20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 rc = allocateBt
19c30 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 46 reePage(pBt, &pF
19c40 72 65 65 50 67 2c 20 26 69 46 72 65 65 50 67 2c reePg, &iFreePg,
19c50 20 69 4e 65 61 72 2c 20 65 4d 6f 64 65 29 3b 0a iNear, eMode);.
19c60 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
19c70 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
19c80 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 releasePa
19c90 67 65 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 ge(pLastPg);.
19ca0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
19cb0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
19cc0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
19cd0 70 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 20 pFreePg);.
19ce0 7d 77 68 69 6c 65 28 20 62 43 6f 6d 6d 69 74 20 }while( bCommit
19cf0 26 26 20 69 46 72 65 65 50 67 3e 6e 46 69 6e 20 && iFreePg>nFin
19d00 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
19d10 20 69 46 72 65 65 50 67 3c 69 4c 61 73 74 50 67 iFreePg<iLastPg
19d20 20 29 3b 0a 20 20 20 20 20 20 0a 20 20 20 20 20 );. .
19d30 20 72 63 20 3d 20 72 65 6c 6f 63 61 74 65 50 61 rc = relocatePa
19d40 67 65 28 70 42 74 2c 20 70 4c 61 73 74 50 67 2c ge(pBt, pLastPg,
19d50 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 eType, iPtrPage
19d60 2c 20 69 46 72 65 65 50 67 2c 20 62 43 6f 6d 6d , iFreePg, bComm
19d70 69 74 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 it);. relea
19d80 73 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b sePage(pLastPg);
19d90 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
19da0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
19db0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
19dc0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
19dd0 0a 0a 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d .. if( bCommit=
19de0 3d 30 20 29 7b 0a 20 20 20 20 64 6f 20 7b 0a 20 =0 ){. do {.
19df0 20 20 20 20 20 69 4c 61 73 74 50 67 2d 2d 3b 0a iLastPg--;.
19e00 20 20 20 20 7d 77 68 69 6c 65 28 20 69 4c 61 73 }while( iLas
19e10 74 50 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 tPg==PENDING_BYT
19e20 45 5f 50 41 47 45 28 70 42 74 29 20 7c 7c 20 50 E_PAGE(pBt) || P
19e30 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
19e40 2c 20 69 4c 61 73 74 50 67 29 20 29 3b 0a 20 20 , iLastPg) );.
19e50 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 pBt->bDoTrunca
19e60 74 65 20 3d 20 31 3b 0a 20 20 20 20 70 42 74 2d te = 1;. pBt-
19e70 3e 6e 50 61 67 65 20 3d 20 69 4c 61 73 74 50 67 >nPage = iLastPg
19e80 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
19e90 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
19ea0 2a 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 ** The database
19eb0 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 66 69 opened by the fi
19ec0 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 rst argument is
19ed0 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 an auto-vacuum d
19ee0 61 74 61 62 61 73 65 0a 2a 2a 20 6e 4f 72 69 67 atabase.** nOrig
19ef0 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 20 63 pages in size c
19f00 6f 6e 74 61 69 6e 69 6e 67 20 6e 46 72 65 65 20 ontaining nFree
19f10 66 72 65 65 20 70 61 67 65 73 2e 20 52 65 74 75 free pages. Retu
19f20 72 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 20 rn the expected
19f30 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 74 68 65 20 .** size of the
19f40 64 61 74 61 62 61 73 65 20 69 6e 20 70 61 67 65 database in page
19f50 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 20 61 s following an a
19f60 75 74 6f 2d 76 61 63 75 75 6d 20 6f 70 65 72 61 uto-vacuum opera
19f70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
19f80 50 67 6e 6f 20 66 69 6e 61 6c 44 62 53 69 7a 65 Pgno finalDbSize
19f90 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
19fa0 50 67 6e 6f 20 6e 4f 72 69 67 2c 20 50 67 6e 6f Pgno nOrig, Pgno
19fb0 20 6e 46 72 65 65 29 7b 0a 20 20 69 6e 74 20 6e nFree){. int n
19fc0 45 6e 74 72 79 3b 20 20 20 20 20 20 20 20 20 20 Entry;
19fd0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
19fe0 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 mber of entries
19ff0 6f 6e 20 6f 6e 65 20 70 74 72 6d 61 70 20 70 61 on one ptrmap pa
1a000 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 50 74 ge */. Pgno nPt
1a010 72 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 rmap;
1a020 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1a030 72 20 6f 66 20 50 74 72 4d 61 70 20 70 61 67 65 r of PtrMap page
1a040 73 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f s to be freed */
1a050 0a 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 20 . Pgno nFin;
1a060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a070 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61 6c /* Return val
1a080 75 65 20 2a 2f 0a 0a 20 20 6e 45 6e 74 72 79 20 ue */.. nEntry
1a090 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
1a0a0 65 2f 35 3b 0a 20 20 6e 50 74 72 6d 61 70 20 3d e/5;. nPtrmap =
1a0b0 20 28 6e 46 72 65 65 2d 6e 4f 72 69 67 2b 50 54 (nFree-nOrig+PT
1a0c0 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c RMAP_PAGENO(pBt,
1a0d0 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 72 79 29 2f nOrig)+nEntry)/
1a0e0 6e 45 6e 74 72 79 3b 0a 20 20 6e 46 69 6e 20 3d nEntry;. nFin =
1a0f0 20 6e 4f 72 69 67 20 2d 20 6e 46 72 65 65 20 2d nOrig - nFree -
1a100 20 6e 50 74 72 6d 61 70 3b 0a 20 20 69 66 28 20 nPtrmap;. if(
1a110 6e 4f 72 69 67 3e 50 45 4e 44 49 4e 47 5f 42 59 nOrig>PENDING_BY
1a120 54 45 5f 50 41 47 45 28 70 42 74 29 20 26 26 20 TE_PAGE(pBt) &&
1a130 6e 46 69 6e 3c 50 45 4e 44 49 4e 47 5f 42 59 54 nFin<PENDING_BYT
1a140 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 E_PAGE(pBt) ){.
1a150 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 20 nFin--;. }.
1a160 20 77 68 69 6c 65 28 20 50 54 52 4d 41 50 5f 49 while( PTRMAP_I
1a170 53 50 41 47 45 28 70 42 74 2c 20 6e 46 69 6e 29 SPAGE(pBt, nFin)
1a180 20 7c 7c 20 6e 46 69 6e 3d 3d 50 45 4e 44 49 4e || nFin==PENDIN
1a190 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
1a1a0 20 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a ){. nFin--;.
1a1b0 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 6e 46 }.. return nF
1a1c0 69 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 77 in;.}../*.** A w
1a1d0 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
1a1e0 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 65 64 20 must be opened
1a1f0 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 before calling t
1a200 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a his function..**
1a210 20 49 74 20 70 65 72 66 6f 72 6d 73 20 61 20 73 It performs a s
1a220 69 6e 67 6c 65 20 75 6e 69 74 20 6f 66 20 77 6f ingle unit of wo
1a230 72 6b 20 74 6f 77 61 72 64 73 20 61 6e 20 69 6e rk towards an in
1a240 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
1a250 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 ..**.** If the i
1a260 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 ncremental vacuu
1a270 6d 20 69 73 20 66 69 6e 69 73 68 65 64 20 61 66 m is finished af
1a280 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
1a290 6e 20 68 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 51 n has run,.** SQ
1a2a0 4c 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 LITE_DONE is ret
1a2b0 75 72 6e 65 64 2e 20 49 66 20 69 74 20 69 73 20 urned. If it is
1a2c0 6e 6f 74 20 66 69 6e 69 73 68 65 64 2c 20 62 75 not finished, bu
1a2d0 74 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 t no error occur
1a2e0 72 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f red,.** SQLITE_O
1a2f0 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f K is returned. O
1a300 74 68 65 72 77 69 73 65 20 61 6e 20 53 51 4c 69 therwise an SQLi
1a310 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 0a te error code. .
1a320 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1a330 72 65 65 49 6e 63 72 56 61 63 75 75 6d 28 42 74 reeIncrVacuum(Bt
1a340 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 ree *p){. int r
1a350 63 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 c;. BtShared *p
1a360 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 20 Bt = p->pBt;..
1a370 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1a380 72 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r(p);. assert(
1a390 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
1a3a0 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 on==TRANS_WRITE
1a3b0 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 && p->inTrans==T
1a3c0 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 RANS_WRITE );.
1a3d0 69 66 28 20 21 70 42 74 2d 3e 61 75 74 6f 56 61 if( !pBt->autoVa
1a3e0 63 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d cuum ){. rc =
1a3f0 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 SQLITE_DONE;.
1a400 7d 65 6c 73 65 7b 0a 20 20 20 20 50 67 6e 6f 20 }else{. Pgno
1a410 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 nOrig = btreePag
1a420 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 ecount(pBt);.
1a430 20 50 67 6e 6f 20 6e 46 72 65 65 20 3d 20 67 65 Pgno nFree = ge
1a440 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
1a450 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b ge1->aData[36]);
1a460 0a 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 20 3d . Pgno nFin =
1a470 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 finalDbSize(pBt
1a480 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b , nOrig, nFree);
1a490 0a 0a 20 20 20 20 69 66 28 20 6e 4f 72 69 67 3c .. if( nOrig<
1a4a0 6e 46 69 6e 20 29 7b 0a 20 20 20 20 20 20 72 63 nFin ){. rc
1a4b0 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
1a4c0 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 T_BKPT;. }els
1a4d0 65 20 69 66 28 20 6e 46 72 65 65 3e 30 20 29 7b e if( nFree>0 ){
1a4e0 0a 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 . rc = save
1a4f0 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 AllCursors(pBt,
1a500 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 0, 0);. if(
1a510 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1a520 7b 0a 20 20 20 20 20 20 20 20 69 6e 76 61 6c 69 {. invali
1a530 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 dateAllOverflowC
1a540 61 63 68 65 28 70 42 74 29 3b 0a 20 20 20 20 20 ache(pBt);.
1a550 20 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 75 rc = incrVacu
1a560 75 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 6e umStep(pBt, nFin
1a570 2c 20 6e 4f 72 69 67 2c 20 30 29 3b 0a 20 20 20 , nOrig, 0);.
1a580 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 }. if( r
1a590 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1a5a0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
1a5b0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
1a5c0 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 Bt->pPage1->pDbP
1a5d0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 75 age);. pu
1a5e0 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
1a5f0 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 ge1->aData[28],
1a600 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 pBt->nPage);.
1a610 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
1a620 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
1a630 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 E_DONE;. }.
1a640 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 }. sqlite3Btree
1a650 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
1a660 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1a670 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
1a680 63 61 6c 6c 65 64 20 70 72 69 6f 72 20 74 6f 20 called prior to
1a690 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d sqlite3PagerComm
1a6a0 69 74 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 it when a transa
1a6b0 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 6f 6d 6d ction.** is comm
1a6c0 69 74 74 65 64 20 66 6f 72 20 61 6e 20 61 75 74 itted for an aut
1a6d0 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 o-vacuum databas
1a6e0 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 e..**.** If SQLI
1a6f0 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
1a700 64 2c 20 74 68 65 6e 20 2a 70 6e 54 72 75 6e 63 d, then *pnTrunc
1a710 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6e is set to the n
1a720 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 0a 2a umber of pages.*
1a730 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
1a740 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 74 72 ile should be tr
1a750 75 6e 63 61 74 65 64 20 74 6f 20 64 75 72 69 6e uncated to durin
1a760 67 20 74 68 65 20 63 6f 6d 6d 69 74 20 70 72 6f g the commit pro
1a770 63 65 73 73 2e 20 0a 2a 2a 20 69 2e 65 2e 20 74 cess. .** i.e. t
1a780 68 65 20 64 61 74 61 62 61 73 65 20 68 61 73 20 he database has
1a790 62 65 65 6e 20 72 65 6f 72 67 61 6e 69 7a 65 64 been reorganized
1a7a0 20 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20 74 68 so that only th
1a7b0 65 20 66 69 72 73 74 20 2a 70 6e 54 72 75 6e 63 e first *pnTrunc
1a7c0 0a 2a 2a 20 70 61 67 65 73 20 61 72 65 20 69 6e .** pages are in
1a7d0 20 75 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 use..*/.static
1a7e0 69 6e 74 20 61 75 74 6f 56 61 63 75 75 6d 43 6f int autoVacuumCo
1a7f0 6d 6d 69 74 28 42 74 53 68 61 72 65 64 20 2a 70 mmit(BtShared *p
1a800 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 Bt){. int rc =
1a810 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 67 SQLITE_OK;. Pag
1a820 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 42 74 er *pPager = pBt
1a830 2d 3e 70 50 61 67 65 72 3b 0a 20 20 56 56 41 5f ->pPager;. VVA_
1a840 4f 4e 4c 59 28 20 69 6e 74 20 6e 52 65 66 20 3d ONLY( int nRef =
1a850 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 sqlite3PagerRef
1a860 63 6f 75 6e 74 28 70 50 61 67 65 72 29 20 29 3b count(pPager) );
1a870 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
1a880 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
1a890 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
1a8a0 69 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 invalidateAllOve
1a8b0 72 66 6c 6f 77 43 61 63 68 65 28 70 42 74 29 3b rflowCache(pBt);
1a8c0 0a 20 20 61 73 73 65 72 74 28 70 42 74 2d 3e 61 . assert(pBt->a
1a8d0 75 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 69 66 utoVacuum);. if
1a8e0 28 20 21 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 ( !pBt->incrVacu
1a8f0 75 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e um ){. Pgno n
1a900 46 69 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 Fin; /*
1a910 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
1a920 69 6e 20 64 61 74 61 62 61 73 65 20 61 66 74 65 in database afte
1a930 72 20 61 75 74 6f 76 61 63 75 75 6d 69 6e 67 20 r autovacuuming
1a940 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 */. Pgno nFre
1a950 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d e; /* Num
1a960 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 ber of pages on
1a970 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 6e 69 the freelist ini
1a980 74 69 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 50 67 tially */. Pg
1a990 6e 6f 20 69 46 72 65 65 3b 20 20 20 20 20 20 20 no iFree;
1a9a0 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 70 61 67 /* The next pag
1a9b0 65 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f e to be freed */
1a9c0 0a 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 3b . Pgno nOrig;
1a9d0 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1a9e0 61 73 65 20 73 69 7a 65 20 62 65 66 6f 72 65 20 ase size before
1a9f0 66 72 65 65 69 6e 67 20 2a 2f 0a 0a 20 20 20 20 freeing */..
1aa00 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 nOrig = btreePag
1aa10 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 ecount(pBt);.
1aa20 20 69 66 28 20 50 54 52 4d 41 50 5f 49 53 50 41 if( PTRMAP_ISPA
1aa30 47 45 28 70 42 74 2c 20 6e 4f 72 69 67 29 20 7c GE(pBt, nOrig) |
1aa40 7c 20 6e 4f 72 69 67 3d 3d 50 45 4e 44 49 4e 47 | nOrig==PENDING
1aa50 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
1aa60 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 74 20 69 ){. /* It i
1aa70 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 s not possible t
1aa80 6f 20 63 72 65 61 74 65 20 61 20 64 61 74 61 62 o create a datab
1aa90 61 73 65 20 66 6f 72 20 77 68 69 63 68 20 74 68 ase for which th
1aaa0 65 20 66 69 6e 61 6c 20 70 61 67 65 0a 20 20 20 e final page.
1aab0 20 20 20 2a 2a 20 69 73 20 65 69 74 68 65 72 20 ** is either
1aac0 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 a pointer-map pa
1aad0 67 65 20 6f 72 20 74 68 65 20 70 65 6e 64 69 6e ge or the pendin
1aae0 67 2d 62 79 74 65 20 70 61 67 65 2e 20 49 66 20 g-byte page. If
1aaf0 6f 6e 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 one. ** is
1ab00 65 6e 63 6f 75 6e 74 65 72 65 64 2c 20 74 68 69 encountered, thi
1ab10 73 20 69 6e 64 69 63 61 74 65 73 20 63 6f 72 72 s indicates corr
1ab20 75 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f uption.. */
1ab30 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
1ab40 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
1ab50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e 46 T;. }.. nF
1ab60 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 ree = get4byte(&
1ab70 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 pBt->pPage1->aDa
1ab80 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 6e 46 69 ta[36]);. nFi
1ab90 6e 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 n = finalDbSize(
1aba0 70 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 pBt, nOrig, nFre
1abb0 65 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 6e e);. if( nFin
1abc0 3e 6e 4f 72 69 67 20 29 20 72 65 74 75 72 6e 20 >nOrig ) return
1abd0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1abe0 4b 50 54 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 KPT;. if( nFi
1abf0 6e 3c 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 n<nOrig ){.
1ac00 20 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 rc = saveAllCur
1ac10 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b sors(pBt, 0, 0);
1ac20 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 . }. for(i
1ac30 46 72 65 65 3d 6e 4f 72 69 67 3b 20 69 46 72 65 Free=nOrig; iFre
1ac40 65 3e 6e 46 69 6e 20 26 26 20 72 63 3d 3d 53 51 e>nFin && rc==SQ
1ac50 4c 49 54 45 5f 4f 4b 3b 20 69 46 72 65 65 2d 2d LITE_OK; iFree--
1ac60 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 69 6e ){. rc = in
1ac70 63 72 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 crVacuumStep(pBt
1ac80 2c 20 6e 46 69 6e 2c 20 69 46 72 65 65 2c 20 31 , nFin, iFree, 1
1ac90 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
1aca0 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e (rc==SQLITE_DON
1acb0 45 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f E || rc==SQLITE_
1acc0 4f 4b 29 20 26 26 20 6e 46 72 65 65 3e 30 20 29 OK) && nFree>0 )
1acd0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
1ace0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
1acf0 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 Bt->pPage1->pDbP
1ad00 61 67 65 29 3b 0a 20 20 20 20 20 20 70 75 74 34 age);. put4
1ad10 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 byte(&pBt->pPage
1ad20 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 30 29 1->aData[32], 0)
1ad30 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
1ad40 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
1ad50 44 61 74 61 5b 33 36 5d 2c 20 30 29 3b 0a 20 20 Data[36], 0);.
1ad60 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 42 put4byte(&pB
1ad70 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
1ad80 5b 32 38 5d 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 [28], nFin);.
1ad90 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 pBt->bDoTrunc
1ada0 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 70 ate = 1;. p
1adb0 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 46 69 6e Bt->nPage = nFin
1adc0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
1add0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1ade0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
1adf0 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 gerRollback(pPag
1ae00 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a er);. }. }..
1ae10 20 20 61 73 73 65 72 74 28 20 6e 52 65 66 3e 3d assert( nRef>=
1ae20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 sqlite3PagerRefc
1ae30 6f 75 6e 74 28 70 50 61 67 65 72 29 20 29 3b 0a ount(pPager) );.
1ae40 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1ae50 23 65 6c 73 65 20 2f 2a 20 69 66 6e 64 65 66 20 #else /* ifndef
1ae60 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
1ae70 56 41 43 55 55 4d 20 2a 2f 0a 23 20 64 65 66 69 VACUUM */.# defi
1ae80 6e 65 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 ne setChildPtrma
1ae90 70 73 28 78 29 20 53 51 4c 49 54 45 5f 4f 4b 0a ps(x) SQLITE_OK.
1aea0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
1aeb0 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 is routine does
1aec0 74 68 65 20 66 69 72 73 74 20 70 68 61 73 65 20 the first phase
1aed0 6f 66 20 61 20 74 77 6f 2d 70 68 61 73 65 20 63 of a two-phase c
1aee0 6f 6d 6d 69 74 2e 20 20 54 68 69 73 20 72 6f 75 ommit. This rou
1aef0 74 69 6e 65 0a 2a 2a 20 63 61 75 73 65 73 20 61 tine.** causes a
1af00 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
1af10 6c 20 74 6f 20 62 65 20 63 72 65 61 74 65 64 20 l to be created
1af20 28 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 (if it does not
1af30 61 6c 72 65 61 64 79 20 65 78 69 73 74 29 0a 2a already exist).*
1af40 2a 20 61 6e 64 20 70 6f 70 75 6c 61 74 65 64 20 * and populated
1af50 77 69 74 68 20 65 6e 6f 75 67 68 20 69 6e 66 6f with enough info
1af60 72 6d 61 74 69 6f 6e 20 73 6f 20 74 68 61 74 20 rmation so that
1af70 69 66 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 if a power loss
1af80 6f 63 63 75 72 73 0a 2a 2a 20 74 68 65 20 64 61 occurs.** the da
1af90 74 61 62 61 73 65 20 63 61 6e 20 62 65 20 72 65 tabase can be re
1afa0 73 74 6f 72 65 64 20 74 6f 20 69 74 73 20 6f 72 stored to its or
1afb0 69 67 69 6e 61 6c 20 73 74 61 74 65 20 62 79 20 iginal state by
1afc0 70 6c 61 79 69 6e 67 20 62 61 63 6b 0a 2a 2a 20 playing back.**
1afd0 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 the journal. Th
1afe0 65 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 en the contents
1aff0 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 of the journal a
1b000 72 65 20 66 6c 75 73 68 65 64 20 6f 75 74 20 74 re flushed out t
1b010 6f 0a 2a 2a 20 74 68 65 20 64 69 73 6b 2e 20 20 o.** the disk.
1b020 41 66 74 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 After the journa
1b030 6c 20 69 73 20 73 61 66 65 6c 79 20 6f 6e 20 6f l is safely on o
1b040 78 69 64 65 2c 20 74 68 65 20 63 68 61 6e 67 65 xide, the change
1b050 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 s to the.** data
1b060 62 61 73 65 20 61 72 65 20 77 72 69 74 74 65 6e base are written
1b070 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
1b080 73 65 20 66 69 6c 65 20 61 6e 64 20 66 6c 75 73 se file and flus
1b090 68 65 64 20 74 6f 20 6f 78 69 64 65 2e 0a 2a 2a hed to oxide..**
1b0a0 20 41 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 At the end of t
1b0b0 68 69 73 20 63 61 6c 6c 2c 20 74 68 65 20 72 6f his call, the ro
1b0c0 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 73 llback journal s
1b0d0 74 69 6c 6c 20 65 78 69 73 74 73 20 6f 6e 20 74 till exists on t
1b0e0 68 65 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 20 77 he.** disk and w
1b0f0 65 20 61 72 65 20 73 74 69 6c 6c 20 68 6f 6c 64 e are still hold
1b100 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b 73 2c 20 73 ing all locks, s
1b110 6f 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f o the transactio
1b120 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 63 6f 6d n has not.** com
1b130 6d 69 74 74 65 64 2e 20 20 53 65 65 20 73 71 6c mitted. See sql
1b140 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
1b150 68 61 73 65 54 77 6f 28 29 20 66 6f 72 20 74 68 haseTwo() for th
1b160 65 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 6f e second phase o
1b170 66 20 74 68 65 0a 2a 2a 20 63 6f 6d 6d 69 74 20 f the.** commit
1b180 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 process..**.** T
1b190 68 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f his call is a no
1b1a0 2d 6f 70 20 69 66 20 6e 6f 20 77 72 69 74 65 2d -op if no write-
1b1b0 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 transaction is c
1b1c0 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 20 urrently active
1b1d0 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 on pBt..**.** Ot
1b1e0 68 65 72 77 69 73 65 2c 20 73 79 6e 63 20 74 68 herwise, sync th
1b1f0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
1b200 66 6f 72 20 74 68 65 20 62 74 72 65 65 20 70 42 for the btree pB
1b210 74 2e 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 t. zMaster point
1b220 73 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 61 6d 65 s to.** the name
1b230 20 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 of a master jou
1b240 72 6e 61 6c 20 66 69 6c 65 20 74 68 61 74 20 73 rnal file that s
1b250 68 6f 75 6c 64 20 62 65 20 77 72 69 74 74 65 6e hould be written
1b260 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 69 6e 64 into the.** ind
1b270 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 ividual journal
1b280 66 69 6c 65 2c 20 6f 72 20 69 73 20 4e 55 4c 4c file, or is NULL
1b290 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 , indicating no
1b2a0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
1b2b0 69 6c 65 20 0a 2a 2a 20 28 73 69 6e 67 6c 65 20 ile .** (single
1b2c0 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 database transac
1b2d0 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 tion)..**.** Whe
1b2e0 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 n this is called
1b2f0 2c 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 , the master jou
1b300 72 6e 61 6c 20 73 68 6f 75 6c 64 20 61 6c 72 65 rnal should alre
1b310 61 64 79 20 68 61 76 65 20 62 65 65 6e 0a 2a 2a ady have been.**
1b320 20 63 72 65 61 74 65 64 2c 20 70 6f 70 75 6c 61 created, popula
1b330 74 65 64 20 77 69 74 68 20 74 68 69 73 20 6a 6f ted with this jo
1b340 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 61 6e urnal pointer an
1b350 64 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b d synced to disk
1b360 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 69 ..**.** Once thi
1b370 73 20 69 73 20 72 6f 75 74 69 6e 65 20 68 61 73 s is routine has
1b380 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 20 6f returned, the o
1b390 6e 6c 79 20 74 68 69 6e 67 20 72 65 71 75 69 72 nly thing requir
1b3a0 65 64 20 74 6f 20 63 6f 6d 6d 69 74 0a 2a 2a 20 ed to commit.**
1b3b0 74 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 the write-transa
1b3c0 63 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 64 ction for this d
1b3d0 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
1b3e0 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f to delete the jo
1b3f0 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 urnal..*/.int sq
1b400 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1b410 50 68 61 73 65 4f 6e 65 28 42 74 72 65 65 20 2a PhaseOne(Btree *
1b420 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a p, const char *z
1b430 4d 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 Master){. int r
1b440 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1b450 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d if( p->inTrans=
1b460 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a =TRANS_WRITE ){.
1b470 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
1b480 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 t = p->pBt;.
1b490 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1b4a0 72 28 70 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 r(p);.#ifndef SQ
1b4b0 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
1b4c0 43 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 74 CUUM. if( pBt
1b4d0 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a ->autoVacuum ){.
1b4e0 20 20 20 20 20 20 72 63 20 3d 20 61 75 74 6f 56 rc = autoV
1b4f0 61 63 75 75 6d 43 6f 6d 6d 69 74 28 70 42 74 29 acuumCommit(pBt)
1b500 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
1b510 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1b520 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
1b530 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 20 eLeave(p);.
1b540 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1b550 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
1b560 69 66 28 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e if( pBt->bDoTrun
1b570 63 61 74 65 20 29 7b 0a 20 20 20 20 20 20 73 71 cate ){. sq
1b580 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 lite3PagerTrunca
1b590 74 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 50 61 teImage(pBt->pPa
1b5a0 67 65 72 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 ger, pBt->nPage)
1b5b0 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
1b5c0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1b5d0 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f agerCommitPhaseO
1b5e0 6e 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 ne(pBt->pPager,
1b5f0 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 zMaster, 0);.
1b600 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1b610 76 65 28 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 ve(p);. }. ret
1b620 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1b630 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
1b640 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 62 6f s called from bo
1b650 74 68 20 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 th BtreeCommitPh
1b660 61 73 65 54 77 6f 28 29 20 61 6e 64 20 42 74 72 aseTwo() and Btr
1b670 65 65 52 6f 6c 6c 62 61 63 6b 28 29 0a 2a 2a 20 eeRollback().**
1b680 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f at the conclusio
1b690 6e 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 n of a transacti
1b6a0 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f on..*/.static vo
1b6b0 69 64 20 62 74 72 65 65 45 6e 64 54 72 61 6e 73 id btreeEndTrans
1b6c0 61 63 74 69 6f 6e 28 42 74 72 65 65 20 2a 70 29 action(Btree *p)
1b6d0 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
1b6e0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 t = p->pBt;. sq
1b6f0 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 lite3 *db = p->d
1b700 62 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c b;. assert( sql
1b710 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 ite3BtreeHoldsMu
1b720 74 65 78 28 70 29 20 29 3b 0a 0a 23 69 66 6e 64 tex(p) );..#ifnd
1b730 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
1b740 55 54 4f 56 41 43 55 55 4d 0a 20 20 70 42 74 2d UTOVACUUM. pBt-
1b750 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 30 >bDoTruncate = 0
1b760 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 ;.#endif. if( p
1b770 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f ->inTrans>TRANS_
1b780 4e 4f 4e 45 20 26 26 20 64 62 2d 3e 6e 56 64 62 NONE && db->nVdb
1b790 65 52 65 61 64 3e 31 20 29 7b 0a 20 20 20 20 2f eRead>1 ){. /
1b7a0 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f * If there are o
1b7b0 74 68 65 72 20 61 63 74 69 76 65 20 73 74 61 74 ther active stat
1b7c0 65 6d 65 6e 74 73 20 74 68 61 74 20 62 65 6c 6f ements that belo
1b7d0 6e 67 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 ng to this datab
1b7e0 61 73 65 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c ase. ** handl
1b7f0 65 2c 20 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 e, downgrade to
1b800 61 20 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e a read-only tran
1b810 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 6f 74 68 saction. The oth
1b820 65 72 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 er statements.
1b830 20 20 2a 2a 20 6d 61 79 20 73 74 69 6c 6c 20 62 ** may still b
1b840 65 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 e reading from t
1b850 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 2a 2f he database. */
1b860 0a 20 20 20 20 64 6f 77 6e 67 72 61 64 65 41 6c . downgradeAl
1b870 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c lSharedCacheTabl
1b880 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 70 eLocks(p);. p
1b890 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e ->inTrans = TRAN
1b8a0 53 5f 52 45 41 44 3b 0a 20 20 7d 65 6c 73 65 7b S_READ;. }else{
1b8b0 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 68 . /* If the h
1b8c0 61 6e 64 6c 65 20 68 61 64 20 61 6e 79 20 6b 69 andle had any ki
1b8d0 6e 64 20 6f 66 20 74 72 61 6e 73 61 63 74 69 6f nd of transactio
1b8e0 6e 20 6f 70 65 6e 2c 20 64 65 63 72 65 6d 65 6e n open, decremen
1b8f0 74 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 74 72 t the . ** tr
1b900 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 ansaction count
1b910 6f 66 20 74 68 65 20 73 68 61 72 65 64 20 62 74 of the shared bt
1b920 72 65 65 2e 20 49 66 20 74 68 65 20 74 72 61 6e ree. If the tran
1b930 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 0a 20 saction count .
1b940 20 20 20 2a 2a 20 72 65 61 63 68 65 73 20 30 2c ** reaches 0,
1b950 20 73 65 74 20 74 68 65 20 73 68 61 72 65 64 20 set the shared
1b960 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e state to TRANS_N
1b970 4f 4e 45 2e 20 54 68 65 20 75 6e 6c 6f 63 6b 42 ONE. The unlockB
1b980 74 72 65 65 49 66 55 6e 75 73 65 64 28 29 0a 20 treeIfUnused().
1b990 20 20 20 2a 2a 20 63 61 6c 6c 20 62 65 6c 6f 77 ** call below
1b9a0 20 77 69 6c 6c 20 75 6e 6c 6f 63 6b 20 74 68 65 will unlock the
1b9b0 20 70 61 67 65 72 2e 20 20 2a 2f 0a 20 20 20 20 pager. */.
1b9c0 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 21 3d if( p->inTrans!=
1b9d0 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 TRANS_NONE ){.
1b9e0 20 20 20 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 clearAllShar
1b9f0 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
1ba00 73 28 70 29 3b 0a 20 20 20 20 20 20 70 42 74 2d s(p);. pBt-
1ba10 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 2d 2d 3b >nTransaction--;
1ba20 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 70 42 . if( 0==pB
1ba30 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 t->nTransaction
1ba40 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e ){. pBt->
1ba50 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 inTransaction =
1ba60 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 TRANS_NONE;.
1ba70 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f }. }.. /
1ba80 2a 20 53 65 74 20 74 68 65 20 63 75 72 72 65 6e * Set the curren
1ba90 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 t transaction st
1baa0 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e ate to TRANS_NON
1bab0 45 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 E and unlock the
1bac0 20 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 69 . ** pager i
1bad0 66 20 74 68 69 73 20 63 61 6c 6c 20 63 6c 6f 73 f this call clos
1bae0 65 64 20 74 68 65 20 6f 6e 6c 79 20 72 65 61 64 ed the only read
1baf0 20 6f 72 20 77 72 69 74 65 20 74 72 61 6e 73 61 or write transa
1bb00 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 70 ction. */. p
1bb10 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e ->inTrans = TRAN
1bb20 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 75 6e 6c 6f S_NONE;. unlo
1bb30 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 ckBtreeIfUnused(
1bb40 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 pBt);. }.. btr
1bb50 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a eeIntegrity(p);.
1bb60 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 }../*.** Commit
1bb70 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
1bb80 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 70 72 6f currently in pro
1bb90 67 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 gress..**.** Thi
1bba0 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d s routine implem
1bbb0 65 6e 74 73 20 74 68 65 20 73 65 63 6f 6e 64 20 ents the second
1bbc0 70 68 61 73 65 20 6f 66 20 61 20 32 2d 70 68 61 phase of a 2-pha
1bbd0 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 65 0a se commit. The.
1bbe0 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 ** sqlite3BtreeC
1bbf0 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 20 ommitPhaseOne()
1bc00 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 routine does the
1bc10 20 66 69 72 73 74 20 70 68 61 73 65 20 61 6e 64 first phase and
1bc20 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 65 20 69 6e should.** be in
1bc30 76 6f 6b 65 64 20 70 72 69 6f 72 20 74 6f 20 63 voked prior to c
1bc40 61 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 alling this rout
1bc50 69 6e 65 2e 20 20 54 68 65 20 73 71 6c 69 74 65 ine. The sqlite
1bc60 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 3BtreeCommitPhas
1bc70 65 4f 6e 65 28 29 0a 2a 2a 20 72 6f 75 74 69 6e eOne().** routin
1bc80 65 20 64 69 64 20 61 6c 6c 20 74 68 65 20 77 6f e did all the wo
1bc90 72 6b 20 6f 66 20 77 72 69 74 69 6e 67 20 69 6e rk of writing in
1bca0 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 74 20 74 6f formation out to
1bcb0 20 64 69 73 6b 20 61 6e 64 20 66 6c 75 73 68 69 disk and flushi
1bcc0 6e 67 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e ng the.** conten
1bcd0 74 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 ts so that they
1bce0 61 72 65 20 77 72 69 74 74 65 6e 20 6f 6e 74 6f are written onto
1bcf0 20 74 68 65 20 64 69 73 6b 20 70 6c 61 74 74 65 the disk platte
1bd00 72 2e 20 20 41 6c 6c 20 74 68 69 73 0a 2a 2a 20 r. All this.**
1bd10 72 6f 75 74 69 6e 65 20 68 61 73 20 74 6f 20 64 routine has to d
1bd20 6f 20 69 73 20 64 65 6c 65 74 65 20 6f 72 20 74 o is delete or t
1bd30 72 75 6e 63 61 74 65 20 6f 72 20 7a 65 72 6f 20 runcate or zero
1bd40 74 68 65 20 68 65 61 64 65 72 20 69 6e 20 74 68 the header in th
1bd50 65 0a 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 61 63 e.** the rollbac
1bd60 6b 20 6a 6f 75 72 6e 61 6c 20 28 77 68 69 63 68 k journal (which
1bd70 20 63 61 75 73 65 73 20 74 68 65 20 74 72 61 6e causes the tran
1bd80 73 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d 69 saction to commi
1bd90 74 29 20 61 6e 64 0a 2a 2a 20 64 72 6f 70 20 6c t) and.** drop l
1bda0 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d ocks..**.** Norm
1bdb0 61 6c 6c 79 2c 20 69 66 20 61 6e 20 65 72 72 6f ally, if an erro
1bdc0 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 r occurs while t
1bdd0 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 20 69 he pager layer i
1bde0 73 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 s attempting to
1bdf0 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 .** finalize the
1be00 20 75 6e 64 65 72 6c 79 69 6e 67 20 6a 6f 75 72 underlying jour
1be10 6e 61 6c 20 66 69 6c 65 2c 20 74 68 69 73 20 66 nal file, this f
1be20 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
1be30 61 6e 20 65 72 72 6f 72 20 61 6e 64 0a 2a 2a 20 an error and.**
1be40 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 the upper layer
1be50 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 61 20 72 will attempt a r
1be60 6f 6c 6c 62 61 63 6b 2e 20 48 6f 77 65 76 65 72 ollback. However
1be70 2c 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 , if the second
1be80 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 69 73 20 6e argument.** is n
1be90 6f 6e 2d 7a 65 72 6f 20 74 68 65 6e 20 74 68 69 on-zero then thi
1bea0 73 20 62 2d 74 72 65 65 20 74 72 61 6e 73 61 63 s b-tree transac
1beb0 74 69 6f 6e 20 69 73 20 70 61 72 74 20 6f 66 20 tion is part of
1bec0 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 0a 2a 2a a multi-file .**
1bed0 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 6e transaction. In
1bee0 20 74 68 69 73 20 63 61 73 65 2c 20 74 68 65 20 this case, the
1bef0 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 transaction has
1bf00 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 6f 6d already been com
1bf10 6d 69 74 74 65 64 20 0a 2a 2a 20 28 62 79 20 64 mitted .** (by d
1bf20 65 6c 65 74 69 6e 67 20 61 20 6d 61 73 74 65 72 eleting a master
1bf30 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 journal file) a
1bf40 6e 64 20 74 68 65 20 63 61 6c 6c 65 72 20 77 69 nd the caller wi
1bf50 6c 6c 20 69 67 6e 6f 72 65 20 74 68 69 73 20 0a ll ignore this .
1bf60 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 ** functions ret
1bf70 75 72 6e 20 63 6f 64 65 2e 20 53 6f 2c 20 65 76 urn code. So, ev
1bf80 65 6e 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f en if an error o
1bf90 63 63 75 72 73 20 69 6e 20 74 68 65 20 70 61 67 ccurs in the pag
1bfa0 65 72 20 6c 61 79 65 72 2c 0a 2a 2a 20 72 65 73 er layer,.** res
1bfb0 65 74 20 74 68 65 20 62 2d 74 72 65 65 20 6f 62 et the b-tree ob
1bfc0 6a 65 63 74 73 20 69 6e 74 65 72 6e 61 6c 20 73 jects internal s
1bfd0 74 61 74 65 20 74 6f 20 69 6e 64 69 63 61 74 65 tate to indicate
1bfe0 20 74 68 61 74 20 74 68 65 20 77 72 69 74 65 0a that the write.
1bff0 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 ** transaction h
1c000 61 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 2e 20 as been closed.
1c010 54 68 69 73 20 69 73 20 71 75 69 74 65 20 73 61 This is quite sa
1c020 66 65 2c 20 61 73 20 74 68 65 20 70 61 67 65 72 fe, as the pager
1c030 20 77 69 6c 6c 20 68 61 76 65 0a 2a 2a 20 74 72 will have.** tr
1c040 61 6e 73 69 74 69 6f 6e 65 64 20 74 6f 20 74 68 ansitioned to th
1c050 65 20 65 72 72 6f 72 20 73 74 61 74 65 2e 0a 2a e error state..*
1c060 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c 20 72 *.** This will r
1c070 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 74 65 elease the write
1c080 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
1c090 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 abase file. If
1c0a0 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 there.** are no
1c0b0 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 2c 20 active cursors,
1c0c0 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 65 73 it also releases
1c0d0 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a the read lock..
1c0e0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1c0f0 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 reeCommitPhaseTw
1c100 6f 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 o(Btree *p, int
1c110 62 43 6c 65 61 6e 75 70 29 7b 0a 0a 20 20 69 66 bCleanup){.. if
1c120 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 ( p->inTrans==TR
1c130 41 4e 53 5f 4e 4f 4e 45 20 29 20 72 65 74 75 72 ANS_NONE ) retur
1c140 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 n SQLITE_OK;. s
1c150 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1c160 28 70 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 (p);. btreeInte
1c170 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 grity(p);.. /*
1c180 49 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 61 If the handle ha
1c190 73 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 s a write-transa
1c1a0 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 63 6f 6d 6d ction open, comm
1c1b0 69 74 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 it the shared-bt
1c1c0 72 65 65 73 20 0a 20 20 2a 2a 20 74 72 61 6e 73 rees . ** trans
1c1d0 61 63 74 69 6f 6e 20 61 6e 64 20 73 65 74 20 74 action and set t
1c1e0 68 65 20 73 68 61 72 65 64 20 73 74 61 74 65 20 he shared state
1c1f0 74 6f 20 54 52 41 4e 53 5f 52 45 41 44 2e 0a 20 to TRANS_READ..
1c200 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 */. if( p->inT
1c210 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 rans==TRANS_WRIT
1c220 45 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b E ){. int rc;
1c230 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 . BtShared *p
1c240 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 Bt = p->pBt;.
1c250 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e assert( pBt->in
1c260 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 Transaction==TRA
1c270 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 20 20 NS_WRITE );.
1c280 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 54 72 assert( pBt->nTr
1c290 61 6e 73 61 63 74 69 6f 6e 3e 30 20 29 3b 0a 20 ansaction>0 );.
1c2a0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1c2b0 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 54 agerCommitPhaseT
1c2c0 77 6f 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b wo(pBt->pPager);
1c2d0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
1c2e0 49 54 45 5f 4f 4b 20 26 26 20 62 43 6c 65 61 6e ITE_OK && bClean
1c2f0 75 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 up==0 ){. s
1c300 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
1c310 28 70 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 (p);. retur
1c320 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
1c330 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
1c340 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b on = TRANS_READ;
1c350 0a 20 20 20 20 62 74 72 65 65 43 6c 65 61 72 48 . btreeClearH
1c360 61 73 43 6f 6e 74 65 6e 74 28 70 42 74 29 3b 0a asContent(pBt);.
1c370 20 20 7d 0a 0a 20 20 62 74 72 65 65 45 6e 64 54 }.. btreeEndT
1c380 72 61 6e 73 61 63 74 69 6f 6e 28 70 29 3b 0a 20 ransaction(p);.
1c390 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1c3a0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
1c3b0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1c3c0 0a 2a 2a 20 44 6f 20 62 6f 74 68 20 70 68 61 73 .** Do both phas
1c3d0 65 73 20 6f 66 20 61 20 63 6f 6d 6d 69 74 2e 0a es of a commit..
1c3e0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1c3f0 72 65 65 43 6f 6d 6d 69 74 28 42 74 72 65 65 20 reeCommit(Btree
1c400 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 *p){. int rc;.
1c410 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1c420 65 72 28 70 29 3b 0a 20 20 72 63 20 3d 20 73 71 er(p);. rc = sq
1c430 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1c440 50 68 61 73 65 4f 6e 65 28 70 2c 20 30 29 3b 0a PhaseOne(p, 0);.
1c450 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1c460 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 _OK ){. rc =
1c470 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d sqlite3BtreeComm
1c480 69 74 50 68 61 73 65 54 77 6f 28 70 2c 20 30 29 itPhaseTwo(p, 0)
1c490 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 ;. }. sqlite3B
1c4a0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
1c4b0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1c4c0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
1c4d0 20 73 65 74 73 20 74 68 65 20 73 74 61 74 65 20 sets the state
1c4e0 74 6f 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 to CURSOR_FAULT
1c4f0 61 6e 64 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a and the error.**
1c500 20 63 6f 64 65 20 74 6f 20 65 72 72 43 6f 64 65 code to errCode
1c510 20 66 6f 72 20 65 76 65 72 79 20 63 75 72 73 6f for every curso
1c520 72 20 6f 6e 20 42 74 53 68 61 72 65 64 20 74 68 r on BtShared th
1c530 61 74 20 70 42 74 72 65 65 0a 2a 2a 20 72 65 66 at pBtree.** ref
1c540 65 72 65 6e 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 45 erences..**.** E
1c550 76 65 72 79 20 63 75 72 73 6f 72 20 69 73 20 74 very cursor is t
1c560 72 69 70 70 65 64 2c 20 69 6e 63 6c 75 64 69 6e ripped, includin
1c570 67 20 63 75 72 73 6f 72 73 20 74 68 61 74 20 62 g cursors that b
1c580 65 6c 6f 6e 67 0a 2a 2a 20 74 6f 20 6f 74 68 65 elong.** to othe
1c590 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 r database conne
1c5a0 63 74 69 6f 6e 73 20 74 68 61 74 20 68 61 70 70 ctions that happ
1c5b0 65 6e 20 74 6f 20 62 65 20 73 68 61 72 69 6e 67 en to be sharing
1c5c0 0a 2a 2a 20 74 68 65 20 63 61 63 68 65 20 77 69 .** the cache wi
1c5d0 74 68 20 70 42 74 72 65 65 2e 0a 2a 2a 0a 2a 2a th pBtree..**.**
1c5e0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 67 65 This routine ge
1c5f0 74 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 ts called when a
1c600 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 rollback occurs
1c610 2e 0a 2a 2a 20 41 6c 6c 20 63 75 72 73 6f 72 73 ..** All cursors
1c620 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 using the same
1c630 63 61 63 68 65 20 6d 75 73 74 20 62 65 20 74 72 cache must be tr
1c640 69 70 70 65 64 0a 2a 2a 20 74 6f 20 70 72 65 76 ipped.** to prev
1c650 65 6e 74 20 74 68 65 6d 20 66 72 6f 6d 20 74 72 ent them from tr
1c660 79 69 6e 67 20 74 6f 20 75 73 65 20 74 68 65 20 ying to use the
1c670 62 74 72 65 65 20 61 66 74 65 72 0a 2a 2a 20 74 btree after.** t
1c680 68 65 20 72 6f 6c 6c 62 61 63 6b 2e 20 20 54 68 he rollback. Th
1c690 65 20 72 6f 6c 6c 62 61 63 6b 20 6d 61 79 20 68 e rollback may h
1c6a0 61 76 65 20 64 65 6c 65 74 65 64 20 74 61 62 6c ave deleted tabl
1c6b0 65 73 0a 2a 2a 20 6f 72 20 6d 6f 76 65 64 20 72 es.** or moved r
1c6c0 6f 6f 74 20 70 61 67 65 73 2c 20 73 6f 20 69 74 oot pages, so it
1c6d0 20 69 73 20 6e 6f 74 20 73 75 66 66 69 63 69 65 is not sufficie
1c6e0 6e 74 20 74 6f 0a 2a 2a 20 73 61 76 65 20 74 68 nt to.** save th
1c6f0 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 63 e state of the c
1c700 75 72 73 6f 72 2e 20 20 54 68 65 20 63 75 72 73 ursor. The curs
1c710 6f 72 20 6d 75 73 74 20 62 65 0a 2a 2a 20 69 6e or must be.** in
1c720 76 61 6c 69 64 61 74 65 64 2e 0a 2a 2f 0a 76 6f validated..*/.vo
1c730 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 54 id sqlite3BtreeT
1c740 72 69 70 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 ripAllCursors(Bt
1c750 72 65 65 20 2a 70 42 74 72 65 65 2c 20 69 6e 74 ree *pBtree, int
1c760 20 65 72 72 43 6f 64 65 29 7b 0a 20 20 42 74 43 errCode){. BtC
1c770 75 72 73 6f 72 20 2a 70 3b 0a 20 20 69 66 28 20 ursor *p;. if(
1c780 70 42 74 72 65 65 3d 3d 30 20 29 20 72 65 74 75 pBtree==0 ) retu
1c790 72 6e 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 rn;. sqlite3Btr
1c7a0 65 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b eeEnter(pBtree);
1c7b0 0a 20 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d . for(p=pBtree-
1c7c0 3e 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 >pBt->pCursor; p
1c7d0 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 ; p=p->pNext){.
1c7e0 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 73 71 int i;. sq
1c7f0 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 lite3BtreeClearC
1c800 75 72 73 6f 72 28 70 29 3b 0a 20 20 20 20 70 2d ursor(p);. p-
1c810 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
1c820 5f 46 41 55 4c 54 3b 0a 20 20 20 20 70 2d 3e 73 _FAULT;. p->s
1c830 6b 69 70 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 kipNext = errCod
1c840 65 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 e;. for(i=0;
1c850 69 3c 3d 70 2d 3e 69 50 61 67 65 3b 20 69 2b 2b i<=p->iPage; i++
1c860 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 ){. release
1c870 50 61 67 65 28 70 2d 3e 61 70 50 61 67 65 5b 69 Page(p->apPage[i
1c880 5d 29 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 50 ]);. p->apP
1c890 61 67 65 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20 age[i] = 0;.
1c8a0 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 }. }. sqlite3B
1c8b0 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 treeLeave(pBtree
1c8c0 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c );.}../*.** Roll
1c8d0 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 61 63 back the transac
1c8e0 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 tion in progress
1c8f0 2e 20 20 41 6c 6c 20 63 75 72 73 6f 72 73 20 77 . All cursors w
1c900 69 6c 6c 20 62 65 0a 2a 2a 20 69 6e 76 61 6c 69 ill be.** invali
1c910 64 65 64 20 62 79 20 74 68 69 73 20 6f 70 65 72 ded by this oper
1c920 61 74 69 6f 6e 2e 20 20 41 6e 79 20 61 74 74 65 ation. Any atte
1c930 6d 70 74 20 74 6f 20 75 73 65 20 61 20 63 75 72 mpt to use a cur
1c940 73 6f 72 0a 2a 2a 20 74 68 61 74 20 77 61 73 20 sor.** that was
1c950 6f 70 65 6e 20 61 74 20 74 68 65 20 62 65 67 69 open at the begi
1c960 6e 6e 69 6e 67 20 6f 66 20 74 68 69 73 20 6f 70 nning of this op
1c970 65 72 61 74 69 6f 6e 20 77 69 6c 6c 20 72 65 73 eration will res
1c980 75 6c 74 0a 2a 2a 20 69 6e 20 61 6e 20 65 72 72 ult.** in an err
1c990 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 or..**.** This w
1c9a0 69 6c 6c 20 72 65 6c 65 61 73 65 20 74 68 65 20 ill release the
1c9b0 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 write lock on th
1c9c0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
1c9d0 20 20 49 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 If there.** ar
1c9e0 65 20 6e 6f 20 61 63 74 69 76 65 20 63 75 72 73 e no active curs
1c9f0 6f 72 73 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c ors, it also rel
1ca00 65 61 73 65 73 20 74 68 65 20 72 65 61 64 20 6c eases the read l
1ca10 6f 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ock..*/.int sqli
1ca20 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b te3BtreeRollback
1ca30 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 (Btree *p, int t
1ca40 72 69 70 43 6f 64 65 29 7b 0a 20 20 69 6e 74 20 ripCode){. int
1ca50 72 63 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a rc;. BtShared *
1ca60 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
1ca70 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 3b MemPage *pPage1;
1ca80 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 .. sqlite3Btree
1ca90 45 6e 74 65 72 28 70 29 3b 0a 20 20 69 66 28 20 Enter(p);. if(
1caa0 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 tripCode==SQLITE
1cab0 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 _OK ){. rc =
1cac0 74 72 69 70 43 6f 64 65 20 3d 20 73 61 76 65 41 tripCode = saveA
1cad0 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 30 llCursors(pBt, 0
1cae0 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 , 0);. }else{.
1caf0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
1cb00 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 74 72 69 K;. }. if( tri
1cb10 70 43 6f 64 65 20 29 7b 0a 20 20 20 20 73 71 6c pCode ){. sql
1cb20 69 74 65 33 42 74 72 65 65 54 72 69 70 41 6c 6c ite3BtreeTripAll
1cb30 43 75 72 73 6f 72 73 28 70 2c 20 74 72 69 70 43 Cursors(p, tripC
1cb40 6f 64 65 29 3b 0a 20 20 7d 0a 20 20 62 74 72 65 ode);. }. btre
1cb50 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a eIntegrity(p);..
1cb60 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1cb70 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b ==TRANS_WRITE ){
1cb80 0a 20 20 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 . int rc2;..
1cb90 20 20 20 61 73 73 65 72 74 28 20 54 52 41 4e 53 assert( TRANS
1cba0 5f 57 52 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 _WRITE==pBt->inT
1cbb0 72 61 6e 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 ransaction );.
1cbc0 20 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 50 rc2 = sqlite3P
1cbd0 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 agerRollback(pBt
1cbe0 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 ->pPager);. i
1cbf0 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f f( rc2!=SQLITE_O
1cc00 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 K ){. rc =
1cc10 72 63 32 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 rc2;. }..
1cc20 2f 2a 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 /* The rollback
1cc30 6d 61 79 20 68 61 76 65 20 64 65 73 74 72 6f 79 may have destroy
1cc40 65 64 20 74 68 65 20 70 50 61 67 65 31 2d 3e 61 ed the pPage1->a
1cc50 44 61 74 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a Data value. So.
1cc60 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 ** call btre
1cc70 65 47 65 74 50 61 67 65 28 29 20 6f 6e 20 70 61 eGetPage() on pa
1cc80 67 65 20 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 ge 1 again to ma
1cc90 6b 65 0a 20 20 20 20 2a 2a 20 73 75 72 65 20 70 ke. ** sure p
1cca0 50 61 67 65 31 2d 3e 61 44 61 74 61 20 69 73 20 Page1->aData is
1ccb0 73 65 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a set correctly. *
1ccc0 2f 0a 20 20 20 20 69 66 28 20 62 74 72 65 65 47 /. if( btreeG
1ccd0 65 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 etPage(pBt, 1, &
1cce0 70 50 61 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 pPage1, 0)==SQLI
1ccf0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
1cd00 6e 74 20 6e 50 61 67 65 20 3d 20 67 65 74 34 62 nt nPage = get4b
1cd10 79 74 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 yte(28+(u8*)pPag
1cd20 65 31 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 e1->aData);.
1cd30 20 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 67 testcase( nPag
1cd40 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 e==0 );. if
1cd50 28 20 6e 50 61 67 65 3d 3d 30 20 29 20 73 71 6c ( nPage==0 ) sql
1cd60 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 ite3PagerPagecou
1cd70 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 nt(pBt->pPager,
1cd80 26 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 74 &nPage);. t
1cd90 65 73 74 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 estcase( pBt->nP
1cda0 61 67 65 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 age!=nPage );.
1cdb0 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d pBt->nPage =
1cdc0 20 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 72 65 nPage;. re
1cdd0 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 leasePage(pPage1
1cde0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 );. }. ass
1cdf0 65 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 ert( countValidC
1ce00 75 72 73 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d ursors(pBt, 1)==
1ce10 30 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 0 );. pBt->in
1ce20 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 Transaction = TR
1ce30 41 4e 53 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 ANS_READ;. bt
1ce40 72 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 reeClearHasConte
1ce50 6e 74 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 nt(pBt);. }..
1ce60 62 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 btreeEndTransact
1ce70 69 6f 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 ion(p);. sqlite
1ce80 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
1ce90 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1cea0 2f 2a 0a 2a 2a 20 53 74 61 72 74 20 61 20 73 74 /*.** Start a st
1ceb0 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
1cec0 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 action. The subt
1ced0 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 ransaction can b
1cee0 65 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b e rolled.** back
1cef0 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f independently o
1cf00 66 20 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 f the main trans
1cf10 61 63 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 action. You must
1cf20 20 73 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 start a transac
1cf30 74 69 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 tion .** before
1cf40 73 74 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 starting a subtr
1cf50 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 ansaction. The s
1cf60 75 62 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 ubtransaction is
1cf70 20 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 ended automatic
1cf80 61 6c 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 ally .** if the
1cf90 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e main transaction
1cfa0 20 63 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c commits or roll
1cfb0 73 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 s back..**.** St
1cfc0 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
1cfd0 61 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 actions are used
1cfe0 20 61 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 around individu
1cff0 61 6c 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 al SQL statement
1d000 73 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f s.** that are co
1d010 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 ntained within a
1d020 20 42 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 BEGIN...COMMIT
1d030 62 6c 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e block. If a con
1d040 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 straint.** error
1d050 20 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 occurs within t
1d060 68 65 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 he statement, th
1d070 65 20 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 e effect of that
1d080 20 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a one statement.*
1d090 2a 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 * can be rolled
1d0a0 62 61 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 back without hav
1d0b0 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 ing to rollback
1d0c0 74 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 the entire trans
1d0d0 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 action..**.** A
1d0e0 73 74 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 statement sub-tr
1d0f0 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 ansaction is imp
1d100 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 lemented as an a
1d110 6e 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 nonymous savepoi
1d120 6e 74 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 nt. The.** value
1d130 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 passed as the s
1d140 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 econd parameter
1d150 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d is the total num
1d160 62 65 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 ber of savepoint
1d170 73 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 s,.** including
1d180 74 68 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 the new anonymou
1d190 73 20 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 s savepoint, ope
1d1a0 6e 20 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e n on the B-Tree.
1d1b0 20 69 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a i.e. if there.*
1d1c0 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 * are no active
1d1d0 73 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e savepoints and n
1d1e0 6f 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e o other statemen
1d1f0 74 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f t-transactions o
1d200 70 65 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 pen,.** iStateme
1d210 6e 74 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e nt is 1. This an
1d220 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e onymous savepoin
1d230 74 20 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 t can be release
1d240 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b d or rolled back
1d250 0a 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 .** using the sq
1d260 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
1d270 69 6e 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a int() function..
1d280 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1d290 72 65 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 reeBeginStmt(Btr
1d2a0 65 65 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 ee *p, int iStat
1d2b0 65 6d 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 ement){. int rc
1d2c0 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
1d2d0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 t = p->pBt;. sq
1d2e0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
1d2f0 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d p);. assert( p-
1d300 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1d310 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 WRITE );. asser
1d320 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 t( (pBt->btsFlag
1d330 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
1d340 59 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 Y)==0 );. asser
1d350 74 28 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 t( iStatement>0
1d360 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 );. assert( iSt
1d370 61 74 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e atement>p->db->n
1d380 53 61 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 Savepoint );. a
1d390 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 ssert( pBt->inTr
1d3a0 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
1d3b0 5f 57 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 _WRITE );. /* A
1d3c0 74 20 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 t the pager leve
1d3d0 6c 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 l, a statement t
1d3e0 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 ransaction is a
1d3f0 73 61 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 savepoint with.
1d400 20 2a 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 ** an index gre
1d410 61 74 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 ater than all sa
1d420 76 65 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 vepoints created
1d430 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e explicitly usin
1d440 67 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 g. ** SQL state
1d450 6d 65 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c ments. It is ill
1d460 65 67 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 egal to open, re
1d470 6c 65 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 lease or rollbac
1d480 6b 20 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 k any. ** such
1d490 73 61 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 savepoints while
1d4a0 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 the statement t
1d4b0 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 ransaction savep
1d4c0 6f 69 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a oint is active..
1d4d0 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
1d4e0 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 te3PagerOpenSave
1d4f0 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 point(pBt->pPage
1d500 72 2c 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a r, iStatement);.
1d510 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
1d520 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
1d530 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
1d540 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
1d550 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 t to this functi
1d560 6f 6e 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 on, op, is alway
1d570 73 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c s SAVEPOINT_ROLL
1d580 42 41 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 BACK.** or SAVEP
1d590 4f 49 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 OINT_RELEASE. Th
1d5a0 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 is function eith
1d5b0 65 72 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 er releases or r
1d5c0 6f 6c 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a olls back the.**
1d5d0 20 73 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 savepoint ident
1d5e0 69 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 ified by paramet
1d5f0 65 72 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 er iSavepoint, d
1d600 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 epending on the
1d610 76 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e value .** of op.
1d620 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c .**.** Normally,
1d630 20 69 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 iSavepoint is g
1d640 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 reater than or e
1d650 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f qual to zero. Ho
1d660 77 65 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a wever, if op is.
1d670 2a 2a 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c ** SAVEPOINT_ROL
1d680 4c 42 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 LBACK, then iSav
1d690 65 70 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 epoint may also
1d6a0 62 65 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 be -1. In this c
1d6b0 61 73 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 ase the .** cont
1d6c0 65 6e 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 ents of the enti
1d6d0 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 re transaction a
1d6e0 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 re rolled back.
1d6f0 54 68 69 73 20 69 73 20 64 69 66 66 65 72 65 6e This is differen
1d700 74 0a 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d t.** from a norm
1d710 61 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 al transaction r
1d720 6f 6c 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c ollback, as no l
1d730 6f 63 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 ocks are release
1d740 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 d and the.** tra
1d750 6e 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 nsaction remains
1d760 20 6f 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 open..*/.int sq
1d770 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
1d780 69 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e int(Btree *p, in
1d790 74 20 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 t op, int iSavep
1d7a0 6f 69 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 oint){. int rc
1d7b0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
1d7c0 66 28 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 f( p && p->inTra
1d7d0 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 ns==TRANS_WRITE
1d7e0 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 ){. BtShared
1d7f0 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
1d800 20 20 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 assert( op==S
1d810 41 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 AVEPOINT_RELEASE
1d820 20 7c 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e || op==SAVEPOIN
1d830 54 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 T_ROLLBACK );.
1d840 20 20 61 73 73 65 72 74 28 20 69 53 61 76 65 70 assert( iSavep
1d850 6f 69 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 oint>=0 || (iSav
1d860 65 70 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 epoint==-1 && op
1d870 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c ==SAVEPOINT_ROLL
1d880 42 41 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c BACK) );. sql
1d890 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1d8a0 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
1d8b0 74 65 33 50 61 67 65 72 53 61 76 65 70 6f 69 6e te3PagerSavepoin
1d8c0 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6f t(pBt->pPager, o
1d8d0 70 2c 20 69 53 61 76 65 70 6f 69 6e 74 29 3b 0a p, iSavepoint);.
1d8e0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1d8f0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
1d900 66 28 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 f( iSavepoint<0
1d910 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 && (pBt->btsFlag
1d920 73 20 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c s & BTS_INITIALL
1d930 59 5f 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 Y_EMPTY)!=0 ){.
1d940 20 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 pBt->nPag
1d950 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 e = 0;. }.
1d960 20 20 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 rc = newDat
1d970 61 62 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 abase(pBt);.
1d980 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 pBt->nPage = g
1d990 65 74 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 et4byte(28 + pBt
1d9a0 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 ->pPage1->aData)
1d9b0 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ;.. /* The
1d9c0 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 database size wa
1d9d0 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 s written into t
1d9e0 68 65 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 he offset 28 of
1d9f0 74 68 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 the header.
1da00 20 2a 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 ** when the tra
1da10 6e 73 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 nsaction started
1da20 2c 20 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 , so we know tha
1da30 74 20 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f t the value at o
1da40 66 66 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 ffset. ** 2
1da50 38 20 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 8 is nonzero. */
1da60 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
1da70 42 74 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 Bt->nPage>0 );.
1da80 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
1da90 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1daa0 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
1dab0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 }../*.** Create
1dac0 61 20 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 a new cursor for
1dad0 20 74 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 the BTree whose
1dae0 20 72 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 root is on the
1daf0 70 61 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 page.** iTable.
1db00 49 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 If a read-only c
1db10 75 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 ursor is request
1db20 65 64 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 ed, it is assume
1db30 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 d that.** the ca
1db40 6c 6c 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 ller already has
1db50 20 61 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 at least a read
1db60 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f -only transactio
1db70 6e 20 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 n open.** on the
1db80 20 64 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 database alread
1db90 79 2e 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 y. If a write-cu
1dba0 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 rsor is requeste
1dbb0 64 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 d, then.** the c
1dbc0 61 6c 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 aller is assumed
1dbd0 20 74 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e to have an open
1dbe0 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
1dbf0 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 77 72 46 on..**.** If wrF
1dc00 6c 61 67 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 lag==0, then the
1dc10 20 63 75 72 73 6f 72 20 63 61 6e 20 6f 6e 6c 79 cursor can only
1dc20 20 62 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 be used for rea
1dc30 64 69 6e 67 2e 0a 2a 2a 20 49 66 20 77 72 46 6c ding..** If wrFl
1dc40 61 67 3d 3d 31 2c 20 74 68 65 6e 20 74 68 65 20 ag==1, then the
1dc50 63 75 72 73 6f 72 20 63 61 6e 20 62 65 20 75 73 cursor can be us
1dc60 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f ed for reading o
1dc70 72 20 66 6f 72 0a 2a 2a 20 77 72 69 74 69 6e 67 r for.** writing
1dc80 20 69 66 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 if other condit
1dc90 69 6f 6e 73 20 66 6f 72 20 77 72 69 74 69 6e 67 ions for writing
1dca0 20 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 are also met.
1dcb0 54 68 65 73 65 0a 2a 2a 20 61 72 65 20 74 68 65 These.** are the
1dcc0 20 63 6f 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 conditions that
1dcd0 20 6d 75 73 74 20 62 65 20 6d 65 74 20 69 6e 20 must be met in
1dce0 6f 72 64 65 72 20 66 6f 72 20 77 72 69 74 69 6e order for writin
1dcf0 67 20 74 6f 0a 2a 2a 20 62 65 20 61 6c 6c 6f 77 g to.** be allow
1dd00 65 64 3a 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 ed:.**.** 1: Th
1dd10 65 20 63 75 72 73 6f 72 20 6d 75 73 74 20 68 61 e cursor must ha
1dd20 76 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 ve been opened w
1dd30 69 74 68 20 77 72 46 6c 61 67 3d 3d 31 0a 2a 2a ith wrFlag==1.**
1dd40 0a 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 61 .** 2: Other da
1dd50 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1dd60 6e 73 20 74 68 61 74 20 73 68 61 72 65 20 74 68 ns that share th
1dd70 65 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 63 e same pager cac
1dd80 68 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 68 he.** but wh
1dd90 69 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 ich are not in t
1dda0 68 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 he READ_UNCOMMIT
1ddb0 54 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e 6f TED state may no
1ddc0 74 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 t have.** cu
1ddd0 72 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 20 rsors open with
1dde0 77 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 wrFlag==0 on the
1ddf0 20 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 same table. Ot
1de00 68 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 herwise.** t
1de10 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 he changes made
1de20 62 79 20 74 68 69 73 20 77 72 69 74 65 20 63 75 by this write cu
1de30 72 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 69 rsor would be vi
1de40 73 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 sible to.**
1de50 74 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 the read cursors
1de60 20 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 61 in the other da
1de70 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1de80 6e 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 n..**.** 3: The
1de90 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 database must b
1dea0 65 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 e writable (not
1deb0 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 on read-only med
1dec0 69 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 ia).**.** 4: Th
1ded0 65 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 61 ere must be an a
1dee0 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f ctive transactio
1def0 6e 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 20 63 68 65 63 n..**.** No chec
1df00 6b 69 6e 67 20 69 73 20 64 6f 6e 65 20 74 6f 20 king is done to
1df10 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 70 make sure that p
1df20 61 67 65 20 69 54 61 62 6c 65 20 72 65 61 6c 6c age iTable reall
1df30 79 20 69 73 20 74 68 65 0a 2a 2a 20 72 6f 6f 74 y is the.** root
1df40 20 70 61 67 65 20 6f 66 20 61 20 62 2d 74 72 65 page of a b-tre
1df50 65 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 e. If it is not
1df60 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
1df70 72 20 61 63 71 75 69 72 65 64 0a 2a 2a 20 77 69 r acquired.** wi
1df80 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 ll not work corr
1df90 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 ectly..**.** It
1dfa0 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 is assumed that
1dfb0 74 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 the sqlite3Btree
1dfc0 43 75 72 73 6f 72 5a 65 72 6f 28 29 20 68 61 73 CursorZero() has
1dfd0 20 62 65 65 6e 20 63 61 6c 6c 65 64 0a 2a 2a 20 been called.**
1dfe0 6f 6e 20 70 43 75 72 20 74 6f 20 69 6e 69 74 69 on pCur to initi
1dff0 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 alize the memory
1e000 20 73 70 61 63 65 20 70 72 69 6f 72 20 74 6f 20 space prior to
1e010 69 6e 76 6f 6b 69 6e 67 20 74 68 69 73 20 72 6f invoking this ro
1e020 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 utine..*/.static
1e030 20 69 6e 74 20 62 74 72 65 65 43 75 72 73 6f 72 int btreeCursor
1e040 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 20 (. Btree *p,
1e050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e060 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
1e070 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 e btree */. int
1e080 20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 iTable,
1e090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e0a0 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 /* Root page
1e0b0 20 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f 70 65 of table to ope
1e0c0 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 6c 61 n */. int wrFla
1e0d0 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g,
1e0e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1e0f0 20 31 20 74 6f 20 77 72 69 74 65 2e 20 30 20 72 1 to write. 0 r
1e100 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 ead-only */. st
1e110 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 2a 70 4b ruct KeyInfo *pK
1e120 65 79 49 6e 66 6f 2c 20 20 20 20 20 20 20 20 20 eyInfo,
1e130 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
1e140 67 20 74 6f 20 63 6f 6d 70 61 72 69 73 6f 6e 20 g to comparison
1e150 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 42 74 function */. Bt
1e160 43 75 72 73 6f 72 20 2a 70 43 75 72 20 20 20 20 Cursor *pCur
1e170 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e180 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 66 6f /* Space fo
1e190 72 20 6e 65 77 20 63 75 72 73 6f 72 20 2a 2f 0a r new cursor */.
1e1a0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
1e1b0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 20 20 20 20 Bt = p->pBt;
1e1c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
1e1d0 68 61 72 65 64 20 62 2d 74 72 65 65 20 68 61 6e hared b-tree han
1e1e0 64 6c 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 dle */.. assert
1e1f0 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f ( sqlite3BtreeHo
1e200 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 ldsMutex(p) );.
1e210 20 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d assert( wrFlag=
1e220 3d 30 20 7c 7c 20 77 72 46 6c 61 67 3d 3d 31 20 =0 || wrFlag==1
1e230 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c );.. /* The fol
1e240 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 20 73 74 lowing assert st
1e250 61 74 65 6d 65 6e 74 73 20 76 65 72 69 66 79 20 atements verify
1e260 74 68 61 74 20 69 66 20 74 68 69 73 20 69 73 20 that if this is
1e270 61 20 73 68 61 72 61 62 6c 65 20 0a 20 20 2a 2a a sharable . **
1e280 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73 65 b-tree database
1e290 2c 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e , the connection
1e2a0 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 is holding the
1e2b0 72 65 71 75 69 72 65 64 20 74 61 62 6c 65 20 6c required table l
1e2c0 6f 63 6b 73 2c 20 0a 20 20 2a 2a 20 61 6e 64 20 ocks, . ** and
1e2d0 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 63 6f that no other co
1e2e0 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 6e 79 nnection has any
1e2f0 20 6f 70 65 6e 20 63 75 72 73 6f 72 20 74 68 61 open cursor tha
1e300 74 20 63 6f 6e 66 6c 69 63 74 73 20 77 69 74 68 t conflicts with
1e310 20 0a 20 20 2a 2a 20 74 68 69 73 20 6c 6f 63 6b . ** this lock
1e320 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
1e330 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 hasSharedCacheTa
1e340 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 62 6c bleLock(p, iTabl
1e350 65 2c 20 70 4b 65 79 49 6e 66 6f 21 3d 30 2c 20 e, pKeyInfo!=0,
1e360 77 72 46 6c 61 67 2b 31 29 20 29 3b 0a 20 20 61 wrFlag+1) );. a
1e370 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 ssert( wrFlag==0
1e380 20 7c 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 || !hasReadConf
1e390 6c 69 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 licts(p, iTable)
1e3a0 20 29 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 );.. /* Assert
1e3b0 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 that the caller
1e3c0 20 68 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 has opened the
1e3d0 72 65 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 required transac
1e3e0 74 69 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 tion. */. asser
1e3f0 74 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 t( p->inTrans>TR
1e400 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 ANS_NONE );. as
1e410 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
1e420 7c 7c 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 || p->inTrans==T
1e430 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 RANS_WRITE );.
1e440 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 assert( pBt->pPa
1e450 67 65 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 ge1 && pBt->pPag
1e460 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a 0a 20 20 e1->aData );..
1e470 69 66 28 20 4e 45 56 45 52 28 77 72 46 6c 61 67 if( NEVER(wrFlag
1e480 20 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 && (pBt->btsFla
1e490 67 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e gs & BTS_READ_ON
1e4a0 4c 59 29 21 3d 30 29 20 29 7b 0a 20 20 20 20 72 LY)!=0) ){. r
1e4b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 eturn SQLITE_REA
1e4c0 44 4f 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 DONLY;. }. if(
1e4d0 20 69 54 61 62 6c 65 3d 3d 31 20 26 26 20 62 74 iTable==1 && bt
1e4e0 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
1e4f0 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 )==0 ){. asse
1e500 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 29 3b rt( wrFlag==0 );
1e510 0a 20 20 20 20 69 54 61 62 6c 65 20 3d 20 30 3b . iTable = 0;
1e520 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 74 . }.. /* Now t
1e530 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 65 72 72 hat no other err
1e540 6f 72 73 20 63 61 6e 20 6f 63 63 75 72 2c 20 66 ors can occur, f
1e550 69 6e 69 73 68 20 66 69 6c 6c 69 6e 67 20 69 6e inish filling in
1e560 20 74 68 65 20 42 74 43 75 72 73 6f 72 0a 20 20 the BtCursor.
1e570 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 ** variables and
1e580 20 6c 69 6e 6b 20 74 68 65 20 63 75 72 73 6f 72 link the cursor
1e590 20 69 6e 74 6f 20 74 68 65 20 42 74 53 68 61 72 into the BtShar
1e5a0 65 64 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 70 ed list. */. p
1e5b0 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 3d 20 Cur->pgnoRoot =
1e5c0 28 50 67 6e 6f 29 69 54 61 62 6c 65 3b 0a 20 20 (Pgno)iTable;.
1e5d0 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d 31 pCur->iPage = -1
1e5e0 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 6e ;. pCur->pKeyIn
1e5f0 66 6f 20 3d 20 70 4b 65 79 49 6e 66 6f 3b 0a 20 fo = pKeyInfo;.
1e600 20 70 43 75 72 2d 3e 70 42 74 72 65 65 20 3d 20 pCur->pBtree =
1e610 70 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 20 3d p;. pCur->pBt =
1e620 20 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 pBt;. assert(
1e630 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 77 72 46 wrFlag==0 || wrF
1e640 6c 61 67 3d 3d 42 54 43 46 5f 57 72 69 74 65 46 lag==BTCF_WriteF
1e650 6c 61 67 20 29 3b 0a 20 20 70 43 75 72 2d 3e 63 lag );. pCur->c
1e660 75 72 46 6c 61 67 73 20 3d 20 77 72 46 6c 61 67 urFlags = wrFlag
1e670 3b 0a 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 20 ;. pCur->pNext
1e680 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
1e690 20 20 69 66 28 20 70 43 75 72 2d 3e 70 4e 65 78 if( pCur->pNex
1e6a0 74 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 70 t ){. pCur->p
1e6b0 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 43 Next->pPrev = pC
1e6c0 75 72 3b 0a 20 20 7d 0a 20 20 70 42 74 2d 3e 70 ur;. }. pBt->p
1e6d0 43 75 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 Cursor = pCur;.
1e6e0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
1e6f0 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a CURSOR_INVALID;.
1e700 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1e710 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 OK;.}.int sqlite
1e720 33 42 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 3BtreeCursor(.
1e730 42 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 Btree *p,
1e740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e750 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1e760 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e he btree */. in
1e770 74 20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 t iTable,
1e780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e790 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f /* Roo
1e7a0 74 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 t page of table
1e7b0 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 to open */. int
1e7c0 20 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 wrFlag,
1e7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e7e0 20 20 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f /* 1 to
1e7f0 20 77 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f write. 0 read-o
1e800 6e 6c 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 nly */. struct
1e810 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 KeyInfo *pKeyInf
1e820 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o,
1e830 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
1e840 67 20 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 20 g to xCompare()
1e850 2a 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 */. BtCursor *p
1e860 43 75 72 20 20 20 20 20 20 20 20 20 20 20 20 20 Cur
1e870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e880 20 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 63 75 /* Write new cu
1e890 72 73 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b 0a rsor here */.){.
1e8a0 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 int rc;. sqli
1e8b0 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
1e8c0 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 43 75 ;. rc = btreeCu
1e8d0 72 73 6f 72 28 70 2c 20 69 54 61 62 6c 65 2c 20 rsor(p, iTable,
1e8e0 77 72 46 6c 61 67 2c 20 70 4b 65 79 49 6e 66 6f wrFlag, pKeyInfo
1e8f0 2c 20 70 43 75 72 29 3b 0a 20 20 73 71 6c 69 74 , pCur);. sqlit
1e900 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
1e910 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
1e920 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
1e930 65 20 73 69 7a 65 20 6f 66 20 61 20 42 74 43 75 e size of a BtCu
1e940 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 62 rsor object in b
1e950 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ytes..**.** This
1e960 20 69 6e 74 65 72 66 61 63 65 73 20 69 73 20 6e interfaces is n
1e970 65 65 64 65 64 20 73 6f 20 74 68 61 74 20 75 73 eeded so that us
1e980 65 72 73 20 6f 66 20 63 75 72 73 6f 72 73 20 63 ers of cursors c
1e990 61 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a 2a an preallocate.*
1e9a0 2a 20 73 75 66 66 69 63 69 65 6e 74 20 73 74 6f * sufficient sto
1e9b0 72 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 63 rage to hold a c
1e9c0 75 72 73 6f 72 2e 20 20 54 68 65 20 42 74 43 75 ursor. The BtCu
1e9d0 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 6f rsor object is o
1e9e0 70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 72 paque.** to user
1e9f0 73 20 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f 74 s so they cannot
1ea00 20 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 29 do the sizeof()
1ea10 20 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 68 themselves - th
1ea20 65 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a 20 ey must call.**
1ea30 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f this routine..*/
1ea40 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
1ea50 65 43 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 64 eCursorSize(void
1ea60 29 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 4e ){. return ROUN
1ea70 44 38 28 73 69 7a 65 6f 66 28 42 74 43 75 72 73 D8(sizeof(BtCurs
1ea80 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 or));.}../*.** I
1ea90 6e 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 79 nitialize memory
1eaa0 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 63 6f that will be co
1eab0 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 42 nverted into a B
1eac0 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e 0a tCursor object..
1ead0 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c 65 **.** The simple
1eae0 20 61 70 70 72 6f 61 63 68 20 68 65 72 65 20 77 approach here w
1eaf0 6f 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 65 ould be to memse
1eb00 74 28 29 20 74 68 65 20 65 6e 74 69 72 65 20 6f t() the entire o
1eb10 62 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f bject.** to zero
1eb20 2e 20 20 42 75 74 20 69 74 20 74 75 72 6e 73 20 . But it turns
1eb30 6f 75 74 20 74 68 61 74 20 74 68 65 20 61 70 50 out that the apP
1eb40 61 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 5b age[] and aiIdx[
1eb50 5d 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 6e ] arrays.** do n
1eb60 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 7a 65 ot need to be ze
1eb70 72 6f 65 64 20 61 6e 64 20 74 68 65 79 20 61 72 roed and they ar
1eb80 65 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 63 e large, so we c
1eb90 61 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a 2a an save a lot.**
1eba0 20 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 20 of run-time by
1ebb0 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 6e 69 skipping the ini
1ebc0 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 tialization of t
1ebd0 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a 2a hose elements..*
1ebe0 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 /.void sqlite3Bt
1ebf0 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 74 reeCursorZero(Bt
1ec00 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d 65 Cursor *p){. me
1ec10 6d 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 65 mset(p, 0, offse
1ec20 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 69 50 tof(BtCursor, iP
1ec30 61 67 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 age));.}../*.**
1ec40 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 2e 20 Close a cursor.
1ec50 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 6f The read lock o
1ec60 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
1ec70 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 64 0a ile is released.
1ec80 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 ** when the last
1ec90 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 65 cursor is close
1eca0 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
1ecb0 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 3BtreeCloseCurso
1ecc0 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 r(BtCursor *pCur
1ecd0 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 ){. Btree *pBtr
1ece0 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 65 ee = pCur->pBtre
1ecf0 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 20 e;. if( pBtree
1ed00 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 ){. int i;.
1ed10 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1ed20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 20 20 = pCur->pBt;.
1ed30 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1ed40 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 er(pBtree);.
1ed50 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 sqlite3BtreeClea
1ed60 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a 20 rCursor(pCur);.
1ed70 20 20 20 69 66 28 20 70 43 75 72 2d 3e 70 50 72 if( pCur->pPr
1ed80 65 76 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 ev ){. pCur
1ed90 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d ->pPrev->pNext =
1eda0 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 pCur->pNext;.
1edb0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
1edc0 42 74 2d 3e 70 43 75 72 73 6f 72 20 3d 20 70 43 Bt->pCursor = pC
1edd0 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d ur->pNext;. }
1ede0 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 70 . if( pCur->p
1edf0 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 70 43 Next ){. pC
1ee00 75 72 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 ur->pNext->pPrev
1ee10 20 3d 20 70 43 75 72 2d 3e 70 50 72 65 76 3b 0a = pCur->pPrev;.
1ee20 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 3d }. for(i=
1ee30 30 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 0; i<=pCur->iPag
1ee40 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 e; i++){. r
1ee50 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 2d eleasePage(pCur-
1ee60 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 >apPage[i]);.
1ee70 20 7d 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 }. unlockBtr
1ee80 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 29 3b eeIfUnused(pBt);
1ee90 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
1eea0 65 65 28 70 42 74 72 65 65 2d 3e 64 62 2c 20 70 ee(pBtree->db, p
1eeb0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 3b Cur->aOverflow);
1eec0 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f . /* sqlite3_
1eed0 66 72 65 65 28 70 43 75 72 29 3b 20 2a 2f 0a 20 free(pCur); */.
1eee0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
1eef0 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a 20 20 eave(pBtree);.
1ef00 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
1ef10 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d E_OK;.}../*.** M
1ef20 61 6b 65 20 73 75 72 65 20 74 68 65 20 42 74 43 ake sure the BtC
1ef30 75 72 73 6f 72 2a 20 67 69 76 65 6e 20 69 6e 20 ursor* given in
1ef40 74 68 65 20 61 72 67 75 6d 65 6e 74 20 68 61 73 the argument has
1ef50 20 61 20 76 61 6c 69 64 0a 2a 2a 20 42 74 43 75 a valid.** BtCu
1ef60 72 73 6f 72 2e 69 6e 66 6f 20 73 74 72 75 63 74 rsor.info struct
1ef70 75 72 65 2e 20 20 49 66 20 69 74 20 69 73 20 6e ure. If it is n
1ef80 6f 74 20 61 6c 72 65 61 64 79 20 76 61 6c 69 64 ot already valid
1ef90 2c 20 63 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 , call.** btreeP
1efa0 61 72 73 65 43 65 6c 6c 28 29 20 74 6f 20 66 69 arseCell() to fi
1efb0 6c 6c 20 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 ll it in..**.**
1efc0 42 74 43 75 72 73 6f 72 2e 69 6e 66 6f 20 69 73 BtCursor.info is
1efd0 20 61 20 63 61 63 68 65 20 6f 66 20 74 68 65 20 a cache of the
1efe0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 information in t
1eff0 68 65 20 63 75 72 72 65 6e 74 20 63 65 6c 6c 2e he current cell.
1f000 0a 2a 2a 20 55 73 69 6e 67 20 74 68 69 73 20 63 .** Using this c
1f010 61 63 68 65 20 72 65 64 75 63 65 73 20 74 68 65 ache reduces the
1f020 20 6e 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 number of calls
1f030 20 74 6f 20 62 74 72 65 65 50 61 72 73 65 43 65 to btreeParseCe
1f040 6c 6c 28 29 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 37 ll()..**.** 2007
1f050 2d 30 36 2d 32 35 3a 20 20 54 68 65 72 65 20 69 -06-25: There i
1f060 73 20 61 20 62 75 67 20 69 6e 20 73 6f 6d 65 20 s a bug in some
1f070 76 65 72 73 69 6f 6e 73 20 6f 66 20 4d 53 56 43 versions of MSVC
1f080 20 74 68 61 74 20 63 61 75 73 65 20 74 68 65 0a that cause the.
1f090 2a 2a 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 63 ** compiler to c
1f0a0 72 61 73 68 20 77 68 65 6e 20 67 65 74 43 65 6c rash when getCel
1f0b0 6c 49 6e 66 6f 28 29 20 69 73 20 69 6d 70 6c 65 lInfo() is imple
1f0c0 6d 65 6e 74 65 64 20 61 73 20 61 20 6d 61 63 72 mented as a macr
1f0d0 6f 2e 0a 2a 2a 20 42 75 74 20 74 68 65 72 65 20 o..** But there
1f0e0 69 73 20 61 20 6d 65 61 73 75 72 65 61 62 6c 65 is a measureable
1f0f0 20 73 70 65 65 64 20 61 64 76 61 6e 74 61 67 65 speed advantage
1f100 20 74 6f 20 75 73 69 6e 67 20 74 68 65 20 6d 61 to using the ma
1f110 63 72 6f 20 6f 6e 20 67 63 63 0a 2a 2a 20 28 77 cro on gcc.** (w
1f120 68 65 6e 20 6c 65 73 73 20 63 6f 6d 70 69 6c 65 hen less compile
1f130 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 r optimizations
1f140 6c 69 6b 65 20 2d 4f 73 20 6f 72 20 2d 4f 30 20 like -Os or -O0
1f150 61 72 65 20 75 73 65 64 20 61 6e 64 20 74 68 65 are used and the
1f160 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 20 69 73 20 .** compiler is
1f170 6e 6f 74 20 64 6f 69 6e 67 20 61 67 67 72 65 73 not doing aggres
1f180 73 69 76 65 20 69 6e 6c 69 6e 69 6e 67 2e 29 20 sive inlining.)
1f190 20 53 6f 20 77 65 20 75 73 65 20 61 20 72 65 61 So we use a rea
1f1a0 6c 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 66 6f l function.** fo
1f1b0 72 20 4d 53 56 43 20 61 6e 64 20 61 20 6d 61 63 r MSVC and a mac
1f1c0 72 6f 20 66 6f 72 20 65 76 65 72 79 74 68 69 6e ro for everythin
1f1d0 67 20 65 6c 73 65 2e 20 20 54 69 63 6b 65 74 20 g else. Ticket
1f1e0 23 32 34 35 37 2e 0a 2a 2f 0a 23 69 66 6e 64 65 #2457..*/.#ifnde
1f1f0 66 20 4e 44 45 42 55 47 0a 20 20 73 74 61 74 69 f NDEBUG. stati
1f200 63 20 76 6f 69 64 20 61 73 73 65 72 74 43 65 6c c void assertCel
1f210 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f 72 20 2a lInfo(BtCursor *
1f220 70 43 75 72 29 7b 0a 20 20 20 20 43 65 6c 6c 49 pCur){. CellI
1f230 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 69 6e nfo info;. in
1f240 74 20 69 50 61 67 65 20 3d 20 70 43 75 72 2d 3e t iPage = pCur->
1f250 69 50 61 67 65 3b 0a 20 20 20 20 6d 65 6d 73 65 iPage;. memse
1f260 74 28 26 69 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 t(&info, 0, size
1f270 6f 66 28 69 6e 66 6f 29 29 3b 0a 20 20 20 20 62 of(info));. b
1f280 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 treeParseCell(pC
1f290 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 ur->apPage[iPage
1f2a0 5d 2c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 ], pCur->aiIdx[i
1f2b0 50 61 67 65 5d 2c 20 26 69 6e 66 6f 29 3b 0a 20 Page], &info);.
1f2c0 20 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 assert( CORRU
1f2d0 50 54 5f 44 42 20 7c 7c 20 6d 65 6d 63 6d 70 28 PT_DB || memcmp(
1f2e0 26 69 6e 66 6f 2c 20 26 70 43 75 72 2d 3e 69 6e &info, &pCur->in
1f2f0 66 6f 2c 20 73 69 7a 65 6f 66 28 69 6e 66 6f 29 fo, sizeof(info)
1f300 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 6c 73 )==0 );. }.#els
1f310 65 0a 20 20 23 64 65 66 69 6e 65 20 61 73 73 65 e. #define asse
1f320 72 74 43 65 6c 6c 49 6e 66 6f 28 78 29 0a 23 65 rtCellInfo(x).#e
1f330 6e 64 69 66 0a 23 69 66 64 65 66 20 5f 4d 53 43 ndif.#ifdef _MSC
1f340 5f 56 45 52 0a 20 20 2f 2a 20 55 73 65 20 61 20 _VER. /* Use a
1f350 72 65 61 6c 20 66 75 6e 63 74 69 6f 6e 20 69 6e real function in
1f360 20 4d 53 56 43 20 74 6f 20 77 6f 72 6b 20 61 72 MSVC to work ar
1f370 6f 75 6e 64 20 62 75 67 73 20 69 6e 20 74 68 61 ound bugs in tha
1f380 74 20 63 6f 6d 70 69 6c 65 72 2e 20 2a 2f 0a 20 t compiler. */.
1f390 20 73 74 61 74 69 63 20 76 6f 69 64 20 67 65 74 static void get
1f3a0 43 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f CellInfo(BtCurso
1f3b0 72 20 2a 70 43 75 72 29 7b 0a 20 20 20 20 69 66 r *pCur){. if
1f3c0 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 ( pCur->info.nSi
1f3d0 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 ze==0 ){. i
1f3e0 6e 74 20 69 50 61 67 65 20 3d 20 70 43 75 72 2d nt iPage = pCur-
1f3f0 3e 69 50 61 67 65 3b 0a 20 20 20 20 20 20 62 74 >iPage;. bt
1f400 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 reeParseCell(pCu
1f410 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 5d r->apPage[iPage]
1f420 2c 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 ,pCur->aiIdx[iPa
1f430 67 65 5d 2c 26 70 43 75 72 2d 3e 69 6e 66 6f 29 ge],&pCur->info)
1f440 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 ;. pCur->cu
1f450 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 rFlags |= BTCF_V
1f460 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 20 20 7d 65 alidNKey;. }e
1f470 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
1f480 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
1f490 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 65 . }. }.#else
1f4a0 20 2f 2a 20 69 66 20 6e 6f 74 20 5f 4d 53 43 5f /* if not _MSC_
1f4b0 56 45 52 20 2a 2f 0a 20 20 2f 2a 20 55 73 65 20 VER */. /* Use
1f4c0 61 20 6d 61 63 72 6f 20 69 6e 20 61 6c 6c 20 6f a macro in all o
1f4d0 74 68 65 72 20 63 6f 6d 70 69 6c 65 72 73 20 73 ther compilers s
1f4e0 6f 20 74 68 61 74 20 74 68 65 20 66 75 6e 63 74 o that the funct
1f4f0 69 6f 6e 20 69 73 20 69 6e 6c 69 6e 65 64 20 2a ion is inlined *
1f500 2f 0a 23 64 65 66 69 6e 65 20 67 65 74 43 65 6c /.#define getCel
1f510 6c 49 6e 66 6f 28 70 43 75 72 29 20 20 20 20 20 lInfo(pCur)
1f520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f550 20 5c 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 69 \. if( pCur->i
1f560 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 20 nfo.nSize==0 ){
1f570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f5a0 20 20 5c 0a 20 20 20 20 69 6e 74 20 69 50 61 67 \. int iPag
1f5b0 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 67 65 3b e = pCur->iPage;
1f5c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f5e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f5f0 20 20 20 5c 0a 20 20 20 20 62 74 72 65 65 50 61 \. btreePa
1f600 72 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 rseCell(pCur->ap
1f610 50 61 67 65 5b 69 50 61 67 65 5d 2c 70 43 75 72 Page[iPage],pCur
1f620 2d 3e 61 69 49 64 78 5b 69 50 61 67 65 5d 2c 26 ->aiIdx[iPage],&
1f630 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 20 20 20 20 pCur->info);
1f640 20 20 20 20 5c 0a 20 20 20 20 70 43 75 72 2d 3e \. pCur->
1f650 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 curFlags |= BTCF
1f660 5f 56 61 6c 69 64 4e 4b 65 79 3b 20 20 20 20 20 _ValidNKey;
1f670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f690 20 20 20 20 20 5c 0a 20 20 7d 65 6c 73 65 7b 20 \. }else{
1f6a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f6b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f6c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f6d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f6e0 20 20 20 20 20 20 5c 0a 20 20 20 20 61 73 73 65 \. asse
1f6f0 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 rtCellInfo(pCur)
1f700 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1f710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f730 20 20 20 20 20 20 20 5c 0a 20 20 7d 0a 23 65 6e \. }.#en
1f740 64 69 66 20 2f 2a 20 5f 4d 53 43 5f 56 45 52 20 dif /* _MSC_VER
1f750 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 */..#ifndef NDEB
1f760 55 47 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 UG /* The next
1f770 72 6f 75 74 69 6e 65 20 75 73 65 64 20 6f 6e 6c routine used onl
1f780 79 20 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 y within assert(
1f790 29 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a ) statements */.
1f7a0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 /*.** Return tru
1f7b0 65 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 42 e if the given B
1f7c0 74 43 75 72 73 6f 72 20 69 73 20 76 61 6c 69 64 tCursor is valid
1f7d0 2e 20 20 41 20 76 61 6c 69 64 20 63 75 72 73 6f . A valid curso
1f7e0 72 20 69 73 20 6f 6e 65 0a 2a 2a 20 74 68 61 74 r is one.** that
1f7f0 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 70 6f is currently po
1f800 69 6e 74 69 6e 67 20 74 6f 20 61 20 72 6f 77 20 inting to a row
1f810 69 6e 20 61 20 28 6e 6f 6e 2d 65 6d 70 74 79 29 in a (non-empty)
1f820 20 74 61 62 6c 65 2e 0a 2a 2a 20 54 68 69 73 20 table..** This
1f830 69 73 20 61 20 76 65 72 69 66 69 63 61 74 69 6f is a verificatio
1f840 6e 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 n routine is use
1f850 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 d only within as
1f860 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
1f870 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
1f880 33 42 74 72 65 65 43 75 72 73 6f 72 49 73 56 61 3BtreeCursorIsVa
1f890 6c 69 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 lid(BtCursor *pC
1f8a0 75 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 ur){. return pC
1f8b0 75 72 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 ur && pCur->eSta
1f8c0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
1f8d0 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 4e 44 ;.}.#endif /* ND
1f8e0 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 EBUG */../*.** S
1f8f0 65 74 20 2a 70 53 69 7a 65 20 74 6f 20 74 68 65 et *pSize to the
1f900 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 75 66 size of the buf
1f910 66 65 72 20 6e 65 65 64 65 64 20 74 6f 20 68 6f fer needed to ho
1f920 6c 64 20 74 68 65 20 76 61 6c 75 65 20 6f 66 0a ld the value of.
1f930 2a 2a 20 74 68 65 20 6b 65 79 20 66 6f 72 20 74 ** the key for t
1f940 68 65 20 63 75 72 72 65 6e 74 20 65 6e 74 72 79 he current entry
1f950 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 . If the cursor
1f960 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 69 6e 67 is not pointing
1f970 0a 2a 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 65 .** to a valid e
1f980 6e 74 72 79 2c 20 2a 70 53 69 7a 65 20 69 73 20 ntry, *pSize is
1f990 73 65 74 20 74 6f 20 30 2e 20 0a 2a 2a 0a 2a 2a set to 0. .**.**
1f9a0 20 46 6f 72 20 61 20 74 61 62 6c 65 20 77 69 74 For a table wit
1f9b0 68 20 74 68 65 20 49 4e 54 4b 45 59 20 66 6c 61 h the INTKEY fla
1f9c0 67 20 73 65 74 2c 20 74 68 69 73 20 72 6f 75 74 g set, this rout
1f9d0 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65 20 ine returns the
1f9e0 6b 65 79 0a 2a 2a 20 69 74 73 65 6c 66 2c 20 6e key.** itself, n
1f9f0 6f 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 ot the number of
1fa00 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 6b 65 bytes in the ke
1fa10 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c y..**.** The cal
1fa20 6c 65 72 20 6d 75 73 74 20 70 6f 73 69 74 69 6f ler must positio
1fa30 6e 20 74 68 65 20 63 75 72 73 6f 72 20 70 72 69 n the cursor pri
1fa40 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 or to invoking t
1fa50 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 20 his routine..**
1fa60 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
1fa70 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 20 20 49 cannot fail. I
1fa80 74 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e 73 t always returns
1fa90 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 20 0a 2a 2f SQLITE_OK. .*/
1faa0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
1fab0 65 4b 65 79 53 69 7a 65 28 42 74 43 75 72 73 6f eKeySize(BtCurso
1fac0 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a 70 53 r *pCur, i64 *pS
1fad0 69 7a 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 ize){. assert(
1fae0 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
1faf0 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
1fb00 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
1fb10 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
1fb20 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 || pCur->eState
1fb30 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
1fb40 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
1fb50 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
1fb60 49 44 20 29 7b 0a 20 20 20 20 2a 70 53 69 7a 65 ID ){. *pSize
1fb70 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 0;. }else{.
1fb80 20 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 getCellInfo(p
1fb90 43 75 72 29 3b 0a 20 20 20 20 2a 70 53 69 7a 65 Cur);. *pSize
1fba0 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b = pCur->info.nK
1fbb0 65 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ey;. }. return
1fbc0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
1fbd0 2a 0a 2a 2a 20 53 65 74 20 2a 70 53 69 7a 65 20 *.** Set *pSize
1fbe0 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 to the number of
1fbf0 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 69 bytes of data i
1fc00 6e 20 74 68 65 20 65 6e 74 72 79 20 74 68 65 0a n the entry the.
1fc10 2a 2a 20 63 75 72 73 6f 72 20 63 75 72 72 65 6e ** cursor curren
1fc20 74 6c 79 20 70 6f 69 6e 74 73 20 74 6f 2e 0a 2a tly points to..*
1fc30 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 *.** The caller
1fc40 6d 75 73 74 20 67 75 61 72 61 6e 74 65 65 20 74 must guarantee t
1fc50 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 hat the cursor i
1fc60 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 s pointing to a
1fc70 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 non-NULL.** vali
1fc80 64 20 65 6e 74 72 79 2e 20 20 49 6e 20 6f 74 68 d entry. In oth
1fc90 65 72 20 77 6f 72 64 73 2c 20 74 68 65 20 63 61 er words, the ca
1fca0 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 lling procedure
1fcb0 6d 75 73 74 20 67 75 61 72 61 6e 74 65 65 0a 2a must guarantee.*
1fcc0 2a 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f * that the curso
1fcd0 72 20 68 61 73 20 43 75 72 73 6f 72 2e 65 53 74 r has Cursor.eSt
1fce0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
1fcf0 44 2e 0a 2a 2a 0a 2a 2a 20 46 61 69 6c 75 72 65 D..**.** Failure
1fd00 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 is not possible
1fd10 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e . This function
1fd20 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e 73 20 always returns
1fd30 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 49 74 SQLITE_OK..** It
1fd40 20 6d 69 67 68 74 20 6a 75 73 74 20 61 73 20 77 might just as w
1fd50 65 6c 6c 20 62 65 20 61 20 70 72 6f 63 65 64 75 ell be a procedu
1fd60 72 65 20 28 72 65 74 75 72 6e 69 6e 67 20 76 6f re (returning vo
1fd70 69 64 29 20 62 75 74 20 77 65 20 63 6f 6e 74 69 id) but we conti
1fd80 6e 75 65 0a 2a 2a 20 74 6f 20 72 65 74 75 72 6e nue.** to return
1fd90 20 61 6e 20 69 6e 74 65 67 65 72 20 72 65 73 75 an integer resu
1fda0 6c 74 20 63 6f 64 65 20 66 6f 72 20 68 69 73 74 lt code for hist
1fdb0 6f 72 69 63 61 6c 20 72 65 61 73 6f 6e 73 2e 0a orical reasons..
1fdc0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1fdd0 72 65 65 44 61 74 61 53 69 7a 65 28 42 74 43 75 reeDataSize(BtCu
1fde0 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 rsor *pCur, u32
1fdf0 2a 70 53 69 7a 65 29 7b 0a 20 20 61 73 73 65 72 *pSize){. asser
1fe00 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 t( cursorHoldsMu
1fe10 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 tex(pCur) );. a
1fe20 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
1fe30 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
1fe40 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 D );. assert( p
1fe50 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
1fe60 2d 3e 69 50 61 67 65 5d 2d 3e 69 6e 74 4b 65 79 ->iPage]->intKey
1fe70 4c 65 61 66 3d 3d 31 20 29 3b 0a 20 20 67 65 74 Leaf==1 );. get
1fe80 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a CellInfo(pCur);.
1fe90 20 20 2a 70 53 69 7a 65 20 3d 20 70 43 75 72 2d *pSize = pCur-
1fea0 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a >info.nPayload;.
1feb0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1fec0 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 OK;.}../*.** Giv
1fed0 65 6e 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 en the page numb
1fee0 65 72 20 6f 66 20 61 6e 20 6f 76 65 72 66 6c 6f er of an overflo
1fef0 77 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 w page in the da
1ff00 74 61 62 61 73 65 20 28 70 61 72 61 6d 65 74 65 tabase (paramete
1ff10 72 0a 2a 2a 20 6f 76 66 6c 29 2c 20 74 68 69 73 r.** ovfl), this
1ff20 20 66 75 6e 63 74 69 6f 6e 20 66 69 6e 64 73 20 function finds
1ff30 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
1ff40 6f 66 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 of the next page
1ff50 20 69 6e 20 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b in the .** link
1ff60 65 64 20 6c 69 73 74 20 6f 66 20 6f 76 65 72 66 ed list of overf
1ff70 6c 6f 77 20 70 61 67 65 73 2e 20 49 66 20 70 6f low pages. If po
1ff80 73 73 69 62 6c 65 2c 20 69 74 20 75 73 65 73 20 ssible, it uses
1ff90 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a the auto-vacuum.
1ffa0 2a 2a 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 64 ** pointer-map d
1ffb0 61 74 61 20 69 6e 73 74 65 61 64 20 6f 66 20 72 ata instead of r
1ffc0 65 61 64 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 eading the conte
1ffd0 6e 74 20 6f 66 20 70 61 67 65 20 6f 76 66 6c 20 nt of page ovfl
1ffe0 74 6f 20 64 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a to do so. .**.**
1fff0 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
20000 75 72 73 20 61 6e 20 53 51 4c 69 74 65 20 65 72 urs an SQLite er
20010 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 ror code is retu
20020 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 65 3a rned. Otherwise:
20030 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 .**.** The page
20040 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 6e 65 number of the ne
20050 78 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 xt overflow page
20060 20 69 6e 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c in the linked l
20070 69 73 74 20 69 73 20 0a 2a 2a 20 77 72 69 74 74 ist is .** writt
20080 65 6e 20 74 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 en to *pPgnoNext
20090 2e 20 49 66 20 70 61 67 65 20 6f 76 66 6c 20 69 . If page ovfl i
200a0 73 20 74 68 65 20 6c 61 73 74 20 70 61 67 65 20 s the last page
200b0 69 6e 20 69 74 73 20 6c 69 6e 6b 65 64 20 0a 2a in its linked .*
200c0 2a 20 6c 69 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 * list, *pPgnoNe
200d0 78 74 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 xt is set to zer
200e0 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 o. .**.** If ppP
200f0 61 67 65 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c age is not NULL,
20100 20 61 6e 64 20 61 20 72 65 66 65 72 65 6e 63 65 and a reference
20110 20 74 6f 20 74 68 65 20 4d 65 6d 50 61 67 65 20 to the MemPage
20120 6f 62 6a 65 63 74 20 63 6f 72 72 65 73 70 6f 6e object correspon
20130 64 69 6e 67 0a 2a 2a 20 74 6f 20 70 61 67 65 20 ding.** to page
20140 6e 75 6d 62 65 72 20 70 4f 76 66 6c 20 77 61 73 number pOvfl was
20150 20 6f 62 74 61 69 6e 65 64 2c 20 74 68 65 6e 20 obtained, then
20160 2a 70 70 50 61 67 65 20 69 73 20 73 65 74 20 74 *ppPage is set t
20170 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 0a o point to that.
20180 2a 2a 20 72 65 66 65 72 65 6e 63 65 2e 20 49 74 ** reference. It
20190 20 69 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 is the responsi
201a0 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 bility of the ca
201b0 6c 6c 65 72 20 74 6f 20 63 61 6c 6c 20 72 65 6c ller to call rel
201c0 65 61 73 65 50 61 67 65 28 29 0a 2a 2a 20 6f 6e easePage().** on
201d0 20 2a 70 70 50 61 67 65 20 74 6f 20 66 72 65 65 *ppPage to free
201e0 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 2e 20 the reference.
201f0 49 6e 20 6e 6f 20 72 65 66 65 72 65 6e 63 65 20 In no reference
20200 77 61 73 20 6f 62 74 61 69 6e 65 64 20 28 62 65 was obtained (be
20210 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 70 6f 69 cause.** the poi
20220 6e 74 65 72 2d 6d 61 70 20 77 61 73 20 75 73 65 nter-map was use
20230 64 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 d to obtain the
20240 76 61 6c 75 65 20 66 6f 72 20 2a 70 50 67 6e 6f value for *pPgno
20250 4e 65 78 74 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a Next), then.** *
20260 70 70 50 61 67 65 20 69 73 20 73 65 74 20 74 6f ppPage is set to
20270 20 7a 65 72 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 zero..*/.static
20280 20 69 6e 74 20 67 65 74 4f 76 65 72 66 6c 6f 77 int getOverflow
20290 50 61 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 Page(. BtShared
202a0 20 2a 70 42 74 2c 20 20 20 20 20 20 20 20 20 20 *pBt,
202b0 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 /* The data
202c0 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 50 base file */. P
202d0 67 6e 6f 20 6f 76 66 6c 2c 20 20 20 20 20 20 20 gno ovfl,
202e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
202f0 75 72 72 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 urrent overflow
20300 70 61 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 page number */.
20310 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 MemPage **ppPag
20320 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e, /*
20330 20 4f 55 54 3a 20 4d 65 6d 50 61 67 65 20 68 61 OUT: MemPage ha
20340 6e 64 6c 65 20 28 6d 61 79 20 62 65 20 4e 55 4c ndle (may be NUL
20350 4c 29 20 2a 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 L) */. Pgno *pP
20360 67 6e 6f 4e 65 78 74 20 20 20 20 20 20 20 20 20 gnoNext
20370 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 /* OUT: Nex
20380 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 t overflow page
20390 6e 75 6d 62 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 number */.){. P
203a0 67 6e 6f 20 6e 65 78 74 20 3d 20 30 3b 0a 20 20 gno next = 0;.
203b0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
203c0 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 0;. int rc = S
203d0 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 QLITE_OK;.. ass
203e0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
203f0 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
20400 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
20410 70 50 67 6e 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 pPgnoNext);..#if
20420 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
20430 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 2f 2a _AUTOVACUUM. /*
20440 20 54 72 79 20 74 6f 20 66 69 6e 64 20 74 68 65 Try to find the
20450 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 68 next page in th
20460 65 20 6f 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 e overflow list
20470 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 61 using the. ** a
20480 75 74 6f 76 61 63 75 75 6d 20 70 6f 69 6e 74 65 utovacuum pointe
20490 72 2d 6d 61 70 20 70 61 67 65 73 2e 20 47 75 65 r-map pages. Gue
204a0 73 73 20 74 68 61 74 20 74 68 65 20 6e 65 78 74 ss that the next
204b0 20 70 61 67 65 20 69 6e 20 0a 20 20 2a 2a 20 74 page in . ** t
204c0 68 65 20 6f 76 65 72 66 6c 6f 77 20 6c 69 73 74 he overflow list
204d0 20 69 73 20 70 61 67 65 20 6e 75 6d 62 65 72 20 is page number
204e0 28 6f 76 66 6c 2b 31 29 2e 20 49 66 20 74 68 61 (ovfl+1). If tha
204f0 74 20 67 75 65 73 73 20 74 75 72 6e 73 20 0a 20 t guess turns .
20500 20 2a 2a 20 6f 75 74 20 74 6f 20 62 65 20 77 72 ** out to be wr
20510 6f 6e 67 2c 20 66 61 6c 6c 20 62 61 63 6b 20 74 ong, fall back t
20520 6f 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 o loading the da
20530 74 61 20 6f 66 20 70 61 67 65 20 0a 20 20 2a 2a ta of page . **
20540 20 6e 75 6d 62 65 72 20 6f 76 66 6c 20 74 6f 20 number ovfl to
20550 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 6e 65 determine the ne
20560 78 74 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a xt page number..
20570 20 20 2a 2f 0a 20 20 69 66 28 20 70 42 74 2d 3e */. if( pBt->
20580 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 autoVacuum ){.
20590 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 Pgno pgno;.
205a0 20 50 67 6e 6f 20 69 47 75 65 73 73 20 3d 20 6f Pgno iGuess = o
205b0 76 66 6c 2b 31 3b 0a 20 20 20 20 75 38 20 65 54 vfl+1;. u8 eT
205c0 79 70 65 3b 0a 0a 20 20 20 20 77 68 69 6c 65 28 ype;.. while(
205d0 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 PTRMAP_ISPAGE(p
205e0 42 74 2c 20 69 47 75 65 73 73 29 20 7c 7c 20 69 Bt, iGuess) || i
205f0 47 75 65 73 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 Guess==PENDING_B
20600 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b YTE_PAGE(pBt) ){
20610 0a 20 20 20 20 20 20 69 47 75 65 73 73 2b 2b 3b . iGuess++;
20620 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 . }.. if(
20630 69 47 75 65 73 73 3c 3d 62 74 72 65 65 50 61 67 iGuess<=btreePag
20640 65 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 ecount(pBt) ){.
20650 20 20 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 rc = ptrmap
20660 47 65 74 28 70 42 74 2c 20 69 47 75 65 73 73 2c Get(pBt, iGuess,
20670 20 26 65 54 79 70 65 2c 20 26 70 67 6e 6f 29 3b &eType, &pgno);
20680 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
20690 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 54 79 70 QLITE_OK && eTyp
206a0 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c e==PTRMAP_OVERFL
206b0 4f 57 32 20 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 OW2 && pgno==ovf
206c0 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 6e 65 78 l ){. nex
206d0 74 20 3d 20 69 47 75 65 73 73 3b 0a 20 20 20 20 t = iGuess;.
206e0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
206f0 44 4f 4e 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 DONE;. }.
20700 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a }. }.#endif..
20710 20 20 61 73 73 65 72 74 28 20 6e 65 78 74 3d 3d assert( next==
20720 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 0 || rc==SQLITE_
20730 44 4f 4e 45 20 29 3b 0a 20 20 69 66 28 20 72 63 DONE );. if( rc
20740 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
20750 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
20760 50 61 67 65 28 70 42 74 2c 20 6f 76 66 6c 2c 20 Page(pBt, ovfl,
20770 26 70 50 61 67 65 2c 20 28 70 70 50 61 67 65 3d &pPage, (ppPage=
20780 3d 30 29 20 3f 20 50 41 47 45 52 5f 47 45 54 5f =0) ? PAGER_GET_
20790 52 45 41 44 4f 4e 4c 59 20 3a 20 30 29 3b 0a 20 READONLY : 0);.
207a0 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 assert( rc==S
207b0 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 QLITE_OK || pPag
207c0 65 3d 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 e==0 );. if(
207d0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
207e0 0a 20 20 20 20 20 20 6e 65 78 74 20 3d 20 67 65 . next = ge
207f0 74 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 t4byte(pPage->aD
20800 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a ata);. }. }.
20810 0a 20 20 2a 70 50 67 6e 6f 4e 65 78 74 20 3d 20 . *pPgnoNext =
20820 6e 65 78 74 3b 0a 20 20 69 66 28 20 70 70 50 61 next;. if( ppPa
20830 67 65 20 29 7b 0a 20 20 20 20 2a 70 70 50 61 67 ge ){. *ppPag
20840 65 20 3d 20 70 50 61 67 65 3b 0a 20 20 7d 65 6c e = pPage;. }el
20850 73 65 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 se{. releaseP
20860 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a age(pPage);. }.
20870 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d 53 51 return (rc==SQ
20880 4c 49 54 45 5f 44 4f 4e 45 20 3f 20 53 51 4c 49 LITE_DONE ? SQLI
20890 54 45 5f 4f 4b 20 3a 20 72 63 29 3b 0a 7d 0a 0a TE_OK : rc);.}..
208a0 2f 2a 0a 2a 2a 20 43 6f 70 79 20 64 61 74 61 20 /*.** Copy data
208b0 66 72 6f 6d 20 61 20 62 75 66 66 65 72 20 74 6f from a buffer to
208c0 20 61 20 70 61 67 65 2c 20 6f 72 20 66 72 6f 6d a page, or from
208d0 20 61 20 70 61 67 65 20 74 6f 20 61 20 62 75 66 a page to a buf
208e0 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 70 50 61 79 6c fer..**.** pPayl
208f0 6f 61 64 20 69 73 20 61 20 70 6f 69 6e 74 65 72 oad is a pointer
20900 20 74 6f 20 64 61 74 61 20 73 74 6f 72 65 64 20 to data stored
20910 6f 6e 20 64 61 74 61 62 61 73 65 20 70 61 67 65 on database page
20920 20 70 44 62 50 61 67 65 2e 0a 2a 2a 20 49 66 20 pDbPage..** If
20930 61 72 67 75 6d 65 6e 74 20 65 4f 70 20 69 73 20 argument eOp is
20940 66 61 6c 73 65 2c 20 74 68 65 6e 20 6e 42 79 74 false, then nByt
20950 65 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 e bytes of data
20960 61 72 65 20 63 6f 70 69 65 64 0a 2a 2a 20 66 72 are copied.** fr
20970 6f 6d 20 70 50 61 79 6c 6f 61 64 20 74 6f 20 74 om pPayload to t
20980 68 65 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 he buffer pointe
20990 64 20 61 74 20 62 79 20 70 42 75 66 2e 20 49 66 d at by pBuf. If
209a0 20 65 4f 70 20 69 73 20 74 72 75 65 2c 0a 2a 2a eOp is true,.**
209b0 20 74 68 65 6e 20 73 71 6c 69 74 65 33 50 61 67 then sqlite3Pag
209c0 65 72 57 72 69 74 65 28 29 20 69 73 20 63 61 6c erWrite() is cal
209d0 6c 65 64 20 6f 6e 20 70 44 62 50 61 67 65 20 61 led on pDbPage a
209e0 6e 64 20 6e 42 79 74 65 20 62 79 74 65 73 0a 2a nd nByte bytes.*
209f0 2a 20 6f 66 20 64 61 74 61 20 61 72 65 20 63 6f * of data are co
20a00 70 69 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75 pied from the bu
20a10 66 66 65 72 20 70 42 75 66 20 74 6f 20 70 50 61 ffer pBuf to pPa
20a20 79 6c 6f 61 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c yload..**.** SQL
20a30 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
20a40 65 64 20 6f 6e 20 73 75 63 63 65 73 73 2c 20 6f ed on success, o
20a50 74 68 65 72 77 69 73 65 20 61 6e 20 65 72 72 6f therwise an erro
20a60 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 r code..*/.stati
20a70 63 20 69 6e 74 20 63 6f 70 79 50 61 79 6c 6f 61 c int copyPayloa
20a80 64 28 0a 20 20 76 6f 69 64 20 2a 70 50 61 79 6c d(. void *pPayl
20a90 6f 61 64 2c 20 20 20 20 20 20 20 20 20 20 20 2f oad, /
20aa0 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 70 61 67 * Pointer to pag
20ab0 65 20 64 61 74 61 20 2a 2f 0a 20 20 76 6f 69 64 e data */. void
20ac0 20 2a 70 42 75 66 2c 20 20 20 20 20 20 20 20 20 *pBuf,
20ad0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
20ae0 20 74 6f 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 to buffer */.
20af0 69 6e 74 20 6e 42 79 74 65 2c 20 20 20 20 20 20 int nByte,
20b00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
20b10 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 6f 20 ber of bytes to
20b20 63 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 20 65 4f copy */. int eO
20b30 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p,
20b40 20 20 20 20 2f 2a 20 30 20 2d 3e 20 63 6f 70 79 /* 0 -> copy
20b50 20 66 72 6f 6d 20 70 61 67 65 2c 20 31 20 2d 3e from page, 1 ->
20b60 20 63 6f 70 79 20 74 6f 20 70 61 67 65 20 2a 2f copy to page */
20b70 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 61 . DbPage *pDbPa
20b80 67 65 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ge /*
20b90 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 Page containing
20ba0 70 50 61 79 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 pPayload */.){.
20bb0 20 69 66 28 20 65 4f 70 20 29 7b 0a 20 20 20 20 if( eOp ){.
20bc0 2f 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f /* Copy data fro
20bd0 6d 20 62 75 66 66 65 72 20 74 6f 20 70 61 67 65 m buffer to page
20be0 20 28 61 20 77 72 69 74 65 20 6f 70 65 72 61 74 (a write operat
20bf0 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ion) */. int
20c00 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
20c10 72 57 72 69 74 65 28 70 44 62 50 61 67 65 29 3b rWrite(pDbPage);
20c20 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
20c30 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
20c40 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
20c50 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 79 . memcpy(pPay
20c60 6c 6f 61 64 2c 20 70 42 75 66 2c 20 6e 42 79 74 load, pBuf, nByt
20c70 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 e);. }else{.
20c80 20 2f 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 /* Copy data fr
20c90 6f 6d 20 70 61 67 65 20 74 6f 20 62 75 66 66 65 om page to buffe
20ca0 72 20 28 61 20 72 65 61 64 20 6f 70 65 72 61 74 r (a read operat
20cb0 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 ion) */. memc
20cc0 70 79 28 70 42 75 66 2c 20 70 50 61 79 6c 6f 61 py(pBuf, pPayloa
20cd0 64 2c 20 6e 42 79 74 65 29 3b 0a 20 20 7d 0a 20 d, nByte);. }.
20ce0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
20cf0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 K;.}../*.** This
20d00 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
20d10 64 20 74 6f 20 72 65 61 64 20 6f 72 20 6f 76 65 d to read or ove
20d20 72 77 72 69 74 65 20 70 61 79 6c 6f 61 64 20 69 rwrite payload i
20d30 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 6f nformation.** fo
20d40 72 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 r the entry that
20d50 20 74 68 65 20 70 43 75 72 20 63 75 72 73 6f 72 the pCur cursor
20d60 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e is pointing to.
20d70 20 54 68 65 20 65 4f 70 0a 2a 2a 20 61 72 67 75 The eOp.** argu
20d80 6d 65 6e 74 20 69 73 20 69 6e 74 65 72 70 72 65 ment is interpre
20d90 74 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a ted as follows:.
20da0 2a 2a 0a 2a 2a 20 20 20 30 3a 20 54 68 65 20 6f **.** 0: The o
20db0 70 65 72 61 74 69 6f 6e 20 69 73 20 61 20 72 65 peration is a re
20dc0 61 64 2e 20 50 6f 70 75 6c 61 74 65 20 74 68 65 ad. Populate the
20dd0 20 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 65 2e overflow cache.
20de0 0a 2a 2a 20 20 20 31 3a 20 54 68 65 20 6f 70 65 .** 1: The ope
20df0 72 61 74 69 6f 6e 20 69 73 20 61 20 77 72 69 74 ration is a writ
20e00 65 2e 20 50 6f 70 75 6c 61 74 65 20 74 68 65 20 e. Populate the
20e10 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a overflow cache..
20e20 2a 2a 20 20 20 32 3a 20 54 68 65 20 6f 70 65 72 ** 2: The oper
20e30 61 74 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e ation is a read.
20e40 20 44 6f 20 6e 6f 74 20 70 6f 70 75 6c 61 74 65 Do not populate
20e50 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 61 the overflow ca
20e60 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 74 6f 74 che..**.** A tot
20e70 61 6c 20 6f 66 20 22 61 6d 74 22 20 62 79 74 65 al of "amt" byte
20e80 73 20 61 72 65 20 72 65 61 64 20 6f 72 20 77 72 s are read or wr
20e90 69 74 74 65 6e 20 62 65 67 69 6e 6e 69 6e 67 20 itten beginning
20ea0 61 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 20 at "offset"..**
20eb0 44 61 74 61 20 69 73 20 72 65 61 64 20 74 6f 20 Data is read to
20ec0 6f 72 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 or from the buff
20ed0 65 72 20 70 42 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 er pBuf..**.** T
20ee0 68 65 20 63 6f 6e 74 65 6e 74 20 62 65 69 6e 67 he content being
20ef0 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e read or written
20f00 20 6d 69 67 68 74 20 61 70 70 65 61 72 20 6f 6e might appear on
20f10 20 74 68 65 20 6d 61 69 6e 20 70 61 67 65 0a 2a the main page.*
20f20 2a 20 6f 72 20 62 65 20 73 63 61 74 74 65 72 65 * or be scattere
20f30 64 20 6f 75 74 20 6f 6e 20 6d 75 6c 74 69 70 6c d out on multipl
20f40 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 e overflow pages
20f50 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 ..**.** If the c
20f60 75 72 72 65 6e 74 20 63 75 72 73 6f 72 20 65 6e urrent cursor en
20f70 74 72 79 20 75 73 65 73 20 6f 6e 65 20 6f 72 20 try uses one or
20f80 6d 6f 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 more overflow pa
20f90 67 65 73 20 61 6e 64 20 74 68 65 0a 2a 2a 20 65 ges and the.** e
20fa0 4f 70 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e Op argument is n
20fb0 6f 74 20 32 2c 20 74 68 69 73 20 66 75 6e 63 74 ot 2, this funct
20fc0 69 6f 6e 20 6d 61 79 20 61 6c 6c 6f 63 61 74 65 ion may allocate
20fd0 20 73 70 61 63 65 20 66 6f 72 20 61 6e 64 20 6c space for and l
20fe0 61 7a 69 6c 79 20 0a 2a 2a 20 70 6f 70 75 6c 61 azily .** popula
20ff0 74 65 73 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 tes the overflow
21000 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 page-list cache
21010 20 61 72 72 61 79 20 28 42 74 43 75 72 73 6f 72 array (BtCursor
21020 2e 61 4f 76 65 72 66 6c 6f 77 29 2e 20 0a 2a 2a .aOverflow). .**
21030 20 53 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c Subsequent call
21040 73 20 75 73 65 20 74 68 69 73 20 63 61 63 68 65 s use this cache
21050 20 74 6f 20 6d 61 6b 65 20 73 65 65 6b 69 6e 67 to make seeking
21060 20 74 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 to the supplied
21070 20 6f 66 66 73 65 74 20 0a 2a 2a 20 6d 6f 72 65 offset .** more
21080 20 65 66 66 69 63 69 65 6e 74 2e 0a 2a 2a 0a 2a efficient..**.*
21090 2a 20 4f 6e 63 65 20 61 6e 20 6f 76 65 72 66 6c * Once an overfl
210a0 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ow page-list cac
210b0 68 65 20 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f he has been allo
210c0 63 61 74 65 64 2c 20 69 74 20 6d 61 79 20 62 65 cated, it may be
210d0 0a 2a 2a 20 69 6e 76 61 6c 69 64 61 74 65 64 20 .** invalidated
210e0 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 63 75 if some other cu
210f0 72 73 6f 72 20 77 72 69 74 65 73 20 74 6f 20 74 rsor writes to t
21100 68 65 20 73 61 6d 65 20 74 61 62 6c 65 2c 20 6f he same table, o
21110 72 20 69 66 0a 2a 2a 20 74 68 65 20 63 75 72 73 r if.** the curs
21120 6f 72 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 61 or is moved to a
21130 20 64 69 66 66 65 72 65 6e 74 20 72 6f 77 2e 20 different row.
21140 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e Additionally, in
21150 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 auto-vacuum.**
21160 6d 6f 64 65 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 mode, the follow
21170 69 6e 67 20 65 76 65 6e 74 73 20 6d 61 79 20 69 ing events may i
21180 6e 76 61 6c 69 64 61 74 65 20 61 6e 20 6f 76 65 nvalidate an ove
21190 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 rflow page-list
211a0 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a cache..**.** *
211b0 20 41 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 An incremental
211c0 76 61 63 75 75 6d 2c 0a 2a 2a 20 20 20 2a 20 41 vacuum,.** * A
211d0 20 63 6f 6d 6d 69 74 20 69 6e 20 61 75 74 6f 5f commit in auto_
211e0 76 61 63 75 75 6d 3d 22 66 75 6c 6c 22 20 6d 6f vacuum="full" mo
211f0 64 65 2c 0a 2a 2a 20 20 20 2a 20 43 72 65 61 74 de,.** * Creat
21200 69 6e 67 20 61 20 74 61 62 6c 65 20 28 6d 61 79 ing a table (may
21210 20 72 65 71 75 69 72 65 20 6d 6f 76 69 6e 67 20 require moving
21220 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
21230 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 )..*/.static int
21240 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 0a accessPayload(.
21250 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
21260 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 , /* Cursor
21270 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 6e 74 pointing to ent
21280 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f 6d 20 ry to read from
21290 2a 2f 0a 20 20 75 33 32 20 6f 66 66 73 65 74 2c */. u32 offset,
212a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 65 67 /* Beg
212b0 69 6e 20 72 65 61 64 69 6e 67 20 74 68 69 73 20 in reading this
212c0 66 61 72 20 69 6e 74 6f 20 70 61 79 6c 6f 61 64 far into payload
212d0 20 2a 2f 0a 20 20 75 33 32 20 61 6d 74 2c 20 20 */. u32 amt,
212e0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
212f0 61 64 20 74 68 69 73 20 6d 61 6e 79 20 62 79 74 ad this many byt
21300 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 es */. unsigned
21310 20 63 68 61 72 20 2a 70 42 75 66 2c 20 2f 2a 20 char *pBuf, /*
21320 57 72 69 74 65 20 74 68 65 20 62 79 74 65 73 20 Write the bytes
21330 69 6e 74 6f 20 74 68 69 73 20 62 75 66 66 65 72 into this buffer
21340 20 2a 2f 20 0a 20 20 69 6e 74 20 65 4f 70 20 20 */ . int eOp
21350 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a /* z
21360 65 72 6f 20 74 6f 20 72 65 61 64 2e 20 6e 6f 6e ero to read. non
21370 2d 7a 65 72 6f 20 74 6f 20 77 72 69 74 65 2e 20 -zero to write.
21380 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 */.){. unsigned
21390 20 63 68 61 72 20 2a 61 50 61 79 6c 6f 61 64 3b char *aPayload;
213a0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
213b0 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 49 64 TE_OK;. int iId
213c0 78 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 x = 0;. MemPage
213d0 20 2a 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e *pPage = pCur->
213e0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
213f0 67 65 5d 3b 20 2f 2a 20 42 74 72 65 65 20 70 61 ge]; /* Btree pa
21400 67 65 20 6f 66 20 63 75 72 72 65 6e 74 20 65 6e ge of current en
21410 74 72 79 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 try */. BtShare
21420 64 20 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 d *pBt = pCur->p
21430 42 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Bt;
21440 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 74 68 /* Btree th
21450 69 73 20 63 75 72 73 6f 72 20 62 65 6c 6f 6e 67 is cursor belong
21460 73 20 74 6f 20 2a 2f 0a 23 69 66 64 65 66 20 53 s to */.#ifdef S
21470 51 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 QLITE_DIRECT_OVE
21480 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 69 6e 74 RFLOW_READ. int
21490 20 62 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 bEnd;
214a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
214b0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
214c0 66 20 72 65 61 64 69 6e 67 20 74 6f 20 65 6e 64 f reading to end
214d0 20 6f 66 20 64 61 74 61 20 2a 2f 0a 23 65 6e 64 of data */.#end
214e0 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 if.. assert( pP
214f0 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 age );. assert(
21500 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
21510 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
21520 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
21530 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
21540 5d 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 ]<pPage->nCell )
21550 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
21560 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
21570 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
21580 65 4f 70 21 3d 32 20 7c 7c 20 6f 66 66 73 65 74 eOp!=2 || offset
21590 3d 3d 30 20 29 3b 20 20 20 20 2f 2a 20 41 6c 77 ==0 ); /* Alw
215a0 61 79 73 20 73 74 61 72 74 20 66 72 6f 6d 20 62 ays start from b
215b0 65 67 69 6e 6e 69 6e 67 20 66 6f 72 20 65 4f 70 eginning for eOp
215c0 3d 3d 32 20 2a 2f 0a 0a 20 20 67 65 74 43 65 6c ==2 */.. getCel
215d0 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 61 lInfo(pCur);. a
215e0 50 61 79 6c 6f 61 64 20 3d 20 70 43 75 72 2d 3e Payload = pCur->
215f0 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3b 0a 23 info.pPayload;.#
21600 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 ifdef SQLITE_DIR
21610 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 ECT_OVERFLOW_REA
21620 44 0a 20 20 62 45 6e 64 20 3d 20 6f 66 66 73 65 D. bEnd = offse
21630 74 2b 61 6d 74 3d 3d 70 43 75 72 2d 3e 69 6e 66 t+amt==pCur->inf
21640 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a 23 65 6e 64 o.nPayload;.#end
21650 69 66 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 if. assert( off
21660 73 65 74 2b 61 6d 74 20 3c 3d 20 70 43 75 72 2d set+amt <= pCur-
21670 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 >info.nPayload )
21680 3b 0a 0a 20 20 69 66 28 20 26 61 50 61 79 6c 6f ;.. if( &aPaylo
21690 61 64 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c ad[pCur->info.nL
216a0 6f 63 61 6c 5d 20 3e 20 26 70 50 61 67 65 2d 3e ocal] > &pPage->
216b0 61 44 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c aData[pBt->usabl
216c0 65 53 69 7a 65 5d 20 29 7b 0a 20 20 20 20 2f 2a eSize] ){. /*
216d0 20 54 72 79 69 6e 67 20 74 6f 20 72 65 61 64 20 Trying to read
216e0 6f 72 20 77 72 69 74 65 20 70 61 73 74 20 74 68 or write past th
216f0 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 e end of the dat
21700 61 20 69 73 20 61 6e 20 65 72 72 6f 72 20 2a 2f a is an error */
21710 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
21720 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
21730 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b . }.. /* Check
21740 20 69 66 20 64 61 74 61 20 6d 75 73 74 20 62 65 if data must be
21750 20 72 65 61 64 2f 77 72 69 74 74 65 6e 20 74 6f read/written to
21760 2f 66 72 6f 6d 20 74 68 65 20 62 74 72 65 65 20 /from the btree
21770 70 61 67 65 20 69 74 73 65 6c 66 2e 20 2a 2f 0a page itself. */.
21780 20 20 69 66 28 20 6f 66 66 73 65 74 3c 70 43 75 if( offset<pCu
21790 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 r->info.nLocal )
217a0 7b 0a 20 20 20 20 69 6e 74 20 61 20 3d 20 61 6d {. int a = am
217b0 74 3b 0a 20 20 20 20 69 66 28 20 61 2b 6f 66 66 t;. if( a+off
217c0 73 65 74 3e 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e set>pCur->info.n
217d0 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 61 Local ){. a
217e0 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c = pCur->info.nL
217f0 6f 63 61 6c 20 2d 20 6f 66 66 73 65 74 3b 0a 20 ocal - offset;.
21800 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 63 6f }. rc = co
21810 70 79 50 61 79 6c 6f 61 64 28 26 61 50 61 79 6c pyPayload(&aPayl
21820 6f 61 64 5b 6f 66 66 73 65 74 5d 2c 20 70 42 75 oad[offset], pBu
21830 66 2c 20 61 2c 20 28 65 4f 70 20 26 20 30 78 30 f, a, (eOp & 0x0
21840 31 29 2c 20 70 50 61 67 65 2d 3e 70 44 62 50 61 1), pPage->pDbPa
21850 67 65 29 3b 0a 20 20 20 20 6f 66 66 73 65 74 20 ge);. offset
21860 3d 20 30 3b 0a 20 20 20 20 70 42 75 66 20 2b 3d = 0;. pBuf +=
21870 20 61 3b 0a 20 20 20 20 61 6d 74 20 2d 3d 20 61 a;. amt -= a
21880 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6f ;. }else{. o
21890 66 66 73 65 74 20 2d 3d 20 70 43 75 72 2d 3e 69 ffset -= pCur->i
218a0 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 7d 0a nfo.nLocal;. }.
218b0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
218c0 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b E_OK && amt>0 ){
218d0 0a 20 20 20 20 63 6f 6e 73 74 20 75 33 32 20 6f . const u32 o
218e0 76 66 6c 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 vflSize = pBt->u
218f0 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 20 20 sableSize - 4;
21900 2f 2a 20 42 79 74 65 73 20 63 6f 6e 74 65 6e 74 /* Bytes content
21910 20 70 65 72 20 6f 76 66 6c 20 70 61 67 65 20 2a per ovfl page *
21920 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 50 /. Pgno nextP
21930 61 67 65 3b 0a 0a 20 20 20 20 6e 65 78 74 50 61 age;.. nextPa
21940 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 ge = get4byte(&a
21950 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d 3e 69 6e Payload[pCur->in
21960 66 6f 2e 6e 4c 6f 63 61 6c 5d 29 3b 0a 0a 20 20 fo.nLocal]);..
21970 20 20 2f 2a 20 49 66 20 74 68 65 20 42 74 43 75 /* If the BtCu
21980 72 73 6f 72 2e 61 4f 76 65 72 66 6c 6f 77 5b 5d rsor.aOverflow[]
21990 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 61 6c has not been al
219a0 6c 6f 63 61 74 65 64 2c 20 61 6c 6c 6f 63 61 74 located, allocat
219b0 65 20 69 74 20 6e 6f 77 2e 0a 20 20 20 20 2a 2a e it now.. **
219c0 20 45 78 63 65 70 74 2c 20 64 6f 20 6e 6f 74 20 Except, do not
219d0 61 6c 6c 6f 63 61 74 65 20 61 4f 76 65 72 66 6c allocate aOverfl
219e0 6f 77 5b 5d 20 66 6f 72 20 65 4f 70 3d 3d 32 2e ow[] for eOp==2.
219f0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
21a00 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 he aOverflow[] a
21a10 72 72 61 79 20 69 73 20 73 69 7a 65 64 20 61 74 rray is sized at
21a20 20 6f 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 one entry for e
21a30 61 63 68 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ach overflow pag
21a40 65 0a 20 20 20 20 2a 2a 20 69 6e 20 74 68 65 20 e. ** in the
21a50 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e 20 overflow chain.
21a60 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 The page number
21a70 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 of the first ove
21a80 72 66 6c 6f 77 20 70 61 67 65 20 69 73 0a 20 20 rflow page is.
21a90 20 20 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20 61 ** stored in a
21aa0 4f 76 65 72 66 6c 6f 77 5b 30 5d 2c 20 65 74 63 Overflow[0], etc
21ab0 2e 20 41 20 76 61 6c 75 65 20 6f 66 20 30 20 69 . A value of 0 i
21ac0 6e 20 74 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b n the aOverflow[
21ad0 5d 20 61 72 72 61 79 0a 20 20 20 20 2a 2a 20 6d ] array. ** m
21ae0 65 61 6e 73 20 22 6e 6f 74 20 79 65 74 20 6b 6e eans "not yet kn
21af0 6f 77 6e 22 20 28 74 68 65 20 63 61 63 68 65 20 own" (the cache
21b00 69 73 20 6c 61 7a 69 6c 79 20 70 6f 70 75 6c 61 is lazily popula
21b10 74 65 64 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ted).. */.
21b20 20 69 66 28 20 65 4f 70 21 3d 32 20 26 26 20 28 if( eOp!=2 && (
21b30 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
21b40 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 BTCF_ValidOvfl)
21b50 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 ==0 ){. int
21b60 20 6e 4f 76 66 6c 20 3d 20 28 70 43 75 72 2d 3e nOvfl = (pCur->
21b70 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 2d 70 43 info.nPayload-pC
21b80 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 2b ur->info.nLocal+
21b90 6f 76 66 6c 53 69 7a 65 2d 31 29 2f 6f 76 66 6c ovflSize-1)/ovfl
21ba0 53 69 7a 65 3b 0a 20 20 20 20 20 20 69 66 28 20 Size;. if(
21bb0 6e 4f 76 66 6c 3e 70 43 75 72 2d 3e 6e 4f 76 66 nOvfl>pCur->nOvf
21bc0 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20 20 20 lAlloc ){.
21bd0 20 20 50 67 6e 6f 20 2a 61 4e 65 77 20 3d 20 28 Pgno *aNew = (
21be0 50 67 6e 6f 2a 29 73 71 6c 69 74 65 33 44 62 52 Pgno*)sqlite3DbR
21bf0 65 61 6c 6c 6f 63 28 0a 20 20 20 20 20 20 20 20 ealloc(.
21c00 20 20 20 20 70 43 75 72 2d 3e 70 42 74 72 65 65 pCur->pBtree
21c10 2d 3e 64 62 2c 20 70 43 75 72 2d 3e 61 4f 76 65 ->db, pCur->aOve
21c20 72 66 6c 6f 77 2c 20 6e 4f 76 66 6c 2a 32 2a 73 rflow, nOvfl*2*s
21c30 69 7a 65 6f 66 28 50 67 6e 6f 29 0a 20 20 20 20 izeof(Pgno).
21c40 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 );. i
21c50 66 28 20 61 4e 65 77 3d 3d 30 20 29 7b 0a 20 20 f( aNew==0 ){.
21c60 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
21c70 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 ITE_NOMEM;.
21c80 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
21c90 20 20 20 20 70 43 75 72 2d 3e 6e 4f 76 66 6c 41 pCur->nOvflA
21ca0 6c 6c 6f 63 20 3d 20 6e 4f 76 66 6c 2a 32 3b 0a lloc = nOvfl*2;.
21cb0 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
21cc0 61 4f 76 65 72 66 6c 6f 77 20 3d 20 61 4e 65 77 aOverflow = aNew
21cd0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
21ce0 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 }. if( rc
21cf0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
21d00 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 43 memset(pC
21d10 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 30 ur->aOverflow, 0
21d20 2c 20 6e 4f 76 66 6c 2a 73 69 7a 65 6f 66 28 50 , nOvfl*sizeof(P
21d30 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 20 20 70 gno));. p
21d40 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d Cur->curFlags |=
21d50 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 3b BTCF_ValidOvfl;
21d60 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a . }. }..
21d70 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6f 76 /* If the ov
21d80 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 erflow page-list
21d90 20 63 61 63 68 65 20 68 61 73 20 62 65 65 6e 20 cache has been
21da0 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 74 68 allocated and th
21db0 65 0a 20 20 20 20 2a 2a 20 65 6e 74 72 79 20 66 e. ** entry f
21dc0 6f 72 20 74 68 65 20 66 69 72 73 74 20 72 65 71 or the first req
21dd0 75 69 72 65 64 20 6f 76 65 72 66 6c 6f 77 20 70 uired overflow p
21de0 61 67 65 20 69 73 20 76 61 6c 69 64 2c 20 73 6b age is valid, sk
21df0 69 70 0a 20 20 20 20 2a 2a 20 64 69 72 65 63 74 ip. ** direct
21e00 6c 79 20 74 6f 20 69 74 2e 0a 20 20 20 20 2a 2f ly to it.. */
21e10 0a 20 20 20 20 69 66 28 20 28 70 43 75 72 2d 3e . if( (pCur->
21e20 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
21e30 56 61 6c 69 64 4f 76 66 6c 29 21 3d 30 0a 20 20 ValidOvfl)!=0.
21e40 20 20 20 26 26 20 70 43 75 72 2d 3e 61 4f 76 65 && pCur->aOve
21e50 72 66 6c 6f 77 5b 6f 66 66 73 65 74 2f 6f 76 66 rflow[offset/ovf
21e60 6c 53 69 7a 65 5d 0a 20 20 20 20 29 7b 0a 20 20 lSize]. ){.
21e70 20 20 20 20 69 49 64 78 20 3d 20 28 6f 66 66 73 iIdx = (offs
21e80 65 74 2f 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 et/ovflSize);.
21e90 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 70 nextPage = p
21ea0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 Cur->aOverflow[i
21eb0 49 64 78 5d 3b 0a 20 20 20 20 20 20 6f 66 66 73 Idx];. offs
21ec0 65 74 20 3d 20 28 6f 66 66 73 65 74 25 6f 76 66 et = (offset%ovf
21ed0 6c 53 69 7a 65 29 3b 0a 20 20 20 20 7d 0a 0a 20 lSize);. }..
21ee0 20 20 20 66 6f 72 28 20 3b 20 72 63 3d 3d 53 51 for( ; rc==SQ
21ef0 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 LITE_OK && amt>0
21f00 20 26 26 20 6e 65 78 74 50 61 67 65 3b 20 69 49 && nextPage; iI
21f10 64 78 2b 2b 29 7b 0a 0a 20 20 20 20 20 20 2f 2a dx++){.. /*
21f20 20 49 66 20 72 65 71 75 69 72 65 64 2c 20 70 6f If required, po
21f30 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 66 pulate the overf
21f40 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
21f50 63 68 65 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 che. */. if
21f60 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 ( (pCur->curFlag
21f70 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 s & BTCF_ValidOv
21f80 66 6c 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 fl)!=0 ){.
21f90 20 20 61 73 73 65 72 74 28 21 70 43 75 72 2d 3e assert(!pCur->
21fa0 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 20 aOverflow[iIdx]
21fb0 7c 7c 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c || pCur->aOverfl
21fc0 6f 77 5b 69 49 64 78 5d 3d 3d 6e 65 78 74 50 61 ow[iIdx]==nextPa
21fd0 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 43 75 ge);. pCu
21fe0 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 r->aOverflow[iId
21ff0 78 5d 20 3d 20 6e 65 78 74 50 61 67 65 3b 0a 20 x] = nextPage;.
22000 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 }.. if
22010 28 20 6f 66 66 73 65 74 3e 3d 6f 76 66 6c 53 69 ( offset>=ovflSi
22020 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a ze ){. /*
22030 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 73 6f 6e The only reason
22040 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 61 to read this pa
22050 67 65 20 69 73 20 74 6f 20 6f 62 74 61 69 6e 20 ge is to obtain
22060 74 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 the page.
22070 20 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 ** number for t
22080 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
22090 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 the overflow cha
220a0 69 6e 2e 20 54 68 65 20 70 61 67 65 0a 20 20 20 in. The page.
220b0 20 20 20 20 20 2a 2a 20 64 61 74 61 20 69 73 20 ** data is
220c0 6e 6f 74 20 72 65 71 75 69 72 65 64 2e 20 53 6f not required. So
220d0 20 66 69 72 73 74 20 74 72 79 20 74 6f 20 6c 6f first try to lo
220e0 6f 6b 75 70 20 74 68 65 20 6f 76 65 72 66 6c 6f okup the overflo
220f0 77 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 w. ** pag
22100 65 2d 6c 69 73 74 20 63 61 63 68 65 2c 20 69 66 e-list cache, if
22110 20 61 6e 79 2c 20 74 68 65 6e 20 66 61 6c 6c 20 any, then fall
22120 62 61 63 6b 20 74 6f 20 74 68 65 20 67 65 74 4f back to the getO
22130 76 65 72 66 6c 6f 77 50 61 67 65 28 29 0a 20 20 verflowPage().
22140 20 20 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f ** functio
22150 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 n.. **.
22160 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 ** Note th
22170 61 74 20 74 68 65 20 61 4f 76 65 72 66 6c 6f 77 at the aOverflow
22180 5b 5d 20 61 72 72 61 79 20 6d 75 73 74 20 62 65 [] array must be
22190 20 61 6c 6c 6f 63 61 74 65 64 20 62 65 63 61 75 allocated becau
221a0 73 65 20 65 4f 70 21 3d 32 0a 20 20 20 20 20 20 se eOp!=2.
221b0 20 20 2a 2a 20 68 65 72 65 2e 20 20 49 66 20 65 ** here. If e
221c0 4f 70 3d 3d 32 2c 20 74 68 65 6e 20 6f 66 66 73 Op==2, then offs
221d0 65 74 3d 3d 30 20 61 6e 64 20 74 68 69 73 20 62 et==0 and this b
221e0 72 61 6e 63 68 20 69 73 20 6e 65 76 65 72 20 74 ranch is never t
221f0 61 6b 65 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2f aken.. */
22200 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
22210 20 65 4f 70 21 3d 32 20 29 3b 0a 20 20 20 20 20 eOp!=2 );.
22220 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
22230 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 >curFlags & BTCF
22240 5f 56 61 6c 69 64 4f 76 66 6c 20 29 3b 0a 20 20 _ValidOvfl );.
22250 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e if( pCur->
22260 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 aOverflow[iIdx+1
22270 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e ] ){. n
22280 65 78 74 50 61 67 65 20 3d 20 70 43 75 72 2d 3e extPage = pCur->
22290 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 aOverflow[iIdx+1
222a0 5d 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 ];. }else
222b0 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d {. rc =
222c0 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
222d0 28 70 42 74 2c 20 6e 65 78 74 50 61 67 65 2c 20 (pBt, nextPage,
222e0 30 2c 20 26 6e 65 78 74 50 61 67 65 29 3b 0a 20 0, &nextPage);.
222f0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
22300 20 6f 66 66 73 65 74 20 2d 3d 20 6f 76 66 6c 53 offset -= ovflS
22310 69 7a 65 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 ize;. }else
22320 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 65 {. /* Nee
22330 64 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 d to read this p
22340 61 67 65 20 70 72 6f 70 65 72 6c 79 2e 20 49 74 age properly. It
22350 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 6f contains some o
22360 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a f the. **
22370 20 72 61 6e 67 65 20 6f 66 20 64 61 74 61 20 74 range of data t
22380 68 61 74 20 69 73 20 62 65 69 6e 67 20 72 65 61 hat is being rea
22390 64 20 28 65 4f 70 3d 3d 30 29 20 6f 72 20 77 72 d (eOp==0) or wr
223a0 69 74 74 65 6e 20 28 65 4f 70 21 3d 30 29 2e 0a itten (eOp!=0)..
223b0 20 20 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 */.#ifde
223c0 66 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f f SQLITE_DIRECT_
223d0 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 OVERFLOW_READ.
223e0 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 sqlite3_fi
223f0 6c 65 20 2a 66 64 3b 0a 23 65 6e 64 69 66 0a 20 le *fd;.#endif.
22400 20 20 20 20 20 20 20 69 6e 74 20 61 20 3d 20 61 int a = a
22410 6d 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 mt;. if(
22420 61 20 2b 20 6f 66 66 73 65 74 20 3e 20 6f 76 66 a + offset > ovf
22430 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 lSize ){.
22440 20 20 20 61 20 3d 20 6f 76 66 6c 53 69 7a 65 20 a = ovflSize
22450 2d 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 20 20 - offset;.
22460 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 }..#ifdef SQLI
22470 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c TE_DIRECT_OVERFL
22480 4f 57 5f 52 45 41 44 0a 20 20 20 20 20 20 20 20 OW_READ.
22490 2f 2a 20 49 66 20 61 6c 6c 20 74 68 65 20 66 6f /* If all the fo
224a0 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65 llowing are true
224b0 3a 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 :. **.
224c0 20 20 20 20 20 2a 2a 20 20 20 31 29 20 74 68 69 ** 1) thi
224d0 73 20 69 73 20 61 20 72 65 61 64 20 6f 70 65 72 s is a read oper
224e0 61 74 69 6f 6e 2c 20 61 6e 64 20 0a 20 20 20 20 ation, and .
224f0 20 20 20 20 2a 2a 20 20 20 32 29 20 64 61 74 61 ** 2) data
22500 20 69 73 20 72 65 71 75 69 72 65 64 20 66 72 6f is required fro
22510 6d 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 m the start of t
22520 68 69 73 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 his overflow pag
22530 65 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a e, and. *
22540 2a 20 20 20 33 29 20 74 68 65 20 64 61 74 61 62 * 3) the datab
22550 61 73 65 20 69 73 20 66 69 6c 65 2d 62 61 63 6b ase is file-back
22560 65 64 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 ed, and.
22570 2a 2a 20 20 20 34 29 20 74 68 65 72 65 20 69 73 ** 4) there is
22580 20 6e 6f 20 6f 70 65 6e 20 77 72 69 74 65 2d 74 no open write-t
22590 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64 0a ransaction, and.
225a0 20 20 20 20 20 20 20 20 2a 2a 20 20 20 35 29 20 ** 5)
225b0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
225c0 6e 6f 74 20 61 20 57 41 4c 20 64 61 74 61 62 61 not a WAL databa
225d0 73 65 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 se,. **
225e0 20 36 29 20 61 6c 6c 20 64 61 74 61 20 66 72 6f 6) all data fro
225f0 6d 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65 m the page is be
22600 69 6e 67 20 72 65 61 64 2e 0a 20 20 20 20 20 20 ing read..
22610 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 **. **
22620 74 68 65 6e 20 64 61 74 61 20 63 61 6e 20 62 65 then data can be
22630 20 72 65 61 64 20 64 69 72 65 63 74 6c 79 20 66 read directly f
22640 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
22650 20 66 69 6c 65 20 69 6e 74 6f 20 74 68 65 0a 20 file into the.
22660 20 20 20 20 20 20 20 2a 2a 20 6f 75 74 70 75 74 ** output
22670 20 62 75 66 66 65 72 2c 20 62 79 70 61 73 73 69 buffer, bypassi
22680 6e 67 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 ng the page-cach
22690 65 20 61 6c 74 6f 67 65 74 68 65 72 2e 20 54 68 e altogether. Th
226a0 69 73 20 73 70 65 65 64 73 0a 20 20 20 20 20 20 is speeds.
226b0 20 20 2a 2a 20 75 70 20 6c 6f 61 64 69 6e 67 20 ** up loading
226c0 6c 61 72 67 65 20 72 65 63 6f 72 64 73 20 74 68 large records th
226d0 61 74 20 73 70 61 6e 20 6d 61 6e 79 20 6f 76 65 at span many ove
226e0 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 20 20 20 rflow pages..
226f0 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
22700 69 66 28 20 28 65 4f 70 26 30 78 30 31 29 3d 3d if( (eOp&0x01)==
22710 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
22720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22730 20 20 20 20 20 20 20 2f 2a 20 28 31 29 20 2a 2f /* (1) */
22740 0a 20 20 20 20 20 20 20 20 20 26 26 20 6f 66 66 . && off
22750 73 65 74 3d 3d 30 20 20 20 20 20 20 20 20 20 20 set==0
22760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22770 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22780 2f 2a 20 28 32 29 20 2a 2f 0a 20 20 20 20 20 20 /* (2) */.
22790 20 20 20 26 26 20 28 62 45 6e 64 20 7c 7c 20 61 && (bEnd || a
227a0 3d 3d 6f 76 66 6c 53 69 7a 65 29 20 20 20 20 20 ==ovflSize)
227b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
227c0 20 20 20 20 20 20 20 20 20 2f 2a 20 28 36 29 20 /* (6)
227d0 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 70 */. && p
227e0 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
227f0 6e 3d 3d 54 52 41 4e 53 5f 52 45 41 44 20 20 20 n==TRANS_READ
22800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22810 20 20 2f 2a 20 28 34 29 20 2a 2f 0a 20 20 20 20 /* (4) */.
22820 20 20 20 20 20 26 26 20 28 66 64 20 3d 20 73 71 && (fd = sq
22830 6c 69 74 65 33 50 61 67 65 72 46 69 6c 65 28 70 lite3PagerFile(p
22840 42 74 2d 3e 70 50 61 67 65 72 29 29 2d 3e 70 4d Bt->pPager))->pM
22850 65 74 68 6f 64 73 20 20 20 20 20 2f 2a 20 28 33 ethods /* (3
22860 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 ) */. &&
22870 20 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 pBt->pPage1->aD
22880 61 74 61 5b 31 39 5d 3d 3d 30 78 30 31 20 20 20 ata[19]==0x01
22890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
228a0 20 20 20 20 2f 2a 20 28 35 29 20 2a 2f 0a 20 20 /* (5) */.
228b0 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
228c0 20 20 20 75 38 20 61 53 61 76 65 5b 34 5d 3b 0a u8 aSave[4];.
228d0 20 20 20 20 20 20 20 20 20 20 75 38 20 2a 61 57 u8 *aW
228e0 72 69 74 65 20 3d 20 26 70 42 75 66 5b 2d 34 5d rite = &pBuf[-4]
228f0 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 ;. memc
22900 70 79 28 61 53 61 76 65 2c 20 61 57 72 69 74 65 py(aSave, aWrite
22910 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 4);.
22920 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 rc = sqlite3OsRe
22930 61 64 28 66 64 2c 20 61 57 72 69 74 65 2c 20 61 ad(fd, aWrite, a
22940 2b 34 2c 20 28 69 36 34 29 70 42 74 2d 3e 70 61 +4, (i64)pBt->pa
22950 67 65 53 69 7a 65 2a 28 6e 65 78 74 50 61 67 65 geSize*(nextPage
22960 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 -1));.
22970 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 62 nextPage = get4b
22980 79 74 65 28 61 57 72 69 74 65 29 3b 0a 20 20 20 yte(aWrite);.
22990 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 57 memcpy(aW
229a0 72 69 74 65 2c 20 61 53 61 76 65 2c 20 34 29 3b rite, aSave, 4);
229b0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 0a 23 . }else.#
229c0 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 20 20 7b endif.. {
229d0 0a 20 20 20 20 20 20 20 20 20 20 44 62 50 61 67 . DbPag
229e0 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 20 20 e *pDbPage;.
229f0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
22a00 65 33 50 61 67 65 72 41 63 71 75 69 72 65 28 70 e3PagerAcquire(p
22a10 42 74 2d 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 Bt->pPager, next
22a20 50 61 67 65 2c 20 26 70 44 62 50 61 67 65 2c 0a Page, &pDbPage,.
22a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 ((
22a40 65 4f 70 26 30 78 30 31 29 3d 3d 30 20 3f 20 50 eOp&0x01)==0 ? P
22a50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c AGER_GET_READONL
22a60 59 20 3a 20 30 29 0a 20 20 20 20 20 20 20 20 20 Y : 0).
22a70 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 );. if
22a80 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
22a90 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 ){. a
22aa0 50 61 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 Payload = sqlite
22ab0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
22ac0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
22ad0 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 nextPage = g
22ae0 65 74 34 62 79 74 65 28 61 50 61 79 6c 6f 61 64 et4byte(aPayload
22af0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
22b00 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 c = copyPayload(
22b10 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 &aPayload[offset
22b20 2b 34 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 +4], pBuf, a, (e
22b30 4f 70 26 30 78 30 31 29 2c 20 70 44 62 50 61 67 Op&0x01), pDbPag
22b40 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
22b50 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
22b60 66 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 f(pDbPage);.
22b70 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d offset =
22b80 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 0;. }.
22b90 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
22ba0 20 20 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 amt -= a;.
22bb0 20 20 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 pBuf += a;.
22bc0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
22bd0 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 .. if( rc==SQLI
22be0 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 TE_OK && amt>0 )
22bf0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
22c00 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
22c10 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
22c20 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 c;.}../*.** Read
22c30 20 70 61 72 74 20 6f 66 20 74 68 65 20 6b 65 79 part of the key
22c40 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
22c50 20 63 75 72 73 6f 72 20 70 43 75 72 2e 20 20 45 cursor pCur. E
22c60 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 xactly.** "amt"
22c70 62 79 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 bytes will be tr
22c80 61 6e 73 66 65 72 72 65 64 20 69 6e 74 6f 20 70 ansferred into p
22c90 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e Buf[]. The tran
22ca0 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 sfer.** begins a
22cb0 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a t "offset"..**.*
22cc0 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 * The caller mus
22cd0 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 70 43 t ensure that pC
22ce0 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 ur is pointing t
22cf0 6f 20 61 20 76 61 6c 69 64 20 72 6f 77 0a 2a 2a o a valid row.**
22d00 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a in the table..*
22d10 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 *.** Return SQLI
22d20 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 TE_OK on success
22d30 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 or an error cod
22d40 65 20 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f e if anything go
22d50 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e es.** wrong. An
22d60 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e error is return
22d70 65 64 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d ed if "offset+am
22d80 74 22 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 t" is larger tha
22d90 6e 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 n.** the availab
22da0 6c 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 le payload..*/.i
22db0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b nt sqlite3BtreeK
22dc0 65 79 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ey(BtCursor *pCu
22dd0 72 2c 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 r, u32 offset, u
22de0 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 32 amt, void *pB
22df0 75 66 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 uf){. assert( c
22e00 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
22e10 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
22e20 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
22e30 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
22e40 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
22e50 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 70 43 75 >iPage>=0 && pCu
22e60 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
22e70 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 iPage] );. asse
22e80 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b rt( pCur->aiIdx[
22e90 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 pCur->iPage]<pCu
22ea0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
22eb0 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b iPage]->nCell );
22ec0 0a 20 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 . return access
22ed0 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 Payload(pCur, of
22ee0 66 73 65 74 2c 20 61 6d 74 2c 20 28 75 6e 73 69 fset, amt, (unsi
22ef0 67 6e 65 64 20 63 68 61 72 2a 29 70 42 75 66 2c gned char*)pBuf,
22f00 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 0);.}../*.** Re
22f10 61 64 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 ad part of the d
22f20 61 74 61 20 61 73 73 6f 63 69 61 74 65 64 20 77 ata associated w
22f30 69 74 68 20 63 75 72 73 6f 72 20 70 43 75 72 2e ith cursor pCur.
22f40 20 20 45 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d Exactly.** "am
22f50 74 22 20 62 79 74 65 73 20 77 69 6c 6c 20 62 65 t" bytes will be
22f60 20 74 72 61 6e 73 66 65 72 65 64 20 69 6e 74 6f transfered into
22f70 20 70 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 pBuf[]. The tr
22f80 61 6e 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 ansfer.** begins
22f90 20 61 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a at "offset"..**
22fa0 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 .** Return SQLIT
22fb0 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 E_OK on success
22fc0 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 or an error code
22fd0 20 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 if anything goe
22fe0 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 s.** wrong. An
22ff0 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 error is returne
23000 64 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 d if "offset+amt
23010 22 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e " is larger than
23020 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c .** the availabl
23030 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e e payload..*/.in
23040 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 t sqlite3BtreeDa
23050 74 61 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ta(BtCursor *pCu
23060 72 2c 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 r, u32 offset, u
23070 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 32 amt, void *pB
23080 75 66 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a uf){. int rc;..
23090 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
230a0 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69 MIT_INCRBLOB. i
230b0 66 20 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 f ( pCur->eState
230c0 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
230d0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
230e0 51 4c 49 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d QLITE_ABORT;. }
230f0 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
23100 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 t( cursorHoldsMu
23110 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 72 tex(pCur) );. r
23120 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f c = restoreCurso
23130 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b rPosition(pCur);
23140 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
23150 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 E_OK ){. asse
23160 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
23170 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
23180 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 ;. assert( pC
23190 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 ur->iPage>=0 &&
231a0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
231b0 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 20 r->iPage] );.
231c0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
231d0 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
231e0 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 ]<pCur->apPage[p
231f0 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 Cur->iPage]->nCe
23200 6c 6c 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 ll );. rc = a
23210 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 ccessPayload(pCu
23220 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 r, offset, amt,
23230 70 42 75 66 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 pBuf, 0);. }.
23240 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
23250 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 .** Return a poi
23260 6e 74 65 72 20 74 6f 20 70 61 79 6c 6f 61 64 20 nter to payload
23270 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d information from
23280 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 the entry that
23290 74 68 65 20 0a 2a 2a 20 70 43 75 72 20 63 75 72 the .** pCur cur
232a0 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 sor is pointing
232b0 74 6f 2e 20 20 54 68 65 20 70 6f 69 6e 74 65 72 to. The pointer
232c0 20 69 73 20 74 6f 20 74 68 65 20 62 65 67 69 6e is to the begin
232d0 6e 69 6e 67 20 6f 66 0a 2a 2a 20 74 68 65 20 6b ning of.** the k
232e0 65 79 20 69 66 20 69 6e 64 65 78 20 62 74 72 65 ey if index btre
232f0 65 73 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 es (pPage->intKe
23300 79 3d 3d 30 29 20 61 6e 64 20 69 73 20 74 68 65 y==0) and is the
23310 20 64 61 74 61 20 66 6f 72 0a 2a 2a 20 74 61 62 data for.** tab
23320 6c 65 20 62 74 72 65 65 73 20 28 70 50 61 67 65 le btrees (pPage
23330 2d 3e 69 6e 74 4b 65 79 3d 3d 31 29 2e 20 54 68 ->intKey==1). Th
23340 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
23350 73 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 0a 2a s of available.*
23360 2a 20 6b 65 79 2f 64 61 74 61 20 69 73 20 77 72 * key/data is wr
23370 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 41 6d 74 itten into *pAmt
23380 2e 20 20 49 66 20 2a 70 41 6d 74 3d 3d 30 2c 20 . If *pAmt==0,
23390 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 0a 2a then the value.*
233a0 2a 20 72 65 74 75 72 6e 65 64 20 77 69 6c 6c 20 * returned will
233b0 6e 6f 74 20 62 65 20 61 20 76 61 6c 69 64 20 70 not be a valid p
233c0 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 ointer..**.** Th
233d0 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6e is routine is an
233e0 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 optimization.
233f0 49 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 66 6f 72 It is common for
23400 20 74 68 65 20 65 6e 74 69 72 65 20 6b 65 79 0a the entire key.
23410 2a 2a 20 61 6e 64 20 64 61 74 61 20 74 6f 20 66 ** and data to f
23420 69 74 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 it on the local
23430 70 61 67 65 20 61 6e 64 20 66 6f 72 20 74 68 65 page and for the
23440 72 65 20 74 6f 20 62 65 20 6e 6f 20 6f 76 65 72 re to be no over
23450 66 6c 6f 77 0a 2a 2a 20 70 61 67 65 73 2e 20 20 flow.** pages.
23460 57 68 65 6e 20 74 68 61 74 20 69 73 20 73 6f 2c When that is so,
23470 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 63 61 this routine ca
23480 6e 20 62 65 20 75 73 65 64 20 74 6f 20 61 63 63 n be used to acc
23490 65 73 73 20 74 68 65 0a 2a 2a 20 6b 65 79 20 61 ess the.** key a
234a0 6e 64 20 64 61 74 61 20 77 69 74 68 6f 75 74 20 nd data without
234b0 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 2e 20 20 making a copy.
234c0 49 66 20 74 68 65 20 6b 65 79 20 61 6e 64 2f 6f If the key and/o
234d0 72 20 64 61 74 61 20 73 70 69 6c 6c 73 0a 2a 2a r data spills.**
234e0 20 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 onto overflow p
234f0 61 67 65 73 2c 20 74 68 65 6e 20 61 63 63 65 73 ages, then acces
23500 73 50 61 79 6c 6f 61 64 28 29 20 6d 75 73 74 20 sPayload() must
23510 62 65 20 75 73 65 64 20 74 6f 20 72 65 61 73 73 be used to reass
23520 65 6d 62 6c 65 0a 2a 2a 20 74 68 65 20 6b 65 79 emble.** the key
23530 2f 64 61 74 61 20 61 6e 64 20 63 6f 70 79 20 69 /data and copy i
23540 74 20 69 6e 74 6f 20 61 20 70 72 65 61 6c 6c 6f t into a preallo
23550 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a 2a 2a cated buffer..**
23560 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 .** The pointer
23570 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 returned by this
23580 20 72 6f 75 74 69 6e 65 20 6c 6f 6f 6b 73 20 64 routine looks d
23590 69 72 65 63 74 6c 79 20 69 6e 74 6f 20 74 68 65 irectly into the
235a0 20 63 61 63 68 65 64 0a 2a 2a 20 70 61 67 65 20 cached.** page
235b0 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2e of the database.
235c0 20 20 54 68 65 20 64 61 74 61 20 6d 69 67 68 74 The data might
235d0 20 63 68 61 6e 67 65 20 6f 72 20 6d 6f 76 65 20 change or move
235e0 74 68 65 20 6e 65 78 74 20 74 69 6d 65 0a 2a 2a the next time.**
235f0 20 61 6e 79 20 62 74 72 65 65 20 72 6f 75 74 69 any btree routi
23600 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f ne is called..*/
23610 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 76 6f .static const vo
23620 69 64 20 2a 66 65 74 63 68 50 61 79 6c 6f 61 64 id *fetchPayload
23630 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 (. BtCursor *pC
23640 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 ur, /* Curs
23650 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 or pointing to e
23660 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f ntry to read fro
23670 6d 20 2a 2f 0a 20 20 75 33 32 20 2a 70 41 6d 74 m */. u32 *pAmt
23680 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
23690 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 rite the number
236a0 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 of available byt
236b0 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 es here */.){.
236c0 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 assert( pCur!=0
236d0 26 26 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d && pCur->iPage>=
236e0 30 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 0 && pCur->apPag
236f0 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b e[pCur->iPage]);
23700 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
23710 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
23720 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
23730 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
23740 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 _held(pCur->pBtr
23750 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ee->db->mutex) )
23760 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
23770 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
23780 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
23790 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
237a0 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d 3e 61 ->iPage]<pCur->a
237b0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
237c0 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 e]->nCell );. a
237d0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 ssert( pCur->inf
237e0 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 20 2a o.nSize>0 );. *
237f0 70 41 6d 74 20 3d 20 70 43 75 72 2d 3e 69 6e 66 pAmt = pCur->inf
23800 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 72 65 74 75 o.nLocal;. retu
23810 72 6e 20 28 76 6f 69 64 2a 29 70 43 75 72 2d 3e rn (void*)pCur->
23820 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3b 0a 7d info.pPayload;.}
23830 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 .../*.** For the
23840 20 65 6e 74 72 79 20 74 68 61 74 20 63 75 72 73 entry that curs
23850 6f 72 20 70 43 75 72 20 69 73 20 70 6f 69 6e 74 or pCur is point
23860 20 74 6f 2c 20 72 65 74 75 72 6e 20 61 73 0a 2a to, return as.*
23870 2a 20 6d 61 6e 79 20 62 79 74 65 73 20 6f 66 20 * many bytes of
23880 74 68 65 20 6b 65 79 20 6f 72 20 64 61 74 61 20 the key or data
23890 61 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 as are available
238a0 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 0a 2a 2a on the local.**
238b0 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 20 57 b-tree page. W
238c0 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 rite the number
238d0 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 of available byt
238e0 65 73 20 69 6e 74 6f 20 2a 70 41 6d 74 2e 0a 2a es into *pAmt..*
238f0 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 *.** The pointer
23900 20 72 65 74 75 72 6e 65 64 20 69 73 20 65 70 68 returned is eph
23910 65 6d 65 72 61 6c 2e 20 20 54 68 65 20 6b 65 79 emeral. The key
23920 2f 64 61 74 61 20 6d 61 79 20 6d 6f 76 65 0a 2a /data may move.*
23930 2a 20 6f 72 20 62 65 20 64 65 73 74 72 6f 79 65 * or be destroye
23940 64 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 63 61 d on the next ca
23950 6c 6c 20 74 6f 20 61 6e 79 20 42 74 72 65 65 20 ll to any Btree
23960 72 6f 75 74 69 6e 65 2c 0a 2a 2a 20 69 6e 63 6c routine,.** incl
23970 75 64 69 6e 67 20 63 61 6c 6c 73 20 66 72 6f 6d uding calls from
23980 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20 61 other threads a
23990 67 61 69 6e 73 74 20 74 68 65 20 73 61 6d 65 20 gainst the same
239a0 63 61 63 68 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c cache..** Hence,
239b0 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20 a mutex on the
239c0 42 74 53 68 61 72 65 64 20 73 68 6f 75 6c 64 20 BtShared should
239d0 62 65 20 68 65 6c 64 20 70 72 69 6f 72 20 74 6f be held prior to
239e0 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 74 68 69 73 calling.** this
239f0 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 routine..**.**
23a00 54 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 69 These routines i
23a10 73 20 75 73 65 64 20 74 6f 20 67 65 74 20 71 75 s used to get qu
23a20 69 63 6b 20 61 63 63 65 73 73 20 74 6f 20 6b 65 ick access to ke
23a30 79 20 61 6e 64 20 64 61 74 61 0a 2a 2a 20 69 6e y and data.** in
23a40 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 the common case
23a50 20 77 68 65 72 65 20 6e 6f 20 6f 76 65 72 66 6c where no overfl
23a60 6f 77 20 70 61 67 65 73 20 61 72 65 20 75 73 65 ow pages are use
23a70 64 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 d..*/.const void
23a80 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 *sqlite3BtreeKe
23a90 79 46 65 74 63 68 28 42 74 43 75 72 73 6f 72 20 yFetch(BtCursor
23aa0 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 41 6d 74 *pCur, u32 *pAmt
23ab0 29 7b 0a 20 20 72 65 74 75 72 6e 20 66 65 74 63 ){. return fetc
23ac0 68 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 hPayload(pCur, p
23ad0 41 6d 74 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f Amt);.}.const vo
23ae0 69 64 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 id *sqlite3Btree
23af0 44 61 74 61 46 65 74 63 68 28 42 74 43 75 72 73 DataFetch(BtCurs
23b00 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 or *pCur, u32 *p
23b10 41 6d 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 66 Amt){. return f
23b20 65 74 63 68 50 61 79 6c 6f 61 64 28 70 43 75 72 etchPayload(pCur
23b30 2c 20 70 41 6d 74 29 3b 0a 7d 0a 0a 0a 2f 2a 0a , pAmt);.}.../*.
23b40 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
23b50 6f 72 20 64 6f 77 6e 20 74 6f 20 61 20 6e 65 77 or down to a new
23b60 20 63 68 69 6c 64 20 70 61 67 65 2e 20 20 54 68 child page. Th
23b70 65 20 6e 65 77 50 67 6e 6f 20 61 72 67 75 6d 65 e newPgno argume
23b80 6e 74 20 69 73 20 74 68 65 0a 2a 2a 20 70 61 67 nt is the.** pag
23b90 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
23ba0 63 68 69 6c 64 20 70 61 67 65 20 74 6f 20 6d 6f child page to mo
23bb0 76 65 20 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 ve to..**.** Thi
23bc0 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
23bd0 6e 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 ns SQLITE_CORRUP
23be0 54 20 69 66 20 74 68 65 20 70 61 67 65 2d 68 65 T if the page-he
23bf0 61 64 65 72 20 66 6c 61 67 73 20 66 69 65 6c 64 ader flags field
23c00 20 6f 66 0a 2a 2a 20 74 68 65 20 6e 65 77 20 63 of.** the new c
23c10 68 69 6c 64 20 70 61 67 65 20 64 6f 65 73 20 6e hild page does n
23c20 6f 74 20 6d 61 74 63 68 20 74 68 65 20 66 6c 61 ot match the fla
23c30 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 gs field of the
23c40 70 61 72 65 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 parent (i.e..**
23c50 69 66 20 61 6e 20 69 6e 74 6b 65 79 20 70 61 67 if an intkey pag
23c60 65 20 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 e appears to be
23c70 74 68 65 20 70 61 72 65 6e 74 20 6f 66 20 61 20 the parent of a
23c80 6e 6f 6e 2d 69 6e 74 6b 65 79 20 70 61 67 65 2c non-intkey page,
23c90 20 6f 72 0a 2a 2a 20 76 69 63 65 2d 76 65 72 73 or.** vice-vers
23ca0 61 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e a)..*/.static in
23cb0 74 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 42 74 t moveToChild(Bt
23cc0 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 Cursor *pCur, u3
23cd0 32 20 6e 65 77 50 67 6e 6f 29 7b 0a 20 20 69 6e 2 newPgno){. in
23ce0 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 20 3d 20 t rc;. int i =
23cf0 70 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 4d pCur->iPage;. M
23d00 65 6d 50 61 67 65 20 2a 70 4e 65 77 50 61 67 65 emPage *pNewPage
23d10 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
23d20 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 0a t = pCur->pBt;..
23d30 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
23d40 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
23d50 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
23d60 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
23d70 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 OR_VALID );. as
23d80 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 sert( pCur->iPag
23d90 65 3c 42 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 e<BTCURSOR_MAX_D
23da0 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 EPTH );. assert
23db0 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 ( pCur->iPage>=0
23dc0 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e );. if( pCur->
23dd0 69 50 61 67 65 3e 3d 28 42 54 43 55 52 53 4f 52 iPage>=(BTCURSOR
23de0 5f 4d 41 58 5f 44 45 50 54 48 2d 31 29 20 29 7b _MAX_DEPTH-1) ){
23df0 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
23e00 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
23e10 0a 20 20 7d 0a 20 20 72 63 20 3d 20 67 65 74 41 . }. rc = getA
23e20 6e 64 49 6e 69 74 50 61 67 65 28 70 42 74 2c 20 ndInitPage(pBt,
23e30 6e 65 77 50 67 6e 6f 2c 20 26 70 4e 65 77 50 61 newPgno, &pNewPa
23e40 67 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ge,.
23e50 20 20 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 (pCur->curFla
23e60 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
23e70 6c 61 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f lag)==0 ? PAGER_
23e80 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 GET_READONLY : 0
23e90 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 );. if( rc ) re
23ea0 74 75 72 6e 20 72 63 3b 0a 20 20 70 43 75 72 2d turn rc;. pCur-
23eb0 3e 61 70 50 61 67 65 5b 69 2b 31 5d 20 3d 20 70 >apPage[i+1] = p
23ec0 4e 65 77 50 61 67 65 3b 0a 20 20 70 43 75 72 2d NewPage;. pCur-
23ed0 3e 61 69 49 64 78 5b 69 2b 31 5d 20 3d 20 30 3b >aiIdx[i+1] = 0;
23ee0 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 2b 2b . pCur->iPage++
23ef0 3b 0a 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ;.. pCur->info.
23f00 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 nSize = 0;. pCu
23f10 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e r->curFlags &= ~
23f20 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c (BTCF_ValidNKey|
23f30 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b BTCF_ValidOvfl);
23f40 0a 20 20 69 66 28 20 70 4e 65 77 50 61 67 65 2d . if( pNewPage-
23f50 3e 6e 43 65 6c 6c 3c 31 20 7c 7c 20 70 4e 65 77 >nCell<1 || pNew
23f60 50 61 67 65 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 Page->intKey!=pC
23f70 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 69 ur->apPage[i]->i
23f80 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 72 65 74 ntKey ){. ret
23f90 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
23fa0 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 PT_BKPT;. }. r
23fb0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
23fc0 0a 7d 0a 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 .}..#if 0./*.**
23fd0 50 61 67 65 20 70 50 61 72 65 6e 74 20 69 73 20 Page pParent is
23fe0 61 6e 20 69 6e 74 65 72 6e 61 6c 20 28 6e 6f 6e an internal (non
23ff0 2d 6c 65 61 66 29 20 74 72 65 65 20 70 61 67 65 -leaf) tree page
24000 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
24010 0a 2a 2a 20 61 73 73 65 72 74 73 20 74 68 61 74 .** asserts that
24020 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 43 68 page number iCh
24030 69 6c 64 20 69 73 20 74 68 65 20 6c 65 66 74 2d ild is the left-
24040 63 68 69 6c 64 20 69 66 20 74 68 65 20 69 49 64 child if the iId
24050 78 27 74 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 x'th.** cell in
24060 70 61 67 65 20 70 50 61 72 65 6e 74 2e 20 4f 72 page pParent. Or
24070 2c 20 69 66 20 69 49 64 78 20 69 73 20 65 71 75 , if iIdx is equ
24080 61 6c 20 74 6f 20 74 68 65 20 74 6f 74 61 6c 20 al to the total
24090 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 65 6c number of.** cel
240a0 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 2c 20 74 ls in pParent, t
240b0 68 61 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 hat page number
240c0 69 43 68 69 6c 64 20 69 73 20 74 68 65 20 72 69 iChild is the ri
240d0 67 68 74 2d 63 68 69 6c 64 20 6f 66 0a 2a 2a 20 ght-child of.**
240e0 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 the page..*/.sta
240f0 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 50 tic void assertP
24100 61 72 65 6e 74 49 6e 64 65 78 28 4d 65 6d 50 61 arentIndex(MemPa
24110 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 69 6e 74 ge *pParent, int
24120 20 69 49 64 78 2c 20 50 67 6e 6f 20 69 43 68 69 iIdx, Pgno iChi
24130 6c 64 29 7b 0a 20 20 61 73 73 65 72 74 28 20 69 ld){. assert( i
24140 49 64 78 3c 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 Idx<=pParent->nC
24150 65 6c 6c 20 29 3b 0a 20 20 69 66 28 20 69 49 64 ell );. if( iId
24160 78 3d 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c x==pParent->nCel
24170 6c 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 l ){. assert(
24180 20 67 65 74 34 62 79 74 65 28 26 70 50 61 72 65 get4byte(&pPare
24190 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e nt->aData[pParen
241a0 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 t->hdrOffset+8])
241b0 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 65 ==iChild );. }e
241c0 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 lse{. assert(
241d0 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 get4byte(findCe
241e0 6c 6c 28 70 50 61 72 65 6e 74 2c 20 69 49 64 78 ll(pParent, iIdx
241f0 29 29 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 ))==iChild );.
24200 7d 0a 7d 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 }.}.#else.# def
24210 69 6e 65 20 61 73 73 65 72 74 50 61 72 65 6e 74 ine assertParent
24220 49 6e 64 65 78 28 78 2c 79 2c 7a 29 20 0a 23 65 Index(x,y,z) .#e
24230 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 ndif../*.** Move
24240 20 74 68 65 20 63 75 72 73 6f 72 20 75 70 20 74 the cursor up t
24250 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 o the parent pag
24260 65 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 e..**.** pCur->i
24270 64 78 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 dx is set to the
24280 20 63 65 6c 6c 20 69 6e 64 65 78 20 74 68 61 74 cell index that
24290 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 6f contains the po
242a0 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 inter.** to the
242b0 70 61 67 65 20 77 65 20 61 72 65 20 63 6f 6d 69 page we are comi
242c0 6e 67 20 66 72 6f 6d 2e 20 20 49 66 20 77 65 20 ng from. If we
242d0 61 72 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 are coming from
242e0 74 68 65 0a 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 the.** right-mos
242f0 74 20 63 68 69 6c 64 20 70 61 67 65 20 74 68 65 t child page the
24300 6e 20 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 n pCur->idx is s
24310 65 74 20 74 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 et to one more t
24320 68 61 6e 0a 2a 2a 20 74 68 65 20 6c 61 72 67 65 han.** the large
24330 73 74 20 63 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a st cell index..*
24340 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 6f /.static void mo
24350 76 65 54 6f 50 61 72 65 6e 74 28 42 74 43 75 72 veToParent(BtCur
24360 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 sor *pCur){. as
24370 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
24380 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
24390 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
243a0 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
243b0 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 ALID );. assert
243c0 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 ( pCur->iPage>0
243d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
243e0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
243f0 69 50 61 67 65 5d 20 29 3b 0a 0a 20 20 2f 2a 20 iPage] );.. /*
24400 55 50 44 41 54 45 3a 20 49 74 20 69 73 20 61 63 UPDATE: It is ac
24410 74 75 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 tually possible
24420 66 6f 72 20 74 68 65 20 63 6f 6e 64 69 74 69 6f for the conditio
24430 6e 20 74 65 73 74 65 64 20 62 79 20 74 68 65 20 n tested by the
24440 61 73 73 65 72 74 0a 20 20 2a 2a 20 62 65 6c 6f assert. ** belo
24450 77 20 74 6f 20 62 65 20 75 6e 74 72 75 65 20 69 w to be untrue i
24460 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
24470 69 6c 65 20 69 73 20 63 6f 72 72 75 70 74 2e 20 ile is corrupt.
24480 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72 20 69 This can occur i
24490 66 0a 20 20 2a 2a 20 6f 6e 65 20 63 75 72 73 6f f. ** one curso
244a0 72 20 68 61 73 20 6d 6f 64 69 66 69 65 64 20 70 r has modified p
244b0 61 67 65 20 70 50 61 72 65 6e 74 20 77 68 69 6c age pParent whil
244c0 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f e a reference to
244d0 20 69 74 20 69 73 20 68 65 6c 64 20 0a 20 20 2a it is held . *
244e0 2a 20 62 79 20 61 20 73 65 63 6f 6e 64 20 63 75 * by a second cu
244f0 72 73 6f 72 2e 20 57 68 69 63 68 20 63 61 6e 20 rsor. Which can
24500 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 61 only happen if a
24510 20 73 69 6e 67 6c 65 20 70 61 67 65 20 69 73 20 single page is
24520 6c 69 6e 6b 65 64 0a 20 20 2a 2a 20 69 6e 74 6f linked. ** into
24530 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 62 more than one b
24540 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 -tree structure
24550 69 6e 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 in a corrupt dat
24560 61 62 61 73 65 2e 20 20 2a 2f 0a 23 69 66 20 30 abase. */.#if 0
24570 0a 20 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 . assertParentI
24580 6e 64 65 78 28 0a 20 20 20 20 70 43 75 72 2d 3e ndex(. pCur->
24590 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
245a0 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 ge-1], . pCur
245b0 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
245c0 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 age-1], . pCu
245d0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
245e0 69 50 61 67 65 5d 2d 3e 70 67 6e 6f 0a 20 20 29 iPage]->pgno. )
245f0 3b 0a 23 65 6e 64 69 66 0a 20 20 74 65 73 74 63 ;.#endif. testc
24600 61 73 65 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ase( pCur->aiIdx
24610 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 20 [pCur->iPage-1]
24620 3e 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 > pCur->apPage[p
24630 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2d 3e 6e Cur->iPage-1]->n
24640 43 65 6c 6c 20 29 3b 0a 0a 20 20 72 65 6c 65 61 Cell );.. relea
24650 73 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 sePage(pCur->apP
24660 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
24670 29 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 );. pCur->iPage
24680 2d 2d 3b 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f --;. pCur->info
24690 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 .nSize = 0;. pC
246a0 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 ur->curFlags &=
246b0 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 ~(BTCF_ValidNKey
246c0 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 |BTCF_ValidOvfl)
246d0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 ;.}../*.** Move
246e0 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f the cursor to po
246f0 69 6e 74 20 74 6f 20 74 68 65 20 72 6f 6f 74 20 int to the root
24700 70 61 67 65 20 6f 66 20 69 74 73 20 62 2d 74 72 page of its b-tr
24710 65 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a ee structure..**
24720 0a 2a 2a 20 49 66 20 74 68 65 20 74 61 62 6c 65 .** If the table
24730 20 68 61 73 20 61 20 76 69 72 74 75 61 6c 20 72 has a virtual r
24740 6f 6f 74 20 70 61 67 65 2c 20 74 68 65 6e 20 74 oot page, then t
24750 68 65 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 he cursor is mov
24760 65 64 20 74 6f 20 70 6f 69 6e 74 0a 2a 2a 20 74 ed to point.** t
24770 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 72 6f o the virtual ro
24780 6f 74 20 70 61 67 65 20 69 6e 73 74 65 61 64 20 ot page instead
24790 6f 66 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f of the actual ro
247a0 6f 74 20 70 61 67 65 2e 20 41 20 74 61 62 6c 65 ot page. A table
247b0 20 68 61 73 20 61 0a 2a 2a 20 76 69 72 74 75 61 has a.** virtua
247c0 6c 20 72 6f 6f 74 20 70 61 67 65 20 77 68 65 6e l root page when
247d0 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 the actual root
247e0 20 70 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 6e page contains n
247f0 6f 20 63 65 6c 6c 73 20 61 6e 64 20 61 20 0a 2a o cells and a .*
24800 2a 20 73 69 6e 67 6c 65 20 63 68 69 6c 64 20 70 * single child p
24810 61 67 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e age. This can on
24820 6c 79 20 68 61 70 70 65 6e 20 77 69 74 68 20 74 ly happen with t
24830 68 65 20 74 61 62 6c 65 20 72 6f 6f 74 65 64 20 he table rooted
24840 61 74 20 70 61 67 65 20 31 2e 0a 2a 2a 0a 2a 2a at page 1..**.**
24850 20 49 66 20 74 68 65 20 62 2d 74 72 65 65 20 73 If the b-tree s
24860 74 72 75 63 74 75 72 65 20 69 73 20 65 6d 70 74 tructure is empt
24870 79 2c 20 74 68 65 20 63 75 72 73 6f 72 20 73 74 y, the cursor st
24880 61 74 65 20 69 73 20 73 65 74 20 74 6f 20 0a 2a ate is set to .*
24890 2a 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 * CURSOR_INVALID
248a0 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 . Otherwise, the
248b0 20 63 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 cursor is set t
248c0 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 o point to the f
248d0 69 72 73 74 0a 2a 2a 20 63 65 6c 6c 20 6c 6f 63 irst.** cell loc
248e0 61 74 65 64 20 6f 6e 20 74 68 65 20 72 6f 6f 74 ated on the root
248f0 20 28 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f (or virtual roo
24900 74 29 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 t) page and the
24910 63 75 72 73 6f 72 20 73 74 61 74 65 0a 2a 2a 20 cursor state.**
24920 69 73 20 73 65 74 20 74 6f 20 43 55 52 53 4f 52 is set to CURSOR
24930 5f 56 41 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 _VALID..**.** If
24940 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
24950 65 74 75 72 6e 73 20 73 75 63 63 65 73 73 66 75 eturns successfu
24960 6c 6c 79 2c 20 69 74 20 6d 61 79 20 62 65 20 61 lly, it may be a
24970 73 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 0a ssumed that the.
24980 2a 2a 20 70 61 67 65 2d 68 65 61 64 65 72 20 66 ** page-header f
24990 6c 61 67 73 20 69 6e 64 69 63 61 74 65 20 74 68 lags indicate th
249a0 61 74 20 74 68 65 20 5b 76 69 72 74 75 61 6c 5d at the [virtual]
249b0 20 72 6f 6f 74 2d 70 61 67 65 20 69 73 20 74 68 root-page is th
249c0 65 20 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 6b e expected .** k
249d0 69 6e 64 20 6f 66 20 62 2d 74 72 65 65 20 70 61 ind of b-tree pa
249e0 67 65 20 28 69 2e 65 2e 20 69 66 20 77 68 65 6e ge (i.e. if when
249f0 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 63 75 72 opening the cur
24a00 73 6f 72 20 74 68 65 20 63 61 6c 6c 65 72 20 64 sor the caller d
24a10 69 64 20 6e 6f 74 0a 2a 2a 20 73 70 65 63 69 66 id not.** specif
24a20 79 20 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 y a KeyInfo stru
24a30 63 74 75 72 65 20 74 68 65 20 66 6c 61 67 73 20 cture the flags
24a40 62 79 74 65 20 69 73 20 73 65 74 20 74 6f 20 30 byte is set to 0
24a50 78 30 35 20 6f 72 20 30 78 30 44 2c 0a 2a 2a 20 x05 or 0x0D,.**
24a60 69 6e 64 69 63 61 74 69 6e 67 20 61 20 74 61 62 indicating a tab
24a70 6c 65 20 62 2d 74 72 65 65 2c 20 6f 72 20 69 66 le b-tree, or if
24a80 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 the caller did
24a90 73 70 65 63 69 66 79 20 61 20 4b 65 79 49 6e 66 specify a KeyInf
24aa0 6f 20 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 o .** structure
24ab0 74 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 69 the flags byte i
24ac0 73 20 73 65 74 20 74 6f 20 30 78 30 32 20 6f 72 s set to 0x02 or
24ad0 20 30 78 30 41 2c 20 69 6e 64 69 63 61 74 69 6e 0x0A, indicatin
24ae0 67 20 61 6e 20 69 6e 64 65 78 0a 2a 2a 20 62 2d g an index.** b-
24af0 74 72 65 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 tree)..*/.static
24b00 20 69 6e 74 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 int moveToRoot(
24b10 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
24b20 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 52 6f 6f . MemPage *pRoo
24b30 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 t;. int rc = SQ
24b40 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 LITE_OK;.. asse
24b50 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
24b60 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
24b70 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 49 assert( CURSOR_I
24b80 4e 56 41 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f NVALID < CURSOR_
24b90 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 REQUIRESEEK );.
24ba0 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f assert( CURSOR_
24bb0 56 41 4c 49 44 20 20 20 3c 20 43 55 52 53 4f 52 VALID < CURSOR
24bc0 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a _REQUIRESEEK );.
24bd0 20 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 assert( CURSOR
24be0 5f 46 41 55 4c 54 20 20 20 3e 20 43 55 52 53 4f _FAULT > CURSO
24bf0 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b R_REQUIRESEEK );
24c00 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
24c10 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 ate>=CURSOR_REQU
24c20 49 52 45 53 45 45 4b 20 29 7b 0a 20 20 20 20 69 IRESEEK ){. i
24c30 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d f( pCur->eState=
24c40 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b =CURSOR_FAULT ){
24c50 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
24c60 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 Cur->skipNext!=S
24c70 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 QLITE_OK );.
24c80 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 return pCur->s
24c90 6b 69 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 kipNext;. }.
24ca0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
24cb0 6c 65 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 learCursor(pCur)
24cc0 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 75 ;. }.. if( pCu
24cd0 72 2d 3e 69 50 61 67 65 3e 3d 30 20 29 7b 0a 20 r->iPage>=0 ){.
24ce0 20 20 20 77 68 69 6c 65 28 20 70 43 75 72 2d 3e while( pCur->
24cf0 69 50 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 iPage ) releaseP
24d00 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 67 65 age(pCur->apPage
24d10 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 5d 29 [pCur->iPage--])
24d20 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 ;. }else if( pC
24d30 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
24d40 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
24d50 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
24d60 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 75 72 6e ALID;. return
24d70 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
24d80 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 67 65 lse{. rc = ge
24d90 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 43 75 tAndInitPage(pCu
24da0 72 2d 3e 70 42 74 72 65 65 2d 3e 70 42 74 2c 20 r->pBtree->pBt,
24db0 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 2c 20 pCur->pgnoRoot,
24dc0 26 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d &pCur->apPage[0]
24dd0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
24de0 20 20 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 (pCur->curFla
24df0 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
24e00 6c 61 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f lag)==0 ? PAGER_
24e10 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 GET_READONLY : 0
24e20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
24e30 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
24e40 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
24e50 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
24e60 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
24e70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 ;. }. pCur
24e80 2d 3e 69 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d ->iPage = 0;. }
24e90 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d . pRoot = pCur-
24ea0 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 20 61 73 >apPage[0];. as
24eb0 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 70 67 6e sert( pRoot->pgn
24ec0 6f 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f o==pCur->pgnoRoo
24ed0 74 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 43 t );.. /* If pC
24ee0 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 69 73 20 ur->pKeyInfo is
24ef0 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 not NULL, then t
24f00 68 65 20 63 61 6c 6c 65 72 20 74 68 61 74 20 6f he caller that o
24f10 70 65 6e 65 64 20 74 68 69 73 20 63 75 72 73 6f pened this curso
24f20 72 0a 20 20 2a 2a 20 65 78 70 65 63 74 65 64 20 r. ** expected
24f30 74 6f 20 6f 70 65 6e 20 69 74 20 6f 6e 20 61 6e to open it on an
24f40 20 69 6e 64 65 78 20 62 2d 74 72 65 65 2e 20 4f index b-tree. O
24f50 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 4b 65 therwise, if pKe
24f60 79 49 6e 66 6f 20 69 73 0a 20 20 2a 2a 20 4e 55 yInfo is. ** NU
24f70 4c 4c 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 65 LL, the caller e
24f80 78 70 65 63 74 73 20 61 20 74 61 62 6c 65 20 62 xpects a table b
24f90 2d 74 72 65 65 2e 20 49 66 20 74 68 69 73 20 69 -tree. If this i
24fa0 73 20 6e 6f 74 20 74 68 65 20 63 61 73 65 2c 0a s not the case,.
24fb0 20 20 2a 2a 20 72 65 74 75 72 6e 20 61 6e 20 53 ** return an S
24fc0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 65 72 QLITE_CORRUPT er
24fd0 72 6f 72 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ror. . **. **
24fe0 45 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 Earlier versions
24ff0 20 6f 66 20 53 51 4c 69 74 65 20 61 73 73 75 6d of SQLite assum
25000 65 64 20 74 68 61 74 20 74 68 69 73 20 74 65 73 ed that this tes
25010 74 20 63 6f 75 6c 64 20 6e 6f 74 20 66 61 69 6c t could not fail
25020 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 72 6f 6f . ** if the roo
25030 74 20 70 61 67 65 20 77 61 73 20 61 6c 72 65 61 t page was alrea
25040 64 79 20 6c 6f 61 64 65 64 20 77 68 65 6e 20 74 dy loaded when t
25050 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 his function was
25060 20 63 61 6c 6c 65 64 20 28 69 2e 65 2e 0a 20 20 called (i.e..
25070 2a 2a 20 69 66 20 70 43 75 72 2d 3e 69 50 61 67 ** if pCur->iPag
25080 65 3e 3d 30 29 2e 20 42 75 74 20 74 68 69 73 20 e>=0). But this
25090 69 73 20 6e 6f 74 20 73 6f 20 69 66 20 74 68 65 is not so if the
250a0 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 database is cor
250b0 72 75 70 74 65 64 20 0a 20 20 2a 2a 20 69 6e 20 rupted . ** in
250c0 73 75 63 68 20 61 20 77 61 79 20 74 68 61 74 20 such a way that
250d0 70 61 67 65 20 70 52 6f 6f 74 20 69 73 20 6c 69 page pRoot is li
250e0 6e 6b 65 64 20 69 6e 74 6f 20 61 20 73 65 63 6f nked into a seco
250f0 6e 64 20 62 2d 74 72 65 65 20 74 61 62 6c 65 20 nd b-tree table
25100 0a 20 20 2a 2a 20 28 6f 72 20 74 68 65 20 66 72 . ** (or the fr
25110 65 65 6c 69 73 74 29 2e 20 20 2a 2f 0a 20 20 61 eelist). */. a
25120 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 69 6e ssert( pRoot->in
25130 74 4b 65 79 3d 3d 31 20 7c 7c 20 70 52 6f 6f 74 tKey==1 || pRoot
25140 2d 3e 69 6e 74 4b 65 79 3d 3d 30 20 29 3b 0a 20 ->intKey==0 );.
25150 20 69 66 28 20 70 52 6f 6f 74 2d 3e 69 73 49 6e if( pRoot->isIn
25160 69 74 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e it==0 || (pCur->
25170 70 4b 65 79 49 6e 66 6f 3d 3d 30 29 21 3d 70 52 pKeyInfo==0)!=pR
25180 6f 6f 74 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 oot->intKey ){.
25190 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
251a0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
251b0 20 7d 0a 0a 20 20 70 43 75 72 2d 3e 61 69 49 64 }.. pCur->aiId
251c0 78 5b 30 5d 20 3d 20 30 3b 0a 20 20 70 43 75 72 x[0] = 0;. pCur
251d0 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
251e0 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 ;. pCur->curFla
251f0 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c gs &= ~(BTCF_AtL
25200 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b ast|BTCF_ValidNK
25210 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 ey|BTCF_ValidOvf
25220 6c 29 3b 0a 0a 20 20 69 66 28 20 70 52 6f 6f 74 l);.. if( pRoot
25230 2d 3e 6e 43 65 6c 6c 3e 30 20 29 7b 0a 20 20 20 ->nCell>0 ){.
25240 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
25250 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 CURSOR_VALID;.
25260 7d 65 6c 73 65 20 69 66 28 20 21 70 52 6f 6f 74 }else if( !pRoot
25270 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 ->leaf ){. Pg
25280 6e 6f 20 73 75 62 70 61 67 65 3b 0a 20 20 20 20 no subpage;.
25290 69 66 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 21 if( pRoot->pgno!
252a0 3d 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =1 ) return SQLI
252b0 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
252c0 0a 20 20 20 20 73 75 62 70 61 67 65 20 3d 20 67 . subpage = g
252d0 65 74 34 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e et4byte(&pRoot->
252e0 61 44 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 aData[pRoot->hdr
252f0 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 Offset+8]);.
25300 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
25310 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 URSOR_VALID;.
25320 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
25330 64 28 70 43 75 72 2c 20 73 75 62 70 61 67 65 29 d(pCur, subpage)
25340 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
25350 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
25360 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
25370 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
25380 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
25390 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 cursor down to
253a0 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 the left-most le
253b0 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
253c0 20 74 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f the.** entry to
253d0 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 which it is cur
253e0 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e rently pointing.
253f0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d .**.** The left-
25400 6d 6f 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 most leaf is the
25410 20 6f 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d one with the sm
25420 61 6c 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 allest key - the
25430 20 66 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 first.** in asc
25440 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f ending order..*/
25450 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 .static int move
25460 54 6f 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 ToLeftmost(BtCur
25470 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 sor *pCur){. Pg
25480 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 no pgno;. int r
25490 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
254a0 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
254b0 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
254c0 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
254d0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
254e0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
254f0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
25500 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 while( rc==SQLIT
25510 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 E_OK && !(pPage
25520 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
25530 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 Cur->iPage])->le
25540 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 af ){. assert
25550 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
25560 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 ur->iPage]<pPage
25570 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 70 ->nCell );. p
25580 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 66 gno = get4byte(f
25590 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 indCell(pPage, p
255a0 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
255b0 3e 69 50 61 67 65 5d 29 29 3b 0a 20 20 20 20 72 >iPage]));. r
255c0 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
255d0 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d pCur, pgno);. }
255e0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
255f0 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
25600 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 cursor down to t
25610 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 he right-most le
25620 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
25630 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 the.** page to
25640 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 which it is curr
25650 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 20 ently pointing.
25660 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 66 66 Notice the diff
25670 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 65 erence.** betwee
25680 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
25690 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 67 () and moveToRig
256a0 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 54 htmost(). moveT
256b0 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 oLeftmost().** f
256c0 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d 6d 6f inds the left-mo
256d0 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 st entry beneath
256e0 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 65 the *entry* whe
256f0 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 74 reas moveToRight
25700 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 most().** finds
25710 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 the right-most e
25720 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 ntry beneath the
25730 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 *page*..**.** T
25740 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e he right-most en
25750 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 20 77 try is the one w
25760 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 74 20 ith the largest
25770 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 0a 2a key - the last.*
25780 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 69 * key in ascendi
25790 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ng order..*/.sta
257a0 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 69 tic int moveToRi
257b0 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 ghtmost(BtCursor
257c0 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 *pCur){. Pgno
257d0 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d pgno;. int rc =
257e0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 SQLITE_OK;. Me
257f0 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 mPage *pPage = 0
25800 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
25810 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
25820 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
25830 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
25840 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
25850 20 77 68 69 6c 65 28 20 21 28 70 50 61 67 65 20 while( !(pPage
25860 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
25870 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 Cur->iPage])->le
25880 61 66 20 29 7b 0a 20 20 20 20 70 67 6e 6f 20 3d af ){. pgno =
25890 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
258a0 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 ->aData[pPage->h
258b0 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 drOffset+8]);.
258c0 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
258d0 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 ur->iPage] = pPa
258e0 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 72 ge->nCell;. r
258f0 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
25900 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 pCur, pgno);.
25910 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
25920 20 72 63 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d rc;. }. pCur-
25930 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
25940 67 65 5d 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 ge] = pPage->nCe
25950 6c 6c 2d 31 3b 0a 20 20 61 73 73 65 72 74 28 20 ll-1;. assert(
25960 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
25970 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
25980 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
25990 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 & BTCF_ValidNKe
259a0 79 29 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 y)==0 );. retur
259b0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
259c0 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 /* Move the curs
259d0 6f 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 or to the first
259e0 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 62 entry in the tab
259f0 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 le. Return SQLI
25a00 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 TE_OK.** on succ
25a10 65 73 73 2e 20 20 53 65 74 20 2a 70 52 65 73 20 ess. Set *pRes
25a20 74 6f 20 30 20 69 66 20 74 68 65 20 63 75 72 73 to 0 if the curs
25a30 6f 72 20 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e or actually poin
25a40 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a ts to something.
25a50 2a 2a 20 6f 72 20 73 65 74 20 2a 70 52 65 73 20 ** or set *pRes
25a60 74 6f 20 31 20 69 66 20 74 68 65 20 74 61 62 6c to 1 if the tabl
25a70 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 e is empty..*/.i
25a80 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 nt sqlite3BtreeF
25a90 69 72 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 irst(BtCursor *p
25aa0 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b Cur, int *pRes){
25ab0 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
25ac0 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
25ad0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
25ae0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
25af0 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 3_mutex_held(pCu
25b00 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d r->pBtree->db->m
25b10 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 utex) );. rc =
25b20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 moveToRoot(pCur)
25b30 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
25b40 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 TE_OK ){. if(
25b50 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
25b60 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b URSOR_INVALID ){
25b70 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
25b80 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 Cur->pgnoRoot==0
25b90 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 || pCur->apPage
25ba0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
25bb0 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 Cell==0 );.
25bc0 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 *pRes = 1;.
25bd0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 }else{. ass
25be0 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 ert( pCur->apPag
25bf0 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e e[pCur->iPage]->
25c00 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 20 nCell>0 );.
25c10 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
25c20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 rc = moveToLef
25c30 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 tmost(pCur);.
25c40 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
25c50 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 rc;.}../* Move t
25c60 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 he cursor to the
25c70 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 last entry in t
25c80 68 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 he table. Retur
25c90 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f n SQLITE_OK.** o
25ca0 6e 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 n success. Set
25cb0 2a 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 *pRes to 0 if th
25cc0 65 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c e cursor actuall
25cd0 79 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 y points to some
25ce0 74 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 thing.** or set
25cf0 2a 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 *pRes to 1 if th
25d00 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 e table is empty
25d10 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
25d20 42 74 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 BtreeLast(BtCurs
25d30 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
25d40 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Res){. int rc;.
25d50 20 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 . assert( curs
25d60 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
25d70 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
25d80 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
25d90 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d ld(pCur->pBtree-
25da0 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a >db->mutex) );..
25db0 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 /* If the curs
25dc0 6f 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 or already point
25dd0 73 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e s to the last en
25de0 74 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e try, this is a n
25df0 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 o-op. */. if( C
25e00 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 URSOR_VALID==pCu
25e10 72 2d 3e 65 53 74 61 74 65 20 26 26 20 28 70 43 r->eState && (pC
25e20 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
25e30 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 TCF_AtLast)!=0 )
25e40 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
25e50 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 DEBUG. /* Thi
25e60 73 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 s block serves t
25e70 6f 20 61 73 73 65 72 74 28 29 20 74 68 61 74 20 o assert() that
25e80 74 68 65 20 63 75 72 73 6f 72 20 72 65 61 6c 6c the cursor reall
25e90 79 20 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 y does point .
25ea0 20 20 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 ** to the last
25eb0 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 62 2d entry in the b-
25ec0 74 72 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 tree. */. int
25ed0 20 69 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d ii;. for(ii=
25ee0 30 3b 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 0; ii<pCur->iPag
25ef0 65 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 e; ii++){.
25f00 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
25f10 49 64 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 Idx[ii]==pCur->a
25f20 70 50 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c pPage[ii]->nCell
25f30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 );. }. as
25f40 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 sert( pCur->aiId
25f50 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d x[pCur->iPage]==
25f60 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
25f70 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
25f80 2d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 -1 );. assert
25f90 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 ( pCur->apPage[p
25fa0 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 Cur->iPage]->lea
25fb0 66 20 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 f );.#endif.
25fc0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
25fd0 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d 6f ;. }.. rc = mo
25fe0 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a veToRoot(pCur);.
25ff0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
26000 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 43 _OK ){. if( C
26010 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 URSOR_INVALID==p
26020 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 Cur->eState ){.
26030 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
26040 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c r->pgnoRoot==0 |
26050 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 | pCur->apPage[p
26060 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 Cur->iPage]->nCe
26070 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a ll==0 );. *
26080 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d 65 pRes = 1;. }e
26090 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
260a0 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
260b0 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
260c0 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 . *pRes = 0
260d0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 ;. rc = mov
260e0 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 eToRightmost(pCu
260f0 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 r);. if( rc
26100 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
26110 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 pCur->cur
26120 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 41 74 Flags |= BTCF_At
26130 4c 61 73 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 Last;. }els
26140 65 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d e{. pCur-
26150 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 >curFlags &= ~BT
26160 43 46 5f 41 74 4c 61 73 74 3b 0a 20 20 20 20 20 CF_AtLast;.
26170 20 7d 0a 20 20 20 0a 20 20 20 20 7d 0a 20 20 7d }. . }. }
26180 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
26190 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 ./* Move the cur
261a0 73 6f 72 20 73 6f 20 74 68 61 74 20 69 74 20 70 sor so that it p
261b0 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 6e 74 72 oints to an entr
261c0 79 20 6e 65 61 72 20 74 68 65 20 6b 65 79 20 0a y near the key .
261d0 2a 2a 20 73 70 65 63 69 66 69 65 64 20 62 79 20 ** specified by
261e0 70 49 64 78 4b 65 79 20 6f 72 20 69 6e 74 4b 65 pIdxKey or intKe
261f0 79 2e 20 20 20 52 65 74 75 72 6e 20 61 20 73 75 y. Return a su
26200 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a 2a 0a 2a ccess code..**.*
26210 2a 20 46 6f 72 20 49 4e 54 4b 45 59 20 74 61 62 * For INTKEY tab
26220 6c 65 73 2c 20 74 68 65 20 69 6e 74 4b 65 79 20 les, the intKey
26230 70 61 72 61 6d 65 74 65 72 20 69 73 20 75 73 65 parameter is use
26240 64 2e 20 20 70 49 64 78 4b 65 79 20 0a 2a 2a 20 d. pIdxKey .**
26250 6d 75 73 74 20 62 65 20 4e 55 4c 4c 2e 20 20 46 must be NULL. F
26260 6f 72 20 69 6e 64 65 78 20 74 61 62 6c 65 73 2c or index tables,
26270 20 70 49 64 78 4b 65 79 20 69 73 20 75 73 65 64 pIdxKey is used
26280 20 61 6e 64 20 69 6e 74 4b 65 79 0a 2a 2a 20 69 and intKey.** i
26290 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a 0a 2a 2a s ignored..**.**
262a0 20 49 66 20 61 6e 20 65 78 61 63 74 20 6d 61 74 If an exact mat
262b0 63 68 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c ch is not found,
262c0 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
262d0 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 6c 65 is always.** le
262e0 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ft pointing at a
262f0 20 6c 65 61 66 20 70 61 67 65 20 77 68 69 63 68 leaf page which
26300 20 77 6f 75 6c 64 20 68 6f 6c 64 20 74 68 65 20 would hold the
26310 65 6e 74 72 79 20 69 66 20 69 74 0a 2a 2a 20 77 entry if it.** w
26320 65 72 65 20 70 72 65 73 65 6e 74 2e 20 20 54 68 ere present. Th
26330 65 20 63 75 72 73 6f 72 20 6d 69 67 68 74 20 70 e cursor might p
26340 6f 69 6e 74 20 74 6f 20 61 6e 20 65 6e 74 72 79 oint to an entry
26350 20 74 68 61 74 20 63 6f 6d 65 73 0a 2a 2a 20 62 that comes.** b
26360 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 20 74 efore or after t
26370 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 6e he key..**.** An
26380 20 69 6e 74 65 67 65 72 20 69 73 20 77 72 69 74 integer is writ
26390 74 65 6e 20 69 6e 74 6f 20 2a 70 52 65 73 20 77 ten into *pRes w
263a0 68 69 63 68 20 69 73 20 74 68 65 20 72 65 73 75 hich is the resu
263b0 6c 74 20 6f 66 0a 2a 2a 20 63 6f 6d 70 61 72 69 lt of.** compari
263c0 6e 67 20 74 68 65 20 6b 65 79 20 77 69 74 68 20 ng the key with
263d0 74 68 65 20 65 6e 74 72 79 20 74 6f 20 77 68 69 the entry to whi
263e0 63 68 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 ch the cursor is
263f0 20 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 20 .** pointing.
26400 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 The meaning of t
26410 68 65 20 69 6e 74 65 67 65 72 20 77 72 69 74 74 he integer writt
26420 65 6e 20 69 6e 74 6f 0a 2a 2a 20 2a 70 52 65 73 en into.** *pRes
26430 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a is as follows:.
26440 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3c **.** *pRes<
26450 30 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 0 The curso
26460 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
26470 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
26480 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
26490 20 20 20 20 20 20 20 20 69 73 20 73 6d 61 6c 6c is small
264a0 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 er than intKey/p
264b0 49 64 78 4b 65 79 20 6f 72 20 69 66 20 74 68 65 IdxKey or if the
264c0 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 0a table is empty.
264d0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
264e0 20 20 20 20 61 6e 64 20 74 68 65 20 63 75 72 73 and the curs
264f0 6f 72 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 or is therefore
26500 6c 65 66 74 20 70 6f 69 6e 74 20 74 6f 20 6e 6f left point to no
26510 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 thing..**.**
26520 20 2a 70 52 65 73 3d 3d 30 20 20 20 20 20 54 68 *pRes==0 Th
26530 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
26540 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 pointing at an
26550 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 entry that.**
26560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 e
26570 78 61 63 74 6c 79 20 6d 61 74 63 68 65 73 20 69 xactly matches i
26580 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a ntKey/pIdxKey..*
26590 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3e 30 *.** *pRes>0
265a0 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 The cursor
265b0 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e is left pointin
265c0 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 g at an entry th
265d0 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 at.**
265e0 20 20 20 20 20 20 20 69 73 20 6c 61 72 67 65 72 is larger
265f0 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 64 than intKey/pId
26600 78 4b 65 79 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 xKey..**.*/.int
26610 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 sqlite3BtreeMove
26620 74 6f 55 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 toUnpacked(. Bt
26630 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 Cursor *pCur,
26640 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 /* The cu
26650 72 73 6f 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 rsor to be moved
26660 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 */. UnpackedRe
26670 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f cord *pIdxKey, /
26680 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 * Unpacked index
26690 20 6b 65 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e key */. i64 in
266a0 74 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 tKey,
266b0 20 20 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 /* The table
266c0 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 key */. int bia
266d0 73 52 69 67 68 74 2c 20 20 20 20 20 20 20 20 20 sRight,
266e0 20 20 2f 2a 20 49 66 20 74 72 75 65 2c 20 62 69 /* If true, bi
266f0 61 73 20 74 68 65 20 73 65 61 72 63 68 20 74 6f as the search to
26700 20 74 68 65 20 68 69 67 68 20 65 6e 64 20 2a 2f the high end */
26710 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 20 20 20 . int *pRes
26720 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
26730 72 69 74 65 20 73 65 61 72 63 68 20 72 65 73 75 rite search resu
26740 6c 74 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 lts here */.){.
26750 20 69 6e 74 20 72 63 3b 0a 20 20 52 65 63 6f 72 int rc;. Recor
26760 64 43 6f 6d 70 61 72 65 20 78 52 65 63 6f 72 64 dCompare xRecord
26770 43 6f 6d 70 61 72 65 3b 0a 0a 20 20 61 73 73 65 Compare;.. asse
26780 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
26790 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
267a0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
267b0 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
267c0 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
267d0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
267e0 20 70 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 pRes );. asser
267f0 74 28 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d t( (pIdxKey==0)=
26800 3d 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f =(pCur->pKeyInfo
26810 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 ==0) );.. /* If
26820 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 the cursor is a
26830 6c 72 65 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 lready positione
26840 64 20 61 74 20 74 68 65 20 70 6f 69 6e 74 20 77 d at the point w
26850 65 20 61 72 65 20 74 72 79 69 6e 67 0a 20 20 2a e are trying. *
26860 2a 20 74 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 * to move to, th
26870 65 6e 20 6a 75 73 74 20 72 65 74 75 72 6e 20 77 en just return w
26880 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 ithout doing any
26890 20 77 6f 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 work */. if( p
268a0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
268b0 53 4f 52 5f 56 41 4c 49 44 20 26 26 20 28 70 43 SOR_VALID && (pC
268c0 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
268d0 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d TCF_ValidNKey)!=
268e0 30 0a 20 20 20 26 26 20 70 43 75 72 2d 3e 61 70 0. && pCur->ap
268f0 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 Page[0]->intKey
26900 0a 20 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 . ){. if( pC
26910 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 ur->info.nKey==i
26920 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a ntKey ){. *
26930 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 pRes = 0;.
26940 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
26950 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
26960 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
26970 26 20 42 54 43 46 5f 41 74 4c 61 73 74 29 21 3d & BTCF_AtLast)!=
26980 30 20 26 26 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 0 && pCur->info.
26990 6e 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 nKey<intKey ){.
269a0 20 20 20 20 20 2a 70 52 65 73 20 3d 20 2d 31 3b *pRes = -1;
269b0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
269c0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
269d0 20 7d 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 }.. if( pIdxKe
269e0 79 20 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 y ){. xRecord
269f0 43 6f 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 Compare = sqlite
26a00 33 56 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 3VdbeFindCompare
26a10 28 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 (pIdxKey);. p
26a20 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 IdxKey->errCode
26a30 3d 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 = 0;. assert(
26a40 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c pIdxKey->defaul
26a50 74 5f 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 t_rc==1 .
26a60 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 || pIdxKey->de
26a70 66 61 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 fault_rc==0 .
26a80 20 20 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 || pIdxKey
26a90 2d 3e 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 ->default_rc==-1
26aa0 0a 20 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b . );. }else{
26ab0 0a 20 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 . xRecordComp
26ac0 61 72 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 are = 0; /* All
26ad0 6b 65 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 keys are integer
26ae0 73 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d s */. }.. rc =
26af0 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 moveToRoot(pCur
26b00 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 );. if( rc ){.
26b10 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
26b20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 }. assert( pCur
26b30 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c ->pgnoRoot==0 ||
26b40 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
26b50 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 ur->iPage] );.
26b60 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 assert( pCur->pg
26b70 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 noRoot==0 || pCu
26b80 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
26b90 69 50 61 67 65 5d 2d 3e 69 73 49 6e 69 74 20 29 iPage]->isInit )
26ba0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
26bb0 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
26bc0 5f 49 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 _INVALID || pCur
26bd0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
26be0 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 Page]->nCell>0 )
26bf0 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
26c00 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 tate==CURSOR_INV
26c10 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a 70 52 65 ALID ){. *pRe
26c20 73 20 3d 20 2d 31 3b 0a 20 20 20 20 61 73 73 65 s = -1;. asse
26c30 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f rt( pCur->pgnoRo
26c40 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 ot==0 || pCur->a
26c50 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
26c60 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a e]->nCell==0 );.
26c70 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
26c80 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 65 E_OK;. }. asse
26c90 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 rt( pCur->apPage
26ca0 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 70 [0]->intKey || p
26cb0 49 64 78 4b 65 79 20 29 3b 0a 20 20 66 6f 72 28 IdxKey );. for(
26cc0 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 77 72 ;;){. int lwr
26cd0 2c 20 75 70 72 2c 20 69 64 78 2c 20 63 3b 0a 20 , upr, idx, c;.
26ce0 20 20 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b 0a Pgno chldPg;.
26cf0 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 MemPage *pPa
26d00 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
26d10 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
26d20 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 3b 20 20 u8 *pCell;
26d30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26d40 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
26d50 65 72 20 74 6f 20 63 75 72 72 65 6e 74 20 63 65 er to current ce
26d60 6c 6c 20 69 6e 20 70 50 61 67 65 20 2a 2f 0a 0a ll in pPage */..
26d70 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e 6e 43 /* pPage->nC
26d80 65 6c 6c 20 6d 75 73 74 20 62 65 20 67 72 65 61 ell must be grea
26d90 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e 20 49 ter than zero. I
26da0 66 20 74 68 69 73 20 69 73 20 74 68 65 20 72 6f f this is the ro
26db0 6f 74 2d 70 61 67 65 0a 20 20 20 20 2a 2a 20 74 ot-page. ** t
26dc0 68 65 20 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 he cursor would
26dd0 68 61 76 65 20 62 65 65 6e 20 49 4e 56 41 4c 49 have been INVALI
26de0 44 20 61 62 6f 76 65 20 61 6e 64 20 74 68 69 73 D above and this
26df0 20 66 6f 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 20 for(;;) loop.
26e00 20 20 2a 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 66 ** not run. If
26e10 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 65 this is not the
26e20 20 72 6f 6f 74 2d 70 61 67 65 2c 20 74 68 65 6e root-page, then
26e30 20 74 68 65 20 6d 6f 76 65 54 6f 43 68 69 6c 64 the moveToChild
26e40 28 29 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a () routine. *
26e50 2a 20 77 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 * would have alr
26e60 65 61 64 79 20 64 65 74 65 63 74 65 64 20 64 62 eady detected db
26e70 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 53 69 6d corruption. Sim
26e80 69 6c 61 72 6c 79 2c 20 70 50 61 67 65 20 6d 75 ilarly, pPage mu
26e90 73 74 0a 20 20 20 20 2a 2a 20 62 65 20 74 68 65 st. ** be the
26ea0 20 72 69 67 68 74 20 6b 69 6e 64 20 28 69 6e 64 right kind (ind
26eb0 65 78 20 6f 72 20 74 61 62 6c 65 29 20 6f 66 20 ex or table) of
26ec0 62 2d 74 72 65 65 20 70 61 67 65 2e 20 4f 74 68 b-tree page. Oth
26ed0 65 72 77 69 73 65 0a 20 20 20 20 2a 2a 20 61 20 erwise. ** a
26ee0 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 6f 72 moveToChild() or
26ef0 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 29 20 63 61 moveToRoot() ca
26f00 6c 6c 20 77 6f 75 6c 64 20 68 61 76 65 20 64 65 ll would have de
26f10 74 65 63 74 65 64 20 63 6f 72 72 75 70 74 69 6f tected corruptio
26f20 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 n. */. asser
26f30 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e t( pPage->nCell>
26f40 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
26f50 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d pPage->intKey==
26f60 28 70 49 64 78 4b 65 79 3d 3d 30 29 20 29 3b 0a (pIdxKey==0) );.
26f70 20 20 20 20 6c 77 72 20 3d 20 30 3b 0a 20 20 20 lwr = 0;.
26f80 20 75 70 72 20 3d 20 70 50 61 67 65 2d 3e 6e 43 upr = pPage->nC
26f90 65 6c 6c 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 ell-1;. asser
26fa0 74 28 20 62 69 61 73 52 69 67 68 74 3d 3d 30 20 t( biasRight==0
26fb0 7c 7c 20 62 69 61 73 52 69 67 68 74 3d 3d 31 20 || biasRight==1
26fc0 29 3b 0a 20 20 20 20 69 64 78 20 3d 20 75 70 72 );. idx = upr
26fd0 3e 3e 28 31 2d 62 69 61 73 52 69 67 68 74 29 3b >>(1-biasRight);
26fe0 20 2f 2a 20 69 64 78 20 3d 20 62 69 61 73 52 69 /* idx = biasRi
26ff0 67 68 74 20 3f 20 75 70 72 20 3a 20 28 6c 77 72 ght ? upr : (lwr
27000 2b 75 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 +upr)/2; */.
27010 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
27020 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 ->iPage] = (u16)
27030 69 64 78 3b 0a 20 20 20 20 69 66 28 20 78 52 65 idx;. if( xRe
27040 63 6f 72 64 43 6f 6d 70 61 72 65 3d 3d 30 20 29 cordCompare==0 )
27050 7b 0a 20 20 20 20 20 20 66 6f 72 28 3b 3b 29 7b {. for(;;){
27060 0a 20 20 20 20 20 20 20 20 69 36 34 20 6e 43 65 . i64 nCe
27070 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 70 llKey;. p
27080 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 Cell = findCell(
27090 70 50 61 67 65 2c 20 69 64 78 29 20 2b 20 70 50 pPage, idx) + pP
270a0 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
270b0 65 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 e;. if( p
270c0 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 Page->intKeyLeaf
270d0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 ){. wh
270e0 69 6c 65 28 20 30 78 38 30 20 3c 3d 20 2a 28 70 ile( 0x80 <= *(p
270f0 43 65 6c 6c 2b 2b 29 20 29 7b 0a 20 20 20 20 20 Cell++) ){.
27100 20 20 20 20 20 20 20 69 66 28 20 70 43 65 6c 6c if( pCell
27110 3e 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e >=pPage->aDataEn
27120 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 d ) return SQLIT
27130 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
27140 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
27150 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 67 65 }. ge
27160 74 56 61 72 69 6e 74 28 70 43 65 6c 6c 2c 20 28 tVarint(pCell, (
27170 75 36 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 29 3b u64*)&nCellKey);
27180 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 . if( nCe
27190 6c 6c 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a llKey<intKey ){.
271a0 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 3d 20 lwr =
271b0 69 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 20 idx+1;.
271c0 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 7b 20 if( lwr>upr ){
271d0 63 20 3d 20 2d 31 3b 20 62 72 65 61 6b 3b 20 7d c = -1; break; }
271e0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
271f0 66 28 20 6e 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b f( nCellKey>intK
27200 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ey ){.
27210 75 70 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 20 upr = idx-1;.
27220 20 20 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 if( lwr>u
27230 70 72 20 29 7b 20 63 20 3d 20 2b 31 3b 20 62 72 pr ){ c = +1; br
27240 65 61 6b 3b 20 7d 0a 20 20 20 20 20 20 20 20 7d eak; }. }
27250 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
27260 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 4b 65 79 assert( nCellKey
27270 3d 3d 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 ==intKey );.
27280 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 pCur->curF
27290 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c lags |= BTCF_Val
272a0 69 64 4e 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 idNKey;.
272b0 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 pCur->info.nKe
272c0 79 20 3d 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 y = nCellKey;.
272d0 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 69 pCur->ai
272e0 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
272f0 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 = (u16)idx;.
27300 20 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 if( !pPag
27310 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
27320 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 lwr = idx
27330 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f ;. go
27340 74 6f 20 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c to moveto_next_l
27350 61 79 65 72 3b 0a 20 20 20 20 20 20 20 20 20 20 ayer;.
27360 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
27370 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
27380 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
27390 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
273a0 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
273b0 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 o_finish;.
273c0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
273d0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
273e0 6c 77 72 2b 75 70 72 3e 3d 30 20 29 3b 0a 20 20 lwr+upr>=0 );.
273f0 20 20 20 20 20 20 69 64 78 20 3d 20 28 6c 77 72 idx = (lwr
27400 2b 75 70 72 29 3e 3e 31 3b 20 20 2f 2a 20 69 64 +upr)>>1; /* id
27410 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 2f 32 3b x = (lwr+upr)/2;
27420 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 */. }.
27430 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 66 6f 72 }else{. for
27440 28 3b 3b 29 7b 0a 20 20 20 20 20 20 20 20 69 6e (;;){. in
27450 74 20 6e 43 65 6c 6c 3b 0a 20 20 20 20 20 20 20 t nCell;.
27460 20 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c pCell = findCel
27470 6c 28 70 50 61 67 65 2c 20 69 64 78 29 20 2b 20 l(pPage, idx) +
27480 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
27490 69 7a 65 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a ize;.. /*
274a0 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 73 75 70 The maximum sup
274b0 70 6f 72 74 65 64 20 70 61 67 65 2d 73 69 7a 65 ported page-size
274c0 20 69 73 20 36 35 35 33 36 20 62 79 74 65 73 2e is 65536 bytes.
274d0 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 This means that
274e0 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 . ** the
274f0 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f maximum number o
27500 66 20 72 65 63 6f 72 64 20 62 79 74 65 73 20 73 f record bytes s
27510 74 6f 72 65 64 20 6f 6e 20 61 6e 20 69 6e 64 65 tored on an inde
27520 78 20 42 2d 54 72 65 65 0a 20 20 20 20 20 20 20 x B-Tree.
27530 20 2a 2a 20 70 61 67 65 20 69 73 20 6c 65 73 73 ** page is less
27540 20 74 68 61 6e 20 31 36 33 38 34 20 62 79 74 65 than 16384 byte
27550 73 20 61 6e 64 20 6d 61 79 20 62 65 20 73 74 6f s and may be sto
27560 72 65 64 20 61 73 20 61 20 32 2d 62 79 74 65 0a red as a 2-byte.
27570 20 20 20 20 20 20 20 20 2a 2a 20 76 61 72 69 6e ** varin
27580 74 2e 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 t. This informat
27590 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 ion is used to a
275a0 74 74 65 6d 70 74 20 74 6f 20 61 76 6f 69 64 20 ttempt to avoid
275b0 70 61 72 73 69 6e 67 20 0a 20 20 20 20 20 20 20 parsing .
275c0 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 ** the entire c
275d0 65 6c 6c 20 62 79 20 63 68 65 63 6b 69 6e 67 20 ell by checking
275e0 66 6f 72 20 74 68 65 20 63 61 73 65 73 20 77 68 for the cases wh
275f0 65 72 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 ere the record i
27600 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 s . ** st
27610 6f 72 65 64 20 65 6e 74 69 72 65 6c 79 20 77 69 ored entirely wi
27620 74 68 69 6e 20 74 68 65 20 62 2d 74 72 65 65 20 thin the b-tree
27630 70 61 67 65 20 62 79 20 69 6e 73 70 65 63 74 69 page by inspecti
27640 6e 67 20 74 68 65 20 66 69 72 73 74 20 0a 20 20 ng the first .
27650 20 20 20 20 20 20 2a 2a 20 32 20 62 79 74 65 73 ** 2 bytes
27660 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a 20 20 of the cell..
27670 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
27680 20 6e 43 65 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 nCell = pCell[0
27690 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e ];. if( n
276a0 43 65 6c 6c 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 Cell<=pPage->max
276b0 31 62 79 74 65 50 61 79 6c 6f 61 64 20 29 7b 0a 1bytePayload ){.
276c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 /* Thi
276d0 73 20 62 72 61 6e 63 68 20 72 75 6e 73 20 69 66 s branch runs if
276e0 20 74 68 65 20 72 65 63 6f 72 64 2d 73 69 7a 65 the record-size
276f0 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 63 65 field of the ce
27700 6c 6c 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 ll is a.
27710 20 20 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 65 ** single byte
27720 20 76 61 72 69 6e 74 20 61 6e 64 20 74 68 65 20 varint and the
27730 72 65 63 6f 72 64 20 66 69 74 73 20 65 6e 74 69 record fits enti
27740 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 6e rely on the main
27750 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 62 2d . ** b-
27760 74 72 65 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 tree page. */.
27770 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 testcas
27780 65 28 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 e( pCell+nCell+1
27790 3d 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e ==pPage->aDataEn
277a0 64 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63 d );. c
277b0 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 = xRecordCompar
277c0 65 28 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 e(nCell, (void*)
277d0 26 70 43 65 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b &pCell[1], pIdxK
277e0 65 79 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c ey);. }el
277f0 73 65 20 69 66 28 20 21 28 70 43 65 6c 6c 5b 31 se if( !(pCell[1
27800 5d 20 26 20 30 78 38 30 29 20 0a 20 20 20 20 20 ] & 0x80) .
27810 20 20 20 20 20 26 26 20 28 6e 43 65 6c 6c 20 3d && (nCell =
27820 20 28 28 6e 43 65 6c 6c 26 30 78 37 66 29 3c 3c ((nCell&0x7f)<<
27830 37 29 20 2b 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 7) + pCell[1])<=
27840 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a pPage->maxLocal.
27850 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ){.
27860 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f /* The reco
27870 72 64 2d 73 69 7a 65 20 66 69 65 6c 64 20 69 73 rd-size field is
27880 20 61 20 32 20 62 79 74 65 20 76 61 72 69 6e 74 a 2 byte varint
27890 20 61 6e 64 20 74 68 65 20 72 65 63 6f 72 64 20 and the record
278a0 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 66 69 . ** fi
278b0 74 73 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 74 ts entirely on t
278c0 68 65 20 6d 61 69 6e 20 62 2d 74 72 65 65 20 70 he main b-tree p
278d0 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 age. */.
278e0 20 20 20 74 65 73 74 63 61 73 65 28 20 70 43 65 testcase( pCe
278f0 6c 6c 2b 6e 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 ll+nCell+2==pPag
27900 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a 20 e->aDataEnd );.
27910 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 52 65 c = xRe
27920 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 6c cordCompare(nCel
27930 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 6c 6c l, (void*)&pCell
27940 5b 32 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 [2], pIdxKey);.
27950 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
27960 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 /* The r
27970 65 63 6f 72 64 20 66 6c 6f 77 73 20 6f 76 65 72 ecord flows over
27980 20 6f 6e 74 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 onto one or mor
27990 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 e overflow pages
279a0 2e 20 49 6e 0a 20 20 20 20 20 20 20 20 20 20 2a . In. *
279b0 2a 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 * this case the
279c0 77 68 6f 6c 65 20 63 65 6c 6c 20 6e 65 65 64 73 whole cell needs
279d0 20 74 6f 20 62 65 20 70 61 72 73 65 64 2c 20 61 to be parsed, a
279e0 20 62 75 66 66 65 72 20 61 6c 6c 6f 63 61 74 65 buffer allocate
279f0 64 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 d. ** a
27a00 6e 64 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 nd accessPayload
27a10 28 29 20 75 73 65 64 20 74 6f 20 72 65 74 72 69 () used to retri
27a20 65 76 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 eve the record i
27a30 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 nto the.
27a40 20 20 2a 2a 20 62 75 66 66 65 72 20 62 65 66 6f ** buffer befo
27a50 72 65 20 56 64 62 65 52 65 63 6f 72 64 43 6f 6d re VdbeRecordCom
27a60 70 61 72 65 28 29 20 63 61 6e 20 62 65 20 63 61 pare() can be ca
27a70 6c 6c 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 20 lled. */.
27a80 20 20 20 76 6f 69 64 20 2a 70 43 65 6c 6c 4b 65 void *pCellKe
27a90 79 3b 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 y;. u8
27aa0 2a 20 63 6f 6e 73 74 20 70 43 65 6c 6c 42 6f 64 * const pCellBod
27ab0 79 20 3d 20 70 43 65 6c 6c 20 2d 20 70 50 61 67 y = pCell - pPag
27ac0 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
27ad0 0a 20 20 20 20 20 20 20 20 20 20 62 74 72 65 65 . btree
27ae0 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 ParseCellPtr(pPa
27af0 67 65 2c 20 70 43 65 6c 6c 42 6f 64 79 2c 20 26 ge, pCellBody, &
27b00 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 20 pCur->info);.
27b10 20 20 20 20 20 20 20 6e 43 65 6c 6c 20 3d 20 28 nCell = (
27b20 69 6e 74 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e int)pCur->info.n
27b30 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 70 Key;. p
27b40 43 65 6c 6c 4b 65 79 20 3d 20 73 71 6c 69 74 65 CellKey = sqlite
27b50 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 6c 6c 20 29 3Malloc( nCell )
27b60 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
27b70 70 43 65 6c 6c 4b 65 79 3d 3d 30 20 29 7b 0a 20 pCellKey==0 ){.
27b80 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
27b90 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
27ba0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d goto m
27bb0 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 oveto_finish;.
27bc0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
27bd0 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b pCur->aiIdx[
27be0 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 pCur->iPage] = (
27bf0 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 u16)idx;.
27c00 20 20 20 72 63 20 3d 20 61 63 63 65 73 73 50 61 rc = accessPa
27c10 79 6c 6f 61 64 28 70 43 75 72 2c 20 30 2c 20 6e yload(pCur, 0, n
27c20 43 65 6c 6c 2c 20 28 75 6e 73 69 67 6e 65 64 20 Cell, (unsigned
27c30 63 68 61 72 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 char*)pCellKey,
27c40 32 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 2);. if
27c50 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 ( rc ){.
27c60 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
27c70 28 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 (pCellKey);.
27c80 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
27c90 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 eto_finish;.
27ca0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
27cb0 20 20 63 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d c = xRecordCom
27cc0 70 61 72 65 28 6e 43 65 6c 6c 2c 20 70 43 65 6c pare(nCell, pCel
27cd0 6c 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 3b 0a lKey, pIdxKey);.
27ce0 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
27cf0 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3_free(pCellKey)
27d00 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
27d10 20 20 20 20 61 73 73 65 72 74 28 20 0a 20 20 20 assert( .
27d20 20 20 20 20 20 20 20 20 20 28 70 49 64 78 4b 65 (pIdxKe
27d30 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 y->errCode!=SQLI
27d40 54 45 5f 43 4f 52 52 55 50 54 20 7c 7c 20 63 3d TE_CORRUPT || c=
27d50 3d 30 29 0a 20 20 20 20 20 20 20 20 20 26 26 20 =0). &&
27d60 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 (pIdxKey->errCod
27d70 65 21 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 e!=SQLITE_NOMEM
27d80 7c 7c 20 70 43 75 72 2d 3e 70 42 74 72 65 65 2d || pCur->pBtree-
27d90 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 >db->mallocFaile
27da0 64 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 d). );.
27db0 20 20 20 20 20 20 69 66 28 20 63 3c 30 20 29 7b if( c<0 ){
27dc0 0a 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 3d . lwr =
27dd0 20 69 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 idx+1;.
27de0 7d 65 6c 73 65 20 69 66 28 20 63 3e 30 20 29 7b }else if( c>0 ){
27df0 0a 20 20 20 20 20 20 20 20 20 20 75 70 72 20 3d . upr =
27e00 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 20 idx-1;.
27e10 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
27e20 20 61 73 73 65 72 74 28 20 63 3d 3d 30 20 29 3b assert( c==0 );
27e30 0a 20 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 . *pRes
27e40 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
27e50 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
27e60 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
27e70 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
27e80 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 e] = (u16)idx;.
27e90 20 20 20 20 20 20 20 20 20 69 66 28 20 70 49 64 if( pId
27ea0 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 29 20 xKey->errCode )
27eb0 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
27ec0 55 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 UPT;. g
27ed0 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 oto moveto_finis
27ee0 68 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 h;. }.
27ef0 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 if( lwr>upr
27f00 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 ) break;.
27f10 20 20 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 assert( lwr+up
27f20 72 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 r>=0 );.
27f30 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e idx = (lwr+upr)>
27f40 3e 31 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c >1; /* idx = (l
27f50 77 72 2b 75 70 72 29 2f 32 20 2a 2f 0a 20 20 20 wr+upr)/2 */.
27f60 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 }. }. a
27f70 73 73 65 72 74 28 20 6c 77 72 3d 3d 75 70 72 2b ssert( lwr==upr+
27f80 31 20 7c 7c 20 28 70 50 61 67 65 2d 3e 69 6e 74 1 || (pPage->int
27f90 4b 65 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c Key && !pPage->l
27fa0 65 61 66 29 20 29 3b 0a 20 20 20 20 61 73 73 65 eaf) );. asse
27fb0 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 rt( pPage->isIni
27fc0 74 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 t );. if( pPa
27fd0 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
27fe0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
27ff0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
28000 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b e]<pCur->apPage[
28010 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
28020 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 70 43 75 ell );. pCu
28030 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
28040 50 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 Page] = (u16)idx
28050 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
28060 63 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 c;. rc = SQ
28070 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 67 LITE_OK;. g
28080 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 oto moveto_finis
28090 68 3b 0a 20 20 20 20 7d 0a 6d 6f 76 65 74 6f 5f h;. }.moveto_
280a0 6e 65 78 74 5f 6c 61 79 65 72 3a 0a 20 20 20 20 next_layer:.
280b0 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d 3e if( lwr>=pPage->
280c0 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 63 nCell ){. c
280d0 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 hldPg = get4byte
280e0 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
280f0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
28100 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 8]);. }else{.
28110 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 67 chldPg = g
28120 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
28130 28 70 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a 20 (pPage, lwr));.
28140 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 61 }. pCur->a
28150 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
28160 5d 20 3d 20 28 75 31 36 29 6c 77 72 3b 0a 20 20 ] = (u16)lwr;.
28170 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
28180 6c 64 28 70 43 75 72 2c 20 63 68 6c 64 50 67 29 ld(pCur, chldPg)
28190 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 62 ;. if( rc ) b
281a0 72 65 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 65 74 6f reak;. }.moveto
281b0 5f 66 69 6e 69 73 68 3a 0a 20 20 70 43 75 72 2d _finish:. pCur-
281c0 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
281d0 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 . pCur->curFlag
281e0 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 s &= ~(BTCF_Vali
281f0 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 dNKey|BTCF_Valid
28200 4f 76 66 6c 29 3b 0a 20 20 72 65 74 75 72 6e 20 Ovfl);. return
28210 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}.../*.** Re
28220 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 turn TRUE if the
28230 20 63 75 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 cursor is not p
28240 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e ointing at an en
28250 74 72 79 20 6f 66 20 74 68 65 20 74 61 62 6c 65 try of the table
28260 2e 0a 2a 2a 0a 2a 2a 20 54 52 55 45 20 77 69 6c ..**.** TRUE wil
28270 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 61 66 l be returned af
28280 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 ter a call to sq
28290 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 lite3BtreeNext()
282a0 20 6d 6f 76 65 73 0a 2a 2a 20 70 61 73 74 20 74 moves.** past t
282b0 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e he last entry in
282c0 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 73 71 the table or sq
282d0 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 28 29 lite3BtreePrev()
282e0 20 6d 6f 76 65 73 20 70 61 73 74 0a 2a 2a 20 74 moves past.** t
282f0 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 2e 20 he first entry.
28300 20 54 52 55 45 20 69 73 20 61 6c 73 6f 20 72 65 TRUE is also re
28310 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 74 61 turned if the ta
28320 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f ble is empty..*/
28330 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
28340 65 45 6f 66 28 42 74 43 75 72 73 6f 72 20 2a 70 eEof(BtCursor *p
28350 43 75 72 29 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a Cur){. /* TODO:
28360 20 57 68 61 74 20 69 66 20 74 68 65 20 63 75 72 What if the cur
28370 73 6f 72 20 69 73 20 69 6e 20 43 55 52 53 4f 52 sor is in CURSOR
28380 5f 52 45 51 55 49 52 45 53 45 45 4b 20 62 75 74 _REQUIRESEEK but
28390 20 61 6c 6c 20 74 61 62 6c 65 20 65 6e 74 72 69 all table entri
283a0 65 73 0a 20 20 2a 2a 20 68 61 76 65 20 62 65 65 es. ** have bee
283b0 6e 20 64 65 6c 65 74 65 64 3f 20 54 68 69 73 20 n deleted? This
283c0 41 50 49 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f API will need to
283d0 20 63 68 61 6e 67 65 20 74 6f 20 72 65 74 75 72 change to retur
283e0 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a n an error code.
283f0 20 20 2a 2a 20 61 73 20 77 65 6c 6c 20 61 73 20 ** as well as
28400 74 68 65 20 62 6f 6f 6c 65 61 6e 20 72 65 73 75 the boolean resu
28410 6c 74 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 lt value.. */.
28420 20 72 65 74 75 72 6e 20 28 43 55 52 53 4f 52 5f return (CURSOR_
28430 56 41 4c 49 44 21 3d 70 43 75 72 2d 3e 65 53 74 VALID!=pCur->eSt
28440 61 74 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 ate);.}../*.** A
28450 64 76 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f dvance the curso
28460 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e r to the next en
28470 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 try in the datab
28480 61 73 65 2e 20 20 49 66 0a 2a 2a 20 73 75 63 63 ase. If.** succ
28490 65 73 73 66 75 6c 20 74 68 65 6e 20 73 65 74 20 essful then set
284a0 2a 70 52 65 73 3d 30 2e 20 20 49 66 20 74 68 65 *pRes=0. If the
284b0 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 73 20 61 cursor.** was a
284c0 6c 72 65 61 64 79 20 70 6f 69 6e 74 69 6e 67 20 lready pointing
284d0 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 to the last entr
284e0 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
284f0 65 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 e before.** this
28500 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c routine was cal
28510 6c 65 64 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 led, then set *p
28520 52 65 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 Res=1..**.** The
28530 20 6d 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e main entry poin
28540 74 20 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 t is sqlite3Btre
28550 65 4e 65 78 74 28 29 2e 20 20 54 68 61 74 20 72 eNext(). That r
28560 6f 75 74 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 outine is optimi
28570 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 zed.** for the c
28580 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 ommon case of me
28590 72 65 6c 79 20 69 6e 63 72 65 6d 65 6e 74 69 6e rely incrementin
285a0 67 20 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 g the cell count
285b0 65 72 20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 er BtCursor.aiId
285c0 78 0a 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 x.** to the next
285d0 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 cell on the cur
285e0 72 65 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 rent page. The
285f0 28 73 6c 6f 77 65 72 29 20 62 74 72 65 65 4e 65 (slower) btreeNe
28600 78 74 28 29 20 68 65 6c 70 65 72 0a 2a 2a 20 72 xt() helper.** r
28610 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
28620 20 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 when it is nece
28630 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f ssary to move to
28640 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 a different pag
28650 65 20 6f 72 0a 2a 2a 20 74 6f 20 72 65 73 74 6f e or.** to resto
28660 72 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a re the cursor..*
28670 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 *.** The calling
28680 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 function will s
28690 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 et *pRes to 0 or
286a0 20 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 1. The initial
286b0 20 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 *pRes value.**
286c0 77 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 will be 1 if the
286d0 20 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 cursor being st
286e0 65 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 epped correspond
286f0 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 s to an SQL inde
28700 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 x and.** if this
28710 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 routine could h
28720 61 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 ave been skipped
28730 20 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 if that SQL ind
28740 65 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 ex had been.** a
28750 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 unique index.
28760 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 63 61 Otherwise the ca
28770 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 ller will have s
28780 65 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f et *pRes to zero
28790 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 ..** Zero is the
287a0 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 common case. Th
287b0 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e e btree implemen
287c0 74 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 tation is free t
287d0 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 o use the.** ini
287e0 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 tial *pRes value
287f0 20 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d as a hint to im
28800 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 prove performanc
28810 65 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 65 e, but the curre
28820 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 nt.** SQLite btr
28830 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ee implementatio
28840 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 n does not. (Not
28850 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 e that the comdb
28860 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 2 btree.** imple
28870 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 mentation does u
28880 73 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f se this hint, ho
28890 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 wever.).*/.stati
288a0 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
288b0 45 20 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 E int btreeNext(
288c0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
288d0 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e int *pRes){. in
288e0 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 64 78 3b t rc;. int idx;
288f0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
28900 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 e;.. assert( cu
28910 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
28920 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
28930 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
28940 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 ==0 || pCur->eSt
28950 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
28960 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 2a D );. assert( *
28970 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 69 66 28 pRes==0 );. if(
28980 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
28990 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 URSOR_VALID ){.
289a0 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 assert( (pCur
289b0 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
289c0 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 F_ValidOvfl)==0
289d0 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 );. rc = rest
289e0 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
289f0 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 n(pCur);. if(
28a00 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
28a10 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
28a20 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
28a30 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d CURSOR_INVALID=
28a40 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b =pCur->eState ){
28a50 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 . *pRes = 1
28a60 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
28a70 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
28a80 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b if( pCur->sk
28a90 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 ipNext ){.
28aa0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
28ab0 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
28ac0 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 ID || pCur->eSta
28ad0 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e te==CURSOR_SKIPN
28ae0 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 EXT );. pCu
28af0 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
28b00 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 OR_VALID;.
28b10 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 if( pCur->skipNe
28b20 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 xt>0 ){.
28b30 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d pCur->skipNext =
28b40 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 0;. retu
28b50 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
28b60 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 }. pCur
28b70 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a ->skipNext = 0;.
28b80 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 }. }.. pPa
28b90 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
28ba0 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
28bb0 20 20 69 64 78 20 3d 20 2b 2b 70 43 75 72 2d 3e idx = ++pCur->
28bc0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
28bd0 65 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 e];. assert( pP
28be0 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 0a age->isInit );..
28bf0 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
28c00 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 6f 72 base file is cor
28c10 72 75 70 74 2c 20 69 74 20 69 73 20 70 6f 73 73 rupt, it is poss
28c20 69 62 6c 65 20 66 6f 72 20 74 68 65 20 76 61 6c ible for the val
28c30 75 65 20 6f 66 20 69 64 78 20 0a 20 20 2a 2a 20 ue of idx . **
28c40 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 20 68 65 to be invalid he
28c50 72 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c re. This can onl
28c60 79 20 6f 63 63 75 72 20 69 66 20 61 20 73 65 63 y occur if a sec
28c70 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f 64 69 66 ond cursor modif
28c80 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 ies. ** the pag
28c90 65 20 77 68 69 6c 65 20 63 75 72 73 6f 72 20 70 e while cursor p
28ca0 43 75 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 Cur is holding a
28cb0 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 69 74 reference to it
28cc0 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 20 2a 2a . Which can. **
28cd0 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 only happen if
28ce0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
28cf0 63 6f 72 72 75 70 74 20 69 6e 20 73 75 63 68 20 corrupt in such
28d00 61 20 77 61 79 20 61 73 20 74 6f 20 6c 69 6e 6b a way as to link
28d10 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 the. ** page i
28d20 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e nto more than on
28d30 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 e b-tree structu
28d40 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 re. */. testcas
28d50 65 28 20 69 64 78 3e 70 50 61 67 65 2d 3e 6e 43 e( idx>pPage->nC
28d60 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 20 69 64 ell );.. if( id
28d70 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 x>=pPage->nCell
28d80 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 ){. if( !pPag
28d90 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
28da0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
28db0 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 74 65 d(pCur, get4byte
28dc0 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
28dd0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
28de0 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 8]));. if(
28df0 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
28e00 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 return mov
28e10 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 eToLeftmost(pCur
28e20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 6f 7b );. }. do{
28e30 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
28e40 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 >iPage==0 ){.
28e50 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a *pRes = 1;.
28e60 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 pCur->eS
28e70 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
28e80 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 72 VALID;. r
28e90 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
28ea0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d . }. m
28eb0 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 oveToParent(pCur
28ec0 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d );. pPage =
28ed0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
28ee0 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 ur->iPage];.
28ef0 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 69 }while( pCur->ai
28f00 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
28f10 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 >=pPage->nCell )
28f20 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d ;. if( pPage-
28f30 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 >intKey ){.
28f40 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 return sqlite3B
28f50 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 treeNext(pCur, p
28f60 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b Res);. }else{
28f70 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
28f80 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
28f90 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e }. if( pPage->
28fa0 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 leaf ){. retu
28fb0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
28fc0 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 }else{. retur
28fd0 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
28fe0 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 6e (pCur);. }.}.in
28ff0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 t sqlite3BtreeNe
29000 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 xt(BtCursor *pCu
29010 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
29020 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
29030 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
29040 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
29050 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
29060 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 Res!=0 );. asse
29070 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 rt( *pRes==0 ||
29080 2a 70 52 65 73 3d 3d 31 20 29 3b 0a 20 20 61 73 *pRes==1 );. as
29090 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 sert( pCur->skip
290a0 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Next==0 || pCur-
290b0 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
290c0 56 41 4c 49 44 20 29 3b 0a 20 20 70 43 75 72 2d VALID );. pCur-
290d0 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
290e0 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 . pCur->curFlag
290f0 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 s &= ~(BTCF_Vali
29100 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 dNKey|BTCF_Valid
29110 4f 76 66 6c 29 3b 0a 20 20 2a 70 52 65 73 20 3d Ovfl);. *pRes =
29120 20 30 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 0;. if( pCur->
29130 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
29140 41 4c 49 44 20 29 20 72 65 74 75 72 6e 20 62 74 ALID ) return bt
29150 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 52 reeNext(pCur, pR
29160 65 73 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 70 es);. pPage = p
29170 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
29180 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 69 66 28 20 ->iPage];. if(
29190 28 2b 2b 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 (++pCur->aiIdx[p
291a0 43 75 72 2d 3e 69 50 61 67 65 5d 29 3e 3d 70 50 Cur->iPage])>=pP
291b0 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 age->nCell ){.
291c0 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
291d0 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 ur->iPage]--;.
291e0 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 4e 65 return btreeNe
291f0 78 74 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a xt(pCur, pRes);.
29200 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d }. if( pPage-
29210 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 >leaf ){. ret
29220 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
29230 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
29240 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 rn moveToLeftmos
29250 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a t(pCur);. }.}..
29260 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 20 63 /*.** Step the c
29270 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 61 63 ursor to the bac
29280 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 k to the previou
29290 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 s entry in the d
292a0 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a 2a 20 atabase. If.**
292b0 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 6e 20 successful then
292c0 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 49 66 set *pRes=0. If
292d0 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 the cursor.** w
292e0 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 as already point
292f0 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72 73 74 ing to the first
29300 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 entry in the da
29310 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a 2a 2a tabase before.**
29320 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 this routine wa
29330 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 73 s called, then s
29340 65 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2a 0a 2a et *pRes=1..**.*
29350 2a 20 54 68 65 20 6d 61 69 6e 20 65 6e 74 72 79 * The main entry
29360 20 70 6f 69 6e 74 20 69 73 20 73 71 6c 69 74 65 point is sqlite
29370 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 28 29 3BtreePrevious()
29380 2e 20 20 54 68 61 74 20 72 6f 75 74 69 6e 65 20 . That routine
29390 69 73 20 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 is optimized.**
293a0 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 for the common c
293b0 61 73 65 20 6f 66 20 6d 65 72 65 6c 79 20 64 65 ase of merely de
293c0 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 crementing the c
293d0 65 6c 6c 20 63 6f 75 6e 74 65 72 20 42 74 43 75 ell counter BtCu
293e0 72 73 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f rsor.aiIdx.** to
293f0 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 63 65 the previous ce
29400 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e ll on the curren
29410 74 20 70 61 67 65 2e 20 20 54 68 65 20 28 73 6c t page. The (sl
29420 6f 77 65 72 29 20 62 74 72 65 65 50 72 65 76 69 ower) btreePrevi
29430 6f 75 73 28 29 0a 2a 2a 20 68 65 6c 70 65 72 20 ous().** helper
29440 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
29450 64 20 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 d when it is nec
29460 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 essary to move t
29470 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 o a different pa
29480 67 65 0a 2a 2a 20 6f 72 20 74 6f 20 72 65 73 74 ge.** or to rest
29490 6f 72 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a ore the cursor..
294a0 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e **.** The callin
294b0 67 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 g function will
294c0 73 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f set *pRes to 0 o
294d0 72 20 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 r 1. The initia
294e0 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a l *pRes value.**
294f0 20 77 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 will be 1 if th
29500 65 20 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 e cursor being s
29510 74 65 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e tepped correspon
29520 64 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 ds to an SQL ind
29530 65 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 ex and.** if thi
29540 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 s routine could
29550 68 61 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 have been skippe
29560 64 20 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e d if that SQL in
29570 64 65 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 dex had been.**
29580 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 a unique index.
29590 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 63 Otherwise the c
295a0 61 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 aller will have
295b0 73 65 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 set *pRes to zer
295c0 6f 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 o..** Zero is th
295d0 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 e common case. T
295e0 68 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 he btree impleme
295f0 6e 74 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 ntation is free
29600 74 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e to use the.** in
29610 69 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 itial *pRes valu
29620 65 20 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 e as a hint to i
29630 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e mprove performan
29640 63 65 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 ce, but the curr
29650 65 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 ent.** SQLite bt
29660 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ree implementati
29670 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f on does not. (No
29680 74 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 te that the comd
29690 62 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c b2 btree.** impl
296a0 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 ementation does
296b0 75 73 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 use this hint, h
296c0 6f 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 owever.).*/.stat
296d0 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 ic SQLITE_NOINLI
296e0 4e 45 20 69 6e 74 20 62 74 72 65 65 50 72 65 76 NE int btreePrev
296f0 69 6f 75 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ious(BtCursor *p
29700 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b Cur, int *pRes){
29710 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65 6d . int rc;. Mem
29720 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 Page *pPage;..
29730 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
29740 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
29750 3b 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 73 ;. assert( pRes
29760 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
29770 20 2a 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 61 *pRes==0 );. a
29780 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 ssert( pCur->ski
29790 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 pNext==0 || pCur
297a0 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
297b0 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 _VALID );. asse
297c0 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c rt( (pCur->curFl
297d0 61 67 73 20 26 20 28 42 54 43 46 5f 41 74 4c 61 ags & (BTCF_AtLa
297e0 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 st|BTCF_ValidOvf
297f0 6c 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 l|BTCF_ValidNKey
29800 29 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ))==0 );. asser
29810 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 t( pCur->info.nS
29820 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 ize==0 );. if(
29830 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
29840 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 RSOR_VALID ){.
29850 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
29860 65 53 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 eState>=CURSOR_R
29870 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
29880 20 20 72 63 20 3d 20 62 74 72 65 65 52 65 73 74 rc = btreeRest
29890 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
298a0 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 n(pCur);. if(
298b0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
298c0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
298d0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
298e0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d CURSOR_INVALID=
298f0 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b =pCur->eState ){
29900 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 . *pRes = 1
29910 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
29920 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
29930 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b if( pCur->sk
29940 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 ipNext ){.
29950 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
29960 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
29970 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 ID || pCur->eSta
29980 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e te==CURSOR_SKIPN
29990 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 EXT );. pCu
299a0 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
299b0 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 OR_VALID;.
299c0 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 if( pCur->skipNe
299d0 78 74 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20 xt<0 ){.
299e0 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d pCur->skipNext =
299f0 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 0;. retu
29a00 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
29a10 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 }. pCur
29a20 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a ->skipNext = 0;.
29a30 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 }. }.. pPa
29a40 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
29a50 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
29a60 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
29a70 3e 69 73 49 6e 69 74 20 29 3b 0a 20 20 69 66 28 >isInit );. if(
29a80 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
29a90 0a 20 20 20 20 69 6e 74 20 69 64 78 20 3d 20 70 . int idx = p
29aa0 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
29ab0 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 72 63 20 >iPage];. rc
29ac0 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 = moveToChild(pC
29ad0 75 72 2c 20 67 65 74 34 62 79 74 65 28 66 69 6e ur, get4byte(fin
29ae0 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 64 78 dCell(pPage, idx
29af0 29 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 )));. if( rc
29b00 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
29b10 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 68 rc = moveToRigh
29b20 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 7d tmost(pCur);. }
29b30 65 6c 73 65 7b 0a 20 20 20 20 77 68 69 6c 65 28 else{. while(
29b40 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 pCur->aiIdx[pCu
29b50 72 2d 3e 69 50 61 67 65 5d 3d 3d 30 20 29 7b 0a r->iPage]==0 ){.
29b60 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e if( pCur->
29b70 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 iPage==0 ){.
29b80 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 pCur->eState
29b90 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 = CURSOR_INVALI
29ba0 44 3b 0a 20 20 20 20 20 20 20 20 2a 70 52 65 73 D;. *pRes
29bb0 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 65 = 1;. re
29bc0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
29bd0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d 6f }. mo
29be0 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 29 veToParent(pCur)
29bf0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
29c00 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e rt( pCur->info.n
29c10 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 Size==0 );. a
29c20 73 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 75 ssert( (pCur->cu
29c30 72 46 6c 61 67 73 20 26 20 28 42 54 43 46 5f 56 rFlags & (BTCF_V
29c40 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 alidNKey|BTCF_Va
29c50 6c 69 64 4f 76 66 6c 29 29 3d 3d 30 20 29 3b 0a lidOvfl))==0 );.
29c60 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 . pCur->aiIdx
29c70 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b [pCur->iPage]--;
29c80 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 43 75 . pPage = pCu
29c90 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
29ca0 69 50 61 67 65 5d 3b 0a 20 20 20 20 69 66 28 20 iPage];. if(
29cb0 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 pPage->intKey &&
29cc0 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
29cd0 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
29ce0 74 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 te3BtreePrevious
29cf0 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 (pCur, pRes);.
29d00 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
29d10 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
29d20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
29d30 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 n rc;.}.int sqli
29d40 74 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 te3BtreePrevious
29d50 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
29d60 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 61 int *pRes){. a
29d70 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
29d80 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
29d90 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 73 21 . assert( pRes!
29da0 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
29db0 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 2a 70 52 65 *pRes==0 || *pRe
29dc0 73 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 s==1 );. assert
29dd0 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
29de0 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 ==0 || pCur->eSt
29df0 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
29e00 44 20 29 3b 0a 20 20 2a 70 52 65 73 20 3d 20 30 D );. *pRes = 0
29e10 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 ;. pCur->curFla
29e20 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c gs &= ~(BTCF_AtL
29e30 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 ast|BTCF_ValidOv
29e40 66 6c 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 fl|BTCF_ValidNKe
29e50 79 29 3b 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f y);. pCur->info
29e60 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 69 66 .nSize = 0;. if
29e70 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d ( pCur->eState!=
29e80 43 55 52 53 4f 52 5f 56 41 4c 49 44 0a 20 20 20 CURSOR_VALID.
29e90 7c 7c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 || pCur->aiIdx[p
29ea0 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d 30 0a 20 Cur->iPage]==0.
29eb0 20 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 || pCur->apPag
29ec0 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e e[pCur->iPage]->
29ed0 6c 65 61 66 3d 3d 30 0a 20 20 29 7b 0a 20 20 20 leaf==0. ){.
29ee0 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 72 65 return btreePre
29ef0 76 69 6f 75 73 28 70 43 75 72 2c 20 70 52 65 73 vious(pCur, pRes
29f00 29 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 61 );. }. pCur->a
29f10 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
29f20 5d 2d 2d 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ]--;. return SQ
29f30 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
29f40 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 * Allocate a new
29f50 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 64 page from the d
29f60 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a atabase file..**
29f70 0a 2a 2a 20 54 68 65 20 6e 65 77 20 70 61 67 65 .** The new page
29f80 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 64 69 is marked as di
29f90 72 74 79 2e 20 20 28 49 6e 20 6f 74 68 65 72 20 rty. (In other
29fa0 77 6f 72 64 73 2c 20 73 71 6c 69 74 65 33 50 61 words, sqlite3Pa
29fb0 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 68 61 gerWrite().** ha
29fc0 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 s already been c
29fd0 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6e 65 77 alled on the new
29fe0 20 70 61 67 65 2e 29 20 20 54 68 65 20 6e 65 77 page.) The new
29ff0 20 70 61 67 65 20 68 61 73 20 61 6c 73 6f 0a 2a page has also.*
2a000 2a 20 62 65 65 6e 20 72 65 66 65 72 65 6e 63 65 * been reference
2a010 64 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e d and the callin
2a020 67 20 72 6f 75 74 69 6e 65 20 69 73 20 72 65 73 g routine is res
2a030 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 63 61 6c ponsible for cal
2a040 6c 69 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 33 50 ling.** sqlite3P
2a050 61 67 65 72 55 6e 72 65 66 28 29 20 6f 6e 20 74 agerUnref() on t
2a060 68 65 20 6e 65 77 20 70 61 67 65 20 77 68 65 6e he new page when
2a070 20 69 74 20 69 73 20 64 6f 6e 65 2e 0a 2a 2a 0a it is done..**.
2a080 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 ** SQLITE_OK is
2a090 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 returned on succ
2a0a0 65 73 73 2e 20 20 41 6e 79 20 6f 74 68 65 72 20 ess. Any other
2a0b0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 6e 64 return value ind
2a0c0 69 63 61 74 65 73 0a 2a 2a 20 61 6e 20 65 72 72 icates.** an err
2a0d0 6f 72 2e 20 20 2a 70 70 50 61 67 65 20 61 6e 64 or. *ppPage and
2a0e0 20 2a 70 50 67 6e 6f 20 61 72 65 20 75 6e 64 65 *pPgno are unde
2a0f0 66 69 6e 65 64 20 69 6e 20 74 68 65 20 65 76 65 fined in the eve
2a100 6e 74 20 6f 66 20 61 6e 20 65 72 72 6f 72 2e 0a nt of an error..
2a110 2a 2a 20 44 6f 20 6e 6f 74 20 69 6e 76 6f 6b 65 ** Do not invoke
2a120 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
2a130 65 66 28 29 20 6f 6e 20 2a 70 70 50 61 67 65 20 ef() on *ppPage
2a140 69 66 20 61 6e 20 65 72 72 6f 72 20 69 73 20 72 if an error is r
2a150 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 eturned..**.** I
2a160 66 20 74 68 65 20 22 6e 65 61 72 62 79 22 20 70 f the "nearby" p
2a170 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 arameter is not
2a180 30 2c 20 74 68 65 6e 20 61 6e 20 65 66 66 6f 72 0, then an effor
2a190 74 20 69 73 20 6d 61 64 65 20 74 6f 20 0a 2a 2a t is made to .**
2a1a0 20 6c 6f 63 61 74 65 20 61 20 70 61 67 65 20 63 locate a page c
2a1b0 6c 6f 73 65 20 74 6f 20 74 68 65 20 70 61 67 65 lose to the page
2a1c0 20 6e 75 6d 62 65 72 20 22 6e 65 61 72 62 79 22 number "nearby"
2a1d0 2e 20 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 . This can be u
2a1e0 73 65 64 20 69 6e 20 61 6e 0a 2a 2a 20 61 74 74 sed in an.** att
2a1f0 65 6d 70 74 20 74 6f 20 6b 65 65 70 20 72 65 6c empt to keep rel
2a200 61 74 65 64 20 70 61 67 65 73 20 63 6c 6f 73 65 ated pages close
2a210 20 74 6f 20 65 61 63 68 20 6f 74 68 65 72 20 69 to each other i
2a220 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
2a230 69 6c 65 2c 0a 2a 2a 20 77 68 69 63 68 20 69 6e ile,.** which in
2a240 20 74 75 72 6e 20 63 61 6e 20 6d 61 6b 65 20 64 turn can make d
2a250 61 74 61 62 61 73 65 20 61 63 63 65 73 73 20 66 atabase access f
2a260 61 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 aster..**.** If
2a270 74 68 65 20 65 4d 6f 64 65 20 70 61 72 61 6d 65 the eMode parame
2a280 74 65 72 20 69 73 20 42 54 41 4c 4c 4f 43 5f 45 ter is BTALLOC_E
2a290 58 41 43 54 20 61 6e 64 20 74 68 65 20 6e 65 61 XACT and the nea
2a2a0 72 62 79 20 70 61 67 65 20 65 78 69 73 74 73 0a rby page exists.
2a2b0 2a 2a 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 ** anywhere on t
2a2c0 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 he free-list, th
2a2d0 65 6e 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 en it is guarant
2a2e0 65 65 64 20 74 6f 20 62 65 20 72 65 74 75 72 6e eed to be return
2a2f0 65 64 2e 20 20 49 66 0a 2a 2a 20 65 4d 6f 64 65 ed. If.** eMode
2a300 20 69 73 20 42 54 41 4c 4c 4f 43 5f 4c 54 20 74 is BTALLOC_LT t
2a310 68 65 6e 20 74 68 65 20 70 61 67 65 20 72 65 74 hen the page ret
2a320 75 72 6e 65 64 20 77 69 6c 6c 20 62 65 20 6c 65 urned will be le
2a330 73 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c ss than or equal
2a340 0a 2a 2a 20 74 6f 20 6e 65 61 72 62 79 20 69 66 .** to nearby if
2a350 20 61 6e 79 20 73 75 63 68 20 70 61 67 65 20 65 any such page e
2a360 78 69 73 74 73 2e 20 20 49 66 20 65 4d 6f 64 65 xists. If eMode
2a370 20 69 73 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 is BTALLOC_ANY
2a380 74 68 65 6e 20 74 68 65 72 65 0a 2a 2a 20 61 72 then there.** ar
2a390 65 20 6e 6f 20 72 65 73 74 72 69 63 74 69 6f 6e e no restriction
2a3a0 73 20 6f 6e 20 77 68 69 63 68 20 70 61 67 65 20 s on which page
2a3b0 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a is returned..*/.
2a3c0 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 static int alloc
2a3d0 61 74 65 42 74 72 65 65 50 61 67 65 28 0a 20 20 ateBtreePage(.
2a3e0 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 BtShared *pBt,
2a3f0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 /* The bt
2a400 72 65 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 ree */. MemPage
2a410 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 **ppPage,
2a420 2f 2a 20 53 74 6f 72 65 20 70 6f 69 6e 74 65 72 /* Store pointer
2a430 20 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 to the allocate
2a440 64 20 70 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 d page here */.
2a450 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 2c 20 20 20 Pgno *pPgno,
2a460 20 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 /* Store
2a470 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
2a480 20 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 here */. Pgno
2a490 6e 65 61 72 62 79 2c 20 20 20 20 20 20 20 20 20 nearby,
2a4a0 20 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 20 /* Search for
2a4b0 61 20 70 61 67 65 20 6e 65 61 72 20 74 68 69 73 a page near this
2a4c0 20 6f 6e 65 20 2a 2f 0a 20 20 75 38 20 65 4d 6f one */. u8 eMo
2a4d0 64 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 de
2a4e0 20 2f 2a 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 /* BTALLOC_EXAC
2a4f0 54 2c 20 42 54 41 4c 4c 4f 43 5f 4c 54 2c 20 6f T, BTALLOC_LT, o
2a500 72 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 2a 2f r BTALLOC_ANY */
2a510 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 .){. MemPage *p
2a520 50 61 67 65 31 3b 0a 20 20 69 6e 74 20 72 63 3b Page1;. int rc;
2a530 0a 20 20 75 33 32 20 6e 3b 20 20 20 20 20 2f 2a . u32 n; /*
2a540 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
2a550 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 on the freelist
2a560 20 2a 2f 0a 20 20 75 33 32 20 6b 3b 20 20 20 20 */. u32 k;
2a570 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 65 /* Number of le
2a580 61 76 65 73 20 6f 6e 20 74 68 65 20 74 72 75 6e aves on the trun
2a590 6b 20 6f 66 20 74 68 65 20 66 72 65 65 6c 69 73 k of the freelis
2a5a0 74 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a t */. MemPage *
2a5b0 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 4d 65 pTrunk = 0;. Me
2a5c0 6d 50 61 67 65 20 2a 70 50 72 65 76 54 72 75 6e mPage *pPrevTrun
2a5d0 6b 20 3d 20 30 3b 0a 20 20 50 67 6e 6f 20 6d 78 k = 0;. Pgno mx
2a5e0 50 61 67 65 3b 20 20 20 20 20 2f 2a 20 54 6f 74 Page; /* Tot
2a5f0 61 6c 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 al size of the d
2a600 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
2a610 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
2a620 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
2a630 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
2a640 73 73 65 72 74 28 20 65 4d 6f 64 65 3d 3d 42 54 ssert( eMode==BT
2a650 41 4c 4c 4f 43 5f 41 4e 59 20 7c 7c 20 28 6e 65 ALLOC_ANY || (ne
2a660 61 72 62 79 3e 30 20 26 26 20 49 66 4e 6f 74 4f arby>0 && IfNotO
2a670 6d 69 74 41 56 28 70 42 74 2d 3e 61 75 74 6f 56 mitAV(pBt->autoV
2a680 61 63 75 75 6d 29 29 20 29 3b 0a 20 20 70 50 61 acuum)) );. pPa
2a690 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 ge1 = pBt->pPage
2a6a0 31 3b 0a 20 20 6d 78 50 61 67 65 20 3d 20 62 74 1;. mxPage = bt
2a6b0 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
2a6c0 29 3b 0a 20 20 6e 20 3d 20 67 65 74 34 62 79 74 );. n = get4byt
2a6d0 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
2a6e0 5b 33 36 5d 29 3b 0a 20 20 74 65 73 74 63 61 73 [36]);. testcas
2a6f0 65 28 20 6e 3d 3d 6d 78 50 61 67 65 2d 31 20 29 e( n==mxPage-1 )
2a700 3b 0a 20 20 69 66 28 20 6e 3e 3d 6d 78 50 61 67 ;. if( n>=mxPag
2a710 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 e ){. return
2a720 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
2a730 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e KPT;. }. if( n
2a740 3e 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 >0 ){. /* The
2a750 72 65 20 61 72 65 20 70 61 67 65 73 20 6f 6e 20 re are pages on
2a760 74 68 65 20 66 72 65 65 6c 69 73 74 2e 20 20 52 the freelist. R
2a770 65 75 73 65 20 6f 6e 65 20 6f 66 20 74 68 6f 73 euse one of thos
2a780 65 20 70 61 67 65 73 2e 20 2a 2f 0a 20 20 20 20 e pages. */.
2a790 50 67 6e 6f 20 69 54 72 75 6e 6b 3b 0a 20 20 20 Pgno iTrunk;.
2a7a0 20 75 38 20 73 65 61 72 63 68 4c 69 73 74 20 3d u8 searchList =
2a7b0 20 30 3b 20 2f 2a 20 49 66 20 74 68 65 20 66 72 0; /* If the fr
2a7c0 65 65 2d 6c 69 73 74 20 6d 75 73 74 20 62 65 20 ee-list must be
2a7d0 73 65 61 72 63 68 65 64 20 66 6f 72 20 27 6e 65 searched for 'ne
2a7e0 61 72 62 79 27 20 2a 2f 0a 20 20 20 20 0a 20 20 arby' */. .
2a7f0 20 20 2f 2a 20 49 66 20 65 4d 6f 64 65 3d 3d 42 /* If eMode==B
2a800 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 61 6e 64 TALLOC_EXACT and
2a810 20 61 20 71 75 65 72 79 20 6f 66 20 74 68 65 20 a query of the
2a820 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 pointer-map.
2a830 2a 2a 20 73 68 6f 77 73 20 74 68 61 74 20 74 68 ** shows that th
2a840 65 20 70 61 67 65 20 27 6e 65 61 72 62 79 27 20 e page 'nearby'
2a850 69 73 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 is somewhere on
2a860 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 the free-list, t
2a870 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 65 hen. ** the e
2a880 6e 74 69 72 65 2d 6c 69 73 74 20 77 69 6c 6c 20 ntire-list will
2a890 62 65 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 be searched for
2a8a0 74 68 61 74 20 70 61 67 65 2e 0a 20 20 20 20 2a that page.. *
2a8b0 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
2a8c0 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
2a8d0 0a 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d . if( eMode==
2a8e0 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 29 7b BTALLOC_EXACT ){
2a8f0 0a 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 . if( nearb
2a900 79 3c 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 y<=mxPage ){.
2a910 20 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a 20 u8 eType;.
2a920 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e assert( n
2a930 65 61 72 62 79 3e 30 20 29 3b 0a 20 20 20 20 20 earby>0 );.
2a940 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e assert( pBt->
2a950 61 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 autoVacuum );.
2a960 20 20 20 20 20 20 72 63 20 3d 20 70 74 72 6d 61 rc = ptrma
2a970 70 47 65 74 28 70 42 74 2c 20 6e 65 61 72 62 79 pGet(pBt, nearby
2a980 2c 20 26 65 54 79 70 65 2c 20 30 29 3b 0a 20 20 , &eType, 0);.
2a990 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 if( rc ) r
2a9a0 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
2a9b0 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 if( eType==PTR
2a9c0 4d 41 50 5f 46 52 45 45 50 41 47 45 20 29 7b 0a MAP_FREEPAGE ){.
2a9d0 20 20 20 20 20 20 20 20 20 20 73 65 61 72 63 68 search
2a9e0 4c 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 List = 1;.
2a9f0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
2aa00 7d 65 6c 73 65 20 69 66 28 20 65 4d 6f 64 65 3d }else if( eMode=
2aa10 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 =BTALLOC_LE ){.
2aa20 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 searchList
2aa30 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 = 1;. }.#endi
2aa40 66 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d f.. /* Decrem
2aa50 65 6e 74 20 74 68 65 20 66 72 65 65 2d 6c 69 73 ent the free-lis
2aa60 74 20 63 6f 75 6e 74 20 62 79 20 31 2e 20 53 65 t count by 1. Se
2aa70 74 20 69 54 72 75 6e 6b 20 74 6f 20 74 68 65 20 t iTrunk to the
2aa80 69 6e 64 65 78 20 6f 66 20 74 68 65 0a 20 20 20 index of the.
2aa90 20 2a 2a 20 66 69 72 73 74 20 66 72 65 65 2d 6c ** first free-l
2aaa0 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 ist trunk page.
2aab0 69 50 72 65 76 54 72 75 6e 6b 20 69 73 20 69 6e iPrevTrunk is in
2aac0 69 74 69 61 6c 6c 79 20 31 2e 0a 20 20 20 20 2a itially 1.. *
2aad0 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 /. rc = sqlit
2aae0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 e3PagerWrite(pPa
2aaf0 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
2ab00 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
2ab10 72 6e 20 72 63 3b 0a 20 20 20 20 70 75 74 34 62 rn rc;. put4b
2ab20 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
2ab30 74 61 5b 33 36 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 ta[36], n-1);..
2ab40 20 20 20 2f 2a 20 54 68 65 20 63 6f 64 65 20 77 /* The code w
2ab50 69 74 68 69 6e 20 74 68 69 73 20 6c 6f 6f 70 20 ithin this loop
2ab60 69 73 20 72 75 6e 20 6f 6e 6c 79 20 6f 6e 63 65 is run only once
2ab70 20 69 66 20 74 68 65 20 27 73 65 61 72 63 68 4c if the 'searchL
2ab80 69 73 74 27 20 76 61 72 69 61 62 6c 65 0a 20 20 ist' variable.
2ab90 20 20 2a 2a 20 69 73 20 6e 6f 74 20 74 72 75 65 ** is not true
2aba0 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 . Otherwise, it
2abb0 72 75 6e 73 20 6f 6e 63 65 20 66 6f 72 20 65 61 runs once for ea
2abc0 63 68 20 74 72 75 6e 6b 2d 70 61 67 65 20 6f 6e ch trunk-page on
2abd0 20 74 68 65 0a 20 20 20 20 2a 2a 20 66 72 65 65 the. ** free
2abe0 2d 6c 69 73 74 20 75 6e 74 69 6c 20 74 68 65 20 -list until the
2abf0 70 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 73 page 'nearby' is
2ac00 20 6c 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 3d located (eMode=
2ac10 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 0a =BTALLOC_EXACT).
2ac20 20 20 20 20 2a 2a 20 6f 72 20 75 6e 74 69 6c 20 ** or until
2ac30 61 20 70 61 67 65 20 6c 65 73 73 20 74 68 61 6e a page less than
2ac40 20 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f 63 'nearby' is loc
2ac50 61 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 ated (eMode==BTA
2ac60 4c 4c 4f 43 5f 4c 54 29 0a 20 20 20 20 2a 2f 0a LLOC_LT). */.
2ac70 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 70 do {. p
2ac80 50 72 65 76 54 72 75 6e 6b 20 3d 20 70 54 72 75 PrevTrunk = pTru
2ac90 6e 6b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 nk;. if( pP
2aca0 72 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 revTrunk ){.
2acb0 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 iTrunk = get
2acc0 34 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 4byte(&pPrevTrun
2acd0 6b 2d 3e 61 44 61 74 61 5b 30 5d 29 3b 0a 20 20 k->aData[0]);.
2ace0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
2acf0 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 iTrunk = get4
2ad00 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 byte(&pPage1->aD
2ad10 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 20 20 ata[32]);.
2ad20 7d 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 }. testcase
2ad30 28 20 69 54 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 ( iTrunk==mxPage
2ad40 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 54 );. if( iT
2ad50 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b 0a 20 runk>mxPage ){.
2ad60 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
2ad70 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
2ad80 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
2ad90 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 rc = btree
2ada0 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 54 72 GetPage(pBt, iTr
2adb0 75 6e 6b 2c 20 26 70 54 72 75 6e 6b 2c 20 30 29 unk, &pTrunk, 0)
2adc0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
2add0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
2ade0 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 pTrunk = 0;.
2adf0 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
2ae00 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
2ae10 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 65 }. asse
2ae20 72 74 28 20 70 54 72 75 6e 6b 21 3d 30 20 29 3b rt( pTrunk!=0 );
2ae30 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
2ae40 54 72 75 6e 6b 2d 3e 61 44 61 74 61 21 3d 30 20 Trunk->aData!=0
2ae50 29 3b 0a 0a 20 20 20 20 20 20 6b 20 3d 20 67 65 );.. k = ge
2ae60 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e t4byte(&pTrunk->
2ae70 61 44 61 74 61 5b 34 5d 29 3b 20 2f 2a 20 23 20 aData[4]); /* #
2ae80 6f 66 20 6c 65 61 76 65 73 20 6f 6e 20 74 68 69 of leaves on thi
2ae90 73 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a s trunk page */.
2aea0 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 26 if( k==0 &
2aeb0 26 20 21 73 65 61 72 63 68 4c 69 73 74 20 29 7b & !searchList ){
2aec0 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 . /* The
2aed0 74 72 75 6e 6b 20 68 61 73 20 6e 6f 20 6c 65 61 trunk has no lea
2aee0 76 65 73 20 61 6e 64 20 74 68 65 20 6c 69 73 74 ves and the list
2aef0 20 69 73 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 is not being se
2af00 61 72 63 68 65 64 2e 20 0a 20 20 20 20 20 20 20 arched. .
2af10 20 2a 2a 20 53 6f 20 65 78 74 72 61 63 74 20 74 ** So extract t
2af20 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 74 he trunk page it
2af30 73 65 6c 66 20 61 6e 64 20 75 73 65 20 69 74 20 self and use it
2af40 61 73 20 74 68 65 20 6e 65 77 6c 79 20 0a 20 20 as the newly .
2af50 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 ** allocat
2af60 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 ed page */.
2af70 20 20 20 61 73 73 65 72 74 28 20 70 50 72 65 76 assert( pPrev
2af80 54 72 75 6e 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 Trunk==0 );.
2af90 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
2afa0 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e PagerWrite(pTrun
2afb0 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 k->pDbPage);.
2afc0 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 if( rc ){.
2afd0 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
2afe0 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
2aff0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2b000 20 20 20 2a 70 50 67 6e 6f 20 3d 20 69 54 72 75 *pPgno = iTru
2b010 6e 6b 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 nk;. memc
2b020 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 py(&pPage1->aDat
2b030 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e a[32], &pTrunk->
2b040 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
2b050 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 *ppPage =
2b060 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 pTrunk;.
2b070 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 pTrunk = 0;.
2b080 20 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f TRACE(("ALLO
2b090 43 41 54 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d CATE: %d trunk -
2b0a0 20 25 64 20 66 72 65 65 20 70 61 67 65 73 20 6c %d free pages l
2b0b0 65 66 74 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 eft\n", *pPgno,
2b0c0 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c n-1));. }el
2b0d0 73 65 20 69 66 28 20 6b 3e 28 75 33 32 29 28 70 se if( k>(u32)(p
2b0e0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 Bt->usableSize/4
2b0f0 20 2d 20 32 29 20 29 7b 0a 20 20 20 20 20 20 20 - 2) ){.
2b100 20 2f 2a 20 56 61 6c 75 65 20 6f 66 20 6b 20 69 /* Value of k i
2b110 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2e 20 s out of range.
2b120 20 44 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 Database corrup
2b130 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 tion */.
2b140 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
2b150 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
2b160 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
2b170 61 74 65 5f 70 61 67 65 3b 0a 23 69 66 6e 64 65 ate_page;.#ifnde
2b180 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
2b190 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 7d TOVACUUM. }
2b1a0 65 6c 73 65 20 69 66 28 20 73 65 61 72 63 68 4c else if( searchL
2b1b0 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 20 20 ist .
2b1c0 20 26 26 20 28 6e 65 61 72 62 79 3d 3d 69 54 72 && (nearby==iTr
2b1d0 75 6e 6b 20 7c 7c 20 28 69 54 72 75 6e 6b 3c 6e unk || (iTrunk<n
2b1e0 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d earby && eMode==
2b1f0 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 BTALLOC_LE)) .
2b200 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ){. /
2b210 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 62 65 * The list is be
2b220 69 6e 67 20 73 65 61 72 63 68 65 64 20 61 6e 64 ing searched and
2b230 20 74 68 69 73 20 74 72 75 6e 6b 20 70 61 67 65 this trunk page
2b240 20 69 73 20 74 68 65 20 70 61 67 65 0a 20 20 20 is the page.
2b250 20 20 20 20 20 2a 2a 20 74 6f 20 61 6c 6c 6f 63 ** to alloc
2b260 61 74 65 2c 20 72 65 67 61 72 64 6c 65 73 73 20 ate, regardless
2b270 6f 66 20 77 68 65 74 68 65 72 20 69 74 20 68 61 of whether it ha
2b280 73 20 6c 65 61 76 65 73 2e 0a 20 20 20 20 20 20 s leaves..
2b290 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 2a 70 50 */. *pP
2b2a0 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 gno = iTrunk;.
2b2b0 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 *ppPage =
2b2c0 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 pTrunk;.
2b2d0 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 0a searchList = 0;.
2b2e0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
2b2f0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
2b300 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
2b310 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 . if( rc
2b320 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 ){. got
2b330 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
2b340 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 age;. }.
2b350 20 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 if( k==0
2b360 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 ){. if(
2b370 20 21 70 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a !pPrevTrunk ){.
2b380 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 memc
2b390 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 py(&pPage1->aDat
2b3a0 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e a[32], &pTrunk->
2b3b0 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
2b3c0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
2b3d0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
2b3e0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2b3f0 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 e(pPrevTrunk->pD
2b400 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
2b410 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
2b420 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
2b430 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
2b440 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
2b450 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
2b460 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 memcpy(
2b470 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 &pPrevTrunk->aDa
2b480 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e ta[0], &pTrunk->
2b490 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 aData[0], 4);.
2b4a0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2b4b0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2b4c0 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b 20 /* The trunk
2b4d0 70 61 67 65 20 69 73 20 72 65 71 75 69 72 65 64 page is required
2b4e0 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 20 62 by the caller b
2b4f0 75 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 0a ut it contains .
2b500 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 6f 69 ** poi
2b510 6e 74 65 72 73 20 74 6f 20 66 72 65 65 2d 6c 69 nters to free-li
2b520 73 74 20 6c 65 61 76 65 73 2e 20 54 68 65 20 66 st leaves. The f
2b530 69 72 73 74 20 6c 65 61 66 20 62 65 63 6f 6d 65 irst leaf become
2b540 73 20 61 20 74 72 75 6e 6b 0a 20 20 20 20 20 20 s a trunk.
2b550 20 20 20 20 2a 2a 20 70 61 67 65 20 69 6e 20 74 ** page in t
2b560 68 69 73 20 63 61 73 65 2e 0a 20 20 20 20 20 20 his case..
2b570 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 */.
2b580 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 54 72 MemPage *pNewTr
2b590 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 50 unk;. P
2b5a0 67 6e 6f 20 69 4e 65 77 54 72 75 6e 6b 20 3d 20 gno iNewTrunk =
2b5b0 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b get4byte(&pTrunk
2b5c0 2d 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 20 20 ->aData[8]);.
2b5d0 20 20 20 20 20 20 20 69 66 28 20 69 4e 65 77 54 if( iNewT
2b5e0 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b 20 0a runk>mxPage ){ .
2b5f0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
2b600 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2b610 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 BKPT;.
2b620 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
2b630 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
2b640 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
2b650 74 65 73 74 63 61 73 65 28 20 69 4e 65 77 54 72 testcase( iNewTr
2b660 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 unk==mxPage );.
2b670 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 rc = bt
2b680 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 reeGetPage(pBt,
2b690 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 4e 65 77 iNewTrunk, &pNew
2b6a0 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 Trunk, 0);.
2b6b0 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
2b6c0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2b6d0 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
2b6e0 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
2b6f0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2b700 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
2b710 50 61 67 65 72 57 72 69 74 65 28 70 4e 65 77 54 PagerWrite(pNewT
2b720 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a runk->pDbPage);.
2b730 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
2b740 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
2b750 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 relea
2b760 73 65 50 61 67 65 28 70 4e 65 77 54 72 75 6e 6b sePage(pNewTrunk
2b770 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 );. g
2b780 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
2b790 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
2b7a0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d }. mem
2b7b0 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e cpy(&pNewTrunk->
2b7c0 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e aData[0], &pTrun
2b7d0 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b k->aData[0], 4);
2b7e0 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 . put4b
2b7f0 79 74 65 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e yte(&pNewTrunk->
2b800 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a aData[4], k-1);.
2b810 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
2b820 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 (&pNewTrunk->aDa
2b830 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e ta[8], &pTrunk->
2b840 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b 2d 31 29 aData[12], (k-1)
2b850 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 *4);. r
2b860 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 54 eleasePage(pNewT
2b870 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 runk);.
2b880 20 69 66 28 20 21 70 50 72 65 76 54 72 75 6e 6b if( !pPrevTrunk
2b890 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2b8a0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
2b8b0 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
2b8c0 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 pPage1->pDbPage)
2b8d0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 );.
2b8e0 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
2b8f0 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 4e 65 ->aData[32], iNe
2b900 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 wTrunk);.
2b910 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2b920 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2b930 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 72 e3PagerWrite(pPr
2b940 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 evTrunk->pDbPage
2b950 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
2b960 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
2b970 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
2b980 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
2b990 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
2b9a0 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 put4byt
2b9b0 65 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 e(&pPrevTrunk->a
2b9c0 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 54 72 75 Data[0], iNewTru
2b9d0 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d nk);. }
2b9e0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2b9f0 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 pTrunk = 0;.
2ba00 20 20 20 20 20 20 20 54 52 41 43 45 28 28 22 41 TRACE(("A
2ba10 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 72 75 6e LLOCATE: %d trun
2ba20 6b 20 2d 20 25 64 20 66 72 65 65 20 70 61 67 65 k - %d free page
2ba30 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 50 67 6e s left\n", *pPgn
2ba40 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e 64 69 66 o, n-1));.#endif
2ba50 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
2ba60 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 k>0 ){.
2ba70 2f 2a 20 45 78 74 72 61 63 74 20 61 20 6c 65 61 /* Extract a lea
2ba80 66 20 66 72 6f 6d 20 74 68 65 20 74 72 75 6e 6b f from the trunk
2ba90 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 32 20 */. u32
2baa0 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 20 20 20 closest;.
2bab0 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a 20 20 20 Pgno iPage;.
2bac0 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68 unsigned ch
2bad0 61 72 20 2a 61 44 61 74 61 20 3d 20 70 54 72 75 ar *aData = pTru
2bae0 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 nk->aData;.
2baf0 20 20 20 69 66 28 20 6e 65 61 72 62 79 3e 30 20 if( nearby>0
2bb00 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33 32 ){. u32
2bb10 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 63 6c i;. cl
2bb20 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 osest = 0;.
2bb30 20 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d if( eMode==
2bb40 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 BTALLOC_LE ){.
2bb50 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
2bb60 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 0; i<k; i++){.
2bb70 20 20 20 20 20 20 20 20 20 20 20 20 69 50 61 67 iPag
2bb80 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 44 e = get4byte(&aD
2bb90 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a 20 20 20 ata[8+i*4]);.
2bba0 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 69 if( i
2bbb0 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 29 7b 0a Page<=nearby ){.
2bbc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bbd0 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 20 20 closest = i;.
2bbe0 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
2bbf0 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ak;.
2bc00 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
2bc10 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
2bc20 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 e{. i
2bc30 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 20 20 20 nt dist;.
2bc40 20 20 20 20 20 64 69 73 74 20 3d 20 73 71 6c 69 dist = sqli
2bc50 74 65 33 41 62 73 49 6e 74 33 32 28 67 65 74 34 te3AbsInt32(get4
2bc60 62 79 74 65 28 26 61 44 61 74 61 5b 38 5d 29 20 byte(&aData[8])
2bc70 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 20 20 20 - nearby);.
2bc80 20 20 20 20 20 20 20 66 6f 72 28 69 3d 31 3b 20 for(i=1;
2bc90 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 i<k; i++){.
2bca0 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 32 20 int d2
2bcb0 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 33 = sqlite3AbsInt3
2bcc0 32 28 67 65 74 34 62 79 74 65 28 26 61 44 61 74 2(get4byte(&aDat
2bcd0 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e 65 61 72 a[8+i*4]) - near
2bce0 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 by);.
2bcf0 20 20 20 69 66 28 20 64 32 3c 64 69 73 74 20 29 if( d2<dist )
2bd00 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
2bd10 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 closest = i;.
2bd20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 d
2bd30 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 20 20 20 ist = d2;.
2bd40 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2bd50 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2bd60 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
2bd70 65 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6c 6f e{. clo
2bd80 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 sest = 0;.
2bd90 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 50 61 }.. iPa
2bda0 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 ge = get4byte(&a
2bdb0 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a 34 Data[8+closest*4
2bdc0 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 ]);. test
2bdd0 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d 78 50 case( iPage==mxP
2bde0 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 age );. i
2bdf0 66 28 20 69 50 61 67 65 3e 6d 78 50 61 67 65 20 f( iPage>mxPage
2be00 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
2be10 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
2be20 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 _BKPT;.
2be30 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 goto end_alloca
2be40 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 te_page;.
2be50 20 7d 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 }. testc
2be60 61 73 65 28 20 69 50 61 67 65 3d 3d 6d 78 50 61 ase( iPage==mxPa
2be70 67 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 ge );. if
2be80 28 20 21 73 65 61 72 63 68 4c 69 73 74 20 0a 20 ( !searchList .
2be90 20 20 20 20 20 20 20 20 7c 7c 20 28 69 50 61 67 || (iPag
2bea0 65 3d 3d 6e 65 61 72 62 79 20 7c 7c 20 28 69 50 e==nearby || (iP
2beb0 61 67 65 3c 6e 65 61 72 62 79 20 26 26 20 65 4d age<nearby && eM
2bec0 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 29 ode==BTALLOC_LE)
2bed0 29 20 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 ) . ){.
2bee0 20 20 20 20 20 20 20 20 69 6e 74 20 6e 6f 43 6f int noCo
2bef0 6e 74 65 6e 74 3b 0a 20 20 20 20 20 20 20 20 20 ntent;.
2bf00 20 2a 70 50 67 6e 6f 20 3d 20 69 50 61 67 65 3b *pPgno = iPage;
2bf10 0a 20 20 20 20 20 20 20 20 20 20 54 52 41 43 45 . TRACE
2bf20 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 (("ALLOCATE: %d
2bf30 77 61 73 20 6c 65 61 66 20 25 64 20 6f 66 20 25 was leaf %d of %
2bf40 64 20 6f 6e 20 74 72 75 6e 6b 20 25 64 22 0a 20 d on trunk %d".
2bf50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bf60 22 3a 20 25 64 20 6d 6f 72 65 20 66 72 65 65 20 ": %d more free
2bf70 70 61 67 65 73 5c 6e 22 2c 0a 20 20 20 20 20 20 pages\n",.
2bf80 20 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 6e *pPgn
2bf90 6f 2c 20 63 6c 6f 73 65 73 74 2b 31 2c 20 6b 2c o, closest+1, k,
2bfa0 20 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f 2c 20 6e pTrunk->pgno, n
2bfb0 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 -1));.
2bfc0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
2bfd0 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 rWrite(pTrunk->p
2bfe0 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
2bff0 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
2c000 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
2c010 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 ge;. if
2c020 28 20 63 6c 6f 73 65 73 74 3c 6b 2d 31 20 29 7b ( closest<k-1 ){
2c030 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d . mem
2c040 63 70 79 28 26 61 44 61 74 61 5b 38 2b 63 6c 6f cpy(&aData[8+clo
2c050 73 65 73 74 2a 34 5d 2c 20 26 61 44 61 74 61 5b sest*4], &aData[
2c060 34 2b 6b 2a 34 5d 2c 20 34 29 3b 0a 20 20 20 20 4+k*4], 4);.
2c070 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2c080 20 20 70 75 74 34 62 79 74 65 28 26 61 44 61 74 put4byte(&aDat
2c090 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 20 20 20 a[4], k-1);.
2c0a0 20 20 20 20 20 20 6e 6f 43 6f 6e 74 65 6e 74 20 noContent
2c0b0 3d 20 21 62 74 72 65 65 47 65 74 48 61 73 43 6f = !btreeGetHasCo
2c0c0 6e 74 65 6e 74 28 70 42 74 2c 20 2a 70 50 67 6e ntent(pBt, *pPgn
2c0d0 6f 29 3f 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f o)? PAGER_GET_NO
2c0e0 43 4f 4e 54 45 4e 54 20 3a 20 30 3b 0a 20 20 20 CONTENT : 0;.
2c0f0 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 rc = btre
2c100 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 2a 70 eGetPage(pBt, *p
2c110 50 67 6e 6f 2c 20 70 70 50 61 67 65 2c 20 6e 6f Pgno, ppPage, no
2c120 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 20 Content);.
2c130 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
2c140 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
2c150 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
2c160 33 50 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 3PagerWrite((*pp
2c170 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b Page)->pDbPage);
2c180 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 . if(
2c190 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2c1a0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
2c1b0 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
2c1c0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
2c1d0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a }. }.
2c1e0 20 20 20 20 20 20 20 20 20 20 73 65 61 72 63 68 search
2c1f0 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 List = 0;.
2c200 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
2c210 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
2c220 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 revTrunk);.
2c230 20 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 30 3b pPrevTrunk = 0;
2c240 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 73 65 61 . }while( sea
2c250 72 63 68 4c 69 73 74 20 29 3b 0a 20 20 7d 65 6c rchList );. }el
2c260 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 se{. /* There
2c270 20 61 72 65 20 6e 6f 20 70 61 67 65 73 20 6f 6e are no pages on
2c280 20 74 68 65 20 66 72 65 65 6c 69 73 74 2c 20 73 the freelist, s
2c290 6f 20 61 70 70 65 6e 64 20 61 20 6e 65 77 20 70 o append a new p
2c2a0 61 67 65 20 74 6f 20 74 68 65 0a 20 20 20 20 2a age to the. *
2c2b0 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 67 65 * database image
2c2c0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
2c2d0 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 65 77 20 70 61 Normally, new pa
2c2e0 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 ges allocated by
2c2f0 20 74 68 69 73 20 62 6c 6f 63 6b 20 63 61 6e 20 this block can
2c300 62 65 20 72 65 71 75 65 73 74 65 64 20 66 72 6f be requested fro
2c310 6d 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 m the. ** pag
2c320 65 72 20 6c 61 79 65 72 20 77 69 74 68 20 74 68 er layer with th
2c330 65 20 27 6e 6f 2d 63 6f 6e 74 65 6e 74 27 20 66 e 'no-content' f
2c340 6c 61 67 20 73 65 74 2e 20 54 68 69 73 20 70 72 lag set. This pr
2c350 65 76 65 6e 74 73 20 74 68 65 20 70 61 67 65 72 events the pager
2c360 0a 20 20 20 20 2a 2a 20 66 72 6f 6d 20 74 72 79 . ** from try
2c370 69 6e 67 20 74 6f 20 72 65 61 64 20 74 68 65 20 ing to read the
2c380 70 61 67 65 73 20 63 6f 6e 74 65 6e 74 20 66 72 pages content fr
2c390 6f 6d 20 64 69 73 6b 2e 20 48 6f 77 65 76 65 72 om disk. However
2c3a0 2c 20 69 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 , if the. **
2c3b0 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 current transact
2c3c0 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 79 20 ion has already
2c3d0 72 75 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 run one or more
2c3e0 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 incremental-vacu
2c3f0 75 6d 0a 20 20 20 20 2a 2a 20 73 74 65 70 73 2c um. ** steps,
2c400 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 77 then the page w
2c410 65 20 61 72 65 20 61 62 6f 75 74 20 74 6f 20 61 e are about to a
2c420 6c 6c 6f 63 61 74 65 20 6d 61 79 20 63 6f 6e 74 llocate may cont
2c430 61 69 6e 20 63 6f 6e 74 65 6e 74 0a 20 20 20 20 ain content.
2c440 2a 2a 20 74 68 61 74 20 69 73 20 72 65 71 75 69 ** that is requi
2c450 72 65 64 20 69 6e 20 74 68 65 20 65 76 65 6e 74 red in the event
2c460 20 6f 66 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 of a rollback.
2c470 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 64 6f In this case, do
2c480 0a 20 20 20 20 2a 2a 20 6e 6f 74 20 73 65 74 20 . ** not set
2c490 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 66 the no-content f
2c4a0 6c 61 67 2e 20 54 68 69 73 20 63 61 75 73 65 73 lag. This causes
2c4b0 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 6c 6f the pager to lo
2c4c0 61 64 20 61 6e 64 20 6a 6f 75 72 6e 61 6c 0a 20 ad and journal.
2c4d0 20 20 20 2a 2a 20 74 68 65 20 63 75 72 72 65 6e ** the curren
2c4e0 74 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 62 t page content b
2c4f0 65 66 6f 72 65 20 6f 76 65 72 77 72 69 74 69 6e efore overwritin
2c500 67 20 69 74 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 g it.. **.
2c510 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 ** Note that th
2c520 65 20 70 61 67 65 72 20 77 69 6c 6c 20 6e 6f 74 e pager will not
2c530 20 61 63 74 75 61 6c 6c 79 20 61 74 74 65 6d 70 actually attemp
2c540 74 20 74 6f 20 6c 6f 61 64 20 6f 72 20 6a 6f 75 t to load or jou
2c550 72 6e 61 6c 20 0a 20 20 20 20 2a 2a 20 63 6f 6e rnal . ** con
2c560 74 65 6e 74 20 66 6f 72 20 61 6e 79 20 70 61 67 tent for any pag
2c570 65 20 74 68 61 74 20 72 65 61 6c 6c 79 20 64 6f e that really do
2c580 65 73 20 6c 69 65 20 70 61 73 74 20 74 68 65 20 es lie past the
2c590 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 62 end of the datab
2c5a0 61 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 ase. ** file
2c5b0 6f 6e 20 64 69 73 6b 2e 20 53 6f 20 74 68 65 20 on disk. So the
2c5c0 65 66 66 65 63 74 73 20 6f 66 20 64 69 73 61 62 effects of disab
2c5d0 6c 69 6e 67 20 74 68 65 20 6e 6f 2d 63 6f 6e 74 ling the no-cont
2c5e0 65 6e 74 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ent optimization
2c5f0 0a 20 20 20 20 2a 2a 20 68 65 72 65 20 61 72 65 . ** here are
2c600 20 63 6f 6e 66 69 6e 65 64 20 74 6f 20 74 68 6f confined to tho
2c610 73 65 20 70 61 67 65 73 20 74 68 61 74 20 6c 69 se pages that li
2c620 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 65 6e e between the en
2c630 64 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 d of the. **
2c640 64 61 74 61 62 61 73 65 20 69 6d 61 67 65 20 61 database image a
2c650 6e 64 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 nd the end of th
2c660 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
2c670 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 . */. int
2c680 62 4e 6f 43 6f 6e 74 65 6e 74 20 3d 20 28 30 3d bNoContent = (0=
2c690 3d 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 42 74 =IfNotOmitAV(pBt
2c6a0 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 29 29 3f ->bDoTruncate))?
2c6b0 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e PAGER_GET_NOCON
2c6c0 54 45 4e 54 3a 30 3b 0a 0a 20 20 20 20 72 63 20 TENT:0;.. rc
2c6d0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
2c6e0 69 74 65 28 70 42 74 2d 3e 70 50 61 67 65 31 2d ite(pBt->pPage1-
2c6f0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 >pDbPage);. i
2c700 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
2c710 63 3b 0a 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 c;. pBt->nPag
2c720 65 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 42 74 e++;. if( pBt
2c730 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 4e 47 ->nPage==PENDING
2c740 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
2c750 29 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a ) pBt->nPage++;.
2c760 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2c770 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
2c780 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 if( pBt->aut
2c790 6f 56 61 63 75 75 6d 20 26 26 20 50 54 52 4d 41 oVacuum && PTRMA
2c7a0 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 70 42 P_ISPAGE(pBt, pB
2c7b0 74 2d 3e 6e 50 61 67 65 29 20 29 7b 0a 20 20 20 t->nPage) ){.
2c7c0 20 20 20 2f 2a 20 49 66 20 2a 70 50 67 6e 6f 20 /* If *pPgno
2c7d0 72 65 66 65 72 73 20 74 6f 20 61 20 70 6f 69 6e refers to a poin
2c7e0 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 61 6c ter-map page, al
2c7f0 6c 6f 63 61 74 65 20 74 77 6f 20 6e 65 77 20 70 locate two new p
2c800 61 67 65 73 0a 20 20 20 20 20 20 2a 2a 20 61 74 ages. ** at
2c810 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
2c820 66 69 6c 65 20 69 6e 73 74 65 61 64 20 6f 66 20 file instead of
2c830 6f 6e 65 2e 20 54 68 65 20 66 69 72 73 74 20 61 one. The first a
2c840 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 0a 20 20 llocated page.
2c850 20 20 20 20 2a 2a 20 62 65 63 6f 6d 65 73 20 61 ** becomes a
2c860 20 6e 65 77 20 70 6f 69 6e 74 65 72 2d 6d 61 70 new pointer-map
2c870 20 70 61 67 65 2c 20 74 68 65 20 73 65 63 6f 6e page, the secon
2c880 64 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 d is used by the
2c890 20 63 61 6c 6c 65 72 2e 0a 20 20 20 20 20 20 2a caller.. *
2c8a0 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 /. MemPage
2c8b0 2a 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 *pPg = 0;.
2c8c0 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 TRACE(("ALLOCATE
2c8d0 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 6f 66 : %d from end of
2c8e0 20 66 69 6c 65 20 28 70 6f 69 6e 74 65 72 2d 6d file (pointer-m
2c8f0 61 70 20 70 61 67 65 29 5c 6e 22 2c 20 70 42 74 ap page)\n", pBt
2c900 2d 3e 6e 50 61 67 65 29 29 3b 0a 20 20 20 20 20 ->nPage));.
2c910 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 50 assert( pBt->nP
2c920 61 67 65 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 age!=PENDING_BYT
2c930 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a 20 E_PAGE(pBt) );.
2c940 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 rc = btreeG
2c950 65 74 50 61 67 65 28 70 42 74 2c 20 70 42 74 2d etPage(pBt, pBt-
2c960 3e 6e 50 61 67 65 2c 20 26 70 50 67 2c 20 62 4e >nPage, &pPg, bN
2c970 6f 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 oContent);.
2c980 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2c990 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 OK ){. rc
2c9a0 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
2c9b0 72 69 74 65 28 70 50 67 2d 3e 70 44 62 50 61 67 rite(pPg->pDbPag
2c9c0 65 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 e);. rele
2c9d0 61 73 65 50 61 67 65 28 70 50 67 29 3b 0a 20 20 asePage(pPg);.
2c9e0 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
2c9f0 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
2ca00 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 pBt->nPage
2ca10 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 ++;. if( pB
2ca20 74 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 4e t->nPage==PENDIN
2ca30 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
2ca40 20 29 7b 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b ){ pBt->nPage++
2ca50 3b 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 ; }. }.#endif
2ca60 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 32 38 . put4byte(28
2ca70 20 2b 20 28 75 38 2a 29 70 42 74 2d 3e 70 50 61 + (u8*)pBt->pPa
2ca80 67 65 31 2d 3e 61 44 61 74 61 2c 20 70 42 74 2d ge1->aData, pBt-
2ca90 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 2a 70 50 >nPage);. *pP
2caa0 67 6e 6f 20 3d 20 70 42 74 2d 3e 6e 50 61 67 65 gno = pBt->nPage
2cab0 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a ;.. assert( *
2cac0 70 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 pPgno!=PENDING_B
2cad0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b YTE_PAGE(pBt) );
2cae0 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 . rc = btreeG
2caf0 65 74 50 61 67 65 28 70 42 74 2c 20 2a 70 50 67 etPage(pBt, *pPg
2cb00 6e 6f 2c 20 70 70 50 61 67 65 2c 20 62 4e 6f 43 no, ppPage, bNoC
2cb10 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 69 66 28 ontent);. if(
2cb20 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
2cb30 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2cb40 33 50 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 3PagerWrite((*pp
2cb50 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b Page)->pDbPage);
2cb60 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
2cb70 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2cb80 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
2cb90 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 age);. }.
2cba0 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 TRACE(("ALLOCATE
2cbb0 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 6f 66 : %d from end of
2cbc0 20 66 69 6c 65 5c 6e 22 2c 20 2a 70 50 67 6e 6f file\n", *pPgno
2cbd0 29 29 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 ));. }.. asser
2cbe0 74 28 20 2a 70 50 67 6e 6f 21 3d 50 45 4e 44 49 t( *pPgno!=PENDI
2cbf0 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
2cc00 29 20 29 3b 0a 0a 65 6e 64 5f 61 6c 6c 6f 63 61 ) );..end_alloca
2cc10 74 65 5f 70 61 67 65 3a 0a 20 20 72 65 6c 65 61 te_page:. relea
2cc20 73 65 50 61 67 65 28 70 54 72 75 6e 6b 29 3b 0a sePage(pTrunk);.
2cc30 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
2cc40 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 69 66 28 revTrunk);. if(
2cc50 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
2cc60 7b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 {. if( sqlite
2cc70 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 3PagerPageRefcou
2cc80 6e 74 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 nt((*ppPage)->pD
2cc90 62 50 61 67 65 29 3e 31 20 29 7b 0a 20 20 20 20 bPage)>1 ){.
2cca0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 releasePage(*p
2ccb0 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 2a 70 pPage);. *p
2ccc0 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 pPage = 0;.
2ccd0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
2cce0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
2ccf0 20 7d 0a 20 20 20 20 28 2a 70 70 50 61 67 65 29 }. (*ppPage)
2cd00 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 ->isInit = 0;.
2cd10 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 70 50 61 }else{. *ppPa
2cd20 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 61 73 ge = 0;. }. as
2cd30 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
2cd40 5f 4f 4b 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 _OK || sqlite3Pa
2cd50 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 28 gerIswriteable((
2cd60 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 61 67 *ppPage)->pDbPag
2cd70 65 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e) );. return r
2cd80 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
2cd90 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
2cda0 64 20 74 6f 20 61 64 64 20 70 61 67 65 20 69 50 d to add page iP
2cdb0 61 67 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 age to the datab
2cdc0 61 73 65 20 66 69 6c 65 20 66 72 65 65 2d 6c 69 ase file free-li
2cdd0 73 74 2e 20 0a 2a 2a 20 49 74 20 69 73 20 61 73 st. .** It is as
2cde0 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 20 70 sumed that the p
2cdf0 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 age is not alrea
2ce00 64 79 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 dy a part of the
2ce10 20 66 72 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a free-list..**.*
2ce20 2a 20 54 68 65 20 76 61 6c 75 65 20 70 61 73 73 * The value pass
2ce30 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
2ce40 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 argument to thi
2ce50 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 70 s function is op
2ce60 74 69 6f 6e 61 6c 2e 0a 2a 2a 20 49 66 20 74 68 tional..** If th
2ce70 65 20 63 61 6c 6c 65 72 20 68 61 70 70 65 6e 73 e caller happens
2ce80 20 74 6f 20 68 61 76 65 20 61 20 70 6f 69 6e 74 to have a point
2ce90 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 50 61 67 er to the MemPag
2cea0 65 20 6f 62 6a 65 63 74 20 0a 2a 2a 20 63 6f 72 e object .** cor
2ceb0 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 70 61 responding to pa
2cec0 67 65 20 69 50 61 67 65 20 68 61 6e 64 79 2c 20 ge iPage handy,
2ced0 69 74 20 6d 61 79 20 70 61 73 73 20 69 74 20 61 it may pass it a
2cee0 73 20 74 68 65 20 73 65 63 6f 6e 64 20 76 61 6c s the second val
2cef0 75 65 2e 20 0a 2a 2a 20 4f 74 68 65 72 77 69 73 ue. .** Otherwis
2cf00 65 2c 20 69 74 20 6d 61 79 20 70 61 73 73 20 4e e, it may pass N
2cf10 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 ULL..**.** If a
2cf20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d pointer to a Mem
2cf30 50 61 67 65 20 6f 62 6a 65 63 74 20 69 73 20 70 Page object is p
2cf40 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 assed as the sec
2cf50 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2c 0a 2a 2a ond argument,.**
2cf60 20 69 74 73 20 72 65 66 65 72 65 6e 63 65 20 63 its reference c
2cf70 6f 75 6e 74 20 69 73 20 6e 6f 74 20 61 6c 74 65 ount is not alte
2cf80 72 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 red by this func
2cf90 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
2cfa0 69 6e 74 20 66 72 65 65 50 61 67 65 32 28 42 74 int freePage2(Bt
2cfb0 53 68 61 72 65 64 20 2a 70 42 74 2c 20 4d 65 6d Shared *pBt, Mem
2cfc0 50 61 67 65 20 2a 70 4d 65 6d 50 61 67 65 2c 20 Page *pMemPage,
2cfd0 50 67 6e 6f 20 69 50 61 67 65 29 7b 0a 20 20 4d Pgno iPage){. M
2cfe0 65 6d 50 61 67 65 20 2a 70 54 72 75 6e 6b 20 3d emPage *pTrunk =
2cff0 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
2d000 20 20 20 2f 2a 20 46 72 65 65 2d 6c 69 73 74 20 /* Free-list
2d010 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a 20 20 trunk page */.
2d020 50 67 6e 6f 20 69 54 72 75 6e 6b 20 3d 20 30 3b Pgno iTrunk = 0;
2d030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d040 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 /* Page numb
2d050 65 72 20 6f 66 20 66 72 65 65 2d 6c 69 73 74 20 er of free-list
2d060 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 20 0a 20 trunk page */ .
2d070 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 MemPage *pPage1
2d080 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 20 = pBt->pPage1;
2d090 20 20 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 72 65 /* Local re
2d0a0 66 65 72 65 6e 63 65 20 74 6f 20 70 61 67 65 20 ference to page
2d0b0 31 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 1 */. MemPage *
2d0c0 70 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 pPage;
2d0d0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
2d0e0 67 65 20 62 65 69 6e 67 20 66 72 65 65 64 2e 20 ge being freed.
2d0f0 4d 61 79 20 62 65 20 4e 55 4c 4c 2e 20 2a 2f 0a May be NULL. */.
2d100 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
2d110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d120 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
2d130 43 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 Code */. int nF
2d140 72 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ree;
2d150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2d160 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 72 20 Initial number
2d170 6f 66 20 70 61 67 65 73 20 6f 6e 20 66 72 65 65 of pages on free
2d180 2d 6c 69 73 74 20 2a 2f 0a 0a 20 20 61 73 73 65 -list */.. asse
2d190 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2d1a0 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
2d1b0 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
2d1c0 69 50 61 67 65 3e 31 20 29 3b 0a 20 20 61 73 73 iPage>1 );. ass
2d1d0 65 72 74 28 20 21 70 4d 65 6d 50 61 67 65 20 7c ert( !pMemPage |
2d1e0 7c 20 70 4d 65 6d 50 61 67 65 2d 3e 70 67 6e 6f | pMemPage->pgno
2d1f0 3d 3d 69 50 61 67 65 20 29 3b 0a 0a 20 20 69 66 ==iPage );.. if
2d200 28 20 70 4d 65 6d 50 61 67 65 20 29 7b 0a 20 20 ( pMemPage ){.
2d210 20 20 70 50 61 67 65 20 3d 20 70 4d 65 6d 50 61 pPage = pMemPa
2d220 67 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 ge;. sqlite3P
2d230 61 67 65 72 52 65 66 28 70 50 61 67 65 2d 3e 70 agerRef(pPage->p
2d240 44 62 50 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 DbPage);. }else
2d250 7b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 62 74 {. pPage = bt
2d260 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 reePageLookup(pB
2d270 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 7d 0a 0a t, iPage);. }..
2d280 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 /* Increment t
2d290 68 65 20 66 72 65 65 20 70 61 67 65 20 63 6f 75 he free page cou
2d2a0 6e 74 20 6f 6e 20 70 50 61 67 65 31 20 2a 2f 0a nt on pPage1 */.
2d2b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
2d2c0 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 2d gerWrite(pPage1-
2d2d0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 >pDbPage);. if(
2d2e0 20 72 63 20 29 20 67 6f 74 6f 20 66 72 65 65 70 rc ) goto freep
2d2f0 61 67 65 5f 6f 75 74 3b 0a 20 20 6e 46 72 65 65 age_out;. nFree
2d300 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 = get4byte(&pPa
2d310 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b ge1->aData[36]);
2d320 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 . put4byte(&pPa
2d330 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 ge1->aData[36],
2d340 6e 46 72 65 65 2b 31 29 3b 0a 0a 20 20 69 66 28 nFree+1);.. if(
2d350 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
2d360 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
2d370 54 45 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 TE ){. /* If
2d380 74 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 the secure_delet
2d390 65 20 6f 70 74 69 6f 6e 20 69 73 20 65 6e 61 62 e option is enab
2d3a0 6c 65 64 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a led, then. **
2d3b0 20 61 6c 77 61 79 73 20 66 75 6c 6c 79 20 6f 76 always fully ov
2d3c0 65 72 77 72 69 74 65 20 64 65 6c 65 74 65 64 20 erwrite deleted
2d3d0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 information with
2d3e0 20 7a 65 72 6f 73 2e 0a 20 20 20 20 2a 2f 0a 20 zeros.. */.
2d3f0 20 20 20 69 66 28 20 28 21 70 50 61 67 65 20 26 if( (!pPage &
2d400 26 20 28 28 72 63 20 3d 20 62 74 72 65 65 47 65 & ((rc = btreeGe
2d410 74 50 61 67 65 28 70 42 74 2c 20 69 50 61 67 65 tPage(pBt, iPage
2d420 2c 20 26 70 50 61 67 65 2c 20 30 29 29 21 3d 30 , &pPage, 0))!=0
2d430 29 20 29 0a 20 20 20 20 20 7c 7c 20 20 20 20 20 ) ). ||
2d440 20 20 20 20 20 20 20 28 28 72 63 20 3d 20 73 71 ((rc = sq
2d450 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
2d460 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 29 pPage->pDbPage))
2d470 21 3d 30 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 !=0). ){.
2d480 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f goto freepage_
2d490 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d out;. }. m
2d4a0 65 6d 73 65 74 28 70 50 61 67 65 2d 3e 61 44 61 emset(pPage->aDa
2d4b0 74 61 2c 20 30 2c 20 70 50 61 67 65 2d 3e 70 42 ta, 0, pPage->pB
2d4c0 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 t->pageSize);.
2d4d0 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64 }.. /* If the d
2d4e0 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 73 atabase supports
2d4f0 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 20 77 72 auto-vacuum, wr
2d500 69 74 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 ite an entry in
2d510 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a the pointer-map.
2d520 20 20 2a 2a 20 74 6f 20 69 6e 64 69 63 61 74 65 ** to indicate
2d530 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 69 that the page i
2d540 73 20 66 72 65 65 2e 0a 20 20 2a 2f 0a 20 20 69 s free.. */. i
2d550 66 28 20 49 53 41 55 54 4f 56 41 43 55 55 4d 20 f( ISAUTOVACUUM
2d560 29 7b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 ){. ptrmapPut
2d570 28 70 42 74 2c 20 69 50 61 67 65 2c 20 50 54 52 (pBt, iPage, PTR
2d580 4d 41 50 5f 46 52 45 45 50 41 47 45 2c 20 30 2c MAP_FREEPAGE, 0,
2d590 20 26 72 63 29 3b 0a 20 20 20 20 69 66 28 20 72 &rc);. if( r
2d5a0 63 20 29 20 67 6f 74 6f 20 66 72 65 65 70 61 67 c ) goto freepag
2d5b0 65 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a e_out;. }.. /*
2d5c0 20 4e 6f 77 20 6d 61 6e 69 70 75 6c 61 74 65 20 Now manipulate
2d5d0 74 68 65 20 61 63 74 75 61 6c 20 64 61 74 61 62 the actual datab
2d5e0 61 73 65 20 66 72 65 65 2d 6c 69 73 74 20 73 74 ase free-list st
2d5f0 72 75 63 74 75 72 65 2e 20 54 68 65 72 65 20 61 ructure. There a
2d600 72 65 20 74 77 6f 0a 20 20 2a 2a 20 70 6f 73 73 re two. ** poss
2d610 69 62 69 6c 69 74 69 65 73 2e 20 49 66 20 74 68 ibilities. If th
2d620 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 63 e free-list is c
2d630 75 72 72 65 6e 74 6c 79 20 65 6d 70 74 79 2c 20 urrently empty,
2d640 6f 72 20 69 66 20 74 68 65 20 66 69 72 73 74 0a or if the first.
2d650 20 20 2a 2a 20 74 72 75 6e 6b 20 70 61 67 65 20 ** trunk page
2d660 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 in the free-list
2d670 20 69 73 20 66 75 6c 6c 2c 20 74 68 65 6e 20 74 is full, then t
2d680 68 69 73 20 70 61 67 65 20 77 69 6c 6c 20 62 65 his page will be
2d690 63 6f 6d 65 20 61 0a 20 20 2a 2a 20 6e 65 77 20 come a. ** new
2d6a0 66 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 free-list trunk
2d6b0 70 61 67 65 2e 20 4f 74 68 65 72 77 69 73 65 2c page. Otherwise,
2d6c0 20 69 74 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 it will become
2d6d0 61 20 6c 65 61 66 20 6f 66 20 74 68 65 0a 20 20 a leaf of the.
2d6e0 2a 2a 20 66 69 72 73 74 20 74 72 75 6e 6b 20 70 ** first trunk p
2d6f0 61 67 65 20 69 6e 20 74 68 65 20 63 75 72 72 65 age in the curre
2d700 6e 74 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 68 nt free-list. Th
2d710 69 73 20 62 6c 6f 63 6b 20 74 65 73 74 73 20 69 is block tests i
2d720 66 20 69 74 0a 20 20 2a 2a 20 69 73 20 70 6f 73 f it. ** is pos
2d730 73 69 62 6c 65 20 74 6f 20 61 64 64 20 74 68 65 sible to add the
2d740 20 70 61 67 65 20 61 73 20 61 20 6e 65 77 20 66 page as a new f
2d750 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 2e 0a 20 ree-list leaf..
2d760 20 2a 2f 0a 20 20 69 66 28 20 6e 46 72 65 65 21 */. if( nFree!
2d770 3d 30 20 29 7b 0a 20 20 20 20 75 33 32 20 6e 4c =0 ){. u32 nL
2d780 65 61 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 eaf;
2d790 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 20 6e /* Initial n
2d7a0 75 6d 62 65 72 20 6f 66 20 6c 65 61 66 20 63 65 umber of leaf ce
2d7b0 6c 6c 73 20 6f 6e 20 74 72 75 6e 6b 20 70 61 67 lls on trunk pag
2d7c0 65 20 2a 2f 0a 0a 20 20 20 20 69 54 72 75 6e 6b e */.. iTrunk
2d7d0 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 = get4byte(&pPa
2d7e0 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 29 3b ge1->aData[32]);
2d7f0 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 . rc = btreeG
2d800 65 74 50 61 67 65 28 70 42 74 2c 20 69 54 72 75 etPage(pBt, iTru
2d810 6e 6b 2c 20 26 70 54 72 75 6e 6b 2c 20 30 29 3b nk, &pTrunk, 0);
2d820 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
2d830 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2d840 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 goto freepage_ou
2d850 74 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e 4c t;. }.. nL
2d860 65 61 66 20 3d 20 67 65 74 34 62 79 74 65 28 26 eaf = get4byte(&
2d870 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d pTrunk->aData[4]
2d880 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
2d890 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3e 33 Bt->usableSize>3
2d8a0 32 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 4c 65 2 );. if( nLe
2d8b0 61 66 20 3e 20 28 75 33 32 29 70 42 74 2d 3e 75 af > (u32)pBt->u
2d8c0 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 20 sableSize/4 - 2
2d8d0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
2d8e0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2d8f0 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 T;. goto fr
2d900 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 eepage_out;.
2d910 7d 0a 20 20 20 20 69 66 28 20 6e 4c 65 61 66 20 }. if( nLeaf
2d920 3c 20 28 75 33 32 29 70 42 74 2d 3e 75 73 61 62 < (u32)pBt->usab
2d930 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 29 7b 0a leSize/4 - 8 ){.
2d940 20 20 20 20 20 20 2f 2a 20 49 6e 20 74 68 69 73 /* In this
2d950 20 63 61 73 65 20 74 68 65 72 65 20 69 73 20 72 case there is r
2d960 6f 6f 6d 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b oom on the trunk
2d970 20 70 61 67 65 20 74 6f 20 69 6e 73 65 72 74 20 page to insert
2d980 74 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 2a the page. *
2d990 2a 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 * being freed as
2d9a0 20 61 20 6e 65 77 20 6c 65 61 66 2e 0a 20 20 20 a new leaf..
2d9b0 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4e **. ** N
2d9c0 6f 74 65 20 74 68 61 74 20 74 68 65 20 74 72 75 ote that the tru
2d9d0 6e 6b 20 70 61 67 65 20 69 73 20 6e 6f 74 20 72 nk page is not r
2d9e0 65 61 6c 6c 79 20 66 75 6c 6c 20 75 6e 74 69 6c eally full until
2d9f0 20 69 74 20 63 6f 6e 74 61 69 6e 73 0a 20 20 20 it contains.
2da00 20 20 20 2a 2a 20 75 73 61 62 6c 65 53 69 7a 65 ** usableSize
2da10 2f 34 20 2d 20 32 20 65 6e 74 72 69 65 73 2c 20 /4 - 2 entries,
2da20 6e 6f 74 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 not usableSize/4
2da30 20 2d 20 38 20 65 6e 74 72 69 65 73 20 61 73 20 - 8 entries as
2da40 77 65 20 68 61 76 65 0a 20 20 20 20 20 20 2a 2a we have. **
2da50 20 63 6f 64 65 64 2e 20 20 42 75 74 20 64 75 65 coded. But due
2da60 20 74 6f 20 61 20 63 6f 64 69 6e 67 20 65 72 72 to a coding err
2da70 6f 72 20 69 6e 20 76 65 72 73 69 6f 6e 73 20 6f or in versions o
2da80 66 20 53 51 4c 69 74 65 20 70 72 69 6f 72 20 74 f SQLite prior t
2da90 6f 0a 20 20 20 20 20 20 2a 2a 20 33 2e 36 2e 30 o. ** 3.6.0
2daa0 2c 20 64 61 74 61 62 61 73 65 73 20 77 69 74 68 , databases with
2dab0 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 freelist trunk
2dac0 70 61 67 65 73 20 68 6f 6c 64 69 6e 67 20 6d 6f pages holding mo
2dad0 72 65 20 74 68 61 6e 0a 20 20 20 20 20 20 2a 2a re than. **
2dae0 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 usableSize/4 -
2daf0 38 20 65 6e 74 72 69 65 73 20 77 69 6c 6c 20 62 8 entries will b
2db00 65 20 72 65 70 6f 72 74 65 64 20 61 73 20 63 6f e reported as co
2db10 72 72 75 70 74 2e 20 20 49 6e 20 6f 72 64 65 72 rrupt. In order
2db20 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 6d 61 69 . ** to mai
2db30 6e 74 61 69 6e 20 62 61 63 6b 77 61 72 64 73 20 ntain backwards
2db40 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 compatibility wi
2db50 74 68 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e th older version
2db60 73 20 6f 66 20 53 51 4c 69 74 65 2c 0a 20 20 20 s of SQLite,.
2db70 20 20 20 2a 2a 20 77 65 20 77 69 6c 6c 20 63 6f ** we will co
2db80 6e 74 69 6e 75 65 20 74 6f 20 72 65 73 74 72 69 ntinue to restri
2db90 63 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 ct the number of
2dba0 20 65 6e 74 72 69 65 73 20 74 6f 20 75 73 61 62 entries to usab
2dbb0 6c 65 53 69 7a 65 2f 34 20 2d 20 38 0a 20 20 20 leSize/4 - 8.
2dbc0 20 20 20 2a 2a 20 66 6f 72 20 6e 6f 77 2e 20 20 ** for now.
2dbd0 41 74 20 73 6f 6d 65 20 70 6f 69 6e 74 20 69 6e At some point in
2dbe0 20 74 68 65 20 66 75 74 75 72 65 20 28 6f 6e 63 the future (onc
2dbf0 65 20 65 76 65 72 79 6f 6e 65 20 68 61 73 20 75 e everyone has u
2dc00 70 67 72 61 64 65 64 0a 20 20 20 20 20 20 2a 2a pgraded. **
2dc10 20 74 6f 20 33 2e 36 2e 30 20 6f 72 20 6c 61 74 to 3.6.0 or lat
2dc20 65 72 29 20 77 65 20 73 68 6f 75 6c 64 20 63 6f er) we should co
2dc30 6e 73 69 64 65 72 20 66 69 78 69 6e 67 20 74 68 nsider fixing th
2dc40 65 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 62 e conditional ab
2dc50 6f 76 65 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 ove. ** to
2dc60 72 65 61 64 20 22 75 73 61 62 6c 65 53 69 7a 65 read "usableSize
2dc70 2f 34 2d 32 22 20 69 6e 73 74 65 61 64 20 6f 66 /4-2" instead of
2dc80 20 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d 38 "usableSize/4-8
2dc90 22 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 ".. */.
2dca0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
2dcb0 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d gerWrite(pTrunk-
2dcc0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
2dcd0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2dce0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 75 OK ){. pu
2dcf0 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e t4byte(&pTrunk->
2dd00 61 44 61 74 61 5b 34 5d 2c 20 6e 4c 65 61 66 2b aData[4], nLeaf+
2dd10 31 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 34 1);. put4
2dd20 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 byte(&pTrunk->aD
2dd30 61 74 61 5b 38 2b 6e 4c 65 61 66 2a 34 5d 2c 20 ata[8+nLeaf*4],
2dd40 69 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 iPage);.
2dd50 69 66 28 20 70 50 61 67 65 20 26 26 20 28 70 42 if( pPage && (pB
2dd60 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
2dd70 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 S_SECURE_DELETE)
2dd80 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
2dd90 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e sqlite3PagerDon
2dda0 74 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 tWrite(pPage->pD
2ddb0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
2ddc0 7d 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 }. rc = b
2ddd0 74 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 6e treeSetHasConten
2dde0 74 28 70 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 t(pBt, iPage);.
2ddf0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 54 52 41 }. TRA
2de00 43 45 28 28 22 46 52 45 45 2d 50 41 47 45 3a 20 CE(("FREE-PAGE:
2de10 25 64 20 6c 65 61 66 20 6f 6e 20 74 72 75 6e 6b %d leaf on trunk
2de20 20 70 61 67 65 20 25 64 5c 6e 22 2c 70 50 61 67 page %d\n",pPag
2de30 65 2d 3e 70 67 6e 6f 2c 70 54 72 75 6e 6b 2d 3e e->pgno,pTrunk->
2de40 70 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 67 6f pgno));. go
2de50 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b to freepage_out;
2de60 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
2de70 20 49 66 20 63 6f 6e 74 72 6f 6c 20 66 6c 6f 77 If control flow
2de80 73 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c s to this point,
2de90 20 74 68 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 then it was not
2dea0 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 64 64 possible to add
2deb0 20 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 the. ** the pa
2dec0 67 65 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 ge being freed a
2ded0 73 20 61 20 6c 65 61 66 20 70 61 67 65 20 6f 66 s a leaf page of
2dee0 20 74 68 65 20 66 69 72 73 74 20 74 72 75 6e 6b the first trunk
2def0 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 in the free-lis
2df00 74 2e 0a 20 20 2a 2a 20 50 6f 73 73 69 62 6c 79 t.. ** Possibly
2df10 20 62 65 63 61 75 73 65 20 74 68 65 20 66 72 65 because the fre
2df20 65 2d 6c 69 73 74 20 69 73 20 65 6d 70 74 79 2c e-list is empty,
2df30 20 6f 72 20 70 6f 73 73 69 62 6c 79 20 62 65 63 or possibly bec
2df40 61 75 73 65 20 74 68 65 20 0a 20 20 2a 2a 20 66 ause the . ** f
2df50 69 72 73 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 irst trunk in th
2df60 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 e free-list is f
2df70 75 6c 6c 2e 20 45 69 74 68 65 72 20 77 61 79 2c ull. Either way,
2df80 20 74 68 65 20 70 61 67 65 20 62 65 69 6e 67 20 the page being
2df90 66 72 65 65 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 freed. ** will
2dfa0 62 65 63 6f 6d 65 20 74 68 65 20 6e 65 77 20 66 become the new f
2dfb0 69 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 irst trunk page
2dfc0 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 in the free-list
2dfd0 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 .. */. if( pPa
2dfe0 67 65 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f ge==0 && SQLITE_
2dff0 4f 4b 21 3d 28 72 63 20 3d 20 62 74 72 65 65 47 OK!=(rc = btreeG
2e000 65 74 50 61 67 65 28 70 42 74 2c 20 69 50 61 67 etPage(pBt, iPag
2e010 65 2c 20 26 70 50 61 67 65 2c 20 30 29 29 20 29 e, &pPage, 0)) )
2e020 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 {. goto freep
2e030 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 72 age_out;. }. r
2e040 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2e050 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 Write(pPage->pDb
2e060 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 Page);. if( rc!
2e070 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2e080 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f goto freepage_
2e090 6f 75 74 3b 0a 20 20 7d 0a 20 20 70 75 74 34 62 out;. }. put4b
2e0a0 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 yte(pPage->aData
2e0b0 2c 20 69 54 72 75 6e 6b 29 3b 0a 20 20 70 75 74 , iTrunk);. put
2e0c0 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 4byte(&pPage->aD
2e0d0 61 74 61 5b 34 5d 2c 20 30 29 3b 0a 20 20 70 75 ata[4], 0);. pu
2e0e0 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
2e0f0 61 44 61 74 61 5b 33 32 5d 2c 20 69 50 61 67 65 aData[32], iPage
2e100 29 3b 0a 20 20 54 52 41 43 45 28 28 22 46 52 45 );. TRACE(("FRE
2e110 45 2d 50 41 47 45 3a 20 25 64 20 6e 65 77 20 74 E-PAGE: %d new t
2e120 72 75 6e 6b 20 70 61 67 65 20 72 65 70 6c 61 63 runk page replac
2e130 69 6e 67 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 ing %d\n", pPage
2e140 2d 3e 70 67 6e 6f 2c 20 69 54 72 75 6e 6b 29 29 ->pgno, iTrunk))
2e150 3b 0a 0a 66 72 65 65 70 61 67 65 5f 6f 75 74 3a ;..freepage_out:
2e160 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a . if( pPage ){.
2e170 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 pPage->isIni
2e180 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 6c t = 0;. }. rel
2e190 65 61 73 65 50 61 67 65 28 70 50 61 67 65 29 3b easePage(pPage);
2e1a0 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 . releasePage(p
2e1b0 54 72 75 6e 6b 29 3b 0a 20 20 72 65 74 75 72 6e Trunk);. return
2e1c0 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f rc;.}.static vo
2e1d0 69 64 20 66 72 65 65 50 61 67 65 28 4d 65 6d 50 id freePage(MemP
2e1e0 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 age *pPage, int
2e1f0 2a 70 52 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 *pRC){. if( (*p
2e200 52 43 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 RC)==SQLITE_OK )
2e210 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 66 72 65 {. *pRC = fre
2e220 65 50 61 67 65 32 28 70 50 61 67 65 2d 3e 70 42 ePage2(pPage->pB
2e230 74 2c 20 70 50 61 67 65 2c 20 70 50 61 67 65 2d t, pPage, pPage-
2e240 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f >pgno);. }.}../
2e250 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 6f 76 *.** Free any ov
2e260 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 73 73 erflow pages ass
2e270 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
2e280 20 67 69 76 65 6e 20 43 65 6c 6c 2e 20 20 57 72 given Cell. Wr
2e290 69 74 65 20 74 68 65 0a 2a 2a 20 6c 6f 63 61 6c ite the.** local
2e2a0 20 43 65 6c 6c 20 73 69 7a 65 20 28 74 68 65 20 Cell size (the
2e2b0 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
2e2c0 6f 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 on the original
2e2d0 70 61 67 65 2c 20 6f 6d 69 74 74 69 6e 67 0a 2a page, omitting.*
2e2e0 2a 20 6f 76 65 72 66 6c 6f 77 29 20 69 6e 74 6f * overflow) into
2e2f0 20 2a 70 6e 53 69 7a 65 2e 0a 2a 2f 0a 73 74 61 *pnSize..*/.sta
2e300 74 69 63 20 69 6e 74 20 63 6c 65 61 72 43 65 6c tic int clearCel
2e310 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 l(. MemPage *pP
2e320 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a age, /*
2e330 20 54 68 65 20 70 61 67 65 20 74 68 61 74 20 63 The page that c
2e340 6f 6e 74 61 69 6e 73 20 74 68 65 20 43 65 6c 6c ontains the Cell
2e350 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 */. unsigned c
2e360 68 61 72 20 2a 70 43 65 6c 6c 2c 20 20 20 20 2f har *pCell, /
2e370 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 * First byte of
2e380 74 68 65 20 43 65 6c 6c 20 2a 2f 0a 20 20 75 31 the Cell */. u1
2e390 36 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 6 *pnSize
2e3a0 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 /* Write
2e3b0 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
2e3c0 43 65 6c 6c 20 68 65 72 65 20 2a 2f 0a 29 7b 0a Cell here */.){.
2e3d0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
2e3e0 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
2e3f0 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 CellInfo info;.
2e400 20 50 67 6e 6f 20 6f 76 66 6c 50 67 6e 6f 3b 0a Pgno ovflPgno;.
2e410 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
2e420 6e 4f 76 66 6c 3b 0a 20 20 75 33 32 20 6f 76 66 nOvfl;. u32 ovf
2e430 6c 50 61 67 65 53 69 7a 65 3b 0a 0a 20 20 61 73 lPageSize;.. as
2e440 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
2e450 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
2e460 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
2e470 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
2e480 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c tr(pPage, pCell,
2e490 20 26 69 6e 66 6f 29 3b 0a 20 20 2a 70 6e 53 69 &info);. *pnSi
2e4a0 7a 65 20 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 3b ze = info.nSize;
2e4b0 0a 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 65 . if( info.iOve
2e4c0 72 66 6c 6f 77 3d 3d 30 20 29 7b 0a 20 20 20 20 rflow==0 ){.
2e4d0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
2e4e0 3b 20 20 2f 2a 20 4e 6f 20 6f 76 65 72 66 6c 6f ; /* No overflo
2e4f0 77 20 70 61 67 65 73 2e 20 52 65 74 75 72 6e 20 w pages. Return
2e500 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e without doing an
2e510 79 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 0a 20 20 ything */. }.
2e520 69 66 28 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e 69 if( pCell+info.i
2e530 4f 76 65 72 66 6c 6f 77 2b 33 20 3e 20 70 50 61 Overflow+3 > pPa
2e540 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d ge->aData+pPage-
2e550 3e 6d 61 73 6b 50 61 67 65 20 29 7b 0a 20 20 20 >maskPage ){.
2e560 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
2e570 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 20 2f 2a ORRUPT_BKPT; /*
2e580 20 43 65 6c 6c 20 65 78 74 65 6e 64 73 20 70 61 Cell extends pa
2e590 73 74 20 65 6e 64 20 6f 66 20 70 61 67 65 20 2a st end of page *
2e5a0 2f 0a 20 20 7d 0a 20 20 6f 76 66 6c 50 67 6e 6f /. }. ovflPgno
2e5b0 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 43 65 = get4byte(&pCe
2e5c0 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f ll[info.iOverflo
2e5d0 77 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 w]);. assert( p
2e5e0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3e Bt->usableSize >
2e5f0 20 34 20 29 3b 0a 20 20 6f 76 66 6c 50 61 67 65 4 );. ovflPage
2e600 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 Size = pBt->usab
2e610 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 6e 4f leSize - 4;. nO
2e620 76 66 6c 20 3d 20 28 69 6e 66 6f 2e 6e 50 61 79 vfl = (info.nPay
2e630 6c 6f 61 64 20 2d 20 69 6e 66 6f 2e 6e 4c 6f 63 load - info.nLoc
2e640 61 6c 20 2b 20 6f 76 66 6c 50 61 67 65 53 69 7a al + ovflPageSiz
2e650 65 20 2d 20 31 29 2f 6f 76 66 6c 50 61 67 65 53 e - 1)/ovflPageS
2e660 69 7a 65 3b 0a 20 20 61 73 73 65 72 74 28 20 6f ize;. assert( o
2e670 76 66 6c 50 67 6e 6f 3d 3d 30 20 7c 7c 20 6e 4f vflPgno==0 || nO
2e680 76 66 6c 3e 30 20 29 3b 0a 20 20 77 68 69 6c 65 vfl>0 );. while
2e690 28 20 6e 4f 76 66 6c 2d 2d 20 29 7b 0a 20 20 20 ( nOvfl-- ){.
2e6a0 20 50 67 6e 6f 20 69 4e 65 78 74 20 3d 20 30 3b Pgno iNext = 0;
2e6b0 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f . MemPage *pO
2e6c0 76 66 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 vfl = 0;. if(
2e6d0 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 7c 7c 20 6f ovflPgno<2 || o
2e6e0 76 66 6c 50 67 6e 6f 3e 62 74 72 65 65 50 61 67 vflPgno>btreePag
2e6f0 65 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 ecount(pBt) ){.
2e700 20 20 20 20 20 2f 2a 20 30 20 69 73 20 6e 6f 74 /* 0 is not
2e710 20 61 20 6c 65 67 61 6c 20 70 61 67 65 20 6e 75 a legal page nu
2e720 6d 62 65 72 20 61 6e 64 20 70 61 67 65 20 31 20 mber and page 1
2e730 63 61 6e 6e 6f 74 20 62 65 20 61 6e 20 0a 20 20 cannot be an .
2e740 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 ** overflow
2e750 70 61 67 65 2e 20 54 68 65 72 65 66 6f 72 65 20 page. Therefore
2e760 69 66 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 6f 72 if ovflPgno<2 or
2e770 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
2e780 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 the . ** f
2e790 69 6c 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ile the database
2e7a0 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 74 must be corrupt
2e7b0 2e 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 . */. retur
2e7c0 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
2e7d0 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 _BKPT;. }.
2e7e0 20 69 66 28 20 6e 4f 76 66 6c 20 29 7b 0a 20 20 if( nOvfl ){.
2e7f0 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 rc = getOver
2e800 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6f 76 flowPage(pBt, ov
2e810 66 6c 50 67 6e 6f 2c 20 26 70 4f 76 66 6c 2c 20 flPgno, &pOvfl,
2e820 26 69 4e 65 78 74 29 3b 0a 20 20 20 20 20 20 69 &iNext);. i
2e830 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
2e840 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 c;. }.. if
2e850 28 20 28 20 70 4f 76 66 6c 20 7c 7c 20 28 28 70 ( ( pOvfl || ((p
2e860 4f 76 66 6c 20 3d 20 62 74 72 65 65 50 61 67 65 Ovfl = btreePage
2e870 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 6f 76 66 6c Lookup(pBt, ovfl
2e880 50 67 6e 6f 29 29 21 3d 30 29 20 29 0a 20 20 20 Pgno))!=0) ).
2e890 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 && sqlite3Page
2e8a0 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 4f rPageRefcount(pO
2e8b0 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 21 3d 31 vfl->pDbPage)!=1
2e8c0 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
2e8d0 20 54 68 65 72 65 20 69 73 20 6e 6f 20 72 65 61 There is no rea
2e8e0 73 6f 6e 20 61 6e 79 20 63 75 72 73 6f 72 20 73 son any cursor s
2e8f0 68 6f 75 6c 64 20 68 61 76 65 20 61 6e 20 6f 75 hould have an ou
2e900 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 tstanding refere
2e910 6e 63 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f nce . ** to
2e920 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
2e930 65 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 61 e belonging to a
2e940 20 63 65 6c 6c 20 74 68 61 74 20 69 73 20 62 65 cell that is be
2e950 69 6e 67 20 64 65 6c 65 74 65 64 2f 75 70 64 61 ing deleted/upda
2e960 74 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 53 6f ted.. ** So
2e970 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 if there exists
2e980 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 more than one r
2e990 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 69 73 eference to this
2e9a0 20 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 0a page, then it .
2e9b0 20 20 20 20 20 20 2a 2a 20 6d 75 73 74 20 6e 6f ** must no
2e9c0 74 20 72 65 61 6c 6c 79 20 62 65 20 61 6e 20 6f t really be an o
2e9d0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 61 6e 64 verflow page and
2e9e0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 the database mu
2e9f0 73 74 20 62 65 20 63 6f 72 72 75 70 74 2e 20 0a st be corrupt. .
2ea00 20 20 20 20 20 20 2a 2a 20 49 74 20 69 73 20 68 ** It is h
2ea10 65 6c 70 66 75 6c 20 74 6f 20 64 65 74 65 63 74 elpful to detect
2ea20 20 74 68 69 73 20 62 65 66 6f 72 65 20 63 61 6c this before cal
2ea30 6c 69 6e 67 20 66 72 65 65 50 61 67 65 32 28 29 ling freePage2()
2ea40 2c 20 61 73 20 0a 20 20 20 20 20 20 2a 2a 20 66 , as . ** f
2ea50 72 65 65 50 61 67 65 32 28 29 20 6d 61 79 20 7a reePage2() may z
2ea60 65 72 6f 20 74 68 65 20 70 61 67 65 20 63 6f 6e ero the page con
2ea70 74 65 6e 74 73 20 69 66 20 73 65 63 75 72 65 2d tents if secure-
2ea80 64 65 6c 65 74 65 20 6d 6f 64 65 20 69 73 0a 20 delete mode is.
2ea90 20 20 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e ** enabled.
2eaa0 20 49 66 20 74 68 69 73 20 27 6f 76 65 72 66 6c If this 'overfl
2eab0 6f 77 27 20 70 61 67 65 20 68 61 70 70 65 6e 73 ow' page happens
2eac0 20 74 6f 20 62 65 20 61 20 70 61 67 65 20 74 68 to be a page th
2ead0 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 at the. **
2eae0 63 61 6c 6c 65 72 20 69 73 20 69 74 65 72 61 74 caller is iterat
2eaf0 69 6e 67 20 74 68 72 6f 75 67 68 20 6f 72 20 75 ing through or u
2eb00 73 69 6e 67 20 69 6e 20 73 6f 6d 65 20 6f 74 68 sing in some oth
2eb10 65 72 20 77 61 79 2c 20 74 68 69 73 0a 20 20 20 er way, this.
2eb20 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 70 72 6f ** can be pro
2eb30 62 6c 65 6d 61 74 69 63 2e 0a 20 20 20 20 20 20 blematic..
2eb40 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 */. rc = SQ
2eb50 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2eb60 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 T;. }else{.
2eb70 20 20 20 20 72 63 20 3d 20 66 72 65 65 50 61 67 rc = freePag
2eb80 65 32 28 70 42 74 2c 20 70 4f 76 66 6c 2c 20 6f e2(pBt, pOvfl, o
2eb90 76 66 6c 50 67 6e 6f 29 3b 0a 20 20 20 20 7d 0a vflPgno);. }.
2eba0 0a 20 20 20 20 69 66 28 20 70 4f 76 66 6c 20 29 . if( pOvfl )
2ebb0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
2ebc0 61 67 65 72 55 6e 72 65 66 28 70 4f 76 66 6c 2d agerUnref(pOvfl-
2ebd0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 7d >pDbPage);. }
2ebe0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
2ebf0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 6f 76 66 turn rc;. ovf
2ec00 6c 50 67 6e 6f 20 3d 20 69 4e 65 78 74 3b 0a 20 lPgno = iNext;.
2ec10 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
2ec20 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
2ec30 43 72 65 61 74 65 20 74 68 65 20 62 79 74 65 20 Create the byte
2ec40 73 65 71 75 65 6e 63 65 20 75 73 65 64 20 74 6f sequence used to
2ec50 20 72 65 70 72 65 73 65 6e 74 20 61 20 63 65 6c represent a cel
2ec60 6c 20 6f 6e 20 70 61 67 65 20 70 50 61 67 65 0a l on page pPage.
2ec70 2a 2a 20 61 6e 64 20 77 72 69 74 65 20 74 68 61 ** and write tha
2ec80 74 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 t byte sequence
2ec90 69 6e 74 6f 20 70 43 65 6c 6c 5b 5d 2e 20 20 4f into pCell[]. O
2eca0 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 verflow pages ar
2ecb0 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 e.** allocated a
2ecc0 6e 64 20 66 69 6c 6c 65 64 20 69 6e 20 61 73 20 nd filled in as
2ecd0 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 65 20 necessary. The
2ece0 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 calling procedur
2ecf0 65 0a 2a 2a 20 69 73 20 72 65 73 70 6f 6e 73 69 e.** is responsi
2ed00 62 6c 65 20 66 6f 72 20 6d 61 6b 69 6e 67 20 73 ble for making s
2ed10 75 72 65 20 73 75 66 66 69 63 69 65 6e 74 20 73 ure sufficient s
2ed20 70 61 63 65 20 68 61 73 20 62 65 65 6e 20 61 6c pace has been al
2ed30 6c 6f 63 61 74 65 64 0a 2a 2a 20 66 6f 72 20 70 located.** for p
2ed40 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 4e 6f Cell[]..**.** No
2ed50 74 65 20 74 68 61 74 20 70 43 65 6c 6c 20 64 6f te that pCell do
2ed60 65 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 es not necessary
2ed70 20 6e 65 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 need to point t
2ed80 6f 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 61 o the pPage->aDa
2ed90 74 61 0a 2a 2a 20 61 72 65 61 2e 20 20 70 43 65 ta.** area. pCe
2eda0 6c 6c 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 ll might point t
2edb0 6f 20 73 6f 6d 65 20 74 65 6d 70 6f 72 61 72 79 o some temporary
2edc0 20 73 74 6f 72 61 67 65 2e 20 20 54 68 65 20 63 storage. The c
2edd0 65 6c 6c 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 63 ell will.** be c
2ede0 6f 6e 73 74 72 75 63 74 65 64 20 69 6e 20 74 68 onstructed in th
2edf0 69 73 20 74 65 6d 70 6f 72 61 72 79 20 61 72 65 is temporary are
2ee00 61 20 74 68 65 6e 20 63 6f 70 69 65 64 20 69 6e a then copied in
2ee10 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 0a to pPage->aData.
2ee20 2a 2a 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 61 ** later..*/.sta
2ee30 74 69 63 20 69 6e 74 20 66 69 6c 6c 49 6e 43 65 tic int fillInCe
2ee40 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 ll(. MemPage *p
2ee50 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 Page,
2ee60 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 /* The page
2ee70 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
2ee80 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 he cell */. uns
2ee90 69 67 6e 65 64 20 63 68 61 72 20 2a 70 43 65 6c igned char *pCel
2eea0 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 l, /* C
2eeb0 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 omplete text of
2eec0 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 63 6f the cell */. co
2eed0 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 2c 20 nst void *pKey,
2eee0 69 36 34 20 6e 4b 65 79 2c 20 20 20 20 2f 2a 20 i64 nKey, /*
2eef0 54 68 65 20 6b 65 79 20 2a 2f 0a 20 20 63 6f 6e The key */. con
2ef00 73 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 69 st void *pData,i
2ef10 6e 74 20 6e 44 61 74 61 2c 20 20 20 2f 2a 20 54 nt nData, /* T
2ef20 68 65 20 64 61 74 61 20 2a 2f 0a 20 20 69 6e 74 he data */. int
2ef30 20 6e 5a 65 72 6f 2c 20 20 20 20 20 20 20 20 20 nZero,
2ef40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
2ef50 78 74 72 61 20 7a 65 72 6f 20 62 79 74 65 73 20 xtra zero bytes
2ef60 74 6f 20 61 70 70 65 6e 64 20 74 6f 20 70 44 61 to append to pDa
2ef70 74 61 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 53 ta */. int *pnS
2ef80 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 20 ize
2ef90 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 /* Write
2efa0 63 65 6c 6c 20 73 69 7a 65 20 68 65 72 65 20 2a cell size here *
2efb0 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 50 61 79 6c /.){. int nPayl
2efc0 6f 61 64 3b 0a 20 20 63 6f 6e 73 74 20 75 38 20 oad;. const u8
2efd0 2a 70 53 72 63 3b 0a 20 20 69 6e 74 20 6e 53 72 *pSrc;. int nSr
2efe0 63 2c 20 6e 2c 20 72 63 3b 0a 20 20 69 6e 74 20 c, n, rc;. int
2eff0 73 70 61 63 65 4c 65 66 74 3b 0a 20 20 4d 65 6d spaceLeft;. Mem
2f000 50 61 67 65 20 2a 70 4f 76 66 6c 20 3d 20 30 3b Page *pOvfl = 0;
2f010 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 6f 52 . MemPage *pToR
2f020 65 6c 65 61 73 65 20 3d 20 30 3b 0a 20 20 75 6e elease = 0;. un
2f030 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 72 signed char *pPr
2f040 69 6f 72 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 ior;. unsigned
2f050 63 68 61 72 20 2a 70 50 61 79 6c 6f 61 64 3b 0a char *pPayload;.
2f060 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
2f070 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
2f080 50 67 6e 6f 20 70 67 6e 6f 4f 76 66 6c 20 3d 20 Pgno pgnoOvfl =
2f090 30 3b 0a 20 20 69 6e 74 20 6e 48 65 61 64 65 72 0;. int nHeader
2f0a0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
2f0b0 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
2f0c0 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
2f0d0 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 70 50 61 67 x) );.. /* pPag
2f0e0 65 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 e is not necessa
2f0f0 72 69 6c 79 20 77 72 69 74 65 61 62 6c 65 20 73 rily writeable s
2f100 69 6e 63 65 20 70 43 65 6c 6c 20 6d 69 67 68 74 ince pCell might
2f110 20 62 65 20 61 75 78 69 6c 69 61 72 79 0a 20 20 be auxiliary.
2f120 2a 2a 20 62 75 66 66 65 72 20 73 70 61 63 65 20 ** buffer space
2f130 74 68 61 74 20 69 73 20 73 65 70 61 72 61 74 65 that is separate
2f140 20 66 72 6f 6d 20 74 68 65 20 70 50 61 67 65 20 from the pPage
2f150 62 75 66 66 65 72 20 61 72 65 61 20 2a 2f 0a 20 buffer area */.
2f160 20 61 73 73 65 72 74 28 20 70 43 65 6c 6c 3c 70 assert( pCell<p
2f170 50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 Page->aData || p
2f180 43 65 6c 6c 3e 3d 26 70 50 61 67 65 2d 3e 61 44 Cell>=&pPage->aD
2f190 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 53 69 7a ata[pBt->pageSiz
2f1a0 65 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7c e]. |
2f1b0 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 | sqlite3PagerIs
2f1c0 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
2f1d0 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 >pDbPage) );..
2f1e0 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 20 68 /* Fill in the h
2f1f0 65 61 64 65 72 2e 20 2a 2f 0a 20 20 6e 48 65 61 eader. */. nHea
2f200 64 65 72 20 3d 20 70 50 61 67 65 2d 3e 63 68 69 der = pPage->chi
2f210 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 6e 50 61 ldPtrSize;. nPa
2f220 79 6c 6f 61 64 20 3d 20 6e 44 61 74 61 20 2b 20 yload = nData +
2f230 6e 5a 65 72 6f 3b 0a 20 20 69 66 28 20 70 50 61 nZero;. if( pPa
2f240 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 ge->intKeyLeaf )
2f250 7b 0a 20 20 20 20 6e 48 65 61 64 65 72 20 2b 3d {. nHeader +=
2f260 20 70 75 74 56 61 72 69 6e 74 33 32 28 26 70 43 putVarint32(&pC
2f270 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 6e 50 ell[nHeader], nP
2f280 61 79 6c 6f 61 64 29 3b 0a 20 20 7d 65 6c 73 65 ayload);. }else
2f290 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 44 {. assert( nD
2f2a0 61 74 61 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 ata==0 );. as
2f2b0 73 65 72 74 28 20 6e 5a 65 72 6f 3d 3d 30 20 29 sert( nZero==0 )
2f2c0 3b 0a 20 20 7d 0a 20 20 6e 48 65 61 64 65 72 20 ;. }. nHeader
2f2d0 2b 3d 20 70 75 74 56 61 72 69 6e 74 28 26 70 43 += putVarint(&pC
2f2e0 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 2a 28 ell[nHeader], *(
2f2f0 75 36 34 2a 29 26 6e 4b 65 79 29 3b 0a 20 20 0a u64*)&nKey);. .
2f300 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 /* Fill in the
2f310 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 20 2a 2f payload size */
2f320 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e . if( pPage->in
2f330 74 4b 65 79 20 29 7b 0a 20 20 20 20 70 53 72 63 tKey ){. pSrc
2f340 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 6e 53 = pData;. nS
2f350 72 63 20 3d 20 6e 44 61 74 61 3b 0a 20 20 20 20 rc = nData;.
2f360 6e 44 61 74 61 20 3d 20 30 3b 0a 20 20 7d 65 6c nData = 0;. }el
2f370 73 65 7b 20 0a 20 20 20 20 69 66 28 20 4e 45 56 se{ . if( NEV
2f380 45 52 28 6e 4b 65 79 3e 30 78 37 66 66 66 66 66 ER(nKey>0x7fffff
2f390 66 66 20 7c 7c 20 70 4b 65 79 3d 3d 30 29 20 29 ff || pKey==0) )
2f3a0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
2f3b0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
2f3c0 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 50 PT;. }. nP
2f3d0 61 79 6c 6f 61 64 20 3d 20 28 69 6e 74 29 6e 4b ayload = (int)nK
2f3e0 65 79 3b 0a 20 20 20 20 70 53 72 63 20 3d 20 70 ey;. pSrc = p
2f3f0 4b 65 79 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 Key;. nSrc =
2f400 28 69 6e 74 29 6e 4b 65 79 3b 0a 20 20 7d 0a 20 (int)nKey;. }.
2f410 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d 70 if( nPayload<=p
2f420 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 Page->maxLocal )
2f430 7b 0a 20 20 20 20 6e 20 3d 20 6e 48 65 61 64 65 {. n = nHeade
2f440 72 20 2b 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 r + nPayload;.
2f450 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 33 testcase( n==3
2f460 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 );. testcase
2f470 28 20 6e 3d 3d 34 20 29 3b 0a 20 20 20 20 69 66 ( n==4 );. if
2f480 28 20 6e 3c 34 20 29 20 6e 20 3d 20 34 3b 0a 20 ( n<4 ) n = 4;.
2f490 20 20 20 2a 70 6e 53 69 7a 65 20 3d 20 6e 3b 0a *pnSize = n;.
2f4a0 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 spaceLeft =
2f4b0 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 70 50 nPayload;. pP
2f4c0 72 69 6f 72 20 3d 20 70 43 65 6c 6c 3b 0a 20 20 rior = pCell;.
2f4d0 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6d }else{. int m
2f4e0 6e 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f n = pPage->minLo
2f4f0 63 61 6c 3b 0a 20 20 20 20 6e 20 3d 20 6d 6e 20 cal;. n = mn
2f500 2b 20 28 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 6e + (nPayload - mn
2f510 29 20 25 20 28 70 50 61 67 65 2d 3e 70 42 74 2d ) % (pPage->pBt-
2f520 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 29 >usableSize - 4)
2f530 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
2f540 6e 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 n==pPage->maxLoc
2f550 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 al );. testca
2f560 73 65 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 6d 61 se( n==pPage->ma
2f570 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 xLocal+1 );.
2f580 69 66 28 20 6e 20 3e 20 70 50 61 67 65 2d 3e 6d if( n > pPage->m
2f590 61 78 4c 6f 63 61 6c 20 29 20 6e 20 3d 20 6d 6e axLocal ) n = mn
2f5a0 3b 0a 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 ;. spaceLeft
2f5b0 3d 20 6e 3b 0a 20 20 20 20 2a 70 6e 53 69 7a 65 = n;. *pnSize
2f5c0 20 3d 20 6e 20 2b 20 6e 48 65 61 64 65 72 20 2b = n + nHeader +
2f5d0 20 34 3b 0a 20 20 20 20 70 50 72 69 6f 72 20 3d 4;. pPrior =
2f5e0 20 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 2b &pCell[nHeader+
2f5f0 6e 5d 3b 0a 20 20 7d 0a 20 20 70 50 61 79 6c 6f n];. }. pPaylo
2f600 61 64 20 3d 20 26 70 43 65 6c 6c 5b 6e 48 65 61 ad = &pCell[nHea
2f610 64 65 72 5d 3b 0a 0a 20 20 2f 2a 20 41 74 20 74 der];.. /* At t
2f620 68 69 73 20 70 6f 69 6e 74 20 76 61 72 69 61 62 his point variab
2f630 6c 65 73 20 73 68 6f 75 6c 64 20 62 65 20 73 65 les should be se
2f640 74 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 t as follows:.
2f650 2a 2a 0a 20 20 2a 2a 20 20 20 6e 50 61 79 6c 6f **. ** nPaylo
2f660 61 64 20 20 20 20 20 20 20 20 20 20 20 54 6f 74 ad Tot
2f670 61 6c 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 20 al payload size
2f680 69 6e 20 62 79 74 65 73 0a 20 20 2a 2a 20 20 20 in bytes. **
2f690 70 50 61 79 6c 6f 61 64 20 20 20 20 20 20 20 20 pPayload
2f6a0 20 20 20 42 65 67 69 6e 20 77 72 69 74 69 6e 67 Begin writing
2f6b0 20 70 61 79 6c 6f 61 64 20 68 65 72 65 0a 20 20 payload here.
2f6c0 2a 2a 20 20 20 73 70 61 63 65 4c 65 66 74 20 20 ** spaceLeft
2f6d0 20 20 20 20 20 20 20 20 53 70 61 63 65 20 61 76 Space av
2f6e0 61 69 6c 61 62 6c 65 20 61 74 20 70 50 61 79 6c ailable at pPayl
2f6f0 6f 61 64 2e 20 20 49 66 20 6e 50 61 79 6c 6f 61 oad. If nPayloa
2f700 64 3e 73 70 61 63 65 4c 65 66 74 2c 0a 20 20 2a d>spaceLeft,. *
2f710 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
2f720 20 20 20 20 20 20 20 74 68 61 74 20 6d 65 61 6e that mean
2f730 73 20 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 73 s content must s
2f740 70 69 6c 6c 20 69 6e 74 6f 20 6f 76 65 72 66 6c pill into overfl
2f750 6f 77 20 70 61 67 65 73 2e 0a 20 20 2a 2a 20 20 ow pages.. **
2f760 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 20 *pnSize
2f770 20 20 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 Size of the
2f780 6c 6f 63 61 6c 20 63 65 6c 6c 20 28 6e 6f 74 20 local cell (not
2f790 63 6f 75 6e 74 69 6e 67 20 6f 76 65 72 66 6c 6f counting overflo
2f7a0 77 20 70 61 67 65 73 29 0a 20 20 2a 2a 20 20 20 w pages). **
2f7b0 70 50 72 69 6f 72 20 20 20 20 20 20 20 20 20 20 pPrior
2f7c0 20 20 20 57 68 65 72 65 20 74 6f 20 77 72 69 74 Where to writ
2f7d0 65 20 74 68 65 20 70 67 6e 6f 20 6f 66 20 74 68 e the pgno of th
2f7e0 65 20 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 e first overflow
2f7f0 20 70 61 67 65 0a 20 20 2a 2a 0a 20 20 2a 2a 20 page. **. **
2f800 55 73 65 20 61 20 63 61 6c 6c 20 74 6f 20 62 74 Use a call to bt
2f810 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 reeParseCellPtr(
2f820 29 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 ) to verify that
2f830 20 74 68 65 20 76 61 6c 75 65 73 20 61 62 6f 76 the values abov
2f840 65 0a 20 20 2a 2a 20 77 65 72 65 20 63 6f 6d 70 e. ** were comp
2f850 75 74 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 0a uted correctly..
2f860 20 20 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f */.#if SQLITE_
2f870 44 45 42 55 47 0a 20 20 7b 0a 20 20 20 20 43 65 DEBUG. {. Ce
2f880 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 llInfo info;.
2f890 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
2f8a0 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c tr(pPage, pCell,
2f8b0 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 61 73 73 &info);. ass
2f8c0 65 72 74 28 20 6e 48 65 61 64 65 72 3d 28 69 6e ert( nHeader=(in
2f8d0 74 29 28 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 t)(info.pPayload
2f8e0 20 2d 20 70 43 65 6c 6c 29 20 29 3b 0a 20 20 20 - pCell) );.
2f8f0 20 61 73 73 65 72 74 28 20 69 6e 66 6f 2e 6e 4b assert( info.nK
2f900 65 79 3d 3d 6e 4b 65 79 20 29 3b 0a 20 20 20 20 ey==nKey );.
2f910 61 73 73 65 72 74 28 20 2a 70 6e 53 69 7a 65 20 assert( *pnSize
2f920 3d 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 20 29 3b == info.nSize );
2f930 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 70 61 . assert( spa
2f940 63 65 4c 65 66 74 20 3d 3d 20 69 6e 66 6f 2e 6e ceLeft == info.n
2f950 4c 6f 63 61 6c 20 29 3b 0a 20 20 20 20 61 73 73 Local );. ass
2f960 65 72 74 28 20 70 50 72 69 6f 72 20 3d 3d 20 26 ert( pPrior == &
2f970 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 pCell[info.iOver
2f980 66 6c 6f 77 5d 20 29 3b 0a 20 20 7d 0a 23 65 6e flow] );. }.#en
2f990 64 69 66 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 dif.. /* Write
2f9a0 74 68 65 20 70 61 79 6c 6f 61 64 20 69 6e 74 6f the payload into
2f9b0 20 74 68 65 20 6c 6f 63 61 6c 20 43 65 6c 6c 20 the local Cell
2f9c0 61 6e 64 20 61 6e 79 20 65 78 74 72 61 20 69 6e and any extra in
2f9d0 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 to overflow page
2f9e0 73 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 6e 50 s */. while( nP
2f9f0 61 79 6c 6f 61 64 3e 30 20 29 7b 0a 20 20 20 20 ayload>0 ){.
2fa00 69 66 28 20 73 70 61 63 65 4c 65 66 74 3d 3d 30 if( spaceLeft==0
2fa10 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ){.#ifndef SQLI
2fa20 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
2fa30 55 4d 0a 20 20 20 20 20 20 50 67 6e 6f 20 70 67 UM. Pgno pg
2fa40 6e 6f 50 74 72 6d 61 70 20 3d 20 70 67 6e 6f 4f noPtrmap = pgnoO
2fa50 76 66 6c 3b 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 vfl; /* Overflow
2fa60 20 70 61 67 65 20 70 6f 69 6e 74 65 72 2d 6d 61 page pointer-ma
2fa70 70 20 65 6e 74 72 79 20 70 61 67 65 20 2a 2f 0a p entry page */.
2fa80 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 if( pBt->a
2fa90 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 utoVacuum ){.
2faa0 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 20 do{.
2fab0 20 20 20 70 67 6e 6f 4f 76 66 6c 2b 2b 3b 0a 20 pgnoOvfl++;.
2fac0 20 20 20 20 20 20 20 7d 20 77 68 69 6c 65 28 20 } while(
2fad0 0a 20 20 20 20 20 20 20 20 20 20 50 54 52 4d 41 . PTRMA
2fae0 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 70 67 P_ISPAGE(pBt, pg
2faf0 6e 6f 4f 76 66 6c 29 20 7c 7c 20 70 67 6e 6f 4f noOvfl) || pgnoO
2fb00 76 66 6c 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 vfl==PENDING_BYT
2fb10 45 5f 50 41 47 45 28 70 42 74 29 20 0a 20 20 20 E_PAGE(pBt) .
2fb20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 7d 0a );. }.
2fb30 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 #endif. rc
2fb40 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 = allocateBtreeP
2fb50 61 67 65 28 70 42 74 2c 20 26 70 4f 76 66 6c 2c age(pBt, &pOvfl,
2fb60 20 26 70 67 6e 6f 4f 76 66 6c 2c 20 70 67 6e 6f &pgnoOvfl, pgno
2fb70 4f 76 66 6c 2c 20 30 29 3b 0a 23 69 66 6e 64 65 Ovfl, 0);.#ifnde
2fb80 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
2fb90 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f TOVACUUM. /
2fba0 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 * If the databas
2fbb0 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d e supports auto-
2fbc0 76 61 63 75 75 6d 2c 20 61 6e 64 20 74 68 65 20 vacuum, and the
2fbd0 73 65 63 6f 6e 64 20 6f 72 20 73 75 62 73 65 71 second or subseq
2fbe0 75 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 6f 76 uent. ** ov
2fbf0 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 62 erflow page is b
2fc00 65 69 6e 67 20 61 6c 6c 6f 63 61 74 65 64 2c 20 eing allocated,
2fc10 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 add an entry to
2fc20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a the pointer-map.
2fc30 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 68 61 ** for tha
2fc40 74 20 70 61 67 65 20 6e 6f 77 2e 20 0a 20 20 20 t page now. .
2fc50 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49 **. ** I
2fc60 66 20 74 68 69 73 20 69 73 20 74 68 65 20 66 69 f this is the fi
2fc70 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 rst overflow pag
2fc80 65 2c 20 74 68 65 6e 20 77 72 69 74 65 20 61 20 e, then write a
2fc90 70 61 72 74 69 61 6c 20 65 6e 74 72 79 20 0a 20 partial entry .
2fca0 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 70 ** to the p
2fcb0 6f 69 6e 74 65 72 2d 6d 61 70 2e 20 49 66 20 77 ointer-map. If w
2fcc0 65 20 77 72 69 74 65 20 6e 6f 74 68 69 6e 67 20 e write nothing
2fcd0 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 65 72 2d to this pointer-
2fce0 6d 61 70 20 73 6c 6f 74 2c 0a 20 20 20 20 20 20 map slot,.
2fcf0 2a 2a 20 74 68 65 6e 20 74 68 65 20 6f 70 74 69 ** then the opti
2fd00 6d 69 73 74 69 63 20 6f 76 65 72 66 6c 6f 77 20 mistic overflow
2fd10 63 68 61 69 6e 20 70 72 6f 63 65 73 73 69 6e 67 chain processing
2fd20 20 69 6e 20 63 6c 65 61 72 43 65 6c 6c 28 29 0a in clearCell().
2fd30 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 6d 69 73 ** may mis
2fd40 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 75 6e interpret the un
2fd50 69 6e 69 74 69 61 6c 69 7a 65 64 20 76 61 6c 75 initialized valu
2fd60 65 73 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 es and delete th
2fd70 65 0a 20 20 20 20 20 20 2a 2a 20 77 72 6f 6e 67 e. ** wrong
2fd80 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 65 20 pages from the
2fd90 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 database..
2fda0 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 */. if( pBt
2fdb0 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 26 20 ->autoVacuum &&
2fdc0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2fdd0 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 79 70 . u8 eTyp
2fde0 65 20 3d 20 28 70 67 6e 6f 50 74 72 6d 61 70 3f e = (pgnoPtrmap?
2fdf0 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
2fe00 3a 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 :PTRMAP_OVERFLOW
2fe10 31 29 3b 0a 20 20 20 20 20 20 20 20 70 74 72 6d 1);. ptrm
2fe20 61 70 50 75 74 28 70 42 74 2c 20 70 67 6e 6f 4f apPut(pBt, pgnoO
2fe30 76 66 6c 2c 20 65 54 79 70 65 2c 20 70 67 6e 6f vfl, eType, pgno
2fe40 50 74 72 6d 61 70 2c 20 26 72 63 29 3b 0a 20 20 Ptrmap, &rc);.
2fe50 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
2fe60 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 releas
2fe70 65 50 61 67 65 28 70 4f 76 66 6c 29 3b 0a 20 20 ePage(pOvfl);.
2fe80 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
2fe90 23 65 6e 64 69 66 0a 20 20 20 20 20 20 69 66 28 #endif. if(
2fea0 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 72 rc ){. r
2feb0 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 65 eleasePage(pToRe
2fec0 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 20 20 lease);.
2fed0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
2fee0 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
2fef0 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 6e 6f pToRelease is no
2ff00 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 72 69 t zero than pPri
2ff10 6f 72 20 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 or points into t
2ff20 68 65 20 64 61 74 61 20 61 72 65 61 0a 20 20 20 he data area.
2ff30 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 6c 65 ** of pToRele
2ff40 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 ase. Make sure
2ff50 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 73 74 pToRelease is st
2ff60 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e 20 2a ill writeable. *
2ff70 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 /. assert(
2ff80 70 54 6f 52 65 6c 65 61 73 65 3d 3d 30 20 7c 7c pToRelease==0 ||
2ff90 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
2ffa0 72 69 74 65 61 62 6c 65 28 70 54 6f 52 65 6c 65 riteable(pToRele
2ffb0 61 73 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b ase->pDbPage) );
2ffc0 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 50 .. /* If pP
2ffd0 72 69 6f 72 20 69 73 20 70 61 72 74 20 6f 66 20 rior is part of
2ffe0 74 68 65 20 64 61 74 61 20 61 72 65 61 20 6f 66 the data area of
2fff0 20 70 50 61 67 65 2c 20 74 68 65 6e 20 6d 61 6b pPage, then mak
30000 65 20 73 75 72 65 20 70 50 61 67 65 0a 20 20 20 e sure pPage.
30010 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c 20 77 ** is still w
30020 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 20 20 riteable */.
30030 20 20 61 73 73 65 72 74 28 20 70 50 72 69 6f 72 assert( pPrior
30040 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c <pPage->aData ||
30050 20 70 50 72 69 6f 72 3e 3d 26 70 50 61 67 65 2d pPrior>=&pPage-
30060 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 >aData[pBt->page
30070 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 Size].
30080 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 || sqlite3Page
30090 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
300a0 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
300b0 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 . put4byte(
300c0 70 50 72 69 6f 72 2c 20 70 67 6e 6f 4f 76 66 6c pPrior, pgnoOvfl
300d0 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 );. release
300e0 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 Page(pToRelease)
300f0 3b 0a 20 20 20 20 20 20 70 54 6f 52 65 6c 65 61 ;. pToRelea
30100 73 65 20 3d 20 70 4f 76 66 6c 3b 0a 20 20 20 20 se = pOvfl;.
30110 20 20 70 50 72 69 6f 72 20 3d 20 70 4f 76 66 6c pPrior = pOvfl
30120 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 20 70 ->aData;. p
30130 75 74 34 62 79 74 65 28 70 50 72 69 6f 72 2c 20 ut4byte(pPrior,
30140 30 29 3b 0a 20 20 20 20 20 20 70 50 61 79 6c 6f 0);. pPaylo
30150 61 64 20 3d 20 26 70 4f 76 66 6c 2d 3e 61 44 61 ad = &pOvfl->aDa
30160 74 61 5b 34 5d 3b 0a 20 20 20 20 20 20 73 70 61 ta[4];. spa
30170 63 65 4c 65 66 74 20 3d 20 70 42 74 2d 3e 75 73 ceLeft = pBt->us
30180 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
30190 20 20 7d 0a 20 20 20 20 6e 20 3d 20 6e 50 61 79 }. n = nPay
301a0 6c 6f 61 64 3b 0a 20 20 20 20 69 66 28 20 6e 3e load;. if( n>
301b0 73 70 61 63 65 4c 65 66 74 20 29 20 6e 20 3d 20 spaceLeft ) n =
301c0 73 70 61 63 65 4c 65 66 74 3b 0a 0a 20 20 20 20 spaceLeft;..
301d0 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 73 65 /* If pToRelease
301e0 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 68 61 is not zero tha
301f0 6e 20 70 50 61 79 6c 6f 61 64 20 70 6f 69 6e 74 n pPayload point
30200 73 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 20 s into the data
30210 61 72 65 61 0a 20 20 20 20 2a 2a 20 6f 66 20 70 area. ** of p
30220 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 6b 65 ToRelease. Make
30230 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 73 65 sure pToRelease
30240 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 is still writea
30250 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 ble. */. asse
30260 72 74 28 20 70 54 6f 52 65 6c 65 61 73 65 3d 3d rt( pToRelease==
30270 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 0 || sqlite3Page
30280 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 54 6f rIswriteable(pTo
30290 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 67 65 Release->pDbPage
302a0 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 ) );.. /* If
302b0 70 50 61 79 6c 6f 61 64 20 69 73 20 70 61 72 74 pPayload is part
302c0 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 72 65 of the data are
302d0 61 20 6f 66 20 70 50 61 67 65 2c 20 74 68 65 6e a of pPage, then
302e0 20 6d 61 6b 65 20 73 75 72 65 20 70 50 61 67 65 make sure pPage
302f0 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c . ** is still
30300 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 writeable */.
30310 20 20 61 73 73 65 72 74 28 20 70 50 61 79 6c 6f assert( pPaylo
30320 61 64 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 ad<pPage->aData
30330 7c 7c 20 70 50 61 79 6c 6f 61 64 3e 3d 26 70 50 || pPayload>=&pP
30340 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e age->aData[pBt->
30350 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 pageSize].
30360 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 || sqlite3
30370 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
30380 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
30390 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e 53 72 );.. if( nSr
303a0 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 c>0 ){. if(
303b0 20 6e 3e 6e 53 72 63 20 29 20 6e 20 3d 20 6e 53 n>nSrc ) n = nS
303c0 72 63 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 rc;. assert
303d0 28 20 70 53 72 63 20 29 3b 0a 20 20 20 20 20 20 ( pSrc );.
303e0 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 2c memcpy(pPayload,
303f0 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 20 20 7d pSrc, n);. }
30400 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 6d 73 else{. mems
30410 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 30 2c 20 et(pPayload, 0,
30420 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 50 n);. }. nP
30430 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a 20 20 20 ayload -= n;.
30440 20 70 50 61 79 6c 6f 61 64 20 2b 3d 20 6e 3b 0a pPayload += n;.
30450 20 20 20 20 70 53 72 63 20 2b 3d 20 6e 3b 0a 20 pSrc += n;.
30460 20 20 20 6e 53 72 63 20 2d 3d 20 6e 3b 0a 20 20 nSrc -= n;.
30470 20 20 73 70 61 63 65 4c 65 66 74 20 2d 3d 20 6e spaceLeft -= n
30480 3b 0a 20 20 20 20 69 66 28 20 6e 53 72 63 3d 3d ;. if( nSrc==
30490 30 20 29 7b 0a 20 20 20 20 20 20 6e 53 72 63 20 0 ){. nSrc
304a0 3d 20 6e 44 61 74 61 3b 0a 20 20 20 20 20 20 70 = nData;. p
304b0 53 72 63 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 Src = pData;.
304c0 20 7d 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 }. }. release
304d0 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 Page(pToRelease)
304e0 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
304f0 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 E_OK;.}../*.** R
30500 65 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 20 63 emove the i-th c
30510 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 20 ell from pPage.
30520 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 66 This routine ef
30530 66 65 63 74 73 20 70 50 61 67 65 20 6f 6e 6c 79 fects pPage only
30540 2e 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 63 6f ..** The cell co
30550 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 72 65 ntent is not fre
30560 65 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 74 65 ed or deallocate
30570 64 2e 20 20 49 74 20 69 73 20 61 73 73 75 6d 65 d. It is assume
30580 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 65 d that.** the ce
30590 6c 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 62 ll content has b
305a0 65 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d 65 70 een copied somep
305b0 6c 61 63 65 20 65 6c 73 65 2e 20 20 54 68 69 73 lace else. This
305c0 20 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a 2a 2a routine just.**
305d0 20 72 65 6d 6f 76 65 73 20 74 68 65 20 72 65 66 removes the ref
305e0 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 63 65 erence to the ce
305f0 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 0a 2a ll from pPage..*
30600 2a 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 20 62 *.** "sz" must b
30610 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 e the number of
30620 62 79 74 65 73 20 69 6e 20 74 68 65 20 63 65 6c bytes in the cel
30630 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 l..*/.static voi
30640 64 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d 50 61 d dropCell(MemPa
30650 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 ge *pPage, int i
30660 64 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 dx, int sz, int
30670 2a 70 52 43 29 7b 0a 20 20 75 33 32 20 70 63 3b *pRC){. u32 pc;
30680 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
30690 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 65 et to cell conte
306a0 6e 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 6e 67 nt of cell being
306b0 20 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 75 38 deleted */. u8
306c0 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a *data; /*
306d0 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f pPage->aData */
306e0 0a 20 20 75 38 20 2a 70 74 72 3b 20 20 20 20 20 . u8 *ptr;
306f0 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 6d 6f /* Used to mo
30700 76 65 20 62 79 74 65 73 20 61 72 6f 75 6e 64 20 ve bytes around
30710 77 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 2a 2f within data[] */
30720 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
30730 20 20 20 2f 2a 20 54 68 65 20 72 65 74 75 72 6e /* The return
30740 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68 code */. int h
30750 64 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 42 65 dr; /* Be
30760 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 68 ginning of the h
30770 65 61 64 65 72 2e 20 20 30 20 6d 6f 73 74 20 70 eader. 0 most p
30780 61 67 65 73 2e 20 20 31 30 30 20 70 61 67 65 20 ages. 100 page
30790 31 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 1 */.. if( *pRC
307a0 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 ) return;.. as
307b0 73 65 72 74 28 20 69 64 78 3e 3d 30 20 26 26 20 sert( idx>=0 &&
307c0 69 64 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c idx<pPage->nCell
307d0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 7a );. assert( sz
307e0 3d 3d 63 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 ==cellSize(pPage
307f0 2c 20 69 64 78 29 20 29 3b 0a 20 20 61 73 73 65 , idx) );. asse
30800 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
30810 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
30820 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
30830 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
30840 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
30850 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
30860 3b 0a 20 20 64 61 74 61 20 3d 20 70 50 61 67 65 ;. data = pPage
30870 2d 3e 61 44 61 74 61 3b 0a 20 20 70 74 72 20 3d ->aData;. ptr =
30880 20 26 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 &pPage->aCellId
30890 78 5b 32 2a 69 64 78 5d 3b 0a 20 20 70 63 20 3d x[2*idx];. pc =
308a0 20 67 65 74 32 62 79 74 65 28 70 74 72 29 3b 0a get2byte(ptr);.
308b0 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 hdr = pPage->h
308c0 64 72 4f 66 66 73 65 74 3b 0a 20 20 74 65 73 74 drOffset;. test
308d0 63 61 73 65 28 20 70 63 3d 3d 67 65 74 32 62 79 case( pc==get2by
308e0 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 te(&data[hdr+5])
308f0 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 );. testcase(
30900 70 63 2b 73 7a 3d 3d 70 50 61 67 65 2d 3e 70 42 pc+sz==pPage->pB
30910 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b t->usableSize );
30920 0a 20 20 69 66 28 20 70 63 20 3c 20 28 75 33 32 . if( pc < (u32
30930 29 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b )get2byte(&data[
30940 68 64 72 2b 35 5d 29 20 7c 7c 20 70 63 2b 73 7a hdr+5]) || pc+sz
30950 20 3e 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 > pPage->pBt->u
30960 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 sableSize ){.
30970 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 45 5f 43 *pRC = SQLITE_C
30980 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
30990 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 72 return;. }. r
309a0 63 20 3d 20 66 72 65 65 53 70 61 63 65 28 70 50 c = freeSpace(pP
309b0 61 67 65 2c 20 70 63 2c 20 73 7a 29 3b 0a 20 20 age, pc, sz);.
309c0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 2a 70 if( rc ){. *p
309d0 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 65 74 RC = rc;. ret
309e0 75 72 6e 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 urn;. }. pPage
309f0 2d 3e 6e 43 65 6c 6c 2d 2d 3b 0a 20 20 6d 65 6d ->nCell--;. mem
30a00 6d 6f 76 65 28 70 74 72 2c 20 70 74 72 2b 32 2c move(ptr, ptr+2,
30a10 20 32 2a 28 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2*(pPage->nCell
30a20 20 2d 20 69 64 78 29 29 3b 0a 20 20 70 75 74 32 - idx));. put2
30a30 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 byte(&data[hdr+3
30a40 5d 2c 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 29 ], pPage->nCell)
30a50 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 ;. pPage->nFree
30a60 20 2b 3d 20 32 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 += 2;.}../*.**
30a70 49 6e 73 65 72 74 20 61 20 6e 65 77 20 63 65 6c Insert a new cel
30a80 6c 20 6f 6e 20 70 50 61 67 65 20 61 74 20 63 65 l on pPage at ce
30a90 6c 6c 20 69 6e 64 65 78 20 22 69 22 2e 20 20 70 ll index "i". p
30aa0 43 65 6c 6c 20 70 6f 69 6e 74 73 20 74 6f 20 74 Cell points to t
30ab0 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 6f 66 he.** content of
30ac0 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2a 0a 2a 2a the cell..**.**
30ad0 20 49 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e If the cell con
30ae0 74 65 6e 74 20 77 69 6c 6c 20 66 69 74 20 6f 6e tent will fit on
30af0 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 6e 20 the page, then
30b00 70 75 74 20 69 74 20 74 68 65 72 65 2e 20 20 49 put it there. I
30b10 66 20 69 74 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 f it.** will not
30b20 20 66 69 74 2c 20 74 68 65 6e 20 6d 61 6b 65 20 fit, then make
30b30 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 63 65 a copy of the ce
30b40 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 74 6f 20 ll content into
30b50 70 54 65 6d 70 20 69 66 0a 2a 2a 20 70 54 65 6d pTemp if.** pTem
30b60 70 20 69 73 20 6e 6f 74 20 6e 75 6c 6c 2e 20 20 p is not null.
30b70 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 70 54 Regardless of pT
30b80 65 6d 70 2c 20 61 6c 6c 6f 63 61 74 65 20 61 20 emp, allocate a
30b90 6e 65 77 20 65 6e 74 72 79 0a 2a 2a 20 69 6e 20 new entry.** in
30ba0 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 5d 20 pPage->apOvfl[]
30bb0 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f 69 6e and make it poin
30bc0 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f t to the cell co
30bd0 6e 74 65 6e 74 20 28 65 69 74 68 65 72 0a 2a 2a ntent (either.**
30be0 20 69 6e 20 70 54 65 6d 70 20 6f 72 20 74 68 65 in pTemp or the
30bf0 20 6f 72 69 67 69 6e 61 6c 20 70 43 65 6c 6c 29 original pCell)
30c00 20 61 6e 64 20 61 6c 73 6f 20 72 65 63 6f 72 64 and also record
30c10 20 69 74 73 20 69 6e 64 65 78 2e 20 0a 2a 2a 20 its index. .**
30c20 41 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 Allocating a new
30c30 20 65 6e 74 72 79 20 69 6e 20 70 50 61 67 65 2d entry in pPage-
30c40 3e 61 43 65 6c 6c 5b 5d 20 69 6d 70 6c 69 65 73 >aCell[] implies
30c50 20 74 68 61 74 20 0a 2a 2a 20 70 50 61 67 65 2d that .** pPage-
30c60 3e 6e 4f 76 65 72 66 6c 6f 77 20 69 73 20 69 6e >nOverflow is in
30c70 63 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a cremented..**.**
30c80 20 49 66 20 6e 53 6b 69 70 20 69 73 20 6e 6f 6e If nSkip is non
30c90 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 64 6f 20 6e -zero, then do n
30ca0 6f 74 20 63 6f 70 79 20 74 68 65 20 66 69 72 73 ot copy the firs
30cb0 74 20 6e 53 6b 69 70 20 62 79 74 65 73 20 6f 66 t nSkip bytes of
30cc0 20 74 68 65 0a 2a 2a 20 63 65 6c 6c 2e 20 54 68 the.** cell. Th
30cd0 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6f 76 e caller will ov
30ce0 65 72 77 72 69 74 65 20 74 68 65 6d 20 61 66 74 erwrite them aft
30cf0 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
30d00 20 72 65 74 75 72 6e 73 2e 20 49 66 0a 2a 2a 20 returns. If.**
30d10 6e 53 6b 69 70 20 69 73 20 6e 6f 6e 2d 7a 65 72 nSkip is non-zer
30d20 6f 2c 20 74 68 65 6e 20 70 43 65 6c 6c 20 6d 61 o, then pCell ma
30d30 79 20 6e 6f 74 20 70 6f 69 6e 74 20 74 6f 20 61 y not point to a
30d40 6e 20 69 6e 76 61 6c 69 64 20 6d 65 6d 6f 72 79 n invalid memory
30d50 20 6c 6f 63 61 74 69 6f 6e 20 0a 2a 2a 20 28 62 location .** (b
30d60 75 74 20 70 43 65 6c 6c 2b 6e 53 6b 69 70 20 69 ut pCell+nSkip i
30d70 73 20 61 6c 77 61 79 73 20 76 61 6c 69 64 29 2e s always valid).
30d80 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
30d90 69 6e 73 65 72 74 43 65 6c 6c 28 0a 20 20 4d 65 insertCell(. Me
30da0 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
30db0 2f 2a 20 50 61 67 65 20 69 6e 74 6f 20 77 68 69 /* Page into whi
30dc0 63 68 20 77 65 20 61 72 65 20 63 6f 70 79 69 6e ch we are copyin
30dd0 67 20 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 20 20 g */. int i,
30de0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 20 /* New
30df0 63 65 6c 6c 20 62 65 63 6f 6d 65 73 20 74 68 65 cell becomes the
30e00 20 69 2d 74 68 20 63 65 6c 6c 20 6f 66 20 74 68 i-th cell of th
30e10 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a e page */. u8 *
30e20 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 2f 2a pCell, /*
30e30 20 43 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 Content of the
30e40 6e 65 77 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e new cell */. in
30e50 74 20 73 7a 2c 20 20 20 20 20 20 20 20 20 20 20 t sz,
30e60 2f 2a 20 42 79 74 65 73 20 6f 66 20 63 6f 6e 74 /* Bytes of cont
30e70 65 6e 74 20 69 6e 20 70 43 65 6c 6c 20 2a 2f 0a ent in pCell */.
30e80 20 20 75 38 20 2a 70 54 65 6d 70 2c 20 20 20 20 u8 *pTemp,
30e90 20 20 20 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 /* Temp stor
30ea0 61 67 65 20 73 70 61 63 65 20 66 6f 72 20 70 43 age space for pC
30eb0 65 6c 6c 2c 20 69 66 20 6e 65 65 64 65 64 20 2a ell, if needed *
30ec0 2f 0a 20 20 50 67 6e 6f 20 69 43 68 69 6c 64 2c /. Pgno iChild,
30ed0 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 6e 2d /* If non-
30ee0 7a 65 72 6f 2c 20 72 65 70 6c 61 63 65 20 66 69 zero, replace fi
30ef0 72 73 74 20 34 20 62 79 74 65 73 20 77 69 74 68 rst 4 bytes with
30f00 20 74 68 69 73 20 76 61 6c 75 65 20 2a 2f 0a 20 this value */.
30f10 20 69 6e 74 20 2a 70 52 43 20 20 20 20 20 20 20 int *pRC
30f20 20 20 20 2f 2a 20 52 65 61 64 20 61 6e 64 20 77 /* Read and w
30f30 72 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 rite return code
30f40 20 66 72 6f 6d 20 68 65 72 65 20 2a 2f 0a 29 7b from here */.){
30f50 0a 20 20 69 6e 74 20 69 64 78 20 3d 20 30 3b 20 . int idx = 0;
30f60 20 20 20 20 20 2f 2a 20 57 68 65 72 65 20 74 6f /* Where to
30f70 20 77 72 69 74 65 20 6e 65 77 20 63 65 6c 6c 20 write new cell
30f80 63 6f 6e 74 65 6e 74 20 69 6e 20 64 61 74 61 5b content in data[
30f90 5d 20 2a 2f 0a 20 20 69 6e 74 20 6a 3b 20 20 20 ] */. int j;
30fa0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
30fb0 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 6e counter */. in
30fc0 74 20 65 6e 64 3b 20 20 20 20 20 20 20 20 20 20 t end;
30fd0 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 61 /* First byte pa
30fe0 73 74 20 74 68 65 20 6c 61 73 74 20 63 65 6c 6c st the last cell
30ff0 20 70 6f 69 6e 74 65 72 20 69 6e 20 64 61 74 61 pointer in data
31000 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 6e 73 3b [] */. int ins;
31010 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
31020 65 78 20 69 6e 20 64 61 74 61 5b 5d 20 77 68 65 ex in data[] whe
31030 72 65 20 6e 65 77 20 63 65 6c 6c 20 70 6f 69 6e re new cell poin
31040 74 65 72 20 69 73 20 69 6e 73 65 72 74 65 64 20 ter is inserted
31050 2a 2f 0a 20 20 69 6e 74 20 63 65 6c 6c 4f 66 66 */. int cellOff
31060 73 65 74 3b 20 20 20 2f 2a 20 41 64 64 72 65 73 set; /* Addres
31070 73 20 6f 66 20 66 69 72 73 74 20 63 65 6c 6c 20 s of first cell
31080 70 6f 69 6e 74 65 72 20 69 6e 20 64 61 74 61 5b pointer in data[
31090 5d 20 2a 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b ] */. u8 *data;
310a0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
310b0 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 77 content of the w
310c0 68 6f 6c 65 20 70 61 67 65 20 2a 2f 0a 20 20 69 hole page */. i
310d0 6e 74 20 6e 53 6b 69 70 20 3d 20 28 69 43 68 69 nt nSkip = (iChi
310e0 6c 64 20 3f 20 34 20 3a 20 30 29 3b 0a 0a 20 20 ld ? 4 : 0);..
310f0 69 66 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 if( *pRC ) retur
31100 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 69 3e n;.. assert( i>
31110 3d 30 20 26 26 20 69 3c 3d 70 50 61 67 65 2d 3e =0 && i<=pPage->
31120 6e 43 65 6c 6c 2b 70 50 61 67 65 2d 3e 6e 4f 76 nCell+pPage->nOv
31130 65 72 66 6c 6f 77 20 29 3b 0a 20 20 61 73 73 65 erflow );. asse
31140 72 74 28 20 4d 58 5f 43 45 4c 4c 28 70 50 61 67 rt( MX_CELL(pPag
31150 65 2d 3e 70 42 74 29 3c 3d 31 30 39 32 31 20 29 e->pBt)<=10921 )
31160 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
31170 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d 58 5f 43 45 4c e->nCell<=MX_CEL
31180 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 20 7c 7c L(pPage->pBt) ||
31190 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 CORRUPT_DB );.
311a0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
311b0 6e 4f 76 65 72 66 6c 6f 77 3c 3d 41 72 72 61 79 nOverflow<=Array
311c0 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 4f 76 Size(pPage->apOv
311d0 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 fl) );. assert(
311e0 20 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 ArraySize(pPage
311f0 2d 3e 61 70 4f 76 66 6c 29 3d 3d 41 72 72 61 79 ->apOvfl)==Array
31200 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 69 4f 76 Size(pPage->aiOv
31210 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 fl) );. assert(
31220 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
31230 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
31240 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 mutex) );. /* T
31250 68 65 20 63 65 6c 6c 20 73 68 6f 75 6c 64 20 6e he cell should n
31260 6f 72 6d 61 6c 6c 79 20 62 65 20 73 69 7a 65 64 ormally be sized
31270 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 48 6f 77 correctly. How
31280 65 76 65 72 2c 20 77 68 65 6e 20 6d 6f 76 69 6e ever, when movin
31290 67 20 61 0a 20 20 2a 2a 20 6d 61 6c 66 6f 72 6d g a. ** malform
312a0 65 64 20 63 65 6c 6c 20 66 72 6f 6d 20 61 20 6c ed cell from a l
312b0 65 61 66 20 70 61 67 65 20 74 6f 20 61 6e 20 69 eaf page to an i
312c0 6e 74 65 72 69 6f 72 20 70 61 67 65 2c 20 69 66 nterior page, if
312d0 20 74 68 65 20 63 65 6c 6c 20 73 69 7a 65 0a 20 the cell size.
312e0 20 2a 2a 20 77 61 6e 74 65 64 20 74 6f 20 62 65 ** wanted to be
312f0 20 6c 65 73 73 20 74 68 61 6e 20 34 20 62 75 74 less than 4 but
31300 20 67 6f 74 20 72 6f 75 6e 64 65 64 20 75 70 20 got rounded up
31310 74 6f 20 34 20 6f 6e 20 74 68 65 20 6c 65 61 66 to 4 on the leaf
31320 2c 20 74 68 65 6e 20 73 69 7a 65 0a 20 20 2a 2a , then size. **
31330 20 6d 69 67 68 74 20 62 65 20 6c 65 73 73 20 74 might be less t
31340 68 61 6e 20 38 20 28 6c 65 61 66 2d 73 69 7a 65 han 8 (leaf-size
31350 20 2b 20 70 6f 69 6e 74 65 72 29 20 6f 6e 20 74 + pointer) on t
31360 68 65 20 69 6e 74 65 72 69 6f 72 20 6e 6f 64 65 he interior node
31370 2e 20 20 48 65 6e 63 65 0a 20 20 2a 2a 20 74 68 . Hence. ** th
31380 65 20 74 65 72 6d 20 61 66 74 65 72 20 74 68 65 e term after the
31390 20 7c 7c 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f || in the follo
313a0 77 69 6e 67 20 61 73 73 65 72 74 28 29 2e 20 2a wing assert(). *
313b0 2f 0a 20 20 61 73 73 65 72 74 28 20 73 7a 3d 3d /. assert( sz==
313c0 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 67 cellSizePtr(pPag
313d0 65 2c 20 70 43 65 6c 6c 29 20 7c 7c 20 28 73 7a e, pCell) || (sz
313e0 3d 3d 38 20 26 26 20 69 43 68 69 6c 64 3e 30 29 ==8 && iChild>0)
313f0 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d );. if( pPage-
31400 3e 6e 4f 76 65 72 66 6c 6f 77 20 7c 7c 20 73 7a >nOverflow || sz
31410 2b 32 3e 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 +2>pPage->nFree
31420 29 7b 0a 20 20 20 20 69 66 28 20 70 54 65 6d 70 ){. if( pTemp
31430 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 ){. memcpy
31440 28 70 54 65 6d 70 2b 6e 53 6b 69 70 2c 20 70 43 (pTemp+nSkip, pC
31450 65 6c 6c 2b 6e 53 6b 69 70 2c 20 73 7a 2d 6e 53 ell+nSkip, sz-nS
31460 6b 69 70 29 3b 0a 20 20 20 20 20 20 70 43 65 6c kip);. pCel
31470 6c 20 3d 20 70 54 65 6d 70 3b 0a 20 20 20 20 7d l = pTemp;. }
31480 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 20 . if( iChild
31490 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 ){. put4byt
314a0 65 28 70 43 65 6c 6c 2c 20 69 43 68 69 6c 64 29 e(pCell, iChild)
314b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6a 20 3d 20 ;. }. j =
314c0 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
314d0 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ++;. assert(
314e0 6a 3c 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 70 j<(int)(sizeof(p
314f0 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 2f 73 69 Page->apOvfl)/si
31500 7a 65 6f 66 28 70 50 61 67 65 2d 3e 61 70 4f 76 zeof(pPage->apOv
31510 66 6c 5b 30 5d 29 29 20 29 3b 0a 20 20 20 20 70 fl[0])) );. p
31520 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 6a 5d 20 Page->apOvfl[j]
31530 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 20 70 50 61 = pCell;. pPa
31540 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 5d 20 3d 20 ge->aiOvfl[j] =
31550 28 75 31 36 29 69 3b 0a 20 20 7d 65 6c 73 65 7b (u16)i;. }else{
31560 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71 . int rc = sq
31570 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
31580 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b pPage->pDbPage);
31590 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
315a0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
315b0 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 20 *pRC = rc;.
315c0 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 return;. }.
315d0 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
315e0 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
315f0 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
31600 65 29 20 29 3b 0a 20 20 20 20 64 61 74 61 20 3d e) );. data =
31610 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 pPage->aData;.
31620 20 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 cellOffset =
31630 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
31640 74 3b 0a 20 20 20 20 65 6e 64 20 3d 20 63 65 6c t;. end = cel
31650 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 61 67 lOffset + 2*pPag
31660 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e e->nCell;. in
31670 73 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b s = cellOffset +
31680 20 32 2a 69 3b 0a 20 20 20 20 72 63 20 3d 20 61 2*i;. rc = a
31690 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 70 50 61 llocateSpace(pPa
316a0 67 65 2c 20 73 7a 2c 20 26 69 64 78 29 3b 0a 20 ge, sz, &idx);.
316b0 20 20 20 69 66 28 20 72 63 20 29 7b 20 2a 70 52 if( rc ){ *pR
316c0 43 20 3d 20 72 63 3b 20 72 65 74 75 72 6e 3b 20 C = rc; return;
316d0 7d 0a 20 20 20 20 2f 2a 20 54 68 65 20 61 6c 6c }. /* The all
316e0 6f 63 61 74 65 53 70 61 63 65 28 29 20 72 6f 75 ocateSpace() rou
316f0 74 69 6e 65 20 67 75 61 72 61 6e 74 65 65 73 20 tine guarantees
31700 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 the following tw
31710 6f 20 70 72 6f 70 65 72 74 69 65 73 0a 20 20 20 o properties.
31720 20 2a 2a 20 69 66 20 69 74 20 72 65 74 75 72 6e ** if it return
31730 73 20 73 75 63 63 65 73 73 20 2a 2f 0a 20 20 20 s success */.
31740 20 61 73 73 65 72 74 28 20 69 64 78 20 3e 3d 20 assert( idx >=
31750 65 6e 64 2b 32 20 29 3b 0a 20 20 20 20 61 73 73 end+2 );. ass
31760 65 72 74 28 20 69 64 78 2b 73 7a 20 3c 3d 20 28 ert( idx+sz <= (
31770 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e int)pPage->pBt->
31780 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
31790 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 2b pPage->nCell++
317a0 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 ;. pPage->nFr
317b0 65 65 20 2d 3d 20 28 75 31 36 29 28 32 20 2b 20 ee -= (u16)(2 +
317c0 73 7a 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 sz);. memcpy(
317d0 26 64 61 74 61 5b 69 64 78 2b 6e 53 6b 69 70 5d &data[idx+nSkip]
317e0 2c 20 70 43 65 6c 6c 2b 6e 53 6b 69 70 2c 20 73 , pCell+nSkip, s
317f0 7a 2d 6e 53 6b 69 70 29 3b 0a 20 20 20 20 69 66 z-nSkip);. if
31800 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 20 ( iChild ){.
31810 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 61 put4byte(&data
31820 5b 69 64 78 5d 2c 20 69 43 68 69 6c 64 29 3b 0a [idx], iChild);.
31830 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 6d 6f 76 }. memmov
31840 65 28 26 64 61 74 61 5b 69 6e 73 2b 32 5d 2c 20 e(&data[ins+2],
31850 26 64 61 74 61 5b 69 6e 73 5d 2c 20 65 6e 64 2d &data[ins], end-
31860 69 6e 73 29 3b 0a 20 20 20 20 70 75 74 32 62 79 ins);. put2by
31870 74 65 28 26 64 61 74 61 5b 69 6e 73 5d 2c 20 69 te(&data[ins], i
31880 64 78 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 dx);. put2byt
31890 65 28 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 68 e(&data[pPage->h
318a0 64 72 4f 66 66 73 65 74 2b 33 5d 2c 20 70 50 61 drOffset+3], pPa
318b0 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 23 69 66 6e ge->nCell);.#ifn
318c0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
318d0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 AUTOVACUUM. i
318e0 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 61 f( pPage->pBt->a
318f0 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 utoVacuum ){.
31900 20 20 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 6d /* The cell m
31910 61 79 20 63 6f 6e 74 61 69 6e 20 61 20 70 6f 69 ay contain a poi
31920 6e 74 65 72 20 74 6f 20 61 6e 20 6f 76 65 72 66 nter to an overf
31930 6c 6f 77 20 70 61 67 65 2e 20 49 66 20 73 6f 2c low page. If so,
31940 20 77 72 69 74 65 0a 20 20 20 20 20 20 2a 2a 20 write. **
31950 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 the entry for th
31960 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 e overflow page
31970 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 into the pointer
31980 20 6d 61 70 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 map.. */.
31990 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 ptrmapPutOv
319a0 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 flPtr(pPage, pCe
319b0 6c 6c 2c 20 70 52 43 29 3b 0a 20 20 20 20 7d 0a ll, pRC);. }.
319c0 23 65 6e 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a #endif. }.}../*
319d0 0a 2a 2a 20 41 64 64 20 61 20 6c 69 73 74 20 6f .** Add a list o
319e0 66 20 63 65 6c 6c 73 20 74 6f 20 61 20 70 61 67 f cells to a pag
319f0 65 2e 20 20 54 68 65 20 70 61 67 65 20 73 68 6f e. The page sho
31a00 75 6c 64 20 62 65 20 69 6e 69 74 69 61 6c 6c 79 uld be initially
31a10 20 65 6d 70 74 79 2e 0a 2a 2a 20 54 68 65 20 63 empty..** The c
31a20 65 6c 6c 73 20 61 72 65 20 67 75 61 72 61 6e 74 ells are guarant
31a30 65 65 64 20 74 6f 20 66 69 74 20 6f 6e 20 74 68 eed to fit on th
31a40 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 e page..*/.stati
31a50 63 20 76 6f 69 64 20 61 73 73 65 6d 62 6c 65 50 c void assembleP
31a60 61 67 65 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a age(. MemPage *
31a70 70 50 61 67 65 2c 20 20 20 2f 2a 20 54 68 65 20 pPage, /* The
31a80 70 61 67 65 20 74 6f 20 62 65 20 61 73 73 65 6d page to be assem
31a90 62 6c 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 bled */. int nC
31aa0 65 6c 6c 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 ell, /* T
31ab0 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c he number of cel
31ac0 6c 73 20 74 6f 20 61 64 64 20 74 6f 20 74 68 69 ls to add to thi
31ad0 73 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a s page */. u8 *
31ae0 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 2f 2a *apCell, /*
31af0 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 63 65 6c Pointers to cel
31b00 6c 20 62 6f 64 69 65 73 20 2a 2f 0a 20 20 75 31 l bodies */. u1
31b10 36 20 2a 61 53 69 7a 65 20 20 20 20 20 20 20 20 6 *aSize
31b20 2f 2a 20 53 69 7a 65 73 20 6f 66 20 74 68 65 20 /* Sizes of the
31b30 63 65 6c 6c 73 20 2a 2f 0a 29 7b 0a 20 20 69 6e cells */.){. in
31b40 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
31b50 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 /* Loop counter
31b60 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 70 74 */. u8 *pCellpt
31b70 72 3b 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 r; /* Addres
31b80 73 20 6f 66 20 6e 65 78 74 20 63 65 6c 6c 20 70 s of next cell p
31b90 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 ointer */. int
31ba0 63 65 6c 6c 62 6f 64 79 3b 20 20 20 20 20 2f 2a cellbody; /*
31bb0 20 41 64 64 72 65 73 73 20 6f 66 20 6e 65 78 74 Address of next
31bc0 20 63 65 6c 6c 20 62 6f 64 79 20 2a 2f 0a 20 20 cell body */.
31bd0 75 38 20 2a 20 63 6f 6e 73 74 20 64 61 74 61 20 u8 * const data
31be0 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 = pPage->aData;
31bf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
31c00 6f 69 6e 74 65 72 20 74 6f 20 64 61 74 61 20 66 ointer to data f
31c10 6f 72 20 70 50 61 67 65 20 2a 2f 0a 20 20 63 6f or pPage */. co
31c20 6e 73 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 nst int hdr = pP
31c30 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 age->hdrOffset;
31c40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 /* Off
31c50 73 65 74 20 6f 66 20 68 65 61 64 65 72 20 6f 6e set of header on
31c60 20 70 50 61 67 65 20 2a 2f 0a 20 20 63 6f 6e 73 pPage */. cons
31c70 74 20 69 6e 74 20 6e 55 73 61 62 6c 65 20 3d 20 t int nUsable =
31c80 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
31c90 6c 65 53 69 7a 65 3b 20 2f 2a 20 55 73 61 62 6c leSize; /* Usabl
31ca0 65 20 73 69 7a 65 20 6f 66 20 70 61 67 65 20 2a e size of page *
31cb0 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 /.. assert( pPa
31cc0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 ge->nOverflow==0
31cd0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
31ce0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
31cf0 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
31d00 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
31d10 20 6e 43 65 6c 6c 3e 3d 30 20 26 26 20 6e 43 65 nCell>=0 && nCe
31d20 6c 6c 3c 3d 28 69 6e 74 29 4d 58 5f 43 45 4c 4c ll<=(int)MX_CELL
31d30 28 70 50 61 67 65 2d 3e 70 42 74 29 0a 20 20 20 (pPage->pBt).
31d40 20 20 20 20 20 20 20 20 20 26 26 20 28 69 6e 74 && (int
31d50 29 4d 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e )MX_CELL(pPage->
31d60 70 42 74 29 3c 3d 31 30 39 32 31 29 3b 0a 20 20 pBt)<=10921);.
31d70 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
31d80 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
31d90 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
31da0 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 );.. /* Check t
31db0 68 61 74 20 74 68 65 20 70 61 67 65 20 68 61 73 hat the page has
31dc0 20 6a 75 73 74 20 62 65 65 6e 20 7a 65 72 6f 65 just been zeroe
31dd0 64 20 62 79 20 7a 65 72 6f 50 61 67 65 28 29 20 d by zeroPage()
31de0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 */. assert( pPa
31df0 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a ge->nCell==0 );.
31e00 20 20 61 73 73 65 72 74 28 20 67 65 74 32 62 79 assert( get2by
31e10 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b teNotZero(&data[
31e20 68 64 72 2b 35 5d 29 3d 3d 6e 55 73 61 62 6c 65 hdr+5])==nUsable
31e30 20 29 3b 0a 0a 20 20 70 43 65 6c 6c 70 74 72 20 );.. pCellptr
31e40 3d 20 26 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 = &pPage->aCellI
31e50 64 78 5b 6e 43 65 6c 6c 2a 32 5d 3b 0a 20 20 63 dx[nCell*2];. c
31e60 65 6c 6c 62 6f 64 79 20 3d 20 6e 55 73 61 62 6c ellbody = nUsabl
31e70 65 3b 0a 20 20 66 6f 72 28 69 3d 6e 43 65 6c 6c e;. for(i=nCell
31e80 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a -1; i>=0; i--){.
31e90 20 20 20 20 75 31 36 20 73 7a 20 3d 20 61 53 69 u16 sz = aSi
31ea0 7a 65 5b 69 5d 3b 0a 20 20 20 20 70 43 65 6c 6c ze[i];. pCell
31eb0 70 74 72 20 2d 3d 20 32 3b 0a 20 20 20 20 63 65 ptr -= 2;. ce
31ec0 6c 6c 62 6f 64 79 20 2d 3d 20 73 7a 3b 0a 20 20 llbody -= sz;.
31ed0 20 20 70 75 74 32 62 79 74 65 28 70 43 65 6c 6c put2byte(pCell
31ee0 70 74 72 2c 20 63 65 6c 6c 62 6f 64 79 29 3b 0a ptr, cellbody);.
31ef0 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 memcpy(&data
31f00 5b 63 65 6c 6c 62 6f 64 79 5d 2c 20 61 70 43 65 [cellbody], apCe
31f10 6c 6c 5b 69 5d 2c 20 73 7a 29 3b 0a 20 20 7d 0a ll[i], sz);. }.
31f20 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
31f30 5b 68 64 72 2b 33 5d 2c 20 6e 43 65 6c 6c 29 3b [hdr+3], nCell);
31f40 0a 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 . put2byte(&dat
31f50 61 5b 68 64 72 2b 35 5d 2c 20 63 65 6c 6c 62 6f a[hdr+5], cellbo
31f60 64 79 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 46 dy);. pPage->nF
31f70 72 65 65 20 2d 3d 20 28 6e 43 65 6c 6c 2a 32 20 ree -= (nCell*2
31f80 2b 20 6e 55 73 61 62 6c 65 20 2d 20 63 65 6c 6c + nUsable - cell
31f90 62 6f 64 79 29 3b 0a 20 20 70 50 61 67 65 2d 3e body);. pPage->
31fa0 6e 43 65 6c 6c 20 3d 20 28 75 31 36 29 6e 43 65 nCell = (u16)nCe
31fb0 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 ll;.}../*.** The
31fc0 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 61 6d following param
31fd0 65 74 65 72 73 20 64 65 74 65 72 6d 69 6e 65 20 eters determine
31fe0 68 6f 77 20 6d 61 6e 79 20 61 64 6a 61 63 65 6e how many adjacen
31ff0 74 20 70 61 67 65 73 20 67 65 74 20 69 6e 76 6f t pages get invo
32000 6c 76 65 64 0a 2a 2a 20 69 6e 20 61 20 62 61 6c lved.** in a bal
32010 61 6e 63 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e ancing operation
32020 2e 20 20 4e 4e 20 69 73 20 74 68 65 20 6e 75 6d . NN is the num
32030 62 65 72 20 6f 66 20 6e 65 69 67 68 62 6f 72 73 ber of neighbors
32040 20 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 0a on either side.
32050 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 ** of the page t
32060 68 61 74 20 70 61 72 74 69 63 69 70 61 74 65 20 hat participate
32070 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 in the balancing
32080 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 4e 42 20 operation. NB
32090 69 73 20 74 68 65 0a 2a 2a 20 74 6f 74 61 6c 20 is the.** total
320a0 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
320b0 74 68 61 74 20 70 61 72 74 69 63 69 70 61 74 65 that participate
320c0 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 , including the
320d0 74 61 72 67 65 74 20 70 61 67 65 20 61 6e 64 0a target page and.
320e0 2a 2a 20 4e 4e 20 6e 65 69 67 68 62 6f 72 73 20 ** NN neighbors
320f0 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 2e 0a on either side..
32100 2a 2a 0a 2a 2a 20 54 68 65 20 6d 69 6e 69 6d 75 **.** The minimu
32110 6d 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 69 73 m value of NN is
32120 20 31 20 28 6f 66 20 63 6f 75 72 73 65 29 2e 20 1 (of course).
32130 20 49 6e 63 72 65 61 73 69 6e 67 20 4e 4e 20 61 Increasing NN a
32140 62 6f 76 65 20 31 0a 2a 2a 20 28 74 6f 20 32 20 bove 1.** (to 2
32150 6f 72 20 33 29 20 67 69 76 65 73 20 61 20 6d 6f or 3) gives a mo
32160 64 65 73 74 20 69 6d 70 72 6f 76 65 6d 65 6e 74 dest improvement
32170 20 69 6e 20 53 45 4c 45 43 54 20 61 6e 64 20 44 in SELECT and D
32180 45 4c 45 54 45 20 70 65 72 66 6f 72 6d 61 6e 63 ELETE performanc
32190 65 0a 2a 2a 20 69 6e 20 65 78 63 68 61 6e 67 65 e.** in exchange
321a0 20 66 6f 72 20 61 20 6c 61 72 67 65 72 20 64 65 for a larger de
321b0 67 72 61 64 61 74 69 6f 6e 20 69 6e 20 49 4e 53 gradation in INS
321c0 45 52 54 20 61 6e 64 20 55 50 44 41 54 45 20 70 ERT and UPDATE p
321d0 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 2a 2a 20 54 erformance..** T
321e0 68 65 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 61 he value of NN a
321f0 70 70 65 61 72 73 20 74 6f 20 67 69 76 65 20 74 ppears to give t
32200 68 65 20 62 65 73 74 20 72 65 73 75 6c 74 73 20 he best results
32210 6f 76 65 72 61 6c 6c 2e 0a 2a 2f 0a 23 64 65 66 overall..*/.#def
32220 69 6e 65 20 4e 4e 20 31 20 20 20 20 20 20 20 20 ine NN 1
32230 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
32240 66 20 6e 65 69 67 68 62 6f 72 73 20 6f 6e 20 65 f neighbors on e
32250 69 74 68 65 72 20 73 69 64 65 20 6f 66 20 70 50 ither side of pP
32260 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e age */.#define N
32270 42 20 28 4e 4e 2a 32 2b 31 29 20 20 20 20 20 20 B (NN*2+1)
32280 2f 2a 20 54 6f 74 61 6c 20 70 61 67 65 73 20 69 /* Total pages i
32290 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 62 nvolved in the b
322a0 61 6c 61 6e 63 65 20 2a 2f 0a 0a 0a 23 69 66 6e alance */...#ifn
322b0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
322c0 51 55 49 43 4b 42 41 4c 41 4e 43 45 0a 2f 2a 0a QUICKBALANCE./*.
322d0 2a 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20 ** This version
322e0 6f 66 20 62 61 6c 61 6e 63 65 28 29 20 68 61 6e of balance() han
322f0 64 6c 65 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 dles the common
32300 73 70 65 63 69 61 6c 20 63 61 73 65 20 77 68 65 special case whe
32310 72 65 0a 2a 2a 20 61 20 6e 65 77 20 65 6e 74 72 re.** a new entr
32320 79 20 69 73 20 62 65 69 6e 67 20 69 6e 73 65 72 y is being inser
32330 74 65 64 20 6f 6e 20 74 68 65 20 65 78 74 72 65 ted on the extre
32340 6d 65 20 72 69 67 68 74 2d 65 6e 64 20 6f 66 20 me right-end of
32350 74 68 65 0a 2a 2a 20 74 72 65 65 2c 20 69 6e 20 the.** tree, in
32360 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 77 68 65 other words, whe
32370 6e 20 74 68 65 20 6e 65 77 20 65 6e 74 72 79 20 n the new entry
32380 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 will become the
32390 6c 61 72 67 65 73 74 0a 2a 2a 20 65 6e 74 72 79 largest.** entry
323a0 20 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a 2a in the tree..**
323b0 0a 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 74 .** Instead of t
323c0 72 79 69 6e 67 20 74 6f 20 62 61 6c 61 6e 63 65 rying to balance
323d0 20 74 68 65 20 33 20 72 69 67 68 74 2d 6d 6f 73 the 3 right-mos
323e0 74 20 6c 65 61 66 20 70 61 67 65 73 2c 20 6a 75 t leaf pages, ju
323f0 73 74 20 61 64 64 0a 2a 2a 20 61 20 6e 65 77 20 st add.** a new
32400 70 61 67 65 20 74 6f 20 74 68 65 20 72 69 67 68 page to the righ
32410 74 2d 68 61 6e 64 20 73 69 64 65 20 61 6e 64 20 t-hand side and
32420 70 75 74 20 74 68 65 20 6f 6e 65 20 6e 65 77 20 put the one new
32430 65 6e 74 72 79 20 69 6e 0a 2a 2a 20 74 68 61 74 entry in.** that
32440 20 70 61 67 65 2e 20 20 54 68 69 73 20 6c 65 61 page. This lea
32450 76 65 73 20 74 68 65 20 72 69 67 68 74 20 73 69 ves the right si
32460 64 65 20 6f 66 20 74 68 65 20 74 72 65 65 20 73 de of the tree s
32470 6f 6d 65 77 68 61 74 0a 2a 2a 20 75 6e 62 61 6c omewhat.** unbal
32480 61 6e 63 65 64 2e 20 20 42 75 74 20 6f 64 64 73 anced. But odds
32490 20 61 72 65 20 74 68 61 74 20 77 65 20 77 69 6c are that we wil
324a0 6c 20 62 65 20 69 6e 73 65 72 74 69 6e 67 20 6e l be inserting n
324b0 65 77 20 65 6e 74 72 69 65 73 0a 2a 2a 20 61 74 ew entries.** at
324c0 20 74 68 65 20 65 6e 64 20 73 6f 6f 6e 20 61 66 the end soon af
324d0 74 65 72 77 61 72 64 73 20 73 6f 20 74 68 65 20 terwards so the
324e0 6e 65 61 72 6c 79 20 65 6d 70 74 79 20 70 61 67 nearly empty pag
324f0 65 20 77 69 6c 6c 20 71 75 69 63 6b 6c 79 0a 2a e will quickly.*
32500 2a 20 66 69 6c 6c 20 75 70 2e 20 20 4f 6e 20 61 * fill up. On a
32510 76 65 72 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 70 50 verage..**.** pP
32520 61 67 65 20 69 73 20 74 68 65 20 6c 65 61 66 20 age is the leaf
32530 70 61 67 65 20 77 68 69 63 68 20 69 73 20 74 68 page which is th
32540 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 70 61 67 e right-most pag
32550 65 20 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a e in the tree..*
32560 2a 20 70 50 61 72 65 6e 74 20 69 73 20 69 74 73 * pParent is its
32570 20 70 61 72 65 6e 74 2e 20 20 70 50 61 67 65 20 parent. pPage
32580 6d 75 73 74 20 68 61 76 65 20 61 20 73 69 6e 67 must have a sing
32590 6c 65 20 6f 76 65 72 66 6c 6f 77 20 65 6e 74 72 le overflow entr
325a0 79 0a 2a 2a 20 77 68 69 63 68 20 69 73 20 61 6c y.** which is al
325b0 73 6f 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 so the right-mos
325c0 74 20 65 6e 74 72 79 20 6f 6e 20 74 68 65 20 70 t entry on the p
325d0 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 age..**.** The p
325e0 53 70 61 63 65 20 62 75 66 66 65 72 20 69 73 20 Space buffer is
325f0 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 61 20 used to store a
32600 74 65 6d 70 6f 72 61 72 79 20 63 6f 70 79 20 6f temporary copy o
32610 66 20 74 68 65 20 64 69 76 69 64 65 72 0a 2a 2a f the divider.**
32620 20 63 65 6c 6c 20 74 68 61 74 20 77 69 6c 6c 20 cell that will
32630 62 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f be inserted into
32640 20 70 50 61 72 65 6e 74 2e 20 53 75 63 68 20 61 pParent. Such a
32650 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 20 6f cell consists o
32660 66 20 61 20 34 0a 2a 2a 20 62 79 74 65 20 70 61 f a 4.** byte pa
32670 67 65 20 6e 75 6d 62 65 72 20 66 6f 6c 6c 6f 77 ge number follow
32680 65 64 20 62 79 20 61 20 76 61 72 69 61 62 6c 65 ed by a variable
32690 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 2e length integer.
326a0 20 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 6f 72 In other.** wor
326b0 64 73 2c 20 61 74 20 6d 6f 73 74 20 31 33 20 62 ds, at most 13 b
326c0 79 74 65 73 2e 20 48 65 6e 63 65 20 74 68 65 20 ytes. Hence the
326d0 70 53 70 61 63 65 20 62 75 66 66 65 72 20 6d 75 pSpace buffer mu
326e0 73 74 20 62 65 20 61 74 0a 2a 2a 20 6c 65 61 73 st be at.** leas
326f0 74 20 31 33 20 62 79 74 65 73 20 69 6e 20 73 69 t 13 bytes in si
32700 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ze..*/.static in
32710 74 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b 28 t balance_quick(
32720 4d 65 6d 50 61 67 65 20 2a 70 50 61 72 65 6e 74 MemPage *pParent
32730 2c 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 , MemPage *pPage
32740 2c 20 75 38 20 2a 70 53 70 61 63 65 29 7b 0a 20 , u8 *pSpace){.
32750 20 42 74 53 68 61 72 65 64 20 2a 63 6f 6e 73 74 BtShared *const
32760 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 pBt = pPage->pB
32770 74 3b 20 20 20 20 2f 2a 20 42 2d 54 72 65 65 20 t; /* B-Tree
32780 44 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 4d 65 Database */. Me
32790 6d 50 61 67 65 20 2a 70 4e 65 77 3b 20 20 20 20 mPage *pNew;
327a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
327b0 20 20 20 2f 2a 20 4e 65 77 6c 79 20 61 6c 6c 6f /* Newly allo
327c0 63 61 74 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 cated page */.
327d0 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
327e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
327f0 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 /* Return C
32800 6f 64 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 ode */. Pgno pg
32810 6e 6f 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 noNew;
32820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
32830 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 Page number of
32840 70 4e 65 77 20 2a 2f 0a 0a 20 20 61 73 73 65 72 pNew */.. asser
32850 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
32860 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
32870 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
32880 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
32890 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 erIswriteable(pP
328a0 61 72 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 arent->pDbPage)
328b0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
328c0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 31 ge->nOverflow==1
328d0 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 65 );.. /* This e
328e0 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 rror condition i
328f0 73 20 6e 6f 77 20 63 61 75 67 68 74 20 70 72 69 s now caught pri
32900 6f 72 20 74 6f 20 72 65 61 63 68 69 6e 67 20 74 or to reaching t
32910 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a his function */.
32920 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 if( pPage->nCe
32930 6c 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 ll==0 ) return S
32940 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
32950 50 54 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 PT;.. /* Alloca
32960 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e 20 54 te a new page. T
32970 68 69 73 20 70 61 67 65 20 77 69 6c 6c 20 62 65 his page will be
32980 63 6f 6d 65 20 74 68 65 20 72 69 67 68 74 2d 73 come the right-s
32990 69 62 6c 69 6e 67 20 6f 66 20 0a 20 20 2a 2a 20 ibling of . **
329a0 70 50 61 67 65 2e 20 4d 61 6b 65 20 74 68 65 20 pPage. Make the
329b0 70 61 72 65 6e 74 20 70 61 67 65 20 77 72 69 74 parent page writ
329c0 61 62 6c 65 2c 20 73 6f 20 74 68 61 74 20 74 68 able, so that th
329d0 65 20 6e 65 77 20 64 69 76 69 64 65 72 20 63 65 e new divider ce
329e0 6c 6c 0a 20 20 2a 2a 20 6d 61 79 20 62 65 20 69 ll. ** may be i
329f0 6e 73 65 72 74 65 64 2e 20 49 66 20 62 6f 74 68 nserted. If both
32a00 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6f 6e these operation
32a10 73 20 61 72 65 20 73 75 63 63 65 73 73 66 75 6c s are successful
32a20 2c 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2f 0a , proceed.. */.
32a30 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 rc = allocateB
32a40 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 treePage(pBt, &p
32a50 4e 65 77 2c 20 26 70 67 6e 6f 4e 65 77 2c 20 30 New, &pgnoNew, 0
32a60 2c 20 30 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d , 0);.. if( rc=
32a70 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 0a 20 =SQLITE_OK ){..
32a80 20 20 20 75 38 20 2a 70 4f 75 74 20 3d 20 26 70 u8 *pOut = &p
32a90 53 70 61 63 65 5b 34 5d 3b 0a 20 20 20 20 75 38 Space[4];. u8
32aa0 20 2a 70 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d *pCell = pPage-
32ab0 3e 61 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 20 >apOvfl[0];.
32ac0 75 31 36 20 73 7a 43 65 6c 6c 20 3d 20 63 65 6c u16 szCell = cel
32ad0 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 lSizePtr(pPage,
32ae0 70 43 65 6c 6c 29 3b 0a 20 20 20 20 75 38 20 2a pCell);. u8 *
32af0 70 53 74 6f 70 3b 0a 0a 20 20 20 20 61 73 73 65 pStop;.. asse
32b00 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
32b10 49 73 77 72 69 74 65 61 62 6c 65 28 70 4e 65 77 Iswriteable(pNew
32b20 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
32b30 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
32b40 3e 61 44 61 74 61 5b 30 5d 3d 3d 28 50 54 46 5f >aData[0]==(PTF_
32b50 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 44 INTKEY|PTF_LEAFD
32b60 41 54 41 7c 50 54 46 5f 4c 45 41 46 29 20 29 3b ATA|PTF_LEAF) );
32b70 0a 20 20 20 20 7a 65 72 6f 50 61 67 65 28 70 4e . zeroPage(pN
32b80 65 77 2c 20 50 54 46 5f 49 4e 54 4b 45 59 7c 50 ew, PTF_INTKEY|P
32b90 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f TF_LEAFDATA|PTF_
32ba0 4c 45 41 46 29 3b 0a 20 20 20 20 61 73 73 65 6d LEAF);. assem
32bb0 62 6c 65 50 61 67 65 28 70 4e 65 77 2c 20 31 2c blePage(pNew, 1,
32bc0 20 26 70 43 65 6c 6c 2c 20 26 73 7a 43 65 6c 6c &pCell, &szCell
32bd0 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 );.. /* If th
32be0 69 73 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 is is an auto-va
32bf0 63 75 75 6d 20 64 61 74 61 62 61 73 65 2c 20 75 cuum database, u
32c00 70 64 61 74 65 20 74 68 65 20 70 6f 69 6e 74 65 pdate the pointe
32c10 72 20 6d 61 70 0a 20 20 20 20 2a 2a 20 77 69 74 r map. ** wit
32c20 68 20 65 6e 74 72 69 65 73 20 66 6f 72 20 74 68 h entries for th
32c30 65 20 6e 65 77 20 70 61 67 65 2c 20 61 6e 64 20 e new page, and
32c40 61 6e 79 20 70 6f 69 6e 74 65 72 20 66 72 6f 6d any pointer from
32c50 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 63 65 6c the . ** cel
32c60 6c 20 6f 6e 20 74 68 65 20 70 61 67 65 20 74 6f l on the page to
32c70 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
32c80 65 2e 20 49 66 20 65 69 74 68 65 72 20 6f 66 20 e. If either of
32c90 74 68 65 73 65 0a 20 20 20 20 2a 2a 20 6f 70 65 these. ** ope
32ca0 72 61 74 69 6f 6e 73 20 66 61 69 6c 73 2c 20 74 rations fails, t
32cb0 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69 he return code i
32cc0 73 20 73 65 74 2c 20 62 75 74 20 74 68 65 20 63 s set, but the c
32cd0 6f 6e 74 65 6e 74 73 0a 20 20 20 20 2a 2a 20 6f ontents. ** o
32ce0 66 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 f the parent pag
32cf0 65 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 6e 69 e are still mani
32d00 70 75 6c 61 74 65 64 20 62 79 20 74 68 68 20 63 pulated by thh c
32d10 6f 64 65 20 62 65 6c 6f 77 2e 0a 20 20 20 20 2a ode below.. *
32d20 2a 20 54 68 61 74 20 69 73 20 4f 6b 2c 20 61 74 * That is Ok, at
32d30 20 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 20 this point the
32d40 70 61 72 65 6e 74 20 70 61 67 65 20 69 73 20 67 parent page is g
32d50 75 61 72 61 6e 74 65 65 64 20 74 6f 0a 20 20 20 uaranteed to.
32d60 20 2a 2a 20 62 65 20 6d 61 72 6b 65 64 20 61 73 ** be marked as
32d70 20 64 69 72 74 79 2e 20 52 65 74 75 72 6e 69 6e dirty. Returnin
32d80 67 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 g an error code
32d90 77 69 6c 6c 20 63 61 75 73 65 20 61 0a 20 20 20 will cause a.
32da0 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2c 20 75 6e ** rollback, un
32db0 64 6f 69 6e 67 20 61 6e 79 20 63 68 61 6e 67 65 doing any change
32dc0 73 20 6d 61 64 65 20 74 6f 20 74 68 65 20 70 61 s made to the pa
32dd0 72 65 6e 74 20 70 61 67 65 2e 0a 20 20 20 20 2a rent page.. *
32de0 2f 0a 20 20 20 20 69 66 28 20 49 53 41 55 54 4f /. if( ISAUTO
32df0 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 20 20 VACUUM ){.
32e00 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 70 ptrmapPut(pBt, p
32e10 67 6e 6f 4e 65 77 2c 20 50 54 52 4d 41 50 5f 42 gnoNew, PTRMAP_B
32e20 54 52 45 45 2c 20 70 50 61 72 65 6e 74 2d 3e 70 TREE, pParent->p
32e30 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 gno, &rc);.
32e40 20 69 66 28 20 73 7a 43 65 6c 6c 3e 70 4e 65 77 if( szCell>pNew
32e50 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 ->minLocal ){.
32e60 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 4f ptrmapPutO
32e70 76 66 6c 50 74 72 28 70 4e 65 77 2c 20 70 43 65 vflPtr(pNew, pCe
32e80 6c 6c 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 ll, &rc);.
32e90 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f }. }. . /
32ea0 2a 20 43 72 65 61 74 65 20 61 20 64 69 76 69 64 * Create a divid
32eb0 65 72 20 63 65 6c 6c 20 74 6f 20 69 6e 73 65 72 er cell to inser
32ec0 74 20 69 6e 74 6f 20 70 50 61 72 65 6e 74 2e 20 t into pParent.
32ed0 54 68 65 20 64 69 76 69 64 65 72 20 63 65 6c 6c The divider cell
32ee0 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 69 73 74 73 . ** consists
32ef0 20 6f 66 20 61 20 34 2d 62 79 74 65 20 70 61 67 of a 4-byte pag
32f00 65 20 6e 75 6d 62 65 72 20 28 74 68 65 20 70 61 e number (the pa
32f10 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 50 61 ge number of pPa
32f20 67 65 29 20 61 6e 64 0a 20 20 20 20 2a 2a 20 61 ge) and. ** a
32f30 20 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 74 68 variable length
32f40 20 6b 65 79 20 76 61 6c 75 65 20 28 77 68 69 63 key value (whic
32f50 68 20 6d 75 73 74 20 62 65 20 74 68 65 20 73 61 h must be the sa
32f60 6d 65 20 76 61 6c 75 65 20 61 73 20 74 68 65 0a me value as the.
32f70 20 20 20 20 2a 2a 20 6c 61 72 67 65 73 74 20 6b ** largest k
32f80 65 79 20 6f 6e 20 70 50 61 67 65 29 2e 0a 20 20 ey on pPage)..
32f90 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 6f 20 66 **. ** To f
32fa0 69 6e 64 20 74 68 65 20 6c 61 72 67 65 73 74 20 ind the largest
32fb0 6b 65 79 20 76 61 6c 75 65 20 6f 6e 20 70 50 61 key value on pPa
32fc0 67 65 2c 20 66 69 72 73 74 20 66 69 6e 64 20 74 ge, first find t
32fd0 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 0a 20 he right-most .
32fe0 20 20 20 2a 2a 20 63 65 6c 6c 20 6f 6e 20 70 50 ** cell on pP
32ff0 61 67 65 2e 20 54 68 65 20 66 69 72 73 74 20 74 age. The first t
33000 77 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 68 69 wo fields of thi
33010 73 20 63 65 6c 6c 20 61 72 65 20 74 68 65 20 0a s cell are the .
33020 20 20 20 20 2a 2a 20 72 65 63 6f 72 64 2d 6c 65 ** record-le
33030 6e 67 74 68 20 28 61 20 76 61 72 69 61 62 6c 65 ngth (a variable
33040 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 20 length integer
33050 61 74 20 6d 6f 73 74 20 33 32 2d 62 69 74 73 20 at most 32-bits
33060 69 6e 20 73 69 7a 65 29 0a 20 20 20 20 2a 2a 20 in size). **
33070 61 6e 64 20 74 68 65 20 6b 65 79 20 76 61 6c 75 and the key valu
33080 65 20 28 61 20 76 61 72 69 61 62 6c 65 20 6c 65 e (a variable le
33090 6e 67 74 68 20 69 6e 74 65 67 65 72 2c 20 6d 61 ngth integer, ma
330a0 79 20 68 61 76 65 20 61 6e 79 20 76 61 6c 75 65 y have any value
330b0 29 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 69 ).. ** The fi
330c0 72 73 74 20 6f 66 20 74 68 65 20 77 68 69 6c 65 rst of the while
330d0 28 2e 2e 2e 29 20 6c 6f 6f 70 73 20 62 65 6c 6f (...) loops belo
330e0 77 20 73 6b 69 70 73 20 6f 76 65 72 20 74 68 65 w skips over the
330f0 20 72 65 63 6f 72 64 2d 6c 65 6e 67 74 68 0a 20 record-length.
33100 20 20 20 2a 2a 20 66 69 65 6c 64 2e 20 54 68 65 ** field. The
33110 20 73 65 63 6f 6e 64 20 77 68 69 6c 65 28 2e 2e second while(..
33120 2e 29 20 6c 6f 6f 70 20 63 6f 70 69 65 73 20 74 .) loop copies t
33130 68 65 20 6b 65 79 20 76 61 6c 75 65 20 66 72 6f he key value fro
33140 6d 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 65 6c m the. ** cel
33150 6c 20 6f 6e 20 70 50 61 67 65 20 69 6e 74 6f 20 l on pPage into
33160 74 68 65 20 70 53 70 61 63 65 20 62 75 66 66 65 the pSpace buffe
33170 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 43 r.. */. pC
33180 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 ell = findCell(p
33190 50 61 67 65 2c 20 70 50 61 67 65 2d 3e 6e 43 65 Page, pPage->nCe
331a0 6c 6c 2d 31 29 3b 0a 20 20 20 20 70 53 74 6f 70 ll-1);. pStop
331b0 20 3d 20 26 70 43 65 6c 6c 5b 39 5d 3b 0a 20 20 = &pCell[9];.
331c0 20 20 77 68 69 6c 65 28 20 28 2a 28 70 43 65 6c while( (*(pCel
331d0 6c 2b 2b 29 26 30 78 38 30 29 20 26 26 20 70 43 l++)&0x80) && pC
331e0 65 6c 6c 3c 70 53 74 6f 70 20 29 3b 0a 20 20 20 ell<pStop );.
331f0 20 70 53 74 6f 70 20 3d 20 26 70 43 65 6c 6c 5b pStop = &pCell[
33200 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 9];. while( (
33210 28 2a 28 70 4f 75 74 2b 2b 29 20 3d 20 2a 28 70 (*(pOut++) = *(p
33220 43 65 6c 6c 2b 2b 29 29 26 30 78 38 30 29 20 26 Cell++))&0x80) &
33230 26 20 70 43 65 6c 6c 3c 70 53 74 6f 70 20 29 3b & pCell<pStop );
33240 0a 0a 20 20 20 20 2f 2a 20 49 6e 73 65 72 74 20 .. /* Insert
33250 74 68 65 20 6e 65 77 20 64 69 76 69 64 65 72 20 the new divider
33260 63 65 6c 6c 20 69 6e 74 6f 20 70 50 61 72 65 6e cell into pParen
33270 74 2e 20 2a 2f 0a 20 20 20 20 69 6e 73 65 72 74 t. */. insert
33280 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 70 50 Cell(pParent, pP
33290 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 2c 20 70 53 arent->nCell, pS
332a0 70 61 63 65 2c 20 28 69 6e 74 29 28 70 4f 75 74 pace, (int)(pOut
332b0 2d 70 53 70 61 63 65 29 2c 0a 20 20 20 20 20 20 -pSpace),.
332c0 20 20 20 20 20 20 20 20 20 30 2c 20 70 50 61 67 0, pPag
332d0 65 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 0a e->pgno, &rc);..
332e0 20 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 72 /* Set the r
332f0 69 67 68 74 2d 63 68 69 6c 64 20 70 6f 69 6e 74 ight-child point
33300 65 72 20 6f 66 20 70 50 61 72 65 6e 74 20 74 6f er of pParent to
33310 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6e 65 point to the ne
33320 77 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 70 w page. */. p
33330 75 74 34 62 79 74 65 28 26 70 50 61 72 65 6e 74 ut4byte(&pParent
33340 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d ->aData[pParent-
33350 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 2c 20 70 >hdrOffset+8], p
33360 67 6e 6f 4e 65 77 29 3b 0a 20 20 0a 20 20 20 20 gnoNew);. .
33370 2f 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20 72 /* Release the r
33380 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 eference to the
33390 6e 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 new page. */.
333a0 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 releasePage(pNe
333b0 77 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 w);. }.. retur
333c0 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f n rc;.}.#endif /
333d0 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55 * SQLITE_OMIT_QU
333e0 49 43 4b 42 41 4c 41 4e 43 45 20 2a 2f 0a 0a 23 ICKBALANCE */..#
333f0 69 66 20 30 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 if 0./*.** This
33400 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f function does no
33410 74 20 63 6f 6e 74 72 69 62 75 74 65 20 61 6e 79 t contribute any
33420 74 68 69 6e 67 20 74 6f 20 74 68 65 20 6f 70 65 thing to the ope
33430 72 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65 ration of SQLite
33440 2e 0a 2a 2a 20 69 74 20 69 73 20 73 6f 6d 65 74 ..** it is somet
33450 69 6d 65 73 20 61 63 74 69 76 61 74 65 64 20 74 imes activated t
33460 65 6d 70 6f 72 61 72 69 6c 79 20 77 68 69 6c 65 emporarily while
33470 20 64 65 62 75 67 67 69 6e 67 20 63 6f 64 65 20 debugging code
33480 72 65 73 70 6f 6e 73 69 62 6c 65 20 0a 2a 2a 20 responsible .**
33490 66 6f 72 20 73 65 74 74 69 6e 67 20 70 6f 69 6e for setting poin
334a0 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 2e ter-map entries.
334b0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
334c0 74 72 6d 61 70 43 68 65 63 6b 50 61 67 65 73 28 trmapCheckPages(
334d0 4d 65 6d 50 61 67 65 20 2a 2a 61 70 50 61 67 65 MemPage **apPage
334e0 2c 20 69 6e 74 20 6e 50 61 67 65 29 7b 0a 20 20 , int nPage){.
334f0 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 66 6f 72 28 int i, j;. for(
33500 69 3d 30 3b 20 69 3c 6e 50 61 67 65 3b 20 69 2b i=0; i<nPage; i+
33510 2b 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 3b 0a +){. Pgno n;.
33520 20 20 20 20 75 38 20 65 3b 0a 20 20 20 20 4d 65 u8 e;. Me
33530 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 61 mPage *pPage = a
33540 70 50 61 67 65 5b 69 5d 3b 0a 20 20 20 20 42 74 pPage[i];. Bt
33550 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 Shared *pBt = pP
33560 61 67 65 2d 3e 70 42 74 3b 0a 20 20 20 20 61 73 age->pBt;. as
33570 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 sert( pPage->isI
33580 6e 69 74 20 29 3b 0a 0a 20 20 20 20 66 6f 72 28 nit );.. for(
33590 6a 3d 30 3b 20 6a 3c 70 50 61 67 65 2d 3e 6e 43 j=0; j<pPage->nC
335a0 65 6c 6c 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 ell; j++){.
335b0 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a CellInfo info;.
335c0 20 20 20 20 20 20 75 38 20 2a 7a 3b 0a 20 20 20 u8 *z;.
335d0 20 20 0a 20 20 20 20 20 20 7a 20 3d 20 66 69 6e . z = fin
335e0 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 6a 29 3b dCell(pPage, j);
335f0 0a 20 20 20 20 20 20 62 74 72 65 65 50 61 72 73 . btreePars
33600 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 eCellPtr(pPage,
33610 7a 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 20 z, &info);.
33620 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 65 72 66 if( info.iOverf
33630 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 20 50 low ){. P
33640 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 34 62 gno ovfl = get4b
33650 79 74 65 28 26 7a 5b 69 6e 66 6f 2e 69 4f 76 65 yte(&z[info.iOve
33660 72 66 6c 6f 77 5d 29 3b 0a 20 20 20 20 20 20 20 rflow]);.
33670 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 ptrmapGet(pBt,
33680 6f 76 66 6c 2c 20 26 65 2c 20 26 6e 29 3b 0a 20 ovfl, &e, &n);.
33690 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e assert( n
336a0 3d 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 26 26 ==pPage->pgno &&
336b0 20 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 e==PTRMAP_OVERF
336c0 4c 4f 57 31 20 29 3b 0a 20 20 20 20 20 20 7d 0a LOW1 );. }.
336d0 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 65 if( !pPage
336e0 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 ->leaf ){.
336f0 20 20 50 67 6e 6f 20 63 68 69 6c 64 20 3d 20 67 Pgno child = g
33700 65 74 34 62 79 74 65 28 7a 29 3b 0a 20 20 20 20 et4byte(z);.
33710 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 42 ptrmapGet(pB
33720 74 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 26 6e t, child, &e, &n
33730 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
33740 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e t( n==pPage->pgn
33750 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 42 o && e==PTRMAP_B
33760 54 52 45 45 20 29 3b 0a 20 20 20 20 20 20 7d 0a TREE );. }.
33770 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21 70 }. if( !p
33780 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
33790 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 20 3d Pgno child =
337a0 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
337b0 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 ->aData[pPage->h
337c0 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 drOffset+8]);.
337d0 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 42 ptrmapGet(pB
337e0 74 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 26 6e t, child, &e, &n
337f0 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
33800 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 n==pPage->pgno
33810 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 && e==PTRMAP_BTR
33820 45 45 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a EE );. }. }.
33830 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 23 65 return 1;.}.#e
33840 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ndif../*.** This
33850 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
33860 64 20 74 6f 20 63 6f 70 79 20 74 68 65 20 63 6f d to copy the co
33870 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 62 2d ntents of the b-
33880 74 72 65 65 20 6e 6f 64 65 20 73 74 6f 72 65 64 tree node stored
33890 20 0a 2a 2a 20 6f 6e 20 70 61 67 65 20 70 46 72 .** on page pFr
338a0 6f 6d 20 74 6f 20 70 61 67 65 20 70 54 6f 2e 20 om to page pTo.
338b0 49 66 20 70 61 67 65 20 70 46 72 6f 6d 20 77 61 If page pFrom wa
338c0 73 20 6e 6f 74 20 61 20 6c 65 61 66 20 70 61 67 s not a leaf pag
338d0 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 70 e, then.** the p
338e0 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 ointer-map entri
338f0 65 73 20 66 6f 72 20 65 61 63 68 20 63 68 69 6c es for each chil
33900 64 20 70 61 67 65 20 61 72 65 20 75 70 64 61 74 d page are updat
33910 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 0a 2a ed so that the.*
33920 2a 20 70 61 72 65 6e 74 20 70 61 67 65 20 73 74 * parent page st
33930 6f 72 65 64 20 69 6e 20 74 68 65 20 70 6f 69 6e ored in the poin
33940 74 65 72 20 6d 61 70 20 69 73 20 70 61 67 65 20 ter map is page
33950 70 54 6f 2e 20 49 66 20 70 46 72 6f 6d 20 63 6f pTo. If pFrom co
33960 6e 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 79 20 63 ntained.** any c
33970 65 6c 6c 73 20 77 69 74 68 20 6f 76 65 72 66 6c ells with overfl
33980 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 73 ow page pointers
33990 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 72 72 65 , then the corre
339a0 73 70 6f 6e 64 69 6e 67 20 70 6f 69 6e 74 65 72 sponding pointer
339b0 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 69 65 73 20 .** map entries
339c0 61 72 65 20 61 6c 73 6f 20 75 70 64 61 74 65 64 are also updated
339d0 20 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 72 so that the par
339e0 65 6e 74 20 70 61 67 65 20 69 73 20 70 61 67 65 ent page is page
339f0 20 70 54 6f 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 pTo..**.** If p
33a00 46 72 6f 6d 20 69 73 20 63 75 72 72 65 6e 74 6c From is currentl
33a10 79 20 63 61 72 72 79 69 6e 67 20 61 6e 79 20 6f y carrying any o
33a20 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 28 65 verflow cells (e
33a30 6e 74 72 69 65 73 20 69 6e 20 74 68 65 0a 2a 2a ntries in the.**
33a40 20 4d 65 6d 50 61 67 65 2e 61 70 4f 76 66 6c 5b MemPage.apOvfl[
33a50 5d 20 61 72 72 61 79 29 2c 20 74 68 65 79 20 61 ] array), they a
33a60 72 65 20 6e 6f 74 20 63 6f 70 69 65 64 20 74 6f re not copied to
33a70 20 70 54 6f 2e 20 0a 2a 2a 0a 2a 2a 20 42 65 66 pTo. .**.** Bef
33a80 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2c 20 70 ore returning, p
33a90 61 67 65 20 70 54 6f 20 69 73 20 72 65 69 6e 69 age pTo is reini
33aa0 74 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 62 tialized using b
33ab0 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 2e 0a treeInitPage()..
33ac0 2a 2a 0a 2a 2a 20 54 68 65 20 70 65 72 66 6f 72 **.** The perfor
33ad0 6d 61 6e 63 65 20 6f 66 20 74 68 69 73 20 66 75 mance of this fu
33ae0 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 63 72 nction is not cr
33af0 69 74 69 63 61 6c 2e 20 49 74 20 69 73 20 6f 6e itical. It is on
33b00 6c 79 20 75 73 65 64 20 62 79 20 0a 2a 2a 20 74 ly used by .** t
33b10 68 65 20 62 61 6c 61 6e 63 65 5f 73 68 61 6c 6c he balance_shall
33b20 6f 77 65 72 28 29 20 61 6e 64 20 62 61 6c 61 6e ower() and balan
33b30 63 65 5f 64 65 65 70 65 72 28 29 20 70 72 6f 63 ce_deeper() proc
33b40 65 64 75 72 65 73 2c 20 6e 65 69 74 68 65 72 20 edures, neither
33b50 6f 66 0a 2a 2a 20 77 68 69 63 68 20 61 72 65 20 of.** which are
33b60 63 61 6c 6c 65 64 20 6f 66 74 65 6e 20 75 6e 64 called often und
33b70 65 72 20 6e 6f 72 6d 61 6c 20 63 69 72 63 75 6d er normal circum
33b80 73 74 61 6e 63 65 73 2e 0a 2a 2f 0a 73 74 61 74 stances..*/.stat
33b90 69 63 20 76 6f 69 64 20 63 6f 70 79 4e 6f 64 65 ic void copyNode
33ba0 43 6f 6e 74 65 6e 74 28 4d 65 6d 50 61 67 65 20 Content(MemPage
33bb0 2a 70 46 72 6f 6d 2c 20 4d 65 6d 50 61 67 65 20 *pFrom, MemPage
33bc0 2a 70 54 6f 2c 20 69 6e 74 20 2a 70 52 43 29 7b *pTo, int *pRC){
33bd0 0a 20 20 69 66 28 20 28 2a 70 52 43 29 3d 3d 53 . if( (*pRC)==S
33be0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
33bf0 42 74 53 68 61 72 65 64 20 2a 20 63 6f 6e 73 74 BtShared * const
33c00 20 70 42 74 20 3d 20 70 46 72 6f 6d 2d 3e 70 42 pBt = pFrom->pB
33c10 74 3b 0a 20 20 20 20 75 38 20 2a 20 63 6f 6e 73 t;. u8 * cons
33c20 74 20 61 46 72 6f 6d 20 3d 20 70 46 72 6f 6d 2d t aFrom = pFrom-
33c30 3e 61 44 61 74 61 3b 0a 20 20 20 20 75 38 20 2a >aData;. u8 *
33c40 20 63 6f 6e 73 74 20 61 54 6f 20 3d 20 70 54 6f const aTo = pTo
33c50 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 69 6e 74 ->aData;. int
33c60 20 63 6f 6e 73 74 20 69 46 72 6f 6d 48 64 72 20 const iFromHdr
33c70 3d 20 70 46 72 6f 6d 2d 3e 68 64 72 4f 66 66 73 = pFrom->hdrOffs
33c80 65 74 3b 0a 20 20 20 20 69 6e 74 20 63 6f 6e 73 et;. int cons
33c90 74 20 69 54 6f 48 64 72 20 3d 20 28 28 70 54 6f t iToHdr = ((pTo
33ca0 2d 3e 70 67 6e 6f 3d 3d 31 29 20 3f 20 31 30 30 ->pgno==1) ? 100
33cb0 20 3a 20 30 29 3b 0a 20 20 20 20 69 6e 74 20 72 : 0);. int r
33cc0 63 3b 0a 20 20 20 20 69 6e 74 20 69 44 61 74 61 c;. int iData
33cd0 3b 0a 20 20 0a 20 20 0a 20 20 20 20 61 73 73 65 ;. . . asse
33ce0 72 74 28 20 70 46 72 6f 6d 2d 3e 69 73 49 6e 69 rt( pFrom->isIni
33cf0 74 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 t );. assert(
33d00 20 70 46 72 6f 6d 2d 3e 6e 46 72 65 65 3e 3d 69 pFrom->nFree>=i
33d10 54 6f 48 64 72 20 29 3b 0a 20 20 20 20 61 73 73 ToHdr );. ass
33d20 65 72 74 28 20 67 65 74 32 62 79 74 65 28 26 61 ert( get2byte(&a
33d30 46 72 6f 6d 5b 69 46 72 6f 6d 48 64 72 2b 35 5d From[iFromHdr+5]
33d40 29 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e 75 ) <= (int)pBt->u
33d50 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 0a sableSize );. .
33d60 20 20 20 20 2f 2a 20 43 6f 70 79 20 74 68 65 20 /* Copy the
33d70 62 2d 74 72 65 65 20 6e 6f 64 65 20 63 6f 6e 74 b-tree node cont
33d80 65 6e 74 20 66 72 6f 6d 20 70 61 67 65 20 70 46 ent from page pF
33d90 72 6f 6d 20 74 6f 20 70 61 67 65 20 70 54 6f 2e rom to page pTo.
33da0 20 2a 2f 0a 20 20 20 20 69 44 61 74 61 20 3d 20 */. iData =
33db0 67 65 74 32 62 79 74 65 28 26 61 46 72 6f 6d 5b get2byte(&aFrom[
33dc0 69 46 72 6f 6d 48 64 72 2b 35 5d 29 3b 0a 20 20 iFromHdr+5]);.
33dd0 20 20 6d 65 6d 63 70 79 28 26 61 54 6f 5b 69 44 memcpy(&aTo[iD
33de0 61 74 61 5d 2c 20 26 61 46 72 6f 6d 5b 69 44 61 ata], &aFrom[iDa
33df0 74 61 5d 2c 20 70 42 74 2d 3e 75 73 61 62 6c 65 ta], pBt->usable
33e00 53 69 7a 65 2d 69 44 61 74 61 29 3b 0a 20 20 20 Size-iData);.
33e10 20 6d 65 6d 63 70 79 28 26 61 54 6f 5b 69 54 6f memcpy(&aTo[iTo
33e20 48 64 72 5d 2c 20 26 61 46 72 6f 6d 5b 69 46 72 Hdr], &aFrom[iFr
33e30 6f 6d 48 64 72 5d 2c 20 70 46 72 6f 6d 2d 3e 63 omHdr], pFrom->c
33e40 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 46 ellOffset + 2*pF
33e50 72 6f 6d 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 0a rom->nCell);. .
33e60 20 20 20 20 2f 2a 20 52 65 69 6e 69 74 69 61 6c /* Reinitial
33e70 69 7a 65 20 70 61 67 65 20 70 54 6f 20 73 6f 20 ize page pTo so
33e80 74 68 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 that the content
33e90 73 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 s of the MemPage
33ea0 20 73 74 72 75 63 74 75 72 65 0a 20 20 20 20 2a structure. *
33eb0 2a 20 6d 61 74 63 68 20 74 68 65 20 6e 65 77 20 * match the new
33ec0 64 61 74 61 2e 20 54 68 65 20 69 6e 69 74 69 61 data. The initia
33ed0 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 70 54 6f 20 lization of pTo
33ee0 63 61 6e 20 61 63 74 75 61 6c 6c 79 20 66 61 69 can actually fai
33ef0 6c 20 75 6e 64 65 72 0a 20 20 20 20 2a 2a 20 66 l under. ** f
33f00 61 69 72 6c 79 20 6f 62 73 63 75 72 65 20 63 69 airly obscure ci
33f10 72 63 75 6d 73 74 61 6e 63 65 73 2c 20 65 76 65 rcumstances, eve
33f20 6e 20 74 68 6f 75 67 68 20 69 74 20 69 73 20 61 n though it is a
33f30 20 63 6f 70 79 20 6f 66 20 69 6e 69 74 69 61 6c copy of initial
33f40 69 7a 65 64 20 0a 20 20 20 20 2a 2a 20 70 61 67 ized . ** pag
33f50 65 20 70 46 72 6f 6d 2e 0a 20 20 20 20 2a 2f 0a e pFrom.. */.
33f60 20 20 20 20 70 54 6f 2d 3e 69 73 49 6e 69 74 20 pTo->isInit
33f70 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 62 74 = 0;. rc = bt
33f80 72 65 65 49 6e 69 74 50 61 67 65 28 70 54 6f 29 reeInitPage(pTo)
33f90 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
33fa0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
33fb0 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 *pRC = rc;.
33fc0 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a return;. }.
33fd0 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 . /* If thi
33fe0 73 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 63 s is an auto-vac
33ff0 75 75 6d 20 64 61 74 61 62 61 73 65 2c 20 75 70 uum database, up
34000 64 61 74 65 20 74 68 65 20 70 6f 69 6e 74 65 72 date the pointer
34010 2d 6d 61 70 20 65 6e 74 72 69 65 73 0a 20 20 20 -map entries.
34020 20 2a 2a 20 66 6f 72 20 61 6e 79 20 62 2d 74 72 ** for any b-tr
34030 65 65 20 6f 72 20 6f 76 65 72 66 6c 6f 77 20 70 ee or overflow p
34040 61 67 65 73 20 74 68 61 74 20 70 54 6f 20 6e 6f ages that pTo no
34050 77 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 w contains the p
34060 6f 69 6e 74 65 72 73 20 74 6f 2e 0a 20 20 20 20 ointers to..
34070 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 41 55 54 */. if( ISAUT
34080 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 20 OVACUUM ){.
34090 20 2a 70 52 43 20 3d 20 73 65 74 43 68 69 6c 64 *pRC = setChild
340a0 50 74 72 6d 61 70 73 28 70 54 6f 29 3b 0a 20 20 Ptrmaps(pTo);.
340b0 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
340c0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 This routine re
340d0 64 69 73 74 72 69 62 75 74 65 73 20 63 65 6c 6c distributes cell
340e0 73 20 6f 6e 20 74 68 65 20 69 50 61 72 65 6e 74 s on the iParent
340f0 49 64 78 27 74 68 20 63 68 69 6c 64 20 6f 66 20 Idx'th child of
34100 70 50 61 72 65 6e 74 0a 2a 2a 20 28 68 65 72 65 pParent.** (here
34110 61 66 74 65 72 20 22 74 68 65 20 70 61 67 65 22 after "the page"
34120 29 20 61 6e 64 20 75 70 20 74 6f 20 32 20 73 69 ) and up to 2 si
34130 62 6c 69 6e 67 73 20 73 6f 20 74 68 61 74 20 61 blings so that a
34140 6c 6c 20 70 61 67 65 73 20 68 61 76 65 20 61 62 ll pages have ab
34150 6f 75 74 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 out the.** same
34160 61 6d 6f 75 6e 74 20 6f 66 20 66 72 65 65 20 73 amount of free s
34170 70 61 63 65 2e 20 55 73 75 61 6c 6c 79 20 61 20 pace. Usually a
34180 73 69 6e 67 6c 65 20 73 69 62 6c 69 6e 67 20 6f single sibling o
34190 6e 20 65 69 74 68 65 72 20 73 69 64 65 20 6f 66 n either side of
341a0 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 61 72 65 the.** page are
341b0 20 75 73 65 64 20 69 6e 20 74 68 65 20 62 61 6c used in the bal
341c0 61 6e 63 69 6e 67 2c 20 74 68 6f 75 67 68 20 62 ancing, though b
341d0 6f 74 68 20 73 69 62 6c 69 6e 67 73 20 6d 69 67 oth siblings mig
341e0 68 74 20 63 6f 6d 65 20 66 72 6f 6d 20 6f 6e 65 ht come from one
341f0 0a 2a 2a 20 73 69 64 65 20 69 66 20 74 68 65 20 .** side if the
34200 70 61 67 65 20 69 73 20 74 68 65 20 66 69 72 73 page is the firs
34210 74 20 6f 72 20 6c 61 73 74 20 63 68 69 6c 64 20 t or last child
34220 6f 66 20 69 74 73 20 70 61 72 65 6e 74 2e 20 49 of its parent. I
34230 66 20 74 68 65 20 70 61 67 65 20 0a 2a 2a 20 68 f the page .** h
34240 61 73 20 66 65 77 65 72 20 74 68 61 6e 20 32 20 as fewer than 2
34250 73 69 62 6c 69 6e 67 73 20 28 73 6f 6d 65 74 68 siblings (someth
34260 69 6e 67 20 77 68 69 63 68 20 63 61 6e 20 6f 6e ing which can on
34270 6c 79 20 68 61 70 70 65 6e 20 69 66 20 74 68 65 ly happen if the
34280 20 70 61 67 65 0a 2a 2a 20 69 73 20 61 20 72 6f page.** is a ro
34290 6f 74 20 70 61 67 65 20 6f 72 20 61 20 63 68 69 ot page or a chi
342a0 6c 64 20 6f 66 20 61 20 72 6f 6f 74 20 70 61 67 ld of a root pag
342b0 65 29 20 74 68 65 6e 20 61 6c 6c 20 61 76 61 69 e) then all avai
342c0 6c 61 62 6c 65 20 73 69 62 6c 69 6e 67 73 0a 2a lable siblings.*
342d0 2a 20 70 61 72 74 69 63 69 70 61 74 65 20 69 6e * participate in
342e0 20 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 2e 0a the balancing..
342f0 2a 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 **.** The number
34300 20 6f 66 20 73 69 62 6c 69 6e 67 73 20 6f 66 20 of siblings of
34310 74 68 65 20 70 61 67 65 20 6d 69 67 68 74 20 62 the page might b
34320 65 20 69 6e 63 72 65 61 73 65 64 20 6f 72 20 64 e increased or d
34330 65 63 72 65 61 73 65 64 20 62 79 20 0a 2a 2a 20 ecreased by .**
34340 6f 6e 65 20 6f 72 20 74 77 6f 20 69 6e 20 61 6e one or two in an
34350 20 65 66 66 6f 72 74 20 74 6f 20 6b 65 65 70 20 effort to keep
34360 70 61 67 65 73 20 6e 65 61 72 6c 79 20 66 75 6c pages nearly ful
34370 6c 20 62 75 74 20 6e 6f 74 20 6f 76 65 72 20 66 l but not over f
34380 75 6c 6c 2e 20 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 ull. .**.** Note
34390 20 74 68 61 74 20 77 68 65 6e 20 74 68 69 73 20 that when this
343a0 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
343b0 64 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 63 d, some of the c
343c0 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 61 67 65 ells on the page
343d0 0a 2a 2a 20 6d 69 67 68 74 20 6e 6f 74 20 61 63 .** might not ac
343e0 74 75 61 6c 6c 79 20 62 65 20 73 74 6f 72 65 64 tually be stored
343f0 20 69 6e 20 4d 65 6d 50 61 67 65 2e 61 44 61 74 in MemPage.aDat
34400 61 5b 5d 2e 20 54 68 69 73 20 63 61 6e 20 68 61 a[]. This can ha
34410 70 70 65 6e 0a 2a 2a 20 69 66 20 74 68 65 20 70 ppen.** if the p
34420 61 67 65 20 69 73 20 6f 76 65 72 66 75 6c 6c 2e age is overfull.
34430 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e This routine en
34440 73 75 72 65 73 20 74 68 61 74 20 61 6c 6c 20 63 sures that all c
34450 65 6c 6c 73 20 61 6c 6c 6f 63 61 74 65 64 0a 2a ells allocated.*
34460 2a 20 74 6f 20 74 68 65 20 70 61 67 65 20 61 6e * to the page an
34470 64 20 69 74 73 20 73 69 62 6c 69 6e 67 73 20 66 d its siblings f
34480 69 74 20 69 6e 74 6f 20 4d 65 6d 50 61 67 65 2e it into MemPage.
34490 61 44 61 74 61 5b 5d 20 62 65 66 6f 72 65 20 72 aData[] before r
344a0 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 eturning..**.**
344b0 49 6e 20 74 68 65 20 63 6f 75 72 73 65 20 6f 66 In the course of
344c0 20 62 61 6c 61 6e 63 69 6e 67 20 74 68 65 20 70 balancing the p
344d0 61 67 65 20 61 6e 64 20 69 74 73 20 73 69 62 6c age and its sibl
344e0 69 6e 67 73 2c 20 63 65 6c 6c 73 20 6d 61 79 20 ings, cells may
344f0 62 65 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 69 be.** inserted i
34500 6e 74 6f 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 nto or removed f
34510 72 6f 6d 20 74 68 65 20 70 61 72 65 6e 74 20 70 rom the parent p
34520 61 67 65 20 28 70 50 61 72 65 6e 74 29 2e 20 44 age (pParent). D
34530 6f 69 6e 67 20 73 6f 0a 2a 2a 20 6d 61 79 20 63 oing so.** may c
34540 61 75 73 65 20 74 68 65 20 70 61 72 65 6e 74 20 ause the parent
34550 70 61 67 65 20 74 6f 20 62 65 63 6f 6d 65 20 6f page to become o
34560 76 65 72 66 75 6c 6c 20 6f 72 20 75 6e 64 65 72 verfull or under
34570 66 75 6c 6c 2e 20 49 66 20 74 68 69 73 0a 2a 2a full. If this.**
34580 20 68 61 70 70 65 6e 73 2c 20 69 74 20 69 73 20 happens, it is
34590 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
345a0 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 ty of the caller
345b0 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 to invoke the c
345c0 6f 72 72 65 63 74 0a 2a 2a 20 62 61 6c 61 6e 63 orrect.** balanc
345d0 69 6e 67 20 72 6f 75 74 69 6e 65 20 74 6f 20 66 ing routine to f
345e0 69 78 20 74 68 69 73 20 70 72 6f 62 6c 65 6d 20 ix this problem
345f0 28 73 65 65 20 74 68 65 20 62 61 6c 61 6e 63 65 (see the balance
34600 28 29 20 72 6f 75 74 69 6e 65 29 2e 20 0a 2a 2a () routine). .**
34610 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75 74 .** If this rout
34620 69 6e 65 20 66 61 69 6c 73 20 66 6f 72 20 61 6e ine fails for an
34630 79 20 72 65 61 73 6f 6e 2c 20 69 74 20 6d 69 67 y reason, it mig
34640 68 74 20 6c 65 61 76 65 20 74 68 65 20 64 61 74 ht leave the dat
34650 61 62 61 73 65 0a 2a 2a 20 69 6e 20 61 20 63 6f abase.** in a co
34660 72 72 75 70 74 65 64 20 73 74 61 74 65 2e 20 53 rrupted state. S
34670 6f 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e o if this routin
34680 65 20 66 61 69 6c 73 2c 20 74 68 65 20 64 61 74 e fails, the dat
34690 61 62 61 73 65 20 73 68 6f 75 6c 64 0a 2a 2a 20 abase should.**
346a0 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a be rolled back..
346b0 2a 2a 0a 2a 2a 20 54 68 65 20 74 68 69 72 64 20 **.** The third
346c0 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 argument to this
346d0 20 66 75 6e 63 74 69 6f 6e 2c 20 61 4f 76 66 6c function, aOvfl
346e0 53 70 61 63 65 2c 20 69 73 20 61 20 70 6f 69 6e Space, is a poin
346f0 74 65 72 20 74 6f 20 61 0a 2a 2a 20 62 75 66 66 ter to a.** buff
34700 65 72 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f er big enough to
34710 20 68 6f 6c 64 20 6f 6e 65 20 70 61 67 65 2e 20 hold one page.
34720 49 66 20 77 68 69 6c 65 20 69 6e 73 65 72 74 69 If while inserti
34730 6e 67 20 63 65 6c 6c 73 20 69 6e 74 6f 20 74 68 ng cells into th
34740 65 20 70 61 72 65 6e 74 0a 2a 2a 20 70 61 67 65 e parent.** page
34750 20 28 70 50 61 72 65 6e 74 29 20 74 68 65 20 70 (pParent) the p
34760 61 72 65 6e 74 20 70 61 67 65 20 62 65 63 6f 6d arent page becom
34770 65 73 20 6f 76 65 72 66 75 6c 6c 2c 20 74 68 69 es overfull, thi
34780 73 20 62 75 66 66 65 72 20 69 73 0a 2a 2a 20 75 s buffer is.** u
34790 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 sed to store the
347a0 20 70 61 72 65 6e 74 27 73 20 6f 76 65 72 66 6c parent's overfl
347b0 6f 77 20 63 65 6c 6c 73 2e 20 42 65 63 61 75 73 ow cells. Becaus
347c0 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 e this function
347d0 69 6e 73 65 72 74 73 0a 2a 2a 20 61 20 6d 61 78 inserts.** a max
347e0 69 6d 75 6d 20 6f 66 20 66 6f 75 72 20 64 69 76 imum of four div
347f0 69 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 6f 20 ider cells into
34800 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2c the parent page,
34810 20 61 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 6d and the maximum
34820 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 61 20 63 65 .** size of a ce
34830 6c 6c 20 73 74 6f 72 65 64 20 77 69 74 68 69 6e ll stored within
34840 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 6e 6f 64 an internal nod
34850 65 20 69 73 20 61 6c 77 61 79 73 20 6c 65 73 73 e is always less
34860 20 74 68 61 6e 20 31 2f 34 0a 2a 2a 20 6f 66 20 than 1/4.** of
34870 74 68 65 20 70 61 67 65 2d 73 69 7a 65 2c 20 74 the page-size, t
34880 68 65 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d 20 he aOvflSpace[]
34890 62 75 66 66 65 72 20 69 73 20 67 75 61 72 61 6e buffer is guaran
348a0 74 65 65 64 20 74 6f 20 62 65 20 6c 61 72 67 65 teed to be large
348b0 0a 2a 2a 20 65 6e 6f 75 67 68 20 66 6f 72 20 61 .** enough for a
348c0 6c 6c 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c ll overflow cell
348d0 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 4f 76 66 s..**.** If aOvf
348e0 6c 53 70 61 63 65 20 69 73 20 73 65 74 20 74 6f lSpace is set to
348f0 20 61 20 6e 75 6c 6c 20 70 6f 69 6e 74 65 72 2c a null pointer,
34900 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
34910 65 74 75 72 6e 73 20 0a 2a 2a 20 53 51 4c 49 54 eturns .** SQLIT
34920 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f 0a 23 69 66 20 E_NOMEM..*/.#if
34930 64 65 66 69 6e 65 64 28 5f 4d 53 43 5f 56 45 52 defined(_MSC_VER
34940 29 20 26 26 20 5f 4d 53 43 5f 56 45 52 20 3e 3d ) && _MSC_VER >=
34950 20 31 37 30 30 20 26 26 20 64 65 66 69 6e 65 64 1700 && defined
34960 28 5f 4d 5f 41 52 4d 29 0a 23 70 72 61 67 6d 61 (_M_ARM).#pragma
34970 20 6f 70 74 69 6d 69 7a 65 28 22 22 2c 20 6f 66 optimize("", of
34980 66 29 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 f).#endif.static
34990 20 69 6e 74 20 62 61 6c 61 6e 63 65 5f 6e 6f 6e int balance_non
349a0 72 6f 6f 74 28 0a 20 20 4d 65 6d 50 61 67 65 20 root(. MemPage
349b0 2a 70 50 61 72 65 6e 74 2c 20 20 20 20 20 20 20 *pParent,
349c0 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 65 6e /* Paren
349d0 74 20 70 61 67 65 20 6f 66 20 73 69 62 6c 69 6e t page of siblin
349e0 67 73 20 62 65 69 6e 67 20 62 61 6c 61 6e 63 65 gs being balance
349f0 64 20 2a 2f 0a 20 20 69 6e 74 20 69 50 61 72 65 d */. int iPare
34a00 6e 74 49 64 78 2c 20 20 20 20 20 20 20 20 20 20 ntIdx,
34a10 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 /* Index
34a20 6f 66 20 22 74 68 65 20 70 61 67 65 22 20 69 6e of "the page" in
34a30 20 70 50 61 72 65 6e 74 20 2a 2f 0a 20 20 75 38 pParent */. u8
34a40 20 2a 61 4f 76 66 6c 53 70 61 63 65 2c 20 20 20 *aOvflSpace,
34a50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
34a60 20 70 61 67 65 2d 73 69 7a 65 20 62 79 74 65 73 page-size bytes
34a70 20 6f 66 20 73 70 61 63 65 20 66 6f 72 20 70 61 of space for pa
34a80 72 65 6e 74 20 6f 76 66 6c 20 2a 2f 0a 20 20 69 rent ovfl */. i
34a90 6e 74 20 69 73 52 6f 6f 74 2c 20 20 20 20 20 20 nt isRoot,
34aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
34ab0 2a 20 54 72 75 65 20 69 66 20 70 50 61 72 65 6e * True if pParen
34ac0 74 20 69 73 20 61 20 72 6f 6f 74 2d 70 61 67 65 t is a root-page
34ad0 20 2a 2f 0a 20 20 69 6e 74 20 62 42 75 6c 6b 20 */. int bBulk
34ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34af0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
34b00 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 70 61 this call is pa
34b10 72 74 20 6f 66 20 61 20 62 75 6c 6b 20 6c 6f 61 rt of a bulk loa
34b20 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 d */.){. BtShar
34b30 65 64 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 ed *pBt;
34b40 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 77 68 /* The wh
34b50 6f 6c 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a ole database */.
34b60 20 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 30 3b int nCell = 0;
34b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
34b80 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c * Number of cell
34b90 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 2a 2f s in apCell[] */
34ba0 0a 20 20 69 6e 74 20 6e 4d 61 78 43 65 6c 6c 73 . int nMaxCells
34bb0 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
34bc0 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 69 7a /* Allocated siz
34bd0 65 20 6f 66 20 61 70 43 65 6c 6c 2c 20 73 7a 43 e of apCell, szC
34be0 65 6c 6c 2c 20 61 46 72 6f 6d 2e 20 2a 2f 0a 20 ell, aFrom. */.
34bf0 20 69 6e 74 20 6e 4e 65 77 20 3d 20 30 3b 20 20 int nNew = 0;
34c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
34c10 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
34c20 20 69 6e 20 61 70 4e 65 77 5b 5d 20 2a 2f 0a 20 in apNew[] */.
34c30 20 69 6e 74 20 6e 4f 6c 64 3b 20 20 20 20 20 20 int nOld;
34c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
34c50 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
34c60 20 69 6e 20 61 70 4f 6c 64 5b 5d 20 2a 2f 0a 20 in apOld[] */.
34c70 20 69 6e 74 20 69 2c 20 6a 2c 20 6b 3b 20 20 20 int i, j, k;
34c80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
34c90 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 73 20 2a Loop counters *
34ca0 2f 0a 20 20 69 6e 74 20 6e 78 44 69 76 3b 20 20 /. int nxDiv;
34cb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34cc0 20 2f 2a 20 4e 65 78 74 20 64 69 76 69 64 65 72 /* Next divider
34cd0 20 73 6c 6f 74 20 69 6e 20 70 50 61 72 65 6e 74 slot in pParent
34ce0 2d 3e 61 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 20 69 ->aCell[] */. i
34cf0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
34d00 4b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 K; /* T
34d10 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 2a he return code *
34d20 2f 0a 20 20 75 31 36 20 6c 65 61 66 43 6f 72 72 /. u16 leafCorr
34d30 65 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 ection;
34d40 20 2f 2a 20 34 20 69 66 20 70 50 61 67 65 20 69 /* 4 if pPage i
34d50 73 20 61 20 6c 65 61 66 2e 20 20 30 20 69 66 20 s a leaf. 0 if
34d60 6e 6f 74 20 2a 2f 0a 20 20 69 6e 74 20 6c 65 61 not */. int lea
34d70 66 44 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 fData;
34d80 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
34d90 20 70 50 61 67 65 20 69 73 20 61 20 6c 65 61 66 pPage is a leaf
34da0 20 6f 66 20 61 20 4c 45 41 46 44 41 54 41 20 74 of a LEAFDATA t
34db0 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 ree */. int usa
34dc0 62 6c 65 53 70 61 63 65 3b 20 20 20 20 20 20 20 bleSpace;
34dd0 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 69 /* Bytes i
34de0 6e 20 70 50 61 67 65 20 62 65 79 6f 6e 64 20 74 n pPage beyond t
34df0 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 he header */. i
34e00 6e 74 20 70 61 67 65 46 6c 61 67 73 3b 20 20 20 nt pageFlags;
34e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
34e20 61 6c 75 65 20 6f 66 20 70 50 61 67 65 2d 3e 61 alue of pPage->a
34e30 44 61 74 61 5b 30 5d 20 2a 2f 0a 20 20 69 6e 74 Data[0] */. int
34e40 20 73 75 62 74 6f 74 61 6c 3b 20 20 20 20 20 20 subtotal;
34e50 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75 62 /* Sub
34e60 74 6f 74 61 6c 20 6f 66 20 62 79 74 65 73 20 69 total of bytes i
34e70 6e 20 63 65 6c 6c 73 20 6f 6e 20 6f 6e 65 20 70 n cells on one p
34e80 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 69 53 70 age */. int iSp
34e90 61 63 65 31 20 3d 20 30 3b 20 20 20 20 20 20 20 ace1 = 0;
34ea0 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 75 /* First u
34eb0 6e 75 73 65 64 20 62 79 74 65 20 6f 66 20 61 53 nused byte of aS
34ec0 70 61 63 65 31 5b 5d 20 2a 2f 0a 20 20 69 6e 74 pace1[] */. int
34ed0 20 69 4f 76 66 6c 53 70 61 63 65 20 3d 20 30 3b iOvflSpace = 0;
34ee0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
34ef0 73 74 20 75 6e 75 73 65 64 20 62 79 74 65 20 6f st unused byte o
34f00 66 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d 20 2a f aOvflSpace[] *
34f10 2f 0a 20 20 69 6e 74 20 73 7a 53 63 72 61 74 63 /. int szScratc
34f20 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
34f30 20 2f 2a 20 53 69 7a 65 20 6f 66 20 73 63 72 61 /* Size of scra
34f40 74 63 68 20 6d 65 6d 6f 72 79 20 72 65 71 75 65 tch memory reque
34f50 73 74 65 64 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 sted */. MemPag
34f60 65 20 2a 61 70 4f 6c 64 5b 4e 42 5d 3b 20 20 20 e *apOld[NB];
34f70 20 20 20 20 20 20 20 2f 2a 20 70 50 61 67 65 20 /* pPage
34f80 61 6e 64 20 75 70 20 74 6f 20 74 77 6f 20 73 69 and up to two si
34f90 62 6c 69 6e 67 73 20 2a 2f 0a 20 20 4d 65 6d 50 blings */. MemP
34fa0 61 67 65 20 2a 61 70 43 6f 70 79 5b 4e 42 5d 3b age *apCopy[NB];
34fb0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 69 76 /* Priv
34fc0 61 74 65 20 63 6f 70 69 65 73 20 6f 66 20 61 70 ate copies of ap
34fd0 4f 6c 64 5b 5d 20 70 61 67 65 73 20 2a 2f 0a 20 Old[] pages */.
34fe0 20 4d 65 6d 50 61 67 65 20 2a 61 70 4e 65 77 5b MemPage *apNew[
34ff0 4e 42 2b 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a NB+2]; /*
35000 20 70 50 61 67 65 20 61 6e 64 20 75 70 20 74 6f pPage and up to
35010 20 4e 42 20 73 69 62 6c 69 6e 67 73 20 61 66 74 NB siblings aft
35020 65 72 20 62 61 6c 61 6e 63 69 6e 67 20 2a 2f 0a er balancing */.
35030 20 20 75 38 20 2a 70 52 69 67 68 74 3b 20 20 20 u8 *pRight;
35040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
35050 2a 20 4c 6f 63 61 74 69 6f 6e 20 69 6e 20 70 61 * Location in pa
35060 72 65 6e 74 20 6f 66 20 72 69 67 68 74 2d 73 69 rent of right-si
35070 62 6c 69 6e 67 20 70 6f 69 6e 74 65 72 20 2a 2f bling pointer */
35080 0a 20 20 75 38 20 2a 61 70 44 69 76 5b 4e 42 2d . u8 *apDiv[NB-
35090 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 1];
350a0 2f 2a 20 44 69 76 69 64 65 72 20 63 65 6c 6c 73 /* Divider cells
350b0 20 69 6e 20 70 50 61 72 65 6e 74 20 2a 2f 0a 20 in pParent */.
350c0 20 69 6e 74 20 63 6e 74 4e 65 77 5b 4e 42 2b 32 int cntNew[NB+2
350d0 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ]; /*
350e0 20 49 6e 64 65 78 20 69 6e 20 61 43 65 6c 6c 5b Index in aCell[
350f0 5d 20 6f 66 20 63 65 6c 6c 20 61 66 74 65 72 20 ] of cell after
35100 69 2d 74 68 20 70 61 67 65 20 2a 2f 0a 20 20 69 i-th page */. i
35110 6e 74 20 73 7a 4e 65 77 5b 4e 42 2b 32 5d 3b 20 nt szNew[NB+2];
35120 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
35130 6f 6d 62 69 6e 65 64 20 73 69 7a 65 20 6f 66 20 ombined size of
35140 63 65 6c 6c 73 20 70 6c 61 63 65 20 6f 6e 20 69 cells place on i
35150 2d 74 68 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 -th page */. u8
35160 20 2a 2a 61 70 43 65 6c 6c 20 3d 20 30 3b 20 20 **apCell = 0;
35170 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c /* Al
35180 6c 20 63 65 6c 6c 73 20 62 65 67 69 6e 20 62 61 l cells begin ba
35190 6c 61 6e 63 65 64 20 2a 2f 0a 20 20 75 31 36 20 lanced */. u16
351a0 2a 73 7a 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 *szCell;
351b0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 /* Loca
351c0 6c 20 73 69 7a 65 20 6f 66 20 61 6c 6c 20 63 65 l size of all ce
351d0 6c 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 lls in apCell[]
351e0 2a 2f 0a 20 20 75 38 20 2a 61 53 70 61 63 65 31 */. u8 *aSpace1
351f0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
35200 20 20 2f 2a 20 53 70 61 63 65 20 66 6f 72 20 63 /* Space for c
35210 6f 70 69 65 73 20 6f 66 20 64 69 76 69 64 65 72 opies of divider
35220 73 20 63 65 6c 6c 73 20 2a 2f 0a 20 20 50 67 6e s cells */. Pgn
35230 6f 20 70 67 6e 6f 3b 20 20 20 20 20 20 20 20 20 o pgno;
35240 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d /* Tem
35250 70 20 76 61 72 20 74 6f 20 73 74 6f 72 65 20 61 p var to store a
35260 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 6e 20 page number in
35270 2a 2f 0a 0a 20 20 70 42 74 20 3d 20 70 50 61 72 */.. pBt = pPar
35280 65 6e 74 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 ent->pBt;. asse
35290 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
352a0 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
352b0 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
352c0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
352d0 69 74 65 61 62 6c 65 28 70 50 61 72 65 6e 74 2d iteable(pParent-
352e0 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 23 69 >pDbPage) );..#i
352f0 66 20 30 0a 20 20 54 52 41 43 45 28 28 22 42 41 f 0. TRACE(("BA
35300 4c 41 4e 43 45 3a 20 62 65 67 69 6e 20 70 61 67 LANCE: begin pag
35310 65 20 25 64 20 63 68 69 6c 64 20 6f 66 20 25 64 e %d child of %d
35320 5c 6e 22 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f \n", pPage->pgno
35330 2c 20 70 50 61 72 65 6e 74 2d 3e 70 67 6e 6f 29 , pParent->pgno)
35340 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 );.#endif.. /*
35350 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 70 50 At this point pP
35360 61 72 65 6e 74 20 6d 61 79 20 68 61 76 65 20 61 arent may have a
35370 74 20 6d 6f 73 74 20 6f 6e 65 20 6f 76 65 72 66 t most one overf
35380 6c 6f 77 20 63 65 6c 6c 2e 20 41 6e 64 20 69 66 low cell. And if
35390 0a 20 20 2a 2a 20 74 68 69 73 20 6f 76 65 72 66 . ** this overf
353a0 6c 6f 77 20 63 65 6c 6c 20 69 73 20 70 72 65 73 low cell is pres
353b0 65 6e 74 2c 20 69 74 20 6d 75 73 74 20 62 65 20 ent, it must be
353c0 74 68 65 20 63 65 6c 6c 20 77 69 74 68 20 0a 20 the cell with .
353d0 20 2a 2a 20 69 6e 64 65 78 20 69 50 61 72 65 6e ** index iParen
353e0 74 49 64 78 2e 20 54 68 69 73 20 73 63 65 6e 61 tIdx. This scena
353f0 72 69 6f 20 63 6f 6d 65 73 20 61 62 6f 75 74 20 rio comes about
35400 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
35410 6f 6e 0a 20 20 2a 2a 20 69 73 20 63 61 6c 6c 65 on. ** is calle
35420 64 20 28 69 6e 64 69 72 65 63 74 6c 79 29 20 66 d (indirectly) f
35430 72 6f 6d 20 73 71 6c 69 74 65 33 42 74 72 65 65 rom sqlite3Btree
35440 44 65 6c 65 74 65 28 29 2e 0a 20 20 2a 2f 0a 20 Delete().. */.
35450 20 61 73 73 65 72 74 28 20 70 50 61 72 65 6e 74 assert( pParent
35460 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 7c ->nOverflow==0 |
35470 7c 20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 | pParent->nOver
35480 66 6c 6f 77 3d 3d 31 20 29 3b 0a 20 20 61 73 73 flow==1 );. ass
35490 65 72 74 28 20 70 50 61 72 65 6e 74 2d 3e 6e 4f ert( pParent->nO
354a0 76 65 72 66 6c 6f 77 3d 3d 30 20 7c 7c 20 70 50 verflow==0 || pP
354b0 61 72 65 6e 74 2d 3e 61 69 4f 76 66 6c 5b 30 5d arent->aiOvfl[0]
354c0 3d 3d 69 50 61 72 65 6e 74 49 64 78 20 29 3b 0a ==iParentIdx );.
354d0 0a 20 20 69 66 28 20 21 61 4f 76 66 6c 53 70 61 . if( !aOvflSpa
354e0 63 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ce ){. return
354f0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
35500 20 7d 0a 0a 20 20 2f 2a 20 46 69 6e 64 20 74 68 }.. /* Find th
35510 65 20 73 69 62 6c 69 6e 67 20 70 61 67 65 73 20 e sibling pages
35520 74 6f 20 62 61 6c 61 6e 63 65 2e 20 41 6c 73 6f to balance. Also
35530 20 6c 6f 63 61 74 65 20 74 68 65 20 63 65 6c 6c locate the cell
35540 73 20 69 6e 20 70 50 61 72 65 6e 74 20 0a 20 20 s in pParent .
35550 2a 2a 20 74 68 61 74 20 64 69 76 69 64 65 20 74 ** that divide t
35560 68 65 20 73 69 62 6c 69 6e 67 73 2e 20 41 6e 20 he siblings. An
35570 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 attempt is made
35580 74 6f 20 66 69 6e 64 20 4e 4e 20 73 69 62 6c 69 to find NN sibli
35590 6e 67 73 20 6f 6e 20 0a 20 20 2a 2a 20 65 69 74 ngs on . ** eit
355a0 68 65 72 20 73 69 64 65 20 6f 66 20 70 50 61 67 her side of pPag
355b0 65 2e 20 4d 6f 72 65 20 73 69 62 6c 69 6e 67 73 e. More siblings
355c0 20 61 72 65 20 74 61 6b 65 6e 20 66 72 6f 6d 20 are taken from
355d0 6f 6e 65 20 73 69 64 65 2c 20 68 6f 77 65 76 65 one side, howeve
355e0 72 2c 20 0a 20 20 2a 2a 20 69 66 20 74 68 65 72 r, . ** if ther
355f0 65 20 61 72 65 20 66 65 77 65 72 20 74 68 61 6e e are fewer than
35600 20 4e 4e 20 73 69 62 6c 69 6e 67 73 20 6f 6e 20 NN siblings on
35610 74 68 65 20 6f 74 68 65 72 20 73 69 64 65 2e 20 the other side.
35620 49 66 20 70 50 61 72 65 6e 74 0a 20 20 2a 2a 20 If pParent. **
35630 68 61 73 20 4e 42 20 6f 72 20 66 65 77 65 72 20 has NB or fewer
35640 63 68 69 6c 64 72 65 6e 20 74 68 65 6e 20 61 6c children then al
35650 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66 20 70 50 l children of pP
35660 61 72 65 6e 74 20 61 72 65 20 74 61 6b 65 6e 2e arent are taken.
35670 20 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 . **. ** Thi
35680 73 20 6c 6f 6f 70 20 61 6c 73 6f 20 64 72 6f 70 s loop also drop
35690 73 20 74 68 65 20 64 69 76 69 64 65 72 20 63 65 s the divider ce
356a0 6c 6c 73 20 66 72 6f 6d 20 74 68 65 20 70 61 72 lls from the par
356b0 65 6e 74 20 70 61 67 65 2e 20 54 68 69 73 0a 20 ent page. This.
356c0 20 2a 2a 20 77 61 79 2c 20 74 68 65 20 72 65 6d ** way, the rem
356d0 61 69 6e 64 65 72 20 6f 66 20 74 68 65 20 66 75 ainder of the fu
356e0 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 nction does not
356f0 68 61 76 65 20 74 6f 20 64 65 61 6c 20 77 69 74 have to deal wit
35700 68 20 61 6e 79 0a 20 20 2a 2a 20 6f 76 65 72 66 h any. ** overf
35710 6c 6f 77 20 63 65 6c 6c 73 20 69 6e 20 74 68 65 low cells in the
35720 20 70 61 72 65 6e 74 20 70 61 67 65 2c 20 73 69 parent page, si
35730 6e 63 65 20 69 66 20 61 6e 79 20 65 78 69 73 74 nce if any exist
35740 65 64 20 74 68 65 79 20 77 69 6c 6c 0a 20 20 2a ed they will. *
35750 2a 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 * have already b
35760 65 65 6e 20 72 65 6d 6f 76 65 64 2e 0a 20 20 2a een removed.. *
35770 2f 0a 20 20 69 20 3d 20 70 50 61 72 65 6e 74 2d /. i = pParent-
35780 3e 6e 4f 76 65 72 66 6c 6f 77 20 2b 20 70 50 61 >nOverflow + pPa
35790 72 65 6e 74 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 69 rent->nCell;. i
357a0 66 28 20 69 3c 32 20 29 7b 0a 20 20 20 20 6e 78 f( i<2 ){. nx
357b0 44 69 76 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 Div = 0;. }else
357c0 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 62 42 {. assert( bB
357d0 75 6c 6b 3d 3d 30 20 7c 7c 20 62 42 75 6c 6b 3d ulk==0 || bBulk=
357e0 3d 31 20 29 3b 0a 20 20 20 20 69 66 28 20 69 50 =1 );. if( iP
357f0 61 72 65 6e 74 49 64 78 3d 3d 30 20 29 7b 20 20 arentIdx==0 ){
35800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a .
35810 20 20 20 20 20 20 6e 78 44 69 76 20 3d 20 30 3b nxDiv = 0;
35820 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69 . }else if( i
35830 50 61 72 65 6e 74 49 64 78 3d 3d 69 20 29 7b 0a ParentIdx==i ){.
35840 20 20 20 20 20 20 6e 78 44 69 76 20 3d 20 69 2d nxDiv = i-
35850 32 2b 62 42 75 6c 6b 3b 0a 20 20 20 20 7d 65 6c 2+bBulk;. }el
35860 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 se{. assert
35870 28 20 62 42 75 6c 6b 3d 3d 30 20 29 3b 0a 20 20 ( bBulk==0 );.
35880 20 20 20 20 6e 78 44 69 76 20 3d 20 69 50 61 72 nxDiv = iPar
35890 65 6e 74 49 64 78 2d 31 3b 0a 20 20 20 20 7d 0a entIdx-1;. }.
358a0 20 20 20 20 69 20 3d 20 32 2d 62 42 75 6c 6b 3b i = 2-bBulk;
358b0 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 3d 20 69 2b . }. nOld = i+
358c0 31 3b 0a 20 20 69 66 28 20 28 69 2b 6e 78 44 69 1;. if( (i+nxDi
358d0 76 2d 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 v-pParent->nOver
358e0 66 6c 6f 77 29 3d 3d 70 50 61 72 65 6e 74 2d 3e flow)==pParent->
358f0 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 70 52 69 nCell ){. pRi
35900 67 68 74 20 3d 20 26 70 50 61 72 65 6e 74 2d 3e ght = &pParent->
35910 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d 3e 68 aData[pParent->h
35920 64 72 4f 66 66 73 65 74 2b 38 5d 3b 0a 20 20 7d drOffset+8];. }
35930 65 6c 73 65 7b 0a 20 20 20 20 70 52 69 67 68 74 else{. pRight
35940 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 72 = findCell(pPar
35950 65 6e 74 2c 20 69 2b 6e 78 44 69 76 2d 70 50 61 ent, i+nxDiv-pPa
35960 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 29 rent->nOverflow)
35970 3b 0a 20 20 7d 0a 20 20 70 67 6e 6f 20 3d 20 67 ;. }. pgno = g
35980 65 74 34 62 79 74 65 28 70 52 69 67 68 74 29 3b et4byte(pRight);
35990 0a 20 20 77 68 69 6c 65 28 20 31 20 29 7b 0a 20 . while( 1 ){.
359a0 20 20 20 72 63 20 3d 20 67 65 74 41 6e 64 49 6e rc = getAndIn
359b0 69 74 50 61 67 65 28 70 42 74 2c 20 70 67 6e 6f itPage(pBt, pgno
359c0 2c 20 26 61 70 4f 6c 64 5b 69 5d 2c 20 30 29 3b , &apOld[i], 0);
359d0 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 . if( rc ){.
359e0 20 20 20 20 20 6d 65 6d 73 65 74 28 61 70 4f 6c memset(apOl
359f0 64 2c 20 30 2c 20 28 69 2b 31 29 2a 73 69 7a 65 d, 0, (i+1)*size
35a00 6f 66 28 4d 65 6d 50 61 67 65 2a 29 29 3b 0a 20 of(MemPage*));.
35a10 20 20 20 20 20 67 6f 74 6f 20 62 61 6c 61 6e 63 goto balanc
35a20 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 20 20 20 7d e_cleanup;. }
35a30 0a 20 20 20 20 6e 4d 61 78 43 65 6c 6c 73 20 2b . nMaxCells +
35a40 3d 20 31 2b 61 70 4f 6c 64 5b 69 5d 2d 3e 6e 43 = 1+apOld[i]->nC
35a50 65 6c 6c 2b 61 70 4f 6c 64 5b 69 5d 2d 3e 6e 4f ell+apOld[i]->nO
35a60 76 65 72 66 6c 6f 77 3b 0a 20 20 20 20 69 66 28 verflow;. if(
35a70 20 28 69 2d 2d 29 3d 3d 30 20 29 20 62 72 65 61 (i--)==0 ) brea
35a80 6b 3b 0a 0a 20 20 20 20 69 66 28 20 69 2b 6e 78 k;.. if( i+nx
35a90 44 69 76 3d 3d 70 50 61 72 65 6e 74 2d 3e 61 69 Div==pParent->ai
35aa0 4f 76 66 6c 5b 30 5d 20 26 26 20 70 50 61 72 65 Ovfl[0] && pPare
35ab0 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 7b nt->nOverflow ){
35ac0 0a 20 20 20 20 20 20 61 70 44 69 76 5b 69 5d 20 . apDiv[i]
35ad0 3d 20 70 50 61 72 65 6e 74 2d 3e 61 70 4f 76 66 = pParent->apOvf
35ae0 6c 5b 30 5d 3b 0a 20 20 20 20 20 20 70 67 6e 6f l[0];. pgno
35af0 20 3d 20 67 65 74 34 62 79 74 65 28 61 70 44 69 = get4byte(apDi
35b00 76 5b 69 5d 29 3b 0a 20 20 20 20 20 20 73 7a 4e v[i]);. szN
35b10 65 77 5b 69 5d 20 3d 20 63 65 6c 6c 53 69 7a 65 ew[i] = cellSize
35b20 50 74 72 28 70 50 61 72 65 6e 74 2c 20 61 70 44 Ptr(pParent, apD
35b30 69 76 5b 69 5d 29 3b 0a 20 20 20 20 20 20 70 50 iv[i]);. pP
35b40 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 arent->nOverflow
35b50 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b = 0;. }else{
35b60 0a 20 20 20 20 20 20 61 70 44 69 76 5b 69 5d 20 . apDiv[i]
35b70 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 72 65 = findCell(pPare
35b80 6e 74 2c 20 69 2b 6e 78 44 69 76 2d 70 50 61 72 nt, i+nxDiv-pPar
35b90 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 29 3b ent->nOverflow);
35ba0 0a 20 20 20 20 20 20 70 67 6e 6f 20 3d 20 67 65 . pgno = ge
35bb0 74 34 62 79 74 65 28 61 70 44 69 76 5b 69 5d 29 t4byte(apDiv[i])
35bc0 3b 0a 20 20 20 20 20 20 73 7a 4e 65 77 5b 69 5d ;. szNew[i]
35bd0 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 = cellSizePtr(p
35be0 50 61 72 65 6e 74 2c 20 61 70 44 69 76 5b 69 5d Parent, apDiv[i]
35bf0 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 44 72 6f );.. /* Dro
35c00 70 20 74 68 65 20 63 65 6c 6c 20 66 72 6f 6d 20 p the cell from
35c10 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e the parent page.
35c20 20 61 70 44 69 76 5b 69 5d 20 73 74 69 6c 6c 20 apDiv[i] still
35c30 70 6f 69 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 points to.
35c40 2a 2a 20 74 68 65 20 63 65 6c 6c 20 77 69 74 68 ** the cell with
35c50 69 6e 20 74 68 65 20 70 61 72 65 6e 74 2c 20 65 in the parent, e
35c60 76 65 6e 20 74 68 6f 75 67 68 20 69 74 20 68 61 ven though it ha
35c70 73 20 62 65 65 6e 20 64 72 6f 70 70 65 64 2e 0a s been dropped..
35c80 20 20 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 ** This is
35c90 20 73 61 66 65 20 62 65 63 61 75 73 65 20 64 72 safe because dr
35ca0 6f 70 70 69 6e 67 20 61 20 63 65 6c 6c 20 6f 6e opping a cell on
35cb0 6c 79 20 6f 76 65 72 77 72 69 74 65 73 20 74 68 ly overwrites th
35cc0 65 20 66 69 72 73 74 0a 20 20 20 20 20 20 2a 2a e first. **
35cd0 20 66 6f 75 72 20 62 79 74 65 73 20 6f 66 20 69 four bytes of i
35ce0 74 2c 20 61 6e 64 20 74 68 69 73 20 66 75 6e 63 t, and this func
35cf0 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 6e 65 tion does not ne
35d00 65 64 20 74 68 65 20 66 69 72 73 74 0a 20 20 20 ed the first.
35d10 20 20 20 2a 2a 20 66 6f 75 72 20 62 79 74 65 73 ** four bytes
35d20 20 6f 66 20 74 68 65 20 64 69 76 69 64 65 72 20 of the divider
35d30 63 65 6c 6c 2e 20 53 6f 20 74 68 65 20 70 6f 69 cell. So the poi
35d40 6e 74 65 72 20 69 73 20 73 61 66 65 20 74 6f 20 nter is safe to
35d50 75 73 65 0a 20 20 20 20 20 20 2a 2a 20 6c 61 74 use. ** lat
35d60 65 72 20 6f 6e 2e 20 20 0a 20 20 20 20 20 20 2a er on. . *
35d70 2a 0a 20 20 20 20 20 20 2a 2a 20 42 75 74 20 6e *. ** But n
35d80 6f 74 20 69 66 20 77 65 20 61 72 65 20 69 6e 20 ot if we are in
35d90 73 65 63 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f secure-delete mo
35da0 64 65 2e 20 49 6e 20 73 65 63 75 72 65 2d 64 65 de. In secure-de
35db0 6c 65 74 65 20 6d 6f 64 65 2c 0a 20 20 20 20 20 lete mode,.
35dc0 20 2a 2a 20 74 68 65 20 64 72 6f 70 43 65 6c 6c ** the dropCell
35dd0 28 29 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 () routine will
35de0 6f 76 65 72 77 72 69 74 65 20 74 68 65 20 65 6e overwrite the en
35df0 74 69 72 65 20 63 65 6c 6c 20 77 69 74 68 20 7a tire cell with z
35e00 65 72 6f 65 73 2e 0a 20 20 20 20 20 20 2a 2a 20 eroes.. **
35e10 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 74 65 In this case, te
35e20 6d 70 6f 72 61 72 69 6c 79 20 63 6f 70 79 20 74 mporarily copy t
35e30 68 65 20 63 65 6c 6c 20 69 6e 74 6f 20 74 68 65 he cell into the
35e40 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d 0a 20 20 aOvflSpace[].
35e50 20 20 20 20 2a 2a 20 62 75 66 66 65 72 2e 20 49 ** buffer. I
35e60 74 20 77 69 6c 6c 20 62 65 20 63 6f 70 69 65 64 t will be copied
35e70 20 6f 75 74 20 61 67 61 69 6e 20 61 73 20 73 6f out again as so
35e80 6f 6e 20 61 73 20 74 68 65 20 61 53 70 61 63 65 on as the aSpace
35e90 5b 5d 20 62 75 66 66 65 72 0a 20 20 20 20 20 20 [] buffer.
35ea0 2a 2a 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 2e ** is allocated.
35eb0 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 */. if( p
35ec0 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
35ed0 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 TS_SECURE_DELETE
35ee0 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 ){. int
35ef0 69 4f 66 66 3b 0a 0a 20 20 20 20 20 20 20 20 69 iOff;.. i
35f00 4f 66 66 20 3d 20 53 51 4c 49 54 45 5f 50 54 52 Off = SQLITE_PTR
35f10 5f 54 4f 5f 49 4e 54 28 61 70 44 69 76 5b 69 5d _TO_INT(apDiv[i]
35f20 29 20 2d 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 ) - SQLITE_PTR_T
35f30 4f 5f 49 4e 54 28 70 50 61 72 65 6e 74 2d 3e 61 O_INT(pParent->a
35f40 44 61 74 61 29 3b 0a 20 20 20 20 20 20 20 20 69 Data);. i
35f50 66 28 20 28 69 4f 66 66 2b 73 7a 4e 65 77 5b 69 f( (iOff+szNew[i
35f60 5d 29 3e 28 69 6e 74 29 70 42 74 2d 3e 75 73 61 ])>(int)pBt->usa
35f70 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 bleSize ){.
35f80 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
35f90 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
35fa0 20 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 memset(
35fb0 61 70 4f 6c 64 2c 20 30 2c 20 28 69 2b 31 29 2a apOld, 0, (i+1)*
35fc0 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 2a 29 sizeof(MemPage*)
35fd0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 );. got
35fe0 6f 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 o balance_cleanu
35ff0 70 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 p;. }else
36000 7b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 {. memc
36010 70 79 28 26 61 4f 76 66 6c 53 70 61 63 65 5b 69 py(&aOvflSpace[i
36020 4f 66 66 5d 2c 20 61 70 44 69 76 5b 69 5d 2c 20 Off], apDiv[i],
36030 73 7a 4e 65 77 5b 69 5d 29 3b 0a 20 20 20 20 20 szNew[i]);.
36040 20 20 20 20 20 61 70 44 69 76 5b 69 5d 20 3d 20 apDiv[i] =
36050 26 61 4f 76 66 6c 53 70 61 63 65 5b 61 70 44 69 &aOvflSpace[apDi
36060 76 5b 69 5d 2d 70 50 61 72 65 6e 74 2d 3e 61 44 v[i]-pParent->aD
36070 61 74 61 5d 3b 0a 20 20 20 20 20 20 20 20 7d 0a ata];. }.
36080 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 64 72 }. dr
36090 6f 70 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 opCell(pParent,
360a0 69 2b 6e 78 44 69 76 2d 70 50 61 72 65 6e 74 2d i+nxDiv-pParent-
360b0 3e 6e 4f 76 65 72 66 6c 6f 77 2c 20 73 7a 4e 65 >nOverflow, szNe
360c0 77 5b 69 5d 2c 20 26 72 63 29 3b 0a 20 20 20 20 w[i], &rc);.
360d0 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b 65 }. }.. /* Make
360e0 20 6e 4d 61 78 43 65 6c 6c 73 20 61 20 6d 75 6c nMaxCells a mul
360f0 74 69 70 6c 65 20 6f 66 20 34 20 69 6e 20 6f 72 tiple of 4 in or
36100 64 65 72 20 74 6f 20 70 72 65 73 65 72 76 65 20 der to preserve
36110 38 2d 62 79 74 65 0a 20 20 2a 2a 20 61 6c 69 67 8-byte. ** alig
36120 6e 6d 65 6e 74 20 2a 2f 0a 20 20 6e 4d 61 78 43 nment */. nMaxC
36130 65 6c 6c 73 20 3d 20 28 6e 4d 61 78 43 65 6c 6c ells = (nMaxCell
36140 73 20 2b 20 33 29 26 7e 33 3b 0a 0a 20 20 2f 2a s + 3)&~3;.. /*
36150 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 73 . ** Allocate s
36160 70 61 63 65 20 66 6f 72 20 6d 65 6d 6f 72 79 20 pace for memory
36170 73 74 72 75 63 74 75 72 65 73 0a 20 20 2a 2f 0a structures. */.
36180 20 20 6b 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 k = pBt->pageS
36190 69 7a 65 20 2b 20 52 4f 55 4e 44 38 28 73 69 7a ize + ROUND8(siz
361a0 65 6f 66 28 4d 65 6d 50 61 67 65 29 29 3b 0a 20 eof(MemPage));.
361b0 20 73 7a 53 63 72 61 74 63 68 20 3d 0a 20 20 20 szScratch =.
361c0 20 20 20 20 6e 4d 61 78 43 65 6c 6c 73 2a 73 69 nMaxCells*si
361d0 7a 65 6f 66 28 75 38 2a 29 20 20 20 20 20 20 20 zeof(u8*)
361e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
361f0 2f 2a 20 61 70 43 65 6c 6c 20 2a 2f 0a 20 20 20 /* apCell */.
36200 20 20 2b 20 6e 4d 61 78 43 65 6c 6c 73 2a 73 69 + nMaxCells*si
36210 7a 65 6f 66 28 75 31 36 29 20 20 20 20 20 20 20 zeof(u16)
36220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36230 2f 2a 20 73 7a 43 65 6c 6c 20 2a 2f 0a 20 20 20 /* szCell */.
36240 20 20 2b 20 70 42 74 2d 3e 70 61 67 65 53 69 7a + pBt->pageSiz
36250 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e
36260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36270 2f 2a 20 61 53 70 61 63 65 31 20 2a 2f 0a 20 20 /* aSpace1 */.
36280 20 20 20 2b 20 6b 2a 6e 4f 6c 64 3b 20 20 20 20 + k*nOld;
36290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
362a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
362b0 20 2f 2a 20 50 61 67 65 20 63 6f 70 69 65 73 20 /* Page copies
362c0 28 61 70 43 6f 70 79 29 20 2a 2f 0a 20 20 61 70 (apCopy) */. ap
362d0 43 65 6c 6c 20 3d 20 73 71 6c 69 74 65 33 53 63 Cell = sqlite3Sc
362e0 72 61 74 63 68 4d 61 6c 6c 6f 63 28 20 73 7a 53 ratchMalloc( szS
362f0 63 72 61 74 63 68 20 29 3b 20 0a 20 20 69 66 28 cratch ); . if(
36300 20 61 70 43 65 6c 6c 3d 3d 30 20 29 7b 0a 20 20 apCell==0 ){.
36310 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
36320 4d 45 4d 3b 0a 20 20 20 20 67 6f 74 6f 20 62 61 MEM;. goto ba
36330 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 lance_cleanup;.
36340 20 7d 0a 20 20 73 7a 43 65 6c 6c 20 3d 20 28 75 }. szCell = (u
36350 31 36 2a 29 26 61 70 43 65 6c 6c 5b 6e 4d 61 78 16*)&apCell[nMax
36360 43 65 6c 6c 73 5d 3b 0a 20 20 61 53 70 61 63 65 Cells];. aSpace
36370 31 20 3d 20 28 75 38 2a 29 26 73 7a 43 65 6c 6c 1 = (u8*)&szCell
36380 5b 6e 4d 61 78 43 65 6c 6c 73 5d 3b 0a 20 20 61 [nMaxCells];. a
36390 73 73 65 72 74 28 20 45 49 47 48 54 5f 42 59 54 ssert( EIGHT_BYT
363a0 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 61 53 70 61 E_ALIGNMENT(aSpa
363b0 63 65 31 29 20 29 3b 0a 0a 20 20 2f 2a 0a 20 20 ce1) );.. /*.
363c0 2a 2a 20 4c 6f 61 64 20 70 6f 69 6e 74 65 72 73 ** Load pointers
363d0 20 74 6f 20 61 6c 6c 20 63 65 6c 6c 73 20 6f 6e to all cells on
363e0 20 73 69 62 6c 69 6e 67 20 70 61 67 65 73 20 61 sibling pages a
363f0 6e 64 20 74 68 65 20 64 69 76 69 64 65 72 20 63 nd the divider c
36400 65 6c 6c 73 0a 20 20 2a 2a 20 69 6e 74 6f 20 74 ells. ** into t
36410 68 65 20 6c 6f 63 61 6c 20 61 70 43 65 6c 6c 5b he local apCell[
36420 5d 20 61 72 72 61 79 2e 20 20 4d 61 6b 65 20 63 ] array. Make c
36430 6f 70 69 65 73 20 6f 66 20 74 68 65 20 64 69 76 opies of the div
36440 69 64 65 72 20 63 65 6c 6c 73 0a 20 20 2a 2a 20 ider cells. **
36450 69 6e 74 6f 20 73 70 61 63 65 20 6f 62 74 61 69 into space obtai
36460 6e 65 64 20 66 72 6f 6d 20 61 53 70 61 63 65 31 ned from aSpace1
36470 5b 5d 20 61 6e 64 20 72 65 6d 6f 76 65 20 74 68 [] and remove th
36480 65 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 0a e divider cells.
36490 20 20 2a 2a 20 66 72 6f 6d 20 70 50 61 72 65 6e ** from pParen
364a0 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 t.. **. ** If
364b0 74 68 65 20 73 69 62 6c 69 6e 67 73 20 61 72 65 the siblings are
364c0 20 6f 6e 20 6c 65 61 66 20 70 61 67 65 73 2c 20 on leaf pages,
364d0 74 68 65 6e 20 74 68 65 20 63 68 69 6c 64 20 70 then the child p
364e0 6f 69 6e 74 65 72 73 20 6f 66 20 74 68 65 0a 20 ointers of the.
364f0 20 2a 2a 20 64 69 76 69 64 65 72 20 63 65 6c 6c ** divider cell
36500 73 20 61 72 65 20 73 74 72 69 70 70 65 64 20 66 s are stripped f
36510 72 6f 6d 20 74 68 65 20 63 65 6c 6c 73 20 62 65 rom the cells be
36520 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 63 6f fore they are co
36530 70 69 65 64 0a 20 20 2a 2a 20 69 6e 74 6f 20 61 pied. ** into a
36540 53 70 61 63 65 31 5b 5d 2e 20 20 49 6e 20 74 68 Space1[]. In th
36550 69 73 20 77 61 79 2c 20 61 6c 6c 20 63 65 6c 6c is way, all cell
36560 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 61 72 s in apCell[] ar
36570 65 20 77 69 74 68 6f 75 74 0a 20 20 2a 2a 20 63 e without. ** c
36580 68 69 6c 64 20 70 6f 69 6e 74 65 72 73 2e 20 20 hild pointers.
36590 49 66 20 73 69 62 6c 69 6e 67 73 20 61 72 65 20 If siblings are
365a0 6e 6f 74 20 6c 65 61 76 65 73 2c 20 74 68 65 6e not leaves, then
365b0 20 61 6c 6c 20 63 65 6c 6c 20 69 6e 0a 20 20 2a all cell in. *
365c0 2a 20 61 70 43 65 6c 6c 5b 5d 20 69 6e 63 6c 75 * apCell[] inclu
365d0 64 65 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 de child pointer
365e0 73 2e 20 20 45 69 74 68 65 72 20 77 61 79 2c 20 s. Either way,
365f0 61 6c 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 all cells in apC
36600 65 6c 6c 5b 5d 0a 20 20 2a 2a 20 61 72 65 20 61 ell[]. ** are a
36610 6c 69 6b 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 like.. **. **
36620 6c 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 3a 20 leafCorrection:
36630 20 34 20 69 66 20 70 50 61 67 65 20 69 73 20 61 4 if pPage is a
36640 20 6c 65 61 66 2e 20 20 30 20 69 66 20 70 50 61 leaf. 0 if pPa
36650 67 65 20 69 73 20 6e 6f 74 20 61 20 6c 65 61 66 ge is not a leaf
36660 2e 0a 20 20 2a 2a 20 20 20 20 20 20 20 6c 65 61 .. ** lea
36670 66 44 61 74 61 3a 20 20 31 20 69 66 20 70 50 61 fData: 1 if pPa
36680 67 65 20 68 6f 6c 64 73 20 6b 65 79 2b 64 61 74 ge holds key+dat
36690 61 20 61 6e 64 20 70 50 61 72 65 6e 74 20 68 6f a and pParent ho
366a0 6c 64 73 20 6f 6e 6c 79 20 6b 65 79 73 2e 0a 20 lds only keys..
366b0 20 2a 2f 0a 20 20 6c 65 61 66 43 6f 72 72 65 63 */. leafCorrec
366c0 74 69 6f 6e 20 3d 20 61 70 4f 6c 64 5b 30 5d 2d tion = apOld[0]-
366d0 3e 6c 65 61 66 2a 34 3b 0a 20 20 6c 65 61 66 44 >leaf*4;. leafD
366e0 61 74 61 20 3d 20 61 70 4f 6c 64 5b 30 5d 2d 3e ata = apOld[0]->
366f0 69 6e 74 4b 65 79 4c 65 61 66 3b 0a 20 20 66 6f intKeyLeaf;. fo
36700 72 28 69 3d 30 3b 20 69 3c 6e 4f 6c 64 3b 20 69 r(i=0; i<nOld; i
36710 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 69 6d ++){. int lim
36720 69 74 3b 0a 20 20 20 20 0a 20 20 20 20 2f 2a 20 it;. . /*
36730 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 61 6e 79 Before doing any
36740 74 68 69 6e 67 20 65 6c 73 65 2c 20 74 61 6b 65 thing else, take
36750 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 69 a copy of the i
36760 27 74 68 20 6f 72 69 67 69 6e 61 6c 20 73 69 62 'th original sib
36770 6c 69 6e 67 0a 20 20 20 20 2a 2a 20 54 68 65 20 ling. ** The
36780 72 65 73 74 20 6f 66 20 74 68 69 73 20 66 75 6e rest of this fun
36790 63 74 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20 64 ction will use d
367a0 61 74 61 20 66 72 6f 6d 20 74 68 65 20 63 6f 70 ata from the cop
367b0 69 65 73 20 72 61 74 68 65 72 0a 20 20 20 20 2a ies rather. *
367c0 2a 20 74 68 61 74 20 74 68 65 20 6f 72 69 67 69 * that the origi
367d0 6e 61 6c 20 70 61 67 65 73 20 73 69 6e 63 65 20 nal pages since
367e0 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 67 the original pag
367f0 65 73 20 77 69 6c 6c 20 62 65 20 69 6e 20 74 68 es will be in th
36800 65 0a 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 e. ** process
36810 20 6f 66 20 62 65 69 6e 67 20 6f 76 65 72 77 72 of being overwr
36820 69 74 74 65 6e 2e 20 20 2a 2f 0a 20 20 20 20 4d itten. */. M
36830 65 6d 50 61 67 65 20 2a 70 4f 6c 64 20 3d 20 61 emPage *pOld = a
36840 70 43 6f 70 79 5b 69 5d 20 3d 20 28 4d 65 6d 50 pCopy[i] = (MemP
36850 61 67 65 2a 29 26 61 53 70 61 63 65 31 5b 70 42 age*)&aSpace1[pB
36860 74 2d 3e 70 61 67 65 53 69 7a 65 20 2b 20 6b 2a t->pageSize + k*
36870 69 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 i];. memcpy(p
36880 4f 6c 64 2c 20 61 70 4f 6c 64 5b 69 5d 2c 20 73 Old, apOld[i], s
36890 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 29 3b izeof(MemPage));
368a0 0a 20 20 20 20 70 4f 6c 64 2d 3e 61 44 61 74 61 . pOld->aData
368b0 20 3d 20 28 76 6f 69 64 2a 29 26 70 4f 6c 64 5b = (void*)&pOld[
368c0 31 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 1];. memcpy(p
368d0 4f 6c 64 2d 3e 61 44 61 74 61 2c 20 61 70 4f 6c Old->aData, apOl
368e0 64 5b 69 5d 2d 3e 61 44 61 74 61 2c 20 70 42 74 d[i]->aData, pBt
368f0 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 0a 20 20 ->pageSize);..
36900 20 20 6c 69 6d 69 74 20 3d 20 70 4f 6c 64 2d 3e limit = pOld->
36910 6e 43 65 6c 6c 2b 70 4f 6c 64 2d 3e 6e 4f 76 65 nCell+pOld->nOve
36920 72 66 6c 6f 77 3b 0a 20 20 20 20 69 66 28 20 70 rflow;. if( p
36930 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3e 30 Old->nOverflow>0
36940 20 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d ){. for(j=
36950 30 3b 20 6a 3c 6c 69 6d 69 74 3b 20 6a 2b 2b 29 0; j<limit; j++)
36960 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
36970 28 20 6e 43 65 6c 6c 3c 6e 4d 61 78 43 65 6c 6c ( nCell<nMaxCell
36980 73 20 29 3b 0a 20 20 20 20 20 20 20 20 61 70 43 s );. apC
36990 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 66 69 6e ell[nCell] = fin
369a0 64 4f 76 65 72 66 6c 6f 77 43 65 6c 6c 28 70 4f dOverflowCell(pO
369b0 6c 64 2c 20 6a 29 3b 0a 20 20 20 20 20 20 20 20 ld, j);.
369c0 73 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 szCell[nCell] =
369d0 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 4f 6c 64 cellSizePtr(pOld
369e0 2c 20 61 70 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 29 , apCell[nCell])
369f0 3b 0a 20 20 20 20 20 20 20 20 6e 43 65 6c 6c 2b ;. nCell+
36a00 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d +;. }. }
36a10 65 6c 73 65 7b 0a 20 20 20 20 20 20 75 38 20 2a else{. u8 *
36a20 61 44 61 74 61 20 3d 20 70 4f 6c 64 2d 3e 61 44 aData = pOld->aD
36a30 61 74 61 3b 0a 20 20 20 20 20 20 75 31 36 20 6d ata;. u16 m
36a40 61 73 6b 50 61 67 65 20 3d 20 70 4f 6c 64 2d 3e askPage = pOld->
36a50 6d 61 73 6b 50 61 67 65 3b 0a 20 20 20 20 20 20 maskPage;.
36a60 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d u16 cellOffset =
36a70 20 70 4f 6c 64 2d 3e 63 65 6c 6c 4f 66 66 73 65 pOld->cellOffse
36a80 74 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 t;. for(j=0
36a90 3b 20 6a 3c 6c 69 6d 69 74 3b 20 6a 2b 2b 29 7b ; j<limit; j++){
36aa0 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
36ab0 20 6e 43 65 6c 6c 3c 6e 4d 61 78 43 65 6c 6c 73 nCell<nMaxCells
36ac0 20 29 3b 0a 20 20 20 20 20 20 20 20 61 70 43 65 );. apCe
36ad0 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 66 69 6e 64 ll[nCell] = find
36ae0 43 65 6c 6c 76 32 28 61 44 61 74 61 2c 20 6d 61 Cellv2(aData, ma
36af0 73 6b 50 61 67 65 2c 20 63 65 6c 6c 4f 66 66 73 skPage, cellOffs
36b00 65 74 2c 20 6a 29 3b 0a 20 20 20 20 20 20 20 20 et, j);.
36b10 73 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 szCell[nCell] =
36b20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 4f 6c 64 cellSizePtr(pOld
36b30 2c 20 61 70 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 29 , apCell[nCell])
36b40 3b 0a 20 20 20 20 20 20 20 20 6e 43 65 6c 6c 2b ;. nCell+
36b50 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d +;. }. }
36b60 20 20 20 20 20 20 20 0a 20 20 20 20 69 66 28 20 . if(
36b70 69 3c 6e 4f 6c 64 2d 31 20 26 26 20 21 6c 65 61 i<nOld-1 && !lea
36b80 66 44 61 74 61 29 7b 0a 20 20 20 20 20 20 75 31 fData){. u1
36b90 36 20 73 7a 20 3d 20 28 75 31 36 29 73 7a 4e 65 6 sz = (u16)szNe
36ba0 77 5b 69 5d 3b 0a 20 20 20 20 20 20 75 38 20 2a w[i];. u8 *
36bb0 70 54 65 6d 70 3b 0a 20 20 20 20 20 20 61 73 73 pTemp;. ass
36bc0 65 72 74 28 20 6e 43 65 6c 6c 3c 6e 4d 61 78 43 ert( nCell<nMaxC
36bd0 65 6c 6c 73 20 29 3b 0a 20 20 20 20 20 20 73 7a ells );. sz
36be0 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 73 7a Cell[nCell] = sz
36bf0 3b 0a 20 20 20 20 20 20 70 54 65 6d 70 20 3d 20 ;. pTemp =
36c00 26 61 53 70 61 63 65 31 5b 69 53 70 61 63 65 31 &aSpace1[iSpace1
36c10 5d 3b 0a 20 20 20 20 20 20 69 53 70 61 63 65 31 ];. iSpace1
36c20 20 2b 3d 20 73 7a 3b 0a 20 20 20 20 20 20 61 73 += sz;. as
36c30 73 65 72 74 28 20 73 7a 3c 3d 70 42 74 2d 3e 6d sert( sz<=pBt->m
36c40 61 78 4c 6f 63 61 6c 2b 32 33 20 29 3b 0a 20 20 axLocal+23 );.
36c50 20 20 20 20 61 73 73 65 72 74 28 20 69 53 70 61 assert( iSpa
36c60 63 65 31 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d ce1 <= (int)pBt-
36c70 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 20 20 20 >pageSize );.
36c80 20 20 20 6d 65 6d 63 70 79 28 70 54 65 6d 70 2c memcpy(pTemp,
36c90 20 61 70 44 69 76 5b 69 5d 2c 20 73 7a 29 3b 0a apDiv[i], sz);.
36ca0 20 20 20 20 20 20 61 70 43 65 6c 6c 5b 6e 43 65 apCell[nCe
36cb0 6c 6c 5d 20 3d 20 70 54 65 6d 70 2b 6c 65 61 66 ll] = pTemp+leaf
36cc0 43 6f 72 72 65 63 74 69 6f 6e 3b 0a 20 20 20 20 Correction;.
36cd0 20 20 61 73 73 65 72 74 28 20 6c 65 61 66 43 6f assert( leafCo
36ce0 72 72 65 63 74 69 6f 6e 3d 3d 30 20 7c 7c 20 6c rrection==0 || l
36cf0 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 3d 3d 34 eafCorrection==4
36d00 20 29 3b 0a 20 20 20 20 20 20 73 7a 43 65 6c 6c );. szCell
36d10 5b 6e 43 65 6c 6c 5d 20 3d 20 73 7a 43 65 6c 6c [nCell] = szCell
36d20 5b 6e 43 65 6c 6c 5d 20 2d 20 6c 65 61 66 43 6f [nCell] - leafCo
36d30 72 72 65 63 74 69 6f 6e 3b 0a 20 20 20 20 20 20 rrection;.
36d40 69 66 28 20 21 70 4f 6c 64 2d 3e 6c 65 61 66 20 if( !pOld->leaf
36d50 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
36d60 74 28 20 6c 65 61 66 43 6f 72 72 65 63 74 69 6f t( leafCorrectio
36d70 6e 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 n==0 );.
36d80 61 73 73 65 72 74 28 20 70 4f 6c 64 2d 3e 68 64 assert( pOld->hd
36d90 72 4f 66 66 73 65 74 3d 3d 30 20 29 3b 0a 20 20 rOffset==0 );.
36da0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 69 67 /* The rig
36db0 68 74 20 70 6f 69 6e 74 65 72 20 6f 66 20 74 68 ht pointer of th
36dc0 65 20 63 68 69 6c 64 20 70 61 67 65 20 70 4f 6c e child page pOl
36dd0 64 20 62 65 63 6f 6d 65 73 20 74 68 65 20 6c 65 d becomes the le
36de0 66 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 6f ft. ** po
36df0 69 6e 74 65 72 20 6f 66 20 74 68 65 20 64 69 76 inter of the div
36e00 69 64 65 72 20 63 65 6c 6c 20 2a 2f 0a 20 20 20 ider cell */.
36e10 20 20 20 20 20 6d 65 6d 63 70 79 28 61 70 43 65 memcpy(apCe
36e20 6c 6c 5b 6e 43 65 6c 6c 5d 2c 20 26 70 4f 6c 64 ll[nCell], &pOld
36e30 2d 3e 61 44 61 74 61 5b 38 5d 2c 20 34 29 3b 0a ->aData[8], 4);.
36e40 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
36e50 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 65 61 assert( lea
36e60 66 43 6f 72 72 65 63 74 69 6f 6e 3d 3d 34 20 29 fCorrection==4 )
36e70 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 73 7a ;. if( sz
36e80 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 3c 34 20 29 7b Cell[nCell]<4 ){
36e90 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f . /* Do
36ea0 20 6e 6f 74 20 61 6c 6c 6f 77 20 61 6e 79 20 63 not allow any c
36eb0 65 6c 6c 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 ells smaller tha
36ec0 6e 20 34 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 n 4 bytes. */.
36ed0 20 20 20 20 20 20 20 20 73 7a 43 65 6c 6c 5b 6e szCell[n
36ee0 43 65 6c 6c 5d 20 3d 20 34 3b 0a 20 20 20 20 20 Cell] = 4;.
36ef0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
36f00 20 20 20 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 20 nCell++;.
36f10 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a }. }.. /*. **
36f20 20 46 69 67 75 72 65 20 6f 75 74 20 74 68 65 20 Figure out the
36f30 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
36f40 6e 65 65 64 65 64 20 74 6f 20 68 6f 6c 64 20 61 needed to hold a
36f50 6c 6c 20 6e 43 65 6c 6c 20 63 65 6c 6c 73 2e 0a ll nCell cells..
36f60 20 20 2a 2a 20 53 74 6f 72 65 20 74 68 69 73 20 ** Store this
36f70 6e 75 6d 62 65 72 20 69 6e 20 22 6b 22 2e 20 20 number in "k".
36f80 41 6c 73 6f 20 63 6f 6d 70 75 74 65 20 73 7a 4e Also compute szN
36f90 65 77 5b 5d 20 77 68 69 63 68 20 69 73 20 74 68 ew[] which is th
36fa0 65 20 74 6f 74 61 6c 0a 20 20 2a 2a 20 73 69 7a e total. ** siz
36fb0 65 20 6f 66 20 61 6c 6c 20 63 65 6c 6c 73 20 6f e of all cells o
36fc0 6e 20 74 68 65 20 69 2d 74 68 20 70 61 67 65 20 n the i-th page
36fd0 61 6e 64 20 63 6e 74 4e 65 77 5b 5d 20 77 68 69 and cntNew[] whi
36fe0 63 68 20 69 73 20 74 68 65 20 69 6e 64 65 78 0a ch is the index.
36ff0 20 20 2a 2a 20 69 6e 20 61 70 43 65 6c 6c 5b 5d ** in apCell[]
37000 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 74 68 61 of the cell tha
37010 74 20 64 69 76 69 64 65 73 20 70 61 67 65 20 69 t divides page i
37020 20 66 72 6f 6d 20 70 61 67 65 20 69 2b 31 2e 20 from page i+1.
37030 20 0a 20 20 2a 2a 20 63 6e 74 4e 65 77 5b 6b 5d . ** cntNew[k]
37040 20 73 68 6f 75 6c 64 20 65 71 75 61 6c 20 6e 43 should equal nC
37050 65 6c 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 56 ell.. **. ** V
37060 61 6c 75 65 73 20 63 6f 6d 70 75 74 65 64 20 62 alues computed b
37070 79 20 74 68 69 73 20 62 6c 6f 63 6b 3a 0a 20 20 y this block:.
37080 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 20 **. **
37090 20 20 6b 3a 20 54 68 65 20 74 6f 74 61 6c 20 6e k: The total n
370a0 75 6d 62 65 72 20 6f 66 20 73 69 62 6c 69 6e 67 umber of sibling
370b0 20 70 61 67 65 73 0a 20 20 2a 2a 20 20 20 20 73 pages. ** s
370c0 7a 4e 65 77 5b 69 5d 3a 20 53 70 61 63 65 64 20 zNew[i]: Spaced
370d0 75 73 65 64 20 6f 6e 20 74 68 65 20 69 2d 74 68 used on the i-th
370e0 20 73 69 62 6c 69 6e 67 20 70 61 67 65 2e 0a 20 sibling page..
370f0 20 2a 2a 20 20 20 63 6e 74 4e 65 77 5b 69 5d 3a ** cntNew[i]:
37100 20 49 6e 64 65 78 20 69 6e 20 61 70 43 65 6c 6c Index in apCell
37110 5b 5d 20 61 6e 64 20 73 7a 43 65 6c 6c 5b 5d 20 [] and szCell[]
37120 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 63 65 for the first ce
37130 6c 6c 20 74 6f 0a 20 20 2a 2a 20 20 20 20 20 20 ll to. **
37140 20 20 20 20 20 20 20 20 74 68 65 20 72 69 67 68 the righ
37150 74 20 6f 66 20 74 68 65 20 69 2d 74 68 20 73 69 t of the i-th si
37160 62 6c 69 6e 67 20 70 61 67 65 2e 0a 20 20 2a 2a bling page.. **
37170 20 75 73 61 62 6c 65 53 70 61 63 65 3a 20 4e 75 usableSpace: Nu
37180 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 mber of bytes of
37190 20 73 70 61 63 65 20 61 76 61 69 6c 61 62 6c 65 space available
371a0 20 6f 6e 20 65 61 63 68 20 73 69 62 6c 69 6e 67 on each sibling
371b0 2e 0a 20 20 2a 2a 20 0a 20 20 2a 2f 0a 20 20 75 .. ** . */. u
371c0 73 61 62 6c 65 53 70 61 63 65 20 3d 20 70 42 74 sableSpace = pBt
371d0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 31 ->usableSize - 1
371e0 32 20 2b 20 6c 65 61 66 43 6f 72 72 65 63 74 69 2 + leafCorrecti
371f0 6f 6e 3b 0a 20 20 66 6f 72 28 73 75 62 74 6f 74 on;. for(subtot
37200 61 6c 3d 6b 3d 69 3d 30 3b 20 69 3c 6e 43 65 6c al=k=i=0; i<nCel
37210 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 61 73 73 l; i++){. ass
37220 65 72 74 28 20 69 3c 6e 4d 61 78 43 65 6c 6c 73 ert( i<nMaxCells
37230 20 29 3b 0a 20 20 20 20 73 75 62 74 6f 74 61 6c );. subtotal
37240 20 2b 3d 20 73 7a 43 65 6c 6c 5b 69 5d 20 2b 20 += szCell[i] +
37250 32 3b 0a 20 20 20 20 69 66 28 20 73 75 62 74 6f 2;. if( subto
37260 74 61 6c 20 3e 20 75 73 61 62 6c 65 53 70 61 63 tal > usableSpac
37270 65 20 29 7b 0a 20 20 20 20 20 20 73 7a 4e 65 77 e ){. szNew
37280 5b 6b 5d 20 3d 20 73 75 62 74 6f 74 61 6c 20 2d [k] = subtotal -
37290 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 szCell[i];.
372a0 20 20 63 6e 74 4e 65 77 5b 6b 5d 20 3d 20 69 3b cntNew[k] = i;
372b0 0a 20 20 20 20 20 20 69 66 28 20 6c 65 61 66 44 . if( leafD
372c0 61 74 61 20 29 7b 20 69 2d 2d 3b 20 7d 0a 20 20 ata ){ i--; }.
372d0 20 20 20 20 73 75 62 74 6f 74 61 6c 20 3d 20 30 subtotal = 0
372e0 3b 0a 20 20 20 20 20 20 6b 2b 2b 3b 0a 20 20 20 ;. k++;.
372f0 20 20 20 69 66 28 20 6b 3e 4e 42 2b 31 20 29 7b if( k>NB+1 ){
37300 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 rc = SQLITE_COR
37310 52 55 50 54 5f 42 4b 50 54 3b 20 67 6f 74 6f 20 RUPT_BKPT; goto
37320 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b balance_cleanup;
37330 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 }. }. }. s
37340 7a 4e 65 77 5b 6b 5d 20 3d 20 73 75 62 74 6f 74 zNew[k] = subtot
37350 61 6c 3b 0a 20 20 63 6e 74 4e 65 77 5b 6b 5d 20 al;. cntNew[k]
37360 3d 20 6e 43 65 6c 6c 3b 0a 20 20 6b 2b 2b 3b 0a = nCell;. k++;.
37370 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 70 . /*. ** The p
37380 61 63 6b 69 6e 67 20 63 6f 6d 70 75 74 65 64 20 acking computed
37390 62 79 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 by the previous
373a0 62 6c 6f 63 6b 20 69 73 20 62 69 61 73 65 64 20 block is biased
373b0 74 6f 77 61 72 64 20 74 68 65 20 73 69 62 6c 69 toward the sibli
373c0 6e 67 73 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 ngs. ** on the
373d0 6c 65 66 74 20 73 69 64 65 2e 20 20 54 68 65 20 left side. The
373e0 6c 65 66 74 20 73 69 62 6c 69 6e 67 73 20 61 72 left siblings ar
373f0 65 20 61 6c 77 61 79 73 20 6e 65 61 72 6c 79 20 e always nearly
37400 66 75 6c 6c 2c 20 77 68 69 6c 65 20 74 68 65 0a full, while the.
37410 20 20 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 20 ** right-most
37420 73 69 62 6c 69 6e 67 20 6d 69 67 68 74 20 62 65 sibling might be
37430 20 6e 65 61 72 6c 79 20 65 6d 70 74 79 2e 20 20 nearly empty.
37440 54 68 69 73 20 62 6c 6f 63 6b 20 6f 66 20 63 6f This block of co
37450 64 65 20 61 74 74 65 6d 70 74 73 0a 20 20 2a 2a de attempts. **
37460 20 74 6f 20 61 64 6a 75 73 74 20 74 68 65 20 70 to adjust the p
37470 61 63 6b 69 6e 67 20 6f 66 20 73 69 62 6c 69 6e acking of siblin
37480 67 73 20 74 6f 20 67 65 74 20 61 20 62 65 74 74 gs to get a bett
37490 65 72 20 62 61 6c 61 6e 63 65 2e 0a 20 20 2a 2a er balance.. **
374a0 0a 20 20 2a 2a 20 54 68 69 73 20 61 64 6a 75 73 . ** This adjus
374b0 74 6d 65 6e 74 20 69 73 20 6d 6f 72 65 20 74 68 tment is more th
374c0 61 6e 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 an an optimizati
374d0 6f 6e 2e 20 20 54 68 65 20 70 61 63 6b 69 6e 67 on. The packing
374e0 20 61 62 6f 76 65 20 6d 69 67 68 74 0a 20 20 2a above might. *
374f0 2a 20 62 65 20 73 6f 20 6f 75 74 20 6f 66 20 62 * be so out of b
37500 61 6c 61 6e 63 65 20 61 73 20 74 6f 20 62 65 20 alance as to be
37510 69 6c 6c 65 67 61 6c 2e 20 20 46 6f 72 20 65 78 illegal. For ex
37520 61 6d 70 6c 65 2c 20 74 68 65 20 72 69 67 68 74 ample, the right
37530 2d 6d 6f 73 74 0a 20 20 2a 2a 20 73 69 62 6c 69 -most. ** sibli
37540 6e 67 20 6d 69 67 68 74 20 62 65 20 63 6f 6d 70 ng might be comp
37550 6c 65 74 65 6c 79 20 65 6d 70 74 79 2e 20 20 54 letely empty. T
37560 68 69 73 20 61 64 6a 75 73 74 6d 65 6e 74 20 69 his adjustment i
37570 73 20 6e 6f 74 20 6f 70 74 69 6f 6e 61 6c 2e 0a s not optional..
37580 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 6b 2d 31 */. for(i=k-1
37590 3b 20 69 3e 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 ; i>0; i--){.
375a0 20 69 6e 74 20 73 7a 52 69 67 68 74 20 3d 20 73 int szRight = s
375b0 7a 4e 65 77 5b 69 5d 3b 20 20 2f 2a 20 53 69 7a zNew[i]; /* Siz
375c0 65 20 6f 66 20 73 69 62 6c 69 6e 67 20 6f 6e 20 e of sibling on
375d0 74 68 65 20 72 69 67 68 74 20 2a 2f 0a 20 20 20 the right */.
375e0 20 69 6e 74 20 73 7a 4c 65 66 74 20 3d 20 73 7a int szLeft = sz
375f0 4e 65 77 5b 69 2d 31 5d 3b 20 2f 2a 20 53 69 7a New[i-1]; /* Siz
37600 65 20 6f 66 20 73 69 62 6c 69 6e 67 20 6f 6e 20 e of sibling on
37610 74 68 65 20 6c 65 66 74 20 2a 2f 0a 20 20 20 20 the left */.
37620 69 6e 74 20 72 3b 20 20 20 20 20 20 20 20 20 20 int r;
37630 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 /* Index of
37640 72 69 67 68 74 2d 6d 6f 73 74 20 63 65 6c 6c 20 right-most cell
37650 69 6e 20 6c 65 66 74 20 73 69 62 6c 69 6e 67 20 in left sibling
37660 2a 2f 0a 20 20 20 20 69 6e 74 20 64 3b 20 20 20 */. int d;
37670 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
37680 64 65 78 20 6f 66 20 66 69 72 73 74 20 63 65 6c dex of first cel
37690 6c 20 74 6f 20 74 68 65 20 6c 65 66 74 20 6f 66 l to the left of
376a0 20 72 69 67 68 74 20 73 69 62 6c 69 6e 67 20 2a right sibling *
376b0 2f 0a 0a 20 20 20 20 72 20 3d 20 63 6e 74 4e 65 /.. r = cntNe
376c0 77 5b 69 2d 31 5d 20 2d 20 31 3b 0a 20 20 20 20 w[i-1] - 1;.
376d0 64 20 3d 20 72 20 2b 20 31 20 2d 20 6c 65 61 66 d = r + 1 - leaf
376e0 44 61 74 61 3b 0a 20 20 20 20 61 73 73 65 72 74 Data;. assert
376f0 28 20 64 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b ( d<nMaxCells );
37700 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 3c 6e . assert( r<n
37710 4d 61 78 43 65 6c 6c 73 20 29 3b 0a 20 20 20 20 MaxCells );.
37720 77 68 69 6c 65 28 20 73 7a 52 69 67 68 74 3d 3d while( szRight==
37730 30 20 0a 20 20 20 20 20 20 20 7c 7c 20 28 21 62 0 . || (!b
37740 42 75 6c 6b 20 26 26 20 73 7a 52 69 67 68 74 2b Bulk && szRight+
37750 73 7a 43 65 6c 6c 5b 64 5d 2b 32 3c 3d 73 7a 4c szCell[d]+2<=szL
37760 65 66 74 2d 28 73 7a 43 65 6c 6c 5b 72 5d 2b 32 eft-(szCell[r]+2
37770 29 29 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 )) . ){.
37780 20 73 7a 52 69 67 68 74 20 2b 3d 20 73 7a 43 65 szRight += szCe
37790 6c 6c 5b 64 5d 20 2b 20 32 3b 0a 20 20 20 20 20 ll[d] + 2;.
377a0 20 73 7a 4c 65 66 74 20 2d 3d 20 73 7a 43 65 6c szLeft -= szCel
377b0 6c 5b 72 5d 20 2b 20 32 3b 0a 20 20 20 20 20 20 l[r] + 2;.
377c0 63 6e 74 4e 65 77 5b 69 2d 31 5d 2d 2d 3b 0a 20 cntNew[i-1]--;.
377d0 20 20 20 20 20 72 20 3d 20 63 6e 74 4e 65 77 5b r = cntNew[
377e0 69 2d 31 5d 20 2d 20 31 3b 0a 20 20 20 20 20 20 i-1] - 1;.
377f0 64 20 3d 20 72 20 2b 20 31 20 2d 20 6c 65 61 66 d = r + 1 - leaf
37800 44 61 74 61 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Data;. }.
37810 73 7a 4e 65 77 5b 69 5d 20 3d 20 73 7a 52 69 67 szNew[i] = szRig
37820 68 74 3b 0a 20 20 20 20 73 7a 4e 65 77 5b 69 2d ht;. szNew[i-
37830 31 5d 20 3d 20 73 7a 4c 65 66 74 3b 0a 20 20 7d 1] = szLeft;. }
37840 0a 0a 20 20 2f 2a 20 45 69 74 68 65 72 20 77 65 .. /* Either we
37850 20 66 6f 75 6e 64 20 6f 6e 65 20 6f 72 20 6d 6f found one or mo
37860 72 65 20 63 65 6c 6c 73 20 28 63 6e 74 6e 65 77 re cells (cntnew
37870 5b 30 5d 29 3e 30 29 20 6f 72 20 70 50 61 67 65 [0])>0) or pPage
37880 20 69 73 0a 20 20 2a 2a 20 61 20 76 69 72 74 75 is. ** a virtu
37890 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 20 41 al root page. A
378a0 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 virtual root pa
378b0 67 65 20 69 73 20 77 68 65 6e 20 74 68 65 20 72 ge is when the r
378c0 65 61 6c 20 72 6f 6f 74 0a 20 20 2a 2a 20 70 61 eal root. ** pa
378d0 67 65 20 69 73 20 70 61 67 65 20 31 20 61 6e 64 ge is page 1 and
378e0 20 77 65 20 61 72 65 20 74 68 65 20 6f 6e 6c 79 we are the only
378f0 20 63 68 69 6c 64 20 6f 66 20 74 68 61 74 20 70 child of that p
37900 61 67 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 55 age.. **. ** U
37910 50 44 41 54 45 3a 20 20 54 68 65 20 61 73 73 65 PDATE: The asse
37920 72 74 28 29 20 62 65 6c 6f 77 20 69 73 20 6e 6f rt() below is no
37930 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 74 72 t necessarily tr
37940 75 65 20 69 66 20 74 68 65 20 64 61 74 61 62 61 ue if the databa
37950 73 65 0a 20 20 2a 2a 20 66 69 6c 65 20 69 73 20 se. ** file is
37960 63 6f 72 72 75 70 74 2e 20 20 54 68 65 20 63 6f corrupt. The co
37970 72 72 75 70 74 69 6f 6e 20 77 69 6c 6c 20 62 65 rruption will be
37980 20 64 65 74 65 63 74 65 64 20 61 6e 64 20 72 65 detected and re
37990 70 6f 72 74 65 64 20 6c 61 74 65 72 0a 20 20 2a ported later. *
379a0 2a 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65 64 * in this proced
379b0 75 72 65 20 73 6f 20 74 68 65 72 65 20 69 73 20 ure so there is
379c0 6e 6f 20 6e 65 65 64 20 74 6f 20 61 63 74 20 75 no need to act u
379d0 70 6f 6e 20 69 74 20 6e 6f 77 2e 0a 20 20 2a 2f pon it now.. */
379e0 0a 23 69 66 20 30 0a 20 20 61 73 73 65 72 74 28 .#if 0. assert(
379f0 20 63 6e 74 4e 65 77 5b 30 5d 3e 30 20 7c 7c 20 cntNew[0]>0 ||
37a00 28 70 50 61 72 65 6e 74 2d 3e 70 67 6e 6f 3d 3d (pParent->pgno==
37a10 31 20 26 26 20 70 50 61 72 65 6e 74 2d 3e 6e 43 1 && pParent->nC
37a20 65 6c 6c 3d 3d 30 29 20 29 3b 0a 23 65 6e 64 69 ell==0) );.#endi
37a30 66 0a 0a 20 20 54 52 41 43 45 28 28 22 42 41 4c f.. TRACE(("BAL
37a40 41 4e 43 45 3a 20 6f 6c 64 3a 20 25 64 20 25 64 ANCE: old: %d %d
37a50 20 25 64 20 20 22 2c 0a 20 20 20 20 61 70 4f 6c %d ",. apOl
37a60 64 5b 30 5d 2d 3e 70 67 6e 6f 2c 20 0a 20 20 20 d[0]->pgno, .
37a70 20 6e 4f 6c 64 3e 3d 32 20 3f 20 61 70 4f 6c 64 nOld>=2 ? apOld
37a80 5b 31 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 0a 20 [1]->pgno : 0,.
37a90 20 20 20 6e 4f 6c 64 3e 3d 33 20 3f 20 61 70 4f nOld>=3 ? apO
37aa0 6c 64 5b 32 5d 2d 3e 70 67 6e 6f 20 3a 20 30 0a ld[2]->pgno : 0.
37ab0 20 20 29 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a ));.. /*. **
37ac0 20 41 6c 6c 6f 63 61 74 65 20 6b 20 6e 65 77 20 Allocate k new
37ad0 70 61 67 65 73 2e 20 20 52 65 75 73 65 20 6f 6c pages. Reuse ol
37ae0 64 20 70 61 67 65 73 20 77 68 65 72 65 20 70 6f d pages where po
37af0 73 73 69 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 ssible.. */. i
37b00 66 28 20 61 70 4f 6c 64 5b 30 5d 2d 3e 70 67 6e f( apOld[0]->pgn
37b10 6f 3c 3d 31 20 29 7b 0a 20 20 20 20 72 63 20 3d o<=1 ){. rc =
37b20 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
37b30 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 62 BKPT;. goto b
37b40 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a alance_cleanup;.
37b50 20 20 7d 0a 20 20 70 61 67 65 46 6c 61 67 73 20 }. pageFlags
37b60 3d 20 61 70 4f 6c 64 5b 30 5d 2d 3e 61 44 61 74 = apOld[0]->aDat
37b70 61 5b 30 5d 3b 0a 20 20 66 6f 72 28 69 3d 30 3b a[0];. for(i=0;
37b80 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 i<k; i++){.
37b90 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 3b 0a 20 MemPage *pNew;.
37ba0 20 20 20 69 66 28 20 69 3c 6e 4f 6c 64 20 29 7b if( i<nOld ){
37bb0 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 61 70 . pNew = ap
37bc0 4e 65 77 5b 69 5d 20 3d 20 61 70 4f 6c 64 5b 69 New[i] = apOld[i
37bd0 5d 3b 0a 20 20 20 20 20 20 61 70 4f 6c 64 5b 69 ];. apOld[i
37be0 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 63 20 ] = 0;. rc
37bf0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
37c00 69 74 65 28 70 4e 65 77 2d 3e 70 44 62 50 61 67 ite(pNew->pDbPag
37c10 65 29 3b 0a 20 20 20 20 20 20 6e 4e 65 77 2b 2b e);. nNew++
37c20 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 ;. if( rc )
37c30 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c goto balance_cl
37c40 65 61 6e 75 70 3b 0a 20 20 20 20 7d 65 6c 73 65 eanup;. }else
37c50 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
37c60 69 3e 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20 i>0 );. rc
37c70 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 = allocateBtreeP
37c80 61 67 65 28 70 42 74 2c 20 26 70 4e 65 77 2c 20 age(pBt, &pNew,
37c90 26 70 67 6e 6f 2c 20 28 62 42 75 6c 6b 20 3f 20 &pgno, (bBulk ?
37ca0 31 20 3a 20 70 67 6e 6f 29 2c 20 30 29 3b 0a 20 1 : pgno), 0);.
37cb0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 6f if( rc ) go
37cc0 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e to balance_clean
37cd0 75 70 3b 0a 20 20 20 20 20 20 61 70 4e 65 77 5b up;. apNew[
37ce0 69 5d 20 3d 20 70 4e 65 77 3b 0a 20 20 20 20 20 i] = pNew;.
37cf0 20 6e 4e 65 77 2b 2b 3b 0a 0a 20 20 20 20 20 20 nNew++;..
37d00 2f 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e 74 /* Set the point
37d10 65 72 2d 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 er-map entry for
37d20 20 74 68 65 20 6e 65 77 20 73 69 62 6c 69 6e 67 the new sibling
37d30 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 20 page. */.
37d40 69 66 28 20 49 53 41 55 54 4f 56 41 43 55 55 4d if( ISAUTOVACUUM
37d50 20 29 7b 0a 20 20 20 20 20 20 20 20 70 74 72 6d ){. ptrm
37d60 61 70 50 75 74 28 70 42 74 2c 20 70 4e 65 77 2d apPut(pBt, pNew-
37d70 3e 70 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 54 >pgno, PTRMAP_BT
37d80 52 45 45 2c 20 70 50 61 72 65 6e 74 2d 3e 70 67 REE, pParent->pg
37d90 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 no, &rc);.
37da0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
37db0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
37dc0 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c goto balance_cl
37dd0 65 61 6e 75 70 3b 0a 20 20 20 20 20 20 20 20 7d eanup;. }
37de0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
37df0 20 7d 0a 0a 20 20 2f 2a 20 46 72 65 65 20 61 6e }.. /* Free an
37e00 79 20 6f 6c 64 20 70 61 67 65 73 20 74 68 61 74 y old pages that
37e10 20 77 65 72 65 20 6e 6f 74 20 72 65 75 73 65 64 were not reused
37e20 20 61 73 20 6e 65 77 20 70 61 67 65 73 2e 0a 20 as new pages..
37e30 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 69 3c 6e */. while( i<n
37e40 4f 6c 64 20 29 7b 0a 20 20 20 20 66 72 65 65 50 Old ){. freeP
37e50 61 67 65 28 61 70 4f 6c 64 5b 69 5d 2c 20 26 72 age(apOld[i], &r
37e60 63 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 c);. if( rc )
37e70 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f 63 6c goto balance_cl
37e80 65 61 6e 75 70 3b 0a 20 20 20 20 72 65 6c 65 61 eanup;. relea
37e90 73 65 50 61 67 65 28 61 70 4f 6c 64 5b 69 5d 29 sePage(apOld[i])
37ea0 3b 0a 20 20 20 20 61 70 4f 6c 64 5b 69 5d 20 3d ;. apOld[i] =
37eb0 20 30 3b 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d 0;. i++;. }
37ec0 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50 75 74 20 .. /*. ** Put
37ed0 74 68 65 20 6e 65 77 20 70 61 67 65 73 20 69 6e the new pages in
37ee0 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 ascending order
37ef0 2e 20 20 54 68 69 73 20 68 65 6c 70 73 20 74 6f . This helps to
37f00 0a 20 20 2a 2a 20 6b 65 65 70 20 65 6e 74 72 69 . ** keep entri
37f10 65 73 20 69 6e 20 74 68 65 20 64 69 73 6b 20 66 es in the disk f
37f20 69 6c 65 20 69 6e 20 6f 72 64 65 72 20 73 6f 20 ile in order so
37f30 74 68 61 74 20 61 20 73 63 61 6e 0a 20 20 2a 2a that a scan. **
37f40 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 69 73 of the table is
37f50 20 61 20 6c 69 6e 65 61 72 20 73 63 61 6e 20 74 a linear scan t
37f60 68 72 6f 75 67 68 20 74 68 65 20 66 69 6c 65 2e hrough the file.
37f70 20 20 54 68 61 74 0a 20 20 2a 2a 20 69 6e 20 74 That. ** in t
37f80 75 72 6e 20 68 65 6c 70 73 20 74 68 65 20 6f 70 urn helps the op
37f90 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 74 erating system t
37fa0 6f 20 64 65 6c 69 76 65 72 20 70 61 67 65 73 0a o deliver pages.
37fb0 20 20 2a 2a 20 66 72 6f 6d 20 74 68 65 20 64 69 ** from the di
37fc0 73 6b 20 6d 6f 72 65 20 72 61 70 69 64 6c 79 2e sk more rapidly.
37fd0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e 20 4f 28 . **. ** An O(
37fe0 6e 5e 32 29 20 69 6e 73 65 72 74 69 6f 6e 20 73 n^2) insertion s
37ff0 6f 72 74 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 ort algorithm is
38000 20 75 73 65 64 2c 20 62 75 74 20 73 69 6e 63 65 used, but since
38010 0a 20 20 2a 2a 20 6e 20 69 73 20 6e 65 76 65 72 . ** n is never
38020 20 6d 6f 72 65 20 74 68 61 6e 20 4e 42 20 28 61 more than NB (a
38030 20 73 6d 61 6c 6c 20 63 6f 6e 73 74 61 6e 74 29 small constant)
38040 2c 20 74 68 61 74 20 73 68 6f 75 6c 64 0a 20 20 , that should.
38050 2a 2a 20 6e 6f 74 20 62 65 20 61 20 70 72 6f 62 ** not be a prob
38060 6c 65 6d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 lem.. **. ** W
38070 68 65 6e 20 4e 42 3d 3d 33 2c 20 74 68 69 73 20 hen NB==3, this
38080 6f 6e 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e one optimization
38090 20 6d 61 6b 65 73 20 74 68 65 20 64 61 74 61 62 makes the datab
380a0 61 73 65 0a 20 20 2a 2a 20 61 62 6f 75 74 20 32 ase. ** about 2
380b0 35 25 20 66 61 73 74 65 72 20 66 6f 72 20 6c 61 5% faster for la
380c0 72 67 65 20 69 6e 73 65 72 74 69 6f 6e 73 20 61 rge insertions a
380d0 6e 64 20 64 65 6c 65 74 69 6f 6e 73 2e 0a 20 20 nd deletions..
380e0 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c */. for(i=0; i<
380f0 6b 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 k-1; i++){. i
38100 6e 74 20 6d 69 6e 56 20 3d 20 61 70 4e 65 77 5b nt minV = apNew[
38110 69 5d 2d 3e 70 67 6e 6f 3b 0a 20 20 20 20 69 6e i]->pgno;. in
38120 74 20 6d 69 6e 49 20 3d 20 69 3b 0a 20 20 20 20 t minI = i;.
38130 66 6f 72 28 6a 3d 69 2b 31 3b 20 6a 3c 6b 3b 20 for(j=i+1; j<k;
38140 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 j++){. if(
38150 61 70 4e 65 77 5b 6a 5d 2d 3e 70 67 6e 6f 3c 28 apNew[j]->pgno<(
38160 75 6e 73 69 67 6e 65 64 29 6d 69 6e 56 20 29 7b unsigned)minV ){
38170 0a 20 20 20 20 20 20 20 20 6d 69 6e 49 20 3d 20 . minI =
38180 6a 3b 0a 20 20 20 20 20 20 20 20 6d 69 6e 56 20 j;. minV
38190 3d 20 61 70 4e 65 77 5b 6a 5d 2d 3e 70 67 6e 6f = apNew[j]->pgno
381a0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
381b0 20 20 20 20 69 66 28 20 6d 69 6e 49 3e 69 20 29 if( minI>i )
381c0 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 {. MemPage
381d0 2a 70 54 3b 0a 20 20 20 20 20 20 70 54 20 3d 20 *pT;. pT =
381e0 61 70 4e 65 77 5b 69 5d 3b 0a 20 20 20 20 20 20 apNew[i];.
381f0 61 70 4e 65 77 5b 69 5d 20 3d 20 61 70 4e 65 77 apNew[i] = apNew
38200 5b 6d 69 6e 49 5d 3b 0a 20 20 20 20 20 20 61 70 [minI];. ap
38210 4e 65 77 5b 6d 69 6e 49 5d 20 3d 20 70 54 3b 0a New[minI] = pT;.
38220 20 20 20 20 7d 0a 20 20 7d 0a 20 20 54 52 41 43 }. }. TRAC
38230 45 28 28 22 6e 65 77 3a 20 25 64 28 25 64 29 20 E(("new: %d(%d)
38240 25 64 28 25 64 29 20 25 64 28 25 64 29 20 25 64 %d(%d) %d(%d) %d
38250 28 25 64 29 20 25 64 28 25 64 29 5c 6e 22 2c 0a (%d) %d(%d)\n",.
38260 20 20 20 20 61 70 4e 65 77 5b 30 5d 2d 3e 70 67 apNew[0]->pg
38270 6e 6f 2c 20 73 7a 4e 65 77 5b 30 5d 2c 0a 20 20 no, szNew[0],.
38280 20 20 6e 4e 65 77 3e 3d 32 20 3f 20 61 70 4e 65 nNew>=2 ? apNe
38290 77 5b 31 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 20 w[1]->pgno : 0,
382a0 6e 4e 65 77 3e 3d 32 20 3f 20 73 7a 4e 65 77 5b nNew>=2 ? szNew[
382b0 31 5d 20 3a 20 30 2c 0a 20 20 20 20 6e 4e 65 77 1] : 0,. nNew
382c0 3e 3d 33 20 3f 20 61 70 4e 65 77 5b 32 5d 2d 3e >=3 ? apNew[2]->
382d0 70 67 6e 6f 20 3a 20 30 2c 20 6e 4e 65 77 3e 3d pgno : 0, nNew>=
382e0 33 20 3f 20 73 7a 4e 65 77 5b 32 5d 20 3a 20 30 3 ? szNew[2] : 0
382f0 2c 0a 20 20 20 20 6e 4e 65 77 3e 3d 34 20 3f 20 ,. nNew>=4 ?
38300 61 70 4e 65 77 5b 33 5d 2d 3e 70 67 6e 6f 20 3a apNew[3]->pgno :
38310 20 30 2c 20 6e 4e 65 77 3e 3d 34 20 3f 20 73 7a 0, nNew>=4 ? sz
38320 4e 65 77 5b 33 5d 20 3a 20 30 2c 0a 20 20 20 20 New[3] : 0,.
38330 6e 4e 65 77 3e 3d 35 20 3f 20 61 70 4e 65 77 5b nNew>=5 ? apNew[
38340 34 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 20 6e 4e 4]->pgno : 0, nN
38350 65 77 3e 3d 35 20 3f 20 73 7a 4e 65 77 5b 34 5d ew>=5 ? szNew[4]
38360 20 3a 20 30 29 29 3b 0a 0a 20 20 61 73 73 65 72 : 0));.. asser
38370 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
38380 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 72 65 swriteable(pPare
38390 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a nt->pDbPage) );.
383a0 20 20 70 75 74 34 62 79 74 65 28 70 52 69 67 68 put4byte(pRigh
383b0 74 2c 20 61 70 4e 65 77 5b 6e 4e 65 77 2d 31 5d t, apNew[nNew-1]
383c0 2d 3e 70 67 6e 6f 29 3b 0a 0a 20 20 2f 2a 0a 20 ->pgno);.. /*.
383d0 20 2a 2a 20 45 76 65 6e 6c 79 20 64 69 73 74 72 ** Evenly distr
383e0 69 62 75 74 65 20 74 68 65 20 64 61 74 61 20 69 ibute the data i
383f0 6e 20 61 70 43 65 6c 6c 5b 5d 20 61 63 72 6f 73 n apCell[] acros
38400 73 20 74 68 65 20 6e 65 77 20 70 61 67 65 73 2e s the new pages.
38410 0a 20 20 2a 2a 20 49 6e 73 65 72 74 20 64 69 76 . ** Insert div
38420 69 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 6f 20 ider cells into
38430 70 50 61 72 65 6e 74 20 61 73 20 6e 65 63 65 73 pParent as neces
38440 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 6a 20 3d sary.. */. j =
38450 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 0;. for(i=0; i
38460 3c 6e 4e 65 77 3b 20 69 2b 2b 29 7b 0a 20 20 20 <nNew; i++){.
38470 20 2f 2a 20 41 73 73 65 6d 62 6c 65 20 74 68 65 /* Assemble the
38480 20 6e 65 77 20 73 69 62 6c 69 6e 67 20 70 61 67 new sibling pag
38490 65 2e 20 2a 2f 0a 20 20 20 20 4d 65 6d 50 61 67 e. */. MemPag
384a0 65 20 2a 70 4e 65 77 2