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 2d 3e 65 53 74 61 74 65 urn pCur->eState
66e0: 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a !=CURSOR_VALID;.
66f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
6700: 75 74 69 6e 65 20 72 65 73 74 6f 72 65 73 20 61 utine restores a
6710: 20 63 75 72 73 6f 72 20 62 61 63 6b 20 74 6f 20 cursor back to
6720: 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 70 6f 73 its original pos
6730: 69 74 69 6f 6e 20 61 66 74 65 72 20 69 74 0a 2a ition after it.*
6740: 2a 20 68 61 73 20 62 65 65 6e 20 6d 6f 76 65 64 * has been moved
6750: 20 62 79 20 73 6f 6d 65 20 6f 75 74 73 69 64 65 by some outside
6760: 20 61 63 74 69 76 69 74 79 20 28 73 75 63 68 20 activity (such
6770: 61 73 20 61 20 62 74 72 65 65 20 72 65 62 61 6c as a btree rebal
6780: 61 6e 63 65 20 6f 72 0a 2a 2a 20 61 20 72 6f 77 ance or.** a row
6790: 20 68 61 76 69 6e 67 20 62 65 65 6e 20 64 65 6c having been del
67a0: 65 74 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e eted out from un
67b0: 64 65 72 20 74 68 65 20 63 75 72 73 6f 72 29 2e der the cursor).
67c0: 20 20 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 .**.** On succ
67d0: 65 73 73 2c 20 74 68 65 20 2a 70 44 69 66 66 65 ess, the *pDiffe
67e0: 72 65 6e 74 52 6f 77 20 70 61 72 61 6d 65 74 65 rentRow paramete
67f0: 72 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 68 r is false if th
6800: 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
6810: 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 .** pointing at
6820: 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 exactly the same
6830: 20 72 6f 77 2e 20 20 2a 70 44 69 66 66 65 72 6e row. *pDiffern
6840: 74 52 6f 77 20 69 73 20 74 68 65 20 72 6f 77 20 tRow is the row
6850: 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 the cursor.** wa
6860: 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 68 61 s pointing to ha
6870: 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2c 20 s been deleted,
6880: 66 6f 72 63 69 6e 67 20 74 68 65 20 63 75 72 73 forcing the curs
6890: 6f 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 73 or to point to s
68a0: 6f 6d 65 0a 2a 2a 20 6e 65 61 72 62 79 20 72 6f ome.** nearby ro
68b0: 77 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f w..**.** This ro
68c0: 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c utine should onl
68d0: 79 20 62 65 20 63 61 6c 6c 65 64 20 66 6f 72 20 y be called for
68e0: 61 20 63 75 72 73 6f 72 20 74 68 61 74 20 6a 75 a cursor that ju
68f0: 73 74 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20 54 st returned.** T
6900: 52 55 45 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 RUE from sqlite3
6910: 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 6f BtreeCursorHasMo
6920: 76 65 64 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ved()..*/.int sq
6930: 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 lite3BtreeCursor
6940: 52 65 73 74 6f 72 65 28 42 74 43 75 72 73 6f 72 Restore(BtCursor
6950: 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 44 69 *pCur, int *pDi
6960: 66 66 65 72 65 6e 74 52 6f 77 29 7b 0a 20 20 69 fferentRow){. i
6970: 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
6980: 28 20 70 43 75 72 21 3d 30 20 29 3b 0a 20 20 61 ( pCur!=0 );. a
6990: 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
69a0: 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
69b0: 44 20 29 3b 0a 20 20 72 63 20 3d 20 72 65 73 74 D );. rc = rest
69c0: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
69d0: 6e 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 n(pCur);. if( r
69e0: 63 20 29 7b 0a 20 20 20 20 2a 70 44 69 66 66 65 c ){. *pDiffe
69f0: 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a 20 20 20 rentRow = 1;.
6a00: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
6a10: 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
6a20: 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
6a30: 20 7c 7c 20 4e 45 56 45 52 28 70 43 75 72 2d 3e || NEVER(pCur->
6a40: 73 6b 69 70 4e 65 78 74 21 3d 30 29 20 29 7b 0a skipNext!=0) ){.
6a50: 20 20 20 20 2a 70 44 69 66 66 65 72 65 6e 74 52 *pDifferentR
6a60: 6f 77 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b ow = 1;. }else{
6a70: 0a 20 20 20 20 2a 70 44 69 66 66 65 72 65 6e 74 . *pDifferent
6a80: 52 6f 77 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 Row = 0;. }. r
6a90: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6aa0: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
6ab0: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
6ac0: 55 4d 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 UM./*.** Given a
6ad0: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
6ae0: 61 20 72 65 67 75 6c 61 72 20 64 61 74 61 62 61 a regular databa
6af0: 73 65 20 70 61 67 65 2c 20 72 65 74 75 72 6e 20 se page, return
6b00: 74 68 65 20 70 61 67 65 0a 2a 2a 20 6e 75 6d 62 the page.** numb
6b10: 65 72 20 66 6f 72 20 74 68 65 20 70 6f 69 6e 74 er for the point
6b20: 65 72 2d 6d 61 70 20 70 61 67 65 20 74 68 61 74 er-map page that
6b30: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 65 6e contains the en
6b40: 74 72 79 20 66 6f 72 20 74 68 65 0a 2a 2a 20 69 try for the.** i
6b50: 6e 70 75 74 20 70 61 67 65 20 6e 75 6d 62 65 72 nput page number
6b60: 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 30 ..**.** Return 0
6b70: 20 28 6e 6f 74 20 61 20 76 61 6c 69 64 20 70 61 (not a valid pa
6b80: 67 65 29 20 66 6f 72 20 70 67 6e 6f 3d 3d 31 20 ge) for pgno==1
6b90: 73 69 6e 63 65 20 74 68 65 72 65 20 69 73 0a 2a since there is.*
6ba0: 2a 20 6e 6f 20 70 6f 69 6e 74 65 72 20 6d 61 70 * no pointer map
6bb0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
6bc0: 20 70 61 67 65 20 31 2e 20 20 54 68 65 20 69 6e page 1. The in
6bd0: 74 65 67 72 69 74 79 5f 63 68 65 63 6b 20 6c 6f tegrity_check lo
6be0: 67 69 63 0a 2a 2a 20 72 65 71 75 69 72 65 73 20 gic.** requires
6bf0: 74 68 61 74 20 70 74 72 6d 61 70 50 61 67 65 6e that ptrmapPagen
6c00: 6f 28 2a 2c 31 29 21 3d 31 2e 0a 2a 2f 0a 73 74 o(*,1)!=1..*/.st
6c10: 61 74 69 63 20 50 67 6e 6f 20 70 74 72 6d 61 70 atic Pgno ptrmap
6c20: 50 61 67 65 6e 6f 28 42 74 53 68 61 72 65 64 20 Pageno(BtShared
6c30: 2a 70 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 *pBt, Pgno pgno)
6c40: 7b 0a 20 20 69 6e 74 20 6e 50 61 67 65 73 50 65 {. int nPagesPe
6c50: 72 4d 61 70 50 61 67 65 3b 0a 20 20 50 67 6e 6f rMapPage;. Pgno
6c60: 20 69 50 74 72 4d 61 70 2c 20 72 65 74 3b 0a 20 iPtrMap, ret;.
6c70: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
6c80: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
6c90: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
6ca0: 20 70 67 6e 6f 3c 32 20 29 20 72 65 74 75 72 6e pgno<2 ) return
6cb0: 20 30 3b 0a 20 20 6e 50 61 67 65 73 50 65 72 4d 0;. nPagesPerM
6cc0: 61 70 50 61 67 65 20 3d 20 28 70 42 74 2d 3e 75 apPage = (pBt->u
6cd0: 73 61 62 6c 65 53 69 7a 65 2f 35 29 2b 31 3b 0a sableSize/5)+1;.
6ce0: 20 20 69 50 74 72 4d 61 70 20 3d 20 28 70 67 6e iPtrMap = (pgn
6cf0: 6f 2d 32 29 2f 6e 50 61 67 65 73 50 65 72 4d 61 o-2)/nPagesPerMa
6d00: 70 50 61 67 65 3b 0a 20 20 72 65 74 20 3d 20 28 pPage;. ret = (
6d10: 69 50 74 72 4d 61 70 2a 6e 50 61 67 65 73 50 65 iPtrMap*nPagesPe
6d20: 72 4d 61 70 50 61 67 65 29 20 2b 20 32 3b 20 0a rMapPage) + 2; .
6d30: 20 20 69 66 28 20 72 65 74 3d 3d 50 45 4e 44 49 if( ret==PENDI
6d40: 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
6d50: 29 20 29 7b 0a 20 20 20 20 72 65 74 2b 2b 3b 0a ) ){. ret++;.
6d60: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 65 74 }. return ret
6d70: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 ;.}../*.** Write
6d80: 20 61 6e 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 an entry into t
6d90: 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 2e 0a he pointer map..
6da0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
6db0: 6e 65 20 75 70 64 61 74 65 73 20 74 68 65 20 70 ne updates the p
6dc0: 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 ointer map entry
6dd0: 20 66 6f 72 20 70 61 67 65 20 6e 75 6d 62 65 72 for page number
6de0: 20 27 6b 65 79 27 0a 2a 2a 20 73 6f 20 74 68 61 'key'.** so tha
6df0: 74 20 69 74 20 6d 61 70 73 20 74 6f 20 74 79 70 t it maps to typ
6e00: 65 20 27 65 54 79 70 65 27 20 61 6e 64 20 70 61 e 'eType' and pa
6e10: 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 72 rent page number
6e20: 20 27 70 67 6e 6f 27 2e 0a 2a 2a 0a 2a 2a 20 49 'pgno'..**.** I
6e30: 66 20 2a 70 52 43 20 69 73 20 69 6e 69 74 69 61 f *pRC is initia
6e40: 6c 6c 79 20 6e 6f 6e 2d 7a 65 72 6f 20 28 6e 6f lly non-zero (no
6e50: 6e 2d 53 51 4c 49 54 45 5f 4f 4b 29 20 74 68 65 n-SQLITE_OK) the
6e60: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 n this routine i
6e70: 73 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 2e 20 20 49 s.** a no-op. I
6e80: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
6e90: 73 2c 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 s, the appropria
6ea0: 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 te error code is
6eb0: 20 77 72 69 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f written.** into
6ec0: 20 2a 70 52 43 2e 0a 2a 2f 0a 73 74 61 74 69 63 *pRC..*/.static
6ed0: 20 76 6f 69 64 20 70 74 72 6d 61 70 50 75 74 28 void ptrmapPut(
6ee0: 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
6ef0: 67 6e 6f 20 6b 65 79 2c 20 75 38 20 65 54 79 70 gno key, u8 eTyp
6f00: 65 2c 20 50 67 6e 6f 20 70 61 72 65 6e 74 2c 20 e, Pgno parent,
6f10: 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 44 62 50 int *pRC){. DbP
6f20: 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 2f age *pDbPage; /
6f30: 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 * The pointer ma
6f40: 70 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a p page */. u8 *
6f50: 70 50 74 72 6d 61 70 3b 20 20 20 20 20 20 2f 2a pPtrmap; /*
6f60: 20 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 The pointer map
6f70: 20 64 61 74 61 20 2a 2f 0a 20 20 50 67 6e 6f 20 data */. Pgno
6f80: 69 50 74 72 6d 61 70 3b 20 20 20 20 20 2f 2a 20 iPtrmap; /*
6f90: 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 The pointer map
6fa0: 70 61 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 page number */.
6fb0: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
6fc0: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 /* Offset in
6fd0: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
6fe0: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 */. int rc;
6ff0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
7000: 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 75 62 66 n code from subf
7010: 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 0a 20 20 69 unctions */.. i
7020: 66 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e f( *pRC ) return
7030: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
7040: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
7050: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
7060: 20 2f 2a 20 54 68 65 20 6d 61 73 74 65 72 2d 6a /* The master-j
7070: 6f 75 72 6e 61 6c 20 70 61 67 65 20 6e 75 6d 62 ournal page numb
7080: 65 72 20 6d 75 73 74 20 6e 65 76 65 72 20 62 65 er must never be
7090: 20 75 73 65 64 20 61 73 20 61 20 70 6f 69 6e 74 used as a point
70a0: 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 er map page */.
70b0: 20 61 73 73 65 72 74 28 20 30 3d 3d 50 54 52 4d assert( 0==PTRM
70c0: 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 50 AP_ISPAGE(pBt, P
70d0: 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
70e0: 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 61 73 73 (pBt)) );.. ass
70f0: 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 ert( pBt->autoVa
7100: 63 75 75 6d 20 29 3b 0a 20 20 69 66 28 20 6b 65 cuum );. if( ke
7110: 79 3d 3d 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 y==0 ){. *pRC
7120: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
7130: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 T_BKPT;. retu
7140: 72 6e 3b 0a 20 20 7d 0a 20 20 69 50 74 72 6d 61 rn;. }. iPtrma
7150: 70 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 4e p = PTRMAP_PAGEN
7160: 4f 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 72 O(pBt, key);. r
7170: 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
7180: 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c Get(pBt->pPager,
7190: 20 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 61 iPtrmap, &pDbPa
71a0: 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 ge);. if( rc!=S
71b0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
71c0: 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 *pRC = rc;. r
71d0: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 6f 66 66 eturn;. }. off
71e0: 73 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 set = PTRMAP_PTR
71f0: 4f 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 OFFSET(iPtrmap,
7200: 6b 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 key);. if( offs
7210: 65 74 3c 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 et<0 ){. *pRC
7220: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
7230: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f T_BKPT;. goto
7240: 20 70 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 20 ptrmap_exit;.
7250: 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 }. assert( offs
7260: 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e et <= (int)pBt->
7270: 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a usableSize-5 );.
7280: 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 pPtrmap = (u8
7290: 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 *)sqlite3PagerGe
72a0: 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a tData(pDbPage);.
72b0: 0a 20 20 69 66 28 20 65 54 79 70 65 21 3d 70 50 . if( eType!=pP
72c0: 74 72 6d 61 70 5b 6f 66 66 73 65 74 5d 20 7c 7c trmap[offset] ||
72d0: 20 67 65 74 34 62 79 74 65 28 26 70 50 74 72 6d get4byte(&pPtrm
72e0: 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 21 3d 70 ap[offset+1])!=p
72f0: 61 72 65 6e 74 20 29 7b 0a 20 20 20 20 54 52 41 arent ){. TRA
7300: 43 45 28 28 22 50 54 52 4d 41 50 5f 55 50 44 41 CE(("PTRMAP_UPDA
7310: 54 45 3a 20 25 64 2d 3e 28 25 64 2c 25 64 29 5c TE: %d->(%d,%d)\
7320: 6e 22 2c 20 6b 65 79 2c 20 65 54 79 70 65 2c 20 n", key, eType,
7330: 70 61 72 65 6e 74 29 29 3b 0a 20 20 20 20 2a 70 parent));. *p
7340: 52 43 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33 RC= rc = sqlite3
7350: 50 61 67 65 72 57 72 69 74 65 28 70 44 62 50 61 PagerWrite(pDbPa
7360: 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d ge);. if( rc=
7370: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
7380: 20 20 20 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 pPtrmap[offs
7390: 65 74 5d 20 3d 20 65 54 79 70 65 3b 0a 20 20 20 et] = eType;.
73a0: 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 74 put4byte(&pPt
73b0: 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 2c 20 rmap[offset+1],
73c0: 70 61 72 65 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 parent);. }.
73d0: 20 7d 0a 0a 70 74 72 6d 61 70 5f 65 78 69 74 3a }..ptrmap_exit:
73e0: 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 . sqlite3PagerU
73f0: 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 7d nref(pDbPage);.}
7400: 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 6e 20 ../*.** Read an
7410: 65 6e 74 72 79 20 66 72 6f 6d 20 74 68 65 20 70 entry from the p
7420: 6f 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a ointer map..**.*
7430: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 * This routine r
7440: 65 74 72 69 65 76 65 73 20 74 68 65 20 70 6f 69 etrieves the poi
7450: 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 nter map entry f
7460: 6f 72 20 70 61 67 65 20 27 6b 65 79 27 2c 20 77 or page 'key', w
7470: 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 74 79 riting.** the ty
7480: 70 65 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 pe and parent pa
7490: 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 2a 70 45 ge number to *pE
74a0: 54 79 70 65 20 61 6e 64 20 2a 70 50 67 6e 6f 20 Type and *pPgno
74b0: 72 65 73 70 65 63 74 69 76 65 6c 79 2e 0a 2a 2a respectively..**
74c0: 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 An error code i
74d0: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 73 6f s returned if so
74e0: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
74f0: 6e 67 2c 20 6f 74 68 65 72 77 69 73 65 20 53 51 ng, otherwise SQ
7500: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 LITE_OK..*/.stat
7510: 69 63 20 69 6e 74 20 70 74 72 6d 61 70 47 65 74 ic int ptrmapGet
7520: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
7530: 50 67 6e 6f 20 6b 65 79 2c 20 75 38 20 2a 70 45 Pgno key, u8 *pE
7540: 54 79 70 65 2c 20 50 67 6e 6f 20 2a 70 50 67 6e Type, Pgno *pPgn
7550: 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 o){. DbPage *pD
7560: 62 50 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 bPage; /* The
7570: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
7580: 20 2a 2f 0a 20 20 69 6e 74 20 69 50 74 72 6d 61 */. int iPtrma
7590: 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e p; /* Poin
75a0: 74 65 72 20 6d 61 70 20 70 61 67 65 20 69 6e 64 ter map page ind
75b0: 65 78 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 ex */. u8 *pPtr
75c0: 6d 61 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f map; /* Po
75d0: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 64 inter map page d
75e0: 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 ata */. int off
75f0: 73 65 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f set; /* O
7600: 66 66 73 65 74 20 6f 66 20 65 6e 74 72 79 20 69 ffset of entry i
7610: 6e 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 2a 2f n pointer map */
7620: 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
7630: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
7640: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
7650: 74 65 78 29 20 29 3b 0a 0a 20 20 69 50 74 72 6d tex) );.. iPtrm
7660: 61 70 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 ap = PTRMAP_PAGE
7670: 4e 4f 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 NO(pBt, key);.
7680: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
7690: 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
76a0: 2c 20 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 , iPtrmap, &pDbP
76b0: 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d age);. if( rc!=
76c0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
76d0: 72 63 3b 0a 20 20 7d 0a 20 20 70 50 74 72 6d 61 rc;. }. pPtrma
76e0: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
76f0: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
7700: 62 50 61 67 65 29 3b 0a 0a 20 20 6f 66 66 73 65 bPage);.. offse
7710: 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f 46 t = PTRMAP_PTROF
7720: 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b 65 FSET(iPtrmap, ke
7730: 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 74 y);. if( offset
7740: 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 <0 ){. sqlite
7750: 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 50 3PagerUnref(pDbP
7760: 61 67 65 29 3b 0a 20 20 20 20 72 65 74 75 72 6e age);. return
7770: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
7780: 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 65 BKPT;. }. asse
7790: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
77a0: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
77b0: 7a 65 2d 35 20 29 3b 0a 20 20 61 73 73 65 72 74 ze-5 );. assert
77c0: 28 20 70 45 54 79 70 65 21 3d 30 20 29 3b 0a 20 ( pEType!=0 );.
77d0: 20 2a 70 45 54 79 70 65 20 3d 20 70 50 74 72 6d *pEType = pPtrm
77e0: 61 70 5b 6f 66 66 73 65 74 5d 3b 0a 20 20 69 66 ap[offset];. if
77f0: 28 20 70 50 67 6e 6f 20 29 20 2a 70 50 67 6e 6f ( pPgno ) *pPgno
7800: 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 74 = get4byte(&pPt
7810: 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 3b rmap[offset+1]);
7820: 0a 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 .. sqlite3Pager
7830: 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a Unref(pDbPage);.
7840: 20 20 69 66 28 20 2a 70 45 54 79 70 65 3c 31 20 if( *pEType<1
7850: 7c 7c 20 2a 70 45 54 79 70 65 3e 35 20 29 20 72 || *pEType>5 ) r
7860: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
7870: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 72 65 74 RUPT_BKPT;. ret
7880: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
7890: 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 64 65 ..#else /* if de
78a0: 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4d 49 fined SQLITE_OMI
78b0: 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f 0a T_AUTOVACUUM */.
78c0: 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 #define ptrmap
78d0: 50 75 74 28 77 2c 78 2c 79 2c 7a 2c 72 63 29 0a Put(w,x,y,z,rc).
78e0: 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 #define ptrmap
78f0: 47 65 74 28 77 2c 78 2c 79 2c 7a 29 20 53 51 4c Get(w,x,y,z) SQL
7900: 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 69 6e 65 ITE_OK. #define
7910: 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 ptrmapPutOvflPt
7920: 72 28 78 2c 20 79 2c 20 72 63 29 0a 23 65 6e 64 r(x, y, rc).#end
7930: 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 if../*.** Given
7940: 61 20 62 74 72 65 65 20 70 61 67 65 20 61 6e 64 a btree page and
7950: 20 61 20 63 65 6c 6c 20 69 6e 64 65 78 20 28 30 a cell index (0
7960: 20 6d 65 61 6e 73 20 74 68 65 20 66 69 72 73 74 means the first
7970: 20 63 65 6c 6c 20 6f 6e 0a 2a 2a 20 74 68 65 20 cell on.** the
7980: 70 61 67 65 2c 20 31 20 6d 65 61 6e 73 20 74 68 page, 1 means th
7990: 65 20 73 65 63 6f 6e 64 20 63 65 6c 6c 2c 20 61 e second cell, a
79a0: 6e 64 20 73 6f 20 66 6f 72 74 68 29 20 72 65 74 nd so forth) ret
79b0: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 0a 2a 2a urn a pointer.**
79c0: 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e to the cell con
79d0: 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 tent..**.** This
79e0: 20 72 6f 75 74 69 6e 65 20 77 6f 72 6b 73 20 6f routine works o
79f0: 6e 6c 79 20 66 6f 72 20 70 61 67 65 73 20 74 68 nly for pages th
7a00: 61 74 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 at do not contai
7a10: 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 n overflow cells
7a20: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66 69 6e ..*/.#define fin
7a30: 64 43 65 6c 6c 28 50 2c 49 29 20 5c 0a 20 20 28 dCell(P,I) \. (
7a40: 28 50 29 2d 3e 61 44 61 74 61 20 2b 20 28 28 50 (P)->aData + ((P
7a50: 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 20 67 65 )->maskPage & ge
7a60: 74 32 62 79 74 65 28 26 28 50 29 2d 3e 61 43 65 t2byte(&(P)->aCe
7a70: 6c 6c 49 64 78 5b 32 2a 28 49 29 5d 29 29 29 0a llIdx[2*(I)]))).
7a80: 23 64 65 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c #define findCell
7a90: 76 32 28 44 2c 4d 2c 4f 2c 49 29 20 28 44 2b 28 v2(D,M,O,I) (D+(
7aa0: 4d 26 67 65 74 32 62 79 74 65 28 44 2b 28 4f 2b M&get2byte(D+(O+
7ab0: 32 2a 28 49 29 29 29 29 29 0a 0a 0a 2f 2a 0a 2a 2*(I))))).../*.*
7ac0: 2a 20 54 68 69 73 20 61 20 6d 6f 72 65 20 63 6f * This a more co
7ad0: 6d 70 6c 65 78 20 76 65 72 73 69 6f 6e 20 6f 66 mplex version of
7ae0: 20 66 69 6e 64 43 65 6c 6c 28 29 20 74 68 61 74 findCell() that
7af0: 20 77 6f 72 6b 73 20 66 6f 72 0a 2a 2a 20 70 61 works for.** pa
7b00: 67 65 73 20 74 68 61 74 20 64 6f 20 63 6f 6e 74 ges that do cont
7b10: 61 69 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c ain overflow cel
7b20: 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 38 ls..*/.static u8
7b30: 20 2a 66 69 6e 64 4f 76 65 72 66 6c 6f 77 43 65 *findOverflowCe
7b40: 6c 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ll(MemPage *pPag
7b50: 65 2c 20 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 e, int iCell){.
7b60: 20 69 6e 74 20 69 3b 0a 20 20 61 73 73 65 72 74 int i;. assert
7b70: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
7b80: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
7b90: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72 >mutex) );. for
7ba0: 28 69 3d 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 (i=pPage->nOverf
7bb0: 6c 6f 77 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d low-1; i>=0; i--
7bc0: 29 7b 0a 20 20 20 20 69 6e 74 20 6b 3b 0a 20 20 ){. int k;.
7bd0: 20 20 6b 20 3d 20 70 50 61 67 65 2d 3e 61 69 4f k = pPage->aiO
7be0: 76 66 6c 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 vfl[i];. if(
7bf0: 6b 3c 3d 69 43 65 6c 6c 20 29 7b 0a 20 20 20 20 k<=iCell ){.
7c00: 20 20 69 66 28 20 6b 3d 3d 69 43 65 6c 6c 20 29 if( k==iCell )
7c10: 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e {. return
7c20: 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 69 pPage->apOvfl[i
7c30: 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 ];. }.
7c40: 20 69 43 65 6c 6c 2d 2d 3b 0a 20 20 20 20 7d 0a iCell--;. }.
7c50: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 66 69 6e }. return fin
7c60: 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 dCell(pPage, iCe
7c70: 6c 6c 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 ll);.}../*.** Pa
7c80: 72 73 65 20 61 20 63 65 6c 6c 20 63 6f 6e 74 65 rse a cell conte
7c90: 6e 74 20 62 6c 6f 63 6b 20 61 6e 64 20 66 69 6c nt block and fil
7ca0: 6c 20 69 6e 20 74 68 65 20 43 65 6c 6c 49 6e 66 l in the CellInf
7cb0: 6f 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 o structure. Th
7cc0: 65 72 65 0a 2a 2a 20 61 72 65 20 74 77 6f 20 76 ere.** are two v
7cd0: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 ersions of this
7ce0: 66 75 6e 63 74 69 6f 6e 2e 20 20 62 74 72 65 65 function. btree
7cf0: 50 61 72 73 65 43 65 6c 6c 28 29 20 74 61 6b 65 ParseCell() take
7d00: 73 20 61 20 0a 2a 2a 20 63 65 6c 6c 20 69 6e 64 s a .** cell ind
7d10: 65 78 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ex as the second
7d20: 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 62 74 argument and bt
7d30: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 reeParseCellPtr(
7d40: 29 20 0a 2a 2a 20 74 61 6b 65 73 20 61 20 70 6f ) .** takes a po
7d50: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 62 6f 64 inter to the bod
7d60: 79 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 61 73 y of the cell as
7d70: 20 69 74 73 20 73 65 63 6f 6e 64 20 61 72 67 75 its second argu
7d80: 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ment..*/.static
7d90: 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 void btreeParseC
7da0: 65 6c 6c 50 74 72 28 0a 20 20 4d 65 6d 50 61 67 ellPtr(. MemPag
7db0: 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 e *pPage,
7dc0: 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 /* Page contai
7dd0: 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f ning the cell */
7de0: 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 . u8 *pCell,
7df0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
7e00: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 65 6c inter to the cel
7e10: 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c l text. */. Cel
7e20: 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 lInfo *pInfo
7e30: 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 /* Fill in
7e40: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a this structure *
7e50: 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 /.){. u8 *pIter
7e60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
7e70: 2a 20 46 6f 72 20 73 63 61 6e 6e 69 6e 67 20 74 * For scanning t
7e80: 68 72 6f 75 67 68 20 70 43 65 6c 6c 20 2a 2f 0a hrough pCell */.
7e90: 20 20 75 33 32 20 6e 50 61 79 6c 6f 61 64 3b 20 u32 nPayload;
7ea0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
7eb0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
7ec0: 63 65 6c 6c 20 70 61 79 6c 6f 61 64 20 2a 2f 0a cell payload */.
7ed0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
7ee0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 e3_mutex_held(pP
7ef0: 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 age->pBt->mutex)
7f00: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
7f10: 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 20 7c 7c 20 age->leaf==0 ||
7f20: 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 31 20 29 pPage->leaf==1 )
7f30: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 ;. if( pPage->i
7f40: 6e 74 4b 65 79 4c 65 61 66 20 29 7b 0a 20 20 20 ntKeyLeaf ){.
7f50: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
7f60: 63 68 69 6c 64 50 74 72 53 69 7a 65 3d 3d 30 20 childPtrSize==0
7f70: 29 3b 0a 20 20 20 20 70 49 74 65 72 20 3d 20 70 );. pIter = p
7f80: 43 65 6c 6c 20 2b 20 67 65 74 56 61 72 69 6e 74 Cell + getVarint
7f90: 33 32 28 70 43 65 6c 6c 2c 20 6e 50 61 79 6c 6f 32(pCell, nPaylo
7fa0: 61 64 29 3b 0a 20 20 20 20 70 49 74 65 72 20 2b ad);. pIter +
7fb0: 3d 20 67 65 74 56 61 72 69 6e 74 28 70 49 74 65 = getVarint(pIte
7fc0: 72 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d r, (u64*)&pInfo-
7fd0: 3e 6e 4b 65 79 29 3b 0a 20 20 7d 65 6c 73 65 20 >nKey);. }else
7fe0: 69 66 28 20 70 50 61 67 65 2d 3e 6e 6f 50 61 79 if( pPage->noPay
7ff0: 6c 6f 61 64 20 29 7b 0a 20 20 20 20 61 73 73 65 load ){. asse
8000: 72 74 28 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 rt( pPage->child
8010: 50 74 72 53 69 7a 65 3d 3d 34 20 29 3b 0a 20 20 PtrSize==4 );.
8020: 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d pInfo->nSize =
8030: 20 34 20 2b 20 67 65 74 56 61 72 69 6e 74 28 26 4 + getVarint(&
8040: 70 43 65 6c 6c 5b 34 5d 2c 20 28 75 36 34 2a 29 pCell[4], (u64*)
8050: 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a 20 &pInfo->nKey);.
8060: 20 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f pInfo->nPaylo
8070: 61 64 20 3d 20 30 3b 0a 20 20 20 20 70 49 6e 66 ad = 0;. pInf
8080: 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20 o->nLocal = 0;.
8090: 20 20 20 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 pInfo->iOverf
80a0: 6c 6f 77 20 3d 20 30 3b 0a 20 20 20 20 70 49 6e low = 0;. pIn
80b0: 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 30 fo->pPayload = 0
80c0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 ;. return;.
80d0: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 74 65 72 }else{. pIter
80e0: 20 3d 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 = pCell + pPage
80f0: 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a ->childPtrSize;.
8100: 20 20 20 20 70 49 74 65 72 20 2b 3d 20 67 65 74 pIter += get
8110: 56 61 72 69 6e 74 33 32 28 70 49 74 65 72 2c 20 Varint32(pIter,
8120: 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 20 70 nPayload);. p
8130: 49 6e 66 6f 2d 3e 6e 4b 65 79 20 3d 20 6e 50 61 Info->nKey = nPa
8140: 79 6c 6f 61 64 3b 0a 20 20 7d 0a 20 20 70 49 6e yload;. }. pIn
8150: 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 6e fo->nPayload = n
8160: 50 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 6f Payload;. pInfo
8170: 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 70 49 74 ->pPayload = pIt
8180: 65 72 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 er;. testcase(
8190: 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d nPayload==pPage-
81a0: 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 >maxLocal );. t
81b0: 65 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 estcase( nPayloa
81c0: 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 d==pPage->maxLoc
81d0: 61 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 50 al+1 );. if( nP
81e0: 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d ayload<=pPage->m
81f0: 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 2f axLocal ){. /
8200: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 28 65 * This is the (e
8210: 61 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 asy) common case
8220: 20 77 68 65 72 65 20 74 68 65 20 65 6e 74 69 72 where the entir
8230: 65 20 70 61 79 6c 6f 61 64 20 66 69 74 73 0a 20 e payload fits.
8240: 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 ** on the loc
8250: 61 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f 76 65 al page. No ove
8260: 72 66 6c 6f 77 20 69 73 20 72 65 71 75 69 72 65 rflow is require
8270: 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 49 d.. */. pI
8280: 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 6e 50 61 nfo->nSize = nPa
8290: 79 6c 6f 61 64 20 2b 20 28 75 31 36 29 28 70 49 yload + (u16)(pI
82a0: 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 ter - pCell);.
82b0: 20 20 69 66 28 20 70 49 6e 66 6f 2d 3e 6e 53 69 if( pInfo->nSi
82c0: 7a 65 3c 34 20 29 20 70 49 6e 66 6f 2d 3e 6e 53 ze<4 ) pInfo->nS
82d0: 69 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 49 6e ize = 4;. pIn
82e0: 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 fo->nLocal = (u1
82f0: 36 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 6)nPayload;.
8300: 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f 77 pInfo->iOverflow
8310: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 0;. }else{.
8320: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 79 /* If the pay
8330: 6c 6f 61 64 20 77 69 6c 6c 20 6e 6f 74 20 66 69 load will not fi
8340: 74 20 63 6f 6d 70 6c 65 74 65 6c 79 20 6f 6e 20 t completely on
8350: 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2c 20 the local page,
8360: 77 65 20 68 61 76 65 0a 20 20 20 20 2a 2a 20 74 we have. ** t
8370: 6f 20 64 65 63 69 64 65 20 68 6f 77 20 6d 75 63 o decide how muc
8380: 68 20 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 6c h to store local
8390: 6c 79 20 61 6e 64 20 68 6f 77 20 6d 75 63 68 20 ly and how much
83a0: 74 6f 20 73 70 69 6c 6c 20 6f 6e 74 6f 0a 20 20 to spill onto.
83b0: 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 ** overflow pa
83c0: 67 65 73 2e 20 20 54 68 65 20 73 74 72 61 74 65 ges. The strate
83d0: 67 79 20 69 73 20 74 6f 20 6d 69 6e 69 6d 69 7a gy is to minimiz
83e0: 65 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 e the amount of
83f0: 75 6e 75 73 65 64 0a 20 20 20 20 2a 2a 20 73 70 unused. ** sp
8400: 61 63 65 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 ace on overflow
8410: 70 61 67 65 73 20 77 68 69 6c 65 20 6b 65 65 70 pages while keep
8420: 69 6e 67 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f ing the amount o
8430: 66 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 0a f local storage.
8440: 20 20 20 20 2a 2a 20 69 6e 20 62 65 74 77 65 65 ** in betwee
8450: 6e 20 6d 69 6e 4c 6f 63 61 6c 20 61 6e 64 20 6d n minLocal and m
8460: 61 78 4c 6f 63 61 6c 2e 0a 20 20 20 20 2a 2a 0a axLocal.. **.
8470: 20 20 20 20 2a 2a 20 57 61 72 6e 69 6e 67 3a 20 ** Warning:
8480: 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 77 61 changing the wa
8490: 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 79 6c 6f y overflow paylo
84a0: 61 64 20 69 73 20 64 69 73 74 72 69 62 75 74 65 ad is distribute
84b0: 64 20 69 6e 20 61 6e 79 0a 20 20 20 20 2a 2a 20 d in any. **
84c0: 77 61 79 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 way will result
84d0: 69 6e 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 in an incompatib
84e0: 6c 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 0a le file format..
84f0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6d */. int m
8500: 69 6e 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d 69 6e inLocal; /* Min
8510: 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 70 imum amount of p
8520: 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f 63 61 ayload held loca
8530: 6c 6c 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6d lly */. int m
8540: 61 78 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d 61 78 axLocal; /* Max
8550: 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 70 imum amount of p
8560: 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f 63 61 ayload held loca
8570: 6c 6c 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 73 lly */. int s
8580: 75 72 70 6c 75 73 3b 20 20 20 2f 2a 20 4f 76 65 urplus; /* Ove
8590: 72 66 6c 6f 77 20 70 61 79 6c 6f 61 64 20 61 76 rflow payload av
85a0: 61 69 6c 61 62 6c 65 20 66 6f 72 20 6c 6f 63 61 ailable for loca
85b0: 6c 20 73 74 6f 72 61 67 65 20 2a 2f 0a 0a 20 20 l storage */..
85c0: 20 20 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 61 minLocal = pPa
85d0: 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 ge->minLocal;.
85e0: 20 20 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 50 61 maxLocal = pPa
85f0: 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 ge->maxLocal;.
8600: 20 20 73 75 72 70 6c 75 73 20 3d 20 6d 69 6e 4c surplus = minL
8610: 6f 63 61 6c 20 2b 20 28 6e 50 61 79 6c 6f 61 64 ocal + (nPayload
8620: 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 25 28 70 50 - minLocal)%(pP
8630: 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
8640: 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 74 Size - 4);. t
8650: 65 73 74 63 61 73 65 28 20 73 75 72 70 6c 75 73 estcase( surplus
8660: 3d 3d 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 ==maxLocal );.
8670: 20 20 74 65 73 74 63 61 73 65 28 20 73 75 72 70 testcase( surp
8680: 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 2b 31 20 lus==maxLocal+1
8690: 29 3b 0a 20 20 20 20 69 66 28 20 73 75 72 70 6c );. if( surpl
86a0: 75 73 20 3c 3d 20 6d 61 78 4c 6f 63 61 6c 20 29 us <= maxLocal )
86b0: 7b 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d 3e 6e {. pInfo->n
86c0: 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 73 75 72 Local = (u16)sur
86d0: 70 6c 75 73 3b 0a 20 20 20 20 7d 65 6c 73 65 7b plus;. }else{
86e0: 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c . pInfo->nL
86f0: 6f 63 61 6c 20 3d 20 28 75 31 36 29 6d 69 6e 4c ocal = (u16)minL
8700: 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ocal;. }.
8710: 70 49 6e 66 6f 2d 3e 69 4f 76 65 72 66 6c 6f 77 pInfo->iOverflow
8720: 20 3d 20 28 75 31 36 29 28 26 70 49 6e 66 6f 2d = (u16)(&pInfo-
8730: 3e 70 50 61 79 6c 6f 61 64 5b 70 49 6e 66 6f 2d >pPayload[pInfo-
8740: 3e 6e 4c 6f 63 61 6c 5d 20 2d 20 70 43 65 6c 6c >nLocal] - pCell
8750: 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 );. pInfo->nS
8760: 69 7a 65 20 3d 20 70 49 6e 66 6f 2d 3e 69 4f 76 ize = pInfo->iOv
8770: 65 72 66 6c 6f 77 20 2b 20 34 3b 0a 20 20 7d 0a erflow + 4;. }.
8780: 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 }.static void bt
8790: 72 65 65 50 61 72 73 65 43 65 6c 6c 28 0a 20 20 reeParseCell(.
87a0: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
87b0: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
87c0: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
87d0: 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 ell */. int iCe
87e0: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
87f0: 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 69 6e 64 /* The cell ind
8800: 65 78 2e 20 20 46 69 72 73 74 20 63 65 6c 6c 20 ex. First cell
8810: 69 73 20 30 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e is 0 */. CellIn
8820: 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 fo *pInfo
8830: 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 /* Fill in thi
8840: 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 s structure */.)
8850: 7b 0a 20 20 62 74 72 65 65 50 61 72 73 65 43 65 {. btreeParseCe
8860: 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 66 69 6e llPtr(pPage, fin
8870: 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 dCell(pPage, iCe
8880: 6c 6c 29 2c 20 70 49 6e 66 6f 29 3b 0a 7d 0a 0a ll), pInfo);.}..
8890: 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 74 68 /*.** Compute th
88a0: 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
88b0: 66 20 62 79 74 65 73 20 74 68 61 74 20 61 20 43 f bytes that a C
88c0: 65 6c 6c 20 6e 65 65 64 73 20 69 6e 20 74 68 65 ell needs in the
88d0: 20 63 65 6c 6c 0a 2a 2a 20 64 61 74 61 20 61 72 cell.** data ar
88e0: 65 61 20 6f 66 20 74 68 65 20 62 74 72 65 65 2d ea of the btree-
88f0: 70 61 67 65 2e 20 20 54 68 65 20 72 65 74 75 72 page. The retur
8900: 6e 20 6e 75 6d 62 65 72 20 69 6e 63 6c 75 64 65 n number include
8910: 73 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 s the cell.** da
8920: 74 61 20 68 65 61 64 65 72 20 61 6e 64 20 74 68 ta header and th
8930: 65 20 6c 6f 63 61 6c 20 70 61 79 6c 6f 61 64 2c e local payload,
8940: 20 62 75 74 20 6e 6f 74 20 61 6e 79 20 6f 76 65 but not any ove
8950: 72 66 6c 6f 77 20 70 61 67 65 20 6f 72 0a 2a 2a rflow page or.**
8960: 20 74 68 65 20 73 70 61 63 65 20 75 73 65 64 20 the space used
8970: 62 79 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e by the cell poin
8980: 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 ter..*/.static u
8990: 31 36 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 4d 16 cellSizePtr(M
89a0: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 emPage *pPage, u
89b0: 38 20 2a 70 43 65 6c 6c 29 7b 0a 20 20 75 38 20 8 *pCell){. u8
89c0: 2a 70 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b *pIter = pCell +
89d0: 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
89e0: 53 69 7a 65 3b 20 2f 2a 20 46 6f 72 20 6c 6f 6f Size; /* For loo
89f0: 70 69 6e 67 20 6f 76 65 72 20 62 79 74 65 73 20 ping over bytes
8a00: 6f 66 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 of pCell */. u8
8a10: 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 20 20 20 *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 2f 2a 20 45 6e 64 20 6d 61 /* End ma
8a40: 72 6b 20 66 6f 72 20 61 20 76 61 72 69 6e 74 20 rk for a varint
8a50: 2a 2f 0a 20 20 75 33 32 20 6e 53 69 7a 65 3b 20 */. u32 nSize;
8a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
8a80: 20 53 69 7a 65 20 76 61 6c 75 65 20 74 6f 20 72 Size value to r
8a90: 65 74 75 72 6e 20 2a 2f 0a 0a 23 69 66 64 65 66 eturn */..#ifdef
8aa0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 SQLITE_DEBUG.
8ab0: 2f 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 /* The value ret
8ac0: 75 72 6e 65 64 20 62 79 20 74 68 69 73 20 66 75 urned by this fu
8ad0: 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c nction should al
8ae0: 77 61 79 73 20 62 65 20 74 68 65 20 73 61 6d 65 ways be the same
8af0: 20 61 73 0a 20 20 2a 2a 20 74 68 65 20 28 43 65 as. ** the (Ce
8b00: 6c 6c 49 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 61 llInfo.nSize) va
8b10: 6c 75 65 20 66 6f 75 6e 64 20 62 79 20 64 6f 69 lue found by doi
8b20: 6e 67 20 61 20 66 75 6c 6c 20 70 61 72 73 65 20 ng a full parse
8b30: 6f 66 20 74 68 65 0a 20 20 2a 2a 20 63 65 6c 6c of the. ** cell
8b40: 2e 20 49 66 20 53 51 4c 49 54 45 5f 44 45 42 55 . If SQLITE_DEBU
8b50: 47 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 6e G is defined, an
8b60: 20 61 73 73 65 72 74 28 29 20 61 74 20 74 68 65 assert() at the
8b70: 20 62 6f 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a 20 bottom of. **
8b80: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 76 65 this function ve
8b90: 72 69 66 69 65 73 20 74 68 61 74 20 74 68 69 73 rifies that this
8ba0: 20 69 6e 76 61 72 69 61 6e 74 20 69 73 20 6e 6f invariant is no
8bb0: 74 20 76 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a 20 t violated. */.
8bc0: 20 43 65 6c 6c 49 6e 66 6f 20 64 65 62 75 67 69 CellInfo debugi
8bd0: 6e 66 6f 3b 0a 20 20 62 74 72 65 65 50 61 72 73 nfo;. btreePars
8be0: 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 eCellPtr(pPage,
8bf0: 70 43 65 6c 6c 2c 20 26 64 65 62 75 67 69 6e 66 pCell, &debuginf
8c00: 6f 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 o);.#endif.. if
8c10: 28 20 70 50 61 67 65 2d 3e 6e 6f 50 61 79 6c 6f ( pPage->noPaylo
8c20: 61 64 20 29 7b 0a 20 20 20 20 70 45 6e 64 20 3d ad ){. pEnd =
8c30: 20 26 70 49 74 65 72 5b 39 5d 3b 0a 20 20 20 20 &pIter[9];.
8c40: 77 68 69 6c 65 28 20 28 2a 70 49 74 65 72 2b 2b while( (*pIter++
8c50: 29 26 30 78 38 30 20 26 26 20 70 49 74 65 72 3c )&0x80 && pIter<
8c60: 70 45 6e 64 20 29 3b 0a 20 20 20 20 61 73 73 65 pEnd );. asse
8c70: 72 74 28 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 rt( pPage->child
8c80: 50 74 72 53 69 7a 65 3d 3d 34 20 29 3b 0a 20 20 PtrSize==4 );.
8c90: 20 20 72 65 74 75 72 6e 20 28 75 31 36 29 28 70 return (u16)(p
8ca0: 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 Iter - pCell);.
8cb0: 20 7d 0a 20 20 6e 53 69 7a 65 20 3d 20 2a 70 49 }. nSize = *pI
8cc0: 74 65 72 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 ter;. if( nSize
8cd0: 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 70 45 >=0x80 ){. pE
8ce0: 6e 64 20 3d 20 26 70 49 74 65 72 5b 39 5d 3b 0a nd = &pIter[9];.
8cf0: 20 20 20 20 6e 53 69 7a 65 20 26 3d 20 30 78 37 nSize &= 0x7
8d00: 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 f;. do{.
8d10: 20 6e 53 69 7a 65 20 3d 20 28 6e 53 69 7a 65 3c nSize = (nSize<
8d20: 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 <7) | (*++pIter
8d30: 26 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 & 0x7f);. }wh
8d40: 69 6c 65 28 20 2a 28 70 49 74 65 72 29 3e 3d 30 ile( *(pIter)>=0
8d50: 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e x80 && pIter<pEn
8d60: 64 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 d );. }. pIter
8d70: 2b 2b 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d ++;. if( pPage-
8d80: 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 2f >intKey ){. /
8d90: 2a 20 70 49 74 65 72 20 6e 6f 77 20 70 6f 69 6e * pIter now poin
8da0: 74 73 20 61 74 20 74 68 65 20 36 34 2d 62 69 74 ts at the 64-bit
8db0: 20 69 6e 74 65 67 65 72 20 6b 65 79 20 76 61 6c integer key val
8dc0: 75 65 2c 20 61 20 76 61 72 69 61 62 6c 65 20 6c ue, a variable l
8dd0: 65 6e 67 74 68 20 0a 20 20 20 20 2a 2a 20 69 6e ength . ** in
8de0: 74 65 67 65 72 2e 20 54 68 65 20 66 6f 6c 6c 6f teger. The follo
8df0: 77 69 6e 67 20 62 6c 6f 63 6b 20 6d 6f 76 65 73 wing block moves
8e00: 20 70 49 74 65 72 20 74 6f 20 70 6f 69 6e 74 20 pIter to point
8e10: 61 74 20 74 68 65 20 66 69 72 73 74 20 62 79 74 at the first byt
8e20: 65 0a 20 20 20 20 2a 2a 20 70 61 73 74 20 74 68 e. ** past th
8e30: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6b 65 79 e end of the key
8e40: 20 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 70 value. */. p
8e50: 45 6e 64 20 3d 20 26 70 49 74 65 72 5b 39 5d 3b End = &pIter[9];
8e60: 0a 20 20 20 20 77 68 69 6c 65 28 20 28 2a 70 49 . while( (*pI
8e70: 74 65 72 2b 2b 29 26 30 78 38 30 20 26 26 20 70 ter++)&0x80 && p
8e80: 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d Iter<pEnd );. }
8e90: 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 . testcase( nSi
8ea0: 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f ze==pPage->maxLo
8eb0: 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 cal );. testcas
8ec0: 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d e( nSize==pPage-
8ed0: 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 >maxLocal+1 );.
8ee0: 20 69 66 28 20 6e 53 69 7a 65 3c 3d 70 50 61 67 if( nSize<=pPag
8ef0: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 e->maxLocal ){.
8f00: 20 20 20 6e 53 69 7a 65 20 2b 3d 20 28 75 33 32 nSize += (u32
8f10: 29 28 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 )(pIter - pCell)
8f20: 3b 0a 20 20 20 20 69 66 28 20 6e 53 69 7a 65 3c ;. if( nSize<
8f30: 34 20 29 20 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 4 ) nSize = 4;.
8f40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 }else{. int
8f50: 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 minLocal = pPage
8f60: 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 ->minLocal;.
8f70: 6e 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c nSize = minLocal
8f80: 20 2b 20 28 6e 53 69 7a 65 20 2d 20 6d 69 6e 4c + (nSize - minL
8f90: 6f 63 61 6c 29 20 25 20 28 70 50 61 67 65 2d 3e ocal) % (pPage->
8fa0: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
8fb0: 2d 20 34 29 3b 0a 20 20 20 20 74 65 73 74 63 61 - 4);. testca
8fc0: 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 se( nSize==pPage
8fd0: 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 ->maxLocal );.
8fe0: 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a testcase( nSiz
8ff0: 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 e==pPage->maxLoc
9000: 61 6c 2b 31 20 29 3b 0a 20 20 20 20 69 66 28 20 al+1 );. if(
9010: 6e 53 69 7a 65 3e 70 50 61 67 65 2d 3e 6d 61 78 nSize>pPage->max
9020: 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 6e Local ){. n
9030: 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 3b Size = minLocal;
9040: 0a 20 20 20 20 7d 0a 20 20 20 20 6e 53 69 7a 65 . }. nSize
9050: 20 2b 3d 20 34 20 2b 20 28 75 31 36 29 28 70 49 += 4 + (u16)(pI
9060: 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 ter - pCell);.
9070: 7d 0a 20 20 61 73 73 65 72 74 28 20 6e 53 69 7a }. assert( nSiz
9080: 65 3d 3d 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 e==debuginfo.nSi
9090: 7a 65 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 ze || CORRUPT_DB
90a0: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 75 31 );. return (u1
90b0: 36 29 6e 53 69 7a 65 3b 0a 7d 0a 0a 23 69 66 64 6)nSize;.}..#ifd
90c0: 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
90d0: 2f 2a 20 54 68 69 73 20 76 61 72 69 61 74 69 6f /* This variatio
90e0: 6e 20 6f 6e 20 63 65 6c 6c 53 69 7a 65 50 74 72 n on cellSizePtr
90f0: 28 29 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 () is used insid
9100: 65 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 e of assert() st
9110: 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 atements.** only
9120: 2e 20 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 . */.static u16
9130: 63 65 6c 6c 53 69 7a 65 28 4d 65 6d 50 61 67 65 cellSize(MemPage
9140: 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 43 65 *pPage, int iCe
9150: 6c 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 65 ll){. return ce
9160: 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c llSizePtr(pPage,
9170: 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c findCell(pPage,
9180: 20 69 43 65 6c 6c 29 29 3b 0a 7d 0a 23 65 6e 64 iCell));.}.#end
9190: 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 if..#ifndef SQLI
91a0: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
91b0: 55 4d 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 UM./*.** If the
91c0: 63 65 6c 6c 20 70 43 65 6c 6c 2c 20 70 61 72 74 cell pCell, part
91d0: 20 6f 66 20 70 61 67 65 20 70 50 61 67 65 20 63 of page pPage c
91e0: 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 ontains a pointe
91f0: 72 0a 2a 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 r.** to an overf
9200: 6c 6f 77 20 70 61 67 65 2c 20 69 6e 73 65 72 74 low page, insert
9210: 20 61 6e 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 an entry into t
9220: 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 2a he pointer-map.*
9230: 2a 20 66 6f 72 20 74 68 65 20 6f 76 65 72 66 6c * for the overfl
9240: 6f 77 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 ow page..*/.stat
9250: 69 63 20 76 6f 69 64 20 70 74 72 6d 61 70 50 75 ic void ptrmapPu
9260: 74 4f 76 66 6c 50 74 72 28 4d 65 6d 50 61 67 65 tOvflPtr(MemPage
9270: 20 2a 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 *pPage, u8 *pCe
9280: 6c 6c 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 ll, int *pRC){.
9290: 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a CellInfo info;.
92a0: 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 74 if( *pRC ) ret
92b0: 75 72 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 70 urn;. assert( p
92c0: 43 65 6c 6c 21 3d 30 20 29 3b 0a 20 20 62 74 72 Cell!=0 );. btr
92d0: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 eeParseCellPtr(p
92e0: 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e Page, pCell, &in
92f0: 66 6f 29 3b 0a 20 20 69 66 28 20 69 6e 66 6f 2e fo);. if( info.
9300: 69 4f 76 65 72 66 6c 6f 77 20 29 7b 0a 20 20 20 iOverflow ){.
9310: 20 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 Pgno ovfl = get
9320: 34 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 4byte(&pCell[inf
9330: 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 o.iOverflow]);.
9340: 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 50 61 ptrmapPut(pPa
9350: 67 65 2d 3e 70 42 74 2c 20 6f 76 66 6c 2c 20 50 ge->pBt, ovfl, P
9360: 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 2c TRMAP_OVERFLOW1,
9370: 20 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 70 52 pPage->pgno, pR
9380: 43 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 C);. }.}.#endif
9390: 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 72 61 67 6d .../*.** Defragm
93a0: 65 6e 74 20 74 68 65 20 70 61 67 65 20 67 69 76 ent the page giv
93b0: 65 6e 2e 20 20 41 6c 6c 20 43 65 6c 6c 73 20 61 en. All Cells a
93c0: 72 65 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 0a re moved to the.
93d0: 2a 2a 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 ** end of the pa
93e0: 67 65 20 61 6e 64 20 61 6c 6c 20 66 72 65 65 20 ge and all free
93f0: 73 70 61 63 65 20 69 73 20 63 6f 6c 6c 65 63 74 space is collect
9400: 65 64 20 69 6e 74 6f 20 6f 6e 65 0a 2a 2a 20 62 ed into one.** b
9410: 69 67 20 46 72 65 65 42 6c 6b 20 74 68 61 74 20 ig FreeBlk that
9420: 6f 63 63 75 72 73 20 69 6e 20 62 65 74 77 65 65 occurs in betwee
9430: 6e 20 74 68 65 20 68 65 61 64 65 72 20 61 6e 64 n the header and
9440: 20 63 65 6c 6c 0a 2a 2a 20 70 6f 69 6e 74 65 72 cell.** pointer
9450: 20 61 72 72 61 79 20 61 6e 64 20 74 68 65 20 63 array and the c
9460: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
9470: 2e 0a 2a 2a 0a 2a 2a 20 45 56 49 44 45 4e 43 45 ..**.** EVIDENCE
9480: 2d 4f 46 3a 20 52 2d 34 34 35 38 32 2d 36 30 31 -OF: R-44582-601
9490: 33 38 20 53 51 4c 69 74 65 20 6d 61 79 20 66 72 38 SQLite may fr
94a0: 6f 6d 20 74 69 6d 65 20 74 6f 20 74 69 6d 65 20 om time to time
94b0: 72 65 6f 72 67 61 6e 69 7a 65 20 61 0a 2a 2a 20 reorganize a.**
94c0: 62 2d 74 72 65 65 20 70 61 67 65 20 73 6f 20 74 b-tree page so t
94d0: 68 61 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f hat there are no
94e0: 20 66 72 65 65 62 6c 6f 63 6b 73 20 6f 72 20 66 freeblocks or f
94f0: 72 61 67 6d 65 6e 74 20 62 79 74 65 73 2c 20 61 ragment bytes, a
9500: 6c 6c 0a 2a 2a 20 75 6e 75 73 65 64 20 62 79 74 ll.** unused byt
9510: 65 73 20 61 72 65 20 63 6f 6e 74 61 69 6e 65 64 es are contained
9520: 20 69 6e 20 74 68 65 20 75 6e 61 6c 6c 6f 63 61 in the unalloca
9530: 74 65 64 20 73 70 61 63 65 20 72 65 67 69 6f 6e ted space region
9540: 2c 20 61 6e 64 20 61 6c 6c 0a 2a 2a 20 63 65 6c , and all.** cel
9550: 6c 73 20 61 72 65 20 70 61 63 6b 65 64 20 74 69 ls are packed ti
9560: 67 68 74 6c 79 20 61 74 20 74 68 65 20 65 6e 64 ghtly at the end
9570: 20 6f 66 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f of the page..*/
9580: 0a 73 74 61 74 69 63 20 69 6e 74 20 64 65 66 72 .static int defr
9590: 61 67 6d 65 6e 74 50 61 67 65 28 4d 65 6d 50 61 agmentPage(MemPa
95a0: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
95b0: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
95c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
95d0: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 6e counter */. in
95e0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 t pc;
95f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 /* Addr
9600: 65 73 73 20 6f 66 20 74 68 65 20 69 2d 74 68 20 ess of the i-th
9610: 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 68 64 cell */. int hd
9620: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
9630: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 /* Offset t
9640: 6f 20 74 68 65 20 70 61 67 65 20 68 65 61 64 65 o the page heade
9650: 72 20 2a 2f 0a 20 20 69 6e 74 20 73 69 7a 65 3b r */. int size;
9660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9670: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 63 /* Size of a c
9680: 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 ell */. int usa
9690: 62 6c 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 bleSize;
96a0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
96b0: 20 75 73 61 62 6c 65 20 62 79 74 65 73 20 6f 6e usable bytes on
96c0: 20 61 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 a page */. int
96d0: 20 63 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 cellOffset;
96e0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
96f0: 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f t to the cell po
9700: 69 6e 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 inter array */.
9710: 20 69 6e 74 20 63 62 72 6b 3b 20 20 20 20 20 20 int cbrk;
9720: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
9730: 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c ffset to the cel
9740: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a l content area *
9750: 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 /. int nCell;
9760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
9770: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c * Number of cell
9780: 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a 2f s on the page */
9790: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
97a0: 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a *data; /*
97b0: 20 54 68 65 20 70 61 67 65 20 64 61 74 61 20 2a The page data *
97c0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
97d0: 72 20 2a 74 65 6d 70 3b 20 20 20 20 20 20 20 2f r *temp; /
97e0: 2a 20 54 65 6d 70 20 61 72 65 61 20 66 6f 72 20 * Temp area for
97f0: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a cell content */.
9800: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
9810: 2a 73 72 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 *src; /*
9820: 53 6f 75 72 63 65 20 6f 66 20 63 6f 6e 74 65 6e Source of conten
9830: 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c t */. int iCell
9840: 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20 20 First;
9850: 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f 77 /* First allow
9860: 61 62 6c 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 able cell index
9870: 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c 4c 61 */. int iCellLa
9880: 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 st;
9890: 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 6c 65 /* Last possible
98a0: 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 0a cell index */..
98b0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
98c0: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
98d0: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
98e0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
98f0: 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b pPage->pBt!=0 );
9900: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
9910: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
9920: 65 20 3c 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f e <= SQLITE_MAX_
9930: 50 41 47 45 5f 53 49 5a 45 20 29 3b 0a 20 20 61 PAGE_SIZE );. a
9940: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f ssert( pPage->nO
9950: 76 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 verflow==0 );.
9960: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
9970: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
9980: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
9990: 0a 20 20 74 65 6d 70 20 3d 20 30 3b 0a 20 20 73 . temp = 0;. s
99a0: 72 63 20 3d 20 64 61 74 61 20 3d 20 70 50 61 67 rc = data = pPag
99b0: 65 2d 3e 61 44 61 74 61 3b 0a 20 20 68 64 72 20 e->aData;. hdr
99c0: 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 = pPage->hdrOffs
99d0: 65 74 3b 0a 20 20 63 65 6c 6c 4f 66 66 73 65 74 et;. cellOffset
99e0: 20 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 = pPage->cellOf
99f0: 66 73 65 74 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 fset;. nCell =
9a00: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
9a10: 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 3d 3d 67 assert( nCell==g
9a20: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
9a30: 72 2b 33 5d 29 20 29 3b 0a 20 20 75 73 61 62 6c r+3]) );. usabl
9a40: 65 53 69 7a 65 20 3d 20 70 50 61 67 65 2d 3e 70 eSize = pPage->p
9a50: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a Bt->usableSize;.
9a60: 20 20 63 62 72 6b 20 3d 20 75 73 61 62 6c 65 53 cbrk = usableS
9a70: 69 7a 65 3b 0a 20 20 69 43 65 6c 6c 46 69 72 73 ize;. iCellFirs
9a80: 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b t = cellOffset +
9a90: 20 32 2a 6e 43 65 6c 6c 3b 0a 20 20 69 43 65 6c 2*nCell;. iCel
9aa0: 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c 65 53 69 lLast = usableSi
9ab0: 7a 65 20 2d 20 34 3b 0a 20 20 66 6f 72 28 69 3d ze - 4;. for(i=
9ac0: 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 0; i<nCell; i++)
9ad0: 7b 0a 20 20 20 20 75 38 20 2a 70 41 64 64 72 3b {. u8 *pAddr;
9ae0: 20 20 20 20 20 2f 2a 20 54 68 65 20 69 2d 74 68 /* The i-th
9af0: 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 2a 2f cell pointer */
9b00: 0a 20 20 20 20 70 41 64 64 72 20 3d 20 26 64 61 . pAddr = &da
9b10: 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 ta[cellOffset +
9b20: 69 2a 32 5d 3b 0a 20 20 20 20 70 63 20 3d 20 67 i*2];. pc = g
9b30: 65 74 32 62 79 74 65 28 70 41 64 64 72 29 3b 0a et2byte(pAddr);.
9b40: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
9b50: 3d 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a ==iCellFirst );.
9b60: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
9b70: 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 23 ==iCellLast );.#
9b80: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
9b90: 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 TE_ENABLE_OVERSI
9ba0: 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 0a 20 ZE_CELL_CHECK).
9bb0: 20 20 20 2f 2a 20 54 68 65 73 65 20 63 6f 6e 64 /* These cond
9bc0: 69 74 69 6f 6e 73 20 68 61 76 65 20 61 6c 72 65 itions have alre
9bd0: 61 64 79 20 62 65 65 6e 20 76 65 72 69 66 69 65 ady been verifie
9be0: 64 20 69 6e 20 62 74 72 65 65 49 6e 69 74 50 61 d in btreeInitPa
9bf0: 67 65 28 29 0a 20 20 20 20 2a 2a 20 69 66 20 53 ge(). ** if S
9c00: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 QLITE_ENABLE_OVE
9c10: 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b RSIZE_CELL_CHECK
9c20: 20 69 73 20 64 65 66 69 6e 65 64 20 0a 20 20 20 is defined .
9c30: 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 63 3c 69 */. if( pc<i
9c40: 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e CellFirst || pc>
9c50: 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 iCellLast ){.
9c60: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
9c70: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
9c80: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
9c90: 61 73 73 65 72 74 28 20 70 63 3e 3d 69 43 65 6c assert( pc>=iCel
9ca0: 6c 46 69 72 73 74 20 26 26 20 70 63 3c 3d 69 43 lFirst && pc<=iC
9cb0: 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 73 ellLast );. s
9cc0: 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 ize = cellSizePt
9cd0: 72 28 70 50 61 67 65 2c 20 26 73 72 63 5b 70 63 r(pPage, &src[pc
9ce0: 5d 29 3b 0a 20 20 20 20 63 62 72 6b 20 2d 3d 20 ]);. cbrk -=
9cf0: 73 69 7a 65 3b 0a 23 69 66 20 64 65 66 69 6e 65 size;.#if define
9d00: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f d(SQLITE_ENABLE_
9d10: 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 OVERSIZE_CELL_CH
9d20: 45 43 4b 29 0a 20 20 20 20 69 66 28 20 63 62 72 ECK). if( cbr
9d30: 6b 3c 69 43 65 6c 6c 46 69 72 73 74 20 29 7b 0a k<iCellFirst ){.
9d40: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
9d50: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
9d60: 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 ;. }.#else.
9d70: 20 20 69 66 28 20 63 62 72 6b 3c 69 43 65 6c 6c if( cbrk<iCell
9d80: 46 69 72 73 74 20 7c 7c 20 70 63 2b 73 69 7a 65 First || pc+size
9d90: 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
9da0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
9db0: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
9dc0: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
9dd0: 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 2b 73 assert( cbrk+s
9de0: 69 7a 65 3c 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize<=usableSize
9df0: 26 26 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 && cbrk>=iCellFi
9e00: 72 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 rst );. testc
9e10: 61 73 65 28 20 63 62 72 6b 2b 73 69 7a 65 3d 3d ase( cbrk+size==
9e20: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
9e30: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
9e40: 69 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize==usableSize
9e50: 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
9e60: 70 41 64 64 72 2c 20 63 62 72 6b 29 3b 0a 20 20 pAddr, cbrk);.
9e70: 20 20 69 66 28 20 74 65 6d 70 3d 3d 30 20 29 7b if( temp==0 ){
9e80: 0a 20 20 20 20 20 20 69 6e 74 20 78 3b 0a 20 20 . int x;.
9e90: 20 20 20 20 69 66 28 20 63 62 72 6b 3d 3d 70 63 if( cbrk==pc
9ea0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
9eb0: 20 20 20 74 65 6d 70 20 3d 20 73 71 6c 69 74 65 temp = sqlite
9ec0: 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 28 3PagerTempSpace(
9ed0: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 50 61 67 pPage->pBt->pPag
9ee0: 65 72 29 3b 0a 20 20 20 20 20 20 78 20 3d 20 67 er);. x = g
9ef0: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
9f00: 72 2b 35 5d 29 3b 0a 20 20 20 20 20 20 6d 65 6d r+5]);. mem
9f10: 63 70 79 28 26 74 65 6d 70 5b 78 5d 2c 20 26 64 cpy(&temp[x], &d
9f20: 61 74 61 5b 78 5d 2c 20 28 63 62 72 6b 2b 73 69 ata[x], (cbrk+si
9f30: 7a 65 29 20 2d 20 78 29 3b 0a 20 20 20 20 20 20 ze) - x);.
9f40: 73 72 63 20 3d 20 74 65 6d 70 3b 0a 20 20 20 20 src = temp;.
9f50: 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 }. memcpy(&da
9f60: 74 61 5b 63 62 72 6b 5d 2c 20 26 73 72 63 5b 70 ta[cbrk], &src[p
9f70: 63 5d 2c 20 73 69 7a 65 29 3b 0a 20 20 7d 0a 20 c], size);. }.
9f80: 20 61 73 73 65 72 74 28 20 63 62 72 6b 3e 3d 69 assert( cbrk>=i
9f90: 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 70 CellFirst );. p
9fa0: 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 ut2byte(&data[hd
9fb0: 72 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a 20 20 64 r+5], cbrk);. d
9fc0: 61 74 61 5b 68 64 72 2b 31 5d 20 3d 20 30 3b 0a ata[hdr+1] = 0;.
9fd0: 20 20 64 61 74 61 5b 68 64 72 2b 32 5d 20 3d 20 data[hdr+2] =
9fe0: 30 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 0;. data[hdr+7]
9ff0: 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 26 = 0;. memset(&
a000: 64 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 74 5d data[iCellFirst]
a010: 2c 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c 6c 46 , 0, cbrk-iCellF
a020: 69 72 73 74 29 3b 0a 20 20 61 73 73 65 72 74 28 irst);. assert(
a030: 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
a040: 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
a050: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 69 66 pDbPage) );. if
a060: 28 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 72 73 ( cbrk-iCellFirs
a070: 74 21 3d 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 t!=pPage->nFree
a080: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
a090: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
a0a0: 54 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 T;. }. return
a0b0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
a0c0: 0a 2a 2a 20 53 65 61 72 63 68 20 74 68 65 20 66 .** Search the f
a0d0: 72 65 65 2d 6c 69 73 74 20 6f 6e 20 70 61 67 65 ree-list on page
a0e0: 20 70 50 67 20 66 6f 72 20 73 70 61 63 65 20 74 pPg for space t
a0f0: 6f 20 73 74 6f 72 65 20 61 20 63 65 6c 6c 20 6e o store a cell n
a100: 42 79 74 65 20 62 79 74 65 73 20 69 6e 0a 2a 2a Byte bytes in.**
a110: 20 73 69 7a 65 2e 20 49 66 20 6f 6e 65 20 63 61 size. If one ca
a120: 6e 20 62 65 20 66 6f 75 6e 64 2c 20 72 65 74 75 n be found, retu
a130: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 rn a pointer to
a140: 74 68 65 20 73 70 61 63 65 20 61 6e 64 20 72 65 the space and re
a150: 6d 6f 76 65 20 69 74 0a 2a 2a 20 66 72 6f 6d 20 move it.** from
a160: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 2a the free-list..*
a170: 2a 0a 2a 2a 20 49 66 20 6e 6f 20 73 75 69 74 61 *.** If no suita
a180: 62 6c 65 20 73 70 61 63 65 20 63 61 6e 20 62 65 ble space can be
a190: 20 66 6f 75 6e 64 20 6f 6e 20 74 68 65 20 66 72 found on the fr
a1a0: 65 65 2d 6c 69 73 74 2c 20 72 65 74 75 72 6e 20 ee-list, return
a1b0: 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 NULL..**.** This
a1c0: 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 64 65 function may de
a1d0: 74 65 63 74 20 63 6f 72 72 75 70 74 69 6f 6e 20 tect corruption
a1e0: 77 69 74 68 69 6e 20 70 50 67 2e 20 20 49 66 20 within pPg. If
a1f0: 63 6f 72 72 75 70 74 69 6f 6e 20 69 73 0a 2a 2a corruption is.**
a200: 20 64 65 74 65 63 74 65 64 20 74 68 65 6e 20 2a detected then *
a210: 70 52 63 20 69 73 20 73 65 74 20 74 6f 20 53 51 pRc is set to SQ
a220: 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 61 6e 64 LITE_CORRUPT and
a230: 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 NULL is returne
a240: 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 73 6c d..**.** If a sl
a250: 6f 74 20 6f 66 20 61 74 20 6c 65 61 73 74 20 6e ot of at least n
a260: 42 79 74 65 20 62 79 74 65 73 20 69 73 20 66 6f Byte bytes is fo
a270: 75 6e 64 20 62 75 74 20 63 61 6e 6e 6f 74 20 62 und but cannot b
a280: 65 20 75 73 65 64 20 62 65 63 61 75 73 65 20 0a e used because .
a290: 2a 2a 20 74 68 65 72 65 20 61 72 65 20 61 6c 72 ** there are alr
a2a0: 65 61 64 79 20 61 74 20 6c 65 61 73 74 20 36 30 eady at least 60
a2b0: 20 66 72 61 67 6d 65 6e 74 65 64 20 62 79 74 65 fragmented byte
a2c0: 73 20 6f 6e 20 74 68 65 20 70 61 67 65 2c 20 72 s on the page, r
a2d0: 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2a 20 49 eturn NULL..** I
a2e0: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 69 66 20 n this case, if
a2f0: 70 62 44 65 66 72 61 67 20 70 61 72 61 6d 65 74 pbDefrag paramet
a300: 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 er is not NULL,
a310: 73 65 74 20 2a 70 62 44 65 66 72 61 67 20 74 6f set *pbDefrag to
a320: 20 74 72 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 true..*/.static
a330: 20 75 38 20 2a 70 61 67 65 46 69 6e 64 53 6c 6f u8 *pageFindSlo
a340: 74 28 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 t(MemPage *pPg,
a350: 69 6e 74 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a int nByte, int *
a360: 70 52 63 2c 20 69 6e 74 20 2a 70 62 44 65 66 72 pRc, int *pbDefr
a370: 61 67 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 ag){. const int
a380: 20 68 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f hdr = pPg->hdrO
a390: 66 66 73 65 74 3b 0a 20 20 75 38 20 2a 20 63 6f ffset;. u8 * co
a3a0: 6e 73 74 20 61 44 61 74 61 20 3d 20 70 50 67 2d nst aData = pPg-
a3b0: 3e 61 44 61 74 61 3b 0a 20 20 69 6e 74 20 69 41 >aData;. int iA
a3c0: 64 64 72 3b 0a 20 20 69 6e 74 20 70 63 3b 0a 20 ddr;. int pc;.
a3d0: 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 20 int usableSize
a3e0: 3d 20 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 = pPg->pBt->usab
a3f0: 6c 65 53 69 7a 65 3b 0a 0a 20 20 66 6f 72 28 69 leSize;.. for(i
a400: 41 64 64 72 3d 68 64 72 2b 31 3b 20 28 70 63 20 Addr=hdr+1; (pc
a410: 3d 20 67 65 74 32 62 79 74 65 28 26 61 44 61 74 = get2byte(&aDat
a420: 61 5b 69 41 64 64 72 5d 29 29 3e 30 3b 20 69 41 a[iAddr]))>0; iA
a430: 64 64 72 3d 70 63 29 7b 0a 20 20 20 20 69 6e 74 ddr=pc){. int
a440: 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 size;
a450: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 /* Size of the
a460: 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 free slot */.
a470: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
a480: 3a 20 52 2d 30 36 38 36 36 2d 33 39 31 32 35 20 : R-06866-39125
a490: 46 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 20 61 Freeblocks are a
a4a0: 6c 77 61 79 73 20 63 6f 6e 6e 65 63 74 65 64 20 lways connected
a4b0: 69 6e 20 6f 72 64 65 72 20 6f 66 0a 20 20 20 20 in order of.
a4c0: 2a 2a 20 69 6e 63 72 65 61 73 69 6e 67 20 6f 66 ** increasing of
a4d0: 66 73 65 74 2e 20 2a 2f 0a 20 20 20 20 69 66 28 fset. */. if(
a4e0: 20 70 63 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 pc>usableSize-4
a4f0: 20 7c 7c 20 70 63 3c 69 41 64 64 72 2b 34 20 29 || pc<iAddr+4 )
a500: 7b 0a 20 20 20 20 20 20 2a 70 52 63 20 3d 20 53 {. *pRc = S
a510: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
a520: 50 54 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e PT;. return
a530: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 0;. }. /*
a540: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
a550: 32 32 37 31 30 2d 35 33 33 32 38 20 54 68 65 20 22710-53328 The
a560: 74 68 69 72 64 20 61 6e 64 20 66 6f 75 72 74 68 third and fourth
a570: 20 62 79 74 65 73 20 6f 66 20 65 61 63 68 0a 20 bytes of each.
a580: 20 20 20 2a 2a 20 66 72 65 65 62 6c 6f 63 6b 20 ** freeblock
a590: 66 6f 72 6d 20 61 20 62 69 67 2d 65 6e 64 69 61 form a big-endia
a5a0: 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 n integer which
a5b0: 69 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 is the size of t
a5c0: 68 65 20 66 72 65 65 62 6c 6f 63 6b 0a 20 20 20 he freeblock.
a5d0: 20 2a 2a 20 69 6e 20 62 79 74 65 73 2c 20 69 6e ** in bytes, in
a5e0: 63 6c 75 64 69 6e 67 20 74 68 65 20 34 2d 62 79 cluding the 4-by
a5f0: 74 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 20 te header. */.
a600: 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 79 74 size = get2byt
a610: 65 28 26 61 44 61 74 61 5b 70 63 2b 32 5d 29 3b e(&aData[pc+2]);
a620: 0a 20 20 20 20 69 66 28 20 73 69 7a 65 3e 3d 6e . if( size>=n
a630: 42 79 74 65 20 29 7b 0a 20 20 20 20 20 20 69 6e Byte ){. in
a640: 74 20 78 20 3d 20 73 69 7a 65 20 2d 20 6e 42 79 t x = size - nBy
a650: 74 65 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 te;. testca
a660: 73 65 28 20 78 3d 3d 34 20 29 3b 0a 20 20 20 20 se( x==4 );.
a670: 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d 33 testcase( x==3
a680: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 78 3c );. if( x<
a690: 34 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 4 ){. /*
a6a0: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 EVIDENCE-OF: R-1
a6b0: 31 34 39 38 2d 35 38 30 32 32 20 49 6e 20 61 20 1498-58022 In a
a6c0: 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 62 2d 74 72 well-formed b-tr
a6d0: 65 65 20 70 61 67 65 2c 20 74 68 65 20 74 6f 74 ee page, the tot
a6e0: 61 6c 0a 20 20 20 20 20 20 20 20 2a 2a 20 6e 75 al. ** nu
a6f0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e mber of bytes in
a700: 20 66 72 61 67 6d 65 6e 74 73 20 6d 61 79 20 6e fragments may n
a710: 6f 74 20 65 78 63 65 65 64 20 36 30 2e 20 2a 2f ot exceed 60. */
a720: 0a 20 20 20 20 20 20 20 20 69 66 28 20 61 44 61 . if( aDa
a730: 74 61 5b 68 64 72 2b 37 5d 3e 3d 36 30 20 29 7b ta[hdr+7]>=60 ){
a740: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 . if( p
a750: 62 44 65 66 72 61 67 20 29 20 2a 70 62 44 65 66 bDefrag ) *pbDef
a760: 72 61 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 rag = 1;.
a770: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 return 0;.
a780: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2f }. /
a790: 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 73 6c 6f * Remove the slo
a7a0: 74 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d t from the free-
a7b0: 6c 69 73 74 2e 20 55 70 64 61 74 65 20 74 68 65 list. Update the
a7c0: 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 20 20 number of.
a7d0: 20 20 20 2a 2a 20 66 72 61 67 6d 65 6e 74 65 64 ** fragmented
a7e0: 20 62 79 74 65 73 20 77 69 74 68 69 6e 20 74 68 bytes within th
a7f0: 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 e page. */.
a800: 20 20 20 6d 65 6d 63 70 79 28 26 61 44 61 74 61 memcpy(&aData
a810: 5b 69 41 64 64 72 5d 2c 20 26 61 44 61 74 61 5b [iAddr], &aData[
a820: 70 63 5d 2c 20 32 29 3b 0a 20 20 20 20 20 20 20 pc], 2);.
a830: 20 61 44 61 74 61 5b 68 64 72 2b 37 5d 20 2b 3d aData[hdr+7] +=
a840: 20 28 75 38 29 78 3b 0a 20 20 20 20 20 20 7d 65 (u8)x;. }e
a850: 6c 73 65 20 69 66 28 20 73 69 7a 65 2b 70 63 20 lse if( size+pc
a860: 3e 20 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a > usableSize ){.
a870: 20 20 20 20 20 20 20 20 2a 70 52 63 20 3d 20 53 *pRc = S
a880: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
a890: 50 54 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 PT;. retu
a8a0: 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 rn 0;. }els
a8b0: 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 e{. /* Th
a8c0: 65 20 73 6c 6f 74 20 72 65 6d 61 69 6e 73 20 6f e slot remains o
a8d0: 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e n the free-list.
a8e0: 20 52 65 64 75 63 65 20 69 74 73 20 73 69 7a 65 Reduce its size
a8f0: 20 74 6f 20 61 63 63 6f 75 6e 74 0a 20 20 20 20 to account.
a900: 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 68 65 20 ** for the
a910: 70 6f 72 74 69 6f 6e 20 75 73 65 64 20 62 79 20 portion used by
a920: 74 68 65 20 6e 65 77 20 61 6c 6c 6f 63 61 74 69 the new allocati
a930: 6f 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 on. */. p
a940: 75 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 ut2byte(&aData[p
a950: 63 2b 32 5d 2c 20 78 29 3b 0a 20 20 20 20 20 20 c+2], x);.
a960: 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 26 }. return &
a970: 61 44 61 74 61 5b 70 63 20 2b 20 78 5d 3b 0a 20 aData[pc + x];.
a980: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 }. }.. retu
a990: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 rn 0;.}../*.** A
a9a0: 6c 6c 6f 63 61 74 65 20 6e 42 79 74 65 20 62 79 llocate nByte by
a9b0: 74 65 73 20 6f 66 20 73 70 61 63 65 20 66 72 6f tes of space fro
a9c0: 6d 20 77 69 74 68 69 6e 20 74 68 65 20 42 2d 54 m within the B-T
a9d0: 72 65 65 20 70 61 67 65 20 70 61 73 73 65 64 0a ree page passed.
a9e0: 2a 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 20 ** as the first
a9f0: 61 72 67 75 6d 65 6e 74 2e 20 57 72 69 74 65 20 argument. Write
aa00: 69 6e 74 6f 20 2a 70 49 64 78 20 74 68 65 20 69 into *pIdx the i
aa10: 6e 64 65 78 20 69 6e 74 6f 20 70 50 61 67 65 2d ndex into pPage-
aa20: 3e 61 44 61 74 61 5b 5d 0a 2a 2a 20 6f 66 20 74 >aData[].** of t
aa30: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
aa40: 20 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 allocated space
aa50: 2e 20 52 65 74 75 72 6e 20 65 69 74 68 65 72 20 . Return either
aa60: 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 SQLITE_OK or.**
aa70: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 28 75 an error code (u
aa80: 73 75 61 6c 6c 79 20 53 51 4c 49 54 45 5f 43 4f sually SQLITE_CO
aa90: 52 52 55 50 54 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 RRUPT)..**.** Th
aaa0: 65 20 63 61 6c 6c 65 72 20 67 75 61 72 61 6e 74 e caller guarant
aab0: 65 65 73 20 74 68 61 74 20 74 68 65 72 65 20 69 ees that there i
aac0: 73 20 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 s sufficient spa
aad0: 63 65 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a ce to make the.*
aae0: 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 54 * allocation. T
aaf0: 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 his routine migh
ab00: 74 20 6e 65 65 64 20 74 6f 20 64 65 66 72 61 67 t need to defrag
ab10: 6d 65 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f ment in order to
ab20: 20 62 72 69 6e 67 0a 2a 2a 20 61 6c 6c 20 74 68 bring.** all th
ab30: 65 20 73 70 61 63 65 20 74 6f 67 65 74 68 65 72 e space together
ab40: 2c 20 68 6f 77 65 76 65 72 2e 20 20 54 68 69 73 , however. This
ab50: 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 76 routine will av
ab60: 6f 69 64 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 oid using.** the
ab70: 20 66 69 72 73 74 20 74 77 6f 20 62 79 74 65 73 first two bytes
ab80: 20 70 61 73 74 20 74 68 65 20 63 65 6c 6c 20 70 past the cell p
ab90: 6f 69 6e 74 65 72 20 61 72 65 61 20 73 69 6e 63 ointer area sinc
aba0: 65 20 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69 e presumably thi
abb0: 73 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 s.** allocation
abc0: 69 73 20 62 65 69 6e 67 20 6d 61 64 65 20 69 6e is being made in
abd0: 20 6f 72 64 65 72 20 74 6f 20 69 6e 73 65 72 74 order to insert
abe0: 20 61 20 6e 65 77 20 63 65 6c 6c 2c 20 73 6f 20 a new cell, so
abf0: 77 65 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 we will.** also
ac00: 65 6e 64 20 75 70 20 6e 65 65 64 69 6e 67 20 61 end up needing a
ac10: 20 6e 65 77 20 63 65 6c 6c 20 70 6f 69 6e 74 65 new cell pointe
ac20: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 r..*/.static int
ac30: 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 4d allocateSpace(M
ac40: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 emPage *pPage, i
ac50: 6e 74 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 nt nByte, int *p
ac60: 49 64 78 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e Idx){. const in
ac70: 74 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 t hdr = pPage->h
ac80: 64 72 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 drOffset; /*
ac90: 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 Local cache of p
aca0: 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 Page->hdrOffset
acb0: 2a 2f 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 */. u8 * const
acc0: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
acd0: 61 74 61 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 63 ata; /* Loc
ace0: 61 6c 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 al cache of pPag
acf0: 65 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 69 6e e->aData */. in
ad00: 74 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 t top;
ad10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ad20: 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 /* First byte
ad30: 20 6f 66 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 of cell content
ad40: 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 72 area */. int r
ad50: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
ad60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ad70: 2f 2a 20 49 6e 74 65 67 65 72 20 72 65 74 75 72 /* Integer retur
ad80: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 n code */. int
ad90: 67 61 70 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 gap; /* F
ada0: 69 72 73 74 20 62 79 74 65 20 6f 66 20 67 61 70 irst byte of gap
adb0: 20 62 65 74 77 65 65 6e 20 63 65 6c 6c 20 70 6f between cell po
adc0: 69 6e 74 65 72 73 20 61 6e 64 20 63 65 6c 6c 20 inters and cell
add0: 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 0a 20 20 content */. .
ade0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
adf0: 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
ae00: 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
ae10: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
ae20: 67 65 2d 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 ge->pBt );. ass
ae30: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
ae40: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
ae50: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
ae60: 61 73 73 65 72 74 28 20 6e 42 79 74 65 3e 3d 30 assert( nByte>=0
ae70: 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 ); /* Minimum
ae80: 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a cell size is 4 *
ae90: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 /. assert( pPag
aea0: 65 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 74 65 20 e->nFree>=nByte
aeb0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
aec0: 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 ge->nOverflow==0
aed0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 42 );. assert( nB
aee0: 79 74 65 20 3c 20 28 69 6e 74 29 28 70 50 61 67 yte < (int)(pPag
aef0: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
af00: 7a 65 2d 38 29 20 29 3b 0a 0a 20 20 61 73 73 65 ze-8) );.. asse
af10: 72 74 28 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f rt( pPage->cellO
af20: 66 66 73 65 74 20 3d 3d 20 68 64 72 20 2b 20 31 ffset == hdr + 1
af30: 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 65 61 2 - 4*pPage->lea
af40: 66 20 29 3b 0a 20 20 67 61 70 20 3d 20 70 50 61 f );. gap = pPa
af50: 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b ge->cellOffset +
af60: 20 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 2*pPage->nCell;
af70: 0a 20 20 61 73 73 65 72 74 28 20 67 61 70 3c 3d . assert( gap<=
af80: 36 35 35 33 36 20 29 3b 0a 20 20 2f 2a 20 45 56 65536 );. /* EV
af90: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 39 33 IDENCE-OF: R-293
afa0: 35 36 2d 30 32 33 39 31 20 49 66 20 74 68 65 20 56-02391 If the
afb0: 64 61 74 61 62 61 73 65 20 75 73 65 73 20 61 20 database uses a
afc0: 36 35 35 33 36 2d 62 79 74 65 20 70 61 67 65 20 65536-byte page
afd0: 73 69 7a 65 0a 20 20 2a 2a 20 61 6e 64 20 74 68 size. ** and th
afe0: 65 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 e reserved space
aff0: 20 69 73 20 7a 65 72 6f 20 28 74 68 65 20 75 73 is zero (the us
b000: 75 61 6c 20 76 61 6c 75 65 20 66 6f 72 20 72 65 ual value for re
b010: 73 65 72 76 65 64 20 73 70 61 63 65 29 0a 20 20 served space).
b020: 2a 2a 20 74 68 65 6e 20 74 68 65 20 63 65 6c 6c ** then the cell
b030: 20 63 6f 6e 74 65 6e 74 20 6f 66 66 73 65 74 20 content offset
b040: 6f 66 20 61 6e 20 65 6d 70 74 79 20 70 61 67 65 of an empty page
b050: 20 77 61 6e 74 73 20 74 6f 20 62 65 20 36 35 35 wants to be 655
b060: 33 36 2e 0a 20 20 2a 2a 20 48 6f 77 65 76 65 72 36.. ** However
b070: 2c 20 74 68 61 74 20 69 6e 74 65 67 65 72 20 69 , that integer i
b080: 73 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f 20 62 s too large to b
b090: 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 32 2d e stored in a 2-
b0a0: 62 79 74 65 20 75 6e 73 69 67 6e 65 64 0a 20 20 byte unsigned.
b0b0: 2a 2a 20 69 6e 74 65 67 65 72 2c 20 73 6f 20 61 ** integer, so a
b0c0: 20 76 61 6c 75 65 20 6f 66 20 30 20 69 73 20 75 value of 0 is u
b0d0: 73 65 64 20 69 6e 20 69 74 73 20 70 6c 61 63 65 sed in its place
b0e0: 2e 20 2a 2f 0a 20 20 74 6f 70 20 3d 20 67 65 74 . */. top = get
b0f0: 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 2byteNotZero(&da
b100: 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 66 ta[hdr+5]);. if
b110: 28 20 67 61 70 3e 74 6f 70 20 29 20 72 65 74 75 ( gap>top ) retu
b120: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
b130: 54 5f 42 4b 50 54 3b 0a 0a 20 20 2f 2a 20 49 66 T_BKPT;.. /* If
b140: 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 68 there is enough
b150: 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 67 space between g
b160: 61 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 6f ap and top for o
b170: 6e 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f 69 ne more cell poi
b180: 6e 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 20 nter. ** array
b190: 65 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 6e entry offset, an
b1a0: 64 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 73 d if the freelis
b1b0: 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c 20 t is not empty,
b1c0: 74 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 0a then search the.
b1d0: 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c 6f ** freelist lo
b1e0: 6f 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 65 oking for a free
b1f0: 20 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 68 slot big enough
b200: 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 20 to satisfy the
b210: 72 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 20 request.. */.
b220: 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 3d testcase( gap+2=
b230: 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 61 =top );. testca
b240: 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 29 se( gap+1==top )
b250: 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 ;. testcase( ga
b260: 70 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 p==top );. if(
b270: 67 61 70 2b 32 3c 3d 74 6f 70 20 26 26 20 28 64 gap+2<=top && (d
b280: 61 74 61 5b 68 64 72 2b 31 5d 20 7c 7c 20 64 61 ata[hdr+1] || da
b290: 74 61 5b 68 64 72 2b 32 5d 29 20 29 7b 0a 20 20 ta[hdr+2]) ){.
b2a0: 20 20 69 6e 74 20 62 44 65 66 72 61 67 20 3d 20 int bDefrag =
b2b0: 30 3b 0a 20 20 20 20 75 38 20 2a 70 53 70 61 63 0;. u8 *pSpac
b2c0: 65 20 3d 20 70 61 67 65 46 69 6e 64 53 6c 6f 74 e = pageFindSlot
b2d0: 28 70 50 61 67 65 2c 20 6e 42 79 74 65 2c 20 26 (pPage, nByte, &
b2e0: 72 63 2c 20 26 62 44 65 66 72 61 67 29 3b 0a 20 rc, &bDefrag);.
b2f0: 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
b300: 72 6e 20 72 63 3b 0a 20 20 20 20 69 66 28 20 62 rn rc;. if( b
b310: 44 65 66 72 61 67 20 29 20 67 6f 74 6f 20 64 65 Defrag ) goto de
b320: 66 72 61 67 6d 65 6e 74 5f 70 61 67 65 3b 0a 20 fragment_page;.
b330: 20 20 20 69 66 28 20 70 53 70 61 63 65 20 29 7b if( pSpace ){
b340: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
b350: 53 70 61 63 65 3e 3d 64 61 74 61 20 26 26 20 28 Space>=data && (
b360: 70 53 70 61 63 65 20 2d 20 64 61 74 61 29 3c 36 pSpace - data)<6
b370: 35 35 33 36 20 29 3b 0a 20 20 20 20 20 20 2a 70 5536 );. *p
b380: 49 64 78 20 3d 20 28 69 6e 74 29 28 70 53 70 61 Idx = (int)(pSpa
b390: 63 65 20 2d 20 64 61 74 61 29 3b 0a 20 20 20 20 ce - data);.
b3a0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
b3b0: 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 OK;. }. }..
b3c0: 20 2f 2a 20 54 68 65 20 72 65 71 75 65 73 74 20 /* The request
b3d0: 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 66 75 6c could not be ful
b3e0: 66 69 6c 6c 65 64 20 75 73 69 6e 67 20 61 20 66 filled using a f
b3f0: 72 65 65 6c 69 73 74 20 73 6c 6f 74 2e 20 20 43 reelist slot. C
b400: 68 65 63 6b 0a 20 20 2a 2a 20 74 6f 20 73 65 65 heck. ** to see
b410: 20 69 66 20 64 65 66 72 61 67 6d 65 6e 74 61 74 if defragmentat
b420: 69 6f 6e 20 69 73 20 6e 65 63 65 73 73 61 72 79 ion is necessary
b430: 2e 0a 20 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 .. */. testcas
b440: 65 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3d 3d e( gap+2+nByte==
b450: 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 67 61 70 top );. if( gap
b460: 2b 32 2b 6e 42 79 74 65 3e 74 6f 70 20 29 7b 0a +2+nByte>top ){.
b470: 20 64 65 66 72 61 67 6d 65 6e 74 5f 70 61 67 65 defragment_page
b480: 3a 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 :. assert( pP
b490: 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 7c 7c 20 age->nCell>0 ||
b4a0: 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 CORRUPT_DB );.
b4b0: 20 20 72 63 20 3d 20 64 65 66 72 61 67 6d 65 6e rc = defragmen
b4c0: 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 tPage(pPage);.
b4d0: 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
b4e0: 6e 20 72 63 3b 0a 20 20 20 20 74 6f 70 20 3d 20 n rc;. top =
b4f0: 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 get2byteNotZero(
b500: 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 &data[hdr+5]);.
b510: 20 20 20 61 73 73 65 72 74 28 20 67 61 70 2b 6e assert( gap+n
b520: 42 79 74 65 3c 3d 74 6f 70 20 29 3b 0a 20 20 7d Byte<=top );. }
b530: 0a 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 ... /* Allocate
b540: 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65 memory from the
b550: 20 67 61 70 20 69 6e 20 62 65 74 77 65 65 6e 20 gap in between
b560: 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 the cell pointer
b570: 20 61 72 72 61 79 0a 20 20 2a 2a 20 61 6e 64 20 array. ** and
b580: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
b590: 20 61 72 65 61 2e 20 20 54 68 65 20 62 74 72 65 area. The btre
b5a0: 65 49 6e 69 74 50 61 67 65 28 29 20 63 61 6c 6c eInitPage() call
b5b0: 20 68 61 73 20 61 6c 72 65 61 64 79 0a 20 20 2a has already. *
b5c0: 2a 20 76 61 6c 69 64 61 74 65 64 20 74 68 65 20 * validated the
b5d0: 66 72 65 65 6c 69 73 74 2e 20 20 47 69 76 65 6e freelist. Given
b5e0: 20 74 68 61 74 20 74 68 65 20 66 72 65 65 6c 69 that the freeli
b5f0: 73 74 20 69 73 20 76 61 6c 69 64 2c 20 74 68 65 st is valid, the
b600: 72 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 77 61 re. ** is no wa
b610: 79 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 y that the alloc
b620: 61 74 69 6f 6e 20 63 61 6e 20 65 78 74 65 6e 64 ation can extend
b630: 20 6f 66 66 20 74 68 65 20 65 6e 64 20 6f 66 20 off the end of
b640: 74 68 65 20 70 61 67 65 2e 0a 20 20 2a 2a 20 54 the page.. ** T
b650: 68 65 20 61 73 73 65 72 74 28 29 20 62 65 6c 6f he assert() belo
b660: 77 20 76 65 72 69 66 69 65 73 20 74 68 65 20 70 w verifies the p
b670: 72 65 76 69 6f 75 73 20 73 65 6e 74 65 6e 63 65 revious sentence
b680: 2e 0a 20 20 2a 2f 0a 20 20 74 6f 70 20 2d 3d 20 .. */. top -=
b690: 6e 42 79 74 65 3b 0a 20 20 70 75 74 32 62 79 74 nByte;. put2byt
b6a0: 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 e(&data[hdr+5],
b6b0: 74 6f 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 top);. assert(
b6c0: 74 6f 70 2b 6e 42 79 74 65 20 3c 3d 20 28 69 6e top+nByte <= (in
b6d0: 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 t)pPage->pBt->us
b6e0: 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 2a 70 ableSize );. *p
b6f0: 49 64 78 20 3d 20 74 6f 70 3b 0a 20 20 72 65 74 Idx = top;. ret
b700: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
b710: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 ../*.** Return a
b720: 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 section of the
b730: 70 50 61 67 65 2d 3e 61 44 61 74 61 20 74 6f 20 pPage->aData to
b740: 74 68 65 20 66 72 65 65 6c 69 73 74 2e 0a 2a 2a the freelist..**
b750: 20 54 68 65 20 66 69 72 73 74 20 62 79 74 65 20 The first byte
b760: 6f 66 20 74 68 65 20 6e 65 77 20 66 72 65 65 20 of the new free
b770: 62 6c 6f 63 6b 20 69 73 20 70 50 61 67 65 2d 3e block is pPage->
b780: 61 44 61 74 61 5b 69 53 74 61 72 74 5d 0a 2a 2a aData[iStart].**
b790: 20 61 6e 64 20 74 68 65 20 73 69 7a 65 20 6f 66 and the size of
b7a0: 20 74 68 65 20 62 6c 6f 63 6b 20 69 73 20 69 53 the block is iS
b7b0: 69 7a 65 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a ize bytes..**.**
b7c0: 20 41 64 6a 61 63 65 6e 74 20 66 72 65 65 62 6c Adjacent freebl
b7d0: 6f 63 6b 73 20 61 72 65 20 63 6f 61 6c 65 73 63 ocks are coalesc
b7e0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 ed..**.** Note t
b7f0: 68 61 74 20 65 76 65 6e 20 74 68 6f 75 67 68 20 hat even though
b800: 74 68 65 20 66 72 65 65 62 6c 6f 63 6b 20 6c 69 the freeblock li
b810: 73 74 20 77 61 73 20 63 68 65 63 6b 65 64 20 62 st was checked b
b820: 79 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 y btreeInitPage(
b830: 29 2c 0a 2a 2a 20 74 68 61 74 20 72 6f 75 74 69 ),.** that routi
b840: 6e 65 20 77 69 6c 6c 20 6e 6f 74 20 64 65 74 65 ne will not dete
b850: 63 74 20 6f 76 65 72 6c 61 70 20 62 65 74 77 65 ct overlap betwe
b860: 65 6e 20 63 65 6c 6c 73 20 6f 72 20 66 72 65 65 en cells or free
b870: 62 6c 6f 63 6b 73 2e 20 20 4e 6f 72 0a 2a 2a 20 blocks. Nor.**
b880: 64 6f 65 73 20 69 74 20 64 65 74 65 63 74 20 63 does it detect c
b890: 65 6c 6c 73 20 6f 72 20 66 72 65 65 62 6c 6f 63 ells or freebloc
b8a0: 6b 73 20 74 68 61 74 20 65 6e 63 72 6f 75 63 68 ks that encrouch
b8b0: 20 69 6e 74 6f 20 74 68 65 20 72 65 73 65 72 76 into the reserv
b8c0: 65 64 20 62 79 74 65 73 0a 2a 2a 20 61 74 20 74 ed bytes.** at t
b8d0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 he end of the pa
b8e0: 67 65 2e 20 20 53 6f 20 64 6f 20 61 64 64 69 74 ge. So do addit
b8f0: 69 6f 6e 61 6c 20 63 6f 72 72 75 70 74 69 6f 6e ional corruption
b900: 20 63 68 65 63 6b 73 20 69 6e 73 69 64 65 20 74 checks inside t
b910: 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 61 his.** routine a
b920: 6e 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 nd return SQLITE
b930: 5f 43 4f 52 52 55 50 54 20 69 66 20 61 6e 79 20 _CORRUPT if any
b940: 70 72 6f 62 6c 65 6d 73 20 61 72 65 20 66 6f 75 problems are fou
b950: 6e 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nd..*/.static in
b960: 74 20 66 72 65 65 53 70 61 63 65 28 4d 65 6d 50 t freeSpace(MemP
b970: 61 67 65 20 2a 70 50 61 67 65 2c 20 75 31 36 20 age *pPage, u16
b980: 69 53 74 61 72 74 2c 20 75 31 36 20 69 53 69 7a iStart, u16 iSiz
b990: 65 29 7b 0a 20 20 75 31 36 20 69 50 74 72 3b 20 e){. u16 iPtr;
b9a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b9b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
b9c0: 64 64 72 65 73 73 20 6f 66 20 70 74 72 20 74 6f ddress of ptr to
b9d0: 20 6e 65 78 74 20 66 72 65 65 62 6c 6f 63 6b 20 next freeblock
b9e0: 2a 2f 0a 20 20 75 31 36 20 69 46 72 65 65 42 6c */. u16 iFreeBl
b9f0: 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k;
ba00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 /* Ad
ba10: 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78 dress of the nex
ba20: 74 20 66 72 65 65 62 6c 6f 63 6b 20 2a 2f 0a 20 t freeblock */.
ba30: 20 75 38 20 68 64 72 3b 20 20 20 20 20 20 20 20 u8 hdr;
ba40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ba50: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 68 /* Page h
ba60: 65 61 64 65 72 20 73 69 7a 65 2e 20 20 30 20 6f eader size. 0 o
ba70: 72 20 31 30 30 20 2a 2f 0a 20 20 75 38 20 6e 46 r 100 */. u8 nF
ba80: 72 61 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 rag = 0;
ba90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
baa0: 20 2f 2a 20 52 65 64 75 63 74 69 6f 6e 20 69 6e /* Reduction in
bab0: 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 2a fragmentation *
bac0: 2f 0a 20 20 75 31 36 20 69 4f 72 69 67 53 69 7a /. u16 iOrigSiz
bad0: 65 20 3d 20 69 53 69 7a 65 3b 20 20 20 20 20 20 e = iSize;
bae0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 /* Ori
baf0: 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 69 ginal value of i
bb00: 53 69 7a 65 20 2a 2f 0a 20 20 75 33 32 20 69 4c Size */. u32 iL
bb10: 61 73 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 ast = pPage->pBt
bb20: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 3b 20 ->usableSize-4;
bb30: 2f 2a 20 4c 61 72 67 65 73 74 20 70 6f 73 73 69 /* Largest possi
bb40: 62 6c 65 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 ble freeblock of
bb50: 66 73 65 74 20 2a 2f 0a 20 20 75 33 32 20 69 45 fset */. u32 iE
bb60: 6e 64 20 3d 20 69 53 74 61 72 74 20 2b 20 69 53 nd = iStart + iS
bb70: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ize;
bb80: 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 61 /* First byte pa
bb90: 73 74 20 74 68 65 20 69 53 74 61 72 74 20 62 75 st the iStart bu
bba0: 66 66 65 72 20 2a 2f 0a 20 20 75 6e 73 69 67 6e ffer */. unsign
bbb0: 65 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d 20 ed char *data =
bbc0: 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 20 20 pPage->aData;
bbd0: 2f 2a 20 50 61 67 65 20 63 6f 6e 74 65 6e 74 20 /* Page content
bbe0: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
bbf0: 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 age->pBt!=0 );.
bc00: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
bc10: 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
bc20: 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
bc30: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 );. assert( iS
bc40: 74 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 72 tart>=pPage->hdr
bc50: 4f 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d 3e Offset+6+pPage->
bc60: 63 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b 0a childPtrSize );.
bc70: 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 assert( CORRUP
bc80: 54 5f 44 42 20 7c 7c 20 69 45 6e 64 20 3c 3d 20 T_DB || iEnd <=
bc90: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
bca0: 6c 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 leSize );. asse
bcb0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
bcc0: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
bcd0: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
bce0: 73 73 65 72 74 28 20 69 53 69 7a 65 3e 3d 34 20 ssert( iSize>=4
bcf0: 29 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 ); /* Minimum
bd00: 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a cell size is 4 *
bd10: 2f 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 /. assert( iSta
bd20: 72 74 3c 3d 69 4c 61 73 74 20 29 3b 0a 0a 20 20 rt<=iLast );..
bd30: 2f 2a 20 4f 76 65 72 77 72 69 74 65 20 64 65 6c /* Overwrite del
bd40: 65 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e eted information
bd50: 20 77 69 74 68 20 7a 65 72 6f 73 20 77 68 65 6e with zeros when
bd60: 20 74 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 the secure_dele
bd70: 74 65 0a 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 te. ** option i
bd80: 73 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 69 s enabled */. i
bd90: 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 62 f( pPage->pBt->b
bda0: 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 tsFlags & BTS_SE
bdb0: 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 CURE_DELETE ){.
bdc0: 20 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b memset(&data[
bdd0: 69 53 74 61 72 74 5d 2c 20 30 2c 20 69 53 69 7a iStart], 0, iSiz
bde0: 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 e);. }.. /* Th
bdf0: 65 20 6c 69 73 74 20 6f 66 20 66 72 65 65 62 6c e list of freebl
be00: 6f 63 6b 73 20 6d 75 73 74 20 62 65 20 69 6e 20 ocks must be in
be10: 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e ascending order.
be20: 20 20 46 69 6e 64 20 74 68 65 20 0a 20 20 2a 2a Find the . **
be30: 20 73 70 6f 74 20 6f 6e 20 74 68 65 20 6c 69 73 spot on the lis
be40: 74 20 77 68 65 72 65 20 69 53 74 61 72 74 20 73 t where iStart s
be50: 68 6f 75 6c 64 20 62 65 20 69 6e 73 65 72 74 65 hould be inserte
be60: 64 2e 0a 20 20 2a 2f 0a 20 20 68 64 72 20 3d 20 d.. */. hdr =
be70: 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
be80: 3b 0a 20 20 69 50 74 72 20 3d 20 68 64 72 20 2b ;. iPtr = hdr +
be90: 20 31 3b 0a 20 20 69 66 28 20 64 61 74 61 5b 69 1;. if( data[i
bea0: 50 74 72 2b 31 5d 3d 3d 30 20 26 26 20 64 61 74 Ptr+1]==0 && dat
beb0: 61 5b 69 50 74 72 5d 3d 3d 30 20 29 7b 0a 20 20 a[iPtr]==0 ){.
bec0: 20 20 69 46 72 65 65 42 6c 6b 20 3d 20 30 3b 20 iFreeBlk = 0;
bed0: 20 2f 2a 20 53 68 6f 72 74 63 75 74 20 66 6f 72 /* Shortcut for
bee0: 20 74 68 65 20 63 61 73 65 20 77 68 65 6e 20 74 the case when t
bef0: 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 65 he freelist is e
bf00: 6d 70 74 79 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b mpty */. }else{
bf10: 0a 20 20 20 20 77 68 69 6c 65 28 20 28 69 46 72 . while( (iFr
bf20: 65 65 42 6c 6b 20 3d 20 67 65 74 32 62 79 74 65 eeBlk = get2byte
bf30: 28 26 64 61 74 61 5b 69 50 74 72 5d 29 29 3e 30 (&data[iPtr]))>0
bf40: 20 26 26 20 69 46 72 65 65 42 6c 6b 3c 69 53 74 && iFreeBlk<iSt
bf50: 61 72 74 20 29 7b 0a 20 20 20 20 20 20 69 66 28 art ){. if(
bf60: 20 69 46 72 65 65 42 6c 6b 3c 69 50 74 72 2b 34 iFreeBlk<iPtr+4
bf70: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
bf80: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
bf90: 20 20 20 20 20 69 50 74 72 20 3d 20 69 46 72 65 iPtr = iFre
bfa0: 65 42 6c 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 eBlk;. }.
bfb0: 69 66 28 20 69 46 72 65 65 42 6c 6b 3e 69 4c 61 if( iFreeBlk>iLa
bfc0: 73 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 st ) return SQLI
bfd0: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
bfe0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 46 72 . assert( iFr
bff0: 65 65 42 6c 6b 3e 69 50 74 72 20 7c 7c 20 69 46 eeBlk>iPtr || iF
c000: 72 65 65 42 6c 6b 3d 3d 30 20 29 3b 0a 20 20 0a reeBlk==0 );. .
c010: 20 20 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 /* At this p
c020: 6f 69 6e 74 3a 0a 20 20 20 20 2a 2a 20 20 20 20 oint:. **
c030: 69 46 72 65 65 42 6c 6b 3a 20 20 20 46 69 72 73 iFreeBlk: Firs
c040: 74 20 66 72 65 65 62 6c 6f 63 6b 20 61 66 74 65 t freeblock afte
c050: 72 20 69 53 74 61 72 74 2c 20 6f 72 20 7a 65 72 r iStart, or zer
c060: 6f 20 69 66 20 6e 6f 6e 65 0a 20 20 20 20 2a 2a o if none. **
c070: 20 20 20 20 69 50 74 72 3a 20 20 20 20 20 20 20 iPtr:
c080: 54 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 61 The address of a
c090: 20 70 6f 69 6e 74 65 72 20 69 46 72 65 65 42 6c pointer iFreeBl
c0a0: 6b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 k. **. **
c0b0: 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 Check to see if
c0c0: 69 46 72 65 65 42 6c 6b 20 73 68 6f 75 6c 64 20 iFreeBlk should
c0d0: 62 65 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 be coalesced ont
c0e0: 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 69 53 74 o the end of iSt
c0f0: 61 72 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 art.. */.
c100: 69 66 28 20 69 46 72 65 65 42 6c 6b 20 26 26 20 if( iFreeBlk &&
c110: 69 45 6e 64 2b 33 3e 3d 69 46 72 65 65 42 6c 6b iEnd+3>=iFreeBlk
c120: 20 29 7b 0a 20 20 20 20 20 20 6e 46 72 61 67 20 ){. nFrag
c130: 3d 20 69 46 72 65 65 42 6c 6b 20 2d 20 69 45 6e = iFreeBlk - iEn
c140: 64 3b 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e d;. if( iEn
c150: 64 3e 69 46 72 65 65 42 6c 6b 20 29 20 72 65 74 d>iFreeBlk ) ret
c160: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
c170: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 69 PT_BKPT;. i
c180: 45 6e 64 20 3d 20 69 46 72 65 65 42 6c 6b 20 2b End = iFreeBlk +
c190: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
c1a0: 69 46 72 65 65 42 6c 6b 2b 32 5d 29 3b 0a 20 20 iFreeBlk+2]);.
c1b0: 20 20 20 20 69 53 69 7a 65 20 3d 20 69 45 6e 64 iSize = iEnd
c1c0: 20 2d 20 69 53 74 61 72 74 3b 0a 20 20 20 20 20 - iStart;.
c1d0: 20 69 46 72 65 65 42 6c 6b 20 3d 20 67 65 74 32 iFreeBlk = get2
c1e0: 62 79 74 65 28 26 64 61 74 61 5b 69 46 72 65 65 byte(&data[iFree
c1f0: 42 6c 6b 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 0a Blk]);. }. .
c200: 20 20 20 20 2f 2a 20 49 66 20 69 50 74 72 20 69 /* If iPtr i
c210: 73 20 61 6e 6f 74 68 65 72 20 66 72 65 65 62 6c s another freebl
c220: 6f 63 6b 20 28 74 68 61 74 20 69 73 2c 20 69 66 ock (that is, if
c230: 20 69 50 74 72 20 69 73 20 6e 6f 74 20 74 68 65 iPtr is not the
c240: 20 66 72 65 65 6c 69 73 74 0a 20 20 20 20 2a 2a freelist. **
c250: 20 70 6f 69 6e 74 65 72 20 69 6e 20 74 68 65 20 pointer in the
c260: 70 61 67 65 20 68 65 61 64 65 72 29 20 74 68 65 page header) the
c270: 6e 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 69 n check to see i
c280: 66 20 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 f iStart should
c290: 62 65 0a 20 20 20 20 2a 2a 20 63 6f 61 6c 65 73 be. ** coales
c2a0: 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 ced onto the end
c2b0: 20 6f 66 20 69 50 74 72 2e 0a 20 20 20 20 2a 2f of iPtr.. */
c2c0: 0a 20 20 20 20 69 66 28 20 69 50 74 72 3e 68 64 . if( iPtr>hd
c2d0: 72 2b 31 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 r+1 ){. int
c2e0: 20 69 50 74 72 45 6e 64 20 3d 20 69 50 74 72 20 iPtrEnd = iPtr
c2f0: 2b 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 + get2byte(&data
c300: 5b 69 50 74 72 2b 32 5d 29 3b 0a 20 20 20 20 20 [iPtr+2]);.
c310: 20 69 66 28 20 69 50 74 72 45 6e 64 2b 33 3e 3d if( iPtrEnd+3>=
c320: 69 53 74 61 72 74 20 29 7b 0a 20 20 20 20 20 20 iStart ){.
c330: 20 20 69 66 28 20 69 50 74 72 45 6e 64 3e 69 53 if( iPtrEnd>iS
c340: 74 61 72 74 20 29 20 72 65 74 75 72 6e 20 53 51 tart ) return SQ
c350: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
c360: 54 3b 0a 20 20 20 20 20 20 20 20 6e 46 72 61 67 T;. nFrag
c370: 20 2b 3d 20 69 53 74 61 72 74 20 2d 20 69 50 74 += iStart - iPt
c380: 72 45 6e 64 3b 0a 20 20 20 20 20 20 20 20 69 53 rEnd;. iS
c390: 69 7a 65 20 3d 20 69 45 6e 64 20 2d 20 69 50 74 ize = iEnd - iPt
c3a0: 72 3b 0a 20 20 20 20 20 20 20 20 69 53 74 61 72 r;. iStar
c3b0: 74 20 3d 20 69 50 74 72 3b 0a 20 20 20 20 20 20 t = iPtr;.
c3c0: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
c3d0: 6e 46 72 61 67 3e 64 61 74 61 5b 68 64 72 2b 37 nFrag>data[hdr+7
c3e0: 5d 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ] ) return SQLIT
c3f0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
c400: 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 data[hdr+7]
c410: 2d 3d 20 6e 46 72 61 67 3b 0a 20 20 7d 0a 20 20 -= nFrag;. }.
c420: 69 66 28 20 69 53 74 61 72 74 3d 3d 67 65 74 32 if( iStart==get2
c430: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
c440: 5d 29 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 ]) ){. /* The
c450: 20 6e 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 new freeblock i
c460: 73 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 s at the beginni
c470: 6e 67 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 ng of the cell c
c480: 6f 6e 74 65 6e 74 20 61 72 65 61 2c 0a 20 20 20 ontent area,.
c490: 20 2a 2a 20 73 6f 20 6a 75 73 74 20 65 78 74 65 ** so just exte
c4a0: 6e 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 nd the cell cont
c4b0: 65 6e 74 20 61 72 65 61 20 72 61 74 68 65 72 20 ent area rather
c4c0: 74 68 61 6e 20 63 72 65 61 74 65 20 61 6e 6f 74 than create anot
c4d0: 68 65 72 0a 20 20 20 20 2a 2a 20 66 72 65 65 6c her. ** freel
c4e0: 69 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 20 ist entry */.
c4f0: 20 69 66 28 20 69 50 74 72 21 3d 68 64 72 2b 31 if( iPtr!=hdr+1
c500: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
c510: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
c520: 20 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 put2byte(&dat
c530: 61 5b 68 64 72 2b 31 5d 2c 20 69 46 72 65 65 42 a[hdr+1], iFreeB
c540: 6c 6b 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 lk);. put2byt
c550: 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 e(&data[hdr+5],
c560: 69 45 6e 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a iEnd);. }else{.
c570: 20 20 20 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 /* Insert th
c580: 65 20 6e 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 e new freeblock
c590: 69 6e 74 6f 20 74 68 65 20 66 72 65 65 6c 69 73 into the freelis
c5a0: 74 20 2a 2f 0a 20 20 20 20 70 75 74 32 62 79 74 t */. put2byt
c5b0: 65 28 26 64 61 74 61 5b 69 50 74 72 5d 2c 20 69 e(&data[iPtr], i
c5c0: 53 74 61 72 74 29 3b 0a 20 20 20 20 70 75 74 32 Start);. put2
c5d0: 62 79 74 65 28 26 64 61 74 61 5b 69 53 74 61 72 byte(&data[iStar
c5e0: 74 5d 2c 20 69 46 72 65 65 42 6c 6b 29 3b 0a 20 t], iFreeBlk);.
c5f0: 20 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 put2byte(&dat
c600: 61 5b 69 53 74 61 72 74 2b 32 5d 2c 20 69 53 69 a[iStart+2], iSi
c610: 7a 65 29 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 ze);. }. pPage
c620: 2d 3e 6e 46 72 65 65 20 2b 3d 20 69 4f 72 69 67 ->nFree += iOrig
c630: 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 Size;. return S
c640: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
c650: 2a 2a 20 44 65 63 6f 64 65 20 74 68 65 20 66 6c ** Decode the fl
c660: 61 67 73 20 62 79 74 65 20 28 74 68 65 20 66 69 ags byte (the fi
c670: 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 rst byte of the
c680: 68 65 61 64 65 72 29 20 66 6f 72 20 61 20 70 61 header) for a pa
c690: 67 65 0a 2a 2a 20 61 6e 64 20 69 6e 69 74 69 61 ge.** and initia
c6a0: 6c 69 7a 65 20 66 69 65 6c 64 73 20 6f 66 20 74 lize fields of t
c6b0: 68 65 20 4d 65 6d 50 61 67 65 20 73 74 72 75 63 he MemPage struc
c6c0: 74 75 72 65 20 61 63 63 6f 72 64 69 6e 67 6c 79 ture accordingly
c6d0: 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 74 68 65 ..**.** Only the
c6e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 62 69 following combi
c6f0: 6e 61 74 69 6f 6e 73 20 61 72 65 20 73 75 70 70 nations are supp
c700: 6f 72 74 65 64 2e 20 20 41 6e 79 74 68 69 6e 67 orted. Anything
c710: 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20 69 6e different.** in
c720: 64 69 63 61 74 65 73 20 61 20 63 6f 72 72 75 70 dicates a corrup
c730: 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 t database files
c740: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 :.**.**
c750: 50 54 46 5f 5a 45 52 4f 44 41 54 41 0a 2a 2a 20 PTF_ZERODATA.**
c760: 20 20 20 20 20 20 20 20 50 54 46 5f 5a 45 52 4f PTF_ZERO
c770: 44 41 54 41 20 7c 20 50 54 46 5f 4c 45 41 46 0a DATA | PTF_LEAF.
c780: 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 5f 4c ** PTF_L
c790: 45 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e EAFDATA | PTF_IN
c7a0: 54 4b 45 59 0a 2a 2a 20 20 20 20 20 20 20 20 20 TKEY.**
c7b0: 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 PTF_LEAFDATA | P
c7c0: 54 46 5f 49 4e 54 4b 45 59 20 7c 20 50 54 46 5f TF_INTKEY | PTF_
c7d0: 4c 45 41 46 0a 2a 2f 0a 73 74 61 74 69 63 20 69 LEAF.*/.static i
c7e0: 6e 74 20 64 65 63 6f 64 65 46 6c 61 67 73 28 4d nt decodeFlags(M
c7f0: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 emPage *pPage, i
c800: 6e 74 20 66 6c 61 67 42 79 74 65 29 7b 0a 20 20 nt flagByte){.
c810: 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b 20 20 BtShared *pBt;
c820: 20 20 20 2f 2a 20 41 20 63 6f 70 79 20 6f 66 20 /* A copy of
c830: 70 50 61 67 65 2d 3e 70 42 74 20 2a 2f 0a 0a 20 pPage->pBt */..
c840: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
c850: 68 64 72 4f 66 66 73 65 74 3d 3d 28 70 50 61 67 hdrOffset==(pPag
c860: 65 2d 3e 70 67 6e 6f 3d 3d 31 20 3f 20 31 30 30 e->pgno==1 ? 100
c870: 20 3a 20 30 29 20 29 3b 0a 20 20 61 73 73 65 72 : 0) );. asser
c880: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
c890: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
c8a0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 50 ->mutex) );. pP
c8b0: 61 67 65 2d 3e 6c 65 61 66 20 3d 20 28 75 38 29 age->leaf = (u8)
c8c0: 28 66 6c 61 67 42 79 74 65 3e 3e 33 29 3b 20 20 (flagByte>>3);
c8d0: 61 73 73 65 72 74 28 20 50 54 46 5f 4c 45 41 46 assert( PTF_LEAF
c8e0: 20 3d 3d 20 31 3c 3c 33 20 29 3b 0a 20 20 66 6c == 1<<3 );. fl
c8f0: 61 67 42 79 74 65 20 26 3d 20 7e 50 54 46 5f 4c agByte &= ~PTF_L
c900: 45 41 46 3b 0a 20 20 70 50 61 67 65 2d 3e 63 68 EAF;. pPage->ch
c910: 69 6c 64 50 74 72 53 69 7a 65 20 3d 20 34 2d 34 ildPtrSize = 4-4
c920: 2a 70 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 *pPage->leaf;.
c930: 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 pBt = pPage->pBt
c940: 3b 0a 20 20 69 66 28 20 66 6c 61 67 42 79 74 65 ;. if( flagByte
c950: 3d 3d 28 50 54 46 5f 4c 45 41 46 44 41 54 41 20 ==(PTF_LEAFDATA
c960: 7c 20 50 54 46 5f 49 4e 54 4b 45 59 29 20 29 7b | PTF_INTKEY) ){
c970: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
c980: 2d 4f 46 3a 20 52 2d 30 33 36 34 30 2d 31 33 34 -OF: R-03640-134
c990: 31 35 20 41 20 76 61 6c 75 65 20 6f 66 20 35 20 15 A value of 5
c9a0: 6d 65 61 6e 73 20 74 68 65 20 70 61 67 65 20 69 means the page i
c9b0: 73 20 61 6e 20 69 6e 74 65 72 69 6f 72 0a 20 20 s an interior.
c9c0: 20 20 2a 2a 20 74 61 62 6c 65 20 62 2d 74 72 65 ** table b-tre
c9d0: 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 e page. */. a
c9e0: 73 73 65 72 74 28 20 28 50 54 46 5f 4c 45 41 46 ssert( (PTF_LEAF
c9f0: 44 41 54 41 7c 50 54 46 5f 49 4e 54 4b 45 59 29 DATA|PTF_INTKEY)
ca00: 3d 3d 35 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 ==5 );. /* EV
ca10: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 30 35 IDENCE-OF: R-205
ca20: 30 31 2d 36 31 37 39 36 20 41 20 76 61 6c 75 65 01-61796 A value
ca30: 20 6f 66 20 31 33 20 6d 65 61 6e 73 20 74 68 65 of 13 means the
ca40: 20 70 61 67 65 20 69 73 20 61 20 6c 65 61 66 0a page is a leaf.
ca50: 20 20 20 20 2a 2a 20 74 61 62 6c 65 20 62 2d 74 ** table b-t
ca60: 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 ree page. */.
ca70: 20 61 73 73 65 72 74 28 20 28 50 54 46 5f 4c 45 assert( (PTF_LE
ca80: 41 46 44 41 54 41 7c 50 54 46 5f 49 4e 54 4b 45 AFDATA|PTF_INTKE
ca90: 59 7c 50 54 46 5f 4c 45 41 46 29 3d 3d 31 33 20 Y|PTF_LEAF)==13
caa0: 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e );. pPage->in
cab0: 74 4b 65 79 20 3d 20 31 3b 0a 20 20 20 20 70 50 tKey = 1;. pP
cac0: 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 age->intKeyLeaf
cad0: 3d 20 70 50 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 = pPage->leaf;.
cae0: 20 20 20 70 50 61 67 65 2d 3e 6e 6f 50 61 79 6c pPage->noPayl
caf0: 6f 61 64 20 3d 20 21 70 50 61 67 65 2d 3e 6c 65 oad = !pPage->le
cb00: 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d af;. pPage->m
cb10: 61 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d axLocal = pBt->m
cb20: 61 78 4c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 axLeaf;. pPag
cb30: 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 e->minLocal = pB
cb40: 74 2d 3e 6d 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 t->minLeaf;. }e
cb50: 6c 73 65 20 69 66 28 20 66 6c 61 67 42 79 74 65 lse if( flagByte
cb60: 3d 3d 50 54 46 5f 5a 45 52 4f 44 41 54 41 20 29 ==PTF_ZERODATA )
cb70: 7b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 {. /* EVIDENC
cb80: 45 2d 4f 46 3a 20 52 2d 32 37 32 32 35 2d 35 33 E-OF: R-27225-53
cb90: 39 33 36 20 41 20 76 61 6c 75 65 20 6f 66 20 32 936 A value of 2
cba0: 20 6d 65 61 6e 73 20 74 68 65 20 70 61 67 65 20 means the page
cbb0: 69 73 20 61 6e 20 69 6e 74 65 72 69 6f 72 0a 20 is an interior.
cbc0: 20 20 20 2a 2a 20 69 6e 64 65 78 20 62 2d 74 72 ** index b-tr
cbd0: 65 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 ee page. */.
cbe0: 61 73 73 65 72 74 28 20 28 50 54 46 5f 5a 45 52 assert( (PTF_ZER
cbf0: 4f 44 41 54 41 29 3d 3d 32 20 29 3b 0a 20 20 20 ODATA)==2 );.
cc00: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
cc10: 20 52 2d 31 36 35 37 31 2d 31 31 36 31 35 20 41 R-16571-11615 A
cc20: 20 76 61 6c 75 65 20 6f 66 20 31 30 20 6d 65 61 value of 10 mea
cc30: 6e 73 20 74 68 65 20 70 61 67 65 20 69 73 20 61 ns the page is a
cc40: 20 6c 65 61 66 0a 20 20 20 20 2a 2a 20 69 6e 64 leaf. ** ind
cc50: 65 78 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 ex b-tree page.
cc60: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 */. assert( (
cc70: 50 54 46 5f 5a 45 52 4f 44 41 54 41 7c 50 54 46 PTF_ZERODATA|PTF
cc80: 5f 4c 45 41 46 29 3d 3d 31 30 20 29 3b 0a 20 20 _LEAF)==10 );.
cc90: 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 pPage->intKey
cca0: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e = 0;. pPage->
ccb0: 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 30 3b 0a intKeyLeaf = 0;.
ccc0: 20 20 20 20 70 50 61 67 65 2d 3e 6e 6f 50 61 79 pPage->noPay
ccd0: 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 20 20 70 50 load = 0;. pP
cce0: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d 20 age->maxLocal =
ccf0: 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 pBt->maxLocal;.
cd00: 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 pPage->minLoc
cd10: 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c 6f 63 al = pBt->minLoc
cd20: 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 al;. }else{.
cd30: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
cd40: 20 52 2d 34 37 36 30 38 2d 35 36 34 36 39 20 41 R-47608-56469 A
cd50: 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 65 20 66 ny other value f
cd60: 6f 72 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 or the b-tree pa
cd70: 67 65 20 74 79 70 65 20 69 73 0a 20 20 20 20 2a ge type is. *
cd80: 2a 20 61 6e 20 65 72 72 6f 72 2e 20 2a 2f 0a 20 * an error. */.
cd90: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
cda0: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
cdb0: 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6d 61 78 31 }. pPage->max1
cdc0: 62 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 70 42 bytePayload = pB
cdd0: 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f t->max1bytePaylo
cde0: 61 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ad;. return SQL
cdf0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
ce00: 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 Initialize the
ce10: 61 75 78 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d auxiliary inform
ce20: 61 74 69 6f 6e 20 66 6f 72 20 61 20 64 69 73 6b ation for a disk
ce30: 20 62 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 52 65 block..**.** Re
ce40: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f turn SQLITE_OK o
ce50: 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 77 n success. If w
ce60: 65 20 73 65 65 20 74 68 61 74 20 74 68 65 20 70 e see that the p
ce70: 61 67 65 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 age does.** not
ce80: 63 6f 6e 74 61 69 6e 20 61 20 77 65 6c 6c 2d 66 contain a well-f
ce90: 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 ormed database p
cea0: 61 67 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e age, then return
ceb0: 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 .** SQLITE_CORR
cec0: 55 50 54 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 UPT. Note that
ced0: 61 20 72 65 74 75 72 6e 20 6f 66 20 53 51 4c 49 a return of SQLI
cee0: 54 45 5f 4f 4b 20 64 6f 65 73 20 6e 6f 74 0a 2a TE_OK does not.*
cef0: 2a 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 * guarantee that
cf00: 20 74 68 65 20 70 61 67 65 20 69 73 20 77 65 6c the page is wel
cf10: 6c 2d 66 6f 72 6d 65 64 2e 20 20 49 74 20 6f 6e l-formed. It on
cf20: 6c 79 20 73 68 6f 77 73 20 74 68 61 74 0a 2a 2a ly shows that.**
cf30: 20 77 65 20 66 61 69 6c 65 64 20 74 6f 20 64 65 we failed to de
cf40: 74 65 63 74 20 61 6e 79 20 63 6f 72 72 75 70 74 tect any corrupt
cf50: 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ion..*/.static i
cf60: 6e 74 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 nt btreeInitPage
cf70: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
cf80: 7b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 {.. assert( pPa
cf90: 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 ge->pBt!=0 );.
cfa0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
cfb0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
cfc0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
cfd0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
cfe0: 2d 3e 70 67 6e 6f 3d 3d 73 71 6c 69 74 65 33 50 ->pgno==sqlite3P
cff0: 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 agerPagenumber(p
d000: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
d010: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
d020: 65 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 65 e == sqlite3Page
d030: 72 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d rGetExtra(pPage-
d040: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
d050: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
d060: 61 74 61 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 ata == sqlite3Pa
d070: 67 65 72 47 65 74 44 61 74 61 28 70 50 61 67 65 gerGetData(pPage
d080: 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 ->pDbPage) );..
d090: 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73 49 if( !pPage->isI
d0a0: 6e 69 74 20 29 7b 0a 20 20 20 20 75 31 36 20 70 nit ){. u16 p
d0b0: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a c; /*
d0c0: 20 41 64 64 72 65 73 73 20 6f 66 20 61 20 66 72 Address of a fr
d0d0: 65 65 62 6c 6f 63 6b 20 77 69 74 68 69 6e 20 70 eeblock within p
d0e0: 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d 20 2a 2f Page->aData[] */
d0f0: 0a 20 20 20 20 75 38 20 68 64 72 3b 20 20 20 20 . u8 hdr;
d100: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
d110: 74 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 6f t to beginning o
d120: 66 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f f page header */
d130: 0a 20 20 20 20 75 38 20 2a 64 61 74 61 3b 20 20 . u8 *data;
d140: 20 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c /* Equal
d150: 20 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 to pPage->aData
d160: 20 2a 2f 0a 20 20 20 20 42 74 53 68 61 72 65 64 */. BtShared
d170: 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 2f 2a *pBt; /*
d180: 20 54 68 65 20 6d 61 69 6e 20 62 74 72 65 65 20 The main btree
d190: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 structure */.
d1a0: 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b int usableSize;
d1b0: 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 /* Amount of
d1c0: 20 75 73 61 62 6c 65 20 73 70 61 63 65 20 6f 6e usable space on
d1d0: 20 65 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 each page */.
d1e0: 20 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 u16 cellOffset
d1f0: 3b 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 66 ; /* Offset f
d200: 72 6f 6d 20 73 74 61 72 74 20 6f 66 20 70 61 67 rom start of pag
d210: 65 20 74 6f 20 66 69 72 73 74 20 63 65 6c 6c 20 e to first cell
d220: 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 pointer */. i
d230: 6e 74 20 6e 46 72 65 65 3b 20 20 20 20 20 20 20 nt nFree;
d240: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
d250: 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 74 nused bytes on t
d260: 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 69 he page */. i
d270: 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 nt top;
d280: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
d290: 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 of the cell cont
d2a0: 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 20 20 ent area */.
d2b0: 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 int iCellFirst;
d2c0: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f /* First allo
d2d0: 77 61 62 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 wable cell or fr
d2e0: 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a eeblock offset *
d2f0: 2f 0a 20 20 20 20 69 6e 74 20 69 43 65 6c 6c 4c /. int iCellL
d300: 61 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 74 ast; /* Last
d310: 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 6f possible cell o
d320: 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 r freeblock offs
d330: 65 74 20 2a 2f 0a 0a 20 20 20 20 70 42 74 20 3d et */.. pBt =
d340: 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 0a 20 20 pPage->pBt;..
d350: 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 hdr = pPage->h
d360: 64 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 64 61 drOffset;. da
d370: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
d380: 61 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e a;. /* EVIDEN
d390: 43 45 2d 4f 46 3a 20 52 2d 32 38 35 39 34 2d 30 CE-OF: R-28594-0
d3a0: 32 38 39 30 20 54 68 65 20 6f 6e 65 2d 62 79 74 2890 The one-byt
d3b0: 65 20 66 6c 61 67 20 61 74 20 6f 66 66 73 65 74 e flag at offset
d3c0: 20 30 20 69 6e 64 69 63 61 74 69 6e 67 0a 20 20 0 indicating.
d3d0: 20 20 2a 2a 20 74 68 65 20 62 2d 74 72 65 65 20 ** the b-tree
d3e0: 70 61 67 65 20 74 79 70 65 2e 20 2a 2f 0a 20 20 page type. */.
d3f0: 20 20 69 66 28 20 64 65 63 6f 64 65 46 6c 61 67 if( decodeFlag
d400: 73 28 70 50 61 67 65 2c 20 64 61 74 61 5b 68 64 s(pPage, data[hd
d410: 72 5d 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c r]) ) return SQL
d420: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
d430: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 ;. assert( pB
d440: 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 t->pageSize>=512
d450: 20 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a && pBt->pageSiz
d460: 65 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 20 20 e<=65536 );.
d470: 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 pPage->maskPage
d480: 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 70 61 67 = (u16)(pBt->pag
d490: 65 53 69 7a 65 20 2d 20 31 29 3b 0a 20 20 20 20 eSize - 1);.
d4a0: 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
d4b0: 20 3d 20 30 3b 0a 20 20 20 20 75 73 61 62 6c 65 = 0;. usable
d4c0: 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 Size = pBt->usab
d4d0: 6c 65 53 69 7a 65 3b 0a 20 20 20 20 70 50 61 67 leSize;. pPag
d4e0: 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 e->cellOffset =
d4f0: 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 68 64 72 cellOffset = hdr
d500: 20 2b 20 38 20 2b 20 70 50 61 67 65 2d 3e 63 68 + 8 + pPage->ch
d510: 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 20 20 ildPtrSize;.
d520: 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
d530: 3d 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 69 = &data[usableSi
d540: 7a 65 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e ze];. pPage->
d550: 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 aCellIdx = &data
d560: 5b 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 [cellOffset];.
d570: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
d580: 3a 20 52 2d 35 38 30 31 35 2d 34 38 31 37 35 20 : R-58015-48175
d590: 54 68 65 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 The two-byte int
d5a0: 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 35 eger at offset 5
d5b0: 20 64 65 73 69 67 6e 61 74 65 73 0a 20 20 20 20 designates.
d5c0: 2a 2a 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 ** the start of
d5d0: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
d5e0: 20 61 72 65 61 2e 20 41 20 7a 65 72 6f 20 76 61 area. A zero va
d5f0: 6c 75 65 20 66 6f 72 20 74 68 69 73 20 69 6e 74 lue for this int
d600: 65 67 65 72 20 69 73 0a 20 20 20 20 2a 2a 20 69 eger is. ** i
d610: 6e 74 65 72 70 72 65 74 65 64 20 61 73 20 36 35 nterpreted as 65
d620: 35 33 36 2e 20 2a 2f 0a 20 20 20 20 74 6f 70 20 536. */. top
d630: 3d 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 = get2byteNotZer
d640: 6f 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b o(&data[hdr+5]);
d650: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
d660: 2d 4f 46 3a 20 52 2d 33 37 30 30 32 2d 33 32 37 -OF: R-37002-327
d670: 37 34 20 54 68 65 20 74 77 6f 2d 62 79 74 65 20 74 The two-byte
d680: 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 integer at offse
d690: 74 20 33 20 67 69 76 65 73 20 74 68 65 0a 20 20 t 3 gives the.
d6a0: 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 63 ** number of c
d6b0: 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 61 67 65 ells on the page
d6c0: 2e 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 2d 3e . */. pPage->
d6d0: 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 74 65 nCell = get2byte
d6e0: 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 3b 0a (&data[hdr+3]);.
d6f0: 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e if( pPage->n
d700: 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 42 74 Cell>MX_CELL(pBt
d710: 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 6f ) ){. /* To
d720: 20 6d 61 6e 79 20 63 65 6c 6c 73 20 66 6f 72 20 many cells for
d730: 61 20 73 69 6e 67 6c 65 20 70 61 67 65 2e 20 20 a single page.
d740: 54 68 65 20 70 61 67 65 20 6d 75 73 74 20 62 65 The page must be
d750: 20 63 6f 72 72 75 70 74 20 2a 2f 0a 20 20 20 20 corrupt */.
d760: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d770: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
d780: 20 20 7d 0a 20 20 20 20 74 65 73 74 63 61 73 65 }. testcase
d790: 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d ( pPage->nCell==
d7a0: 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 3b 0a MX_CELL(pBt) );.
d7b0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
d7c0: 4f 46 3a 20 52 2d 32 34 30 38 39 2d 35 37 39 37 OF: R-24089-5797
d7d0: 39 20 49 66 20 61 20 70 61 67 65 20 63 6f 6e 74 9 If a page cont
d7e0: 61 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 28 77 ains no cells (w
d7f0: 68 69 63 68 20 69 73 20 6f 6e 6c 79 0a 20 20 20 hich is only.
d800: 20 2a 2a 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 ** possible for
d810: 20 61 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 a root page of
d820: 61 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e a table that con
d830: 74 61 69 6e 73 20 6e 6f 20 72 6f 77 73 29 20 74 tains no rows) t
d840: 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 6f hen the. ** o
d850: 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c ffset to the cel
d860: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 77 l content area w
d870: 69 6c 6c 20 65 71 75 61 6c 20 74 68 65 20 70 61 ill equal the pa
d880: 67 65 20 73 69 7a 65 20 6d 69 6e 75 73 20 74 68 ge size minus th
d890: 65 0a 20 20 20 20 2a 2a 20 62 79 74 65 73 20 6f e. ** bytes o
d8a0: 66 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 f reserved space
d8b0: 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 . */. assert(
d8c0: 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 pPage->nCell>0
d8d0: 7c 7c 20 74 6f 70 3d 3d 75 73 61 62 6c 65 53 69 || top==usableSi
d8e0: 7a 65 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 ze || CORRUPT_DB
d8f0: 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 41 20 6d 61 );.. /* A ma
d900: 6c 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 lformed database
d910: 20 70 61 67 65 20 6d 69 67 68 74 20 63 61 75 73 page might caus
d920: 65 20 75 73 20 74 6f 20 72 65 61 64 20 70 61 73 e us to read pas
d930: 74 20 74 68 65 20 65 6e 64 0a 20 20 20 20 2a 2a t the end. **
d940: 20 6f 66 20 70 61 67 65 20 77 68 65 6e 20 70 61 of page when pa
d950: 72 73 69 6e 67 20 61 20 63 65 6c 6c 2e 20 20 0a rsing a cell. .
d960: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 **. ** Th
d970: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 e following bloc
d980: 6b 20 6f 66 20 63 6f 64 65 20 63 68 65 63 6b 73 k of code checks
d990: 20 65 61 72 6c 79 20 74 6f 20 73 65 65 20 69 66 early to see if
d9a0: 20 61 20 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a a cell extends.
d9b0: 20 20 20 20 2a 2a 20 70 61 73 74 20 74 68 65 20 ** past the
d9c0: 65 6e 64 20 6f 66 20 61 20 70 61 67 65 20 62 6f end of a page bo
d9d0: 75 6e 64 61 72 79 20 61 6e 64 20 63 61 75 73 65 undary and cause
d9e0: 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 s SQLITE_CORRUPT
d9f0: 20 74 6f 20 62 65 20 0a 20 20 20 20 2a 2a 20 72 to be . ** r
da00: 65 74 75 72 6e 65 64 20 69 66 20 69 74 20 64 6f eturned if it do
da10: 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 es.. */. i
da20: 43 65 6c 6c 46 69 72 73 74 20 3d 20 63 65 6c 6c CellFirst = cell
da30: 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 61 67 65 Offset + 2*pPage
da40: 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 43 65 ->nCell;. iCe
da50: 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c 65 53 llLast = usableS
da60: 69 7a 65 20 2d 20 34 3b 0a 23 69 66 20 64 65 66 ize - 4;.#if def
da70: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
da80: 4c 45 5f 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c LE_OVERSIZE_CELL
da90: 5f 43 48 45 43 4b 29 0a 20 20 20 20 7b 0a 20 20 _CHECK). {.
daa0: 20 20 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 int i;
dab0: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 /* Index i
dac0: 6e 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 nto the cell poi
dad0: 6e 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 nter array */.
dae0: 20 20 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 int sz;
daf0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
db00: 20 61 20 63 65 6c 6c 20 2a 2f 0a 0a 20 20 20 20 a cell */..
db10: 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 if( !pPage->le
db20: 61 66 20 29 20 69 43 65 6c 6c 4c 61 73 74 2d 2d af ) iCellLast--
db30: 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b ;. for(i=0;
db40: 20 69 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b i<pPage->nCell;
db50: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 i++){. p
db60: 63 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 c = get2byte(&da
db70: 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 2b 69 2a ta[cellOffset+i*
db80: 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 2]);. tes
db90: 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c tcase( pc==iCell
dba0: 46 69 72 73 74 20 29 3b 0a 20 20 20 20 20 20 20 First );.
dbb0: 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 testcase( pc==i
dbc0: 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 CellLast );.
dbd0: 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c if( pc<iCell
dbe0: 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c First || pc>iCel
dbf0: 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 20 lLast ){.
dc00: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
dc10: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
dc20: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
dc30: 20 73 7a 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 sz = cellSizePt
dc40: 72 28 70 50 61 67 65 2c 20 26 64 61 74 61 5b 70 r(pPage, &data[p
dc50: 63 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 c]);. tes
dc60: 74 63 61 73 65 28 20 70 63 2b 73 7a 3d 3d 75 73 tcase( pc+sz==us
dc70: 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 ableSize );.
dc80: 20 20 20 20 69 66 28 20 70 63 2b 73 7a 3e 75 73 if( pc+sz>us
dc90: 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 ableSize ){.
dca0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
dcb0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
dcc0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
dcd0: 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 }. if( !p
dce0: 50 61 67 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 Page->leaf ) iCe
dcf0: 6c 6c 4c 61 73 74 2b 2b 3b 0a 20 20 20 20 7d 20 llLast++;. }
dd00: 20 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a .#endif.. /*
dd10: 20 43 6f 6d 70 75 74 65 20 74 68 65 20 74 6f 74 Compute the tot
dd20: 61 6c 20 66 72 65 65 20 73 70 61 63 65 20 6f 6e al free space on
dd30: 20 74 68 65 20 70 61 67 65 0a 20 20 20 20 2a 2a the page. **
dd40: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
dd50: 32 33 35 38 38 2d 33 34 34 35 30 20 54 68 65 20 23588-34450 The
dd60: 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 67 65 72 two-byte integer
dd70: 20 61 74 20 6f 66 66 73 65 74 20 31 20 67 69 76 at offset 1 giv
dd80: 65 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 73 74 es the. ** st
dd90: 61 72 74 20 6f 66 20 74 68 65 20 66 69 72 73 74 art of the first
dda0: 20 66 72 65 65 62 6c 6f 63 6b 20 6f 6e 20 74 68 freeblock on th
ddb0: 65 20 70 61 67 65 2c 20 6f 72 20 69 73 20 7a 65 e page, or is ze
ddc0: 72 6f 20 69 66 20 74 68 65 72 65 20 61 72 65 20 ro if there are
ddd0: 6e 6f 0a 20 20 20 20 2a 2a 20 66 72 65 65 62 6c no. ** freebl
dde0: 6f 63 6b 73 2e 20 2a 2f 0a 20 20 20 20 70 63 20 ocks. */. pc
ddf0: 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
de00: 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 20 6e 46 [hdr+1]);. nF
de10: 72 65 65 20 3d 20 64 61 74 61 5b 68 64 72 2b 37 ree = data[hdr+7
de20: 5d 20 2b 20 74 6f 70 3b 20 20 2f 2a 20 49 6e 69 ] + top; /* Ini
de30: 74 20 6e 46 72 65 65 20 74 6f 20 6e 6f 6e 2d 66 t nFree to non-f
de40: 72 65 65 62 6c 6f 63 6b 20 66 72 65 65 20 73 70 reeblock free sp
de50: 61 63 65 20 2a 2f 0a 20 20 20 20 77 68 69 6c 65 ace */. while
de60: 28 20 70 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 ( pc>0 ){.
de70: 75 31 36 20 6e 65 78 74 2c 20 73 69 7a 65 3b 0a u16 next, size;.
de80: 20 20 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 if( pc<iCe
de90: 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 llFirst || pc>iC
dea0: 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 ellLast ){.
deb0: 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
dec0: 46 3a 20 52 2d 35 35 35 33 30 2d 35 32 39 33 30 F: R-55530-52930
ded0: 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 In a well-forme
dee0: 64 20 62 2d 74 72 65 65 20 70 61 67 65 2c 20 74 d b-tree page, t
def0: 68 65 72 65 20 77 69 6c 6c 0a 20 20 20 20 20 20 here will.
df00: 20 20 2a 2a 20 61 6c 77 61 79 73 20 62 65 20 61 ** always be a
df10: 74 20 6c 65 61 73 74 20 6f 6e 65 20 63 65 6c 6c t least one cell
df20: 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 before the firs
df30: 74 20 66 72 65 65 62 6c 6f 63 6b 2e 0a 20 20 20 t freeblock..
df40: 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 **.
df50: 2a 2a 20 4f 72 2c 20 74 68 65 20 66 72 65 65 62 ** Or, the freeb
df60: 6c 6f 63 6b 20 69 73 20 6f 66 66 20 74 68 65 20 lock is off the
df70: 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 0a end of the page.
df80: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
df90: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
dfa0: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a _CORRUPT_BKPT; .
dfb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 65 }. ne
dfc0: 78 74 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 xt = get2byte(&d
dfd0: 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 ata[pc]);.
dfe0: 73 69 7a 65 20 3d 20 67 65 74 32 62 79 74 65 28 size = get2byte(
dff0: 26 64 61 74 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 &data[pc+2]);.
e000: 20 20 20 20 69 66 28 20 28 6e 65 78 74 3e 30 20 if( (next>0
e010: 26 26 20 6e 65 78 74 3c 3d 70 63 2b 73 69 7a 65 && next<=pc+size
e020: 2b 33 29 20 7c 7c 20 70 63 2b 73 69 7a 65 3e 75 +3) || pc+size>u
e030: 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 sableSize ){.
e040: 20 20 20 20 20 2f 2a 20 46 72 65 65 20 62 6c 6f /* Free blo
e050: 63 6b 73 20 6d 75 73 74 20 62 65 20 69 6e 20 61 cks must be in a
e060: 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 20 scending order.
e070: 41 6e 64 20 74 68 65 20 6c 61 73 74 20 62 79 74 And the last byt
e080: 65 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 e of. **
e090: 74 68 65 20 66 72 65 65 2d 62 6c 6f 63 6b 20 6d the free-block m
e0a0: 75 73 74 20 6c 69 65 20 6f 6e 20 74 68 65 20 64 ust lie on the d
e0b0: 61 74 61 62 61 73 65 20 70 61 67 65 2e 20 20 2a atabase page. *
e0c0: 2f 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e /. return
e0d0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
e0e0: 42 4b 50 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 BKPT; . }.
e0f0: 20 20 20 20 20 6e 46 72 65 65 20 3d 20 6e 46 72 nFree = nFr
e100: 65 65 20 2b 20 73 69 7a 65 3b 0a 20 20 20 20 20 ee + size;.
e110: 20 70 63 20 3d 20 6e 65 78 74 3b 0a 20 20 20 20 pc = next;.
e120: 7d 0a 0a 20 20 20 20 2f 2a 20 41 74 20 74 68 69 }.. /* At thi
e130: 73 20 70 6f 69 6e 74 2c 20 6e 46 72 65 65 20 63 s point, nFree c
e140: 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 75 6d 20 ontains the sum
e150: 6f 66 20 74 68 65 20 6f 66 66 73 65 74 20 74 6f of the offset to
e160: 20 74 68 65 20 73 74 61 72 74 0a 20 20 20 20 2a the start. *
e170: 2a 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f * of the cell-co
e180: 6e 74 65 6e 74 20 61 72 65 61 20 70 6c 75 73 20 ntent area plus
e190: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 the number of fr
e1a0: 65 65 20 62 79 74 65 73 20 77 69 74 68 69 6e 0a ee bytes within.
e1b0: 20 20 20 20 2a 2a 20 74 68 65 20 63 65 6c 6c 2d ** the cell-
e1c0: 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 49 66 content area. If
e1d0: 20 74 68 69 73 20 69 73 20 67 72 65 61 74 65 72 this is greater
e1e0: 20 74 68 61 6e 20 74 68 65 20 75 73 61 62 6c 65 than the usable
e1f0: 2d 73 69 7a 65 0a 20 20 20 20 2a 2a 20 6f 66 20 -size. ** of
e200: 74 68 65 20 70 61 67 65 2c 20 74 68 65 6e 20 74 the page, then t
e210: 68 65 20 70 61 67 65 20 6d 75 73 74 20 62 65 20 he page must be
e220: 63 6f 72 72 75 70 74 65 64 2e 20 54 68 69 73 20 corrupted. This
e230: 63 68 65 63 6b 20 61 6c 73 6f 0a 20 20 20 20 2a check also. *
e240: 2a 20 73 65 72 76 65 73 20 74 6f 20 76 65 72 69 * serves to veri
e250: 66 79 20 74 68 61 74 20 74 68 65 20 6f 66 66 73 fy that the offs
e260: 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 et to the start
e270: 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 of the cell-cont
e280: 65 6e 74 0a 20 20 20 20 2a 2a 20 61 72 65 61 2c ent. ** area,
e290: 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 according to th
e2a0: 65 20 70 61 67 65 20 68 65 61 64 65 72 2c 20 6c e page header, l
e2b0: 69 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 ies within the p
e2c0: 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 age.. */.
e2d0: 69 66 28 20 6e 46 72 65 65 3e 75 73 61 62 6c 65 if( nFree>usable
e2e0: 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72 65 Size ){. re
e2f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
e300: 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 20 7d UPT_BKPT; . }
e310: 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 . pPage->nFre
e320: 65 20 3d 20 28 75 31 36 29 28 6e 46 72 65 65 20 e = (u16)(nFree
e330: 2d 20 69 43 65 6c 6c 46 69 72 73 74 29 3b 0a 20 - iCellFirst);.
e340: 20 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 pPage->isInit
e350: 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 = 1;. }. retu
e360: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
e370: 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 20 61 20 ./*.** Set up a
e380: 72 61 77 20 70 61 67 65 20 73 6f 20 74 68 61 74 raw page so that
e390: 20 69 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 61 it looks like a
e3a0: 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 68 database page h
e3b0: 6f 6c 64 69 6e 67 0a 2a 2a 20 6e 6f 20 65 6e 74 olding.** no ent
e3c0: 72 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ries..*/.static
e3d0: 76 6f 69 64 20 7a 65 72 6f 50 61 67 65 28 4d 65 void zeroPage(Me
e3e0: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
e3f0: 74 20 66 6c 61 67 73 29 7b 0a 20 20 75 6e 73 69 t flags){. unsi
e400: 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 20 gned char *data
e410: 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a = pPage->aData;.
e420: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
e430: 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
e440: 75 38 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e u8 hdr = pPage->
e450: 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 75 31 36 hdrOffset;. u16
e460: 20 66 69 72 73 74 3b 0a 0a 20 20 61 73 73 65 72 first;.. asser
e470: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 t( sqlite3PagerP
e480: 61 67 65 6e 75 6d 62 65 72 28 70 50 61 67 65 2d agenumber(pPage-
e490: 3e 70 44 62 50 61 67 65 29 3d 3d 70 50 61 67 65 >pDbPage)==pPage
e4a0: 2d 3e 70 67 6e 6f 20 29 3b 0a 20 20 61 73 73 65 ->pgno );. asse
e4b0: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
e4c0: 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d 3e GetExtra(pPage->
e4d0: 70 44 62 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 pDbPage) == (voi
e4e0: 64 2a 29 70 50 61 67 65 20 29 3b 0a 20 20 61 73 d*)pPage );. as
e4f0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
e500: 65 72 47 65 74 44 61 74 61 28 70 50 61 67 65 2d erGetData(pPage-
e510: 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 64 61 74 >pDbPage) == dat
e520: 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 a );. assert( s
e530: 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
e540: 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 teable(pPage->pD
e550: 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 65 bPage) );. asse
e560: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
e570: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
e580: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d x) );. if( pBt-
e590: 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
e5a0: 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b SECURE_DELETE ){
e5b0: 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 64 61 74 . memset(&dat
e5c0: 61 5b 68 64 72 5d 2c 20 30 2c 20 70 42 74 2d 3e a[hdr], 0, pBt->
e5d0: 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 68 64 72 usableSize - hdr
e5e0: 29 3b 0a 20 20 7d 0a 20 20 64 61 74 61 5b 68 64 );. }. data[hd
e5f0: 72 5d 20 3d 20 28 63 68 61 72 29 66 6c 61 67 73 r] = (char)flags
e600: 3b 0a 20 20 66 69 72 73 74 20 3d 20 68 64 72 20 ;. first = hdr
e610: 2b 20 28 28 66 6c 61 67 73 26 50 54 46 5f 4c 45 + ((flags&PTF_LE
e620: 41 46 29 3d 3d 30 20 3f 20 31 32 20 3a 20 38 29 AF)==0 ? 12 : 8)
e630: 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 ;. memset(&data
e640: 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a [hdr+1], 0, 4);.
e650: 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 data[hdr+7] =
e660: 30 3b 0a 20 20 70 75 74 32 62 79 74 65 28 26 64 0;. put2byte(&d
e670: 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 42 74 2d ata[hdr+5], pBt-
e680: 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 >usableSize);.
e690: 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 pPage->nFree = (
e6a0: 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 u16)(pBt->usable
e6b0: 53 69 7a 65 20 2d 20 66 69 72 73 74 29 3b 0a 20 Size - first);.
e6c0: 20 64 65 63 6f 64 65 46 6c 61 67 73 28 70 50 61 decodeFlags(pPa
e6d0: 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 70 50 ge, flags);. pP
e6e0: 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 age->cellOffset
e6f0: 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 61 67 65 = first;. pPage
e700: 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 26 64 61 ->aDataEnd = &da
e710: 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 ta[pBt->usableSi
e720: 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 61 43 ze];. pPage->aC
e730: 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b 66 ellIdx = &data[f
e740: 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 65 2d 3e irst];. pPage->
e750: 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 nOverflow = 0;.
e760: 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 assert( pBt->pa
e770: 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 geSize>=512 && p
e780: 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 Bt->pageSize<=65
e790: 35 33 36 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 536 );. pPage->
e7a0: 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 31 36 29 maskPage = (u16)
e7b0: 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d (pBt->pageSize -
e7c0: 20 31 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 43 1);. pPage->nC
e7d0: 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 ell = 0;. pPage
e7e0: 2d 3e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 7d 0a ->isInit = 1;.}.
e7f0: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 ../*.** Convert
e800: 61 20 44 62 50 61 67 65 20 6f 62 74 61 69 6e 65 a DbPage obtaine
e810: 64 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 d from the pager
e820: 20 69 6e 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 into a MemPage
e830: 75 73 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 62 used by.** the b
e840: 74 72 65 65 20 6c 61 79 65 72 2e 0a 2a 2f 0a 73 tree layer..*/.s
e850: 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 2a 62 tatic MemPage *b
e860: 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 50 61 treePageFromDbPa
e870: 67 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 ge(DbPage *pDbPa
e880: 67 65 2c 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 42 ge, Pgno pgno, B
e890: 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
e8a0: 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 MemPage *pPage
e8b0: 3d 20 28 4d 65 6d 50 61 67 65 2a 29 73 71 6c 69 = (MemPage*)sqli
e8c0: 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 te3PagerGetExtra
e8d0: 28 70 44 62 50 61 67 65 29 3b 0a 20 20 70 50 61 (pDbPage);. pPa
e8e0: 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c 69 ge->aData = sqli
e8f0: 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 te3PagerGetData(
e900: 70 44 62 50 61 67 65 29 3b 0a 20 20 70 50 61 67 pDbPage);. pPag
e910: 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 70 44 62 e->pDbPage = pDb
e920: 50 61 67 65 3b 0a 20 20 70 50 61 67 65 2d 3e 70 Page;. pPage->p
e930: 42 74 20 3d 20 70 42 74 3b 0a 20 20 70 50 61 67 Bt = pBt;. pPag
e940: 65 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b 0a e->pgno = pgno;.
e950: 20 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 pPage->hdrOffs
e960: 65 74 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f et = pPage->pgno
e970: 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b 0a 20 ==1 ? 100 : 0;.
e980: 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b 20 0a return pPage; .
e990: 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 }../*.** Get a p
e9a0: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 age from the pag
e9b0: 65 72 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 er. Initialize
e9c0: 74 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 the MemPage.pBt
e9d0: 61 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 and.** MemPage.a
e9e0: 44 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 Data elements if
e9f0: 20 6e 65 65 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 needed..**.** I
ea00: 66 20 74 68 65 20 6e 6f 43 6f 6e 74 65 6e 74 20 f the noContent
ea10: 66 6c 61 67 20 69 73 20 73 65 74 2c 20 69 74 20 flag is set, it
ea20: 6d 65 61 6e 73 20 74 68 61 74 20 77 65 20 64 6f means that we do
ea30: 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 0a not care about.
ea40: 2a 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f ** the content o
ea50: 66 20 74 68 65 20 70 61 67 65 20 61 74 20 74 68 f the page at th
ea60: 69 73 20 74 69 6d 65 2e 20 20 53 6f 20 64 6f 20 is time. So do
ea70: 6e 6f 74 20 67 6f 20 74 6f 20 74 68 65 20 64 69 not go to the di
ea80: 73 6b 0a 2a 2a 20 74 6f 20 66 65 74 63 68 20 74 sk.** to fetch t
ea90: 68 65 20 63 6f 6e 74 65 6e 74 2e 20 20 4a 75 73 he content. Jus
eaa0: 74 20 66 69 6c 6c 20 69 6e 20 74 68 65 20 63 6f t fill in the co
eab0: 6e 74 65 6e 74 20 77 69 74 68 20 7a 65 72 6f 73 ntent with zeros
eac0: 20 66 6f 72 20 6e 6f 77 2e 0a 2a 2a 20 49 66 20 for now..** If
ead0: 69 6e 20 74 68 65 20 66 75 74 75 72 65 20 77 65 in the future we
eae0: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 call sqlite3Pag
eaf0: 65 72 57 72 69 74 65 28 29 20 6f 6e 20 74 68 69 erWrite() on thi
eb00: 73 20 70 61 67 65 2c 20 74 68 61 74 0a 2a 2a 20 s page, that.**
eb10: 6d 65 61 6e 73 20 77 65 20 68 61 76 65 20 73 74 means we have st
eb20: 61 72 74 65 64 20 74 6f 20 62 65 20 63 6f 6e 63 arted to be conc
eb30: 65 72 6e 65 64 20 61 62 6f 75 74 20 63 6f 6e 74 erned about cont
eb40: 65 6e 74 20 61 6e 64 20 74 68 65 20 64 69 73 6b ent and the disk
eb50: 0a 2a 2a 20 72 65 61 64 20 73 68 6f 75 6c 64 20 .** read should
eb60: 6f 63 63 75 72 20 61 74 20 74 68 61 74 20 70 6f occur at that po
eb70: 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 int..*/.static i
eb80: 6e 74 20 62 74 72 65 65 47 65 74 50 61 67 65 28 nt btreeGetPage(
eb90: 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
eba0: 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 , /* The b
ebb0: 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 tree */. Pgno p
ebc0: 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 2f gno, /
ebd0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 * Number of the
ebe0: 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 2a 2f page to fetch */
ebf0: 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 . MemPage **ppP
ec00: 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 75 72 age, /* Retur
ec10: 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 n the page in th
ec20: 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a 2f 0a is parameter */.
ec30: 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 20 int flags
ec40: 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f /* PAGER_
ec50: 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 6f 72 GET_NOCONTENT or
ec60: 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f PAGER_GET_READO
ec70: 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 NLY */.){. int
ec80: 72 63 3b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 rc;. DbPage *pD
ec90: 62 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 bPage;.. assert
eca0: 28 20 66 6c 61 67 73 3d 3d 30 20 7c 7c 20 66 6c ( flags==0 || fl
ecb0: 61 67 73 3d 3d 50 41 47 45 52 5f 47 45 54 5f 4e ags==PAGER_GET_N
ecc0: 4f 43 4f 4e 54 45 4e 54 20 7c 7c 20 66 6c 61 67 OCONTENT || flag
ecd0: 73 3d 3d 50 41 47 45 52 5f 47 45 54 5f 52 45 41 s==PAGER_GET_REA
ece0: 44 4f 4e 4c 59 20 29 3b 0a 20 20 61 73 73 65 72 DONLY );. asser
ecf0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
ed00: 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
ed10: 29 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ) );. rc = sqli
ed20: 74 65 33 50 61 67 65 72 41 63 71 75 69 72 65 28 te3PagerAcquire(
ed30: 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e pBt->pPager, pgn
ed40: 6f 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 o, (DbPage**)&pD
ed50: 62 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 bPage, flags);.
ed60: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
ed70: 20 72 63 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d rc;. *ppPage =
ed80: 20 62 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 btreePageFromDb
ed90: 50 61 67 65 28 70 44 62 50 61 67 65 2c 20 70 67 Page(pDbPage, pg
eda0: 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 72 65 74 75 no, pBt);. retu
edb0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
edc0: 0a 2f 2a 0a 2a 2a 20 52 65 74 72 69 65 76 65 20 ./*.** Retrieve
edd0: 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 a page from the
ede0: 70 61 67 65 72 20 63 61 63 68 65 2e 20 49 66 20 pager cache. If
edf0: 74 68 65 20 72 65 71 75 65 73 74 65 64 20 70 61 the requested pa
ee00: 67 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 ge is not.** alr
ee10: 65 61 64 79 20 69 6e 20 74 68 65 20 70 61 67 65 eady in the page
ee20: 72 20 63 61 63 68 65 20 72 65 74 75 72 6e 20 4e r cache return N
ee30: 55 4c 4c 2e 20 49 6e 69 74 69 61 6c 69 7a 65 20 ULL. Initialize
ee40: 74 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 the MemPage.pBt
ee50: 61 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 and.** MemPage.a
ee60: 44 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 Data elements if
ee70: 20 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 needed..*/.stat
ee80: 69 63 20 4d 65 6d 50 61 67 65 20 2a 62 74 72 65 ic MemPage *btre
ee90: 65 50 61 67 65 4c 6f 6f 6b 75 70 28 42 74 53 68 ePageLookup(BtSh
eea0: 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 ared *pBt, Pgno
eeb0: 70 67 6e 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 pgno){. DbPage
eec0: 2a 70 44 62 50 61 67 65 3b 0a 20 20 61 73 73 65 *pDbPage;. asse
eed0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
eee0: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
eef0: 78 29 20 29 3b 0a 20 20 70 44 62 50 61 67 65 20 x) );. pDbPage
ef00: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f = sqlite3PagerLo
ef10: 6f 6b 75 70 28 70 42 74 2d 3e 70 50 61 67 65 72 okup(pBt->pPager
ef20: 2c 20 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 70 , pgno);. if( p
ef30: 44 62 50 61 67 65 20 29 7b 0a 20 20 20 20 72 65 DbPage ){. re
ef40: 74 75 72 6e 20 62 74 72 65 65 50 61 67 65 46 72 turn btreePageFr
ef50: 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 omDbPage(pDbPage
ef60: 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 , pgno, pBt);.
ef70: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a }. return 0;.}.
ef80: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
ef90: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 e size of the da
efa0: 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e 20 70 tabase file in p
efb0: 61 67 65 73 2e 20 49 66 20 74 68 65 72 65 20 69 ages. If there i
efc0: 73 20 61 6e 79 20 6b 69 6e 64 20 6f 66 0a 2a 2a s any kind of.**
efd0: 20 65 72 72 6f 72 2c 20 72 65 74 75 72 6e 20 28 error, return (
efe0: 28 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 2d 31 (unsigned int)-1
eff0: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e )..*/.static Pgn
f000: 6f 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 o btreePagecount
f010: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
f020: 0a 20 20 72 65 74 75 72 6e 20 70 42 74 2d 3e 6e . return pBt->n
f030: 50 61 67 65 3b 0a 7d 0a 75 33 32 20 73 71 6c 69 Page;.}.u32 sqli
f040: 74 65 33 42 74 72 65 65 4c 61 73 74 50 61 67 65 te3BtreeLastPage
f050: 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 61 73 (Btree *p){. as
f060: 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 sert( sqlite3Btr
f070: 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 eeHoldsMutex(p)
f080: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 28 70 );. assert( ((p
f090: 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 29 26 30 78 ->pBt->nPage)&0x
f0a0: 38 30 30 30 30 30 30 29 3d 3d 30 20 29 3b 0a 20 8000000)==0 );.
f0b0: 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 61 67 return btreePag
f0c0: 65 63 6f 75 6e 74 28 70 2d 3e 70 42 74 29 3b 0a ecount(p->pBt);.
f0d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 }../*.** Get a p
f0e0: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 age from the pag
f0f0: 65 72 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a er and initializ
f100: 65 20 69 74 2e 20 20 54 68 69 73 20 72 6f 75 74 e it. This rout
f110: 69 6e 65 20 69 73 20 6a 75 73 74 20 61 0a 2a 2a ine is just a.**
f120: 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20 77 72 61 convenience wra
f130: 70 70 65 72 20 61 72 6f 75 6e 64 20 73 65 70 61 pper around sepa
f140: 72 61 74 65 20 63 61 6c 6c 73 20 74 6f 20 62 74 rate calls to bt
f150: 72 65 65 47 65 74 50 61 67 65 28 29 20 61 6e 64 reeGetPage() and
f160: 20 0a 2a 2a 20 62 74 72 65 65 49 6e 69 74 50 61 .** btreeInitPa
f170: 67 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 ge()..**.** If a
f180: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 n error occurs,
f190: 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 2a then the value *
f1a0: 70 70 50 61 67 65 20 69 73 20 73 65 74 20 74 6f ppPage is set to
f1b0: 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 49 is undefined. I
f1c0: 74 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e 20 t.** may remain
f1d0: 75 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 74 unchanged, or it
f1e0: 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 61 may be set to a
f1f0: 6e 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 2e n invalid value.
f200: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 .*/.static int g
f210: 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a 20 etAndInitPage(.
f220: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 BtShared *pBt,
f230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f240: 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
f250: 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
f260: 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
f270: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
f280: 6d 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 mber of the page
f290: 20 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 6d to get */. Mem
f2a0: 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 Page **ppPage,
f2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
f2c0: 57 72 69 74 65 20 74 68 65 20 70 61 67 65 20 70 Write the page p
f2d0: 6f 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a 20 ointer here */.
f2e0: 20 69 6e 74 20 62 52 65 61 64 6f 6e 6c 79 20 20 int bReadonly
f2f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f300: 20 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 52 45 /* PAGER_GET_RE
f310: 41 44 4f 4e 4c 59 20 6f 72 20 30 20 2a 2f 0a 29 ADONLY or 0 */.)
f320: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 {. int rc;. as
f330: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
f340: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
f350: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
f360: 28 20 62 52 65 61 64 6f 6e 6c 79 3d 3d 50 41 47 ( bReadonly==PAG
f370: 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 ER_GET_READONLY
f380: 7c 7c 20 62 52 65 61 64 6f 6e 6c 79 3d 3d 30 20 || bReadonly==0
f390: 29 3b 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 );.. if( pgno>b
f3a0: 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 treePagecount(pB
f3b0: 74 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 t) ){. rc = S
f3c0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
f3d0: 50 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 PT;. }else{.
f3e0: 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
f3f0: 67 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 ge(pBt, pgno, pp
f400: 50 61 67 65 2c 20 62 52 65 61 64 6f 6e 6c 79 29 Page, bReadonly)
f410: 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
f420: 4c 49 54 45 5f 4f 4b 20 26 26 20 28 2a 70 70 50 LITE_OK && (*ppP
f430: 61 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 age)->isInit==0
f440: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 ){. rc = bt
f450: 72 65 65 49 6e 69 74 50 61 67 65 28 2a 70 70 50 reeInitPage(*ppP
f460: 61 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 age);. if(
f470: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
f480: 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 . release
f490: 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 Page(*ppPage);.
f4a0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
f4b0: 0a 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 67 .. testcase( pg
f4c0: 6e 6f 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 no==0 );. asser
f4d0: 74 28 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 t( pgno!=0 || rc
f4e0: 3d 3d 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 ==SQLITE_CORRUPT
f4f0: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
f500: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 .}../*.** Releas
f510: 65 20 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 e a MemPage. Th
f520: 69 73 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c is should be cal
f530: 6c 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 led once for eac
f540: 68 20 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 h prior.** call
f550: 74 6f 20 62 74 72 65 65 47 65 74 50 61 67 65 2e to btreeGetPage.
f560: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
f570: 72 65 6c 65 61 73 65 50 61 67 65 28 4d 65 6d 50 releasePage(MemP
f580: 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 age *pPage){. i
f590: 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 f( pPage ){.
f5a0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 assert( pPage->a
f5b0: 44 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 Data );. asse
f5c0: 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 20 29 rt( pPage->pBt )
f5d0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
f5e0: 61 67 65 2d 3e 70 44 62 50 61 67 65 21 3d 30 20 age->pDbPage!=0
f5f0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
f600: 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 qlite3PagerGetEx
f610: 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 tra(pPage->pDbPa
f620: 67 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 70 50 ge) == (void*)pP
f630: 61 67 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 age );. asser
f640: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
f650: 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 etData(pPage->pD
f660: 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 bPage)==pPage->a
f670: 44 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 Data );. asse
f680: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
f690: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
f6a0: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 t->mutex) );.
f6b0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
f6c0: 65 66 4e 6f 74 4e 75 6c 6c 28 70 50 61 67 65 2d efNotNull(pPage-
f6d0: 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 7d 0a 7d >pDbPage);. }.}
f6e0: 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 ../*.** During a
f6f0: 20 72 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 rollback, when
f700: 74 68 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 the pager reload
f710: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e s information in
f720: 74 6f 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 to the cache.**
f730: 73 6f 20 74 68 61 74 20 74 68 65 20 63 61 63 68 so that the cach
f740: 65 20 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f e is restored to
f750: 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 its original st
f760: 61 74 65 20 61 74 20 74 68 65 20 73 74 61 72 74 ate at the start
f770: 20 6f 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 of.** the trans
f780: 61 63 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 action, for each
f790: 20 70 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 page restored t
f7a0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
f7b0: 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 alled..**.** Thi
f7c0: 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 s routine needs
f7d0: 74 6f 20 72 65 73 65 74 20 74 68 65 20 65 78 74 to reset the ext
f7e0: 72 61 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 ra data section
f7f0: 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 at the end of th
f800: 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 e.** page to agr
f810: 65 65 20 77 69 74 68 20 74 68 65 20 72 65 73 74 ee with the rest
f820: 6f 72 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 ored data..*/.st
f830: 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 atic void pageRe
f840: 69 6e 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 init(DbPage *pDa
f850: 74 61 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a ta){. MemPage *
f860: 70 50 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d pPage;. pPage =
f870: 20 28 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 (MemPage *)sqli
f880: 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 te3PagerGetExtra
f890: 28 70 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 (pData);. asser
f8a0: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 t( sqlite3PagerP
f8b0: 61 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 ageRefcount(pDat
f8c0: 61 29 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 a)>0 );. if( pP
f8d0: 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 age->isInit ){.
f8e0: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
f8f0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 e3_mutex_held(pP
f900: 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 age->pBt->mutex)
f910: 20 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 );. pPage->i
f920: 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 sInit = 0;. i
f930: 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 f( sqlite3PagerP
f940: 61 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 ageRefcount(pDat
f950: 61 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a a)>1 ){. /*
f960: 20 70 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 pPage might not
f970: 20 62 65 20 61 20 62 74 72 65 65 20 70 61 67 65 be a btree page
f980: 3b 20 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 ; it might be a
f990: 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a n overflow page.
f9a0: 20 20 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d ** or ptrm
f9b0: 61 70 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 ap page or a fre
f9c0: 65 20 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 e page. In thos
f9d0: 65 20 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c e cases, the fol
f9e0: 6c 6f 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 lowing. **
f9f0: 63 61 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 call to btreeIni
fa00: 74 50 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b tPage() will lik
fa10: 65 6c 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ely return SQLIT
fa20: 45 5f 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 E_CORRUPT..
fa30: 20 2a 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 ** But no harm
fa40: 69 73 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e is done by this.
fa50: 20 20 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 And it is very
fa60: 20 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a important that.
fa70: 20 20 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e ** btreeIn
fa80: 69 74 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c itPage() be call
fa90: 65 64 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 ed on every btre
faa0: 65 20 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b e page so we mak
fab0: 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 e. ** the c
fac0: 61 6c 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 all for every pa
fad0: 67 65 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e ge that comes in
fae0: 20 66 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e for re-initing.
faf0: 20 2a 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 */. btreeI
fb00: 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a nitPage(pPage);.
fb10: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a }. }.}../*.
fb20: 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 ** Invoke the bu
fb30: 73 79 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 sy handler for a
fb40: 20 62 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 btree..*/.stati
fb50: 63 20 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b c int btreeInvok
fb60: 65 42 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 eBusyHandler(voi
fb70: 64 20 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 d *pArg){. BtSh
fb80: 61 72 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 ared *pBt = (BtS
fb90: 68 61 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 hared*)pArg;. a
fba0: 73 73 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 ssert( pBt->db )
fbb0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
fbc0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
fbd0: 42 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 Bt->db->mutex) )
fbe0: 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 ;. return sqlit
fbf0: 65 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 e3InvokeBusyHand
fc00: 6c 65 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 ler(&pBt->db->bu
fc10: 73 79 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a 2f syHandler);.}../
fc20: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 *.** Open a data
fc30: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a base file..** .*
fc40: 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 * zFilename is t
fc50: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 he name of the d
fc60: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 atabase file. I
fc70: 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e f zFilename is N
fc80: 55 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 ULL.** then an e
fc90: 70 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 phemeral databas
fca0: 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 e is created. T
fcb0: 68 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 he ephemeral dat
fcc0: 61 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 abase might.** b
fcd0: 65 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e e exclusively in
fce0: 20 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d memory, or it m
fcf0: 69 67 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d ight use a disk-
fd00: 62 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 based memory cac
fd10: 68 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 he..** Either wa
fd20: 79 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c y, the ephemeral
fd30: 20 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 database will b
fd40: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 e automatically
fd50: 64 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e deleted .** when
fd60: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f sqlite3BtreeClo
fd70: 73 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a se() is called..
fd80: 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 **.** If zFilena
fd90: 6d 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 me is ":memory:"
fda0: 20 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f then an in-memo
fdb0: 72 79 20 64 61 74 61 62 61 73 65 20 69 73 20 63 ry database is c
fdc0: 72 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 reated.** that i
fdd0: 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 s automatically
fde0: 64 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 destroyed when i
fdf0: 74 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a t is closed..**.
fe00: 2a 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 ** The "flags" p
fe10: 61 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 arameter is a bi
fe20: 74 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 tmask that might
fe30: 20 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 contain bits li
fe40: 6b 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 ke.** BTREE_OMIT
fe50: 5f 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 _JOURNAL and/or
fe60: 42 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a BTREE_MEMORY..**
fe70: 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 .** If the datab
fe80: 61 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f ase is already o
fe90: 70 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d pened in the sam
fea0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
feb0: 63 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 ction.** and we
fec0: 61 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 are in shared ca
fed0: 63 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 che mode, then t
fee0: 68 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 he open will fai
fef0: 6c 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c l with an.** SQL
ff00: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 ITE_CONSTRAINT e
ff10: 72 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 rror. We cannot
ff20: 20 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f allow two or mo
ff30: 72 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f re BtShared.** o
ff40: 62 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 bjects in the sa
ff50: 6d 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e me database conn
ff60: 65 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 ection since doi
ff70: 6e 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a ng so will lead.
ff80: 2a 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 ** to problems w
ff90: 69 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a ith locking..*/.
ffa0: 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
ffb0: 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f Open(. sqlite3_
ffc0: 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 vfs *pVfs,
ffd0: 2f 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f /* VFS to use fo
ffe0: 72 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f r this b-tree */
fff0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
10000 46 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 Filename, /* Na
10010 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 me of the file c
10020 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 ontaining the BT
10030 72 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a ree database */.
10040 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
10050 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 /* Ass
10060 6f 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 ociated database
10070 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 handle */. Btr
10080 65 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 ee **ppBtree,
10090 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
100a0 74 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a to new Btree obj
100b0 65 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 ect written here
100c0 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c */. int flags,
100d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
100e0 20 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e Options */. in
100f0 74 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 t vfsFlags
10100 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 /* Flags p
10110 61 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f assed through to
10120 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 sqlite3_vfs.xOp
10130 65 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 en() */.){. BtS
10140 68 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 hared *pBt = 0;
10150 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
10160 68 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 hared part of bt
10170 72 65 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f ree structure */
10180 0a 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 . Btree *p;
10190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
101a0 20 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 /* Handle to r
101b0 65 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 eturn */. sqlit
101c0 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f e3_mutex *mutexO
101d0 70 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 pen = 0; /* Pre
101e0 76 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e vents a race con
101f0 64 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 dition. Ticket #
10200 33 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3537 */. int rc
10210 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 = SQLITE_OK;
10220 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 /* Resu
10230 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 lt code from thi
10240 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 s function */.
10250 75 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 u8 nReserve;
10260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
10270 2a 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 * Byte of unused
10280 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 space on each p
10290 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 age */. unsigne
102a0 64 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 d char zDbHeader
102b0 5b 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 [100]; /* Datab
102c0 61 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 ase header conte
102d0 6e 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 nt */.. /* True
102e0 20 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 if opening an e
102f0 70 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 phemeral, tempor
10300 61 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a ary database */.
10310 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 const int isTe
10320 6d 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 mpDb = zFilename
10330 3d 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 ==0 || zFilename
10340 5b 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 [0]==0;.. /* Se
10350 74 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 t the variable i
10360 73 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 sMemdb to true f
10370 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 or an in-memory
10380 64 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 database, or .
10390 2a 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 ** false for a f
103a0 69 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 ile-based databa
103b0 73 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 se.. */.#ifdef
103c0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f SQLITE_OMIT_MEMO
103d0 52 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 RYDB. const int
103e0 20 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 isMemdb = 0;.#e
103f0 6c 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 lse. const int
10400 69 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 isMemdb = (zFile
10410 6e 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a name && strcmp(z
10420 46 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f Filename, ":memo
10430 72 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 ry:")==0).
10440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10450 20 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 || (isTempDb &&
10460 20 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 sqlite3TempInMe
10470 6d 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 mory(db)).
10480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10490 20 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 || (vfsFlags &
104a0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f SQLITE_OPEN_MEMO
104b0 52 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a RY)!=0;.#endif..
104c0 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 assert( db!=0
104d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 );. assert( pVf
104e0 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 s!=0 );. assert
104f0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
10500 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
10510 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c );. assert( (fl
10520 61 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 ags&0xff)==flags
10530 20 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 ); /* flags f
10540 69 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a it in 8 bits */.
10550 0a 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 . /* Only a BTR
10560 45 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 EE_SINGLE databa
10570 73 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f se can be BTREE_
10580 55 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 UNORDERED */. a
10590 73 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 ssert( (flags &
105a0 42 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 BTREE_UNORDERED)
105b0 3d 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 ==0 || (flags &
105c0 42 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 BTREE_SINGLE)!=0
105d0 20 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 );.. /* A BTRE
105e0 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 E_SINGLE databas
105f0 65 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 e is always a te
10600 6d 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 mporary and/or e
10610 70 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 phemeral */. as
10620 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 sert( (flags & B
10630 54 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 TREE_SINGLE)==0
10640 7c 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a || isTempDb );..
10650 20 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b if( isMemdb ){
10660 0a 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 . flags |= BT
10670 52 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a REE_MEMORY;. }.
10680 20 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 if( (vfsFlags
10690 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 & SQLITE_OPEN_MA
106a0 49 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 IN_DB)!=0 && (is
106b0 4d 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 Memdb || isTempD
106c0 62 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 b) ){. vfsFla
106d0 67 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 gs = (vfsFlags &
106e0 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 ~SQLITE_OPEN_MA
106f0 49 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f IN_DB) | SQLITE_
10700 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 OPEN_TEMP_DB;.
10710 7d 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d }. p = sqlite3M
10720 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 allocZero(sizeof
10730 28 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 (Btree));. if(
10740 21 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e !p ){. return
10750 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
10760 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 }. p->inTrans
10770 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 = TRANS_NONE;.
10780 70 2d 3e 64 62 20 3d 20 64 62 3b 0a 23 69 66 6e p->db = db;.#ifn
10790 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
107a0 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 70 SHARED_CACHE. p
107b0 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 20 3d 20 ->lock.pBtree =
107c0 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 p;. p->lock.iTa
107d0 62 6c 65 20 3d 20 31 3b 0a 23 65 6e 64 69 66 0a ble = 1;.#endif.
107e0 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 .#if !defined(SQ
107f0 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
10800 5f 43 41 43 48 45 29 20 26 26 20 21 64 65 66 69 _CACHE) && !defi
10810 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
10820 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 0a 20 20 2a DISKIO). /*. *
10830 2a 20 49 66 20 74 68 69 73 20 42 74 72 65 65 20 * If this Btree
10840 69 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 66 is a candidate f
10850 6f 72 20 73 68 61 72 65 64 20 63 61 63 68 65 2c or shared cache,
10860 20 74 72 79 20 74 6f 20 66 69 6e 64 20 61 6e 0a try to find an.
10870 20 20 2a 2a 20 65 78 69 73 74 69 6e 67 20 42 74 ** existing Bt
10880 53 68 61 72 65 64 20 6f 62 6a 65 63 74 20 74 68 Shared object th
10890 61 74 20 77 65 20 63 61 6e 20 73 68 61 72 65 20 at we can share
108a0 77 69 74 68 0a 20 20 2a 2f 0a 20 20 69 66 28 20 with. */. if(
108b0 69 73 54 65 6d 70 44 62 3d 3d 30 20 26 26 20 28 isTempDb==0 && (
108c0 69 73 4d 65 6d 64 62 3d 3d 30 20 7c 7c 20 28 76 isMemdb==0 || (v
108d0 66 73 46 6c 61 67 73 26 53 51 4c 49 54 45 5f 4f fsFlags&SQLITE_O
108e0 50 45 4e 5f 55 52 49 29 21 3d 30 29 20 29 7b 0a PEN_URI)!=0) ){.
108f0 20 20 20 20 69 66 28 20 76 66 73 46 6c 61 67 73 if( vfsFlags
10900 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 & SQLITE_OPEN_S
10910 48 41 52 45 44 43 41 43 48 45 20 29 7b 0a 20 20 HAREDCACHE ){.
10920 20 20 20 20 69 6e 74 20 6e 46 75 6c 6c 50 61 74 int nFullPat
10930 68 6e 61 6d 65 20 3d 20 70 56 66 73 2d 3e 6d 78 hname = pVfs->mx
10940 50 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 20 20 Pathname+1;.
10950 20 20 63 68 61 72 20 2a 7a 46 75 6c 6c 50 61 74 char *zFullPat
10960 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 4d hname = sqlite3M
10970 61 6c 6c 6f 63 28 6e 46 75 6c 6c 50 61 74 68 6e alloc(nFullPathn
10980 61 6d 65 29 3b 0a 20 20 20 20 20 20 4d 55 54 45 ame);. MUTE
10990 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 X_LOGIC( sqlite3
109a0 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 61 _mutex *mutexSha
109b0 72 65 64 3b 20 29 0a 20 20 20 20 20 20 70 2d 3e red; ). p->
109c0 73 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 20 sharable = 1;.
109d0 20 20 20 20 69 66 28 20 21 7a 46 75 6c 6c 50 61 if( !zFullPa
109e0 74 68 6e 61 6d 65 20 29 7b 0a 20 20 20 20 20 20 thname ){.
109f0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
10a00 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 );. retur
10a10 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a n SQLITE_NOMEM;.
10a20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
10a30 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 ( isMemdb ){.
10a40 20 20 20 20 20 6d 65 6d 63 70 79 28 7a 46 75 6c memcpy(zFul
10a50 6c 50 61 74 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 lPathname, zFile
10a60 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33 53 74 72 name, sqlite3Str
10a70 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 len30(zFilename)
10a80 2b 31 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 +1);. }else
10a90 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 {. rc = s
10aa0 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 68 qlite3OsFullPath
10ab0 6e 61 6d 65 28 70 56 66 73 2c 20 7a 46 69 6c 65 name(pVfs, zFile
10ac0 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 name,.
10ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ae0 20 20 20 20 20 20 20 20 20 6e 46 75 6c 6c 50 61 nFullPa
10af0 74 68 6e 61 6d 65 2c 20 7a 46 75 6c 6c 50 61 74 thname, zFullPat
10b00 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 hname);.
10b10 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
10b20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
10b30 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b (zFullPathname);
10b40 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
10b50 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 e3_free(p);.
10b60 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
10b70 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
10b80 20 7d 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 }.#if SQLITE_TH
10b90 52 45 41 44 53 41 46 45 0a 20 20 20 20 20 20 6d READSAFE. m
10ba0 75 74 65 78 4f 70 65 6e 20 3d 20 73 71 6c 69 74 utexOpen = sqlit
10bb0 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c e3MutexAlloc(SQL
10bc0 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 ITE_MUTEX_STATIC
10bd0 5f 4f 50 45 4e 29 3b 0a 20 20 20 20 20 20 73 71 _OPEN);. sq
10be0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
10bf0 72 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 r(mutexOpen);.
10c00 20 20 20 20 6d 75 74 65 78 53 68 61 72 65 64 20 mutexShared
10c10 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
10c20 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
10c30 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b _STATIC_MASTER);
10c40 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
10c50 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 utex_enter(mutex
10c60 53 68 61 72 65 64 29 3b 0a 23 65 6e 64 69 66 0a Shared);.#endif.
10c70 20 20 20 20 20 20 66 6f 72 28 70 42 74 3d 47 4c for(pBt=GL
10c80 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 OBAL(BtShared*,s
10c90 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 qlite3SharedCach
10ca0 65 4c 69 73 74 29 3b 20 70 42 74 3b 20 70 42 74 eList); pBt; pBt
10cb0 3d 70 42 74 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 =pBt->pNext){.
10cc0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 assert( pB
10cd0 74 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20 20 t->nRef>0 );.
10ce0 20 20 20 20 20 69 66 28 20 30 3d 3d 73 74 72 63 if( 0==strc
10cf0 6d 70 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 mp(zFullPathname
10d00 2c 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 , sqlite3PagerFi
10d10 6c 65 6e 61 6d 65 28 70 42 74 2d 3e 70 50 61 67 lename(pBt->pPag
10d20 65 72 2c 20 30 29 29 0a 20 20 20 20 20 20 20 20 er, 0)).
10d30 20 20 20 20 20 20 20 20 20 26 26 20 73 71 6c 69 && sqli
10d40 74 65 33 50 61 67 65 72 56 66 73 28 70 42 74 2d te3PagerVfs(pBt-
10d50 3e 70 50 61 67 65 72 29 3d 3d 70 56 66 73 20 29 >pPager)==pVfs )
10d60 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 {. int
10d70 69 44 62 3b 0a 20 20 20 20 20 20 20 20 20 20 66 iDb;. f
10d80 6f 72 28 69 44 62 3d 64 62 2d 3e 6e 44 62 2d 31 or(iDb=db->nDb-1
10d90 3b 20 69 44 62 3e 3d 30 3b 20 69 44 62 2d 2d 29 ; iDb>=0; iDb--)
10da0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 42 74 {. Bt
10db0 72 65 65 20 2a 70 45 78 69 73 74 69 6e 67 20 3d ree *pExisting =
10dc0 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 db->aDb[iDb].pB
10dd0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 t;. i
10de0 66 28 20 70 45 78 69 73 74 69 6e 67 20 26 26 20 f( pExisting &&
10df0 70 45 78 69 73 74 69 6e 67 2d 3e 70 42 74 3d 3d pExisting->pBt==
10e00 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 pBt ){.
10e10 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
10e20 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 ex_leave(mutexSh
10e30 61 72 65 64 29 3b 0a 20 20 20 20 20 20 20 20 20 ared);.
10e40 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
10e50 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 4f 70 ex_leave(mutexOp
10e60 65 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 en);.
10e70 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
10e80 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a zFullPathname);.
10e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 sq
10ea0 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 lite3_free(p);.
10eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
10ec0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 urn SQLITE_CONST
10ed0 52 41 49 4e 54 3b 0a 20 20 20 20 20 20 20 20 20 RAINT;.
10ee0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d }. }
10ef0 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 42 . p->pB
10f00 74 20 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 20 t = pBt;.
10f10 20 20 20 70 42 74 2d 3e 6e 52 65 66 2b 2b 3b 0a pBt->nRef++;.
10f20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
10f30 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
10f40 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
10f50 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 _mutex_leave(mut
10f60 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 20 exShared);.
10f70 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 sqlite3_free(zF
10f80 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 ullPathname);.
10f90 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }.#ifdef SQLIT
10fa0 45 5f 44 45 42 55 47 0a 20 20 20 20 65 6c 73 65 E_DEBUG. else
10fb0 7b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 20 64 65 {. /* In de
10fc0 62 75 67 20 6d 6f 64 65 2c 20 77 65 20 6d 61 72 bug mode, we mar
10fd0 6b 20 61 6c 6c 20 70 65 72 73 69 73 74 65 6e 74 k all persistent
10fe0 20 64 61 74 61 62 61 73 65 73 20 61 73 20 73 68 databases as sh
10ff0 61 72 61 62 6c 65 0a 20 20 20 20 20 20 2a 2a 20 arable. **
11000 65 76 65 6e 20 77 68 65 6e 20 74 68 65 79 20 61 even when they a
11010 72 65 20 6e 6f 74 2e 20 20 54 68 69 73 20 65 78 re not. This ex
11020 65 72 63 69 73 65 73 20 74 68 65 20 6c 6f 63 6b ercises the lock
11030 69 6e 67 20 63 6f 64 65 20 61 6e 64 0a 20 20 20 ing code and.
11040 20 20 20 2a 2a 20 67 69 76 65 73 20 6d 6f 72 65 ** gives more
11050 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 opportunity for
11060 20 61 73 73 65 72 74 73 28 73 71 6c 69 74 65 33 asserts(sqlite3
11070 5f 6d 75 74 65 78 5f 68 65 6c 64 28 29 29 0a 20 _mutex_held()).
11080 20 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e ** statemen
11090 74 73 20 74 6f 20 66 69 6e 64 20 6c 6f 63 6b 69 ts to find locki
110a0 6e 67 20 70 72 6f 62 6c 65 6d 73 2e 0a 20 20 20 ng problems..
110b0 20 20 20 2a 2f 0a 20 20 20 20 20 20 70 2d 3e 73 */. p->s
110c0 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a 20 20 20 harable = 1;.
110d0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 23 65 }.#endif. }.#e
110e0 6e 64 69 66 0a 20 20 69 66 28 20 70 42 74 3d 3d ndif. if( pBt==
110f0 30 20 29 7b 0a 20 20 20 20 2f 2a 0a 20 20 20 20 0 ){. /*.
11100 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
11110 20 61 73 73 65 72 74 73 20 6d 61 6b 65 20 73 75 asserts make su
11120 72 65 20 74 68 61 74 20 73 74 72 75 63 74 75 72 re that structur
11130 65 73 20 75 73 65 64 20 62 79 20 74 68 65 20 62 es used by the b
11140 74 72 65 65 20 61 72 65 0a 20 20 20 20 2a 2a 20 tree are. **
11150 74 68 65 20 72 69 67 68 74 20 73 69 7a 65 2e 20 the right size.
11160 20 54 68 69 73 20 69 73 20 74 6f 20 67 75 61 72 This is to guar
11170 64 20 61 67 61 69 6e 73 74 20 73 69 7a 65 20 63 d against size c
11180 68 61 6e 67 65 73 20 74 68 61 74 20 72 65 73 75 hanges that resu
11190 6c 74 0a 20 20 20 20 2a 2a 20 77 68 65 6e 20 63 lt. ** when c
111a0 6f 6d 70 69 6c 69 6e 67 20 6f 6e 20 61 20 64 69 ompiling on a di
111b0 66 66 65 72 65 6e 74 20 61 72 63 68 69 74 65 63 fferent architec
111c0 74 75 72 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ture.. */.
111d0 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 assert( sizeof(
111e0 69 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 6f i64)==8 || sizeo
111f0 66 28 69 36 34 29 3d 3d 34 20 29 3b 0a 20 20 20 f(i64)==4 );.
11200 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 assert( sizeof(
11210 75 36 34 29 3d 3d 38 20 7c 7c 20 73 69 7a 65 6f u64)==8 || sizeo
11220 66 28 75 36 34 29 3d 3d 34 20 29 3b 0a 20 20 20 f(u64)==4 );.
11230 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 assert( sizeof(
11240 75 33 32 29 3d 3d 34 20 29 3b 0a 20 20 20 20 61 u32)==4 );. a
11250 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 31 ssert( sizeof(u1
11260 36 29 3d 3d 32 20 29 3b 0a 20 20 20 20 61 73 73 6)==2 );. ass
11270 65 72 74 28 20 73 69 7a 65 6f 66 28 50 67 6e 6f ert( sizeof(Pgno
11280 29 3d 3d 34 20 29 3b 0a 20 20 0a 20 20 20 20 70 )==4 );. . p
11290 42 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c Bt = sqlite3Mall
112a0 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 2a ocZero( sizeof(*
112b0 70 42 74 29 20 29 3b 0a 20 20 20 20 69 66 28 20 pBt) );. if(
112c0 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 pBt==0 ){.
112d0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
112e0 4d 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 M;. goto bt
112f0 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 ree_open_out;.
11300 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c }. rc = sql
11310 69 74 65 33 50 61 67 65 72 4f 70 65 6e 28 70 56 ite3PagerOpen(pV
11320 66 73 2c 20 26 70 42 74 2d 3e 70 50 61 67 65 72 fs, &pBt->pPager
11330 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 , zFilename,.
11340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11350 20 20 20 20 20 20 20 45 58 54 52 41 5f 53 49 5a EXTRA_SIZ
11360 45 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 E, flags, vfsFla
11370 67 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b gs, pageReinit);
11380 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
11390 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
113a0 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d sqlite3PagerSetM
113b0 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 mapLimit(pBt->pP
113c0 61 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 ager, db->szMmap
113d0 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
113e0 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 lite3PagerReadFi
113f0 6c 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 leheader(pBt->pP
11400 61 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 ager,sizeof(zDbH
11410 65 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 eader),zDbHeader
11420 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
11430 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
11440 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 {. goto btr
11450 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
11460 20 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e }. pBt->open
11470 46 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 Flags = (u8)flag
11480 73 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d s;. pBt->db =
11490 20 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 db;. sqlite3
114a0 50 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 64 PagerSetBusyhand
114b0 6c 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ler(pBt->pPager,
114c0 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
114d0 48 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 Handler, pBt);.
114e0 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b p->pBt = pBt;
114f0 0a 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 . . pBt->pCu
11500 72 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 rsor = 0;. pB
11510 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 t->pPage1 = 0;.
11520 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 if( sqlite3Pa
11530 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 gerIsreadonly(pB
11540 74 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 t->pPager) ) pBt
11550 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
11560 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 S_READ_ONLY;.#if
11570 64 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 52 def SQLITE_SECUR
11580 45 5f 44 45 4c 45 54 45 0a 20 20 20 20 70 42 74 E_DELETE. pBt
11590 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
115a0 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b S_SECURE_DELETE;
115b0 0a 23 65 6e 64 69 66 0a 20 20 20 20 2f 2a 20 45 .#endif. /* E
115c0 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 31 VIDENCE-OF: R-51
115d0 38 37 33 2d 33 39 36 31 38 20 54 68 65 20 70 61 873-39618 The pa
115e0 67 65 20 73 69 7a 65 20 66 6f 72 20 61 20 64 61 ge size for a da
115f0 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 0a 20 tabase file is.
11600 20 20 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 ** determined
11610 20 62 79 20 74 68 65 20 32 2d 62 79 74 65 20 69 by the 2-byte i
11620 6e 74 65 67 65 72 20 6c 6f 63 61 74 65 64 20 61 nteger located a
11630 74 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 20 31 t an offset of 1
11640 36 20 62 79 74 65 73 20 66 72 6f 6d 0a 20 20 20 6 bytes from.
11650 20 2a 2a 20 74 68 65 20 62 65 67 69 6e 6e 69 6e ** the beginnin
11660 67 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 g of the databas
11670 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 70 e file. */. p
11680 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 Bt->pageSize = (
11690 7a 44 62 48 65 61 64 65 72 5b 31 36 5d 3c 3c 38 zDbHeader[16]<<8
116a0 29 20 7c 20 28 7a 44 62 48 65 61 64 65 72 5b 31 ) | (zDbHeader[1
116b0 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 7]<<16);. if(
116c0 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 35 pBt->pageSize<5
116d0 31 32 20 7c 7c 20 70 42 74 2d 3e 70 61 67 65 53 12 || pBt->pageS
116e0 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 ize>SQLITE_MAX_P
116f0 41 47 45 5f 53 49 5a 45 0a 20 20 20 20 20 20 20 AGE_SIZE.
11700 20 20 7c 7c 20 28 28 70 42 74 2d 3e 70 61 67 65 || ((pBt->page
11710 53 69 7a 65 2d 31 29 26 70 42 74 2d 3e 70 61 67 Size-1)&pBt->pag
11720 65 53 69 7a 65 29 21 3d 30 20 29 7b 0a 20 20 20 eSize)!=0 ){.
11730 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 pBt->pageSize
11740 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 = 0;.#ifndef SQ
11750 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
11760 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 CUUM. /* If
11770 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 the magic name
11780 22 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 6c 6c 20 ":memory:" will
11790 63 72 65 61 74 65 20 61 6e 20 69 6e 2d 6d 65 6d create an in-mem
117a0 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 74 68 ory database, th
117b0 65 6e 0a 20 20 20 20 20 20 2a 2a 20 6c 65 61 76 en. ** leav
117c0 65 20 74 68 65 20 61 75 74 6f 56 61 63 75 75 6d e the autoVacuum
117d0 20 6d 6f 64 65 20 61 74 20 30 20 28 64 6f 20 6e mode at 0 (do n
117e0 6f 74 20 61 75 74 6f 2d 76 61 63 75 75 6d 29 2c ot auto-vacuum),
117f0 20 65 76 65 6e 20 69 66 0a 20 20 20 20 20 20 2a even if. *
11800 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 * SQLITE_DEFAULT
11810 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 74 _AUTOVACUUM is t
11820 72 75 65 2e 20 4f 6e 20 74 68 65 20 6f 74 68 65 rue. On the othe
11830 72 20 68 61 6e 64 2c 20 69 66 0a 20 20 20 20 20 r hand, if.
11840 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ** SQLITE_OMIT_
11850 4d 45 4d 4f 52 59 44 42 20 68 61 73 20 62 65 65 MEMORYDB has bee
11860 6e 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 n defined, then
11870 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 20 6a 75 ":memory:" is ju
11880 73 74 20 61 0a 20 20 20 20 20 20 2a 2a 20 72 65 st a. ** re
11890 67 75 6c 61 72 20 66 69 6c 65 2d 6e 61 6d 65 2e gular file-name.
118a0 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 In this case th
118b0 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 61 70 e auto-vacuum ap
118c0 70 6c 69 65 73 20 61 73 20 70 65 72 20 6e 6f 72 plies as per nor
118d0 6d 61 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 mal.. */.
118e0 20 20 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d if( zFilenam
118f0 65 20 26 26 20 21 69 73 4d 65 6d 64 62 20 29 7b e && !isMemdb ){
11900 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 61 75 . pBt->au
11910 74 6f 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 toVacuum = (SQLI
11920 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 TE_DEFAULT_AUTOV
11930 41 43 55 55 4d 20 3f 20 31 20 3a 20 30 29 3b 0a ACUUM ? 1 : 0);.
11940 20 20 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 63 pBt->inc
11950 72 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 rVacuum = (SQLIT
11960 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 E_DEFAULT_AUTOVA
11970 43 55 55 4d 3d 3d 32 20 3f 20 31 20 3a 20 30 29 CUUM==2 ? 1 : 0)
11980 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 ;. }.#endif
11990 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 . nReserve
119a0 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a = 0;. }else{.
119b0 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
119c0 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 2d 34 32 E-OF: R-37497-42
119d0 34 31 32 20 54 68 65 20 73 69 7a 65 20 6f 66 20 412 The size of
119e0 74 68 65 20 72 65 73 65 72 76 65 64 20 72 65 67 the reserved reg
119f0 69 6f 6e 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 ion is. **
11a00 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
11a10 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e 73 69 67 e one-byte unsig
11a20 6e 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 6e ned integer foun
11a30 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f d at an offset o
11a40 66 20 32 30 0a 20 20 20 20 20 20 2a 2a 20 69 6e f 20. ** in
11a50 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
11a60 66 69 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a file header. */.
11a70 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d nReserve =
11a80 20 7a 44 62 48 65 61 64 65 72 5b 32 30 5d 3b 0a zDbHeader[20];.
11a90 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c pBt->btsFl
11aa0 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 ags |= BTS_PAGES
11ab0 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 IZE_FIXED;.#ifnd
11ac0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
11ad0 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 UTOVACUUM.
11ae0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
11af0 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 = (get4byte(&zDb
11b00 48 65 61 64 65 72 5b 33 36 20 2b 20 34 2a 34 5d Header[36 + 4*4]
11b10 29 3f 31 3a 30 29 3b 0a 20 20 20 20 20 20 70 42 )?1:0);. pB
11b20 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 t->incrVacuum =
11b30 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 (get4byte(&zDbHe
11b40 61 64 65 72 5b 33 36 20 2b 20 37 2a 34 5d 29 3f ader[36 + 7*4])?
11b50 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 1:0);.#endif.
11b60 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 }. rc = sqli
11b70 74 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 te3PagerSetPages
11b80 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ize(pBt->pPager,
11b90 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c &pBt->pageSize,
11ba0 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 20 20 nReserve);.
11bb0 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 62 74 if( rc ) goto bt
11bc0 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 ree_open_out;.
11bd0 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a pBt->usableSiz
11be0 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a e = pBt->pageSiz
11bf0 65 20 2d 20 6e 52 65 73 65 72 76 65 3b 0a 20 20 e - nReserve;.
11c00 20 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e assert( (pBt->
11c10 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 pageSize & 7)==0
11c20 20 29 3b 20 20 2f 2a 20 38 2d 62 79 74 65 20 61 ); /* 8-byte a
11c30 6c 69 67 6e 6d 65 6e 74 20 6f 66 20 70 61 67 65 lignment of page
11c40 53 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 69 66 20 Size */. .#if
11c50 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
11c60 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
11c70 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 E) && !defined(S
11c80 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 QLITE_OMIT_DISKI
11c90 4f 29 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68 O). /* Add th
11ca0 65 20 6e 65 77 20 42 74 53 68 61 72 65 64 20 6f e new BtShared o
11cb0 62 6a 65 63 74 20 74 6f 20 74 68 65 20 6c 69 6e bject to the lin
11cc0 6b 65 64 20 6c 69 73 74 20 73 68 61 72 61 62 6c ked list sharabl
11cd0 65 20 42 74 53 68 61 72 65 64 73 2e 0a 20 20 20 e BtShareds..
11ce0 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 73 */. if( p->s
11cf0 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 harable ){.
11d00 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 MUTEX_LOGIC( sq
11d10 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 lite3_mutex *mut
11d20 65 78 53 68 61 72 65 64 3b 20 29 0a 20 20 20 20 exShared; ).
11d30 20 20 70 42 74 2d 3e 6e 52 65 66 20 3d 20 31 3b pBt->nRef = 1;
11d40 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 . MUTEX_LOG
11d50 49 43 28 20 6d 75 74 65 78 53 68 61 72 65 64 20 IC( mutexShared
11d60 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
11d70 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
11d80 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b _STATIC_MASTER);
11d90 29 0a 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 ). if( SQLI
11da0 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 26 26 TE_THREADSAFE &&
11db0 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
11dc0 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 nfig.bCoreMutex
11dd0 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e ){. pBt->
11de0 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d mutex = sqlite3M
11df0 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 utexAlloc(SQLITE
11e00 5f 4d 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 _MUTEX_FAST);.
11e10 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6d if( pBt->m
11e20 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 utex==0 ){.
11e30 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
11e40 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20 _NOMEM;.
11e50 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c db->mallocFail
11e60 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ed = 0;.
11e70 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 65 goto btree_ope
11e80 6e 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 7d n_out;. }
11e90 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 . }. s
11ea0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
11eb0 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b er(mutexShared);
11ec0 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 4e 65 78 . pBt->pNex
11ed0 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 t = GLOBAL(BtSha
11ee0 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 red*,sqlite3Shar
11ef0 65 64 43 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 edCacheList);.
11f00 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 GLOBAL(BtSha
11f10 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 red*,sqlite3Shar
11f20 65 64 43 61 63 68 65 4c 69 73 74 29 20 3d 20 70 edCacheList) = p
11f30 42 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 Bt;. sqlite
11f40 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 3_mutex_leave(mu
11f50 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 texShared);.
11f60 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 23 69 }.#endif. }..#i
11f70 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
11f80 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
11f90 43 48 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 CHE) && !defined
11fa0 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 (SQLITE_OMIT_DIS
11fb0 4b 49 4f 29 0a 20 20 2f 2a 20 49 66 20 74 68 65 KIO). /* If the
11fc0 20 6e 65 77 20 42 74 72 65 65 20 75 73 65 73 20 new Btree uses
11fd0 61 20 73 68 61 72 61 62 6c 65 20 70 42 74 53 68 a sharable pBtSh
11fe0 61 72 65 64 2c 20 74 68 65 6e 20 6c 69 6e 6b 20 ared, then link
11ff0 74 68 65 20 6e 65 77 0a 20 20 2a 2a 20 42 74 72 the new. ** Btr
12000 65 65 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 ee into the list
12010 20 6f 66 20 61 6c 6c 20 73 68 61 72 61 62 6c 65 of all sharable
12020 20 42 74 72 65 65 73 20 66 6f 72 20 74 68 65 20 Btrees for the
12030 73 61 6d 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e same connection.
12040 0a 20 20 2a 2a 20 54 68 65 20 6c 69 73 74 20 69 . ** The list i
12050 73 20 6b 65 70 74 20 69 6e 20 61 73 63 65 6e 64 s kept in ascend
12060 69 6e 67 20 6f 72 64 65 72 20 62 79 20 70 42 74 ing order by pBt
12070 20 61 64 64 72 65 73 73 2e 0a 20 20 2a 2f 0a 20 address.. */.
12080 20 69 66 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 if( p->sharable
12090 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
120a0 20 20 20 42 74 72 65 65 20 2a 70 53 69 62 3b 0a Btree *pSib;.
120b0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 for(i=0; i<d
120c0 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 b->nDb; i++){.
120d0 20 20 20 20 69 66 28 20 28 70 53 69 62 20 3d 20 if( (pSib =
120e0 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 21 db->aDb[i].pBt)!
120f0 3d 30 20 26 26 20 70 53 69 62 2d 3e 73 68 61 72 =0 && pSib->shar
12100 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 able ){.
12110 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 50 72 while( pSib->pPr
12120 65 76 20 29 7b 20 70 53 69 62 20 3d 20 70 53 69 ev ){ pSib = pSi
12130 62 2d 3e 70 50 72 65 76 3b 20 7d 0a 20 20 20 20 b->pPrev; }.
12140 20 20 20 20 69 66 28 20 70 2d 3e 70 42 74 3c 70 if( p->pBt<p
12150 53 69 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 Sib->pBt ){.
12160 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d p->pNext =
12170 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 20 20 pSib;.
12180 20 70 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 p->pPrev = 0;.
12190 20 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 pSib->p
121a0 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 Prev = p;.
121b0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
121c0 20 20 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e while( pSib->
121d0 70 4e 65 78 74 20 26 26 20 70 53 69 62 2d 3e 70 pNext && pSib->p
121e0 4e 65 78 74 2d 3e 70 42 74 3c 70 2d 3e 70 42 74 Next->pBt<p->pBt
121f0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
12200 70 53 69 62 20 3d 20 70 53 69 62 2d 3e 70 4e 65 pSib = pSib->pNe
12210 78 74 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a xt;. }.
12220 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 p->pNe
12230 78 74 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 xt = pSib->pNext
12240 3b 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 ;. p->p
12250 50 72 65 76 20 3d 20 70 53 69 62 3b 0a 20 20 20 Prev = pSib;.
12260 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 70 4e if( p->pN
12270 65 78 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ext ){.
12280 20 20 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 p->pNext->pPr
12290 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 ev = p;.
122a0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 53 }. pS
122b0 69 62 2d 3e 70 4e 65 78 74 20 3d 20 70 3b 0a 20 ib->pNext = p;.
122c0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
122d0 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a break;. }.
122e0 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 }. }.#endif
122f0 0a 20 20 2a 70 70 42 74 72 65 65 20 3d 20 70 3b . *ppBtree = p;
12300 0a 0a 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 ..btree_open_out
12310 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 :. if( rc!=SQLI
12320 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 TE_OK ){. if(
12330 20 70 42 74 20 26 26 20 70 42 74 2d 3e 70 50 61 pBt && pBt->pPa
12340 67 65 72 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ger ){. sql
12350 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 28 70 ite3PagerClose(p
12360 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 Bt->pPager);.
12370 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 }. sqlite3_f
12380 72 65 65 28 70 42 74 29 3b 0a 20 20 20 20 73 71 ree(pBt);. sq
12390 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 lite3_free(p);.
123a0 20 20 20 2a 70 70 42 74 72 65 65 20 3d 20 30 3b *ppBtree = 0;
123b0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a . }else{. /*
123c0 20 49 66 20 74 68 65 20 42 2d 54 72 65 65 20 77 If the B-Tree w
123d0 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 as successfully
123e0 6f 70 65 6e 65 64 2c 20 73 65 74 20 74 68 65 20 opened, set the
123f0 70 61 67 65 72 2d 63 61 63 68 65 20 73 69 7a 65 pager-cache size
12400 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 to the. ** d
12410 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 45 78 efault value. Ex
12420 63 65 70 74 2c 20 77 68 65 6e 20 6f 70 65 6e 69 cept, when openi
12430 6e 67 20 6f 6e 20 61 6e 20 65 78 69 73 74 69 6e ng on an existin
12440 67 20 73 68 61 72 65 64 20 70 61 67 65 72 2d 63 g shared pager-c
12450 61 63 68 65 2c 0a 20 20 20 20 2a 2a 20 64 6f 20 ache,. ** do
12460 6e 6f 74 20 63 68 61 6e 67 65 20 74 68 65 20 70 not change the p
12470 61 67 65 72 2d 63 61 63 68 65 20 73 69 7a 65 2e ager-cache size.
12480 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
12490 73 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 sqlite3BtreeSche
124a0 6d 61 28 70 2c 20 30 2c 20 30 29 3d 3d 30 20 29 ma(p, 0, 0)==0 )
124b0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
124c0 61 67 65 72 53 65 74 43 61 63 68 65 73 69 7a 65 agerSetCachesize
124d0 28 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c (p->pBt->pPager,
124e0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
124f0 43 41 43 48 45 5f 53 49 5a 45 29 3b 0a 20 20 20 CACHE_SIZE);.
12500 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6d 75 74 }. }. if( mut
12510 65 78 4f 70 65 6e 20 29 7b 0a 20 20 20 20 61 73 exOpen ){. as
12520 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
12530 74 65 78 5f 68 65 6c 64 28 6d 75 74 65 78 4f 70 tex_held(mutexOp
12540 65 6e 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 en) );. sqlit
12550 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d e3_mutex_leave(m
12560 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 7d 0a 20 utexOpen);. }.
12570 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
12580 2a 0a 2a 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 *.** Decrement t
12590 68 65 20 42 74 53 68 61 72 65 64 2e 6e 52 65 66 he BtShared.nRef
125a0 20 63 6f 75 6e 74 65 72 2e 20 20 57 68 65 6e 20 counter. When
125b0 69 74 20 72 65 61 63 68 65 73 20 7a 65 72 6f 2c it reaches zero,
125c0 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 68 65 20 42 .** remove the B
125d0 74 53 68 61 72 65 64 20 73 74 72 75 63 74 75 72 tShared structur
125e0 65 20 66 72 6f 6d 20 74 68 65 20 73 68 61 72 69 e from the shari
125f0 6e 67 20 6c 69 73 74 2e 20 20 52 65 74 75 72 6e ng list. Return
12600 0a 2a 2a 20 74 72 75 65 20 69 66 20 74 68 65 20 .** true if the
12610 42 74 53 68 61 72 65 64 2e 6e 52 65 66 20 63 6f BtShared.nRef co
12620 75 6e 74 65 72 20 72 65 61 63 68 65 73 20 7a 65 unter reaches ze
12630 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 0a 2a 2a ro and return.**
12640 20 66 61 6c 73 65 20 69 66 20 69 74 20 69 73 20 false if it is
12650 73 74 69 6c 6c 20 70 6f 73 69 74 69 76 65 2e 0a still positive..
12660 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 */.static int re
12670 6d 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c moveFromSharingL
12680 69 73 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 ist(BtShared *pB
12690 74 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 t){.#ifndef SQLI
126a0 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
126b0 41 43 48 45 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 ACHE. MUTEX_LOG
126c0 49 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 IC( sqlite3_mute
126d0 78 20 2a 70 4d 61 73 74 65 72 3b 20 29 0a 20 20 x *pMaster; ).
126e0 42 74 53 68 61 72 65 64 20 2a 70 4c 69 73 74 3b BtShared *pList;
126f0 0a 20 20 69 6e 74 20 72 65 6d 6f 76 65 64 20 3d . int removed =
12700 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 0;.. assert( s
12710 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 qlite3_mutex_not
12720 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
12730 20 29 3b 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 );. MUTEX_LOGI
12740 43 28 20 70 4d 61 73 74 65 72 20 3d 20 73 71 6c C( pMaster = sql
12750 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 ite3MutexAlloc(S
12760 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
12770 49 43 5f 4d 41 53 54 45 52 29 3b 20 29 0a 20 20 IC_MASTER); ).
12780 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
12790 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 ter(pMaster);.
127a0 70 42 74 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 pBt->nRef--;. i
127b0 66 28 20 70 42 74 2d 3e 6e 52 65 66 3c 3d 30 20 f( pBt->nRef<=0
127c0 29 7b 0a 20 20 20 20 69 66 28 20 47 4c 4f 42 41 ){. if( GLOBA
127d0 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 L(BtShared*,sqli
127e0 74 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 te3SharedCacheLi
127f0 73 74 29 3d 3d 70 42 74 20 29 7b 0a 20 20 20 20 st)==pBt ){.
12800 20 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 GLOBAL(BtShare
12810 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 d*,sqlite3Shared
12820 43 61 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 CacheList) = pBt
12830 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c ->pNext;. }el
12840 73 65 7b 0a 20 20 20 20 20 20 70 4c 69 73 74 20 se{. pList
12850 3d 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 = GLOBAL(BtShare
12860 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 d*,sqlite3Shared
12870 43 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 CacheList);.
12880 20 20 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 while( ALWAYS(
12890 70 4c 69 73 74 29 20 26 26 20 70 4c 69 73 74 2d pList) && pList-
128a0 3e 70 4e 65 78 74 21 3d 70 42 74 20 29 7b 0a 20 >pNext!=pBt ){.
128b0 20 20 20 20 20 20 20 70 4c 69 73 74 3d 70 4c 69 pList=pLi
128c0 73 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 st->pNext;.
128d0 20 7d 0a 20 20 20 20 20 20 69 66 28 20 41 4c 57 }. if( ALW
128e0 41 59 53 28 70 4c 69 73 74 29 20 29 7b 0a 20 20 AYS(pList) ){.
128f0 20 20 20 20 20 20 70 4c 69 73 74 2d 3e 70 4e 65 pList->pNe
12900 78 74 20 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b xt = pBt->pNext;
12910 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
12920 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 54 48 if( SQLITE_TH
12930 52 45 41 44 53 41 46 45 20 29 7b 0a 20 20 20 20 READSAFE ){.
12940 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
12950 66 72 65 65 28 70 42 74 2d 3e 6d 75 74 65 78 29 free(pBt->mutex)
12960 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 6d 6f ;. }. remo
12970 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 ved = 1;. }. s
12980 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
12990 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72 ve(pMaster);. r
129a0 65 74 75 72 6e 20 72 65 6d 6f 76 65 64 3b 0a 23 eturn removed;.#
129b0 65 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 31 3b else. return 1;
129c0 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
129d0 20 4d 61 6b 65 20 73 75 72 65 20 70 42 74 2d 3e Make sure pBt->
129e0 70 54 6d 70 53 70 61 63 65 20 70 6f 69 6e 74 73 pTmpSpace points
129f0 20 74 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f to an allocatio
12a00 6e 20 6f 66 20 0a 2a 2a 20 4d 58 5f 43 45 4c 4c n of .** MX_CELL
12a10 5f 53 49 5a 45 28 70 42 74 29 20 62 79 74 65 73 _SIZE(pBt) bytes
12a20 20 77 69 74 68 20 61 20 34 2d 62 79 74 65 20 70 with a 4-byte p
12a30 72 65 66 69 78 20 66 6f 72 20 61 20 6c 65 66 74 refix for a left
12a40 2d 63 68 69 6c 64 0a 2a 2a 20 70 6f 69 6e 74 65 -child.** pointe
12a50 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 r..*/.static voi
12a60 64 20 61 6c 6c 6f 63 61 74 65 54 65 6d 70 53 70 d allocateTempSp
12a70 61 63 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 ace(BtShared *pB
12a80 74 29 7b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e t){. if( !pBt->
12a90 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 pTmpSpace ){.
12aa0 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
12ab0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c = sqlite3PageMal
12ac0 6c 6f 63 28 20 70 42 74 2d 3e 70 61 67 65 53 69 loc( pBt->pageSi
12ad0 7a 65 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 6e ze );.. /* On
12ae0 65 20 6f 66 20 74 68 65 20 75 73 65 73 20 6f 66 e of the uses of
12af0 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
12b00 69 73 20 74 6f 20 66 6f 72 6d 61 74 20 63 65 6c is to format cel
12b10 6c 73 20 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a ls before. **
12b20 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 6d 20 inserting them
12b30 69 6e 74 6f 20 61 20 6c 65 61 66 20 70 61 67 65 into a leaf page
12b40 20 28 66 75 6e 63 74 69 6f 6e 20 66 69 6c 6c 49 (function fillI
12b50 6e 43 65 6c 6c 28 29 29 2e 20 49 66 0a 20 20 20 nCell()). If.
12b60 20 2a 2a 20 61 20 63 65 6c 6c 20 69 73 20 6c 65 ** a cell is le
12b70 73 73 20 74 68 61 6e 20 34 20 62 79 74 65 73 20 ss than 4 bytes
12b80 69 6e 20 73 69 7a 65 2c 20 69 74 20 69 73 20 72 in size, it is r
12b90 6f 75 6e 64 65 64 20 75 70 20 74 6f 20 34 20 62 ounded up to 4 b
12ba0 79 74 65 73 0a 20 20 20 20 2a 2a 20 62 79 20 74 ytes. ** by t
12bb0 68 65 20 76 61 72 69 6f 75 73 20 72 6f 75 74 69 he various routi
12bc0 6e 65 73 20 74 68 61 74 20 6d 61 6e 69 70 75 6c nes that manipul
12bd0 61 74 65 20 62 69 6e 61 72 79 20 63 65 6c 6c 73 ate binary cells
12be0 2e 20 57 68 69 63 68 0a 20 20 20 20 2a 2a 20 63 . Which. ** c
12bf0 61 6e 20 6d 65 61 6e 20 74 68 61 74 20 66 69 6c an mean that fil
12c00 6c 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 20 69 lInCell() only i
12c10 6e 69 74 69 61 6c 69 7a 65 73 20 74 68 65 20 66 nitializes the f
12c20 69 72 73 74 20 32 20 6f 72 20 33 0a 20 20 20 20 irst 2 or 3.
12c30 2a 2a 20 62 79 74 65 73 20 6f 66 20 70 54 6d 70 ** bytes of pTmp
12c40 53 70 61 63 65 2c 20 62 75 74 20 74 68 61 74 20 Space, but that
12c50 74 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 the first 4 byte
12c60 73 20 61 72 65 20 63 6f 70 69 65 64 20 66 72 6f s are copied fro
12c70 6d 0a 20 20 20 20 2a 2a 20 69 74 20 69 6e 74 6f m. ** it into
12c80 20 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 a database page
12c90 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 63 . This is not ac
12ca0 74 75 61 6c 6c 79 20 61 20 70 72 6f 62 6c 65 6d tually a problem
12cb0 2c 20 62 75 74 20 69 74 0a 20 20 20 20 2a 2a 20 , but it. **
12cc0 64 6f 65 73 20 63 61 75 73 65 20 61 20 76 61 6c does cause a val
12cd0 67 72 69 6e 64 20 65 72 72 6f 72 20 77 68 65 6e grind error when
12ce0 20 74 68 65 20 31 20 6f 72 20 32 20 62 79 74 65 the 1 or 2 byte
12cf0 73 20 6f 66 20 75 6e 69 74 69 61 6c 69 7a 65 64 s of unitialized
12d00 20 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 69 73 . ** data is
12d10 20 70 61 73 73 65 64 20 74 6f 20 73 79 73 74 65 passed to syste
12d20 6d 20 63 61 6c 6c 20 77 72 69 74 65 28 29 2e 20 m call write().
12d30 53 6f 20 74 6f 20 61 76 6f 69 64 20 74 68 69 73 So to avoid this
12d40 20 65 72 72 6f 72 2c 0a 20 20 20 20 2a 2a 20 7a error,. ** z
12d50 65 72 6f 20 74 68 65 20 66 69 72 73 74 20 34 20 ero the first 4
12d60 62 79 74 65 73 20 6f 66 20 74 65 6d 70 20 73 70 bytes of temp sp
12d70 61 63 65 20 68 65 72 65 2e 0a 20 20 20 20 2a 2a ace here.. **
12d80 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 3a 20 20 50 . ** Also: P
12d90 72 6f 76 69 64 65 20 66 6f 75 72 20 62 79 74 65 rovide four byte
12da0 73 20 6f 66 20 69 6e 69 74 69 61 6c 69 7a 65 64 s of initialized
12db0 20 73 70 61 63 65 20 62 65 66 6f 72 65 20 74 68 space before th
12dc0 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e 6e 69 e. ** beginni
12dd0 6e 67 20 6f 66 20 70 54 6d 70 53 70 61 63 65 20 ng of pTmpSpace
12de0 61 73 20 61 6e 20 61 72 65 61 20 61 76 61 69 6c as an area avail
12df0 61 62 6c 65 20 74 6f 20 70 72 65 70 65 6e 64 20 able to prepend
12e00 74 68 65 0a 20 20 20 20 2a 2a 20 6c 65 66 74 2d the. ** left-
12e10 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 20 74 6f child pointer to
12e20 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f the beginning o
12e30 66 20 61 20 63 65 6c 6c 2e 0a 20 20 20 20 2a 2f f a cell.. */
12e40 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 70 54 . if( pBt->pT
12e50 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 20 20 mpSpace ){.
12e60 20 6d 65 6d 73 65 74 28 70 42 74 2d 3e 70 54 6d memset(pBt->pTm
12e70 70 53 70 61 63 65 2c 20 30 2c 20 38 29 3b 0a 20 pSpace, 0, 8);.
12e80 20 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 pBt->pTmpSp
12e90 61 63 65 20 2b 3d 20 34 3b 0a 20 20 20 20 7d 0a ace += 4;. }.
12ea0 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 }.}../*.** Fre
12eb0 65 20 74 68 65 20 70 42 74 2d 3e 70 54 6d 70 53 e the pBt->pTmpS
12ec0 70 61 63 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a pace allocation.
12ed0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 */.static void f
12ee0 72 65 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 reeTempSpace(BtS
12ef0 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 hared *pBt){. i
12f00 66 28 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 f( pBt->pTmpSpac
12f10 65 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e 70 54 e ){. pBt->pT
12f20 6d 70 53 70 61 63 65 20 2d 3d 20 34 3b 0a 20 20 mpSpace -= 4;.
12f30 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 sqlite3PageFre
12f40 65 28 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 e(pBt->pTmpSpace
12f50 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 );. pBt->pTmp
12f60 53 70 61 63 65 20 3d 20 30 3b 0a 20 20 7d 0a 7d Space = 0;. }.}
12f70 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e ../*.** Close an
12f80 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 61 open database a
12f90 6e 64 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c nd invalidate al
12fa0 6c 20 63 75 72 73 6f 72 73 2e 0a 2a 2f 0a 69 6e l cursors..*/.in
12fb0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c t sqlite3BtreeCl
12fc0 6f 73 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 ose(Btree *p){.
12fd0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
12fe0 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 43 75 72 p->pBt;. BtCur
12ff0 73 6f 72 20 2a 70 43 75 72 3b 0a 0a 20 20 2f 2a sor *pCur;.. /*
13000 20 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72 73 6f Close all curso
13010 72 73 20 6f 70 65 6e 65 64 20 76 69 61 20 74 68 rs opened via th
13020 69 73 20 68 61 6e 64 6c 65 2e 20 20 2a 2f 0a 20 is handle. */.
13030 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
13040 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 _mutex_held(p->d
13050 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
13060 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
13070 28 70 29 3b 0a 20 20 70 43 75 72 20 3d 20 70 42 (p);. pCur = pB
13080 74 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 20 77 68 t->pCursor;. wh
13090 69 6c 65 28 20 70 43 75 72 20 29 7b 0a 20 20 20 ile( pCur ){.
130a0 20 42 74 43 75 72 73 6f 72 20 2a 70 54 6d 70 20 BtCursor *pTmp
130b0 3d 20 70 43 75 72 3b 0a 20 20 20 20 70 43 75 72 = pCur;. pCur
130c0 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a = pCur->pNext;.
130d0 20 20 20 20 69 66 28 20 70 54 6d 70 2d 3e 70 42 if( pTmp->pB
130e0 74 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 tree==p ){.
130f0 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f sqlite3BtreeClo
13100 73 65 43 75 72 73 6f 72 28 70 54 6d 70 29 3b 0a seCursor(pTmp);.
13110 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
13120 52 6f 6c 6c 62 61 63 6b 20 61 6e 79 20 61 63 74 Rollback any act
13130 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ive transaction
13140 61 6e 64 20 66 72 65 65 20 74 68 65 20 68 61 6e and free the han
13150 64 6c 65 20 73 74 72 75 63 74 75 72 65 2e 0a 20 dle structure..
13160 20 2a 2a 20 54 68 65 20 63 61 6c 6c 20 74 6f 20 ** The call to
13170 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c sqlite3BtreeRoll
13180 62 61 63 6b 28 29 20 64 72 6f 70 73 20 61 6e 79 back() drops any
13190 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 68 65 6c table-locks hel
131a0 64 20 62 79 0a 20 20 2a 2a 20 74 68 69 73 20 68 d by. ** this h
131b0 61 6e 64 6c 65 2e 0a 20 20 2a 2f 0a 20 20 73 71 andle.. */. sq
131c0 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 lite3BtreeRollba
131d0 63 6b 28 70 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c ck(p, SQLITE_OK,
131e0 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 0);. sqlite3Bt
131f0 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 0a 20 20 reeLeave(p);..
13200 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 /* If there are
13210 73 74 69 6c 6c 20 6f 74 68 65 72 20 6f 75 74 73 still other outs
13220 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 tanding referenc
13230 65 73 20 74 6f 20 74 68 65 20 73 68 61 72 65 64 es to the shared
13240 2d 62 74 72 65 65 0a 20 20 2a 2a 20 73 74 72 75 -btree. ** stru
13250 63 74 75 72 65 2c 20 72 65 74 75 72 6e 20 6e 6f cture, return no
13260 77 2e 20 54 68 65 20 72 65 6d 61 69 6e 64 65 72 w. The remainder
13270 20 6f 66 20 74 68 69 73 20 70 72 6f 63 65 64 75 of this procedu
13280 72 65 20 63 6c 65 61 6e 73 20 0a 20 20 2a 2a 20 re cleans . **
13290 75 70 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 up the shared-bt
132a0 72 65 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ree.. */. asse
132b0 72 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 rt( p->wantToLoc
132c0 6b 3d 3d 30 20 26 26 20 70 2d 3e 6c 6f 63 6b 65 k==0 && p->locke
132d0 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 21 70 d==0 );. if( !p
132e0 2d 3e 73 68 61 72 61 62 6c 65 20 7c 7c 20 72 65 ->sharable || re
132f0 6d 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c moveFromSharingL
13300 69 73 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 ist(pBt) ){.
13310 2f 2a 20 54 68 65 20 70 42 74 20 69 73 20 6e 6f /* The pBt is no
13320 20 6c 6f 6e 67 65 72 20 6f 6e 20 74 68 65 20 73 longer on the s
13330 68 61 72 69 6e 67 20 6c 69 73 74 2c 20 73 6f 20 haring list, so
13340 77 65 20 63 61 6e 20 61 63 63 65 73 73 0a 20 20 we can access.
13350 20 20 2a 2a 20 69 74 20 77 69 74 68 6f 75 74 20 ** it without
13360 68 61 76 69 6e 67 20 74 6f 20 68 6f 6c 64 20 74 having to hold t
13370 68 65 20 6d 75 74 65 78 2e 0a 20 20 20 20 2a 2a he mutex.. **
13380 0a 20 20 20 20 2a 2a 20 43 6c 65 61 6e 20 6f 75 . ** Clean ou
13390 74 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 t and delete the
133a0 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 BtShared object
133b0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 .. */. ass
133c0 65 72 74 28 20 21 70 42 74 2d 3e 70 43 75 72 73 ert( !pBt->pCurs
133d0 6f 72 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 or );. sqlite
133e0 33 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3PagerClose(pBt-
133f0 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 >pPager);. if
13400 28 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 ( pBt->xFreeSche
13410 6d 61 20 26 26 20 70 42 74 2d 3e 70 53 63 68 65 ma && pBt->pSche
13420 6d 61 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d ma ){. pBt-
13430 3e 78 46 72 65 65 53 63 68 65 6d 61 28 70 42 74 >xFreeSchema(pBt
13440 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 ->pSchema);.
13450 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 }. sqlite3DbF
13460 72 65 65 28 30 2c 20 70 42 74 2d 3e 70 53 63 68 ree(0, pBt->pSch
13470 65 6d 61 29 3b 0a 20 20 20 20 66 72 65 65 54 65 ema);. freeTe
13480 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 mpSpace(pBt);.
13490 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
134a0 42 74 29 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 Bt);. }..#ifnde
134b0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 f SQLITE_OMIT_SH
134c0 41 52 45 44 5f 43 41 43 48 45 0a 20 20 61 73 73 ARED_CACHE. ass
134d0 65 72 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f ert( p->wantToLo
134e0 63 6b 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ck==0 );. asser
134f0 74 28 20 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 t( p->locked==0
13500 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 );. if( p->pPre
13510 76 20 29 20 70 2d 3e 70 50 72 65 76 2d 3e 70 4e v ) p->pPrev->pN
13520 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a ext = p->pNext;.
13530 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 if( p->pNext )
13540 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 p->pNext->pPrev
13550 20 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 23 65 6e = p->pPrev;.#en
13560 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 dif.. sqlite3_f
13570 72 65 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ree(p);. return
13580 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
13590 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
135a0 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d limit on the num
135b0 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c ber of pages all
135c0 6f 77 65 64 20 69 6e 20 74 68 65 20 63 61 63 68 owed in the cach
135d0 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 78 e..**.** The max
135e0 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 63 imum number of c
135f0 61 63 68 65 20 70 61 67 65 73 20 69 73 20 73 65 ache pages is se
13600 74 20 74 6f 20 74 68 65 20 61 62 73 6f 6c 75 74 t to the absolut
13610 65 0a 2a 2a 20 76 61 6c 75 65 20 6f 66 20 6d 78 e.** value of mx
13620 50 61 67 65 2e 20 20 49 66 20 6d 78 50 61 67 65 Page. If mxPage
13630 20 69 73 20 6e 65 67 61 74 69 76 65 2c 20 74 68 is negative, th
13640 65 20 70 61 67 65 72 20 77 69 6c 6c 0a 2a 2a 20 e pager will.**
13650 6f 70 65 72 61 74 65 20 61 73 79 6e 63 68 72 6f operate asynchro
13660 6e 6f 75 73 6c 79 20 2d 20 69 74 20 77 69 6c 6c nously - it will
13670 20 6e 6f 74 20 73 74 6f 70 20 74 6f 20 64 6f 20 not stop to do
13680 66 73 79 6e 63 28 29 73 0a 2a 2a 20 74 6f 20 69 fsync()s.** to i
13690 6e 73 75 72 65 20 64 61 74 61 20 69 73 20 77 72 nsure data is wr
136a0 69 74 74 65 6e 20 74 6f 20 74 68 65 20 64 69 73 itten to the dis
136b0 6b 20 73 75 72 66 61 63 65 20 62 65 66 6f 72 65 k surface before
136c0 0a 2a 2a 20 63 6f 6e 74 69 6e 75 69 6e 67 2e 20 .** continuing.
136d0 20 54 72 61 6e 73 61 63 74 69 6f 6e 73 20 73 74 Transactions st
136e0 69 6c 6c 20 77 6f 72 6b 20 69 66 20 73 79 6e 63 ill work if sync
136f0 68 72 6f 6e 6f 75 73 20 69 73 20 6f 66 66 2c 0a hronous is off,.
13700 2a 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 ** and the datab
13710 61 73 65 20 63 61 6e 6e 6f 74 20 62 65 20 63 6f ase cannot be co
13720 72 72 75 70 74 65 64 20 69 66 20 74 68 69 73 20 rrupted if this
13730 70 72 6f 67 72 61 6d 0a 2a 2a 20 63 72 61 73 68 program.** crash
13740 65 73 2e 20 20 42 75 74 20 69 66 20 74 68 65 20 es. But if the
13750 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d operating system
13760 20 63 72 61 73 68 65 73 20 6f 72 20 74 68 65 72 crashes or ther
13770 65 20 69 73 0a 2a 2a 20 61 6e 20 61 62 72 75 70 e is.** an abrup
13780 74 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 t power failure
13790 77 68 65 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73 when synchronous
137a0 20 69 73 20 6f 66 66 2c 20 74 68 65 20 64 61 74 is off, the dat
137b0 61 62 61 73 65 0a 2a 2a 20 63 6f 75 6c 64 20 62 abase.** could b
137c0 65 20 6c 65 66 74 20 69 6e 20 61 6e 20 69 6e 63 e left in an inc
137d0 6f 6e 73 69 73 74 65 6e 74 20 61 6e 64 20 75 6e onsistent and un
137e0 72 65 63 6f 76 65 72 61 62 6c 65 20 73 74 61 74 recoverable stat
137f0 65 2e 0a 2a 2a 20 53 79 6e 63 68 72 6f 6e 6f 75 e..** Synchronou
13800 73 20 69 73 20 6f 6e 20 62 79 20 64 65 66 61 75 s is on by defau
13810 6c 74 20 73 6f 20 64 61 74 61 62 61 73 65 20 63 lt so database c
13820 6f 72 72 75 70 74 69 6f 6e 20 69 73 20 6e 6f 74 orruption is not
13830 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c 79 20 61 20 77 .** normally a w
13840 6f 72 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c orry..*/.int sql
13850 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63 68 ite3BtreeSetCach
13860 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 eSize(Btree *p,
13870 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 int mxPage){. B
13880 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
13890 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 ->pBt;. assert(
138a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
138b0 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
138c0 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ) );. sqlite3Bt
138d0 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 reeEnter(p);. s
138e0 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 61 qlite3PagerSetCa
138f0 63 68 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 chesize(pBt->pPa
13900 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 ger, mxPage);.
13910 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
13920 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 e(p);. return S
13930 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
13940 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
13950 5f 53 49 5a 45 3e 30 0a 2f 2a 0a 2a 2a 20 43 68 _SIZE>0./*.** Ch
13960 61 6e 67 65 20 74 68 65 20 6c 69 6d 69 74 20 6f ange the limit o
13970 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 n the amount of
13980 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
13990 65 20 74 68 61 74 20 6d 61 79 20 62 65 0a 2a 2a e that may be.**
139a0 20 6d 65 6d 6f 72 79 20 6d 61 70 70 65 64 2e 0a memory mapped..
139b0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
139c0 72 65 65 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 reeSetMmapLimit(
139d0 42 74 72 65 65 20 2a 70 2c 20 73 71 6c 69 74 65 Btree *p, sqlite
139e0 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 29 7b 3_int64 szMmap){
139f0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
13a00 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 = p->pBt;. ass
13a10 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
13a20 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d ex_held(p->db->m
13a30 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 utex) );. sqlit
13a40 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
13a50 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 . sqlite3PagerS
13a60 65 74 4d 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d etMmapLimit(pBt-
13a70 3e 70 50 61 67 65 72 2c 20 73 7a 4d 6d 61 70 29 >pPager, szMmap)
13a80 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
13a90 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
13aa0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
13ab0 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
13ac0 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 _MAX_MMAP_SIZE>0
13ad0 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 */../*.** Chang
13ae0 65 20 74 68 65 20 77 61 79 20 64 61 74 61 20 69 e the way data i
13af0 73 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b s synced to disk
13b00 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e 63 in order to inc
13b10 72 65 61 73 65 20 6f 72 20 64 65 63 72 65 61 73 rease or decreas
13b20 65 0a 2a 2a 20 68 6f 77 20 77 65 6c 6c 20 74 68 e.** how well th
13b30 65 20 64 61 74 61 62 61 73 65 20 72 65 73 69 73 e database resis
13b40 74 73 20 64 61 6d 61 67 65 20 64 75 65 20 74 6f ts damage due to
13b50 20 4f 53 20 63 72 61 73 68 65 73 20 61 6e 64 20 OS crashes and
13b60 70 6f 77 65 72 0a 2a 2a 20 66 61 69 6c 75 72 65 power.** failure
13b70 73 2e 20 20 4c 65 76 65 6c 20 31 20 69 73 20 74 s. Level 1 is t
13b80 68 65 20 73 61 6d 65 20 61 73 20 61 73 79 6e 63 he same as async
13b90 68 72 6f 6e 6f 75 73 20 28 6e 6f 20 73 79 6e 63 hronous (no sync
13ba0 73 28 29 20 6f 63 63 75 72 20 61 6e 64 0a 2a 2a s() occur and.**
13bb0 20 74 68 65 72 65 20 69 73 20 61 20 68 69 67 68 there is a high
13bc0 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 probability of
13bd0 64 61 6d 61 67 65 29 20 20 4c 65 76 65 6c 20 32 damage) Level 2
13be0 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e is the default.
13bf0 20 20 54 68 65 72 65 0a 2a 2a 20 69 73 20 61 20 There.** is a
13c00 76 65 72 79 20 6c 6f 77 20 62 75 74 20 6e 6f 6e very low but non
13c10 2d 7a 65 72 6f 20 70 72 6f 62 61 62 69 6c 69 74 -zero probabilit
13c20 79 20 6f 66 20 64 61 6d 61 67 65 2e 20 20 4c 65 y of damage. Le
13c30 76 65 6c 20 33 20 72 65 64 75 63 65 73 20 74 68 vel 3 reduces th
13c40 65 0a 2a 2a 20 70 72 6f 62 61 62 69 6c 69 74 79 e.** probability
13c50 20 6f 66 20 64 61 6d 61 67 65 20 74 6f 20 6e 65 of damage to ne
13c60 61 72 20 7a 65 72 6f 20 62 75 74 20 77 69 74 68 ar zero but with
13c70 20 61 20 77 72 69 74 65 20 70 65 72 66 6f 72 6d a write perform
13c80 61 6e 63 65 20 72 65 64 75 63 74 69 6f 6e 2e 0a ance reduction..
13c90 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
13ca0 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 E_OMIT_PAGER_PRA
13cb0 47 4d 41 53 0a 69 6e 74 20 73 71 6c 69 74 65 33 GMAS.int sqlite3
13cc0 42 74 72 65 65 53 65 74 50 61 67 65 72 46 6c 61 BtreeSetPagerFla
13cd0 67 73 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 gs(. Btree *p,
13ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
13cf0 54 68 65 20 62 74 72 65 65 20 74 6f 20 73 65 74 The btree to set
13d00 20 74 68 65 20 73 61 66 65 74 79 20 6c 65 76 65 the safety leve
13d10 6c 20 6f 6e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e l on */. unsign
13d20 65 64 20 70 67 46 6c 61 67 73 20 20 20 20 20 20 ed pgFlags
13d30 20 2f 2a 20 56 61 72 69 6f 75 73 20 50 41 47 45 /* Various PAGE
13d40 52 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 29 7b 0a R_* flags */.){.
13d50 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
13d60 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 = p->pBt;. asse
13d70 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
13d80 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 x_held(p->db->mu
13d90 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
13da0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
13db0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 sqlite3PagerSe
13dc0 74 46 6c 61 67 73 28 70 42 74 2d 3e 70 50 61 67 tFlags(pBt->pPag
13dd0 65 72 2c 20 70 67 46 6c 61 67 73 29 3b 0a 20 20 er, pgFlags);.
13de0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
13df0 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 e(p);. return S
13e00 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
13e10 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e if../*.** Return
13e20 20 54 52 55 45 20 69 66 20 74 68 65 20 67 69 76 TRUE if the giv
13e30 65 6e 20 62 74 72 65 65 20 69 73 20 73 65 74 20 en btree is set
13e40 74 6f 20 73 61 66 65 74 79 20 6c 65 76 65 6c 20 to safety level
13e50 31 2e 20 20 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 1. In other.**
13e60 77 6f 72 64 73 2c 20 72 65 74 75 72 6e 20 54 52 words, return TR
13e70 55 45 20 69 66 20 6e 6f 20 73 79 6e 63 28 29 20 UE if no sync()
13e80 6f 63 63 75 72 73 20 6f 6e 20 74 68 65 20 64 69 occurs on the di
13e90 73 6b 20 66 69 6c 65 73 2e 0a 2a 2f 0a 69 6e 74 sk files..*/.int
13ea0 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e sqlite3BtreeSyn
13eb0 63 44 69 73 61 62 6c 65 64 28 42 74 72 65 65 20 cDisabled(Btree
13ec0 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 *p){. BtShared
13ed0 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
13ee0 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 int rc;. asser
13ef0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
13f00 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 _held(p->db->mut
13f10 65 78 29 20 29 3b 20 20 0a 20 20 73 71 6c 69 74 ex) ); . sqlit
13f20 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
13f30 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 20 26 . assert( pBt &
13f40 26 20 70 42 74 2d 3e 70 50 61 67 65 72 20 29 3b & pBt->pPager );
13f50 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
13f60 61 67 65 72 4e 6f 73 79 6e 63 28 70 42 74 2d 3e agerNosync(pBt->
13f70 70 50 61 67 65 72 29 3b 0a 20 20 73 71 6c 69 74 pPager);. sqlit
13f80 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
13f90 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
13fa0 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 ./*.** Change th
13fb0 65 20 64 65 66 61 75 6c 74 20 70 61 67 65 73 20 e default pages
13fc0 73 69 7a 65 20 61 6e 64 20 74 68 65 20 6e 75 6d size and the num
13fd0 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 ber of reserved
13fe0 62 79 74 65 73 20 70 65 72 20 70 61 67 65 2e 0a bytes per page..
13ff0 2a 2a 20 4f 72 2c 20 69 66 20 74 68 65 20 70 61 ** Or, if the pa
14000 67 65 20 73 69 7a 65 20 68 61 73 20 61 6c 72 65 ge size has alre
14010 61 64 79 20 62 65 65 6e 20 66 69 78 65 64 2c 20 ady been fixed,
14020 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 return SQLITE_RE
14030 41 44 4f 4e 4c 59 20 0a 2a 2a 20 77 69 74 68 6f ADONLY .** witho
14040 75 74 20 63 68 61 6e 67 69 6e 67 20 61 6e 79 74 ut changing anyt
14050 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 hing..**.** The
14060 70 61 67 65 20 73 69 7a 65 20 6d 75 73 74 20 62 page size must b
14070 65 20 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62 e a power of 2 b
14080 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 etween 512 and 6
14090 35 35 33 36 2e 20 20 49 66 20 74 68 65 20 70 61 5536. If the pa
140a0 67 65 0a 2a 2a 20 73 69 7a 65 20 73 75 70 70 6c ge.** size suppl
140b0 69 65 64 20 64 6f 65 73 20 6e 6f 74 20 6d 65 65 ied does not mee
140c0 74 20 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e t this constrain
140d0 74 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 t then the page
140e0 73 69 7a 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 63 size is not.** c
140f0 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 hanged..**.** Pa
14100 67 65 20 73 69 7a 65 73 20 61 72 65 20 63 6f 6e ge sizes are con
14110 73 74 72 61 69 6e 65 64 20 74 6f 20 62 65 20 61 strained to be a
14120 20 70 6f 77 65 72 20 6f 66 20 74 77 6f 20 73 6f power of two so
14130 20 74 68 61 74 20 74 68 65 20 72 65 67 69 6f 6e that the region
14140 0a 2a 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 .** of the datab
14150 61 73 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f ase file used fo
14160 72 20 6c 6f 63 6b 69 6e 67 20 28 62 65 67 69 6e r locking (begin
14170 6e 69 6e 67 20 61 74 20 50 45 4e 44 49 4e 47 5f ning at PENDING_
14180 42 59 54 45 2c 0a 2a 2a 20 74 68 65 20 66 69 72 BYTE,.** the fir
14190 73 74 20 62 79 74 65 20 70 61 73 74 20 74 68 65 st byte past the
141a0 20 31 47 42 20 62 6f 75 6e 64 61 72 79 2c 20 30 1GB boundary, 0
141b0 78 34 30 30 30 30 30 30 30 29 20 6e 65 65 64 73 x40000000) needs
141c0 20 74 6f 20 6f 63 63 75 72 0a 2a 2a 20 61 74 20 to occur.** at
141d0 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 the beginning of
141e0 20 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 a page..**.** I
141f0 66 20 70 61 72 61 6d 65 74 65 72 20 6e 52 65 73 f parameter nRes
14200 65 72 76 65 20 69 73 20 6c 65 73 73 20 74 68 61 erve is less tha
14210 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 n zero, then the
14220 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 number of reser
14230 76 65 64 0a 2a 2a 20 62 79 74 65 73 20 70 65 72 ved.** bytes per
14240 20 70 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e page is left un
14250 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 changed..**.** I
14260 66 20 74 68 65 20 69 46 69 78 21 3d 30 20 74 68 f the iFix!=0 th
14270 65 6e 20 74 68 65 20 42 54 53 5f 50 41 47 45 53 en the BTS_PAGES
14280 49 5a 45 5f 46 49 58 45 44 20 66 6c 61 67 20 69 IZE_FIXED flag i
14290 73 20 73 65 74 20 73 6f 20 74 68 61 74 20 74 68 s set so that th
142a0 65 20 70 61 67 65 20 73 69 7a 65 0a 2a 2a 20 61 e page size.** a
142b0 6e 64 20 61 75 74 6f 76 61 63 75 75 6d 20 6d 6f nd autovacuum mo
142c0 64 65 20 63 61 6e 20 6e 6f 20 6c 6f 6e 67 65 72 de can no longer
142d0 20 62 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a be changed..*/.
142e0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
142f0 53 65 74 50 61 67 65 53 69 7a 65 28 42 74 72 65 SetPageSize(Btre
14300 65 20 2a 70 2c 20 69 6e 74 20 70 61 67 65 53 69 e *p, int pageSi
14310 7a 65 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 ze, int nReserve
14320 2c 20 69 6e 74 20 69 46 69 78 29 7b 0a 20 20 69 , int iFix){. i
14330 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
14340 4b 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 K;. BtShared *p
14350 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 Bt = p->pBt;. a
14360 73 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e ssert( nReserve>
14370 3d 2d 31 20 26 26 20 6e 52 65 73 65 72 76 65 3c =-1 && nReserve<
14380 3d 32 35 35 20 29 3b 0a 20 20 73 71 6c 69 74 65 =255 );. sqlite
14390 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
143a0 20 20 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c if( pBt->btsFl
143b0 61 67 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 ags & BTS_PAGESI
143c0 5a 45 5f 46 49 58 45 44 20 29 7b 0a 20 20 20 20 ZE_FIXED ){.
143d0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
143e0 65 28 70 29 3b 0a 20 20 20 20 72 65 74 75 72 6e e(p);. return
143f0 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
14400 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 52 65 73 ;. }. if( nRes
14410 65 72 76 65 3c 30 20 29 7b 0a 20 20 20 20 6e 52 erve<0 ){. nR
14420 65 73 65 72 76 65 20 3d 20 70 42 74 2d 3e 70 61 eserve = pBt->pa
14430 67 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 geSize - pBt->us
14440 61 62 6c 65 53 69 7a 65 3b 0a 20 20 7d 0a 20 20 ableSize;. }.
14450 61 73 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 assert( nReserve
14460 3e 3d 30 20 26 26 20 6e 52 65 73 65 72 76 65 3c >=0 && nReserve<
14470 3d 32 35 35 20 29 3b 0a 20 20 69 66 28 20 70 61 =255 );. if( pa
14480 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 geSize>=512 && p
14490 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 54 45 5f ageSize<=SQLITE_
144a0 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 26 26 MAX_PAGE_SIZE &&
144b0 0a 20 20 20 20 20 20 20 20 28 28 70 61 67 65 53 . ((pageS
144c0 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 ize-1)&pageSize)
144d0 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ==0 ){. asser
144e0 74 28 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 t( (pageSize & 7
144f0 29 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 )==0 );. asse
14500 72 74 28 20 21 70 42 74 2d 3e 70 50 61 67 65 31 rt( !pBt->pPage1
14510 20 26 26 20 21 70 42 74 2d 3e 70 43 75 72 73 6f && !pBt->pCurso
14520 72 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 61 r );. pBt->pa
14530 67 65 53 69 7a 65 20 3d 20 28 75 33 32 29 70 61 geSize = (u32)pa
14540 67 65 53 69 7a 65 3b 0a 20 20 20 20 66 72 65 65 geSize;. free
14550 54 65 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a TempSpace(pBt);.
14560 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
14570 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 e3PagerSetPagesi
14580 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 ze(pBt->pPager,
14590 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 &pBt->pageSize,
145a0 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 70 42 74 nReserve);. pBt
145b0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 ->usableSize = p
145c0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 28 Bt->pageSize - (
145d0 75 31 36 29 6e 52 65 73 65 72 76 65 3b 0a 20 20 u16)nReserve;.
145e0 69 66 28 20 69 46 69 78 20 29 20 70 42 74 2d 3e if( iFix ) pBt->
145f0 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
14600 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a PAGESIZE_FIXED;.
14610 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
14620 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
14630 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
14640 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 turn the current
14650 6c 79 20 64 65 66 69 6e 65 64 20 70 61 67 65 20 ly defined page
14660 73 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 size.*/.int sqli
14670 74 65 33 42 74 72 65 65 47 65 74 50 61 67 65 53 te3BtreeGetPageS
14680 69 7a 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 ize(Btree *p){.
14690 20 72 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e return p->pBt->
146a0 70 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a 23 69 66 pageSize;.}..#if
146b0 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
146c0 48 41 53 5f 43 4f 44 45 43 29 20 7c 7c 20 64 65 HAS_CODEC) || de
146d0 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 fined(SQLITE_DEB
146e0 55 47 29 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 UG)./*.** This f
146f0 75 6e 63 74 69 6f 6e 20 69 73 20 73 69 6d 69 6c unction is simil
14700 61 72 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 ar to sqlite3Btr
14710 65 65 47 65 74 52 65 73 65 72 76 65 28 29 2c 20 eeGetReserve(),
14720 65 78 63 65 70 74 20 74 68 61 74 20 69 74 0a 2a except that it.*
14730 2a 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 * may only be ca
14740 6c 6c 65 64 20 69 66 20 69 74 20 69 73 20 67 75 lled if it is gu
14750 61 72 61 6e 74 65 65 64 20 74 68 61 74 20 74 68 aranteed that th
14760 65 20 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 e b-tree mutex i
14770 73 20 61 6c 72 65 61 64 79 0a 2a 2a 20 68 65 6c s already.** hel
14780 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 d..**.** This is
14790 20 75 73 65 66 75 6c 20 69 6e 20 6f 6e 65 20 73 useful in one s
147a0 70 65 63 69 61 6c 20 63 61 73 65 20 69 6e 20 74 pecial case in t
147b0 68 65 20 62 61 63 6b 75 70 20 41 50 49 20 63 6f he backup API co
147c0 64 65 20 77 68 65 72 65 20 69 74 20 69 73 0a 2a de where it is.*
147d0 2a 20 6b 6e 6f 77 6e 20 74 68 61 74 20 74 68 65 * known that the
147e0 20 73 68 61 72 65 64 20 62 2d 74 72 65 65 20 6d shared b-tree m
147f0 75 74 65 78 20 69 73 20 68 65 6c 64 2c 20 62 75 utex is held, bu
14800 74 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 74 t the mutex on t
14810 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 he .** database
14820 68 61 6e 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 handle that owns
14830 20 2a 70 20 69 73 20 6e 6f 74 2e 20 49 6e 20 74 *p is not. In t
14840 68 69 73 20 63 61 73 65 20 69 66 20 73 71 6c 69 his case if sqli
14850 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 29 0a te3BtreeEnter().
14860 2a 2a 20 77 65 72 65 20 74 6f 20 62 65 20 63 61 ** were to be ca
14870 6c 6c 65 64 2c 20 69 74 20 6d 69 67 68 74 20 63 lled, it might c
14880 6f 6c 6c 69 64 65 20 77 69 74 68 20 73 6f 6d 65 ollide with some
14890 20 6f 74 68 65 72 20 6f 70 65 72 61 74 69 6f 6e other operation
148a0 20 6f 6e 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 on the.** datab
148b0 61 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 ase handle that
148c0 6f 77 6e 73 20 2a 70 2c 20 63 61 75 73 69 6e 67 owns *p, causing
148d0 20 75 6e 64 65 66 69 6e 65 64 20 62 65 68 61 76 undefined behav
148e0 69 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ior..*/.int sqli
148f0 74 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 te3BtreeGetReser
14900 76 65 4e 6f 4d 75 74 65 78 28 42 74 72 65 65 20 veNoMutex(Btree
14910 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 *p){. assert( s
14920 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
14930 64 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 d(p->pBt->mutex)
14940 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e );. return p->
14950 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 pBt->pageSize -
14960 70 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 p->pBt->usableSi
14970 7a 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 ze;.}.#endif /*
14980 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 SQLITE_HAS_CODEC
14990 20 7c 7c 20 53 51 4c 49 54 45 5f 44 45 42 55 47 || SQLITE_DEBUG
149a0 20 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 */..#if !define
149b0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 d(SQLITE_OMIT_PA
149c0 47 45 52 5f 50 52 41 47 4d 41 53 29 20 7c 7c 20 GER_PRAGMAS) ||
149d0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
149e0 4f 4d 49 54 5f 56 41 43 55 55 4d 29 0a 2f 2a 0a OMIT_VACUUM)./*.
149f0 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 ** Return the nu
14a00 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 mber of bytes of
14a10 20 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e space at the en
14a20 64 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 20 d of every page
14a30 74 68 61 74 0a 2a 2a 20 61 72 65 20 69 6e 74 65 that.** are inte
14a40 6e 74 75 61 6c 6c 79 20 6c 65 66 74 20 75 6e 75 ntually left unu
14a50 73 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 sed. This is th
14a60 65 20 22 72 65 73 65 72 76 65 64 22 20 73 70 61 e "reserved" spa
14a70 63 65 20 74 68 61 74 20 69 73 0a 2a 2a 20 73 6f ce that is.** so
14a80 6d 65 74 69 6d 65 73 20 75 73 65 64 20 62 79 20 metimes used by
14a90 65 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a 2f 0a 69 extensions..*/.i
14aa0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 nt sqlite3BtreeG
14ab0 65 74 52 65 73 65 72 76 65 28 42 74 72 65 65 20 etReserve(Btree
14ac0 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 *p){. int n;.
14ad0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
14ae0 72 28 70 29 3b 0a 20 20 6e 20 3d 20 70 2d 3e 70 r(p);. n = p->p
14af0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 Bt->pageSize - p
14b00 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
14b10 65 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 e;. sqlite3Btre
14b20 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
14b30 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn n;.}../*.**
14b40 53 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 Set the maximum
14b50 70 61 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 page count for a
14b60 20 64 61 74 61 62 61 73 65 20 69 66 20 6d 78 50 database if mxP
14b70 61 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 2e age is positive.
14b80 0a 2a 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 61 .** No changes a
14b90 72 65 20 6d 61 64 65 20 69 66 20 6d 78 50 61 67 re made if mxPag
14ba0 65 20 69 73 20 30 20 6f 72 20 6e 65 67 61 74 69 e is 0 or negati
14bb0 76 65 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 ve..** Regardles
14bc0 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f s of the value o
14bd0 66 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 6e f mxPage, return
14be0 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 the maximum pag
14bf0 65 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 e count..*/.int
14c00 73 71 6c 69 74 65 33 42 74 72 65 65 4d 61 78 50 sqlite3BtreeMaxP
14c10 61 67 65 43 6f 75 6e 74 28 42 74 72 65 65 20 2a ageCount(Btree *
14c20 70 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a p, int mxPage){.
14c30 20 20 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 int n;. sqlit
14c40 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
14c50 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 61 . n = sqlite3Pa
14c60 67 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 gerMaxPageCount(
14c70 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 p->pBt->pPager,
14c80 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 mxPage);. sqlit
14c90 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
14ca0 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a . return n;.}..
14cb0 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 42 54 /*.** Set the BT
14cc0 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 S_SECURE_DELETE
14cd0 66 6c 61 67 20 69 66 20 6e 65 77 46 6c 61 67 20 flag if newFlag
14ce0 69 73 20 30 20 6f 72 20 31 2e 20 20 49 66 20 6e is 0 or 1. If n
14cf0 65 77 46 6c 61 67 20 69 73 20 2d 31 2c 0a 2a 2a ewFlag is -1,.**
14d00 20 74 68 65 6e 20 6d 61 6b 65 20 6e 6f 20 63 68 then make no ch
14d10 61 6e 67 65 73 2e 20 20 41 6c 77 61 79 73 20 72 anges. Always r
14d20 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 eturn the value
14d30 6f 66 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 of the BTS_SECUR
14d40 45 5f 44 45 4c 45 54 45 0a 2a 2a 20 73 65 74 74 E_DELETE.** sett
14d50 69 6e 67 20 61 66 74 65 72 20 74 68 65 20 63 68 ing after the ch
14d60 61 6e 67 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ange..*/.int sql
14d70 69 74 65 33 42 74 72 65 65 53 65 63 75 72 65 44 ite3BtreeSecureD
14d80 65 6c 65 74 65 28 42 74 72 65 65 20 2a 70 2c 20 elete(Btree *p,
14d90 69 6e 74 20 6e 65 77 46 6c 61 67 29 7b 0a 20 20 int newFlag){.
14da0 69 6e 74 20 62 3b 0a 20 20 69 66 28 20 70 3d 3d int b;. if( p==
14db0 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
14dc0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
14dd0 72 28 70 29 3b 0a 20 20 69 66 28 20 6e 65 77 46 r(p);. if( newF
14de0 6c 61 67 3e 3d 30 20 29 7b 0a 20 20 20 20 70 2d lag>=0 ){. p-
14df0 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 >pBt->btsFlags &
14e00 3d 20 7e 42 54 53 5f 53 45 43 55 52 45 5f 44 45 = ~BTS_SECURE_DE
14e10 4c 45 54 45 3b 0a 20 20 20 20 69 66 28 20 6e 65 LETE;. if( ne
14e20 77 46 6c 61 67 20 29 20 70 2d 3e 70 42 74 2d 3e wFlag ) p->pBt->
14e30 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
14e40 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 SECURE_DELETE;.
14e50 20 7d 20 0a 20 20 62 20 3d 20 28 70 2d 3e 70 42 } . b = (p->pB
14e60 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
14e70 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 S_SECURE_DELETE)
14e80 21 3d 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 !=0;. sqlite3Bt
14e90 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
14ea0 65 74 75 72 6e 20 62 3b 0a 7d 0a 23 65 6e 64 69 eturn b;.}.#endi
14eb0 66 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 53 51 f /* !defined(SQ
14ec0 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f LITE_OMIT_PAGER_
14ed0 50 52 41 47 4d 41 53 29 20 7c 7c 20 21 64 65 66 PRAGMAS) || !def
14ee0 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
14ef0 5f 56 41 43 55 55 4d 29 20 2a 2f 0a 0a 2f 2a 0a _VACUUM) */../*.
14f00 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 27 61 ** Change the 'a
14f10 75 74 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 uto-vacuum' prop
14f20 65 72 74 79 20 6f 66 20 74 68 65 20 64 61 74 61 erty of the data
14f30 62 61 73 65 2e 20 49 66 20 74 68 65 20 27 61 75 base. If the 'au
14f40 74 6f 56 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 toVacuum'.** par
14f50 61 6d 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 ameter is non-ze
14f60 72 6f 2c 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 ro, then auto-va
14f70 63 75 75 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 cuum mode is ena
14f80 62 6c 65 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 bled. If zero, i
14f90 74 0a 2a 2a 20 69 73 20 64 69 73 61 62 6c 65 64 t.** is disabled
14fa0 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 . The default va
14fb0 6c 75 65 20 66 6f 72 20 74 68 65 20 61 75 74 6f lue for the auto
14fc0 2d 76 61 63 75 75 6d 20 70 72 6f 70 65 72 74 79 -vacuum property
14fd0 20 69 73 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e is .** determin
14fe0 65 64 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 ed by the SQLITE
14ff0 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 _DEFAULT_AUTOVAC
15000 55 55 4d 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e UUM macro..*/.in
15010 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
15020 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 tAutoVacuum(Btre
15030 65 20 2a 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 e *p, int autoVa
15040 63 75 75 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 cuum){.#ifdef SQ
15050 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
15060 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 CUUM. return SQ
15070 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 LITE_READONLY;.#
15080 65 6c 73 65 0a 20 20 42 74 53 68 61 72 65 64 20 else. BtShared
15090 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
150a0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
150b0 5f 4f 4b 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 _OK;. u8 av = (
150c0 75 38 29 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a u8)autoVacuum;..
150d0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
150e0 74 65 72 28 70 29 3b 0a 20 20 69 66 28 20 28 70 ter(p);. if( (p
150f0 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
15100 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 TS_PAGESIZE_FIXE
15110 44 29 21 3d 30 20 26 26 20 28 61 76 20 3f 31 3a D)!=0 && (av ?1:
15120 30 29 21 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 0)!=pBt->autoVac
15130 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 uum ){. rc =
15140 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b SQLITE_READONLY;
15150 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 . }else{. pB
15160 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 t->autoVacuum =
15170 61 76 20 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 av ?1:0;. pBt
15180 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 ->incrVacuum = a
15190 76 3d 3d 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 v==2 ?1:0;. }.
151a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
151b0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
151c0 72 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a rc;.#endif.}../*
151d0 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 .** Return the v
151e0 61 6c 75 65 20 6f 66 20 74 68 65 20 27 61 75 74 alue of the 'aut
151f0 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 o-vacuum' proper
15200 74 79 2e 20 49 66 20 61 75 74 6f 2d 76 61 63 75 ty. If auto-vacu
15210 75 6d 20 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 um is .** enable
15220 64 20 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e d 1 is returned.
15230 20 4f 74 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f Otherwise 0..*/
15240 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
15250 65 47 65 74 41 75 74 6f 56 61 63 75 75 6d 28 42 eGetAutoVacuum(B
15260 74 72 65 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 tree *p){.#ifdef
15270 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
15280 4f 56 41 43 55 55 4d 0a 20 20 72 65 74 75 72 6e OVACUUM. return
15290 20 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 BTREE_AUTOVACUU
152a0 4d 5f 4e 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 M_NONE;.#else.
152b0 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 int rc;. sqlite
152c0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
152d0 20 20 72 63 20 3d 20 28 0a 20 20 20 20 28 21 70 rc = (. (!p
152e0 2d 3e 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ->pBt->autoVacuu
152f0 6d 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 m)?BTREE_AUTOVAC
15300 55 55 4d 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 UUM_NONE:. (!
15310 70 2d 3e 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 p->pBt->incrVacu
15320 75 6d 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 um)?BTREE_AUTOVA
15330 43 55 55 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 CUUM_FULL:. B
15340 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f TREE_AUTOVACUUM_
15350 49 4e 43 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 INCR. );. sqli
15360 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
15370 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 ;. return rc;.#
15380 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 endif.}.../*.**
15390 47 65 74 20 61 20 72 65 66 65 72 65 6e 63 65 20 Get a reference
153a0 74 6f 20 70 50 61 67 65 31 20 6f 66 20 74 68 65 to pPage1 of the
153b0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
153c0 20 54 68 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 6c This will.** al
153d0 73 6f 20 61 63 71 75 69 72 65 20 61 20 72 65 61 so acquire a rea
153e0 64 6c 6f 63 6b 20 6f 6e 20 74 68 61 74 20 66 69 dlock on that fi
153f0 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 le..**.** SQLITE
15400 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 _OK is returned
15410 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 on success. If
15420 74 68 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 the file is not
15430 61 0a 2a 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 a.** well-formed
15440 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
15450 74 68 65 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 then SQLITE_CORR
15460 55 50 54 20 69 73 20 72 65 74 75 72 6e 65 64 2e UPT is returned.
15470 0a 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 .** SQLITE_BUSY
15480 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 is returned if t
15490 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6c he database is l
154a0 6f 63 6b 65 64 2e 20 20 53 51 4c 49 54 45 5f 4e ocked. SQLITE_N
154b0 4f 4d 45 4d 0a 2a 2a 20 69 73 20 72 65 74 75 72 OMEM.** is retur
154c0 6e 65 64 20 69 66 20 77 65 20 72 75 6e 20 6f 75 ned if we run ou
154d0 74 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a 2f t of memory. .*/
154e0 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 6f 63 6b .static int lock
154f0 42 74 72 65 65 28 42 74 53 68 61 72 65 64 20 2a Btree(BtShared *
15500 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 pBt){. int rc;
15510 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
15520 52 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d Result code from
15530 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f subfunctions */
15540 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
15550 65 31 3b 20 20 20 20 20 2f 2a 20 50 61 67 65 20 e1; /* Page
15560 31 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 1 of the databas
15570 65 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 e file */. int
15580 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 nPage;
15590 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
155a0 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 ges in the datab
155b0 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 ase */. int nPa
155c0 67 65 46 69 6c 65 20 3d 20 30 3b 20 20 20 2f 2a geFile = 0; /*
155d0 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
155e0 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
155f0 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e file */. int n
15600 50 61 67 65 48 65 61 64 65 72 3b 20 20 20 20 20 PageHeader;
15610 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
15620 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 es in the databa
15630 73 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 se according to
15640 68 64 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 hdr */.. assert
15650 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
15660 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
15670 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 );. assert( pB
15680 74 2d 3e 70 50 61 67 65 31 3d 3d 30 20 29 3b 0a t->pPage1==0 );.
15690 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
156a0 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 70 42 gerSharedLock(pB
156b0 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 69 66 t->pPager);. if
156c0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
156d0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 ) return rc;. r
156e0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
156f0 28 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 31 (pBt, 1, &pPage1
15700 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d , 0);. if( rc!=
15710 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 SQLITE_OK ) retu
15720 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 rn rc;.. /* Do
15730 73 6f 6d 65 20 63 68 65 63 6b 69 6e 67 20 74 6f some checking to
15740 20 68 65 6c 70 20 69 6e 73 75 72 65 20 74 68 65 help insure the
15750 20 66 69 6c 65 20 77 65 20 6f 70 65 6e 65 64 20 file we opened
15760 72 65 61 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 61 really is. ** a
15770 20 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 20 valid database
15780 66 69 6c 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 file. . */. nP
15790 61 67 65 20 3d 20 6e 50 61 67 65 48 65 61 64 65 age = nPageHeade
157a0 72 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 2b r = get4byte(28+
157b0 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 (u8*)pPage1->aDa
157c0 74 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 ta);. sqlite3Pa
157d0 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 74 gerPagecount(pBt
157e0 2d 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 ->pPager, &nPage
157f0 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 6e 50 61 File);. if( nPa
15800 67 65 3d 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 ge==0 || memcmp(
15810 32 34 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 24+(u8*)pPage1->
15820 61 44 61 74 61 2c 20 39 32 2b 28 75 38 2a 29 70 aData, 92+(u8*)p
15830 50 61 67 65 31 2d 3e 61 44 61 74 61 2c 34 29 21 Page1->aData,4)!
15840 3d 30 20 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 =0 ){. nPage
15850 3d 20 6e 50 61 67 65 46 69 6c 65 3b 0a 20 20 7d = nPageFile;. }
15860 0a 20 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 . if( nPage>0 )
15870 7b 0a 20 20 20 20 75 33 32 20 70 61 67 65 53 69 {. u32 pageSi
15880 7a 65 3b 0a 20 20 20 20 75 33 32 20 75 73 61 62 ze;. u32 usab
15890 6c 65 53 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a leSize;. u8 *
158a0 70 61 67 65 31 20 3d 20 70 50 61 67 65 31 2d 3e page1 = pPage1->
158b0 61 44 61 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 aData;. rc =
158c0 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 SQLITE_NOTADB;.
158d0 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
158e0 46 3a 20 52 2d 34 33 37 33 37 2d 33 39 39 39 39 F: R-43737-39999
158f0 20 45 76 65 72 79 20 76 61 6c 69 64 20 53 51 4c Every valid SQL
15900 69 74 65 20 64 61 74 61 62 61 73 65 20 66 69 6c ite database fil
15910 65 20 62 65 67 69 6e 73 0a 20 20 20 20 2a 2a 20 e begins. **
15920 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 with the followi
15930 6e 67 20 31 36 20 62 79 74 65 73 20 28 69 6e 20 ng 16 bytes (in
15940 68 65 78 29 3a 20 35 33 20 35 31 20 34 63 20 36 hex): 53 51 4c 6
15950 39 20 37 34 20 36 35 20 32 30 20 36 36 20 36 66 9 74 65 20 66 6f
15960 20 37 32 20 36 64 0a 20 20 20 20 2a 2a 20 36 31 72 6d. ** 61
15970 20 37 34 20 32 30 20 33 33 20 30 30 2e 20 2a 2f 74 20 33 00. */
15980 0a 20 20 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 . if( memcmp(
15990 70 61 67 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 page1, zMagicHea
159a0 64 65 72 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 der, 16)!=0 ){.
159b0 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f goto page1_
159c0 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 init_failed;.
159d0 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }..#ifdef SQLIT
159e0 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 E_OMIT_WAL. i
159f0 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 f( page1[18]>1 )
15a00 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 {. pBt->bts
15a10 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 Flags |= BTS_REA
15a20 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 D_ONLY;. }.
15a30 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d 3e if( page1[19]>
15a40 31 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 1 ){. goto
15a50 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 page1_init_faile
15a60 64 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 d;. }.#else.
15a70 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 38 5d if( page1[18]
15a80 3e 32 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d >2 ){. pBt-
15a90 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
15aa0 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 _READ_ONLY;.
15ab0 7d 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 5b }. if( page1[
15ac0 31 39 5d 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 19]>2 ){. g
15ad0 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 oto page1_init_f
15ae0 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 ailed;. }..
15af0 20 20 2f 2a 20 49 66 20 74 68 65 20 77 72 69 74 /* If the writ
15b00 65 20 76 65 72 73 69 6f 6e 20 69 73 20 73 65 74 e version is set
15b10 20 74 6f 20 32 2c 20 74 68 69 73 20 64 61 74 61 to 2, this data
15b20 62 61 73 65 20 73 68 6f 75 6c 64 20 62 65 20 61 base should be a
15b30 63 63 65 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 ccessed. ** i
15b40 6e 20 57 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 n WAL mode. If t
15b50 68 65 20 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c he log is not al
15b60 72 65 61 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e ready open, open
15b70 20 69 74 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 it now. Then .
15b80 20 20 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c ** return SQL
15b90 49 54 45 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 ITE_OK and retur
15ba0 6e 20 77 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 n without popula
15bb0 74 69 6e 67 20 42 74 53 68 61 72 65 64 2e 70 50 ting BtShared.pP
15bc0 61 67 65 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 age1.. ** The
15bd0 20 63 61 6c 6c 65 72 20 64 65 74 65 63 74 73 20 caller detects
15be0 74 68 69 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 this and calls t
15bf0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 his function aga
15c00 69 6e 2e 20 54 68 69 73 20 69 73 0a 20 20 20 20 in. This is.
15c10 2a 2a 20 72 65 71 75 69 72 65 64 20 61 73 20 74 ** required as t
15c20 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 he version of pa
15c30 67 65 20 31 20 63 75 72 72 65 6e 74 6c 79 20 69 ge 1 currently i
15c40 6e 20 74 68 65 20 70 61 67 65 31 20 62 75 66 66 n the page1 buff
15c50 65 72 0a 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f er. ** may no
15c60 74 20 62 65 20 74 68 65 20 6c 61 74 65 73 74 20 t be the latest
15c70 76 65 72 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 version - there
15c80 6d 61 79 20 62 65 20 61 20 6e 65 77 65 72 20 6f may be a newer o
15c90 6e 65 20 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 ne in the log.
15ca0 20 20 2a 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a ** file.. *
15cb0 2f 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 5b /. if( page1[
15cc0 31 39 5d 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 19]==2 && (pBt->
15cd0 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 4e btsFlags & BTS_N
15ce0 4f 5f 57 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 O_WAL)==0 ){.
15cf0 20 20 20 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 int isOpen =
15d00 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 0;. rc = sq
15d10 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e 57 61 lite3PagerOpenWa
15d20 6c 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 l(pBt->pPager, &
15d30 69 73 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 isOpen);. i
15d40 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
15d50 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f ){. goto
15d60 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
15d70 65 64 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 ed;. }else
15d80 69 66 28 20 69 73 4f 70 65 6e 3d 3d 30 20 29 7b if( isOpen==0 ){
15d90 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 . release
15da0 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 Page(pPage1);.
15db0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
15dc0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a ITE_OK;. }.
15dd0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
15de0 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 7d 0a E_NOTADB;. }.
15df0 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 45 #endif.. /* E
15e00 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 35 VIDENCE-OF: R-15
15e10 34 36 35 2d 32 30 38 31 33 20 54 68 65 20 6d 61 465-20813 The ma
15e20 78 69 6d 75 6d 20 61 6e 64 20 6d 69 6e 69 6d 75 ximum and minimu
15e30 6d 20 65 6d 62 65 64 64 65 64 20 70 61 79 6c 6f m embedded paylo
15e40 61 64 0a 20 20 20 20 2a 2a 20 66 72 61 63 74 69 ad. ** fracti
15e50 6f 6e 73 20 61 6e 64 20 74 68 65 20 6c 65 61 66 ons and the leaf
15e60 20 70 61 79 6c 6f 61 64 20 66 72 61 63 74 69 6f payload fractio
15e70 6e 20 76 61 6c 75 65 73 20 6d 75 73 74 20 62 65 n values must be
15e80 20 36 34 2c 20 33 32 2c 20 61 6e 64 20 33 32 2e 64, 32, and 32.
15e90 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
15ea0 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 65 73 69 he original desi
15eb0 67 6e 20 61 6c 6c 6f 77 65 64 20 74 68 65 73 65 gn allowed these
15ec0 20 61 6d 6f 75 6e 74 73 20 74 6f 20 76 61 72 79 amounts to vary
15ed0 2c 20 62 75 74 20 61 73 20 6f 66 0a 20 20 20 20 , but as of.
15ee0 2a 2a 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e 30 ** version 3.6.0
15ef0 2c 20 77 65 20 72 65 71 75 69 72 65 20 74 68 65 , we require the
15f00 6d 20 74 6f 20 62 65 20 66 69 78 65 64 2e 0a 20 m to be fixed..
15f10 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6d 65 */. if( me
15f20 6d 63 6d 70 28 26 70 61 67 65 31 5b 32 31 5d 2c mcmp(&page1[21],
15f30 20 22 5c 31 30 30 5c 30 34 30 5c 30 34 30 22 2c "\100\040\040",
15f40 33 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 3)!=0 ){. g
15f50 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 oto page1_init_f
15f60 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 ailed;. }.
15f70 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
15f80 20 52 2d 35 31 38 37 33 2d 33 39 36 31 38 20 54 R-51873-39618 T
15f90 68 65 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 he page size for
15fa0 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 a database file
15fb0 20 69 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 is. ** deter
15fc0 6d 69 6e 65 64 20 62 79 20 74 68 65 20 32 2d 62 mined by the 2-b
15fd0 79 74 65 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 yte integer loca
15fe0 74 65 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 ted at an offset
15ff0 20 6f 66 20 31 36 20 62 79 74 65 73 20 66 72 6f of 16 bytes fro
16000 6d 0a 20 20 20 20 2a 2a 20 74 68 65 20 62 65 67 m. ** the beg
16010 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 61 inning of the da
16020 74 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a tabase file. */.
16030 20 20 20 20 70 61 67 65 53 69 7a 65 20 3d 20 28 pageSize = (
16040 70 61 67 65 31 5b 31 36 5d 3c 3c 38 29 20 7c 20 page1[16]<<8) |
16050 28 70 61 67 65 31 5b 31 37 5d 3c 3c 31 36 29 3b (page1[17]<<16);
16060 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
16070 2d 4f 46 3a 20 52 2d 32 35 30 30 38 2d 32 31 36 -OF: R-25008-216
16080 38 38 20 54 68 65 20 73 69 7a 65 20 6f 66 20 61 88 The size of a
16090 20 70 61 67 65 20 69 73 20 61 20 70 6f 77 65 72 page is a power
160a0 20 6f 66 20 74 77 6f 0a 20 20 20 20 2a 2a 20 62 of two. ** b
160b0 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 etween 512 and 6
160c0 35 35 33 36 20 69 6e 63 6c 75 73 69 76 65 2e 20 5536 inclusive.
160d0 2a 2f 0a 20 20 20 20 69 66 28 20 28 28 70 61 67 */. if( ((pag
160e0 65 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a eSize-1)&pageSiz
160f0 65 29 21 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 e)!=0. || pa
16100 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 geSize>SQLITE_MA
16110 58 5f 50 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 X_PAGE_SIZE .
16120 20 20 7c 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 || pageSize<=2
16130 35 36 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 56 . ){.
16140 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
16150 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
16160 20 20 20 61 73 73 65 72 74 28 20 28 70 61 67 65 assert( (page
16170 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a Size & 7)==0 );.
16180 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
16190 4f 46 3a 20 52 2d 35 39 33 31 30 2d 35 31 32 30 OF: R-59310-5120
161a0 35 20 54 68 65 20 22 72 65 73 65 72 76 65 64 20 5 The "reserved
161b0 73 70 61 63 65 22 20 73 69 7a 65 20 69 6e 20 74 space" size in t
161c0 68 65 20 31 2d 62 79 74 65 0a 20 20 20 20 2a 2a he 1-byte. **
161d0 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 integer at offs
161e0 65 74 20 32 30 20 69 73 20 74 68 65 20 6e 75 6d et 20 is the num
161f0 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
16200 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 space at the end
16210 20 6f 66 0a 20 20 20 20 2a 2a 20 65 61 63 68 20 of. ** each
16220 70 61 67 65 20 74 6f 20 72 65 73 65 72 76 65 20 page to reserve
16230 66 6f 72 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 for extensions.
16240 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 . **. ** E
16250 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 VIDENCE-OF: R-37
16260 34 39 37 2d 34 32 34 31 32 20 54 68 65 20 73 69 497-42412 The si
16270 7a 65 20 6f 66 20 74 68 65 20 72 65 73 65 72 76 ze of the reserv
16280 65 64 20 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 ed region is.
16290 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 ** determined b
162a0 79 20 74 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 y the one-byte u
162b0 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 nsigned integer
162c0 66 6f 75 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 found at an offs
162d0 65 74 20 6f 66 20 32 30 0a 20 20 20 20 2a 2a 20 et of 20. **
162e0 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 into the databas
162f0 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 2a e file header. *
16300 2f 0a 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 /. usableSize
16310 20 3d 20 70 61 67 65 53 69 7a 65 20 2d 20 70 61 = pageSize - pa
16320 67 65 31 5b 32 30 5d 3b 0a 20 20 20 20 69 66 28 ge1[20];. if(
16330 20 28 75 33 32 29 70 61 67 65 53 69 7a 65 21 3d (u32)pageSize!=
16340 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b pBt->pageSize ){
16350 0a 20 20 20 20 20 20 2f 2a 20 41 66 74 65 72 20 . /* After
16360 72 65 61 64 69 6e 67 20 74 68 65 20 66 69 72 73 reading the firs
16370 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 t page of the da
16380 74 61 62 61 73 65 20 61 73 73 75 6d 69 6e 67 20 tabase assuming
16390 61 20 70 61 67 65 20 73 69 7a 65 0a 20 20 20 20 a page size.
163a0 20 20 2a 2a 20 6f 66 20 42 74 53 68 61 72 65 64 ** of BtShared
163b0 2e 70 61 67 65 53 69 7a 65 2c 20 77 65 20 68 61 .pageSize, we ha
163c0 76 65 20 64 69 73 63 6f 76 65 72 65 64 20 74 68 ve discovered th
163d0 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 at the page-size
163e0 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 is. ** act
163f0 75 61 6c 6c 79 20 70 61 67 65 53 69 7a 65 2e 20 ually pageSize.
16400 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 Unlock the datab
16410 61 73 65 2c 20 6c 65 61 76 65 20 70 42 74 2d 3e ase, leave pBt->
16420 70 50 61 67 65 31 20 61 74 0a 20 20 20 20 20 20 pPage1 at.
16430 2a 2a 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 ** zero and retu
16440 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 rn SQLITE_OK. Th
16450 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 63 61 e caller will ca
16460 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ll this function
16470 0a 20 20 20 20 20 20 2a 2a 20 61 67 61 69 6e 20 . ** again
16480 77 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 74 with the correct
16490 20 70 61 67 65 2d 73 69 7a 65 2e 0a 20 20 20 20 page-size..
164a0 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 6c 65 61 */. relea
164b0 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a sePage(pPage1);.
164c0 20 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c pBt->usabl
164d0 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 eSize = usableSi
164e0 7a 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 ze;. pBt->p
164f0 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 ageSize = pageSi
16500 7a 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 ze;. freeTe
16510 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 mpSpace(pBt);.
16520 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
16530 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
16540 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 (pBt->pPager, &p
16550 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 Bt->pageSize,.
16560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16580 20 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 pageSize-usable
16590 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 Size);. ret
165a0 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
165b0 20 20 69 66 28 20 28 70 42 74 2d 3e 64 62 2d 3e if( (pBt->db->
165c0 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 flags & SQLITE_R
165d0 65 63 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 20 ecoveryMode)==0
165e0 26 26 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 69 && nPage>nPageFi
165f0 6c 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d le ){. rc =
16600 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
16610 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f BKPT;. goto
16620 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
16630 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a ed;. }. /*
16640 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
16650 32 38 33 31 32 2d 36 34 37 30 34 20 48 6f 77 65 28312-64704 Howe
16660 76 65 72 2c 20 74 68 65 20 75 73 61 62 6c 65 20 ver, the usable
16670 73 69 7a 65 20 69 73 20 6e 6f 74 20 61 6c 6c 6f size is not allo
16680 77 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 wed to. ** be
16690 20 6c 65 73 73 20 74 68 61 6e 20 34 38 30 2e 20 less than 480.
166a0 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words,
166b0 69 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 if the page size
166c0 20 69 73 20 35 31 32 2c 20 74 68 65 6e 20 74 68 is 512, then th
166d0 65 0a 20 20 20 20 2a 2a 20 72 65 73 65 72 76 65 e. ** reserve
166e0 64 20 73 70 61 63 65 20 73 69 7a 65 20 63 61 6e d space size can
166f0 6e 6f 74 20 65 78 63 65 65 64 20 33 32 2e 20 2a not exceed 32. *
16700 2f 0a 20 20 20 20 69 66 28 20 75 73 61 62 6c 65 /. if( usable
16710 53 69 7a 65 3c 34 38 30 20 29 7b 0a 20 20 20 20 Size<480 ){.
16720 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
16730 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
16740 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a pBt->pageSiz
16750 65 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 e = pageSize;.
16760 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a pBt->usableSiz
16770 65 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a e = usableSize;.
16780 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
16790 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
167a0 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
167b0 75 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 um = (get4byte(&
167c0 70 61 67 65 31 5b 33 36 20 2b 20 34 2a 34 5d 29 page1[36 + 4*4])
167d0 3f 31 3a 30 29 3b 0a 20 20 20 20 70 42 74 2d 3e ?1:0);. pBt->
167e0 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 incrVacuum = (ge
167f0 74 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 t4byte(&page1[36
16800 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 0a 23 + 7*4])?1:0);.#
16810 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 endif. }.. /*
16820 6d 61 78 4c 6f 63 61 6c 20 69 73 20 74 68 65 20 maxLocal is the
16830 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f maximum amount o
16840 66 20 70 61 79 6c 6f 61 64 20 74 6f 20 73 74 6f f payload to sto
16850 72 65 20 6c 6f 63 61 6c 6c 79 20 66 6f 72 0a 20 re locally for.
16860 20 2a 2a 20 61 20 63 65 6c 6c 2e 20 20 4d 61 6b ** a cell. Mak
16870 65 20 73 75 72 65 20 69 74 20 69 73 20 73 6d 61 e sure it is sma
16880 6c 6c 20 65 6e 6f 75 67 68 20 73 6f 20 74 68 61 ll enough so tha
16890 74 20 61 74 20 6c 65 61 73 74 20 6d 69 6e 46 61 t at least minFa
168a0 6e 6f 75 74 0a 20 20 2a 2a 20 63 65 6c 6c 73 20 nout. ** cells
168b0 63 61 6e 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 can will fit on
168c0 6f 6e 65 20 70 61 67 65 2e 20 20 57 65 20 61 73 one page. We as
168d0 73 75 6d 65 20 61 20 31 30 2d 62 79 74 65 20 70 sume a 10-byte p
168e0 61 67 65 20 68 65 61 64 65 72 2e 0a 20 20 2a 2a age header.. **
168f0 20 42 65 73 69 64 65 73 20 74 68 65 20 70 61 79 Besides the pay
16900 6c 6f 61 64 2c 20 74 68 65 20 63 65 6c 6c 20 6d load, the cell m
16910 75 73 74 20 73 74 6f 72 65 3a 0a 20 20 2a 2a 20 ust store:. **
16920 20 20 20 20 32 2d 62 79 74 65 20 70 6f 69 6e 74 2-byte point
16930 65 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 0a 20 er to the cell.
16940 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 63 ** 4-byte c
16950 68 69 6c 64 20 70 6f 69 6e 74 65 72 0a 20 20 2a hild pointer. *
16960 2a 20 20 20 20 20 39 2d 62 79 74 65 20 6e 4b 65 * 9-byte nKe
16970 79 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 20 20 y value. **
16980 20 34 2d 62 79 74 65 20 6e 44 61 74 61 20 76 61 4-byte nData va
16990 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 lue. ** 4-b
169a0 79 74 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 yte overflow pag
169b0 65 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 53 e pointer. ** S
169c0 6f 20 61 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 o a cell consist
169d0 73 20 6f 66 20 61 20 32 2d 62 79 74 65 20 70 6f s of a 2-byte po
169e0 69 6e 74 65 72 2c 20 61 20 68 65 61 64 65 72 20 inter, a header
169f0 77 68 69 63 68 20 69 73 20 61 73 20 6d 75 63 68 which is as much
16a00 20 61 73 0a 20 20 2a 2a 20 31 37 20 62 79 74 65 as. ** 17 byte
16a10 73 20 6c 6f 6e 67 2c 20 30 20 74 6f 20 4e 20 62 s long, 0 to N b
16a20 79 74 65 73 20 6f 66 20 70 61 79 6c 6f 61 64 2c ytes of payload,
16a30 20 61 6e 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c and an optional
16a40 20 34 20 62 79 74 65 20 6f 76 65 72 66 6c 6f 77 4 byte overflow
16a50 0a 20 20 2a 2a 20 70 61 67 65 20 70 6f 69 6e 74 . ** page point
16a60 65 72 2e 0a 20 20 2a 2f 0a 20 20 70 42 74 2d 3e er.. */. pBt->
16a70 6d 61 78 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 maxLocal = (u16)
16a80 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ((pBt->usableSiz
16a90 65 2d 31 32 29 2a 36 34 2f 32 35 35 20 2d 20 32 e-12)*64/255 - 2
16aa0 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 6f 3);. pBt->minLo
16ab0 63 61 6c 20 3d 20 28 75 31 36 29 28 28 70 42 74 cal = (u16)((pBt
16ac0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 ->usableSize-12)
16ad0 2a 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 *32/255 - 23);.
16ae0 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 3d 20 pBt->maxLeaf =
16af0 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c (u16)(pBt->usabl
16b00 65 53 69 7a 65 20 2d 20 33 35 29 3b 0a 20 20 70 eSize - 35);. p
16b10 42 74 2d 3e 6d 69 6e 4c 65 61 66 20 3d 20 28 75 Bt->minLeaf = (u
16b20 31 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 16)((pBt->usable
16b30 53 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 Size-12)*32/255
16b40 2d 20 32 33 29 3b 0a 20 20 69 66 28 20 70 42 74 - 23);. if( pBt
16b50 2d 3e 6d 61 78 4c 6f 63 61 6c 3e 31 32 37 20 29 ->maxLocal>127 )
16b60 7b 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 {. pBt->max1b
16b70 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 31 32 37 ytePayload = 127
16b80 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
16b90 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c Bt->max1bytePayl
16ba0 6f 61 64 20 3d 20 28 75 38 29 70 42 74 2d 3e 6d oad = (u8)pBt->m
16bb0 61 78 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 61 axLocal;. }. a
16bc0 73 73 65 72 74 28 20 70 42 74 2d 3e 6d 61 78 4c ssert( pBt->maxL
16bd0 65 61 66 20 2b 20 32 33 20 3c 3d 20 4d 58 5f 43 eaf + 23 <= MX_C
16be0 45 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 29 3b ELL_SIZE(pBt) );
16bf0 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d . pBt->pPage1 =
16c00 20 70 50 61 67 65 31 3b 0a 20 20 70 42 74 2d 3e pPage1;. pBt->
16c10 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 nPage = nPage;.
16c20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
16c30 4b 3b 0a 0a 70 61 67 65 31 5f 69 6e 69 74 5f 66 K;..page1_init_f
16c40 61 69 6c 65 64 3a 0a 20 20 72 65 6c 65 61 73 65 ailed:. release
16c50 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 Page(pPage1);.
16c60 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b pBt->pPage1 = 0;
16c70 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
16c80 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a .#ifndef NDEBUG.
16c90 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
16ca0 20 6e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f number of curso
16cb0 72 73 20 6f 70 65 6e 20 6f 6e 20 70 42 74 2e 20 rs open on pBt.
16cc0 54 68 69 73 20 69 73 20 66 6f 72 20 75 73 65 0a This is for use.
16cd0 2a 2a 20 69 6e 20 61 73 73 65 72 74 28 29 20 65 ** in assert() e
16ce0 78 70 72 65 73 73 69 6f 6e 73 2c 20 73 6f 20 69 xpressions, so i
16cf0 74 20 69 73 20 6f 6e 6c 79 20 63 6f 6d 70 69 6c t is only compil
16d00 65 64 20 69 66 20 4e 44 45 42 55 47 20 69 73 20 ed if NDEBUG is
16d10 6e 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 64 2e 0a not.** defined..
16d20 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 65 **.** Only write
16d30 20 63 75 72 73 6f 72 73 20 61 72 65 20 63 6f 75 cursors are cou
16d40 6e 74 65 64 20 69 66 20 77 72 4f 6e 6c 79 20 69 nted if wrOnly i
16d50 73 20 74 72 75 65 2e 20 20 49 66 20 77 72 4f 6e s true. If wrOn
16d60 6c 79 20 69 73 0a 2a 2a 20 66 61 6c 73 65 20 74 ly is.** false t
16d70 68 65 6e 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 hen all cursors
16d80 61 72 65 20 63 6f 75 6e 74 65 64 2e 0a 2a 2a 0a are counted..**.
16d90 2a 2a 20 46 6f 72 20 74 68 65 20 70 75 72 70 6f ** For the purpo
16da0 73 65 73 20 6f 66 20 74 68 69 73 20 72 6f 75 74 ses of this rout
16db0 69 6e 65 2c 20 61 20 63 75 72 73 6f 72 20 69 73 ine, a cursor is
16dc0 20 61 6e 79 20 63 75 72 73 6f 72 20 74 68 61 74 any cursor that
16dd0 0a 2a 2a 20 69 73 20 63 61 70 61 62 6c 65 20 6f .** is capable o
16de0 66 20 72 65 61 64 69 6e 67 20 6f 72 20 77 72 69 f reading or wri
16df0 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 ting to the data
16e00 62 61 73 65 2e 20 20 43 75 72 73 6f 72 73 20 74 base. Cursors t
16e10 68 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e hat.** have been
16e20 20 74 72 69 70 70 65 64 20 69 6e 74 6f 20 74 68 tripped into th
16e30 65 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 73 e CURSOR_FAULT s
16e40 74 61 74 65 20 61 72 65 20 6e 6f 74 20 63 6f 75 tate are not cou
16e50 6e 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 nted..*/.static
16e60 69 6e 74 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 int countValidCu
16e70 72 73 6f 72 73 28 42 74 53 68 61 72 65 64 20 2a rsors(BtShared *
16e80 70 42 74 2c 20 69 6e 74 20 77 72 4f 6e 6c 79 29 pBt, int wrOnly)
16e90 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 {. BtCursor *pC
16ea0 75 72 3b 0a 20 20 69 6e 74 20 72 20 3d 20 30 3b ur;. int r = 0;
16eb0 0a 20 20 66 6f 72 28 70 43 75 72 3d 70 42 74 2d . for(pCur=pBt-
16ec0 3e 70 43 75 72 73 6f 72 3b 20 70 43 75 72 3b 20 >pCursor; pCur;
16ed0 70 43 75 72 3d 70 43 75 72 2d 3e 70 4e 65 78 74 pCur=pCur->pNext
16ee0 29 7b 0a 20 20 20 20 69 66 28 20 28 77 72 4f 6e ){. if( (wrOn
16ef0 6c 79 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e ly==0 || (pCur->
16f00 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
16f10 57 72 69 74 65 46 6c 61 67 29 21 3d 30 29 0a 20 WriteFlag)!=0).
16f20 20 20 20 20 26 26 20 70 43 75 72 2d 3e 65 53 74 && pCur->eSt
16f30 61 74 65 21 3d 43 55 52 53 4f 52 5f 46 41 55 4c ate!=CURSOR_FAUL
16f40 54 20 29 20 72 2b 2b 3b 20 0a 20 20 7d 0a 20 20 T ) r++; . }.
16f50 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 23 65 6e 64 return r;.}.#end
16f60 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 if../*.** If the
16f70 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 re are no outsta
16f80 6e 64 69 6e 67 20 63 75 72 73 6f 72 73 20 61 6e nding cursors an
16f90 64 20 77 65 20 61 72 65 20 6e 6f 74 20 69 6e 20 d we are not in
16fa0 74 68 65 20 6d 69 64 64 6c 65 0a 2a 2a 20 6f 66 the middle.** of
16fb0 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 a transaction b
16fc0 75 74 20 74 68 65 72 65 20 69 73 20 61 20 72 65 ut there is a re
16fd0 61 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 ad lock on the d
16fe0 61 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 2a 2a atabase, then.**
16ff0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 75 6e this routine un
17000 72 65 66 73 20 74 68 65 20 66 69 72 73 74 20 70 refs the first p
17010 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 age of the datab
17020 61 73 65 20 66 69 6c 65 20 77 68 69 63 68 20 0a ase file which .
17030 2a 2a 20 68 61 73 20 74 68 65 20 65 66 66 65 63 ** has the effec
17040 74 20 6f 66 20 72 65 6c 65 61 73 69 6e 67 20 74 t of releasing t
17050 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2a he read lock..**
17060 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 .** If there is
17070 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e a transaction in
17080 20 70 72 6f 67 72 65 73 73 2c 20 74 68 69 73 20 progress, this
17090 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d routine is a no-
170a0 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f op..*/.static vo
170b0 69 64 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 id unlockBtreeIf
170c0 55 6e 75 73 65 64 28 42 74 53 68 61 72 65 64 20 Unused(BtShared
170d0 2a 70 42 74 29 7b 0a 20 20 61 73 73 65 72 74 28 *pBt){. assert(
170e0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
170f0 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
17100 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 6f 75 );. assert( cou
17110 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 70 ntValidCursors(p
17120 42 74 2c 30 29 3d 3d 30 20 7c 7c 20 70 42 74 2d Bt,0)==0 || pBt-
17130 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3e 54 >inTransaction>T
17140 52 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 69 RANS_NONE );. i
17150 66 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 f( pBt->inTransa
17160 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e ction==TRANS_NON
17170 45 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 E && pBt->pPage1
17180 21 3d 30 20 29 7b 0a 20 20 20 20 4d 65 6d 50 61 !=0 ){. MemPa
17190 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 ge *pPage1 = pBt
171a0 2d 3e 70 50 61 67 65 31 3b 0a 20 20 20 20 61 73 ->pPage1;. as
171b0 73 65 72 74 28 20 70 50 61 67 65 31 2d 3e 61 44 sert( pPage1->aD
171c0 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ata );. asser
171d0 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 t( sqlite3PagerR
171e0 65 66 63 6f 75 6e 74 28 70 42 74 2d 3e 70 50 61 efcount(pBt->pPa
171f0 67 65 72 29 3d 3d 31 20 29 3b 0a 20 20 20 20 70 ger)==1 );. p
17200 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a Bt->pPage1 = 0;.
17210 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
17220 70 50 61 67 65 31 29 3b 0a 20 20 7d 0a 7d 0a 0a pPage1);. }.}..
17230 2f 2a 0a 2a 2a 20 49 66 20 70 42 74 20 70 6f 69 /*.** If pBt poi
17240 6e 74 73 20 74 6f 20 61 6e 20 65 6d 70 74 79 20 nts to an empty
17250 66 69 6c 65 20 74 68 65 6e 20 63 6f 6e 76 65 72 file then conver
17260 74 20 74 68 61 74 20 65 6d 70 74 79 20 66 69 6c t that empty fil
17270 65 0a 2a 2a 20 69 6e 74 6f 20 61 20 6e 65 77 20 e.** into a new
17280 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 20 62 empty database b
17290 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 y initializing t
172a0 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 he first page of
172b0 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
172c0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
172d0 6e 65 77 44 61 74 61 62 61 73 65 28 42 74 53 68 newDatabase(BtSh
172e0 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 4d 65 ared *pBt){. Me
172f0 6d 50 61 67 65 20 2a 70 50 31 3b 0a 20 20 75 6e mPage *pP1;. un
17300 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 signed char *dat
17310 61 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 a;. int rc;..
17320 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
17330 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
17340 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 mutex) );. if(
17350 70 42 74 2d 3e 6e 50 61 67 65 3e 30 20 29 7b 0a pBt->nPage>0 ){.
17360 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
17370 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 50 31 20 E_OK;. }. pP1
17380 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 = pBt->pPage1;.
17390 20 61 73 73 65 72 74 28 20 70 50 31 21 3d 30 20 assert( pP1!=0
173a0 29 3b 0a 20 20 64 61 74 61 20 3d 20 70 50 31 2d );. data = pP1-
173b0 3e 61 44 61 74 61 3b 0a 20 20 72 63 20 3d 20 73 >aData;. rc = s
173c0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
173d0 28 70 50 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a (pP1->pDbPage);.
173e0 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
173f0 6e 20 72 63 3b 0a 20 20 6d 65 6d 63 70 79 28 64 n rc;. memcpy(d
17400 61 74 61 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 ata, zMagicHeade
17410 72 2c 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 r, sizeof(zMagic
17420 48 65 61 64 65 72 29 29 3b 0a 20 20 61 73 73 65 Header));. asse
17430 72 74 28 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 rt( sizeof(zMagi
17440 63 48 65 61 64 65 72 29 3d 3d 31 36 20 29 3b 0a cHeader)==16 );.
17450 20 20 64 61 74 61 5b 31 36 5d 20 3d 20 28 75 38 data[16] = (u8
17460 29 28 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 )((pBt->pageSize
17470 3e 3e 38 29 26 30 78 66 66 29 3b 0a 20 20 64 61 >>8)&0xff);. da
17480 74 61 5b 31 37 5d 20 3d 20 28 75 38 29 28 28 70 ta[17] = (u8)((p
17490 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 31 36 Bt->pageSize>>16
174a0 29 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b )&0xff);. data[
174b0 31 38 5d 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 18] = 1;. data[
174c0 31 39 5d 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 19] = 1;. asser
174d0 74 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 t( pBt->usableSi
174e0 7a 65 3c 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a ze<=pBt->pageSiz
174f0 65 20 26 26 20 70 42 74 2d 3e 75 73 61 62 6c 65 e && pBt->usable
17500 53 69 7a 65 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 Size+255>=pBt->p
17510 61 67 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 ageSize);. data
17520 5b 32 30 5d 20 3d 20 28 75 38 29 28 70 42 74 2d [20] = (u8)(pBt-
17530 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 42 74 2d >pageSize - pBt-
17540 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 >usableSize);.
17550 64 61 74 61 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 data[21] = 64;.
17560 20 64 61 74 61 5b 32 32 5d 20 3d 20 33 32 3b 0a data[22] = 32;.
17570 20 20 64 61 74 61 5b 32 33 5d 20 3d 20 33 32 3b data[23] = 32;
17580 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b . memset(&data[
17590 32 34 5d 2c 20 30 2c 20 31 30 30 2d 32 34 29 3b 24], 0, 100-24);
175a0 0a 20 20 7a 65 72 6f 50 61 67 65 28 70 50 31 2c . zeroPage(pP1,
175b0 20 50 54 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f PTF_INTKEY|PTF_
175c0 4c 45 41 46 7c 50 54 46 5f 4c 45 41 46 44 41 54 LEAF|PTF_LEAFDAT
175d0 41 20 29 3b 0a 20 20 70 42 74 2d 3e 62 74 73 46 A );. pBt->btsF
175e0 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 lags |= BTS_PAGE
175f0 53 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e SIZE_FIXED;.#ifn
17600 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
17610 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 61 73 73 AUTOVACUUM. ass
17620 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 ert( pBt->autoVa
17630 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e cuum==1 || pBt->
17640 61 75 74 6f 56 61 63 75 75 6d 3d 3d 30 20 29 3b autoVacuum==0 );
17650 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
17660 69 6e 63 72 56 61 63 75 75 6d 3d 3d 31 20 7c 7c incrVacuum==1 ||
17670 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
17680 3d 3d 30 20 29 3b 0a 20 20 70 75 74 34 62 79 74 ==0 );. put4byt
17690 65 28 26 64 61 74 61 5b 33 36 20 2b 20 34 2a 34 e(&data[36 + 4*4
176a0 5d 2c 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 ], pBt->autoVacu
176b0 75 6d 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 um);. put4byte(
176c0 26 64 61 74 61 5b 33 36 20 2b 20 37 2a 34 5d 2c &data[36 + 7*4],
176d0 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
176e0 29 3b 0a 23 65 6e 64 69 66 0a 20 20 70 42 74 2d );.#endif. pBt-
176f0 3e 6e 50 61 67 65 20 3d 20 31 3b 0a 20 20 64 61 >nPage = 1;. da
17700 74 61 5b 33 31 5d 20 3d 20 31 3b 0a 20 20 72 65 ta[31] = 1;. re
17710 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
17720 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c }../*.** Initial
17730 69 7a 65 20 74 68 65 20 66 69 72 73 74 20 70 61 ize the first pa
17740 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ge of the databa
17750 73 65 20 66 69 6c 65 20 28 63 72 65 61 74 69 6e se file (creatin
17760 67 20 61 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 g a database.**
17770 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 20 61 20 consisting of a
17780 73 69 6e 67 6c 65 20 70 61 67 65 20 61 6e 64 20 single page and
17790 6e 6f 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 no schema object
177a0 73 29 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54 s). Return SQLIT
177b0 45 5f 4f 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 E_OK.** if succe
177c0 73 73 66 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c ssful, or an SQL
177d0 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 6f ite error code o
177e0 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 therwise..*/.int
177f0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 77 sqlite3BtreeNew
17800 44 62 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 Db(Btree *p){.
17810 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 int rc;. sqlite
17820 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
17830 20 20 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 20 p->pBt->nPage
17840 3d 20 30 3b 0a 20 20 72 63 20 3d 20 6e 65 77 44 = 0;. rc = newD
17850 61 74 61 62 61 73 65 28 70 2d 3e 70 42 74 29 3b atabase(p->pBt);
17860 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
17870 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
17880 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 n rc;.}../*.** A
17890 74 74 65 6d 70 74 20 74 6f 20 73 74 61 72 74 20 ttempt to start
178a0 61 20 6e 65 77 20 74 72 61 6e 73 61 63 74 69 6f a new transactio
178b0 6e 2e 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 n. A write-trans
178c0 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 73 74 61 action.** is sta
178d0 72 74 65 64 20 69 66 20 74 68 65 20 73 65 63 6f rted if the seco
178e0 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e nd argument is n
178f0 6f 6e 7a 65 72 6f 2c 20 6f 74 68 65 72 77 69 73 onzero, otherwis
17900 65 20 61 20 72 65 61 64 2d 0a 2a 2a 20 74 72 61 e a read-.** tra
17910 6e 73 61 63 74 69 6f 6e 2e 20 20 49 66 20 74 68 nsaction. If th
17920 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
17930 74 20 69 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 t is 2 or more a
17940 6e 64 20 65 78 63 6c 75 73 69 76 65 0a 2a 2a 20 nd exclusive.**
17950 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 transaction is s
17960 74 61 72 74 65 64 2c 20 6d 65 61 6e 69 6e 67 20 tarted, meaning
17970 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 70 72 that no other pr
17980 6f 63 65 73 73 20 69 73 20 61 6c 6c 6f 77 65 64 ocess is allowed
17990 0a 2a 2a 20 74 6f 20 61 63 63 65 73 73 20 74 68 .** to access th
179a0 65 20 64 61 74 61 62 61 73 65 2e 20 20 41 20 70 e database. A p
179b0 72 65 65 78 69 73 74 69 6e 67 20 74 72 61 6e 73 reexisting trans
179c0 61 63 74 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 action may not b
179d0 65 0a 2a 2a 20 75 70 67 72 61 64 65 64 20 74 6f e.** upgraded to
179e0 20 65 78 63 6c 75 73 69 76 65 20 62 79 20 63 61 exclusive by ca
179f0 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 lling this routi
17a00 6e 65 20 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 ne a second time
17a10 20 2d 20 74 68 65 0a 2a 2a 20 65 78 63 6c 75 73 - the.** exclus
17a20 69 76 69 74 79 20 66 6c 61 67 20 6f 6e 6c 79 20 ivity flag only
17a30 77 6f 72 6b 73 20 66 6f 72 20 61 20 6e 65 77 20 works for a new
17a40 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a transaction..**.
17a50 2a 2a 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 ** A write-trans
17a60 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 73 action must be s
17a70 74 61 72 74 65 64 20 62 65 66 6f 72 65 20 61 74 tarted before at
17a80 74 65 6d 70 74 69 6e 67 20 61 6e 79 20 0a 2a 2a tempting any .**
17a90 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 changes to the
17aa0 64 61 74 61 62 61 73 65 2e 20 20 4e 6f 6e 65 20 database. None
17ab0 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
17ac0 20 72 6f 75 74 69 6e 65 73 20 0a 2a 2a 20 77 69 routines .** wi
17ad0 6c 6c 20 77 6f 72 6b 20 75 6e 6c 65 73 73 20 61 ll work unless a
17ae0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
17af0 73 74 61 72 74 65 64 20 66 69 72 73 74 3a 0a 2a started first:.*
17b00 2a 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 *.** sqlite
17b10 33 42 74 72 65 65 43 72 65 61 74 65 54 61 62 6c 3BtreeCreateTabl
17b20 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 e().** sqli
17b30 74 65 33 42 74 72 65 65 43 72 65 61 74 65 49 6e te3BtreeCreateIn
17b40 64 65 78 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 dex().** sq
17b50 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 54 lite3BtreeClearT
17b60 61 62 6c 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 able().** s
17b70 71 6c 69 74 65 33 42 74 72 65 65 44 72 6f 70 54 qlite3BtreeDropT
17b80 61 62 6c 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 able().** s
17b90 71 6c 69 74 65 33 42 74 72 65 65 49 6e 73 65 72 qlite3BtreeInser
17ba0 74 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 t().** sqli
17bb0 74 65 33 42 74 72 65 65 44 65 6c 65 74 65 28 29 te3BtreeDelete()
17bc0 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
17bd0 42 74 72 65 65 55 70 64 61 74 65 4d 65 74 61 28 BtreeUpdateMeta(
17be0 29 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 69 6e ).**.** If an in
17bf0 69 74 69 61 6c 20 61 74 74 65 6d 70 74 20 74 6f itial attempt to
17c00 20 61 63 71 75 69 72 65 20 74 68 65 20 6c 6f 63 acquire the loc
17c10 6b 20 66 61 69 6c 73 20 62 65 63 61 75 73 65 20 k fails because
17c20 6f 66 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 of lock contenti
17c30 6f 6e 0a 2a 2a 20 61 6e 64 20 74 68 65 20 64 61 on.** and the da
17c40 74 61 62 61 73 65 20 77 61 73 20 70 72 65 76 69 tabase was previ
17c50 6f 75 73 6c 79 20 75 6e 6c 6f 63 6b 65 64 2c 20 ously unlocked,
17c60 74 68 65 6e 20 69 6e 76 6f 6b 65 20 74 68 65 20 then invoke the
17c70 62 75 73 79 20 68 61 6e 64 6c 65 72 0a 2a 2a 20 busy handler.**
17c80 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 2e if there is one.
17c90 20 20 42 75 74 20 69 66 20 74 68 65 72 65 20 77 But if there w
17ca0 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 61 20 as previously a
17cb0 72 65 61 64 2d 6c 6f 63 6b 2c 20 64 6f 20 6e 6f read-lock, do no
17cc0 74 0a 2a 2a 20 69 6e 76 6f 6b 65 20 74 68 65 20 t.** invoke the
17cd0 62 75 73 79 20 68 61 6e 64 6c 65 72 20 2d 20 6a busy handler - j
17ce0 75 73 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ust return SQLIT
17cf0 45 5f 42 55 53 59 2e 20 20 53 51 4c 49 54 45 5f E_BUSY. SQLITE_
17d00 42 55 53 59 20 69 73 20 0a 2a 2a 20 72 65 74 75 BUSY is .** retu
17d10 72 6e 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 rned when there
17d20 69 73 20 61 6c 72 65 61 64 79 20 61 20 72 65 61 is already a rea
17d30 64 2d 6c 6f 63 6b 20 69 6e 20 6f 72 64 65 72 20 d-lock in order
17d40 74 6f 20 61 76 6f 69 64 20 61 20 64 65 61 64 6c to avoid a deadl
17d50 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f ock..**.** Suppo
17d60 73 65 20 74 68 65 72 65 20 61 72 65 20 74 77 6f se there are two
17d70 20 70 72 6f 63 65 73 73 65 73 20 41 20 61 6e 64 processes A and
17d80 20 42 2e 20 20 41 20 68 61 73 20 61 20 72 65 61 B. A has a rea
17d90 64 20 6c 6f 63 6b 20 61 6e 64 20 42 20 68 61 73 d lock and B has
17da0 0a 2a 2a 20 61 20 72 65 73 65 72 76 65 64 20 6c .** a reserved l
17db0 6f 63 6b 2e 20 20 42 20 74 72 69 65 73 20 74 6f ock. B tries to
17dc0 20 70 72 6f 6d 6f 74 65 20 74 6f 20 65 78 63 6c promote to excl
17dd0 75 73 69 76 65 20 62 75 74 20 69 73 20 62 6c 6f usive but is blo
17de0 63 6b 65 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 cked because.**
17df0 6f 66 20 41 27 73 20 72 65 61 64 20 6c 6f 63 6b of A's read lock
17e00 2e 20 20 41 20 74 72 69 65 73 20 74 6f 20 70 72 . A tries to pr
17e10 6f 6d 6f 74 65 20 74 6f 20 72 65 73 65 72 76 65 omote to reserve
17e20 64 20 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 d but is blocked
17e30 20 62 79 20 42 2e 0a 2a 2a 20 4f 6e 65 20 6f 72 by B..** One or
17e40 20 74 68 65 20 6f 74 68 65 72 20 6f 66 20 74 68 the other of th
17e50 65 20 74 77 6f 20 70 72 6f 63 65 73 73 65 73 20 e two processes
17e60 6d 75 73 74 20 67 69 76 65 20 77 61 79 20 6f 72 must give way or
17e70 20 74 68 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a there can be.**
17e80 20 6e 6f 20 70 72 6f 67 72 65 73 73 2e 20 20 42 no progress. B
17e90 79 20 72 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 y returning SQLI
17ea0 54 45 5f 42 55 53 59 20 61 6e 64 20 6e 6f 74 20 TE_BUSY and not
17eb0 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 62 75 73 invoking the bus
17ec0 79 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 77 68 y callback.** wh
17ed0 65 6e 20 41 20 61 6c 72 65 61 64 79 20 68 61 73 en A already has
17ee0 20 61 20 72 65 61 64 20 6c 6f 63 6b 2c 20 77 65 a read lock, we
17ef0 20 65 6e 63 6f 75 72 61 67 65 20 41 20 74 6f 20 encourage A to
17f00 67 69 76 65 20 75 70 20 61 6e 64 20 6c 65 74 20 give up and let
17f10 42 0a 2a 2a 20 70 72 6f 63 65 65 64 2e 0a 2a 2f B.** proceed..*/
17f20 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
17f30 65 42 65 67 69 6e 54 72 61 6e 73 28 42 74 72 65 eBeginTrans(Btre
17f40 65 20 2a 70 2c 20 69 6e 74 20 77 72 66 6c 61 67 e *p, int wrflag
17f50 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 42 ){. sqlite3 *pB
17f60 6c 6f 63 6b 20 3d 20 30 3b 0a 20 20 42 74 53 68 lock = 0;. BtSh
17f70 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
17f80 42 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 Bt;. int rc = S
17f90 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c QLITE_OK;.. sql
17fa0 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
17fb0 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 );. btreeIntegr
17fc0 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 ity(p);.. /* If
17fd0 20 74 68 65 20 62 74 72 65 65 20 69 73 20 61 6c the btree is al
17fe0 72 65 61 64 79 20 69 6e 20 61 20 77 72 69 74 65 ready in a write
17ff0 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 -transaction, or
18000 20 69 74 0a 20 20 2a 2a 20 69 73 20 61 6c 72 65 it. ** is alre
18010 61 64 79 20 69 6e 20 61 20 72 65 61 64 2d 74 72 ady in a read-tr
18020 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 61 20 ansaction and a
18030 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
18040 0a 20 20 2a 2a 20 69 73 20 72 65 71 75 65 73 74 . ** is request
18050 65 64 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f ed, this is a no
18060 2d 6f 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 -op.. */. if(
18070 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
18080 53 5f 57 52 49 54 45 20 7c 7c 20 28 70 2d 3e 69 S_WRITE || (p->i
18090 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 nTrans==TRANS_RE
180a0 41 44 20 26 26 20 21 77 72 66 6c 61 67 29 20 29 AD && !wrflag) )
180b0 7b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 {. goto trans
180c0 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 _begun;. }. as
180d0 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 sert( pBt->inTra
180e0 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
180f0 57 52 49 54 45 20 7c 7c 20 49 66 4e 6f 74 4f 6d WRITE || IfNotOm
18100 69 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 75 itAV(pBt->bDoTru
18110 6e 63 61 74 65 29 3d 3d 30 20 29 3b 0a 0a 20 20 ncate)==0 );..
18120 2f 2a 20 57 72 69 74 65 20 74 72 61 6e 73 61 63 /* Write transac
18130 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 70 6f tions are not po
18140 73 73 69 62 6c 65 20 6f 6e 20 61 20 72 65 61 64 ssible on a read
18150 2d 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 20 2a -only database *
18160 2f 0a 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 /. if( (pBt->bt
18170 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 sFlags & BTS_REA
18180 44 5f 4f 4e 4c 59 29 21 3d 30 20 26 26 20 77 72 D_ONLY)!=0 && wr
18190 66 6c 61 67 20 29 7b 0a 20 20 20 20 72 63 20 3d flag ){. rc =
181a0 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
181b0 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 ;. goto trans
181c0 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 0a 23 69 66 _begun;. }..#if
181d0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
181e0 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 _SHARED_CACHE.
181f0 2f 2a 20 49 66 20 61 6e 6f 74 68 65 72 20 64 61 /* If another da
18200 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 68 61 tabase handle ha
18210 73 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 s already opened
18220 20 61 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 a write transac
18230 74 69 6f 6e 20 0a 20 20 2a 2a 20 6f 6e 20 74 68 tion . ** on th
18240 69 73 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 is shared-btree
18250 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 61 20 structure and a
18260 73 65 63 6f 6e 64 20 77 72 69 74 65 20 74 72 61 second write tra
18270 6e 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 2a 2a nsaction is. **
18280 20 72 65 71 75 65 73 74 65 64 2c 20 72 65 74 75 requested, retu
18290 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 rn SQLITE_LOCKED
182a0 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 77 72 .. */. if( (wr
182b0 66 6c 61 67 20 26 26 20 70 42 74 2d 3e 69 6e 54 flag && pBt->inT
182c0 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
182d0 53 5f 57 52 49 54 45 29 0a 20 20 20 7c 7c 20 28 S_WRITE). || (
182e0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
182f0 42 54 53 5f 50 45 4e 44 49 4e 47 29 21 3d 30 0a BTS_PENDING)!=0.
18300 20 20 29 7b 0a 20 20 20 20 70 42 6c 6f 63 6b 20 ){. pBlock
18310 3d 20 70 42 74 2d 3e 70 57 72 69 74 65 72 2d 3e = pBt->pWriter->
18320 64 62 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 db;. }else if(
18330 77 72 66 6c 61 67 3e 31 20 29 7b 0a 20 20 20 20 wrflag>1 ){.
18340 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 20 BtLock *pIter;.
18350 20 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 for(pIter=pBt
18360 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 ->pLock; pIter;
18370 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 pIter=pIter->pNe
18380 78 74 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 xt){. if( p
18390 49 74 65 72 2d 3e 70 42 74 72 65 65 21 3d 70 20 Iter->pBtree!=p
183a0 29 7b 0a 20 20 20 20 20 20 20 20 70 42 6c 6f 63 ){. pBloc
183b0 6b 20 3d 20 70 49 74 65 72 2d 3e 70 42 74 72 65 k = pIter->pBtre
183c0 65 2d 3e 64 62 3b 0a 20 20 20 20 20 20 20 20 62 e->db;. b
183d0 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
183e0 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 42 }. }. if( pB
183f0 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 lock ){. sqli
18400 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f te3ConnectionBlo
18410 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 42 6c 6f cked(p->db, pBlo
18420 63 6b 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 ck);. rc = SQ
18430 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 LITE_LOCKED_SHAR
18440 45 44 43 41 43 48 45 3b 0a 20 20 20 20 67 6f 74 EDCACHE;. got
18450 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 o trans_begun;.
18460 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
18470 41 6e 79 20 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 Any read-only or
18480 20 72 65 61 64 2d 77 72 69 74 65 20 74 72 61 6e read-write tran
18490 73 61 63 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 saction implies
184a0 61 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 0a a read-lock on .
184b0 20 20 2a 2a 20 70 61 67 65 20 31 2e 20 53 6f 20 ** page 1. So
184c0 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 73 68 if some other sh
184d0 61 72 65 64 2d 63 61 63 68 65 20 63 6c 69 65 6e ared-cache clien
184e0 74 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 t already has a
184f0 77 72 69 74 65 2d 6c 6f 63 6b 20 0a 20 20 2a 2a write-lock . **
18500 20 6f 6e 20 70 61 67 65 20 31 2c 20 74 68 65 20 on page 1, the
18510 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e 6e transaction cann
18520 6f 74 20 62 65 20 6f 70 65 6e 65 64 2e 20 2a 2f ot be opened. */
18530 0a 20 20 72 63 20 3d 20 71 75 65 72 79 53 68 61 . rc = querySha
18540 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
18550 6b 28 70 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 k(p, MASTER_ROOT
18560 2c 20 52 45 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 , READ_LOCK);.
18570 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 if( SQLITE_OK!=r
18580 63 20 29 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 c ) goto trans_b
18590 65 67 75 6e 3b 0a 0a 20 20 70 42 74 2d 3e 62 74 egun;.. pBt->bt
185a0 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f 49 sFlags &= ~BTS_I
185b0 4e 49 54 49 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a NITIALLY_EMPTY;.
185c0 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 if( pBt->nPage
185d0 3d 3d 30 20 29 20 70 42 74 2d 3e 62 74 73 46 6c ==0 ) pBt->btsFl
185e0 61 67 73 20 7c 3d 20 42 54 53 5f 49 4e 49 54 49 ags |= BTS_INITI
185f0 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 64 6f ALLY_EMPTY;. do
18600 20 7b 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 6c {. /* Call l
18610 6f 63 6b 42 74 72 65 65 28 29 20 75 6e 74 69 6c ockBtree() until
18620 20 65 69 74 68 65 72 20 70 42 74 2d 3e 70 50 61 either pBt->pPa
18630 67 65 31 20 69 73 20 70 6f 70 75 6c 61 74 65 64 ge1 is populated
18640 20 6f 72 0a 20 20 20 20 2a 2a 20 6c 6f 63 6b 42 or. ** lockB
18650 74 72 65 65 28 29 20 72 65 74 75 72 6e 73 20 73 tree() returns s
18660 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 20 74 omething other t
18670 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 6c han SQLITE_OK. l
18680 6f 63 6b 42 74 72 65 65 28 29 0a 20 20 20 20 2a ockBtree(). *
18690 2a 20 6d 61 79 20 72 65 74 75 72 6e 20 53 51 4c * may return SQL
186a0 49 54 45 5f 4f 4b 20 62 75 74 20 6c 65 61 76 65 ITE_OK but leave
186b0 20 70 42 74 2d 3e 70 50 61 67 65 31 20 73 65 74 pBt->pPage1 set
186c0 20 74 6f 20 30 20 69 66 20 61 66 74 65 72 0a 20 to 0 if after.
186d0 20 20 20 2a 2a 20 72 65 61 64 69 6e 67 20 70 61 ** reading pa
186e0 67 65 20 31 20 69 74 20 64 69 73 63 6f 76 65 72 ge 1 it discover
186f0 73 20 74 68 61 74 20 74 68 65 20 70 61 67 65 2d s that the page-
18700 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 size of the data
18710 62 61 73 65 20 0a 20 20 20 20 2a 2a 20 66 69 6c base . ** fil
18720 65 20 69 73 20 6e 6f 74 20 70 42 74 2d 3e 70 61 e is not pBt->pa
18730 67 65 53 69 7a 65 2e 20 49 6e 20 74 68 69 73 20 geSize. In this
18740 63 61 73 65 20 6c 6f 63 6b 42 74 72 65 65 28 29 case lockBtree()
18750 20 77 69 6c 6c 20 75 70 64 61 74 65 0a 20 20 20 will update.
18760 20 2a 2a 20 70 42 74 2d 3e 70 61 67 65 53 69 7a ** pBt->pageSiz
18770 65 20 74 6f 20 74 68 65 20 70 61 67 65 2d 73 69 e to the page-si
18780 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 6f ze of the file o
18790 6e 20 64 69 73 6b 2e 0a 20 20 20 20 2a 2f 0a 20 n disk.. */.
187a0 20 20 20 77 68 69 6c 65 28 20 70 42 74 2d 3e 70 while( pBt->p
187b0 50 61 67 65 31 3d 3d 30 20 26 26 20 53 51 4c 49 Page1==0 && SQLI
187c0 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 6c 6f 63 TE_OK==(rc = loc
187d0 6b 42 74 72 65 65 28 70 42 74 29 29 20 29 3b 0a kBtree(pBt)) );.
187e0 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
187f0 49 54 45 5f 4f 4b 20 26 26 20 77 72 66 6c 61 67 ITE_OK && wrflag
18800 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 28 70 ){. if( (p
18810 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
18820 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 TS_READ_ONLY)!=0
18830 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
18840 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
18850 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
18860 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
18870 74 65 33 50 61 67 65 72 42 65 67 69 6e 28 70 42 te3PagerBegin(pB
18880 74 2d 3e 70 50 61 67 65 72 2c 77 72 66 6c 61 67 t->pPager,wrflag
18890 3e 31 2c 73 71 6c 69 74 65 33 54 65 6d 70 49 6e >1,sqlite3TempIn
188a0 4d 65 6d 6f 72 79 28 70 2d 3e 64 62 29 29 3b 0a Memory(p->db));.
188b0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d if( rc==
188c0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
188d0 20 20 20 20 20 20 20 72 63 20 3d 20 6e 65 77 44 rc = newD
188e0 61 74 61 62 61 73 65 28 70 42 74 29 3b 0a 20 20 atabase(pBt);.
188f0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
18900 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 }. . if(
18910 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
18920 7b 0a 20 20 20 20 20 20 75 6e 6c 6f 63 6b 42 74 {. unlockBt
18930 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 29 reeIfUnused(pBt)
18940 3b 0a 20 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 ;. }. }while
18950 28 20 28 72 63 26 30 78 46 46 29 3d 3d 53 51 4c ( (rc&0xFF)==SQL
18960 49 54 45 5f 42 55 53 59 20 26 26 20 70 42 74 2d ITE_BUSY && pBt-
18970 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d >inTransaction==
18980 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 0a 20 20 TRANS_NONE &&.
18990 20 20 20 20 20 20 20 20 62 74 72 65 65 49 6e 76 btreeInv
189a0 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 70 okeBusyHandler(p
189b0 42 74 29 20 29 3b 0a 0a 20 20 69 66 28 20 72 63 Bt) );.. if( rc
189c0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
189d0 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e if( p->inTran
189e0 73 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b s==TRANS_NONE ){
189f0 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 54 72 61 . pBt->nTra
18a00 6e 73 61 63 74 69 6f 6e 2b 2b 3b 0a 23 69 66 6e nsaction++;.#ifn
18a10 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
18a20 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 20 SHARED_CACHE.
18a30 20 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 62 if( p->sharab
18a40 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 le ){. as
18a50 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b 2e 70 42 sert( p->lock.pB
18a60 74 72 65 65 3d 3d 70 20 26 26 20 70 2d 3e 6c 6f tree==p && p->lo
18a70 63 6b 2e 69 54 61 62 6c 65 3d 3d 31 20 29 3b 0a ck.iTable==1 );.
18a80 20 20 20 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e p->lock.
18a90 65 4c 6f 63 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 eLock = READ_LOC
18aa0 4b 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6c 6f K;. p->lo
18ab0 63 6b 2e 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e ck.pNext = pBt->
18ac0 70 4c 6f 63 6b 3b 0a 20 20 20 20 20 20 20 20 70 pLock;. p
18ad0 42 74 2d 3e 70 4c 6f 63 6b 20 3d 20 26 70 2d 3e Bt->pLock = &p->
18ae0 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 23 65 lock;. }.#e
18af0 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 20 70 ndif. }. p
18b00 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 28 77 72 66 ->inTrans = (wrf
18b10 6c 61 67 3f 54 52 41 4e 53 5f 57 52 49 54 45 3a lag?TRANS_WRITE:
18b20 54 52 41 4e 53 5f 52 45 41 44 29 3b 0a 20 20 20 TRANS_READ);.
18b30 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e if( p->inTrans>
18b40 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
18b50 6f 6e 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d on ){. pBt-
18b60 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d >inTransaction =
18b70 20 70 2d 3e 69 6e 54 72 61 6e 73 3b 0a 20 20 20 p->inTrans;.
18b80 20 7d 0a 20 20 20 20 69 66 28 20 77 72 66 6c 61 }. if( wrfla
18b90 67 20 29 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 g ){. MemPa
18ba0 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 ge *pPage1 = pBt
18bb0 2d 3e 70 50 61 67 65 31 3b 0a 23 69 66 6e 64 65 ->pPage1;.#ifnde
18bc0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 f SQLITE_OMIT_SH
18bd0 41 52 45 44 5f 43 41 43 48 45 0a 20 20 20 20 20 ARED_CACHE.
18be0 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e 70 assert( !pBt->p
18bf0 57 72 69 74 65 72 20 29 3b 0a 20 20 20 20 20 20 Writer );.
18c00 70 42 74 2d 3e 70 57 72 69 74 65 72 20 3d 20 70 pBt->pWriter = p
18c10 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 ;. pBt->bts
18c20 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f 45 58 Flags &= ~BTS_EX
18c30 43 4c 55 53 49 56 45 3b 0a 20 20 20 20 20 20 69 CLUSIVE;. i
18c40 66 28 20 77 72 66 6c 61 67 3e 31 20 29 20 70 42 f( wrflag>1 ) pB
18c50 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
18c60 54 53 5f 45 58 43 4c 55 53 49 56 45 3b 0a 23 65 TS_EXCLUSIVE;.#e
18c70 6e 64 69 66 0a 0a 20 20 20 20 20 20 2f 2a 20 49 ndif.. /* I
18c80 66 20 74 68 65 20 64 62 2d 73 69 7a 65 20 68 65 f the db-size he
18c90 61 64 65 72 20 66 69 65 6c 64 20 69 73 20 69 6e ader field is in
18ca0 63 6f 72 72 65 63 74 20 28 61 73 20 69 74 20 6d correct (as it m
18cb0 61 79 20 62 65 20 69 66 20 61 6e 20 6f 6c 64 0a ay be if an old.
18cc0 20 20 20 20 20 20 2a 2a 20 63 6c 69 65 6e 74 20 ** client
18cd0 68 61 73 20 62 65 65 6e 20 77 72 69 74 69 6e 67 has been writing
18ce0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
18cf0 6c 65 29 2c 20 75 70 64 61 74 65 20 69 74 20 6e le), update it n
18d00 6f 77 2e 20 44 6f 69 6e 67 0a 20 20 20 20 20 20 ow. Doing.
18d10 2a 2a 20 74 68 69 73 20 73 6f 6f 6e 65 72 20 72 ** this sooner r
18d20 61 74 68 65 72 20 74 68 61 6e 20 6c 61 74 65 72 ather than later
18d30 20 6d 65 61 6e 73 20 74 68 65 20 64 61 74 61 62 means the datab
18d40 61 73 65 20 73 69 7a 65 20 63 61 6e 20 73 61 66 ase size can saf
18d50 65 6c 79 20 0a 20 20 20 20 20 20 2a 2a 20 72 65 ely . ** re
18d60 2d 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61 -read the databa
18d70 73 65 20 73 69 7a 65 20 66 72 6f 6d 20 70 61 67 se size from pag
18d80 65 20 31 20 69 66 20 61 20 73 61 76 65 70 6f 69 e 1 if a savepoi
18d90 6e 74 20 6f 72 20 74 72 61 6e 73 61 63 74 69 6f nt or transactio
18da0 6e 0a 20 20 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 n. ** rollb
18db0 61 63 6b 20 6f 63 63 75 72 73 20 77 69 74 68 69 ack occurs withi
18dc0 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f n the transactio
18dd0 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 n.. */.
18de0 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 if( pBt->nPage
18df0 21 3d 67 65 74 34 62 79 74 65 28 26 70 50 61 67 !=get4byte(&pPag
18e00 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 29 20 29 e1->aData[28]) )
18e10 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 {. rc = s
18e20 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
18e30 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 (pPage1->pDbPage
18e40 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
18e50 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
18e60 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 put4by
18e70 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
18e80 61 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 a[28], pBt->nPag
18e90 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 e);. }.
18ea0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
18eb0 0a 0a 74 72 61 6e 73 5f 62 65 67 75 6e 3a 0a 20 ..trans_begun:.
18ec0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
18ed0 4f 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a OK && wrflag ){.
18ee0 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61 6c 6c /* This call
18ef0 20 6d 61 6b 65 73 20 73 75 72 65 20 74 68 61 74 makes sure that
18f00 20 74 68 65 20 70 61 67 65 72 20 68 61 73 20 74 the pager has t
18f10 68 65 20 63 6f 72 72 65 63 74 20 6e 75 6d 62 65 he correct numbe
18f20 72 20 6f 66 0a 20 20 20 20 2a 2a 20 6f 70 65 6e r of. ** open
18f30 20 73 61 76 65 70 6f 69 6e 74 73 2e 20 49 66 20 savepoints. If
18f40 74 68 65 20 73 65 63 6f 6e 64 20 70 61 72 61 6d the second param
18f50 65 74 65 72 20 69 73 20 67 72 65 61 74 65 72 20 eter is greater
18f60 74 68 61 6e 20 30 20 61 6e 64 0a 20 20 20 20 2a than 0 and. *
18f70 2a 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 * the sub-journa
18f80 6c 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 l is not already
18f90 20 6f 70 65 6e 2c 20 74 68 65 6e 20 69 74 20 77 open, then it w
18fa0 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 20 68 65 ill be opened he
18fb0 72 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 re.. */. r
18fc0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
18fd0 4f 70 65 6e 53 61 76 65 70 6f 69 6e 74 28 70 42 OpenSavepoint(pB
18fe0 74 2d 3e 70 50 61 67 65 72 2c 20 70 2d 3e 64 62 t->pPager, p->db
18ff0 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 ->nSavepoint);.
19000 20 7d 0a 0a 20 20 62 74 72 65 65 49 6e 74 65 67 }.. btreeInteg
19010 72 69 74 79 28 70 29 3b 0a 20 20 73 71 6c 69 74 rity(p);. sqlit
19020 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
19030 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
19040 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
19050 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
19060 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 70 ./*.** Set the p
19070 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 ointer-map entri
19080 65 73 20 66 6f 72 20 61 6c 6c 20 63 68 69 6c 64 es for all child
19090 72 65 6e 20 6f 66 20 70 61 67 65 20 70 50 61 67 ren of page pPag
190a0 65 2e 20 41 6c 73 6f 2c 20 69 66 0a 2a 2a 20 70 e. Also, if.** p
190b0 50 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 63 65 Page contains ce
190c0 6c 6c 73 20 74 68 61 74 20 70 6f 69 6e 74 20 74 lls that point t
190d0 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 o overflow pages
190e0 2c 20 73 65 74 20 74 68 65 20 70 6f 69 6e 74 65 , set the pointe
190f0 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 69 65 73 r.** map entries
19100 20 66 6f 72 20 74 68 65 20 6f 76 65 72 66 6c 6f for the overflo
19110 77 20 70 61 67 65 73 20 61 73 20 77 65 6c 6c 2e w pages as well.
19120 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
19130 65 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 4d etChildPtrmaps(M
19140 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 7b 0a emPage *pPage){.
19150 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 int i;
19160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19170 20 20 20 20 20 2f 2a 20 43 6f 75 6e 74 65 72 20 /* Counter
19180 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 69 6e variable */. in
19190 74 20 6e 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 t nCell;
191a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
191b0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 /* Number of ce
191c0 6c 6c 73 20 69 6e 20 70 61 67 65 20 70 50 61 67 lls in page pPag
191d0 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 e */. int rc;
191e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
191f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
19200 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 42 74 urn code */. Bt
19210 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 Shared *pBt = pP
19220 61 67 65 2d 3e 70 42 74 3b 0a 20 20 75 38 20 69 age->pBt;. u8 i
19230 73 49 6e 69 74 4f 72 69 67 20 3d 20 70 50 61 67 sInitOrig = pPag
19240 65 2d 3e 69 73 49 6e 69 74 3b 0a 20 20 50 67 6e e->isInit;. Pgn
19250 6f 20 70 67 6e 6f 20 3d 20 70 50 61 67 65 2d 3e o pgno = pPage->
19260 70 67 6e 6f 3b 0a 0a 20 20 61 73 73 65 72 74 28 pgno;.. assert(
19270 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
19280 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
19290 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d mutex) );. rc =
192a0 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 btreeInitPage(p
192b0 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 Page);. if( rc!
192c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
192d0 20 20 67 6f 74 6f 20 73 65 74 5f 63 68 69 6c 64 goto set_child
192e0 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3b 0a 20 20 _ptrmaps_out;.
192f0 7d 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 }. nCell = pPag
19300 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 66 6f 72 e->nCell;.. for
19310 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 (i=0; i<nCell; i
19320 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 ++){. u8 *pCe
19330 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 ll = findCell(pP
19340 61 67 65 2c 20 69 29 3b 0a 0a 20 20 20 20 70 74 age, i);.. pt
19350 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 28 70 rmapPutOvflPtr(p
19360 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 72 63 Page, pCell, &rc
19370 29 3b 0a 0a 20 20 20 20 69 66 28 20 21 70 50 61 );.. if( !pPa
19380 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 ge->leaf ){.
19390 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 67 6e 6f Pgno childPgno
193a0 20 3d 20 67 65 74 34 62 79 74 65 28 70 43 65 6c = get4byte(pCel
193b0 6c 29 3b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 l);. ptrmap
193c0 50 75 74 28 70 42 74 2c 20 63 68 69 6c 64 50 67 Put(pBt, childPg
193d0 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 54 52 45 45 no, PTRMAP_BTREE
193e0 2c 20 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 , pgno, &rc);.
193f0 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 21 }. }.. if( !
19400 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 pPage->leaf ){.
19410 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 67 6e Pgno childPgn
19420 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 o = get4byte(&pP
19430 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 age->aData[pPage
19440 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b ->hdrOffset+8]);
19450 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 . ptrmapPut(p
19460 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 50 Bt, childPgno, P
19470 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 6e TRMAP_BTREE, pgn
19480 6f 2c 20 26 72 63 29 3b 0a 20 20 7d 0a 0a 73 65 o, &rc);. }..se
19490 74 5f 63 68 69 6c 64 5f 70 74 72 6d 61 70 73 5f t_child_ptrmaps_
194a0 6f 75 74 3a 0a 20 20 70 50 61 67 65 2d 3e 69 73 out:. pPage->is
194b0 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 4f 72 69 Init = isInitOri
194c0 67 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a g;. return rc;.
194d0 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 77 68 65 }../*.** Somewhe
194e0 72 65 20 6f 6e 20 70 50 61 67 65 20 69 73 20 61 re on pPage is a
194f0 20 70 6f 69 6e 74 65 72 20 74 6f 20 70 61 67 65 pointer to page
19500 20 69 46 72 6f 6d 2e 20 20 4d 6f 64 69 66 79 20 iFrom. Modify
19510 74 68 69 73 20 70 6f 69 6e 74 65 72 20 73 6f 0a this pointer so.
19520 2a 2a 20 74 68 61 74 20 69 74 20 70 6f 69 6e 74 ** that it point
19530 73 20 74 6f 20 69 54 6f 2e 20 50 61 72 61 6d 65 s to iTo. Parame
19540 74 65 72 20 65 54 79 70 65 20 64 65 73 63 72 69 ter eType descri
19550 62 65 73 20 74 68 65 20 74 79 70 65 20 6f 66 20 bes the type of
19560 70 6f 69 6e 74 65 72 20 74 6f 0a 2a 2a 20 62 65 pointer to.** be
19570 20 6d 6f 64 69 66 69 65 64 2c 20 61 73 20 20 66 modified, as f
19580 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 50 54 ollows:.**.** PT
19590 52 4d 41 50 5f 42 54 52 45 45 3a 20 20 20 20 20 RMAP_BTREE:
195a0 70 50 61 67 65 20 69 73 20 61 20 62 74 72 65 65 pPage is a btree
195b0 2d 70 61 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 -page. The point
195c0 65 72 20 70 6f 69 6e 74 73 20 61 74 20 61 20 63 er points at a c
195d0 68 69 6c 64 20 0a 2a 2a 20 20 20 20 20 20 20 20 hild .**
195e0 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 20 page
195f0 6f 66 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 of pPage..**.**
19600 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 PTRMAP_OVERFLOW1
19610 3a 20 70 50 61 67 65 20 69 73 20 61 20 62 74 72 : pPage is a btr
19620 65 65 2d 70 61 67 65 2e 20 54 68 65 20 70 6f 69 ee-page. The poi
19630 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 74 20 61 nter points at a
19640 6e 20 6f 76 65 72 66 6c 6f 77 0a 2a 2a 20 20 20 n overflow.**
19650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19660 70 61 67 65 20 70 6f 69 6e 74 65 64 20 74 6f 20 page pointed to
19670 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 63 65 by one of the ce
19680 6c 6c 73 20 6f 6e 20 70 50 61 67 65 2e 0a 2a 2a lls on pPage..**
19690 0a 2a 2a 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 .** PTRMAP_OVERF
196a0 4c 4f 57 32 3a 20 70 50 61 67 65 20 69 73 20 61 LOW2: pPage is a
196b0 6e 20 6f 76 65 72 66 6c 6f 77 2d 70 61 67 65 2e n overflow-page.
196c0 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 The pointer poi
196d0 6e 74 73 20 61 74 20 74 68 65 20 6e 65 78 74 0a nts at the next.
196e0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
196f0 20 20 20 20 20 6f 76 65 72 66 6c 6f 77 20 70 61 overflow pa
19700 67 65 20 69 6e 20 74 68 65 20 6c 69 73 74 2e 0a ge in the list..
19710 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f */.static int mo
19720 64 69 66 79 50 61 67 65 50 6f 69 6e 74 65 72 28 difyPagePointer(
19730 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
19740 50 67 6e 6f 20 69 46 72 6f 6d 2c 20 50 67 6e 6f Pgno iFrom, Pgno
19750 20 69 54 6f 2c 20 75 38 20 65 54 79 70 65 29 7b iTo, u8 eType){
19760 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
19770 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 e3_mutex_held(pP
19780 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 age->pBt->mutex)
19790 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
197a0 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
197b0 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
197c0 50 61 67 65 29 20 29 3b 0a 20 20 69 66 28 20 65 Page) );. if( e
197d0 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 Type==PTRMAP_OVE
197e0 52 46 4c 4f 57 32 20 29 7b 0a 20 20 20 20 2f 2a RFLOW2 ){. /*
197f0 20 54 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 The pointer is
19800 61 6c 77 61 79 73 20 74 68 65 20 66 69 72 73 74 always the first
19810 20 34 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 4 bytes of the
19820 70 61 67 65 20 69 6e 20 74 68 69 73 20 63 61 73 page in this cas
19830 65 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 67 e. */. if( g
19840 65 74 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 et4byte(pPage->a
19850 44 61 74 61 29 21 3d 69 46 72 6f 6d 20 29 7b 0a Data)!=iFrom ){.
19860 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
19870 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
19880 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 75 74 34 ;. }. put4
19890 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 byte(pPage->aDat
198a0 61 2c 20 69 54 6f 29 3b 0a 20 20 7d 65 6c 73 65 a, iTo);. }else
198b0 7b 0a 20 20 20 20 75 38 20 69 73 49 6e 69 74 4f {. u8 isInitO
198c0 72 69 67 20 3d 20 70 50 61 67 65 2d 3e 69 73 49 rig = pPage->isI
198d0 6e 69 74 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a nit;. int i;.
198e0 20 20 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 0a 0a int nCell;..
198f0 20 20 20 20 62 74 72 65 65 49 6e 69 74 50 61 67 btreeInitPag
19900 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 6e 43 e(pPage);. nC
19910 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 ell = pPage->nCe
19920 6c 6c 3b 0a 0a 20 20 20 20 66 6f 72 28 69 3d 30 ll;.. for(i=0
19930 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b ; i<nCell; i++){
19940 0a 20 20 20 20 20 20 75 38 20 2a 70 43 65 6c 6c . u8 *pCell
19950 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 = findCell(pPag
19960 65 2c 20 69 29 3b 0a 20 20 20 20 20 20 69 66 28 e, i);. if(
19970 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f eType==PTRMAP_O
19980 56 45 52 46 4c 4f 57 31 20 29 7b 0a 20 20 20 20 VERFLOW1 ){.
19990 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 CellInfo inf
199a0 6f 3b 0a 20 20 20 20 20 20 20 20 62 74 72 65 65 o;. btree
199b0 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 ParseCellPtr(pPa
199c0 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f ge, pCell, &info
199d0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 );. if( i
199e0 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 0a 20 20 nfo.iOverflow.
199f0 20 20 20 20 20 20 20 26 26 20 70 43 65 6c 6c 2b && pCell+
19a00 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 2b 33 info.iOverflow+3
19a10 3c 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 2b 70 <=pPage->aData+p
19a20 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 0a 20 Page->maskPage.
19a30 20 20 20 20 20 20 20 20 26 26 20 69 46 72 6f 6d && iFrom
19a40 3d 3d 67 65 74 34 62 79 74 65 28 26 70 43 65 6c ==get4byte(&pCel
19a50 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 l[info.iOverflow
19a60 5d 29 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 ]). ){.
19a70 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 put4byte
19a80 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 (&pCell[info.iOv
19a90 65 72 66 6c 6f 77 5d 2c 20 69 54 6f 29 3b 0a 20 erflow], iTo);.
19aa0 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
19ab0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
19ac0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 69 }else{. i
19ad0 66 28 20 67 65 74 34 62 79 74 65 28 70 43 65 6c f( get4byte(pCel
19ae0 6c 29 3d 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 l)==iFrom ){.
19af0 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
19b00 70 43 65 6c 6c 2c 20 69 54 6f 29 3b 0a 20 20 20 pCell, iTo);.
19b10 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
19b20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
19b30 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 }. . if(
19b40 20 69 3d 3d 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 i==nCell ){.
19b50 20 20 20 69 66 28 20 65 54 79 70 65 21 3d 50 54 if( eType!=PT
19b60 52 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 0a 20 RMAP_BTREE || .
19b70 20 20 20 20 20 20 20 20 20 67 65 74 34 62 79 74 get4byt
19b80 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b e(&pPage->aData[
19b90 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
19ba0 2b 38 5d 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 +8])!=iFrom ){.
19bb0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
19bc0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
19bd0 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 T;. }.
19be0 20 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 put4byte(&pPage
19bf0 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 ->aData[pPage->h
19c00 64 72 4f 66 66 73 65 74 2b 38 5d 2c 20 69 54 6f drOffset+8], iTo
19c10 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 50 );. }.. pP
19c20 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 69 73 age->isInit = is
19c30 49 6e 69 74 4f 72 69 67 3b 0a 20 20 7d 0a 20 20 InitOrig;. }.
19c40 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
19c50 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 ;.}.../*.** Move
19c60 20 74 68 65 20 6f 70 65 6e 20 64 61 74 61 62 61 the open databa
19c70 73 65 20 70 61 67 65 20 70 44 62 50 61 67 65 20 se page pDbPage
19c80 74 6f 20 6c 6f 63 61 74 69 6f 6e 20 69 46 72 65 to location iFre
19c90 65 50 61 67 65 20 69 6e 20 74 68 65 20 0a 2a 2a ePage in the .**
19ca0 20 64 61 74 61 62 61 73 65 2e 20 54 68 65 20 70 database. The p
19cb0 44 62 50 61 67 65 20 72 65 66 65 72 65 6e 63 65 DbPage reference
19cc0 20 72 65 6d 61 69 6e 73 20 76 61 6c 69 64 2e 0a remains valid..
19cd0 2a 2a 0a 2a 2a 20 54 68 65 20 69 73 43 6f 6d 6d **.** The isComm
19ce0 69 74 20 66 6c 61 67 20 69 6e 64 69 63 61 74 65 it flag indicate
19cf0 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 s that there is
19d00 6e 6f 20 6e 65 65 64 20 74 6f 20 72 65 6d 65 6d no need to remem
19d10 62 65 72 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 ber that.** the
19d20 6a 6f 75 72 6e 61 6c 20 6e 65 65 64 73 20 74 6f journal needs to
19d30 20 62 65 20 73 79 6e 63 28 29 65 64 20 62 65 66 be sync()ed bef
19d40 6f 72 65 20 64 61 74 61 62 61 73 65 20 70 61 67 ore database pag
19d50 65 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 20 e pDbPage->pgno
19d60 0a 2a 2a 20 63 61 6e 20 62 65 20 77 72 69 74 74 .** can be writt
19d70 65 6e 20 74 6f 2e 20 54 68 65 20 63 61 6c 6c 65 en to. The calle
19d80 72 20 68 61 73 20 61 6c 72 65 61 64 79 20 70 72 r has already pr
19d90 6f 6d 69 73 65 64 20 6e 6f 74 20 74 6f 20 77 72 omised not to wr
19da0 69 74 65 20 74 6f 20 74 68 61 74 0a 2a 2a 20 70 ite to that.** p
19db0 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 age..*/.static i
19dc0 6e 74 20 72 65 6c 6f 63 61 74 65 50 61 67 65 28 nt relocatePage(
19dd0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
19de0 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 , /* B
19df0 74 72 65 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 tree */. MemPag
19e00 65 20 2a 70 44 62 50 61 67 65 2c 20 20 20 20 20 e *pDbPage,
19e10 20 20 20 2f 2a 20 4f 70 65 6e 20 70 61 67 65 20 /* Open page
19e20 74 6f 20 6d 6f 76 65 20 2a 2f 0a 20 20 75 38 20 to move */. u8
19e30 65 54 79 70 65 2c 20 20 20 20 20 20 20 20 20 20 eType,
19e40 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
19e50 20 6d 61 70 20 27 74 79 70 65 27 20 65 6e 74 72 map 'type' entr
19e60 79 20 66 6f 72 20 70 44 62 50 61 67 65 20 2a 2f y for pDbPage */
19e70 0a 20 20 50 67 6e 6f 20 69 50 74 72 50 61 67 65 . Pgno iPtrPage
19e80 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 , /* P
19e90 6f 69 6e 74 65 72 20 6d 61 70 20 27 70 61 67 65 ointer map 'page
19ea0 2d 6e 6f 27 20 65 6e 74 72 79 20 66 6f 72 20 70 -no' entry for p
19eb0 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f DbPage */. Pgno
19ec0 20 69 46 72 65 65 50 61 67 65 2c 20 20 20 20 20 iFreePage,
19ed0 20 20 20 20 20 2f 2a 20 54 68 65 20 6c 6f 63 61 /* The loca
19ee0 74 69 6f 6e 20 74 6f 20 6d 6f 76 65 20 70 44 62 tion to move pDb
19ef0 50 61 67 65 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 Page to */. int
19f00 20 69 73 43 6f 6d 6d 69 74 20 20 20 20 20 20 20 isCommit
19f10 20 20 20 20 20 20 2f 2a 20 69 73 43 6f 6d 6d 69 /* isCommi
19f20 74 20 66 6c 61 67 20 70 61 73 73 65 64 20 74 6f t flag passed to
19f30 20 73 71 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 sqlite3PagerMov
19f40 65 70 61 67 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 epage */.){. Me
19f50 6d 50 61 67 65 20 2a 70 50 74 72 50 61 67 65 3b mPage *pPtrPage;
19f60 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 74 /* The page t
19f70 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 hat contains a p
19f80 6f 69 6e 74 65 72 20 74 6f 20 70 44 62 50 61 67 ointer to pDbPag
19f90 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 44 62 50 e */. Pgno iDbP
19fa0 61 67 65 20 3d 20 70 44 62 50 61 67 65 2d 3e 70 age = pDbPage->p
19fb0 67 6e 6f 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 gno;. Pager *pP
19fc0 61 67 65 72 20 3d 20 70 42 74 2d 3e 70 50 61 67 ager = pBt->pPag
19fd0 65 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 er;. int rc;..
19fe0 20 61 73 73 65 72 74 28 20 65 54 79 70 65 3d 3d assert( eType==
19ff0 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
1a000 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 || eType==PTRMA
1a010 50 5f 4f 56 45 52 46 4c 4f 57 31 20 7c 7c 20 0a P_OVERFLOW1 || .
1a020 20 20 20 20 20 20 65 54 79 70 65 3d 3d 50 54 52 eType==PTR
1a030 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 MAP_BTREE || eTy
1a040 70 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 pe==PTRMAP_ROOTP
1a050 41 47 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 AGE );. assert(
1a060 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
1a070 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
1a080 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 44 62 );. assert( pDb
1a090 50 61 67 65 2d 3e 70 42 74 3d 3d 70 42 74 20 29 Page->pBt==pBt )
1a0a0 3b 0a 0a 20 20 2f 2a 20 4d 6f 76 65 20 70 61 67 ;.. /* Move pag
1a0b0 65 20 69 44 62 50 61 67 65 20 66 72 6f 6d 20 69 e iDbPage from i
1a0c0 74 73 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 ts current locat
1a0d0 69 6f 6e 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 ion to page numb
1a0e0 65 72 20 69 46 72 65 65 50 61 67 65 20 2a 2f 0a er iFreePage */.
1a0f0 20 20 54 52 41 43 45 28 28 22 41 55 54 4f 56 41 TRACE(("AUTOVA
1a100 43 55 55 4d 3a 20 4d 6f 76 69 6e 67 20 25 64 20 CUUM: Moving %d
1a110 74 6f 20 66 72 65 65 20 70 61 67 65 20 25 64 20 to free page %d
1a120 28 70 74 72 20 70 61 67 65 20 25 64 20 74 79 70 (ptr page %d typ
1a130 65 20 25 64 29 5c 6e 22 2c 20 0a 20 20 20 20 20 e %d)\n", .
1a140 20 69 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 iDbPage, iFreeP
1a150 61 67 65 2c 20 69 50 74 72 50 61 67 65 2c 20 65 age, iPtrPage, e
1a160 54 79 70 65 29 29 3b 0a 20 20 72 63 20 3d 20 73 Type));. rc = s
1a170 71 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 qlite3PagerMovep
1a180 61 67 65 28 70 50 61 67 65 72 2c 20 70 44 62 50 age(pPager, pDbP
1a190 61 67 65 2d 3e 70 44 62 50 61 67 65 2c 20 69 46 age->pDbPage, iF
1a1a0 72 65 65 50 61 67 65 2c 20 69 73 43 6f 6d 6d 69 reePage, isCommi
1a1b0 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 t);. if( rc!=SQ
1a1c0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
1a1d0 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 eturn rc;. }.
1a1e0 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 pDbPage->pgno =
1a1f0 69 46 72 65 65 50 61 67 65 3b 0a 0a 20 20 2f 2a iFreePage;.. /*
1a200 20 49 66 20 70 44 62 50 61 67 65 20 77 61 73 20 If pDbPage was
1a210 61 20 62 74 72 65 65 2d 70 61 67 65 2c 20 74 68 a btree-page, th
1a220 65 6e 20 69 74 20 6d 61 79 20 68 61 76 65 20 63 en it may have c
1a230 68 69 6c 64 20 70 61 67 65 73 20 61 6e 64 2f 6f hild pages and/o
1a240 72 20 63 65 6c 6c 73 0a 20 20 2a 2a 20 74 68 61 r cells. ** tha
1a250 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 65 72 66 t point to overf
1a260 6c 6f 77 20 70 61 67 65 73 2e 20 54 68 65 20 70 low pages. The p
1a270 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 69 ointer map entri
1a280 65 73 20 66 6f 72 20 61 6c 6c 20 74 68 65 73 65 es for all these
1a290 0a 20 20 2a 2a 20 70 61 67 65 73 20 6e 65 65 64 . ** pages need
1a2a0 20 74 6f 20 62 65 20 63 68 61 6e 67 65 64 2e 0a to be changed..
1a2b0 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 70 44 62 **. ** If pDb
1a2c0 50 61 67 65 20 69 73 20 61 6e 20 6f 76 65 72 66 Page is an overf
1a2d0 6c 6f 77 20 70 61 67 65 2c 20 74 68 65 6e 20 74 low page, then t
1a2e0 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 he first 4 bytes
1a2f0 20 6d 61 79 20 73 74 6f 72 65 20 61 0a 20 20 2a may store a. *
1a300 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 * pointer to a s
1a310 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 66 6c ubsequent overfl
1a320 6f 77 20 70 61 67 65 2e 20 49 66 20 74 68 69 73 ow page. If this
1a330 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 74 68 is the case, th
1a340 65 6e 0a 20 20 2a 2a 20 74 68 65 20 70 6f 69 6e en. ** the poin
1a350 74 65 72 20 6d 61 70 20 6e 65 65 64 73 20 74 6f ter map needs to
1a360 20 62 65 20 75 70 64 61 74 65 64 20 66 6f 72 20 be updated for
1a370 74 68 65 20 73 75 62 73 65 71 75 65 6e 74 20 6f the subsequent o
1a380 76 65 72 66 6c 6f 77 20 70 61 67 65 2e 0a 20 20 verflow page..
1a390 2a 2f 0a 20 20 69 66 28 20 65 54 79 70 65 3d 3d */. if( eType==
1a3a0 50 54 52 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 PTRMAP_BTREE ||
1a3b0 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 52 4f eType==PTRMAP_RO
1a3c0 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 72 63 OTPAGE ){. rc
1a3d0 20 3d 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 = setChildPtrma
1a3e0 70 73 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 ps(pDbPage);.
1a3f0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1a400 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 OK ){. retu
1a410 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d rn rc;. }. }
1a420 65 6c 73 65 7b 0a 20 20 20 20 50 67 6e 6f 20 6e else{. Pgno n
1a430 65 78 74 4f 76 66 6c 20 3d 20 67 65 74 34 62 79 extOvfl = get4by
1a440 74 65 28 70 44 62 50 61 67 65 2d 3e 61 44 61 74 te(pDbPage->aDat
1a450 61 29 3b 0a 20 20 20 20 69 66 28 20 6e 65 78 74 a);. if( next
1a460 4f 76 66 6c 21 3d 30 20 29 7b 0a 20 20 20 20 20 Ovfl!=0 ){.
1a470 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 ptrmapPut(pBt,
1a480 6e 65 78 74 4f 76 66 6c 2c 20 50 54 52 4d 41 50 nextOvfl, PTRMAP
1a490 5f 4f 56 45 52 46 4c 4f 57 32 2c 20 69 46 72 65 _OVERFLOW2, iFre
1a4a0 65 50 61 67 65 2c 20 26 72 63 29 3b 0a 20 20 20 ePage, &rc);.
1a4b0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1a4c0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
1a4d0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
1a4e0 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 }. }. }..
1a4f0 2f 2a 20 46 69 78 20 74 68 65 20 64 61 74 61 62 /* Fix the datab
1a500 61 73 65 20 70 6f 69 6e 74 65 72 20 6f 6e 20 70 ase pointer on p
1a510 61 67 65 20 69 50 74 72 50 61 67 65 20 74 68 61 age iPtrPage tha
1a520 74 20 70 6f 69 6e 74 65 64 20 61 74 20 69 44 62 t pointed at iDb
1a530 50 61 67 65 20 73 6f 0a 20 20 2a 2a 20 74 68 61 Page so. ** tha
1a540 74 20 69 74 20 70 6f 69 6e 74 73 20 61 74 20 69 t it points at i
1a550 46 72 65 65 50 61 67 65 2e 20 41 6c 73 6f 20 66 FreePage. Also f
1a560 69 78 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d ix the pointer m
1a570 61 70 20 65 6e 74 72 79 20 66 6f 72 0a 20 20 2a ap entry for. *
1a580 2a 20 69 50 74 72 50 61 67 65 2e 0a 20 20 2a 2f * iPtrPage.. */
1a590 0a 20 20 69 66 28 20 65 54 79 70 65 21 3d 50 54 . if( eType!=PT
1a5a0 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b RMAP_ROOTPAGE ){
1a5b0 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 . rc = btreeG
1a5c0 65 74 50 61 67 65 28 70 42 74 2c 20 69 50 74 72 etPage(pBt, iPtr
1a5d0 50 61 67 65 2c 20 26 70 50 74 72 50 61 67 65 2c Page, &pPtrPage,
1a5e0 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 0);. if( rc!
1a5f0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1a600 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1a610 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 }. rc = sq
1a620 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
1a630 70 50 74 72 50 61 67 65 2d 3e 70 44 62 50 61 67 pPtrPage->pDbPag
1a640 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
1a650 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1a660 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
1a670 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 20 20 PtrPage);.
1a680 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
1a690 0a 20 20 20 20 72 63 20 3d 20 6d 6f 64 69 66 79 . rc = modify
1a6a0 50 61 67 65 50 6f 69 6e 74 65 72 28 70 50 74 72 PagePointer(pPtr
1a6b0 50 61 67 65 2c 20 69 44 62 50 61 67 65 2c 20 69 Page, iDbPage, i
1a6c0 46 72 65 65 50 61 67 65 2c 20 65 54 79 70 65 29 FreePage, eType)
1a6d0 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 ;. releasePag
1a6e0 65 28 70 50 74 72 50 61 67 65 29 3b 0a 20 20 20 e(pPtrPage);.
1a6f0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1a700 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d OK ){. ptrm
1a710 61 70 50 75 74 28 70 42 74 2c 20 69 46 72 65 65 apPut(pBt, iFree
1a720 50 61 67 65 2c 20 65 54 79 70 65 2c 20 69 50 74 Page, eType, iPt
1a730 72 50 61 67 65 2c 20 26 72 63 29 3b 0a 20 20 20 rPage, &rc);.
1a740 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
1a750 72 63 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 rc;.}../* Forwar
1a760 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 72 65 d declaration re
1a770 71 75 69 72 65 64 20 62 79 20 69 6e 63 72 56 61 quired by incrVa
1a780 63 75 75 6d 53 74 65 70 28 29 2e 20 2a 2f 0a 73 cuumStep(). */.s
1a790 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 tatic int alloca
1a7a0 74 65 42 74 72 65 65 50 61 67 65 28 42 74 53 68 teBtreePage(BtSh
1a7b0 61 72 65 64 20 2a 2c 20 4d 65 6d 50 61 67 65 20 ared *, MemPage
1a7c0 2a 2a 2c 20 50 67 6e 6f 20 2a 2c 20 50 67 6e 6f **, Pgno *, Pgno
1a7d0 2c 20 75 38 29 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 , u8);../*.** Pe
1a7e0 72 66 6f 72 6d 20 61 20 73 69 6e 67 6c 65 20 73 rform a single s
1a7f0 74 65 70 20 6f 66 20 61 6e 20 69 6e 63 72 65 6d tep of an increm
1a800 65 6e 74 61 6c 2d 76 61 63 75 75 6d 2e 20 49 66 ental-vacuum. If
1a810 20 73 75 63 63 65 73 73 66 75 6c 2c 20 72 65 74 successful, ret
1a820 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b urn.** SQLITE_OK
1a830 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f . If there is no
1a840 20 77 6f 72 6b 20 74 6f 20 64 6f 20 28 61 6e 64 work to do (and
1a850 20 74 68 65 72 65 66 6f 72 65 20 6e 6f 20 70 6f therefore no po
1a860 69 6e 74 20 69 6e 20 0a 2a 2a 20 63 61 6c 6c 69 int in .** calli
1a870 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ng this function
1a880 20 61 67 61 69 6e 29 2c 20 72 65 74 75 72 6e 20 again), return
1a890 53 51 4c 49 54 45 5f 44 4f 4e 45 2e 20 4f 72 2c SQLITE_DONE. Or,
1a8a0 20 69 66 20 61 6e 20 65 72 72 6f 72 20 0a 2a 2a if an error .**
1a8b0 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72 6e 20 occurs, return
1a8c0 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72 some other error
1a8d0 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 code..**.** Mor
1a8e0 65 20 73 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 e specifically,
1a8f0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 this function at
1a900 74 65 6d 70 74 73 20 74 6f 20 72 65 2d 6f 72 67 tempts to re-org
1a910 61 6e 69 7a 65 20 74 68 65 20 64 61 74 61 62 61 anize the databa
1a920 73 65 20 73 6f 20 0a 2a 2a 20 74 68 61 74 20 74 se so .** that t
1a930 68 65 20 6c 61 73 74 20 70 61 67 65 20 6f 66 20 he last page of
1a940 74 68 65 20 66 69 6c 65 20 63 75 72 72 65 6e 74 the file current
1a950 6c 79 20 69 6e 20 75 73 65 20 69 73 20 6e 6f 20 ly in use is no
1a960 6c 6f 6e 67 65 72 20 69 6e 20 75 73 65 2e 0a 2a longer in use..*
1a970 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 6e *.** Parameter n
1a980 46 69 6e 20 69 73 20 74 68 65 20 6e 75 6d 62 65 Fin is the numbe
1a990 72 20 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 r of pages that
1a9a0 74 68 69 73 20 64 61 74 61 62 61 73 65 20 77 6f this database wo
1a9b0 75 6c 64 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 77 uld contain.** w
1a9c0 65 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f ere this functio
1a9d0 6e 20 63 61 6c 6c 65 64 20 75 6e 74 69 6c 20 69 n called until i
1a9e0 74 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 t returns SQLITE
1a9f0 5f 44 4f 4e 45 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 _DONE..**.** If
1aa00 74 68 65 20 62 43 6f 6d 6d 69 74 20 70 61 72 61 the bCommit para
1aa10 6d 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 meter is non-zer
1aa20 6f 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e o, this function
1aa30 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 74 68 assumes that th
1aa40 65 20 0a 2a 2a 20 63 61 6c 6c 65 72 20 77 69 6c e .** caller wil
1aa50 6c 20 6b 65 65 70 20 63 61 6c 6c 69 6e 67 20 69 l keep calling i
1aa60 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 29 20 ncrVacuumStep()
1aa70 75 6e 74 69 6c 20 69 74 20 72 65 74 75 72 6e 73 until it returns
1aa80 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 0a 2a 2a SQLITE_DONE .**
1aa90 20 6f 72 20 61 6e 20 65 72 72 6f 72 2e 20 62 43 or an error. bC
1aaa0 6f 6d 6d 69 74 20 69 73 20 70 61 73 73 65 64 20 ommit is passed
1aab0 74 72 75 65 20 66 6f 72 20 61 6e 20 61 75 74 6f true for an auto
1aac0 2d 76 61 63 75 75 6d 2d 6f 6e 2d 63 6f 6d 6d 69 -vacuum-on-commi
1aad0 74 20 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 2c t .** operation,
1aae0 20 6f 72 20 66 61 6c 73 65 20 66 6f 72 20 61 6e or false for an
1aaf0 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 incremental vac
1ab00 75 75 6d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 uum..*/.static i
1ab10 6e 74 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 nt incrVacuumSte
1ab20 70 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c p(BtShared *pBt,
1ab30 20 50 67 6e 6f 20 6e 46 69 6e 2c 20 50 67 6e 6f Pgno nFin, Pgno
1ab40 20 69 4c 61 73 74 50 67 2c 20 69 6e 74 20 62 43 iLastPg, int bC
1ab50 6f 6d 6d 69 74 29 7b 0a 20 20 50 67 6e 6f 20 6e ommit){. Pgno n
1ab60 46 72 65 65 4c 69 73 74 3b 20 20 20 20 20 20 20 FreeList;
1ab70 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1ab80 20 70 61 67 65 73 20 73 74 69 6c 6c 20 6f 6e 20 pages still on
1ab90 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 2a 2f the free-list */
1aba0 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
1abb0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
1abc0 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
1abd0 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
1abe0 28 20 69 4c 61 73 74 50 67 3e 6e 46 69 6e 20 29 ( iLastPg>nFin )
1abf0 3b 0a 0a 20 20 69 66 28 20 21 50 54 52 4d 41 50 ;.. if( !PTRMAP
1ac00 5f 49 53 50 41 47 45 28 70 42 74 2c 20 69 4c 61 _ISPAGE(pBt, iLa
1ac10 73 74 50 67 29 20 26 26 20 69 4c 61 73 74 50 67 stPg) && iLastPg
1ac20 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 !=PENDING_BYTE_P
1ac30 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 AGE(pBt) ){.
1ac40 75 38 20 65 54 79 70 65 3b 0a 20 20 20 20 50 67 u8 eType;. Pg
1ac50 6e 6f 20 69 50 74 72 50 61 67 65 3b 0a 0a 20 20 no iPtrPage;..
1ac60 20 20 6e 46 72 65 65 4c 69 73 74 20 3d 20 67 65 nFreeList = ge
1ac70 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
1ac80 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b ge1->aData[36]);
1ac90 0a 20 20 20 20 69 66 28 20 6e 46 72 65 65 4c 69 . if( nFreeLi
1aca0 73 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 st==0 ){. r
1acb0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e eturn SQLITE_DON
1acc0 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 72 63 E;. }.. rc
1acd0 20 3d 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 = ptrmapGet(pBt
1ace0 2c 20 69 4c 61 73 74 50 67 2c 20 26 65 54 79 70 , iLastPg, &eTyp
1acf0 65 2c 20 26 69 50 74 72 50 61 67 65 29 3b 0a 20 e, &iPtrPage);.
1ad00 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1ad10 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
1ad20 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
1ad30 20 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 if( eType==PT
1ad40 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b RMAP_ROOTPAGE ){
1ad50 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
1ad60 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
1ad70 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 T;. }.. if
1ad80 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
1ad90 46 52 45 45 50 41 47 45 20 29 7b 0a 20 20 20 20 FREEPAGE ){.
1ada0 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 if( bCommit==0
1adb0 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 52 ){. /* R
1adc0 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20 66 emove the page f
1add0 72 6f 6d 20 74 68 65 20 66 69 6c 65 73 20 66 72 rom the files fr
1ade0 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 69 73 ee-list. This is
1adf0 20 6e 6f 74 20 72 65 71 75 69 72 65 64 0a 20 20 not required.
1ae00 20 20 20 20 20 20 2a 2a 20 69 66 20 62 43 6f 6d ** if bCom
1ae10 6d 69 74 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e mit is non-zero.
1ae20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 74 In that case, t
1ae30 68 65 20 66 72 65 65 2d 6c 69 73 74 20 77 69 6c he free-list wil
1ae40 6c 20 62 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 l be. **
1ae50 74 72 75 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 truncated to zer
1ae60 6f 20 61 66 74 65 72 20 74 68 69 73 20 66 75 6e o after this fun
1ae70 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2c 20 73 ction returns, s
1ae80 6f 20 69 74 20 64 6f 65 73 6e 27 74 20 0a 20 20 o it doesn't .
1ae90 20 20 20 20 20 20 2a 2a 20 6d 61 74 74 65 72 20 ** matter
1aea0 69 66 20 69 74 20 73 74 69 6c 6c 20 63 6f 6e 74 if it still cont
1aeb0 61 69 6e 73 20 73 6f 6d 65 20 67 61 72 62 61 67 ains some garbag
1aec0 65 20 65 6e 74 72 69 65 73 2e 0a 20 20 20 20 20 e entries..
1aed0 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 50 67 */. Pg
1aee0 6e 6f 20 69 46 72 65 65 50 67 3b 0a 20 20 20 20 no iFreePg;.
1aef0 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 MemPage *pFr
1af00 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 72 63 eePg;. rc
1af10 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 = allocateBtree
1af20 50 61 67 65 28 70 42 74 2c 20 26 70 46 72 65 65 Page(pBt, &pFree
1af30 50 67 2c 20 26 69 46 72 65 65 50 67 2c 20 69 4c Pg, &iFreePg, iL
1af40 61 73 74 50 67 2c 20 42 54 41 4c 4c 4f 43 5f 45 astPg, BTALLOC_E
1af50 58 41 43 54 29 3b 0a 20 20 20 20 20 20 20 20 69 XACT);. i
1af60 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1af70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
1af80 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 turn rc;.
1af90 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 }. asser
1afa0 74 28 20 69 46 72 65 65 50 67 3d 3d 69 4c 61 73 t( iFreePg==iLas
1afb0 74 50 67 20 29 3b 0a 20 20 20 20 20 20 20 20 72 tPg );. r
1afc0 65 6c 65 61 73 65 50 61 67 65 28 70 46 72 65 65 eleasePage(pFree
1afd0 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 Pg);. }.
1afe0 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 } else {.
1aff0 50 67 6e 6f 20 69 46 72 65 65 50 67 3b 20 20 20 Pgno iFreePg;
1b000 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
1b010 65 78 20 6f 66 20 66 72 65 65 20 70 61 67 65 20 ex of free page
1b020 74 6f 20 6d 6f 76 65 20 70 4c 61 73 74 50 67 20 to move pLastPg
1b030 74 6f 20 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 to */. MemP
1b040 61 67 65 20 2a 70 4c 61 73 74 50 67 3b 0a 20 20 age *pLastPg;.
1b050 20 20 20 20 75 38 20 65 4d 6f 64 65 20 3d 20 42 u8 eMode = B
1b060 54 41 4c 4c 4f 43 5f 41 4e 59 3b 20 20 20 2f 2a TALLOC_ANY; /*
1b070 20 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 72 20 Mode parameter
1b080 66 6f 72 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 for allocateBtre
1b090 65 50 61 67 65 28 29 20 2a 2f 0a 20 20 20 20 20 ePage() */.
1b0a0 20 50 67 6e 6f 20 69 4e 65 61 72 20 3d 20 30 3b Pgno iNear = 0;
1b0b0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 6e 65 /* ne
1b0c0 61 72 62 79 20 70 61 72 61 6d 65 74 65 72 20 66 arby parameter f
1b0d0 6f 72 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 or allocateBtree
1b0e0 50 61 67 65 28 29 20 2a 2f 0a 0a 20 20 20 20 20 Page() */..
1b0f0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
1b100 67 65 28 70 42 74 2c 20 69 4c 61 73 74 50 67 2c ge(pBt, iLastPg,
1b110 20 26 70 4c 61 73 74 50 67 2c 20 30 29 3b 0a 20 &pLastPg, 0);.
1b120 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
1b130 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1b140 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
1b150 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 }.. /* I
1b160 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 7a 65 72 f bCommit is zer
1b170 6f 2c 20 74 68 69 73 20 6c 6f 6f 70 20 72 75 6e o, this loop run
1b180 73 20 65 78 61 63 74 6c 79 20 6f 6e 63 65 20 61 s exactly once a
1b190 6e 64 20 70 61 67 65 20 70 4c 61 73 74 50 67 0a nd page pLastPg.
1b1a0 20 20 20 20 20 20 2a 2a 20 69 73 20 73 77 61 70 ** is swap
1b1b0 70 65 64 20 77 69 74 68 20 74 68 65 20 66 69 72 ped with the fir
1b1c0 73 74 20 66 72 65 65 20 70 61 67 65 20 70 75 6c st free page pul
1b1d0 6c 65 64 20 6f 66 66 20 74 68 65 20 66 72 65 65 led off the free
1b1e0 20 6c 69 73 74 2e 0a 20 20 20 20 20 20 2a 2a 0a list.. **.
1b1f0 20 20 20 20 20 20 2a 2a 20 4f 6e 20 74 68 65 20 ** On the
1b200 6f 74 68 65 72 20 68 61 6e 64 2c 20 69 66 20 62 other hand, if b
1b210 43 6f 6d 6d 69 74 20 69 73 20 67 72 65 61 74 65 Commit is greate
1b220 72 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 r than zero, the
1b230 6e 20 6b 65 65 70 0a 20 20 20 20 20 20 2a 2a 20 n keep. **
1b240 6c 6f 6f 70 69 6e 67 20 75 6e 74 69 6c 20 61 20 looping until a
1b250 66 72 65 65 2d 70 61 67 65 20 6c 6f 63 61 74 65 free-page locate
1b260 64 20 77 69 74 68 69 6e 20 74 68 65 20 66 69 72 d within the fir
1b270 73 74 20 6e 46 69 6e 20 70 61 67 65 73 0a 20 20 st nFin pages.
1b280 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 ** of the fi
1b290 6c 65 20 69 73 20 66 6f 75 6e 64 2e 0a 20 20 20 le is found..
1b2a0 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
1b2b0 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 bCommit==0 ){.
1b2c0 20 20 20 20 20 20 65 4d 6f 64 65 20 3d 20 42 54 eMode = BT
1b2d0 41 4c 4c 4f 43 5f 4c 45 3b 0a 20 20 20 20 20 20 ALLOC_LE;.
1b2e0 20 20 69 4e 65 61 72 20 3d 20 6e 46 69 6e 3b 0a iNear = nFin;.
1b2f0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 64 6f }. do
1b300 20 7b 0a 20 20 20 20 20 20 20 20 4d 65 6d 50 61 {. MemPa
1b310 67 65 20 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 ge *pFreePg;.
1b320 20 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 rc = alloca
1b330 74 65 42 74 72 65 65 50 61 67 65 28 70 42 74 2c teBtreePage(pBt,
1b340 20 26 70 46 72 65 65 50 67 2c 20 26 69 46 72 65 &pFreePg, &iFre
1b350 65 50 67 2c 20 69 4e 65 61 72 2c 20 65 4d 6f 64 ePg, iNear, eMod
1b360 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 e);. if(
1b370 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1b380 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 . relea
1b390 73 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b sePage(pLastPg);
1b3a0 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
1b3b0 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
1b3c0 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
1b3d0 61 67 65 28 70 46 72 65 65 50 67 29 3b 0a 20 20 age(pFreePg);.
1b3e0 20 20 20 20 7d 77 68 69 6c 65 28 20 62 43 6f 6d }while( bCom
1b3f0 6d 69 74 20 26 26 20 69 46 72 65 65 50 67 3e 6e mit && iFreePg>n
1b400 46 69 6e 20 29 3b 0a 20 20 20 20 20 20 61 73 73 Fin );. ass
1b410 65 72 74 28 20 69 46 72 65 65 50 67 3c 69 4c 61 ert( iFreePg<iLa
1b420 73 74 50 67 20 29 3b 0a 20 20 20 20 20 20 0a 20 stPg );. .
1b430 20 20 20 20 20 72 63 20 3d 20 72 65 6c 6f 63 61 rc = reloca
1b440 74 65 50 61 67 65 28 70 42 74 2c 20 70 4c 61 73 tePage(pBt, pLas
1b450 74 50 67 2c 20 65 54 79 70 65 2c 20 69 50 74 72 tPg, eType, iPtr
1b460 50 61 67 65 2c 20 69 46 72 65 65 50 67 2c 20 62 Page, iFreePg, b
1b470 43 6f 6d 6d 69 74 29 3b 0a 20 20 20 20 20 20 72 Commit);. r
1b480 65 6c 65 61 73 65 50 61 67 65 28 70 4c 61 73 74 eleasePage(pLast
1b490 50 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 Pg);. if( r
1b4a0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1b4b0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
1b4c0 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d c;. }. }
1b4d0 0a 20 20 7d 0a 0a 20 20 69 66 28 20 62 43 6f 6d . }.. if( bCom
1b4e0 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 64 6f mit==0 ){. do
1b4f0 20 7b 0a 20 20 20 20 20 20 69 4c 61 73 74 50 67 {. iLastPg
1b500 2d 2d 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 --;. }while(
1b510 69 4c 61 73 74 50 67 3d 3d 50 45 4e 44 49 4e 47 iLastPg==PENDING
1b520 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
1b530 7c 7c 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 || PTRMAP_ISPAGE
1b540 28 70 42 74 2c 20 69 4c 61 73 74 50 67 29 20 29 (pBt, iLastPg) )
1b550 3b 0a 20 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 ;. pBt->bDoTr
1b560 75 6e 63 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 uncate = 1;.
1b570 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 69 4c 61 pBt->nPage = iLa
1b580 73 74 50 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 stPg;. }. retu
1b590 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
1b5a0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 ./*.** The datab
1b5b0 61 73 65 20 6f 70 65 6e 65 64 20 62 79 20 74 68 ase opened by th
1b5c0 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 e first argument
1b5d0 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 is an auto-vacu
1b5e0 75 6d 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 6e um database.** n
1b5f0 4f 72 69 67 20 70 61 67 65 73 20 69 6e 20 73 69 Orig pages in si
1b600 7a 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6e 46 ze containing nF
1b610 72 65 65 20 66 72 65 65 20 70 61 67 65 73 2e 20 ree free pages.
1b620 52 65 74 75 72 6e 20 74 68 65 20 65 78 70 65 63 Return the expec
1b630 74 65 64 20 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 ted .** size of
1b640 74 68 65 20 64 61 74 61 62 61 73 65 20 69 6e 20 the database in
1b650 70 61 67 65 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 pages following
1b660 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 6f an auto-vacuum o
1b670 70 65 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 peration..*/.sta
1b680 74 69 63 20 50 67 6e 6f 20 66 69 6e 61 6c 44 62 tic Pgno finalDb
1b690 53 69 7a 65 28 42 74 53 68 61 72 65 64 20 2a 70 Size(BtShared *p
1b6a0 42 74 2c 20 50 67 6e 6f 20 6e 4f 72 69 67 2c 20 Bt, Pgno nOrig,
1b6b0 50 67 6e 6f 20 6e 46 72 65 65 29 7b 0a 20 20 69 Pgno nFree){. i
1b6c0 6e 74 20 6e 45 6e 74 72 79 3b 20 20 20 20 20 20 nt nEntry;
1b6d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b6e0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 * Number of entr
1b6f0 69 65 73 20 6f 6e 20 6f 6e 65 20 70 74 72 6d 61 ies on one ptrma
1b700 70 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f p page */. Pgno
1b710 20 6e 50 74 72 6d 61 70 3b 20 20 20 20 20 20 20 nPtrmap;
1b720 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1b730 75 6d 62 65 72 20 6f 66 20 50 74 72 4d 61 70 20 umber of PtrMap
1b740 70 61 67 65 73 20 74 6f 20 62 65 20 66 72 65 65 pages to be free
1b750 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 46 69 6e d */. Pgno nFin
1b760 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1b770 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
1b780 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 20 6e 45 6e value */.. nEn
1b790 74 72 79 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c try = pBt->usabl
1b7a0 65 53 69 7a 65 2f 35 3b 0a 20 20 6e 50 74 72 6d eSize/5;. nPtrm
1b7b0 61 70 20 3d 20 28 6e 46 72 65 65 2d 6e 4f 72 69 ap = (nFree-nOri
1b7c0 67 2b 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 g+PTRMAP_PAGENO(
1b7d0 70 42 74 2c 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 pBt, nOrig)+nEnt
1b7e0 72 79 29 2f 6e 45 6e 74 72 79 3b 0a 20 20 6e 46 ry)/nEntry;. nF
1b7f0 69 6e 20 3d 20 6e 4f 72 69 67 20 2d 20 6e 46 72 in = nOrig - nFr
1b800 65 65 20 2d 20 6e 50 74 72 6d 61 70 3b 0a 20 20 ee - nPtrmap;.
1b810 69 66 28 20 6e 4f 72 69 67 3e 50 45 4e 44 49 4e if( nOrig>PENDIN
1b820 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
1b830 20 26 26 20 6e 46 69 6e 3c 50 45 4e 44 49 4e 47 && nFin<PENDING
1b840 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
1b850 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 ){. nFin--;.
1b860 20 7d 0a 20 20 77 68 69 6c 65 28 20 50 54 52 4d }. while( PTRM
1b870 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 6e AP_ISPAGE(pBt, n
1b880 46 69 6e 29 20 7c 7c 20 6e 46 69 6e 3d 3d 50 45 Fin) || nFin==PE
1b890 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
1b8a0 70 42 74 29 20 29 7b 0a 20 20 20 20 6e 46 69 6e pBt) ){. nFin
1b8b0 2d 2d 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 --;. }.. retur
1b8c0 6e 20 6e 46 69 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n nFin;.}../*.**
1b8d0 20 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 A write-transac
1b8e0 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 6f 70 65 tion must be ope
1b8f0 6e 65 64 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 ned before calli
1b900 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ng this function
1b910 2e 0a 2a 2a 20 49 74 20 70 65 72 66 6f 72 6d 73 ..** It performs
1b920 20 61 20 73 69 6e 67 6c 65 20 75 6e 69 74 20 6f a single unit o
1b930 66 20 77 6f 72 6b 20 74 6f 77 61 72 64 73 20 61 f work towards a
1b940 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 n incremental va
1b950 63 75 75 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 cuum..**.** If t
1b960 68 65 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 he incremental v
1b970 61 63 75 75 6d 20 69 73 20 66 69 6e 69 73 68 65 acuum is finishe
1b980 64 20 61 66 74 65 72 20 74 68 69 73 20 66 75 6e d after this fun
1b990 63 74 69 6f 6e 20 68 61 73 20 72 75 6e 2c 0a 2a ction has run,.*
1b9a0 2a 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 * SQLITE_DONE is
1b9b0 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 returned. If it
1b9c0 20 69 73 20 6e 6f 74 20 66 69 6e 69 73 68 65 64 is not finished
1b9d0 2c 20 62 75 74 20 6e 6f 20 65 72 72 6f 72 20 6f , but no error o
1b9e0 63 63 75 72 72 65 64 2c 0a 2a 2a 20 53 51 4c 49 ccurred,.** SQLI
1b9f0 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
1ba00 64 2e 20 4f 74 68 65 72 77 69 73 65 20 61 6e 20 d. Otherwise an
1ba10 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
1ba20 65 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 e. .*/.int sqlit
1ba30 65 33 42 74 72 65 65 49 6e 63 72 56 61 63 75 75 e3BtreeIncrVacuu
1ba40 6d 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 m(Btree *p){. i
1ba50 6e 74 20 72 63 3b 0a 20 20 42 74 53 68 61 72 65 nt rc;. BtShare
1ba60 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
1ba70 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 .. sqlite3Btree
1ba80 45 6e 74 65 72 28 70 29 3b 0a 20 20 61 73 73 65 Enter(p);. asse
1ba90 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 rt( pBt->inTrans
1baa0 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
1bab0 49 54 45 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e ITE && p->inTran
1bac0 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 s==TRANS_WRITE )
1bad0 3b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 61 75 ;. if( !pBt->au
1bae0 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 toVacuum ){.
1baf0 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
1bb00 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 50 ;. }else{. P
1bb10 67 6e 6f 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 gno nOrig = btre
1bb20 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
1bb30 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 65 20 . Pgno nFree
1bb40 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 2d = get4byte(&pBt-
1bb50 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 >pPage1->aData[3
1bb60 36 5d 29 3b 0a 20 20 20 20 50 67 6e 6f 20 6e 46 6]);. Pgno nF
1bb70 69 6e 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 in = finalDbSize
1bb80 28 70 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 (pBt, nOrig, nFr
1bb90 65 65 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e 4f ee);.. if( nO
1bba0 72 69 67 3c 6e 46 69 6e 20 29 7b 0a 20 20 20 20 rig<nFin ){.
1bbb0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
1bbc0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
1bbd0 7d 65 6c 73 65 20 69 66 28 20 6e 46 72 65 65 3e }else if( nFree>
1bbe0 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 0 ){. rc =
1bbf0 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 saveAllCursors(p
1bc00 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 Bt, 0, 0);.
1bc10 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1bc20 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e OK ){. in
1bc30 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 validateAllOverf
1bc40 6c 6f 77 43 61 63 68 65 28 70 42 74 29 3b 0a 20 lowCache(pBt);.
1bc50 20 20 20 20 20 20 20 72 63 20 3d 20 69 6e 63 72 rc = incr
1bc60 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 2c 20 VacuumStep(pBt,
1bc70 6e 46 69 6e 2c 20 6e 4f 72 69 67 2c 20 30 29 3b nFin, nOrig, 0);
1bc80 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
1bc90 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1bca0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
1bcb0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
1bcc0 74 65 28 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e te(pBt->pPage1->
1bcd0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
1bce0 20 20 70 75 74 34 62 79 74 65 28 26 70 42 74 2d put4byte(&pBt-
1bcf0 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 >pPage1->aData[2
1bd00 38 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 8], pBt->nPage);
1bd10 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
1bd20 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
1bd30 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 QLITE_DONE;.
1bd40 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 }. }. sqlite3B
1bd50 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
1bd60 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1bd70 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
1bd80 20 69 73 20 63 61 6c 6c 65 64 20 70 72 69 6f 72 is called prior
1bd90 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
1bda0 43 6f 6d 6d 69 74 20 77 68 65 6e 20 61 20 74 72 Commit when a tr
1bdb0 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 ansaction.** is
1bdc0 63 6f 6d 6d 69 74 74 65 64 20 66 6f 72 20 61 6e committed for an
1bdd0 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61 74 auto-vacuum dat
1bde0 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 abase..**.** If
1bdf0 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
1be00 75 72 6e 65 64 2c 20 74 68 65 6e 20 2a 70 6e 54 urned, then *pnT
1be10 72 75 6e 63 20 69 73 20 73 65 74 20 74 6f 20 74 runc is set to t
1be20 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
1be30 65 73 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 es.** the databa
1be40 73 65 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 se file should b
1be50 65 20 74 72 75 6e 63 61 74 65 64 20 74 6f 20 64 e truncated to d
1be60 75 72 69 6e 67 20 74 68 65 20 63 6f 6d 6d 69 74 uring the commit
1be70 20 70 72 6f 63 65 73 73 2e 20 0a 2a 2a 20 69 2e process. .** i.
1be80 65 2e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 e. the database
1be90 68 61 73 20 62 65 65 6e 20 72 65 6f 72 67 61 6e has been reorgan
1bea0 69 7a 65 64 20 73 6f 20 74 68 61 74 20 6f 6e 6c ized so that onl
1beb0 79 20 74 68 65 20 66 69 72 73 74 20 2a 70 6e 54 y the first *pnT
1bec0 72 75 6e 63 0a 2a 2a 20 70 61 67 65 73 20 61 72 runc.** pages ar
1bed0 65 20 69 6e 20 75 73 65 2e 0a 2a 2f 0a 73 74 61 e in use..*/.sta
1bee0 74 69 63 20 69 6e 74 20 61 75 74 6f 56 61 63 75 tic int autoVacu
1bef0 75 6d 43 6f 6d 6d 69 74 28 42 74 53 68 61 72 65 umCommit(BtShare
1bf00 64 20 2a 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 d *pBt){. int r
1bf10 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1bf20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
1bf30 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 pBt->pPager;.
1bf40 56 56 41 5f 4f 4e 4c 59 28 20 69 6e 74 20 6e 52 VVA_ONLY( int nR
1bf50 65 66 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 ef = sqlite3Page
1bf60 72 52 65 66 63 6f 75 6e 74 28 70 50 61 67 65 72 rRefcount(pPager
1bf70 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ) );.. assert(
1bf80 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
1bf90 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
1bfa0 3b 0a 20 20 69 6e 76 61 6c 69 64 61 74 65 41 6c ;. invalidateAl
1bfb0 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 lOverflowCache(p
1bfc0 42 74 29 3b 0a 20 20 61 73 73 65 72 74 28 70 42 Bt);. assert(pB
1bfd0 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 3b 0a t->autoVacuum);.
1bfe0 20 20 69 66 28 20 21 70 42 74 2d 3e 69 6e 63 72 if( !pBt->incr
1bff0 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 Vacuum ){. Pg
1c000 6e 6f 20 6e 46 69 6e 3b 20 20 20 20 20 20 20 20 no nFin;
1c010 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
1c020 67 65 73 20 69 6e 20 64 61 74 61 62 61 73 65 20 ges in database
1c030 61 66 74 65 72 20 61 75 74 6f 76 61 63 75 75 6d after autovacuum
1c040 69 6e 67 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 ing */. Pgno
1c050 6e 46 72 65 65 3b 20 20 20 20 20 20 20 20 2f 2a nFree; /*
1c060 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
1c070 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 on the freelist
1c080 20 69 6e 69 74 69 61 6c 6c 79 20 2a 2f 0a 20 20 initially */.
1c090 20 20 50 67 6e 6f 20 69 46 72 65 65 3b 20 20 20 Pgno iFree;
1c0a0 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 /* The next
1c0b0 20 70 61 67 65 20 74 6f 20 62 65 20 66 72 65 65 page to be free
1c0c0 64 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 4f d */. Pgno nO
1c0d0 72 69 67 3b 20 20 20 20 20 20 20 20 2f 2a 20 44 rig; /* D
1c0e0 61 74 61 62 61 73 65 20 73 69 7a 65 20 62 65 66 atabase size bef
1c0f0 6f 72 65 20 66 72 65 65 69 6e 67 20 2a 2f 0a 0a ore freeing */..
1c100 20 20 20 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 nOrig = btre
1c110 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
1c120 0a 20 20 20 20 69 66 28 20 50 54 52 4d 41 50 5f . if( PTRMAP_
1c130 49 53 50 41 47 45 28 70 42 74 2c 20 6e 4f 72 69 ISPAGE(pBt, nOri
1c140 67 29 20 7c 7c 20 6e 4f 72 69 67 3d 3d 50 45 4e g) || nOrig==PEN
1c150 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 DING_BYTE_PAGE(p
1c160 42 74 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 Bt) ){. /*
1c170 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 It is not possib
1c180 6c 65 20 74 6f 20 63 72 65 61 74 65 20 61 20 64 le to create a d
1c190 61 74 61 62 61 73 65 20 66 6f 72 20 77 68 69 63 atabase for whic
1c1a0 68 20 74 68 65 20 66 69 6e 61 6c 20 70 61 67 65 h the final page
1c1b0 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 65 69 74 . ** is eit
1c1c0 68 65 72 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 her a pointer-ma
1c1d0 70 20 70 61 67 65 20 6f 72 20 74 68 65 20 70 65 p page or the pe
1c1e0 6e 64 69 6e 67 2d 62 79 74 65 20 70 61 67 65 2e nding-byte page.
1c1f0 20 49 66 20 6f 6e 65 0a 20 20 20 20 20 20 2a 2a If one. **
1c200 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c is encountered,
1c210 20 74 68 69 73 20 69 6e 64 69 63 61 74 65 73 20 this indicates
1c220 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 20 20 20 20 corruption..
1c230 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 */. retur
1c240 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
1c250 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 _BKPT;. }..
1c260 20 20 6e 46 72 65 65 20 3d 20 67 65 74 34 62 79 nFree = get4by
1c270 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d te(&pBt->pPage1-
1c280 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 >aData[36]);.
1c290 20 6e 46 69 6e 20 3d 20 66 69 6e 61 6c 44 62 53 nFin = finalDbS
1c2a0 69 7a 65 28 70 42 74 2c 20 6e 4f 72 69 67 2c 20 ize(pBt, nOrig,
1c2b0 6e 46 72 65 65 29 3b 0a 20 20 20 20 69 66 28 20 nFree);. if(
1c2c0 6e 46 69 6e 3e 6e 4f 72 69 67 20 29 20 72 65 74 nFin>nOrig ) ret
1c2d0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
1c2e0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 69 66 28 PT_BKPT;. if(
1c2f0 20 6e 46 69 6e 3c 6e 4f 72 69 67 20 29 7b 0a 20 nFin<nOrig ){.
1c300 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 41 6c rc = saveAl
1c310 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 30 2c lCursors(pBt, 0,
1c320 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 0);. }. f
1c330 6f 72 28 69 46 72 65 65 3d 6e 4f 72 69 67 3b 20 or(iFree=nOrig;
1c340 69 46 72 65 65 3e 6e 46 69 6e 20 26 26 20 72 63 iFree>nFin && rc
1c350 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 46 72 ==SQLITE_OK; iFr
1c360 65 65 2d 2d 29 7b 0a 20 20 20 20 20 20 72 63 20 ee--){. rc
1c370 3d 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 = incrVacuumStep
1c380 28 70 42 74 2c 20 6e 46 69 6e 2c 20 69 46 72 65 (pBt, nFin, iFre
1c390 65 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 e, 1);. }.
1c3a0 20 69 66 28 20 28 72 63 3d 3d 53 51 4c 49 54 45 if( (rc==SQLITE
1c3b0 5f 44 4f 4e 45 20 7c 7c 20 72 63 3d 3d 53 51 4c _DONE || rc==SQL
1c3c0 49 54 45 5f 4f 4b 29 20 26 26 20 6e 46 72 65 65 ITE_OK) && nFree
1c3d0 3e 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d >0 ){. rc =
1c3e0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
1c3f0 74 65 28 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e te(pBt->pPage1->
1c400 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
1c410 70 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 put4byte(&pBt->p
1c420 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
1c430 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 75 74 34 , 0);. put4
1c440 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 byte(&pBt->pPage
1c450 31 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 30 29 1->aData[36], 0)
1c460 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
1c470 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
1c480 44 61 74 61 5b 32 38 5d 2c 20 6e 46 69 6e 29 3b Data[28], nFin);
1c490 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 44 6f 54 . pBt->bDoT
1c4a0 72 75 6e 63 61 74 65 20 3d 20 31 3b 0a 20 20 20 runcate = 1;.
1c4b0 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 pBt->nPage =
1c4c0 6e 46 69 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nFin;. }.
1c4d0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1c4e0 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
1c4f0 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 e3PagerRollback(
1c500 70 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 pPager);. }.
1c510 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 6e 52 }.. assert( nR
1c520 65 66 3e 3d 73 71 6c 69 74 65 33 50 61 67 65 72 ef>=sqlite3Pager
1c530 52 65 66 63 6f 75 6e 74 28 70 50 61 67 65 72 29 Refcount(pPager)
1c540 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
1c550 0a 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 6e .}..#else /* ifn
1c560 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1c570 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f 0a 23 20 AUTOVACUUM */.#
1c580 64 65 66 69 6e 65 20 73 65 74 43 68 69 6c 64 50 define setChildP
1c590 74 72 6d 61 70 73 28 78 29 20 53 51 4c 49 54 45 trmaps(x) SQLITE
1c5a0 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a _OK.#endif../*.*
1c5b0 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 * This routine d
1c5c0 6f 65 73 20 74 68 65 20 66 69 72 73 74 20 70 68 oes the first ph
1c5d0 61 73 65 20 6f 66 20 61 20 74 77 6f 2d 70 68 61 ase of a two-pha
1c5e0 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 69 73 se commit. This
1c5f0 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 63 61 75 73 routine.** caus
1c600 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f es a rollback jo
1c610 75 72 6e 61 6c 20 74 6f 20 62 65 20 63 72 65 61 urnal to be crea
1c620 74 65 64 20 28 69 66 20 69 74 20 64 6f 65 73 20 ted (if it does
1c630 6e 6f 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 not already exis
1c640 74 29 0a 2a 2a 20 61 6e 64 20 70 6f 70 75 6c 61 t).** and popula
1c650 74 65 64 20 77 69 74 68 20 65 6e 6f 75 67 68 20 ted with enough
1c660 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 6f 20 74 information so t
1c670 68 61 74 20 69 66 20 61 20 70 6f 77 65 72 20 6c hat if a power l
1c680 6f 73 73 20 6f 63 63 75 72 73 0a 2a 2a 20 74 68 oss occurs.** th
1c690 65 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 e database can b
1c6a0 65 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74 e restored to it
1c6b0 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 65 s original state
1c6c0 20 62 79 20 70 6c 61 79 69 6e 67 20 62 61 63 6b by playing back
1c6d0 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e .** the journal.
1c6e0 20 20 54 68 65 6e 20 74 68 65 20 63 6f 6e 74 65 Then the conte
1c6f0 6e 74 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e nts of the journ
1c700 61 6c 20 61 72 65 20 66 6c 75 73 68 65 64 20 6f al are flushed o
1c710 75 74 20 74 6f 0a 2a 2a 20 74 68 65 20 64 69 73 ut to.** the dis
1c720 6b 2e 20 20 41 66 74 65 72 20 74 68 65 20 6a 6f k. After the jo
1c730 75 72 6e 61 6c 20 69 73 20 73 61 66 65 6c 79 20 urnal is safely
1c740 6f 6e 20 6f 78 69 64 65 2c 20 74 68 65 20 63 68 on oxide, the ch
1c750 61 6e 67 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 anges to the.**
1c760 64 61 74 61 62 61 73 65 20 61 72 65 20 77 72 69 database are wri
1c770 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 64 61 tten into the da
1c780 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 tabase file and
1c790 66 6c 75 73 68 65 64 20 74 6f 20 6f 78 69 64 65 flushed to oxide
1c7a0 2e 0a 2a 2a 20 41 74 20 74 68 65 20 65 6e 64 20 ..** At the end
1c7b0 6f 66 20 74 68 69 73 20 63 61 6c 6c 2c 20 74 68 of this call, th
1c7c0 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
1c7d0 61 6c 20 73 74 69 6c 6c 20 65 78 69 73 74 73 20 al still exists
1c7e0 6f 6e 20 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 on the.** disk a
1c7f0 6e 64 20 77 65 20 61 72 65 20 73 74 69 6c 6c 20 nd we are still
1c800 68 6f 6c 64 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b holding all lock
1c810 73 2c 20 73 6f 20 74 68 65 20 74 72 61 6e 73 61 s, so the transa
1c820 63 74 69 6f 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a ction has not.**
1c830 20 63 6f 6d 6d 69 74 74 65 64 2e 20 20 53 65 65 committed. See
1c840 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d sqlite3BtreeCom
1c850 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 66 6f mitPhaseTwo() fo
1c860 72 20 74 68 65 20 73 65 63 6f 6e 64 20 70 68 61 r the second pha
1c870 73 65 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 6d se of the.** com
1c880 6d 69 74 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a mit process..**.
1c890 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20 ** This call is
1c8a0 61 20 6e 6f 2d 6f 70 20 69 66 20 6e 6f 20 77 72 a no-op if no wr
1c8b0 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
1c8c0 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 is currently act
1c8d0 69 76 65 20 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a ive on pBt..**.*
1c8e0 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 73 79 6e * Otherwise, syn
1c8f0 63 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 c the database f
1c900 69 6c 65 20 66 6f 72 20 74 68 65 20 62 74 72 65 ile for the btre
1c910 65 20 70 42 74 2e 20 7a 4d 61 73 74 65 72 20 70 e pBt. zMaster p
1c920 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68 65 20 oints to.** the
1c930 6e 61 6d 65 20 6f 66 20 61 20 6d 61 73 74 65 72 name of a master
1c940 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 journal file th
1c950 61 74 20 73 68 6f 75 6c 64 20 62 65 20 77 72 69 at should be wri
1c960 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 0a 2a 2a tten into the.**
1c970 20 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 individual jour
1c980 6e 61 6c 20 66 69 6c 65 2c 20 6f 72 20 69 73 20 nal file, or is
1c990 4e 55 4c 4c 2c 20 69 6e 64 69 63 61 74 69 6e 67 NULL, indicating
1c9a0 20 6e 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e no master journ
1c9b0 61 6c 20 66 69 6c 65 20 0a 2a 2a 20 28 73 69 6e al file .** (sin
1c9c0 67 6c 65 20 64 61 74 61 62 61 73 65 20 74 72 61 gle database tra
1c9d0 6e 73 61 63 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a nsaction)..**.**
1c9e0 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 When this is ca
1c9f0 6c 6c 65 64 2c 20 74 68 65 20 6d 61 73 74 65 72 lled, the master
1ca00 20 6a 6f 75 72 6e 61 6c 20 73 68 6f 75 6c 64 20 journal should
1ca10 61 6c 72 65 61 64 79 20 68 61 76 65 20 62 65 65 already have bee
1ca20 6e 0a 2a 2a 20 63 72 65 61 74 65 64 2c 20 70 6f n.** created, po
1ca30 70 75 6c 61 74 65 64 20 77 69 74 68 20 74 68 69 pulated with thi
1ca40 73 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 s journal pointe
1ca50 72 20 61 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 r and synced to
1ca60 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 disk..**.** Once
1ca70 20 74 68 69 73 20 69 73 20 72 6f 75 74 69 6e 65 this is routine
1ca80 20 68 61 73 20 72 65 74 75 72 6e 65 64 2c 20 74 has returned, t
1ca90 68 65 20 6f 6e 6c 79 20 74 68 69 6e 67 20 72 65 he only thing re
1caa0 71 75 69 72 65 64 20 74 6f 20 63 6f 6d 6d 69 74 quired to commit
1cab0 0a 2a 2a 20 74 68 65 20 77 72 69 74 65 2d 74 72 .** the write-tr
1cac0 61 6e 73 61 63 74 69 6f 6e 20 66 6f 72 20 74 68 ansaction for th
1cad0 69 73 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 is database file
1cae0 20 69 73 20 74 6f 20 64 65 6c 65 74 65 20 74 68 is to delete th
1caf0 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e e journal..*/.in
1cb00 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f t sqlite3BtreeCo
1cb10 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 42 74 72 mmitPhaseOne(Btr
1cb20 65 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 ee *p, const cha
1cb30 72 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 69 r *zMaster){. i
1cb40 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1cb50 4b 3b 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 K;. if( p->inTr
1cb60 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
1cb70 20 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 ){. BtShared
1cb80 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
1cb90 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1cba0 45 6e 74 65 72 28 70 29 3b 0a 23 69 66 6e 64 65 Enter(p);.#ifnde
1cbb0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
1cbc0 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
1cbd0 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
1cbe0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 ){. rc = a
1cbf0 75 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 utoVacuumCommit(
1cc00 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pBt);. if(
1cc10 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1cc20 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
1cc30 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1cc40 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
1cc50 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
1cc60 20 20 20 20 69 66 28 20 70 42 74 2d 3e 62 44 6f if( pBt->bDo
1cc70 54 72 75 6e 63 61 74 65 20 29 7b 0a 20 20 20 20 Truncate ){.
1cc80 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 sqlite3PagerTr
1cc90 75 6e 63 61 74 65 49 6d 61 67 65 28 70 42 74 2d uncateImage(pBt-
1cca0 3e 70 50 61 67 65 72 2c 20 70 42 74 2d 3e 6e 50 >pPager, pBt->nP
1ccb0 61 67 65 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 age);. }.#end
1ccc0 69 66 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 if. rc = sqli
1ccd0 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 te3PagerCommitPh
1cce0 61 73 65 4f 6e 65 28 70 42 74 2d 3e 70 50 61 67 aseOne(pBt->pPag
1ccf0 65 72 2c 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b er, zMaster, 0);
1cd00 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
1cd10 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 eLeave(p);. }.
1cd20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1cd30 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
1cd40 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f on is called fro
1cd50 6d 20 62 6f 74 68 20 42 74 72 65 65 43 6f 6d 6d m both BtreeComm
1cd60 69 74 50 68 61 73 65 54 77 6f 28 29 20 61 6e 64 itPhaseTwo() and
1cd70 20 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 BtreeRollback()
1cd80 0a 2a 2a 20 61 74 20 74 68 65 20 63 6f 6e 63 6c .** at the concl
1cd90 75 73 69 6f 6e 20 6f 66 20 61 20 74 72 61 6e 73 usion of a trans
1cda0 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 action..*/.stati
1cdb0 63 20 76 6f 69 64 20 62 74 72 65 65 45 6e 64 54 c void btreeEndT
1cdc0 72 61 6e 73 61 63 74 69 6f 6e 28 42 74 72 65 65 ransaction(Btree
1cdd0 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 *p){. BtShared
1cde0 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
1cdf0 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
1ce00 70 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28 p->db;. assert(
1ce10 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
1ce20 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 0a 23 dsMutex(p) );..#
1ce30 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1ce40 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
1ce50 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 pBt->bDoTruncate
1ce60 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 69 = 0;.#endif. i
1ce70 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 f( p->inTrans>TR
1ce80 41 4e 53 5f 4e 4f 4e 45 20 26 26 20 64 62 2d 3e ANS_NONE && db->
1ce90 6e 56 64 62 65 52 65 61 64 3e 31 20 29 7b 0a 20 nVdbeRead>1 ){.
1cea0 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 /* If there a
1ceb0 72 65 20 6f 74 68 65 72 20 61 63 74 69 76 65 20 re other active
1cec0 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 statements that
1ced0 62 65 6c 6f 6e 67 20 74 6f 20 74 68 69 73 20 64 belong to this d
1cee0 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 68 atabase. ** h
1cef0 61 6e 64 6c 65 2c 20 64 6f 77 6e 67 72 61 64 65 andle, downgrade
1cf00 20 74 6f 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 to a read-only
1cf10 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 transaction. The
1cf20 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 other statement
1cf30 73 0a 20 20 20 20 2a 2a 20 6d 61 79 20 73 74 69 s. ** may sti
1cf40 6c 6c 20 62 65 20 72 65 61 64 69 6e 67 20 66 72 ll be reading fr
1cf50 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e om the database.
1cf60 20 20 2a 2f 0a 20 20 20 20 64 6f 77 6e 67 72 61 */. downgra
1cf70 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 deAllSharedCache
1cf80 54 61 62 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 TableLocks(p);.
1cf90 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 p->inTrans =
1cfa0 54 52 41 4e 53 5f 52 45 41 44 3b 0a 20 20 7d 65 TRANS_READ;. }e
1cfb0 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 lse{. /* If t
1cfc0 68 65 20 68 61 6e 64 6c 65 20 68 61 64 20 61 6e he handle had an
1cfd0 79 20 6b 69 6e 64 20 6f 66 20 74 72 61 6e 73 61 y kind of transa
1cfe0 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 64 65 63 72 ction open, decr
1cff0 65 6d 65 6e 74 20 74 68 65 20 0a 20 20 20 20 2a ement the . *
1d000 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f * transaction co
1d010 75 6e 74 20 6f 66 20 74 68 65 20 73 68 61 72 65 unt of the share
1d020 64 20 62 74 72 65 65 2e 20 49 66 20 74 68 65 20 d btree. If the
1d030 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e transaction coun
1d040 74 20 0a 20 20 20 20 2a 2a 20 72 65 61 63 68 65 t . ** reache
1d050 73 20 30 2c 20 73 65 74 20 74 68 65 20 73 68 61 s 0, set the sha
1d060 72 65 64 20 73 74 61 74 65 20 74 6f 20 54 52 41 red state to TRA
1d070 4e 53 5f 4e 4f 4e 45 2e 20 54 68 65 20 75 6e 6c NS_NONE. The unl
1d080 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1d090 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 (). ** call b
1d0a0 65 6c 6f 77 20 77 69 6c 6c 20 75 6e 6c 6f 63 6b elow will unlock
1d0b0 20 74 68 65 20 70 61 67 65 72 2e 20 20 2a 2f 0a the pager. */.
1d0c0 20 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 if( p->inTra
1d0d0 6e 73 21 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 ns!=TRANS_NONE )
1d0e0 7b 0a 20 20 20 20 20 20 63 6c 65 61 72 41 6c 6c {. clearAll
1d0f0 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
1d100 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 20 20 Locks(p);.
1d110 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f pBt->nTransactio
1d120 6e 2d 2d 3b 0a 20 20 20 20 20 20 69 66 28 20 30 n--;. if( 0
1d130 3d 3d 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 ==pBt->nTransact
1d140 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ion ){. p
1d150 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1d160 6e 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a n = TRANS_NONE;.
1d170 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 }. }..
1d180 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 63 75 /* Set the cu
1d190 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f rrent transactio
1d1a0 6e 20 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 n state to TRANS
1d1b0 5f 4e 4f 4e 45 20 61 6e 64 20 75 6e 6c 6f 63 6b _NONE and unlock
1d1c0 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 70 61 67 the . ** pag
1d1d0 65 72 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 er if this call
1d1e0 63 6c 6f 73 65 64 20 74 68 65 20 6f 6e 6c 79 20 closed the only
1d1f0 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 read or write tr
1d200 61 6e 73 61 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 ansaction. */.
1d210 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 p->inTrans =
1d220 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 TRANS_NONE;.
1d230 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 unlockBtreeIfUnu
1d240 73 65 64 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 sed(pBt);. }..
1d250 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 btreeIntegrity(
1d260 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d p);.}../*.** Com
1d270 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 mit the transact
1d280 69 6f 6e 20 63 75 72 72 65 6e 74 6c 79 20 69 6e ion currently in
1d290 20 70 72 6f 67 72 65 73 73 2e 0a 2a 2a 0a 2a 2a progress..**.**
1d2a0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d This routine im
1d2b0 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 73 65 63 plements the sec
1d2c0 6f 6e 64 20 70 68 61 73 65 20 6f 66 20 61 20 32 ond phase of a 2
1d2d0 2d 70 68 61 73 65 20 63 6f 6d 6d 69 74 2e 20 20 -phase commit.
1d2e0 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 42 74 The.** sqlite3Bt
1d2f0 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e reeCommitPhaseOn
1d300 65 28 29 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 e() routine does
1d310 20 74 68 65 20 66 69 72 73 74 20 70 68 61 73 65 the first phase
1d320 20 61 6e 64 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 and should.** b
1d330 65 20 69 6e 76 6f 6b 65 64 20 70 72 69 6f 72 20 e invoked prior
1d340 74 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 to calling this
1d350 72 6f 75 74 69 6e 65 2e 20 20 54 68 65 20 73 71 routine. The sq
1d360 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1d370 50 68 61 73 65 4f 6e 65 28 29 0a 2a 2a 20 72 6f PhaseOne().** ro
1d380 75 74 69 6e 65 20 64 69 64 20 61 6c 6c 20 74 68 utine did all th
1d390 65 20 77 6f 72 6b 20 6f 66 20 77 72 69 74 69 6e e work of writin
1d3a0 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 g information ou
1d3b0 74 20 74 6f 20 64 69 73 6b 20 61 6e 64 20 66 6c t to disk and fl
1d3c0 75 73 68 69 6e 67 20 74 68 65 0a 2a 2a 20 63 6f ushing the.** co
1d3d0 6e 74 65 6e 74 73 20 73 6f 20 74 68 61 74 20 74 ntents so that t
1d3e0 68 65 79 20 61 72 65 20 77 72 69 74 74 65 6e 20 hey are written
1d3f0 6f 6e 74 6f 20 74 68 65 20 64 69 73 6b 20 70 6c onto the disk pl
1d400 61 74 74 65 72 2e 20 20 41 6c 6c 20 74 68 69 73 atter. All this
1d410 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 68 61 73 20 .** routine has
1d420 74 6f 20 64 6f 20 69 73 20 64 65 6c 65 74 65 20 to do is delete
1d430 6f 72 20 74 72 75 6e 63 61 74 65 20 6f 72 20 7a or truncate or z
1d440 65 72 6f 20 74 68 65 20 68 65 61 64 65 72 20 69 ero the header i
1d450 6e 20 74 68 65 0a 2a 2a 20 74 68 65 20 72 6f 6c n the.** the rol
1d460 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 28 77 lback journal (w
1d470 68 69 63 68 20 63 61 75 73 65 73 20 74 68 65 20 hich causes the
1d480 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 6f 20 63 transaction to c
1d490 6f 6d 6d 69 74 29 20 61 6e 64 0a 2a 2a 20 64 72 ommit) and.** dr
1d4a0 6f 70 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 op locks..**.**
1d4b0 4e 6f 72 6d 61 6c 6c 79 2c 20 69 66 20 61 6e 20 Normally, if an
1d4c0 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
1d4d0 6c 65 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 le the pager lay
1d4e0 65 72 20 69 73 20 61 74 74 65 6d 70 74 69 6e 67 er is attempting
1d4f0 20 74 6f 20 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 to .** finalize
1d500 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 the underlying
1d510 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 journal file, th
1d520 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
1d530 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 rns an error and
1d540 0a 2a 2a 20 74 68 65 20 75 70 70 65 72 20 6c 61 .** the upper la
1d550 79 65 72 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 yer will attempt
1d560 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 48 6f 77 a rollback. How
1d570 65 76 65 72 2c 20 69 66 20 74 68 65 20 73 65 63 ever, if the sec
1d580 6f 6e 64 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 ond argument.**
1d590 69 73 20 6e 6f 6e 2d 7a 65 72 6f 20 74 68 65 6e is non-zero then
1d5a0 20 74 68 69 73 20 62 2d 74 72 65 65 20 74 72 61 this b-tree tra
1d5b0 6e 73 61 63 74 69 6f 6e 20 69 73 20 70 61 72 74 nsaction is part
1d5c0 20 6f 66 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 of a multi-file
1d5d0 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e .** transaction
1d5e0 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 . In this case,
1d5f0 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
1d600 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
1d610 20 63 6f 6d 6d 69 74 74 65 64 20 0a 2a 2a 20 28 committed .** (
1d620 62 79 20 64 65 6c 65 74 69 6e 67 20 61 20 6d 61 by deleting a ma
1d630 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
1d640 65 29 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 65 e) and the calle
1d650 72 20 77 69 6c 6c 20 69 67 6e 6f 72 65 20 74 68 r will ignore th
1d660 69 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 is .** functions
1d670 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 20 53 6f return code. So
1d680 2c 20 65 76 65 6e 20 69 66 20 61 6e 20 65 72 72 , even if an err
1d690 6f 72 20 6f 63 63 75 72 73 20 69 6e 20 74 68 65 or occurs in the
1d6a0 20 70 61 67 65 72 20 6c 61 79 65 72 2c 0a 2a 2a pager layer,.**
1d6b0 20 72 65 73 65 74 20 74 68 65 20 62 2d 74 72 65 reset the b-tre
1d6c0 65 20 6f 62 6a 65 63 74 73 20 69 6e 74 65 72 6e e objects intern
1d6d0 61 6c 20 73 74 61 74 65 20 74 6f 20 69 6e 64 69 al state to indi
1d6e0 63 61 74 65 20 74 68 61 74 20 74 68 65 20 77 72 cate that the wr
1d6f0 69 74 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ite.** transacti
1d700 6f 6e 20 68 61 73 20 62 65 65 6e 20 63 6c 6f 73 on has been clos
1d710 65 64 2e 20 54 68 69 73 20 69 73 20 71 75 69 74 ed. This is quit
1d720 65 20 73 61 66 65 2c 20 61 73 20 74 68 65 20 70 e safe, as the p
1d730 61 67 65 72 20 77 69 6c 6c 20 68 61 76 65 0a 2a ager will have.*
1d740 2a 20 74 72 61 6e 73 69 74 69 6f 6e 65 64 20 74 * transitioned t
1d750 6f 20 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 o the error stat
1d760 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 e..**.** This wi
1d770 6c 6c 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 ll release the w
1d780 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 rite lock on the
1d790 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
1d7a0 20 49 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 If there.** are
1d7b0 20 6e 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f no active curso
1d7c0 72 73 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 rs, it also rele
1d7d0 61 73 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f ases the read lo
1d7e0 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ck..*/.int sqlit
1d7f0 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 e3BtreeCommitPha
1d800 73 65 54 77 6f 28 42 74 72 65 65 20 2a 70 2c 20 seTwo(Btree *p,
1d810 69 6e 74 20 62 43 6c 65 61 6e 75 70 29 7b 0a 0a int bCleanup){..
1d820 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1d830 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 20 72 ==TRANS_NONE ) r
1d840 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1d850 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
1d860 6e 74 65 72 28 70 29 3b 0a 20 20 62 74 72 65 65 nter(p);. btree
1d870 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 Integrity(p);..
1d880 20 2f 2a 20 49 66 20 74 68 65 20 68 61 6e 64 6c /* If the handl
1d890 65 20 68 61 73 20 61 20 77 72 69 74 65 2d 74 72 e has a write-tr
1d8a0 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 ansaction open,
1d8b0 63 6f 6d 6d 69 74 20 74 68 65 20 73 68 61 72 65 commit the share
1d8c0 64 2d 62 74 72 65 65 73 20 0a 20 20 2a 2a 20 74 d-btrees . ** t
1d8d0 72 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 73 ransaction and s
1d8e0 65 74 20 74 68 65 20 73 68 61 72 65 64 20 73 74 et the shared st
1d8f0 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 52 45 41 ate to TRANS_REA
1d900 44 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d D.. */. if( p-
1d910 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1d920 57 52 49 54 45 20 29 7b 0a 20 20 20 20 69 6e 74 WRITE ){. int
1d930 20 72 63 3b 0a 20 20 20 20 42 74 53 68 61 72 65 rc;. BtShare
1d940 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
1d950 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 . assert( pBt
1d960 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d ->inTransaction=
1d970 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a =TRANS_WRITE );.
1d980 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
1d990 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3e 30 20 >nTransaction>0
1d9a0 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
1d9b0 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 te3PagerCommitPh
1d9c0 61 73 65 54 77 6f 28 70 42 74 2d 3e 70 50 61 67 aseTwo(pBt->pPag
1d9d0 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 er);. if( rc!
1d9e0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 43 =SQLITE_OK && bC
1d9f0 6c 65 61 6e 75 70 3d 3d 30 20 29 7b 0a 20 20 20 leanup==0 ){.
1da00 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
1da10 65 61 76 65 28 70 29 3b 0a 20 20 20 20 20 20 72 eave(p);. r
1da20 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
1da30 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 pBt->inTrans
1da40 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 action = TRANS_R
1da50 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 43 6c EAD;. btreeCl
1da60 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 earHasContent(pB
1da70 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 t);. }.. btree
1da80 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 EndTransaction(p
1da90 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
1daa0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
1dab0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
1dac0 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 6f 74 68 20 ../*.** Do both
1dad0 70 68 61 73 65 73 20 6f 66 20 61 20 63 6f 6d 6d phases of a comm
1dae0 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 it..*/.int sqlit
1daf0 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 42 74 e3BtreeCommit(Bt
1db00 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 ree *p){. int r
1db10 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 c;. sqlite3Btre
1db20 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 20 eEnter(p);. rc
1db30 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f = sqlite3BtreeCo
1db40 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 2c 20 mmitPhaseOne(p,
1db50 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 0);. if( rc==SQ
1db60 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
1db70 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
1db80 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70 CommitPhaseTwo(p
1db90 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 , 0);. }. sqli
1dba0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
1dbb0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1dbc0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
1dbd0 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 73 74 tine sets the st
1dbe0 61 74 65 20 74 6f 20 43 55 52 53 4f 52 5f 46 41 ate to CURSOR_FA
1dbf0 55 4c 54 20 61 6e 64 20 74 68 65 20 65 72 72 6f ULT and the erro
1dc00 72 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 65 72 72 r.** code to err
1dc10 43 6f 64 65 20 66 6f 72 20 65 76 65 72 79 20 63 Code for every c
1dc20 75 72 73 6f 72 20 6f 6e 20 61 6e 79 20 42 74 53 ursor on any BtS
1dc30 68 61 72 65 64 20 74 68 61 74 20 70 42 74 72 65 hared that pBtre
1dc40 65 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 2e e.** references.
1dc50 20 20 4f 72 20 69 66 20 74 68 65 20 77 72 69 74 Or if the writ
1dc60 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 65 eOnly flag is se
1dc70 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 6f 6e 6c t to 1, then onl
1dc80 79 0a 2a 2a 20 74 72 69 70 20 77 72 69 74 65 20 y.** trip write
1dc90 63 75 72 73 6f 72 73 20 61 6e 64 20 6c 65 61 76 cursors and leav
1dca0 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 75 e read cursors u
1dcb0 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 nchanged..**.**
1dcc0 45 76 65 72 79 20 63 75 72 73 6f 72 20 69 73 20 Every cursor is
1dcd0 61 20 63 61 6e 64 69 64 61 74 65 20 74 6f 20 62 a candidate to b
1dce0 65 20 74 72 69 70 70 65 64 2c 20 69 6e 63 6c 75 e tripped, inclu
1dcf0 64 69 6e 67 20 63 75 72 73 6f 72 73 0a 2a 2a 20 ding cursors.**
1dd00 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 6f that belong to o
1dd10 74 68 65 72 20 64 61 74 61 62 61 73 65 20 63 6f ther database co
1dd20 6e 6e 65 63 74 69 6f 6e 73 20 74 68 61 74 20 68 nnections that h
1dd30 61 70 70 65 6e 20 74 6f 20 62 65 0a 2a 2a 20 73 appen to be.** s
1dd40 68 61 72 69 6e 67 20 74 68 65 20 63 61 63 68 65 haring the cache
1dd50 20 77 69 74 68 20 70 42 74 72 65 65 2e 0a 2a 2a with pBtree..**
1dd60 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
1dd70 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77 68 65 gets called whe
1dd80 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 n a rollback occ
1dd90 75 72 73 2e 20 49 66 20 74 68 65 20 77 72 69 74 urs. If the writ
1dda0 65 4f 6e 6c 79 0a 2a 2a 20 66 6c 61 67 20 69 73 eOnly.** flag is
1ddb0 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e 6c 79 true, then only
1ddc0 20 77 72 69 74 65 2d 63 75 72 73 6f 72 73 20 6e write-cursors n
1ddd0 65 65 64 20 62 65 20 74 72 69 70 70 65 64 20 2d eed be tripped -
1dde0 20 72 65 61 64 2d 6f 6e 6c 79 0a 2a 2a 20 63 75 read-only.** cu
1ddf0 72 73 6f 72 73 20 73 61 76 65 20 74 68 65 69 72 rsors save their
1de00 20 63 75 72 72 65 6e 74 20 70 6f 73 69 74 69 6f current positio
1de10 6e 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 ns so that they
1de20 6d 61 79 20 63 6f 6e 74 69 6e 75 65 20 0a 2a 2a may continue .**
1de30 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 72 following the r
1de40 6f 6c 6c 62 61 63 6b 2e 20 4f 72 2c 20 69 66 20 ollback. Or, if
1de50 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c writeOnly is fal
1de60 73 65 2c 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 se, all cursors
1de70 61 72 65 20 0a 2a 2a 20 74 72 69 70 70 65 64 2e are .** tripped.
1de80 20 49 6e 20 67 65 6e 65 72 61 6c 2c 20 77 72 69 In general, wri
1de90 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 20 teOnly is false
1dea0 69 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 if the transacti
1deb0 6f 6e 20 62 65 69 6e 67 0a 2a 2a 20 72 6f 6c 6c on being.** roll
1dec0 65 64 20 62 61 63 6b 20 6d 6f 64 69 66 69 65 64 ed back modified
1ded0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 the database sc
1dee0 68 65 6d 61 2e 20 49 6e 20 74 68 69 73 20 63 61 hema. In this ca
1def0 73 65 20 62 2d 74 72 65 65 20 72 6f 6f 74 0a 2a se b-tree root.*
1df00 2a 20 70 61 67 65 73 20 6d 61 79 20 62 65 20 6d * pages may be m
1df10 6f 76 65 64 20 6f 72 20 64 65 6c 65 74 65 64 20 oved or deleted
1df20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
1df30 65 20 61 6c 74 6f 67 65 74 68 65 72 2c 20 6d 61 e altogether, ma
1df40 6b 69 6e 67 0a 2a 2a 20 69 74 20 75 6e 73 61 66 king.** it unsaf
1df50 65 20 66 6f 72 20 72 65 61 64 20 63 75 72 73 6f e for read curso
1df60 72 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 2e 0a rs to continue..
1df70 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 77 72 69 **.** If the wri
1df80 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 74 teOnly flag is t
1df90 72 75 65 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 rue and an error
1dfa0 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 is encountered
1dfb0 77 68 69 6c 65 20 0a 2a 2a 20 73 61 76 69 6e 67 while .** saving
1dfc0 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 6f 73 the current pos
1dfd0 69 74 69 6f 6e 20 6f 66 20 61 20 72 65 61 64 2d ition of a read-
1dfe0 6f 6e 6c 79 20 63 75 72 73 6f 72 2c 20 61 6c 6c only cursor, all
1dff0 20 63 75 72 73 6f 72 73 2c 20 0a 2a 2a 20 69 6e cursors, .** in
1e000 63 6c 75 64 69 6e 67 20 61 6c 6c 20 72 65 61 64 cluding all read
1e010 2d 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 69 -cursors are tri
1e020 70 70 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 pped..**.** SQLI
1e030 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
1e040 64 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c d if successful,
1e050 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 or if an error
1e060 6f 63 63 75 72 73 20 77 68 69 6c 65 0a 2a 2a 20 occurs while.**
1e070 73 61 76 69 6e 67 20 61 20 63 75 72 73 6f 72 20 saving a cursor
1e080 70 6f 73 69 74 69 6f 6e 2c 20 61 6e 20 53 51 4c position, an SQL
1e090 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a ite error code..
1e0a0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1e0b0 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 reeTripAllCursor
1e0c0 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 65 2c s(Btree *pBtree,
1e0d0 20 69 6e 74 20 65 72 72 43 6f 64 65 2c 20 69 6e int errCode, in
1e0e0 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b 0a 20 20 t writeOnly){.
1e0f0 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 69 BtCursor *p;. i
1e100 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1e110 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 28 77 K;.. assert( (w
1e120 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 77 riteOnly==0 || w
1e130 72 69 74 65 4f 6e 6c 79 3d 3d 31 29 20 26 26 20 riteOnly==1) &&
1e140 42 54 43 46 5f 57 72 69 74 65 46 6c 61 67 3d 3d BTCF_WriteFlag==
1e150 31 20 29 3b 0a 20 20 69 66 28 20 70 42 74 72 65 1 );. if( pBtre
1e160 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 e ){. sqlite3
1e170 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 BtreeEnter(pBtre
1e180 65 29 3b 0a 20 20 20 20 66 6f 72 28 70 3d 70 42 e);. for(p=pB
1e190 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 73 tree->pBt->pCurs
1e1a0 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 or; p; p=p->pNex
1e1b0 74 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b t){. int i;
1e1c0 0a 20 20 20 20 20 20 69 66 28 20 77 72 69 74 65 . if( write
1e1d0 4f 6e 6c 79 20 26 26 20 28 70 2d 3e 63 75 72 46 Only && (p->curF
1e1e0 6c 61 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 lags & BTCF_Writ
1e1f0 65 46 6c 61 67 29 3d 3d 30 20 29 7b 0a 20 20 20 eFlag)==0 ){.
1e200 20 20 20 20 20 69 66 28 20 70 2d 3e 65 53 74 61 if( p->eSta
1e210 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
1e220 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
1e230 20 3d 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 = saveCursorPos
1e240 69 74 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 20 ition(p);.
1e250 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1e260 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1e270 20 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 (void)sqlit
1e280 65 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 e3BtreeTripAllCu
1e290 72 73 6f 72 73 28 70 42 74 72 65 65 2c 20 72 63 rsors(pBtree, rc
1e2a0 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 0);.
1e2b0 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
1e2c0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
1e2d0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
1e2e0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1e2f0 43 6c 65 61 72 43 75 72 73 6f 72 28 70 29 3b 0a ClearCursor(p);.
1e300 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 p->eStat
1e310 65 20 3d 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 e = CURSOR_FAULT
1e320 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 73 6b 69 ;. p->ski
1e330 70 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b pNext = errCode;
1e340 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 . }. f
1e350 6f 72 28 69 3d 30 3b 20 69 3c 3d 70 2d 3e 69 50 or(i=0; i<=p->iP
1e360 61 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 age; i++){.
1e370 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
1e380 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 ->apPage[i]);.
1e390 20 20 20 20 20 20 70 2d 3e 61 70 50 61 67 65 5b p->apPage[
1e3a0 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a i] = 0;. }.
1e3b0 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
1e3c0 33 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 3BtreeLeave(pBtr
1e3d0 65 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ee);. }. retur
1e3e0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
1e3f0 6f 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e ollback the tran
1e400 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 saction in progr
1e410 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 72 ess..**.** If tr
1e420 69 70 43 6f 64 65 20 69 73 20 6e 6f 74 20 53 51 ipCode is not SQ
1e430 4c 49 54 45 5f 4f 4b 20 74 68 65 6e 20 63 75 72 LITE_OK then cur
1e440 73 6f 72 73 20 77 69 6c 6c 20 62 65 20 69 6e 76 sors will be inv
1e450 61 6c 69 64 61 74 65 64 20 28 74 72 69 70 70 65 alidated (trippe
1e460 64 29 2e 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 d)..** Only writ
1e470 65 20 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 e cursors are tr
1e480 69 70 70 65 64 20 69 66 20 77 72 69 74 65 4f 6e ipped if writeOn
1e490 6c 79 20 69 73 20 74 72 75 65 20 62 75 74 20 61 ly is true but a
1e4a0 6c 6c 20 63 75 72 73 6f 72 73 20 61 72 65 0a 2a ll cursors are.*
1e4b0 2a 20 74 72 69 70 70 65 64 20 69 66 20 77 72 69 * tripped if wri
1e4c0 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 2e teOnly is false.
1e4d0 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f Any attempt to
1e4e0 20 75 73 65 0a 2a 2a 20 61 20 74 72 69 70 70 65 use.** a trippe
1e4f0 64 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 72 65 d cursor will re
1e500 73 75 6c 74 20 69 6e 20 61 6e 20 65 72 72 6f 72 sult in an error
1e510 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c ..**.** This wil
1e520 6c 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 l release the wr
1e530 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ite lock on the
1e540 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
1e550 49 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 If there.** are
1e560 6e 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 no active cursor
1e570 73 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 s, it also relea
1e580 73 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 ses the read loc
1e590 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 k..*/.int sqlite
1e5a0 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 3BtreeRollback(B
1e5b0 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 tree *p, int tri
1e5c0 70 43 6f 64 65 2c 20 69 6e 74 20 77 72 69 74 65 pCode, int write
1e5d0 4f 6e 6c 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b Only){. int rc;
1e5e0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
1e5f0 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d = p->pBt;. Mem
1e600 50 61 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 Page *pPage1;..
1e610 20 61 73 73 65 72 74 28 20 77 72 69 74 65 4f 6e assert( writeOn
1e620 6c 79 3d 3d 31 20 7c 7c 20 77 72 69 74 65 4f 6e ly==1 || writeOn
1e630 6c 79 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ly==0 );. asser
1e640 74 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c t( tripCode==SQL
1e650 49 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 ITE_ABORT_ROLLBA
1e660 43 4b 20 7c 7c 20 74 72 69 70 43 6f 64 65 3d 3d CK || tripCode==
1e670 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 73 SQLITE_OK );. s
1e680 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1e690 28 70 29 3b 0a 20 20 69 66 28 20 74 72 69 70 43 (p);. if( tripC
1e6a0 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 ode==SQLITE_OK )
1e6b0 7b 0a 20 20 20 20 72 63 20 3d 20 74 72 69 70 43 {. rc = tripC
1e6c0 6f 64 65 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 ode = saveAllCur
1e6d0 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b sors(pBt, 0, 0);
1e6e0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 77 72 . if( rc ) wr
1e6f0 69 74 65 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d iteOnly = 0;. }
1e700 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 else{. rc = S
1e710 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 QLITE_OK;. }.
1e720 69 66 28 20 74 72 69 70 43 6f 64 65 20 29 7b 0a if( tripCode ){.
1e730 20 20 20 20 69 6e 74 20 72 63 32 20 3d 20 73 71 int rc2 = sq
1e740 6c 69 74 65 33 42 74 72 65 65 54 72 69 70 41 6c lite3BtreeTripAl
1e750 6c 43 75 72 73 6f 72 73 28 70 2c 20 74 72 69 70 lCursors(p, trip
1e760 43 6f 64 65 2c 20 77 72 69 74 65 4f 6e 6c 79 29 Code, writeOnly)
1e770 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 ;. assert( rc
1e780 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 ==SQLITE_OK || (
1e790 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 26 26 20 writeOnly==0 &&
1e7a0 72 63 32 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 rc2==SQLITE_OK)
1e7b0 29 3b 0a 20 20 20 20 69 66 28 20 72 63 32 21 3d );. if( rc2!=
1e7c0 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d SQLITE_OK ) rc =
1e7d0 20 72 63 32 3b 0a 20 20 7d 0a 20 20 62 74 72 65 rc2;. }. btre
1e7e0 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a eIntegrity(p);..
1e7f0 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1e800 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b ==TRANS_WRITE ){
1e810 0a 20 20 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 . int rc2;..
1e820 20 20 20 61 73 73 65 72 74 28 20 54 52 41 4e 53 assert( TRANS
1e830 5f 57 52 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 _WRITE==pBt->inT
1e840 72 61 6e 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 ransaction );.
1e850 20 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 50 rc2 = sqlite3P
1e860 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 agerRollback(pBt
1e870 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 ->pPager);. i
1e880 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f f( rc2!=SQLITE_O
1e890 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 K ){. rc =
1e8a0 72 63 32 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 rc2;. }..
1e8b0 2f 2a 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 /* The rollback
1e8c0 6d 61 79 20 68 61 76 65 20 64 65 73 74 72 6f 79 may have destroy
1e8d0 65 64 20 74 68 65 20 70 50 61 67 65 31 2d 3e 61 ed the pPage1->a
1e8e0 44 61 74 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a Data value. So.
1e8f0 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 ** call btre
1e900 65 47 65 74 50 61 67 65 28 29 20 6f 6e 20 70 61 eGetPage() on pa
1e910 67 65 20 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 ge 1 again to ma
1e920 6b 65 0a 20 20 20 20 2a 2a 20 73 75 72 65 20 70 ke. ** sure p
1e930 50 61 67 65 31 2d 3e 61 44 61 74 61 20 69 73 20 Page1->aData is
1e940 73 65 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a set correctly. *
1e950 2f 0a 20 20 20 20 69 66 28 20 62 74 72 65 65 47 /. if( btreeG
1e960 65 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 etPage(pBt, 1, &
1e970 70 50 61 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 pPage1, 0)==SQLI
1e980 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
1e990 6e 74 20 6e 50 61 67 65 20 3d 20 67 65 74 34 62 nt nPage = get4b
1e9a0 79 74 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 yte(28+(u8*)pPag
1e9b0 65 31 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 e1->aData);.
1e9c0 20 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 67 testcase( nPag
1e9d0 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 e==0 );. if
1e9e0 28 20 6e 50 61 67 65 3d 3d 30 20 29 20 73 71 6c ( nPage==0 ) sql
1e9f0 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 ite3PagerPagecou
1ea00 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 nt(pBt->pPager,
1ea10 26 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 74 &nPage);. t
1ea20 65 73 74 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 estcase( pBt->nP
1ea30 61 67 65 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 age!=nPage );.
1ea40 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d pBt->nPage =
1ea50 20 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 72 65 nPage;. re
1ea60 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 leasePage(pPage1
1ea70 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 );. }. ass
1ea80 65 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 ert( countValidC
1ea90 75 72 73 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d ursors(pBt, 1)==
1eaa0 30 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 0 );. pBt->in
1eab0 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 Transaction = TR
1eac0 41 4e 53 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 ANS_READ;. bt
1ead0 72 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 reeClearHasConte
1eae0 6e 74 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 nt(pBt);. }..
1eaf0 62 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 btreeEndTransact
1eb00 69 6f 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 ion(p);. sqlite
1eb10 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
1eb20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1eb30 2f 2a 0a 2a 2a 20 53 74 61 72 74 20 61 20 73 74 /*.** Start a st
1eb40 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
1eb50 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 action. The subt
1eb60 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 ransaction can b
1eb70 65 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b e rolled.** back
1eb80 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f independently o
1eb90 66 20 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 f the main trans
1eba0 61 63 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 action. You must
1ebb0 20 73 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 start a transac
1ebc0 74 69 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 tion .** before
1ebd0 73 74 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 starting a subtr
1ebe0 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 ansaction. The s
1ebf0 75 62 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 ubtransaction is
1ec00 20 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 ended automatic
1ec10 61 6c 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 ally .** if the
1ec20 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e main transaction
1ec30 20 63 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c commits or roll
1ec40 73 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 s back..**.** St
1ec50 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
1ec60 61 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 actions are used
1ec70 20 61 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 around individu
1ec80 61 6c 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 al SQL statement
1ec90 73 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f s.** that are co
1eca0 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 ntained within a
1ecb0 20 42 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 BEGIN...COMMIT
1ecc0 62 6c 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e block. If a con
1ecd0 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 straint.** error
1ece0 20 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 occurs within t
1ecf0 68 65 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 he statement, th
1ed00 65 20 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 e effect of that
1ed10 20 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a one statement.*
1ed20 2a 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 * can be rolled
1ed30 62 61 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 back without hav
1ed40 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 ing to rollback
1ed50 74 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 the entire trans
1ed60 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 action..**.** A
1ed70 73 74 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 statement sub-tr
1ed80 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 ansaction is imp
1ed90 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 lemented as an a
1eda0 6e 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 nonymous savepoi
1edb0 6e 74 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 nt. The.** value
1edc0 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 passed as the s
1edd0 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 econd parameter
1ede0 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d is the total num
1edf0 62 65 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 ber of savepoint
1ee00 73 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 s,.** including
1ee10 74 68 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 the new anonymou
1ee20 73 20 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 s savepoint, ope
1ee30 6e 20 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e n on the B-Tree.
1ee40 20 69 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a i.e. if there.*
1ee50 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 * are no active
1ee60 73 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e savepoints and n
1ee70 6f 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e o other statemen
1ee80 74 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f t-transactions o
1ee90 70 65 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 pen,.** iStateme
1eea0 6e 74 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e nt is 1. This an
1eeb0 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e onymous savepoin
1eec0 74 20 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 t can be release
1eed0 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b d or rolled back
1eee0 0a 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 .** using the sq
1eef0 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
1ef00 69 6e 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a int() function..
1ef10 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1ef20 72 65 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 reeBeginStmt(Btr
1ef30 65 65 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 ee *p, int iStat
1ef40 65 6d 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 ement){. int rc
1ef50 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
1ef60 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 t = p->pBt;. sq
1ef70 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
1ef80 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d p);. assert( p-
1ef90 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1efa0 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 WRITE );. asser
1efb0 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 t( (pBt->btsFlag
1efc0 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
1efd0 59 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 Y)==0 );. asser
1efe0 74 28 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 t( iStatement>0
1eff0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 );. assert( iSt
1f000 61 74 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e atement>p->db->n
1f010 53 61 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 Savepoint );. a
1f020 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 ssert( pBt->inTr
1f030 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
1f040 5f 57 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 _WRITE );. /* A
1f050 74 20 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 t the pager leve
1f060 6c 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 l, a statement t
1f070 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 ransaction is a
1f080 73 61 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 savepoint with.
1f090 20 2a 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 ** an index gre
1f0a0 61 74 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 ater than all sa
1f0b0 76 65 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 vepoints created
1f0c0 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e explicitly usin
1f0d0 67 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 g. ** SQL state
1f0e0 6d 65 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c ments. It is ill
1f0f0 65 67 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 egal to open, re
1f100 6c 65 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 lease or rollbac
1f110 6b 20 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 k any. ** such
1f120 73 61 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 savepoints while
1f130 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 the statement t
1f140 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 ransaction savep
1f150 6f 69 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a oint is active..
1f160 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
1f170 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 te3PagerOpenSave
1f180 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 point(pBt->pPage
1f190 72 2c 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a r, iStatement);.
1f1a0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
1f1b0 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
1f1c0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
1f1d0 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
1f1e0 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 t to this functi
1f1f0 6f 6e 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 on, op, is alway
1f200 73 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c s SAVEPOINT_ROLL
1f210 42 41 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 BACK.** or SAVEP
1f220 4f 49 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 OINT_RELEASE. Th
1f230 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 is function eith
1f240 65 72 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 er releases or r
1f250 6f 6c 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a olls back the.**
1f260 20 73 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 savepoint ident
1f270 69 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 ified by paramet
1f280 65 72 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 er iSavepoint, d
1f290 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 epending on the
1f2a0 76 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e value .** of op.
1f2b0 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c .**.** Normally,
1f2c0 20 69 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 iSavepoint is g
1f2d0 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 reater than or e
1f2e0 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f qual to zero. Ho
1f2f0 77 65 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a wever, if op is.
1f300 2a 2a 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c ** SAVEPOINT_ROL
1f310 4c 42 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 LBACK, then iSav
1f320 65 70 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 epoint may also
1f330 62 65 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 be -1. In this c
1f340 61 73 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 ase the .** cont
1f350 65 6e 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 ents of the enti
1f360 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 re transaction a
1f370 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 re rolled back.
1f380 54 68 69 73 20 69 73 20 64 69 66 66 65 72 65 6e This is differen
1f390 74 0a 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d t.** from a norm
1f3a0 61 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 al transaction r
1f3b0 6f 6c 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c ollback, as no l
1f3c0 6f 63 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 ocks are release
1f3d0 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 d and the.** tra
1f3e0 6e 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 nsaction remains
1f3f0 20 6f 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 open..*/.int sq
1f400 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
1f410 69 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e int(Btree *p, in
1f420 74 20 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 t op, int iSavep
1f430 6f 69 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 oint){. int rc
1f440 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
1f450 66 28 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 f( p && p->inTra
1f460 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 ns==TRANS_WRITE
1f470 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 ){. BtShared
1f480 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
1f490 20 20 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 assert( op==S
1f4a0 41 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 AVEPOINT_RELEASE
1f4b0 20 7c 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e || op==SAVEPOIN
1f4c0 54 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 T_ROLLBACK );.
1f4d0 20 20 61 73 73 65 72 74 28 20 69 53 61 76 65 70 assert( iSavep
1f4e0 6f 69 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 oint>=0 || (iSav
1f4f0 65 70 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 epoint==-1 && op
1f500 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c ==SAVEPOINT_ROLL
1f510 42 41 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c BACK) );. sql
1f520 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1f530 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
1f540 74 65 33 50 61 67 65 72 53 61 76 65 70 6f 69 6e te3PagerSavepoin
1f550 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6f t(pBt->pPager, o
1f560 70 2c 20 69 53 61 76 65 70 6f 69 6e 74 29 3b 0a p, iSavepoint);.
1f570 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1f580 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
1f590 66 28 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 f( iSavepoint<0
1f5a0 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 && (pBt->btsFlag
1f5b0 73 20 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c s & BTS_INITIALL
1f5c0 59 5f 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 Y_EMPTY)!=0 ){.
1f5d0 20 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 pBt->nPag
1f5e0 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 e = 0;. }.
1f5f0 20 20 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 rc = newDat
1f600 61 62 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 abase(pBt);.
1f610 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 pBt->nPage = g
1f620 65 74 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 et4byte(28 + pBt
1f630 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 ->pPage1->aData)
1f640 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ;.. /* The
1f650 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 database size wa
1f660 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 s written into t
1f670 68 65 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 he offset 28 of
1f680 74 68 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 the header.
1f690 20 2a 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 ** when the tra
1f6a0 6e 73 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 nsaction started
1f6b0 2c 20 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 , so we know tha
1f6c0 74 20 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f t the value at o
1f6d0 66 66 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 ffset. ** 2
1f6e0 38 20 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 8 is nonzero. */
1f6f0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
1f700 42 74 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 Bt->nPage>0 );.
1f710 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
1f720 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1f730 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
1f740 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 }../*.** Create
1f750 61 20 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 a new cursor for
1f760 20 74 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 the BTree whose
1f770 20 72 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 root is on the
1f780 70 61 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 page.** iTable.
1f790 49 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 If a read-only c
1f7a0 75 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 ursor is request
1f7b0 65 64 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 ed, it is assume
1f7c0 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 d that.** the ca
1f7d0 6c 6c 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 ller already has
1f7e0 20 61 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 at least a read
1f7f0 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f -only transactio
1f800 6e 20 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 n open.** on the
1f810 20 64 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 database alread
1f820 79 2e 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 y. If a write-cu
1f830 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 rsor is requeste
1f840 64 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 d, then.** the c
1f850 61 6c 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 aller is assumed
1f860 20 74 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e to have an open
1f870 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
1f880 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 77 72 46 on..**.** If wrF
1f890 6c 61 67 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 lag==0, then the
1f8a0 20 63 75 72 73 6f 72 20 63 61 6e 20 6f 6e 6c 79 cursor can only
1f8b0 20 62 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 be used for rea
1f8c0 64 69 6e 67 2e 0a 2a 2a 20 49 66 20 77 72 46 6c ding..** If wrFl
1f8d0 61 67 3d 3d 31 2c 20 74 68 65 6e 20 74 68 65 20 ag==1, then the
1f8e0 63 75 72 73 6f 72 20 63 61 6e 20 62 65 20 75 73 cursor can be us
1f8f0 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f ed for reading o
1f900 72 20 66 6f 72 0a 2a 2a 20 77 72 69 74 69 6e 67 r for.** writing
1f910 20 69 66 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 if other condit
1f920 69 6f 6e 73 20 66 6f 72 20 77 72 69 74 69 6e 67 ions for writing
1f930 20 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 are also met.
1f940 54 68 65 73 65 0a 2a 2a 20 61 72 65 20 74 68 65 These.** are the
1f950 20 63 6f 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 conditions that
1f960 20 6d 75 73 74 20 62 65 20 6d 65 74 20 69 6e 20 must be met in
1f970 6f 72 64 65 72 20 66 6f 72 20 77 72 69 74 69 6e order for writin
1f980 67 20 74 6f 0a 2a 2a 20 62 65 20 61 6c 6c 6f 77 g to.** be allow
1f990 65 64 3a 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 ed:.**.** 1: Th
1f9a0 65 20 63 75 72 73 6f 72 20 6d 75 73 74 20 68 61 e cursor must ha
1f9b0 76 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 ve been opened w
1f9c0 69 74 68 20 77 72 46 6c 61 67 3d 3d 31 0a 2a 2a ith wrFlag==1.**
1f9d0 0a 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 61 .** 2: Other da
1f9e0 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1f9f0 6e 73 20 74 68 61 74 20 73 68 61 72 65 20 74 68 ns that share th
1fa00 65 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 63 e same pager cac
1fa10 68 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 68 he.** but wh
1fa20 69 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 ich are not in t
1fa30 68 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 he READ_UNCOMMIT
1fa40 54 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e 6f TED state may no
1fa50 74 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 t have.** cu
1fa60 72 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 20 rsors open with
1fa70 77 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 wrFlag==0 on the
1fa80 20 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 same table. Ot
1fa90 68 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 herwise.** t
1faa0 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 he changes made
1fab0 62 79 20 74 68 69 73 20 77 72 69 74 65 20 63 75 by this write cu
1fac0 72 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 69 rsor would be vi
1fad0 73 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 sible to.**
1fae0 74 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 the read cursors
1faf0 20 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 61 in the other da
1fb00 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1fb10 6e 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 n..**.** 3: The
1fb20 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 database must b
1fb30 65 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 e writable (not
1fb40 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 on read-only med
1fb50 69 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 ia).**.** 4: Th
1fb60 65 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 61 ere must be an a
1fb70 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f ctive transactio
1fb80 6e 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 20 63 68 65 63 n..**.** No chec
1fb90 6b 69 6e 67 20 69 73 20 64 6f 6e 65 20 74 6f 20 king is done to
1fba0 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 70 make sure that p
1fbb0 61 67 65 20 69 54 61 62 6c 65 20 72 65 61 6c 6c age iTable reall
1fbc0 79 20 69 73 20 74 68 65 0a 2a 2a 20 72 6f 6f 74 y is the.** root
1fbd0 20 70 61 67 65 20 6f 66 20 61 20 62 2d 74 72 65 page of a b-tre
1fbe0 65 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 e. If it is not
1fbf0 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
1fc00 72 20 61 63 71 75 69 72 65 64 0a 2a 2a 20 77 69 r acquired.** wi
1fc10 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 ll not work corr
1fc20 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 ectly..**.** It
1fc30 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 is assumed that
1fc40 74 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 the sqlite3Btree
1fc50 43 75 72 73 6f 72 5a 65 72 6f 28 29 20 68 61 73 CursorZero() has
1fc60 20 62 65 65 6e 20 63 61 6c 6c 65 64 0a 2a 2a 20 been called.**
1fc70 6f 6e 20 70 43 75 72 20 74 6f 20 69 6e 69 74 69 on pCur to initi
1fc80 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 alize the memory
1fc90 20 73 70 61 63 65 20 70 72 69 6f 72 20 74 6f 20 space prior to
1fca0 69 6e 76 6f 6b 69 6e 67 20 74 68 69 73 20 72 6f invoking this ro
1fcb0 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 utine..*/.static
1fcc0 20 69 6e 74 20 62 74 72 65 65 43 75 72 73 6f 72 int btreeCursor
1fcd0 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 20 (. Btree *p,
1fce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fcf0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
1fd00 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 e btree */. int
1fd10 20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 iTable,
1fd20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fd30 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 /* Root page
1fd40 20 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f 70 65 of table to ope
1fd50 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 6c 61 n */. int wrFla
1fd60 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g,
1fd70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1fd80 20 31 20 74 6f 20 77 72 69 74 65 2e 20 30 20 72 1 to write. 0 r
1fd90 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 ead-only */. st
1fda0 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 2a 70 4b ruct KeyInfo *pK
1fdb0 65 79 49 6e 66 6f 2c 20 20 20 20 20 20 20 20 20 eyInfo,
1fdc0 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
1fdd0 67 20 74 6f 20 63 6f 6d 70 61 72 69 73 6f 6e 20 g to comparison
1fde0 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 42 74 function */. Bt
1fdf0 43 75 72 73 6f 72 20 2a 70 43 75 72 20 20 20 20 Cursor *pCur
1fe00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fe10 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 66 6f /* Space fo
1fe20 72 20 6e 65 77 20 63 75 72 73 6f 72 20 2a 2f 0a r new cursor */.
1fe30 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
1fe40 42 74 20 3d 20 70 2d 3e 70 42 74 3b 20 20 20 20 Bt = p->pBt;
1fe50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
1fe60 68 61 72 65 64 20 62 2d 74 72 65 65 20 68 61 6e hared b-tree han
1fe70 64 6c 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 dle */.. assert
1fe80 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f ( sqlite3BtreeHo
1fe90 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 ldsMutex(p) );.
1fea0 20 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d assert( wrFlag=
1feb0 3d 30 20 7c 7c 20 77 72 46 6c 61 67 3d 3d 31 20 =0 || wrFlag==1
1fec0 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c );.. /* The fol
1fed0 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 20 73 74 lowing assert st
1fee0 61 74 65 6d 65 6e 74 73 20 76 65 72 69 66 79 20 atements verify
1fef0 74 68 61 74 20 69 66 20 74 68 69 73 20 69 73 20 that if this is
1ff00 61 20 73 68 61 72 61 62 6c 65 20 0a 20 20 2a 2a a sharable . **
1ff10 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73 65 b-tree database
1ff20 2c 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e , the connection
1ff30 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 is holding the
1ff40 72 65 71 75 69 72 65 64 20 74 61 62 6c 65 20 6c required table l
1ff50 6f 63 6b 73 2c 20 0a 20 20 2a 2a 20 61 6e 64 20 ocks, . ** and
1ff60 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 63 6f that no other co
1ff70 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 6e 79 nnection has any
1ff80 20 6f 70 65 6e 20 63 75 72 73 6f 72 20 74 68 61 open cursor tha
1ff90 74 20 63 6f 6e 66 6c 69 63 74 73 20 77 69 74 68 t conflicts with
1ffa0 20 0a 20 20 2a 2a 20 74 68 69 73 20 6c 6f 63 6b . ** this lock
1ffb0 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
1ffc0 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 hasSharedCacheTa
1ffd0 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 62 6c bleLock(p, iTabl
1ffe0 65 2c 20 70 4b 65 79 49 6e 66 6f 21 3d 30 2c 20 e, pKeyInfo!=0,
1fff0 77 72 46 6c 61 67 2b 31 29 20 29 3b 0a 20 20 61 wrFlag+1) );. a
20000 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 ssert( wrFlag==0
20010 20 7c 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 || !hasReadConf
20020 6c 69 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 licts(p, iTable)
20030 20 29 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 );.. /* Assert
20040 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 that the caller
20050 20 68 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 has opened the
20060 72 65 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 required transac
20070 74 69 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 tion. */. asser
20080 74 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 t( p->inTrans>TR
20090 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 ANS_NONE );. as
200a0 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
200b0 7c 7c 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 || p->inTrans==T
200c0 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 RANS_WRITE );.
200d0 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 assert( pBt->pPa
200e0 67 65 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 ge1 && pBt->pPag
200f0 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a 0a 20 20 e1->aData );..
20100 69 66 28 20 4e 45 56 45 52 28 77 72 46 6c 61 67 if( NEVER(wrFlag
20110 20 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 && (pBt->btsFla
20120 67 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e gs & BTS_READ_ON
20130 4c 59 29 21 3d 30 29 20 29 7b 0a 20 20 20 20 72 LY)!=0) ){. r
20140 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 eturn SQLITE_REA
20150 44 4f 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 DONLY;. }. if(
20160 20 77 72 46 6c 61 67 20 29 7b 0a 20 20 20 20 61 wrFlag ){. a
20170 6c 6c 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 llocateTempSpace
20180 28 70 42 74 29 3b 0a 20 20 20 20 69 66 28 20 70 (pBt);. if( p
20190 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 3d 3d 30 Bt->pTmpSpace==0
201a0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
201b0 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 _NOMEM;. }. if
201c0 28 20 69 54 61 62 6c 65 3d 3d 31 20 26 26 20 62 ( iTable==1 && b
201d0 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 treePagecount(pB
201e0 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 t)==0 ){. ass
201f0 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 29 ert( wrFlag==0 )
20200 3b 0a 20 20 20 20 69 54 61 62 6c 65 20 3d 20 30 ;. iTable = 0
20210 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 ;. }.. /* Now
20220 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 65 72 that no other er
20230 72 6f 72 73 20 63 61 6e 20 6f 63 63 75 72 2c 20 rors can occur,
20240 66 69 6e 69 73 68 20 66 69 6c 6c 69 6e 67 20 69 finish filling i
20250 6e 20 74 68 65 20 42 74 43 75 72 73 6f 72 0a 20 n the BtCursor.
20260 20 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 61 6e ** variables an
20270 64 20 6c 69 6e 6b 20 74 68 65 20 63 75 72 73 6f d link the curso
20280 72 20 69 6e 74 6f 20 74 68 65 20 42 74 53 68 61 r into the BtSha
20290 72 65 64 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 red list. */.
202a0 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 3d pCur->pgnoRoot =
202b0 20 28 50 67 6e 6f 29 69 54 61 62 6c 65 3b 0a 20 (Pgno)iTable;.
202c0 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d pCur->iPage = -
202d0 31 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 1;. pCur->pKeyI
202e0 6e 66 6f 20 3d 20 70 4b 65 79 49 6e 66 6f 3b 0a nfo = pKeyInfo;.
202f0 20 20 70 43 75 72 2d 3e 70 42 74 72 65 65 20 3d pCur->pBtree =
20300 20 70 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 20 p;. pCur->pBt
20310 3d 20 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 = pBt;. assert(
20320 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 77 72 wrFlag==0 || wr
20330 46 6c 61 67 3d 3d 42 54 43 46 5f 57 72 69 74 65 Flag==BTCF_Write
20340 46 6c 61 67 20 29 3b 0a 20 20 70 43 75 72 2d 3e Flag );. pCur->
20350 63 75 72 46 6c 61 67 73 20 3d 20 77 72 46 6c 61 curFlags = wrFla
20360 67 3b 0a 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 g;. pCur->pNext
20370 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b = pBt->pCursor;
20380 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 70 4e 65 . if( pCur->pNe
20390 78 74 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e xt ){. pCur->
203a0 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 pNext->pPrev = p
203b0 43 75 72 3b 0a 20 20 7d 0a 20 20 70 42 74 2d 3e Cur;. }. pBt->
203c0 70 43 75 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a pCursor = pCur;.
203d0 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
203e0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
203f0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
20400 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 _OK;.}.int sqlit
20410 65 33 42 74 72 65 65 43 75 72 73 6f 72 28 0a 20 e3BtreeCursor(.
20420 20 42 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 Btree *p,
20430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20440 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
20450 54 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 The btree */. i
20460 6e 74 20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 nt iTable,
20470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20480 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f /* Ro
20490 6f 74 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 ot page of table
204a0 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e to open */. in
204b0 74 20 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 t wrFlag,
204c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
204d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 20 74 /* 1 t
204e0 6f 20 77 72 69 74 65 2e 20 30 20 72 65 61 64 2d o write. 0 read-
204f0 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 only */. struct
20500 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e KeyInfo *pKeyIn
20510 66 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 fo,
20520 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
20530 72 67 20 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 rg to xCompare()
20540 20 2a 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a */. BtCursor *
20550 70 43 75 72 20 20 20 20 20 20 20 20 20 20 20 20 pCur
20560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20570 20 20 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 63 /* Write new c
20580 75 72 73 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b ursor here */.){
20590 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c . int rc;. sql
205a0 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
205b0 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 43 );. rc = btreeC
205c0 75 72 73 6f 72 28 70 2c 20 69 54 61 62 6c 65 2c ursor(p, iTable,
205d0 20 77 72 46 6c 61 67 2c 20 70 4b 65 79 49 6e 66 wrFlag, pKeyInf
205e0 6f 2c 20 70 43 75 72 29 3b 0a 20 20 73 71 6c 69 o, pCur);. sqli
205f0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
20600 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
20610 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
20620 68 65 20 73 69 7a 65 20 6f 66 20 61 20 42 74 43 he size of a BtC
20630 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 ursor object in
20640 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 bytes..**.** Thi
20650 73 20 69 6e 74 65 72 66 61 63 65 73 20 69 73 20 s interfaces is
20660 6e 65 65 64 65 64 20 73 6f 20 74 68 61 74 20 75 needed so that u
20670 73 65 72 73 20 6f 66 20 63 75 72 73 6f 72 73 20 sers of cursors
20680 63 61 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a can preallocate.
20690 2a 2a 20 73 75 66 66 69 63 69 65 6e 74 20 73 74 ** sufficient st
206a0 6f 72 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 orage to hold a
206b0 63 75 72 73 6f 72 2e 20 20 54 68 65 20 42 74 43 cursor. The BtC
206c0 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 ursor object is
206d0 6f 70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 opaque.** to use
206e0 72 73 20 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f rs so they canno
206f0 74 20 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 t do the sizeof(
20700 29 20 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 ) themselves - t
20710 68 65 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a hey must call.**
20720 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a this routine..*
20730 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
20740 65 65 43 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 eeCursorSize(voi
20750 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 d){. return ROU
20760 4e 44 38 28 73 69 7a 65 6f 66 28 42 74 43 75 72 ND8(sizeof(BtCur
20770 73 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 sor));.}../*.**
20780 49 6e 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 Initialize memor
20790 79 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 63 y that will be c
207a0 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 onverted into a
207b0 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e BtCursor object.
207c0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c .**.** The simpl
207d0 65 20 61 70 70 72 6f 61 63 68 20 68 65 72 65 20 e approach here
207e0 77 6f 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 would be to mems
207f0 65 74 28 29 20 74 68 65 20 65 6e 74 69 72 65 20 et() the entire
20800 6f 62 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 object.** to zer
20810 6f 2e 20 20 42 75 74 20 69 74 20 74 75 72 6e 73 o. But it turns
20820 20 6f 75 74 20 74 68 61 74 20 74 68 65 20 61 70 out that the ap
20830 50 61 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 Page[] and aiIdx
20840 5b 5d 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 [] arrays.** do
20850 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 7a not need to be z
20860 65 72 6f 65 64 20 61 6e 64 20 74 68 65 79 20 61 eroed and they a
20870 72 65 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 re large, so we
20880 63 61 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a can save a lot.*
20890 2a 20 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 * of run-time by
208a0 20 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 6e skipping the in
208b0 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 itialization of
208c0 74 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a those elements..
208d0 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 */.void sqlite3B
208e0 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 treeCursorZero(B
208f0 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d tCursor *p){. m
20900 65 6d 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 emset(p, 0, offs
20910 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 69 etof(BtCursor, i
20920 50 61 67 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Page));.}../*.**
20930 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 2e Close a cursor.
20940 20 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 The read lock
20950 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
20960 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 64 file is released
20970 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 .** when the las
20980 74 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 t cursor is clos
20990 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
209a0 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 e3BtreeCloseCurs
209b0 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 or(BtCursor *pCu
209c0 72 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 r){. Btree *pBt
209d0 72 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 ree = pCur->pBtr
209e0 65 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 ee;. if( pBtree
209f0 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
20a00 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 BtShared *pBt
20a10 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 20 = pCur->pBt;.
20a20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
20a30 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 ter(pBtree);.
20a40 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 sqlite3BtreeCle
20a50 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a arCursor(pCur);.
20a60 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 70 50 if( pCur->pP
20a70 72 65 76 20 29 7b 0a 20 20 20 20 20 20 70 43 75 rev ){. pCu
20a80 72 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 r->pPrev->pNext
20a90 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 = pCur->pNext;.
20aa0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
20ab0 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 3d 20 70 pBt->pCursor = p
20ac0 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 Cur->pNext;.
20ad0 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e }. if( pCur->
20ae0 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 70 pNext ){. p
20af0 43 75 72 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 Cur->pNext->pPre
20b00 76 20 3d 20 70 43 75 72 2d 3e 70 50 72 65 76 3b v = pCur->pPrev;
20b10 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 . }. for(i
20b20 3d 30 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 =0; i<=pCur->iPa
20b30 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ge; i++){.
20b40 72 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 releasePage(pCur
20b50 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 ->apPage[i]);.
20b60 20 20 7d 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 74 }. unlockBt
20b70 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 29 reeIfUnused(pBt)
20b80 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 ;. sqlite3DbF
20b90 72 65 65 28 70 42 74 72 65 65 2d 3e 64 62 2c 20 ree(pBtree->db,
20ba0 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 pCur->aOverflow)
20bb0 3b 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 ;. /* sqlite3
20bc0 5f 66 72 65 65 28 70 43 75 72 29 3b 20 2a 2f 0a _free(pCur); */.
20bd0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
20be0 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a 20 Leave(pBtree);.
20bf0 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
20c00 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
20c10 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 42 74 Make sure the Bt
20c20 43 75 72 73 6f 72 2a 20 67 69 76 65 6e 20 69 6e Cursor* given in
20c30 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 68 61 the argument ha
20c40 73 20 61 20 76 61 6c 69 64 0a 2a 2a 20 42 74 43 s a valid.** BtC
20c50 75 72 73 6f 72 2e 69 6e 66 6f 20 73 74 72 75 63 ursor.info struc
20c60 74 75 72 65 2e 20 20 49 66 20 69 74 20 69 73 20 ture. If it is
20c70 6e 6f 74 20 61 6c 72 65 61 64 79 20 76 61 6c 69 not already vali
20c80 64 2c 20 63 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 d, call.** btree
20c90 50 61 72 73 65 43 65 6c 6c 28 29 20 74 6f 20 66 ParseCell() to f
20ca0 69 6c 6c 20 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a ill it in..**.**
20cb0 20 42 74 43 75 72 73 6f 72 2e 69 6e 66 6f 20 69 BtCursor.info i
20cc0 73 20 61 20 63 61 63 68 65 20 6f 66 20 74 68 65 s a cache of the
20cd0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 information in
20ce0 74 68 65 20 63 75 72 72 65 6e 74 20 63 65 6c 6c the current cell
20cf0 2e 0a 2a 2a 20 55 73 69 6e 67 20 74 68 69 73 20 ..** Using this
20d00 63 61 63 68 65 20 72 65 64 75 63 65 73 20 74 68 cache reduces th
20d10 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c e number of call
20d20 73 20 74 6f 20 62 74 72 65 65 50 61 72 73 65 43 s to btreeParseC
20d30 65 6c 6c 28 29 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 ell()..**.** 200
20d40 37 2d 30 36 2d 32 35 3a 20 20 54 68 65 72 65 20 7-06-25: There
20d50 69 73 20 61 20 62 75 67 20 69 6e 20 73 6f 6d 65 is a bug in some
20d60 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 4d 53 56 versions of MSV
20d70 43 20 74 68 61 74 20 63 61 75 73 65 20 74 68 65 C that cause the
20d80 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 .** compiler to
20d90 63 72 61 73 68 20 77 68 65 6e 20 67 65 74 43 65 crash when getCe
20da0 6c 6c 49 6e 66 6f 28 29 20 69 73 20 69 6d 70 6c llInfo() is impl
20db0 65 6d 65 6e 74 65 64 20 61 73 20 61 20 6d 61 63 emented as a mac
20dc0 72 6f 2e 0a 2a 2a 20 42 75 74 20 74 68 65 72 65 ro..** But there
20dd0 20 69 73 20 61 20 6d 65 61 73 75 72 65 61 62 6c is a measureabl
20de0 65 20 73 70 65 65 64 20 61 64 76 61 6e 74 61 67 e speed advantag
20df0 65 20 74 6f 20 75 73 69 6e 67 20 74 68 65 20 6d e to using the m
20e00 61 63 72 6f 20 6f 6e 20 67 63 63 0a 2a 2a 20 28 acro on gcc.** (
20e10 77 68 65 6e 20 6c 65 73 73 20 63 6f 6d 70 69 6c when less compil
20e20 65 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 er optimizations
20e30 20 6c 69 6b 65 20 2d 4f 73 20 6f 72 20 2d 4f 30 like -Os or -O0
20e40 20 61 72 65 20 75 73 65 64 20 61 6e 64 20 74 68 are used and th
20e50 65 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 20 69 73 e.** compiler is
20e60 20 6e 6f 74 20 64 6f 69 6e 67 20 61 67 67 72 65 not doing aggre
20e70 73 73 69 76 65 20 69 6e 6c 69 6e 69 6e 67 2e 29 ssive inlining.)
20e80 20 20 53 6f 20 77 65 20 75 73 65 20 61 20 72 65 So we use a re
20e90 61 6c 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 66 al function.** f
20ea0 6f 72 20 4d 53 56 43 20 61 6e 64 20 61 20 6d 61 or MSVC and a ma
20eb0 63 72 6f 20 66 6f 72 20 65 76 65 72 79 74 68 69 cro for everythi
20ec0 6e 67 20 65 6c 73 65 2e 20 20 54 69 63 6b 65 74 ng else. Ticket
20ed0 20 23 32 34 35 37 2e 0a 2a 2f 0a 23 69 66 6e 64 #2457..*/.#ifnd
20ee0 65 66 20 4e 44 45 42 55 47 0a 20 20 73 74 61 74 ef NDEBUG. stat
20ef0 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 43 65 ic void assertCe
20f00 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f 72 20 llInfo(BtCursor
20f10 2a 70 43 75 72 29 7b 0a 20 20 20 20 43 65 6c 6c *pCur){. Cell
20f20 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 69 Info info;. i
20f30 6e 74 20 69 50 61 67 65 20 3d 20 70 43 75 72 2d nt iPage = pCur-
20f40 3e 69 50 61 67 65 3b 0a 20 20 20 20 6d 65 6d 73 >iPage;. mems
20f50 65 74 28 26 69 6e 66 6f 2c 20 30 2c 20 73 69 7a et(&info, 0, siz
20f60 65 6f 66 28 69 6e 66 6f 29 29 3b 0a 20 20 20 20 eof(info));.
20f70 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 btreeParseCell(p
20f80 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 Cur->apPage[iPag
20f90 65 5d 2c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b e], pCur->aiIdx[
20fa0 69 50 61 67 65 5d 2c 20 26 69 6e 66 6f 29 3b 0a iPage], &info);.
20fb0 20 20 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 assert( CORR
20fc0 55 50 54 5f 44 42 20 7c 7c 20 6d 65 6d 63 6d 70 UPT_DB || memcmp
20fd0 28 26 69 6e 66 6f 2c 20 26 70 43 75 72 2d 3e 69 (&info, &pCur->i
20fe0 6e 66 6f 2c 20 73 69 7a 65 6f 66 28 69 6e 66 6f nfo, sizeof(info
20ff0 29 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 6c ))==0 );. }.#el
21000 73 65 0a 20 20 23 64 65 66 69 6e 65 20 61 73 73 se. #define ass
21010 65 72 74 43 65 6c 6c 49 6e 66 6f 28 78 29 0a 23 ertCellInfo(x).#
21020 65 6e 64 69 66 0a 23 69 66 64 65 66 20 5f 4d 53 endif.#ifdef _MS
21030 43 5f 56 45 52 0a 20 20 2f 2a 20 55 73 65 20 61 C_VER. /* Use a
21040 20 72 65 61 6c 20 66 75 6e 63 74 69 6f 6e 20 69 real function i
21050 6e 20 4d 53 56 43 20 74 6f 20 77 6f 72 6b 20 61 n MSVC to work a
21060 72 6f 75 6e 64 20 62 75 67 73 20 69 6e 20 74 68 round bugs in th
21070 61 74 20 63 6f 6d 70 69 6c 65 72 2e 20 2a 2f 0a at compiler. */.
21080 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 67 65 static void ge
21090 74 43 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 tCellInfo(BtCurs
210a0 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 20 20 69 or *pCur){. i
210b0 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 f( pCur->info.nS
210c0 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ize==0 ){.
210d0 69 6e 74 20 69 50 61 67 65 20 3d 20 70 43 75 72 int iPage = pCur
210e0 2d 3e 69 50 61 67 65 3b 0a 20 20 20 20 20 20 62 ->iPage;. b
210f0 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 treeParseCell(pC
21100 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 ur->apPage[iPage
21110 5d 2c 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 ],pCur->aiIdx[iP
21120 61 67 65 5d 2c 26 70 43 75 72 2d 3e 69 6e 66 6f age],&pCur->info
21130 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 63 );. pCur->c
21140 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f urFlags |= BTCF_
21150 56 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 20 20 7d ValidNKey;. }
21160 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 else{. asse
21170 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 rtCellInfo(pCur)
21180 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 ;. }. }.#els
21190 65 20 2f 2a 20 69 66 20 6e 6f 74 20 5f 4d 53 43 e /* if not _MSC
211a0 5f 56 45 52 20 2a 2f 0a 20 20 2f 2a 20 55 73 65 _VER */. /* Use
211b0 20 61 20 6d 61 63 72 6f 20 69 6e 20 61 6c 6c 20 a macro in all
211c0 6f 74 68 65 72 20 63 6f 6d 70 69 6c 65 72 73 20 other compilers
211d0 73 6f 20 74 68 61 74 20 74 68 65 20 66 75 6e 63 so that the func
211e0 74 69 6f 6e 20 69 73 20 69 6e 6c 69 6e 65 64 20 tion is inlined
211f0 2a 2f 0a 23 64 65 66 69 6e 65 20 67 65 74 43 65 */.#define getCe
21200 6c 6c 49 6e 66 6f 28 70 43 75 72 29 20 20 20 20 llInfo(pCur)
21210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21240 20 20 5c 0a 20 20 69 66 28 20 70 43 75 72 2d 3e \. if( pCur->
21250 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b info.nSize==0 ){
21260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21280 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21290 20 20 20 5c 0a 20 20 20 20 69 6e 74 20 69 50 61 \. int iPa
212a0 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 67 65 ge = pCur->iPage
212b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
212c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
212d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
212e0 20 20 20 20 5c 0a 20 20 20 20 62 74 72 65 65 50 \. btreeP
212f0 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 arseCell(pCur->a
21300 70 50 61 67 65 5b 69 50 61 67 65 5d 2c 70 43 75 pPage[iPage],pCu
21310 72 2d 3e 61 69 49 64 78 5b 69 50 61 67 65 5d 2c r->aiIdx[iPage],
21320 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 20 20 20 &pCur->info);
21330 20 20 20 20 20 5c 0a 20 20 20 20 70 43 75 72 2d \. pCur-
21340 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 >curFlags |= BTC
21350 46 5f 56 61 6c 69 64 4e 4b 65 79 3b 20 20 20 20 F_ValidNKey;
21360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21380 20 20 20 20 20 20 5c 0a 20 20 7d 65 6c 73 65 7b \. }else{
21390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
213a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
213b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
213c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
213d0 20 20 20 20 20 20 20 5c 0a 20 20 20 20 61 73 73 \. ass
213e0 65 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 ertCellInfo(pCur
213f0 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 );
21400 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21420 20 20 20 20 20 20 20 20 5c 0a 20 20 7d 0a 23 65 \. }.#e
21430 6e 64 69 66 20 2f 2a 20 5f 4d 53 43 5f 56 45 52 ndif /* _MSC_VER
21440 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 */..#ifndef NDE
21450 42 55 47 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 BUG /* The next
21460 20 72 6f 75 74 69 6e 65 20 75 73 65 64 20 6f 6e routine used on
21470 6c 79 20 77 69 74 68 69 6e 20 61 73 73 65 72 74 ly within assert
21480 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f () statements */
21490 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 ./*.** Return tr
214a0 75 65 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 ue if the given
214b0 42 74 43 75 72 73 6f 72 20 69 73 20 76 61 6c 69 BtCursor is vali
214c0 64 2e 20 20 41 20 76 61 6c 69 64 20 63 75 72 73 d. A valid curs
214d0 6f 72 20 69 73 20 6f 6e 65 0a 2a 2a 20 74 68 61 or is one.** tha
214e0 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 70 t is currently p
214f0 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 72 6f 77 ointing to a row
21500 20 69 6e 20 61 20 28 6e 6f 6e 2d 65 6d 70 74 79 in a (non-empty
21510 29 20 74 61 62 6c 65 2e 0a 2a 2a 20 54 68 69 73 ) table..** This
21520 20 69 73 20 61 20 76 65 72 69 66 69 63 61 74 69 is a verificati
21530 6f 6e 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 on routine is us
21540 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 ed only within a
21550 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
21560 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ts..*/.int sqlit
21570 65 33 42 74 72 65 65 43 75 72 73 6f 72 49 73 56 e3BtreeCursorIsV
21580 61 6c 69 64 28 42 74 43 75 72 73 6f 72 20 2a 70 alid(BtCursor *p
21590 43 75 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 Cur){. return p
215a0 43 75 72 20 26 26 20 70 43 75 72 2d 3e 65 53 74 Cur && pCur->eSt
215b0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
215c0 44 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 4e D;.}.#endif /* N
215d0 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 DEBUG */../*.**
215e0 53 65 74 20 2a 70 53 69 7a 65 20 74 6f 20 74 68 Set *pSize to th
215f0 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 75 e size of the bu
21600 66 66 65 72 20 6e 65 65 64 65 64 20 74 6f 20 68 ffer needed to h
21610 6f 6c 64 20 74 68 65 20 76 61 6c 75 65 20 6f 66 old the value of
21620 0a 2a 2a 20 74 68 65 20 6b 65 79 20 66 6f 72 20 .** the key for
21630 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e 74 72 the current entr
21640 79 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 6f y. If the curso
21650 72 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 69 6e r is not pointin
21660 67 0a 2a 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 g.** to a valid
21670 65 6e 74 72 79 2c 20 2a 70 53 69 7a 65 20 69 73 entry, *pSize is
21680 20 73 65 74 20 74 6f 20 30 2e 20 0a 2a 2a 0a 2a set to 0. .**.*
21690 2a 20 46 6f 72 20 61 20 74 61 62 6c 65 20 77 69 * For a table wi
216a0 74 68 20 74 68 65 20 49 4e 54 4b 45 59 20 66 6c th the INTKEY fl
216b0 61 67 20 73 65 74 2c 20 74 68 69 73 20 72 6f 75 ag set, this rou
216c0 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65 tine returns the
216d0 20 6b 65 79 0a 2a 2a 20 69 74 73 65 6c 66 2c 20 key.** itself,
216e0 6e 6f 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f not the number o
216f0 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 6b f bytes in the k
21700 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 ey..**.** The ca
21710 6c 6c 65 72 20 6d 75 73 74 20 70 6f 73 69 74 69 ller must positi
21720 6f 6e 20 74 68 65 20 63 75 72 73 6f 72 20 70 72 on the cursor pr
21730 69 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 ior to invoking
21740 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a this routine..**
21750 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e .** This routin
21760 65 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 20 20 e cannot fail.
21770 49 74 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e It always return
21780 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 20 0a 2a s SQLITE_OK. .*
21790 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
217a0 65 65 4b 65 79 53 69 7a 65 28 42 74 43 75 72 73 eeKeySize(BtCurs
217b0 6f 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a 70 or *pCur, i64 *p
217c0 53 69 7a 65 29 7b 0a 20 20 61 73 73 65 72 74 28 Size){. assert(
217d0 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
217e0 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 x(pCur) );. ass
217f0 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
21800 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
21810 29 3b 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f );. getCellInfo
21820 28 70 43 75 72 29 3b 0a 20 20 2a 70 53 69 7a 65 (pCur);. *pSize
21830 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b = pCur->info.nK
21840 65 79 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ey;. return SQL
21850 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
21860 20 53 65 74 20 2a 70 53 69 7a 65 20 74 6f 20 74 Set *pSize to t
21870 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
21880 65 73 20 6f 66 20 64 61 74 61 20 69 6e 20 74 68 es of data in th
21890 65 20 65 6e 74 72 79 20 74 68 65 0a 2a 2a 20 63 e entry the.** c
218a0 75 72 73 6f 72 20 63 75 72 72 65 6e 74 6c 79 20 ursor currently
218b0 70 6f 69 6e 74 73 20 74 6f 2e 0a 2a 2a 0a 2a 2a points to..**.**
218c0 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 The caller must
218d0 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 20 guarantee that
218e0 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 70 6f the cursor is po
218f0 69 6e 74 69 6e 67 20 74 6f 20 61 20 6e 6f 6e 2d inting to a non-
21900 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 64 20 65 6e NULL.** valid en
21910 74 72 79 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 try. In other w
21920 6f 72 64 73 2c 20 74 68 65 20 63 61 6c 6c 69 6e ords, the callin
21930 67 20 70 72 6f 63 65 64 75 72 65 20 6d 75 73 74 g procedure must
21940 20 67 75 61 72 61 6e 74 65 65 0a 2a 2a 20 74 68 guarantee.** th
21950 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 68 61 at the cursor ha
21960 73 20 43 75 72 73 6f 72 2e 65 53 74 61 74 65 3d s Cursor.eState=
21970 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e 0a 2a =CURSOR_VALID..*
21980 2a 0a 2a 2a 20 46 61 69 6c 75 72 65 20 69 73 20 *.** Failure is
21990 6e 6f 74 20 70 6f 73 73 69 62 6c 65 2e 20 20 54 not possible. T
219a0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 6c 77 his function alw
219b0 61 79 73 20 72 65 74 75 72 6e 73 20 53 51 4c 49 ays returns SQLI
219c0 54 45 5f 4f 4b 2e 0a 2a 2a 20 49 74 20 6d 69 67 TE_OK..** It mig
219d0 68 74 20 6a 75 73 74 20 61 73 20 77 65 6c 6c 20 ht just as well
219e0 62 65 20 61 20 70 72 6f 63 65 64 75 72 65 20 28 be a procedure (
219f0 72 65 74 75 72 6e 69 6e 67 20 76 6f 69 64 29 20 returning void)
21a00 62 75 74 20 77 65 20 63 6f 6e 74 69 6e 75 65 0a but we continue.
21a10 2a 2a 20 74 6f 20 72 65 74 75 72 6e 20 61 6e 20 ** to return an
21a20 69 6e 74 65 67 65 72 20 72 65 73 75 6c 74 20 63 integer result c
21a30 6f 64 65 20 66 6f 72 20 68 69 73 74 6f 72 69 63 ode for historic
21a40 61 6c 20 72 65 61 73 6f 6e 73 2e 0a 2a 2f 0a 69 al reasons..*/.i
21a50 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 nt sqlite3BtreeD
21a60 61 74 61 53 69 7a 65 28 42 74 43 75 72 73 6f 72 ataSize(BtCursor
21a70 20 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 53 69 *pCur, u32 *pSi
21a80 7a 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 ze){. assert( c
21a90 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
21aa0 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
21ab0 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
21ac0 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
21ad0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
21ae0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
21af0 61 67 65 5d 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 age]->intKeyLeaf
21b00 3d 3d 31 20 29 3b 0a 20 20 67 65 74 43 65 6c 6c ==1 );. getCell
21b10 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 2a 70 Info(pCur);. *p
21b20 53 69 7a 65 20 3d 20 70 43 75 72 2d 3e 69 6e 66 Size = pCur->inf
21b30 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 72 65 o.nPayload;. re
21b40 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
21b50 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 }../*.** Given t
21b60 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
21b70 66 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 f an overflow pa
21b80 67 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 ge in the databa
21b90 73 65 20 28 70 61 72 61 6d 65 74 65 72 0a 2a 2a se (parameter.**
21ba0 20 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 75 6e ovfl), this fun
21bb0 63 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 65 20 ction finds the
21bc0 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 page number of t
21bd0 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
21be0 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 6c the .** linked l
21bf0 69 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 ist of overflow
21c00 70 61 67 65 73 2e 20 49 66 20 70 6f 73 73 69 62 pages. If possib
21c10 6c 65 2c 20 69 74 20 75 73 65 73 20 74 68 65 20 le, it uses the
21c20 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 70 auto-vacuum.** p
21c30 6f 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 61 20 ointer-map data
21c40 69 6e 73 74 65 61 64 20 6f 66 20 72 65 61 64 69 instead of readi
21c50 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f ng the content o
21c60 66 20 70 61 67 65 20 6f 76 66 6c 20 74 6f 20 64 f page ovfl to d
21c70 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 o so. .**.** If
21c80 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 an error occurs
21c90 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
21ca0 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
21cb0 2e 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a 2a 0a . Otherwise:.**.
21cc0 2a 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 ** The page numb
21cd0 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 6f er of the next o
21ce0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 verflow page in
21cf0 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 the linked list
21d00 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 is .** written t
21d10 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 49 66 o *pPgnoNext. If
21d20 20 70 61 67 65 20 6f 76 66 6c 20 69 73 20 74 68 page ovfl is th
21d30 65 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 69 e last page in i
21d40 74 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c 69 ts linked .** li
21d50 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 20 69 st, *pPgnoNext i
21d60 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 0a s set to zero. .
21d70 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 65 20 **.** If ppPage
21d80 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e 64 is not NULL, and
21d90 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
21da0 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 the MemPage obje
21db0 63 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 ct corresponding
21dc0 0a 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 .** to page numb
21dd0 65 72 20 70 4f 76 66 6c 20 77 61 73 20 6f 62 74 er pOvfl was obt
21de0 61 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 70 50 ained, then *ppP
21df0 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 70 6f age is set to po
21e00 69 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a 20 72 int to that.** r
21e10 65 66 65 72 65 6e 63 65 2e 20 49 74 20 69 73 20 eference. It is
21e20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
21e30 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 ty of the caller
21e40 20 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 73 65 to call release
21e50 50 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 70 Page().** on *pp
21e60 50 61 67 65 20 74 6f 20 66 72 65 65 20 74 68 65 Page to free the
21e70 20 72 65 66 65 72 65 6e 63 65 2e 20 49 6e 20 6e reference. In n
21e80 6f 20 72 65 66 65 72 65 6e 63 65 20 77 61 73 20 o reference was
21e90 6f 62 74 61 69 6e 65 64 20 28 62 65 63 61 75 73 obtained (becaus
21ea0 65 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 e.** the pointer
21eb0 2d 6d 61 70 20 77 61 73 20 75 73 65 64 20 74 6f -map was used to
21ec0 20 6f 62 74 61 69 6e 20 74 68 65 20 76 61 6c 75 obtain the valu
21ed0 65 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 74 e for *pPgnoNext
21ee0 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 61 ), then.** *ppPa
21ef0 67 65 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 ge is set to zer
21f00 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 o..*/.static int
21f10 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
21f20 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
21f30 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
21f40 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
21f50 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
21f60 6f 76 66 6c 2c 20 20 20 20 20 20 20 20 20 20 20 ovfl,
21f70 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 /* Curre
21f80 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 nt overflow page
21f90 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 6d number */. Mem
21fa0 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 Page **ppPage,
21fb0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
21fc0 3a 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 6c 65 : MemPage handle
21fd0 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a (may be NULL) *
21fe0 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 4e /. Pgno *pPgnoN
21ff0 65 78 74 20 20 20 20 20 20 20 20 20 20 20 20 20 ext
22000 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 6f 76 /* OUT: Next ov
22010 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 erflow page numb
22020 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f 20 er */.){. Pgno
22030 6e 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 next = 0;. MemP
22040 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a age *pPage = 0;.
22050 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
22060 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 E_OK;.. assert(
22070 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
22080 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
22090 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 67 6e );. assert(pPgn
220a0 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 65 66 oNext);..#ifndef
220b0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
220c0 4f 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 72 79 OVACUUM. /* Try
220d0 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 65 78 to find the nex
220e0 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 6f 76 t page in the ov
220f0 65 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 69 6e erflow list usin
22100 67 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 6f 76 g the. ** autov
22110 61 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 acuum pointer-ma
22120 70 20 70 61 67 65 73 2e 20 47 75 65 73 73 20 74 p pages. Guess t
22130 68 61 74 20 74 68 65 20 6e 65 78 74 20 70 61 67 hat the next pag
22140 65 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 20 6f e in . ** the o
22150 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 73 20 verflow list is
22160 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6f 76 66 page number (ovf
22170 6c 2b 31 29 2e 20 49 66 20 74 68 61 74 20 67 75 l+1). If that gu
22180 65 73 73 20 74 75 72 6e 73 20 0a 20 20 2a 2a 20 ess turns . **
22190 6f 75 74 20 74 6f 20 62 65 20 77 72 6f 6e 67 2c out to be wrong,
221a0 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 6c 6f fall back to lo
221b0 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 20 6f ading the data o
221c0 66 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e 75 6d f page . ** num
221d0 62 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 74 65 ber ovfl to dete
221e0 72 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 20 70 rmine the next p
221f0 61 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 2a 2f age number.. */
22200 0a 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f . if( pBt->auto
22210 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 Vacuum ){. Pg
22220 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 67 6e no pgno;. Pgn
22230 6f 20 69 47 75 65 73 73 20 3d 20 6f 76 66 6c 2b o iGuess = ovfl+
22240 31 3b 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 1;. u8 eType;
22250 0a 0a 20 20 20 20 77 68 69 6c 65 28 20 50 54 52 .. while( PTR
22260 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
22270 69 47 75 65 73 73 29 20 7c 7c 20 69 47 75 65 73 iGuess) || iGues
22280 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f s==PENDING_BYTE_
22290 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
222a0 20 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 20 20 iGuess++;.
222b0 20 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 75 65 }.. if( iGue
222c0 73 73 3c 3d 62 74 72 65 65 50 61 67 65 63 6f 75 ss<=btreePagecou
222d0 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 nt(pBt) ){.
222e0 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 rc = ptrmapGet(
222f0 70 42 74 2c 20 69 47 75 65 73 73 2c 20 26 65 54 pBt, iGuess, &eT
22300 79 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 20 ype, &pgno);.
22310 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
22320 45 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d 3d 50 E_OK && eType==P
22330 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 TRMAP_OVERFLOW2
22340 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 7b && pgno==ovfl ){
22350 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 3d 20 . next =
22360 69 47 75 65 73 73 3b 0a 20 20 20 20 20 20 20 20 iGuess;.
22370 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
22380 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
22390 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 }.#endif.. as
223a0 73 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 7c 7c sert( next==0 ||
223b0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 rc==SQLITE_DONE
223c0 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );. if( rc==SQ
223d0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
223e0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
223f0 28 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 50 61 (pBt, ovfl, &pPa
22400 67 65 2c 20 28 70 70 50 61 67 65 3d 3d 30 29 20 ge, (ppPage==0)
22410 3f 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 ? PAGER_GET_READ
22420 4f 4e 4c 59 20 3a 20 30 29 3b 0a 20 20 20 20 61 ONLY : 0);. a
22430 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
22440 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 3d 3d 30 E_OK || pPage==0
22450 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d );. if( rc==
22460 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
22470 20 20 20 6e 65 78 74 20 3d 20 67 65 74 34 62 79 next = get4by
22480 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 te(pPage->aData)
22490 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a ;. }. }.. *
224a0 70 50 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 78 74 pPgnoNext = next
224b0 3b 0a 20 20 69 66 28 20 70 70 50 61 67 65 20 29 ;. if( ppPage )
224c0 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 {. *ppPage =
224d0 70 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a pPage;. }else{.
224e0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
224f0 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 72 65 pPage);. }. re
22500 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 turn (rc==SQLITE
22510 5f 44 4f 4e 45 20 3f 20 53 51 4c 49 54 45 5f 4f _DONE ? SQLITE_O
22520 4b 20 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a K : rc);.}../*.*
22530 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d * Copy data from
22540 20 61 20 62 75 66 66 65 72 20 74 6f 20 61 20 70 a buffer to a p
22550 61 67 65 2c 20 6f 72 20 66 72 6f 6d 20 61 20 70 age, or from a p
22560 61 67 65 20 74 6f 20 61 20 62 75 66 66 65 72 2e age to a buffer.
22570 0a 2a 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 64 20 .**.** pPayload
22580 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
22590 64 61 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 64 data stored on d
225a0 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
225b0 50 61 67 65 2e 0a 2a 2a 20 49 66 20 61 72 67 75 Page..** If argu
225c0 6d 65 6e 74 20 65 4f 70 20 69 73 20 66 61 6c 73 ment eOp is fals
225d0 65 2c 20 74 68 65 6e 20 6e 42 79 74 65 20 62 79 e, then nByte by
225e0 74 65 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 tes of data are
225f0 63 6f 70 69 65 64 0a 2a 2a 20 66 72 6f 6d 20 70 copied.** from p
22600 50 61 79 6c 6f 61 64 20 74 6f 20 74 68 65 20 62 Payload to the b
22610 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 61 74 uffer pointed at
22620 20 62 79 20 70 42 75 66 2e 20 49 66 20 65 4f 70 by pBuf. If eOp
22630 20 69 73 20 74 72 75 65 2c 0a 2a 2a 20 74 68 65 is true,.** the
22640 6e 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 n sqlite3PagerWr
22650 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 ite() is called
22660 6f 6e 20 70 44 62 50 61 67 65 20 61 6e 64 20 6e on pDbPage and n
22670 42 79 74 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 Byte bytes.** of
22680 20 64 61 74 61 20 61 72 65 20 63 6f 70 69 65 64 data are copied
22690 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
226a0 20 70 42 75 66 20 74 6f 20 70 50 61 79 6c 6f 61 pBuf to pPayloa
226b0 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f d..**.** SQLITE_
226c0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f OK is returned o
226d0 6e 20 73 75 63 63 65 73 73 2c 20 6f 74 68 65 72 n success, other
226e0 77 69 73 65 20 61 6e 20 65 72 72 6f 72 20 63 6f wise an error co
226f0 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e de..*/.static in
22700 74 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 0a 20 t copyPayload(.
22710 20 76 6f 69 64 20 2a 70 50 61 79 6c 6f 61 64 2c void *pPayload,
22720 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
22730 69 6e 74 65 72 20 74 6f 20 70 61 67 65 20 64 61 inter to page da
22740 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 ta */. void *pB
22750 75 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 uf,
22760 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
22770 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 buffer */. int
22780 6e 42 79 74 65 2c 20 20 20 20 20 20 20 20 20 20 nByte,
22790 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
227a0 6f 66 20 62 79 74 65 73 20 74 6f 20 63 6f 70 79 of bytes to copy
227b0 20 2a 2f 0a 20 20 69 6e 74 20 65 4f 70 2c 20 20 */. int eOp,
227c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
227d0 2f 2a 20 30 20 2d 3e 20 63 6f 70 79 20 66 72 6f /* 0 -> copy fro
227e0 6d 20 70 61 67 65 2c 20 31 20 2d 3e 20 63 6f 70 m page, 1 -> cop
227f0 79 20 74 6f 20 70 61 67 65 20 2a 2f 0a 20 20 44 y to page */. D
22800 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 20 20 bPage *pDbPage
22810 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
22820 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 50 61 79 containing pPay
22830 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 load */.){. if(
22840 20 65 4f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 43 eOp ){. /* C
22850 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 62 75 opy data from bu
22860 66 66 65 72 20 74 6f 20 70 61 67 65 20 28 61 20 ffer to page (a
22870 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 29 write operation)
22880 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d */. int rc =
22890 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
228a0 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
228b0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
228c0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 OK ){. retu
228d0 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
228e0 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 memcpy(pPayload
228f0 2c 20 70 42 75 66 2c 20 6e 42 79 74 65 29 3b 0a , pBuf, nByte);.
22900 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 }else{. /*
22910 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 70 Copy data from p
22920 61 67 65 20 74 6f 20 62 75 66 66 65 72 20 28 61 age to buffer (a
22930 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 29 read operation)
22940 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 */. memcpy(p
22950 42 75 66 2c 20 70 50 61 79 6c 6f 61 64 2c 20 6e Buf, pPayload, n
22960 42 79 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 Byte);. }. ret
22970 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
22980 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
22990 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
229a0 20 72 65 61 64 20 6f 72 20 6f 76 65 72 77 72 69 read or overwri
229b0 74 65 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 te payload infor
229c0 6d 61 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 74 68 mation.** for th
229d0 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 e entry that the
229e0 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 20 pCur cursor is
229f0 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 54 68 65 pointing to. The
22a00 20 65 4f 70 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 eOp.** argument
22a10 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 is interpreted
22a20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a as follows:.**.*
22a30 2a 20 20 20 30 3a 20 54 68 65 20 6f 70 65 72 61 * 0: The opera
22a40 74 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e 20 tion is a read.
22a50 50 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 Populate the ove
22a60 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 rflow cache..**
22a70 20 20 31 3a 20 54 68 65 20 6f 70 65 72 61 74 69 1: The operati
22a80 6f 6e 20 69 73 20 61 20 77 72 69 74 65 2e 20 50 on is a write. P
22a90 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 opulate the over
22aa0 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 20 flow cache..**
22ab0 20 32 3a 20 54 68 65 20 6f 70 65 72 61 74 69 6f 2: The operatio
22ac0 6e 20 69 73 20 61 20 72 65 61 64 2e 20 44 6f 20 n is a read. Do
22ad0 6e 6f 74 20 70 6f 70 75 6c 61 74 65 20 74 68 65 not populate the
22ae0 20 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 65 2e overflow cache.
22af0 0a 2a 2a 0a 2a 2a 20 41 20 74 6f 74 61 6c 20 6f .**.** A total o
22b00 66 20 22 61 6d 74 22 20 62 79 74 65 73 20 61 72 f "amt" bytes ar
22b10 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 e read or writte
22b20 6e 20 62 65 67 69 6e 6e 69 6e 67 20 61 74 20 22 n beginning at "
22b30 6f 66 66 73 65 74 22 2e 0a 2a 2a 20 44 61 74 61 offset"..** Data
22b40 20 69 73 20 72 65 61 64 20 74 6f 20 6f 72 20 66 is read to or f
22b50 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 20 70 rom the buffer p
22b60 42 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 Buf..**.** The c
22b70 6f 6e 74 65 6e 74 20 62 65 69 6e 67 20 72 65 61 ontent being rea
22b80 64 20 6f 72 20 77 72 69 74 74 65 6e 20 6d 69 67 d or written mig
22b90 68 74 20 61 70 70 65 61 72 20 6f 6e 20 74 68 65 ht appear on the
22ba0 20 6d 61 69 6e 20 70 61 67 65 0a 2a 2a 20 6f 72 main page.** or
22bb0 20 62 65 20 73 63 61 74 74 65 72 65 64 20 6f 75 be scattered ou
22bc0 74 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 6f 76 t on multiple ov
22bd0 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 2a 2a erflow pages..**
22be0 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 72 72 65 .** If the curre
22bf0 6e 74 20 63 75 72 73 6f 72 20 65 6e 74 72 79 20 nt cursor entry
22c00 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 uses one or more
22c10 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 overflow pages
22c20 61 6e 64 20 74 68 65 0a 2a 2a 20 65 4f 70 20 61 and the.** eOp a
22c30 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 74 20 32 rgument is not 2
22c40 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 , this function
22c50 6d 61 79 20 61 6c 6c 6f 63 61 74 65 20 73 70 61 may allocate spa
22c60 63 65 20 66 6f 72 20 61 6e 64 20 6c 61 7a 69 6c ce for and lazil
22c70 79 20 0a 2a 2a 20 70 6f 70 75 6c 61 74 65 73 20 y .** populates
22c80 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 the overflow pag
22c90 65 2d 6c 69 73 74 20 63 61 63 68 65 20 61 72 72 e-list cache arr
22ca0 61 79 20 28 42 74 43 75 72 73 6f 72 2e 61 4f 76 ay (BtCursor.aOv
22cb0 65 72 66 6c 6f 77 29 2e 20 0a 2a 2a 20 53 75 62 erflow). .** Sub
22cc0 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 75 73 sequent calls us
22cd0 65 20 74 68 69 73 20 63 61 63 68 65 20 74 6f 20 e this cache to
22ce0 6d 61 6b 65 20 73 65 65 6b 69 6e 67 20 74 6f 20 make seeking to
22cf0 74 68 65 20 73 75 70 70 6c 69 65 64 20 6f 66 66 the supplied off
22d00 73 65 74 20 0a 2a 2a 20 6d 6f 72 65 20 65 66 66 set .** more eff
22d10 69 63 69 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e icient..**.** On
22d20 63 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 ce an overflow p
22d30 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 age-list cache h
22d40 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 as been allocate
22d50 64 2c 20 69 74 20 6d 61 79 20 62 65 0a 2a 2a 20 d, it may be.**
22d60 69 6e 76 61 6c 69 64 61 74 65 64 20 69 66 20 73 invalidated if s
22d70 6f 6d 65 20 6f 74 68 65 72 20 63 75 72 73 6f 72 ome other cursor
22d80 20 77 72 69 74 65 73 20 74 6f 20 74 68 65 20 73 writes to the s
22d90 61 6d 65 20 74 61 62 6c 65 2c 20 6f 72 20 69 66 ame table, or if
22da0 0a 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 20 69 .** the cursor i
22db0 73 20 6d 6f 76 65 64 20 74 6f 20 61 20 64 69 66 s moved to a dif
22dc0 66 65 72 65 6e 74 20 72 6f 77 2e 20 41 64 64 69 ferent row. Addi
22dd0 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e 20 61 75 74 tionally, in aut
22de0 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 6d 6f 64 65 o-vacuum.** mode
22df0 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 , the following
22e00 65 76 65 6e 74 73 20 6d 61 79 20 69 6e 76 61 6c events may inval
22e10 69 64 61 74 65 20 61 6e 20 6f 76 65 72 66 6c 6f idate an overflo
22e20 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 w page-list cach
22e30 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 6e 20 e..**.** * An
22e40 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 incremental vacu
22e50 75 6d 2c 0a 2a 2a 20 20 20 2a 20 41 20 63 6f 6d um,.** * A com
22e60 6d 69 74 20 69 6e 20 61 75 74 6f 5f 76 61 63 75 mit in auto_vacu
22e70 75 6d 3d 22 66 75 6c 6c 22 20 6d 6f 64 65 2c 0a um="full" mode,.
22e80 2a 2a 20 20 20 2a 20 43 72 65 61 74 69 6e 67 20 ** * Creating
22e90 61 20 74 61 62 6c 65 20 28 6d 61 79 20 72 65 71 a table (may req
22ea0 75 69 72 65 20 6d 6f 76 69 6e 67 20 61 6e 20 6f uire moving an o
22eb0 76 65 72 66 6c 6f 77 20 70 61 67 65 29 2e 0a 2a verflow page)..*
22ec0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 63 63 /.static int acc
22ed0 65 73 73 50 61 79 6c 6f 61 64 28 0a 20 20 42 74 essPayload(. Bt
22ee0 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 Cursor *pCur,
22ef0 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 70 6f 69 /* Cursor poi
22f00 6e 74 69 6e 67 20 74 6f 20 65 6e 74 72 79 20 74 nting to entry t
22f10 6f 20 72 65 61 64 20 66 72 6f 6d 20 2a 2f 0a 20 o read from */.
22f20 20 75 33 32 20 6f 66 66 73 65 74 2c 20 20 20 20 u32 offset,
22f30 20 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 72 /* Begin r
22f40 65 61 64 69 6e 67 20 74 68 69 73 20 66 61 72 20 eading this far
22f50 69 6e 74 6f 20 70 61 79 6c 6f 61 64 20 2a 2f 0a into payload */.
22f60 20 20 75 33 32 20 61 6d 74 2c 20 20 20 20 20 20 u32 amt,
22f70 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 74 /* Read t
22f80 68 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 2a his many bytes *
22f90 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
22fa0 72 20 2a 70 42 75 66 2c 20 2f 2a 20 57 72 69 74 r *pBuf, /* Writ
22fb0 65 20 74 68 65 20 62 79 74 65 73 20 69 6e 74 6f e the bytes into
22fc0 20 74 68 69 73 20 62 75 66 66 65 72 20 2a 2f 20 this buffer */
22fd0 0a 20 20 69 6e 74 20 65 4f 70 20 20 20 20 20 20 . int eOp
22fe0 20 20 20 20 20 20 20 20 2f 2a 20 7a 65 72 6f 20 /* zero
22ff0 74 6f 20 72 65 61 64 2e 20 6e 6f 6e 2d 7a 65 72 to read. non-zer
23000 6f 20 74 6f 20 77 72 69 74 65 2e 20 2a 2f 0a 29 o to write. */.)
23010 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 {. unsigned cha
23020 72 20 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 20 69 r *aPayload;. i
23030 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
23040 4b 3b 0a 20 20 69 6e 74 20 69 49 64 78 20 3d 20 K;. int iIdx =
23050 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 0;. MemPage *pP
23060 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
23070 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
23080 20 2f 2a 20 42 74 72 65 65 20 70 61 67 65 20 6f /* Btree page o
23090 66 20 63 75 72 72 65 6e 74 20 65 6e 74 72 79 20 f current entry
230a0 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 */. BtShared *p
230b0 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 20 Bt = pCur->pBt;
230c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
230d0 20 2f 2a 20 42 74 72 65 65 20 74 68 69 73 20 63 /* Btree this c
230e0 75 72 73 6f 72 20 62 65 6c 6f 6e 67 73 20 74 6f ursor belongs to
230f0 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
23100 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f E_DIRECT_OVERFLO
23110 57 5f 52 45 41 44 0a 20 20 75 6e 73 69 67 6e 65 W_READ. unsigne
23120 64 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 20 70 d char * const p
23130 42 75 66 53 74 61 72 74 20 3d 20 70 42 75 66 3b BufStart = pBuf;
23140 0a 20 20 69 6e 74 20 62 45 6e 64 3b 20 20 20 20 . int bEnd;
23150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23160 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23170 54 72 75 65 20 69 66 20 72 65 61 64 69 6e 67 20 True if reading
23180 74 6f 20 65 6e 64 20 6f 66 20 64 61 74 61 20 2a to end of data *
23190 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 /.#endif.. asse
231a0 72 74 28 20 70 50 61 67 65 20 29 3b 0a 20 20 61 rt( pPage );. a
231b0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
231c0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
231d0 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 D );. assert( p
231e0 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
231f0 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e 6e >iPage]<pPage->n
23200 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 Cell );. assert
23210 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
23220 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
23230 73 65 72 74 28 20 65 4f 70 21 3d 32 20 7c 7c 20 sert( eOp!=2 ||
23240 6f 66 66 73 65 74 3d 3d 30 20 29 3b 20 20 20 20 offset==0 );
23250 2f 2a 20 41 6c 77 61 79 73 20 73 74 61 72 74 20 /* Always start
23260 66 72 6f 6d 20 62 65 67 69 6e 6e 69 6e 67 20 66 from beginning f
23270 6f 72 20 65 4f 70 3d 3d 32 20 2a 2f 0a 0a 20 20 or eOp==2 */..
23280 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 getCellInfo(pCur
23290 29 3b 0a 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 );. aPayload =
232a0 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c pCur->info.pPayl
232b0 6f 61 64 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 oad;.#ifdef SQLI
232c0 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c TE_DIRECT_OVERFL
232d0 4f 57 5f 52 45 41 44 0a 20 20 62 45 6e 64 20 3d OW_READ. bEnd =
232e0 20 6f 66 66 73 65 74 2b 61 6d 74 3d 3d 70 43 75 offset+amt==pCu
232f0 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 r->info.nPayload
23300 3b 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 65 72 ;.#endif. asser
23310 74 28 20 6f 66 66 73 65 74 2b 61 6d 74 20 3c 3d t( offset+amt <=
23320 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 pCur->info.nPay
23330 6c 6f 61 64 20 29 3b 0a 0a 20 20 69 66 28 20 26 load );.. if( &
23340 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d 3e 69 aPayload[pCur->i
23350 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 26 70 nfo.nLocal] > &p
23360 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d Page->aData[pBt-
23370 3e 75 73 61 62 6c 65 53 69 7a 65 5d 20 29 7b 0a >usableSize] ){.
23380 20 20 20 20 2f 2a 20 54 72 79 69 6e 67 20 74 6f /* Trying to
23390 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 70 read or write p
233a0 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ast the end of t
233b0 68 65 20 64 61 74 61 20 69 73 20 61 6e 20 65 72 he data is an er
233c0 72 6f 72 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 ror */. retur
233d0 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
233e0 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a _BKPT;. }.. /*
233f0 20 43 68 65 63 6b 20 69 66 20 64 61 74 61 20 6d Check if data m
23400 75 73 74 20 62 65 20 72 65 61 64 2f 77 72 69 74 ust be read/writ
23410 74 65 6e 20 74 6f 2f 66 72 6f 6d 20 74 68 65 20 ten to/from the
23420 62 74 72 65 65 20 70 61 67 65 20 69 74 73 65 6c btree page itsel
23430 66 2e 20 2a 2f 0a 20 20 69 66 28 20 6f 66 66 73 f. */. if( offs
23440 65 74 3c 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c et<pCur->info.nL
23450 6f 63 61 6c 20 29 7b 0a 20 20 20 20 69 6e 74 20 ocal ){. int
23460 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 69 66 28 a = amt;. if(
23470 20 61 2b 6f 66 66 73 65 74 3e 70 43 75 72 2d 3e a+offset>pCur->
23480 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 7b 0a 20 info.nLocal ){.
23490 20 20 20 20 20 61 20 3d 20 70 43 75 72 2d 3e 69 a = pCur->i
234a0 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d 20 6f 66 66 nfo.nLocal - off
234b0 73 65 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 set;. }. r
234c0 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 c = copyPayload(
234d0 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 &aPayload[offset
234e0 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 4f 70 ], pBuf, a, (eOp
234f0 20 26 20 30 78 30 31 29 2c 20 70 50 61 67 65 2d & 0x01), pPage-
23500 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 6f >pDbPage);. o
23510 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 20 70 ffset = 0;. p
23520 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 61 6d Buf += a;. am
23530 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 65 7b t -= a;. }else{
23540 0a 20 20 20 20 6f 66 66 73 65 74 20 2d 3d 20 70 . offset -= p
23550 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c Cur->info.nLocal
23560 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d ;. }.. if( rc=
23570 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d =SQLITE_OK && am
23580 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 t>0 ){. const
23590 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 20 3d 20 u32 ovflSize =
235a0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
235b0 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 73 20 63 - 4; /* Bytes c
235c0 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 66 6c 20 ontent per ovfl
235d0 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 67 6e 6f page */. Pgno
235e0 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 20 20 nextPage;..
235f0 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 62 nextPage = get4b
23600 79 74 65 28 26 61 50 61 79 6c 6f 61 64 5b 70 43 yte(&aPayload[pC
23610 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d ur->info.nLocal]
23620 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 );.. /* If th
23630 65 20 42 74 43 75 72 73 6f 72 2e 61 4f 76 65 72 e BtCursor.aOver
23640 66 6c 6f 77 5b 5d 20 68 61 73 20 6e 6f 74 20 62 flow[] has not b
23650 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 2c 20 61 een allocated, a
23660 6c 6c 6f 63 61 74 65 20 69 74 20 6e 6f 77 2e 0a llocate it now..
23670 20 20 20 20 2a 2a 20 45 78 63 65 70 74 2c 20 64 ** Except, d
23680 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 o not allocate a
23690 4f 76 65 72 66 6c 6f 77 5b 5d 20 66 6f 72 20 65 Overflow[] for e
236a0 4f 70 3d 3d 32 2e 0a 20 20 20 20 2a 2a 0a 20 20 Op==2.. **.
236b0 20 20 2a 2a 20 54 68 65 20 61 4f 76 65 72 66 6c ** The aOverfl
236c0 6f 77 5b 5d 20 61 72 72 61 79 20 69 73 20 73 69 ow[] array is si
236d0 7a 65 64 20 61 74 20 6f 6e 65 20 65 6e 74 72 79 zed at one entry
236e0 20 66 6f 72 20 65 61 63 68 20 6f 76 65 72 66 6c for each overfl
236f0 6f 77 20 70 61 67 65 0a 20 20 20 20 2a 2a 20 69 ow page. ** i
23700 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 n the overflow c
23710 68 61 69 6e 2e 20 54 68 65 20 70 61 67 65 20 6e hain. The page n
23720 75 6d 62 65 72 20 6f 66 20 74 68 65 20 66 69 72 umber of the fir
23730 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 st overflow page
23740 20 69 73 0a 20 20 20 20 2a 2a 20 73 74 6f 72 65 is. ** store
23750 64 20 69 6e 20 61 4f 76 65 72 66 6c 6f 77 5b 30 d in aOverflow[0
23760 5d 2c 20 65 74 63 2e 20 41 20 76 61 6c 75 65 20 ], etc. A value
23770 6f 66 20 30 20 69 6e 20 74 68 65 20 61 4f 76 65 of 0 in the aOve
23780 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 0a 20 20 rflow[] array.
23790 20 20 2a 2a 20 6d 65 61 6e 73 20 22 6e 6f 74 20 ** means "not
237a0 79 65 74 20 6b 6e 6f 77 6e 22 20 28 74 68 65 20 yet known" (the
237b0 63 61 63 68 65 20 69 73 20 6c 61 7a 69 6c 79 20 cache is lazily
237c0 70 6f 70 75 6c 61 74 65 64 29 2e 0a 20 20 20 20 populated)..
237d0 2a 2f 0a 20 20 20 20 69 66 28 20 65 4f 70 21 3d */. if( eOp!=
237e0 32 20 26 26 20 28 70 43 75 72 2d 3e 63 75 72 46 2 && (pCur->curF
237f0 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 lags & BTCF_Vali
23800 64 4f 76 66 6c 29 3d 3d 30 20 29 7b 0a 20 20 20 dOvfl)==0 ){.
23810 20 20 20 69 6e 74 20 6e 4f 76 66 6c 20 3d 20 28 int nOvfl = (
23820 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c pCur->info.nPayl
23830 6f 61 64 2d 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e oad-pCur->info.n
23840 4c 6f 63 61 6c 2b 6f 76 66 6c 53 69 7a 65 2d 31 Local+ovflSize-1
23850 29 2f 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 )/ovflSize;.
23860 20 20 69 66 28 20 6e 4f 76 66 6c 3e 70 43 75 72 if( nOvfl>pCur
23870 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 29 7b 0a ->nOvflAlloc ){.
23880 20 20 20 20 20 20 20 20 50 67 6e 6f 20 2a 61 4e Pgno *aN
23890 65 77 20 3d 20 28 50 67 6e 6f 2a 29 73 71 6c 69 ew = (Pgno*)sqli
238a0 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 0a 20 20 te3DbRealloc(.
238b0 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
238c0 70 42 74 72 65 65 2d 3e 64 62 2c 20 70 43 75 72 pBtree->db, pCur
238d0 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 6e 4f 76 ->aOverflow, nOv
238e0 66 6c 2a 32 2a 73 69 7a 65 6f 66 28 50 67 6e 6f fl*2*sizeof(Pgno
238f0 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 ). );.
23900 20 20 20 20 20 69 66 28 20 61 4e 65 77 3d 3d 30 if( aNew==0
23910 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
23920 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b = SQLITE_NOMEM;
23930 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
23940 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
23950 6e 4f 76 66 6c 41 6c 6c 6f 63 20 3d 20 6e 4f 76 nOvflAlloc = nOv
23960 66 6c 2a 32 3b 0a 20 20 20 20 20 20 20 20 20 20 fl*2;.
23970 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 pCur->aOverflow
23980 3d 20 61 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 = aNew;.
23990 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
239a0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
239b0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d K ){. mem
239c0 73 65 74 28 70 43 75 72 2d 3e 61 4f 76 65 72 66 set(pCur->aOverf
239d0 6c 6f 77 2c 20 30 2c 20 6e 4f 76 66 6c 2a 73 69 low, 0, nOvfl*si
239e0 7a 65 6f 66 28 50 67 6e 6f 29 29 3b 0a 20 20 20 zeof(Pgno));.
239f0 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c pCur->curFl
23a00 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c 69 ags |= BTCF_Vali
23a10 64 4f 76 66 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 dOvfl;. }.
23a20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
23a30 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 the overflow pag
23a40 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 73 e-list cache has
23a50 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 been allocated
23a60 61 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 65 and the. ** e
23a70 6e 74 72 79 20 66 6f 72 20 74 68 65 20 66 69 72 ntry for the fir
23a80 73 74 20 72 65 71 75 69 72 65 64 20 6f 76 65 72 st required over
23a90 66 6c 6f 77 20 70 61 67 65 20 69 73 20 76 61 6c flow page is val
23aa0 69 64 2c 20 73 6b 69 70 0a 20 20 20 20 2a 2a 20 id, skip. **
23ab0 64 69 72 65 63 74 6c 79 20 74 6f 20 69 74 2e 0a directly to it..
23ac0 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 */. if( (
23ad0 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
23ae0 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 BTCF_ValidOvfl)
23af0 21 3d 30 0a 20 20 20 20 20 26 26 20 70 43 75 72 !=0. && pCur
23b00 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 6f 66 66 73 ->aOverflow[offs
23b10 65 74 2f 6f 76 66 6c 53 69 7a 65 5d 0a 20 20 20 et/ovflSize].
23b20 20 29 7b 0a 20 20 20 20 20 20 69 49 64 78 20 3d ){. iIdx =
23b30 20 28 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 7a (offset/ovflSiz
23b40 65 29 3b 0a 20 20 20 20 20 20 6e 65 78 74 50 61 e);. nextPa
23b50 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 65 72 ge = pCur->aOver
23b60 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a 20 20 20 20 flow[iIdx];.
23b70 20 20 6f 66 66 73 65 74 20 3d 20 28 6f 66 66 73 offset = (offs
23b80 65 74 25 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 et%ovflSize);.
23b90 20 20 7d 0a 0a 20 20 20 20 66 6f 72 28 20 3b 20 }.. for( ;
23ba0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
23bb0 20 61 6d 74 3e 30 20 26 26 20 6e 65 78 74 50 61 amt>0 && nextPa
23bc0 67 65 3b 20 69 49 64 78 2b 2b 29 7b 0a 0a 20 20 ge; iIdx++){..
23bd0 20 20 20 20 2f 2a 20 49 66 20 72 65 71 75 69 72 /* If requir
23be0 65 64 2c 20 70 6f 70 75 6c 61 74 65 20 74 68 65 ed, populate the
23bf0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c overflow page-l
23c00 69 73 74 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20 ist cache. */.
23c10 20 20 20 20 69 66 28 20 28 70 43 75 72 2d 3e 63 if( (pCur->c
23c20 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 urFlags & BTCF_V
23c30 61 6c 69 64 4f 76 66 6c 29 21 3d 30 20 29 7b 0a alidOvfl)!=0 ){.
23c40 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 21 assert(!
23c50 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
23c60 69 49 64 78 5d 20 7c 7c 20 70 43 75 72 2d 3e 61 iIdx] || pCur->a
23c70 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d Overflow[iIdx]==
23c80 6e 65 78 74 50 61 67 65 29 3b 0a 20 20 20 20 20 nextPage);.
23c90 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c pCur->aOverfl
23ca0 6f 77 5b 69 49 64 78 5d 20 3d 20 6e 65 78 74 50 ow[iIdx] = nextP
23cb0 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 age;. }..
23cc0 20 20 20 20 69 66 28 20 6f 66 66 73 65 74 3e 3d if( offset>=
23cd0 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 ovflSize ){.
23ce0 20 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c 79 20 /* The only
23cf0 72 65 61 73 6f 6e 20 74 6f 20 72 65 61 64 20 74 reason to read t
23d00 68 69 73 20 70 61 67 65 20 69 73 20 74 6f 20 6f his page is to o
23d10 62 74 61 69 6e 20 74 68 65 20 70 61 67 65 0a 20 btain the page.
23d20 20 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 ** number
23d30 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 70 61 for the next pa
23d40 67 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c ge in the overfl
23d50 6f 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 ow chain. The pa
23d60 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 61 ge. ** da
23d70 74 61 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 ta is not requir
23d80 65 64 2e 20 53 6f 20 66 69 72 73 74 20 74 72 79 ed. So first try
23d90 20 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 6f to lookup the o
23da0 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 verflow.
23db0 2a 2a 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ** page-list cac
23dc0 68 65 2c 20 69 66 20 61 6e 79 2c 20 74 68 65 6e he, if any, then
23dd0 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74 68 fall back to th
23de0 65 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 e getOverflowPag
23df0 65 28 29 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 e(). ** f
23e00 75 6e 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 unction..
23e10 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 4e **. ** N
23e20 6f 74 65 20 74 68 61 74 20 74 68 65 20 61 4f 76 ote that the aOv
23e30 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 20 6d erflow[] array m
23e40 75 73 74 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 ust be allocated
23e50 20 62 65 63 61 75 73 65 20 65 4f 70 21 3d 32 0a because eOp!=2.
23e60 20 20 20 20 20 20 20 20 2a 2a 20 68 65 72 65 2e ** here.
23e70 20 20 49 66 20 65 4f 70 3d 3d 32 2c 20 74 68 65 If eOp==2, the
23e80 6e 20 6f 66 66 73 65 74 3d 3d 30 20 61 6e 64 20 n offset==0 and
23e90 74 68 69 73 20 62 72 61 6e 63 68 20 69 73 20 6e this branch is n
23ea0 65 76 65 72 20 74 61 6b 65 6e 2e 0a 20 20 20 20 ever taken..
23eb0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 */. a
23ec0 73 73 65 72 74 28 20 65 4f 70 21 3d 32 20 29 3b ssert( eOp!=2 );
23ed0 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
23ee0 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
23ef0 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c & BTCF_ValidOvfl
23f00 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 );. if(
23f10 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
23f20 69 49 64 78 2b 31 5d 20 29 7b 0a 20 20 20 20 20 iIdx+1] ){.
23f30 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
23f40 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
23f50 69 49 64 78 2b 31 5d 3b 0a 20 20 20 20 20 20 20 iIdx+1];.
23f60 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
23f70 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 66 6c rc = getOverfl
23f80 6f 77 50 61 67 65 28 70 42 74 2c 20 6e 65 78 74 owPage(pBt, next
23f90 50 61 67 65 2c 20 30 2c 20 26 6e 65 78 74 50 61 Page, 0, &nextPa
23fa0 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ge);. }.
23fb0 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 2d 3d offset -=
23fc0 20 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 ovflSize;.
23fd0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
23fe0 2f 2a 20 4e 65 65 64 20 74 6f 20 72 65 61 64 20 /* Need to read
23ff0 74 68 69 73 20 70 61 67 65 20 70 72 6f 70 65 72 this page proper
24000 6c 79 2e 20 49 74 20 63 6f 6e 74 61 69 6e 73 20 ly. It contains
24010 73 6f 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 some of the.
24020 20 20 20 20 2a 2a 20 72 61 6e 67 65 20 6f 66 20 ** range of
24030 64 61 74 61 20 74 68 61 74 20 69 73 20 62 65 69 data that is bei
24040 6e 67 20 72 65 61 64 20 28 65 4f 70 3d 3d 30 29 ng read (eOp==0)
24050 20 6f 72 20 77 72 69 74 74 65 6e 20 28 65 4f 70 or written (eOp
24060 21 3d 30 29 2e 0a 20 20 20 20 20 20 20 20 2a 2f !=0).. */
24070 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
24080 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 IRECT_OVERFLOW_R
24090 45 41 44 0a 20 20 20 20 20 20 20 20 73 71 6c 69 EAD. sqli
240a0 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b 0a 23 65 te3_file *fd;.#e
240b0 6e 64 69 66 0a 20 20 20 20 20 20 20 20 69 6e 74 ndif. int
240c0 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 20 20 a = amt;.
240d0 20 20 69 66 28 20 61 20 2b 20 6f 66 66 73 65 74 if( a + offset
240e0 20 3e 20 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 > ovflSize ){.
240f0 20 20 20 20 20 20 20 20 20 61 20 3d 20 6f 76 66 a = ovf
24100 6c 53 69 7a 65 20 2d 20 6f 66 66 73 65 74 3b 0a lSize - offset;.
24110 20 20 20 20 20 20 20 20 7d 0a 0a 23 69 66 64 65 }..#ifde
24120 66 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f f SQLITE_DIRECT_
24130 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 OVERFLOW_READ.
24140 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6c 6c 20 /* If all
24150 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 the following ar
24160 65 20 74 72 75 65 3a 0a 20 20 20 20 20 20 20 20 e true:.
24170 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 **. **
24180 31 29 20 74 68 69 73 20 69 73 20 61 20 72 65 61 1) this is a rea
24190 64 20 6f 70 65 72 61 74 69 6f 6e 2c 20 61 6e 64 d operation, and
241a0 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 32 . ** 2
241b0 29 20 64 61 74 61 20 69 73 20 72 65 71 75 69 72 ) data is requir
241c0 65 64 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 ed from the star
241d0 74 20 6f 66 20 74 68 69 73 20 6f 76 65 72 66 6c t of this overfl
241e0 6f 77 20 70 61 67 65 2c 20 61 6e 64 0a 20 20 20 ow page, and.
241f0 20 20 20 20 20 2a 2a 20 20 20 33 29 20 74 68 65 ** 3) the
24200 20 64 61 74 61 62 61 73 65 20 69 73 20 66 69 6c database is fil
24210 65 2d 62 61 63 6b 65 64 2c 20 61 6e 64 0a 20 20 e-backed, and.
24220 20 20 20 20 20 20 2a 2a 20 20 20 34 29 20 74 68 ** 4) th
24230 65 72 65 20 69 73 20 6e 6f 20 6f 70 65 6e 20 77 ere is no open w
24240 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
24250 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a , and. **
24260 20 20 20 35 29 20 74 68 65 20 64 61 74 61 62 61 5) the databa
24270 73 65 20 69 73 20 6e 6f 74 20 61 20 57 41 4c 20 se is not a WAL
24280 64 61 74 61 62 61 73 65 2c 0a 20 20 20 20 20 20 database,.
24290 20 20 2a 2a 20 20 20 36 29 20 61 6c 6c 20 64 61 ** 6) all da
242a0 74 61 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ta from the page
242b0 20 69 73 20 62 65 69 6e 67 20 72 65 61 64 2e 0a is being read..
242c0 20 20 20 20 20 20 20 20 2a 2a 20 20 20 37 29 20 ** 7)
242d0 61 74 20 6c 65 61 73 74 20 34 20 62 79 74 65 73 at least 4 bytes
242e0 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 have already be
242f0 65 6e 20 72 65 61 64 20 69 6e 74 6f 20 74 68 65 en read into the
24300 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 0a output buffer .
24310 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 **.
24320 20 20 20 2a 2a 20 74 68 65 6e 20 64 61 74 61 20 ** then data
24330 63 61 6e 20 62 65 20 72 65 61 64 20 64 69 72 65 can be read dire
24340 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 64 61 ctly from the da
24350 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e 74 6f tabase file into
24360 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 the. **
24370 6f 75 74 70 75 74 20 62 75 66 66 65 72 2c 20 62 output buffer, b
24380 79 70 61 73 73 69 6e 67 20 74 68 65 20 70 61 67 ypassing the pag
24390 65 2d 63 61 63 68 65 20 61 6c 74 6f 67 65 74 68 e-cache altogeth
243a0 65 72 2e 20 54 68 69 73 20 73 70 65 65 64 73 0a er. This speeds.
243b0 20 20 20 20 20 20 20 20 2a 2a 20 75 70 20 6c 6f ** up lo
243c0 61 64 69 6e 67 20 6c 61 72 67 65 20 72 65 63 6f ading large reco
243d0 72 64 73 20 74 68 61 74 20 73 70 61 6e 20 6d 61 rds that span ma
243e0 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 ny overflow page
243f0 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 s.. */.
24400 20 20 20 20 20 20 69 66 28 20 28 65 4f 70 26 30 if( (eOp&0
24410 78 30 31 29 3d 3d 30 20 20 20 20 20 20 20 20 20 x01)==0
24420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24430 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24440 28 31 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 (1) */.
24450 26 26 20 6f 66 66 73 65 74 3d 3d 30 20 20 20 20 && offset==0
24460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24480 20 20 20 20 20 20 2f 2a 20 28 32 29 20 2a 2f 0a /* (2) */.
24490 20 20 20 20 20 20 20 20 20 26 26 20 28 62 45 6e && (bEn
244a0 64 20 7c 7c 20 61 3d 3d 6f 76 66 6c 53 69 7a 65 d || a==ovflSize
244b0 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 )
244c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
244d0 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 20 20 * (6) */.
244e0 20 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e && pBt->inTran
244f0 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 52 saction==TRANS_R
24500 45 41 44 20 20 20 20 20 20 20 20 20 20 20 20 20 EAD
24510 20 20 20 20 20 20 20 20 2f 2a 20 28 34 29 20 2a /* (4) *
24520 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 66 /. && (f
24530 64 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 d = sqlite3Pager
24540 46 69 6c 65 28 70 42 74 2d 3e 70 50 61 67 65 72 File(pBt->pPager
24550 29 29 2d 3e 70 4d 65 74 68 6f 64 73 20 20 20 20 ))->pMethods
24560 20 2f 2a 20 28 33 29 20 2a 2f 0a 20 20 20 20 20 /* (3) */.
24570 20 20 20 20 26 26 20 70 42 74 2d 3e 70 50 61 67 && pBt->pPag
24580 65 31 2d 3e 61 44 61 74 61 5b 31 39 5d 3d 3d 30 e1->aData[19]==0
24590 78 30 31 20 20 20 20 20 20 20 20 20 20 20 20 20 x01
245a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 35 29 /* (5)
245b0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 */. &&
245c0 26 70 42 75 66 5b 2d 34 5d 3e 3d 70 42 75 66 53 &pBuf[-4]>=pBufS
245d0 74 61 72 74 20 20 20 20 20 20 20 20 20 20 20 20 tart
245e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
245f0 20 20 20 2f 2a 20 28 37 29 20 2a 2f 0a 20 20 20 /* (7) */.
24600 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 ){.
24610 20 20 75 38 20 61 53 61 76 65 5b 34 5d 3b 0a 20 u8 aSave[4];.
24620 20 20 20 20 20 20 20 20 20 75 38 20 2a 61 57 72 u8 *aWr
24630 69 74 65 20 3d 20 26 70 42 75 66 5b 2d 34 5d 3b ite = &pBuf[-4];
24640 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
24650 74 28 20 61 57 72 69 74 65 3e 3d 70 42 75 66 53 t( aWrite>=pBufS
24660 74 61 72 74 20 29 3b 20 20 20 20 20 20 20 20 20 tart );
24670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24680 2f 2a 20 68 65 6e 63 65 20 28 37 29 20 2a 2f 0a /* hence (7) */.
24690 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
246a0 28 61 53 61 76 65 2c 20 61 57 72 69 74 65 2c 20 (aSave, aWrite,
246b0 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 4);. rc
246c0 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 = sqlite3OsRead
246d0 28 66 64 2c 20 61 57 72 69 74 65 2c 20 61 2b 34 (fd, aWrite, a+4
246e0 2c 20 28 69 36 34 29 70 42 74 2d 3e 70 61 67 65 , (i64)pBt->page
246f0 53 69 7a 65 2a 28 6e 65 78 74 50 61 67 65 2d 31 Size*(nextPage-1
24700 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 ));. ne
24710 78 74 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 xtPage = get4byt
24720 65 28 61 57 72 69 74 65 29 3b 0a 20 20 20 20 20 e(aWrite);.
24730 20 20 20 20 20 6d 65 6d 63 70 79 28 61 57 72 69 memcpy(aWri
24740 74 65 2c 20 61 53 61 76 65 2c 20 34 29 3b 0a 20 te, aSave, 4);.
24750 20 20 20 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e }else.#en
24760 64 69 66 0a 0a 20 20 20 20 20 20 20 20 7b 0a 20 dif.. {.
24770 20 20 20 20 20 20 20 20 20 44 62 50 61 67 65 20 DbPage
24780 2a 70 44 62 50 61 67 65 3b 0a 20 20 20 20 20 20 *pDbPage;.
24790 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
247a0 50 61 67 65 72 41 63 71 75 69 72 65 28 70 42 74 PagerAcquire(pBt
247b0 2d 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 50 61 ->pPager, nextPa
247c0 67 65 2c 20 26 70 44 62 50 61 67 65 2c 0a 20 20 ge, &pDbPage,.
247d0 20 20 20 20 20 20 20 20 20 20 20 20 28 28 65 4f ((eO
247e0 70 26 30 78 30 31 29 3d 3d 30 20 3f 20 50 41 47 p&0x01)==0 ? PAG
247f0 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 ER_GET_READONLY
24800 3a 20 30 29 0a 20 20 20 20 20 20 20 20 20 20 29 : 0). )
24810 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
24820 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
24830 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 50 61 . aPa
24840 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 33 50 yload = sqlite3P
24850 61 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 agerGetData(pDbP
24860 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
24870 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 nextPage = get
24880 34 62 79 74 65 28 61 50 61 79 6c 6f 61 64 29 3b 4byte(aPayload);
24890 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
248a0 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 = copyPayload(&a
248b0 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 2b 34 Payload[offset+4
248c0 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 4f 70 ], pBuf, a, (eOp
248d0 26 30 78 30 31 29 2c 20 70 44 62 50 61 67 65 29 &0x01), pDbPage)
248e0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 ;. sq
248f0 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
24900 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
24910 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 30 offset = 0
24920 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
24930 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
24940 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 20 20 amt -= a;.
24950 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 pBuf += a;.
24960 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a }. }. }..
24970 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
24980 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a _OK && amt>0 ){.
24990 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
249a0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
249b0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
249c0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 .}../*.** Read p
249d0 61 72 74 20 6f 66 20 74 68 65 20 6b 65 79 20 61 art of the key a
249e0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 63 ssociated with c
249f0 75 72 73 6f 72 20 70 43 75 72 2e 20 20 45 78 61 ursor pCur. Exa
24a00 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 62 79 ctly.** "amt" by
24a10 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 61 6e tes will be tran
24a20 73 66 65 72 72 65 64 20 69 6e 74 6f 20 70 42 75 sferred into pBu
24a30 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e 73 66 f[]. The transf
24a40 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 74 20 er.** begins at
24a50 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 "offset"..**.**
24a60 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 The caller must
24a70 65 6e 73 75 72 65 20 74 68 61 74 20 70 43 75 72 ensure that pCur
24a80 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 is pointing to
24a90 61 20 76 61 6c 69 64 20 72 6f 77 0a 2a 2a 20 69 a valid row.** i
24aa0 6e 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a n the table..**.
24ab0 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 ** Return SQLITE
24ac0 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 6f _OK on success o
24ad0 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 r an error code
24ae0 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 if anything goes
24af0 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 65 .** wrong. An e
24b00 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 rror is returned
24b10 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 22 if "offset+amt"
24b20 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 0a is larger than.
24b30 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 ** the available
24b40 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 payload..*/.int
24b50 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 sqlite3BtreeKey
24b60 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
24b70 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 u32 offset, u32
24b80 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 amt, void *pBuf
24b90 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ){. assert( cur
24ba0 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
24bb0 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
24bc0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
24bd0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
24be0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
24bf0 50 61 67 65 3e 3d 30 20 26 26 20 70 43 75 72 2d Page>=0 && pCur-
24c00 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
24c10 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 72 74 age] );. assert
24c20 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
24c30 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d ur->iPage]<pCur-
24c40 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
24c50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 age]->nCell );.
24c60 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 return accessPa
24c70 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 yload(pCur, offs
24c80 65 74 2c 20 61 6d 74 2c 20 28 75 6e 73 69 67 6e et, amt, (unsign
24c90 65 64 20 63 68 61 72 2a 29 70 42 75 66 2c 20 30 ed char*)pBuf, 0
24ca0 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 );.}../*.** Read
24cb0 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 part of the dat
24cc0 61 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 a associated wit
24cd0 68 20 63 75 72 73 6f 72 20 70 43 75 72 2e 20 20 h cursor pCur.
24ce0 45 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 Exactly.** "amt"
24cf0 20 62 79 74 65 73 20 77 69 6c 6c 20 62 65 20 74 bytes will be t
24d00 72 61 6e 73 66 65 72 65 64 20 69 6e 74 6f 20 70 ransfered into p
24d10 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e Buf[]. The tran
24d20 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 sfer.** begins a
24d30 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a t "offset"..**.*
24d40 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f * Return SQLITE_
24d50 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 OK on success or
24d60 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 an error code i
24d70 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a f anything goes.
24d80 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 65 72 ** wrong. An er
24d90 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 20 ror is returned
24da0 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 22 20 if "offset+amt"
24db0 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 0a 2a is larger than.*
24dc0 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 * the available
24dd0 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 payload..*/.int
24de0 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 74 61 sqlite3BtreeData
24df0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
24e00 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 u32 offset, u32
24e10 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 amt, void *pBuf
24e20 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 23 69 ){. int rc;..#i
24e30 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
24e40 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69 66 20 T_INCRBLOB. if
24e50 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
24e60 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 CURSOR_INVALID )
24e70 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
24e80 49 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 23 ITE_ABORT;. }.#
24e90 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 endif.. assert(
24ea0 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
24eb0 78 28 70 43 75 72 29 20 29 3b 0a 20 20 72 63 20 x(pCur) );. rc
24ec0 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 50 = restoreCursorP
24ed0 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a 20 osition(pCur);.
24ee0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
24ef0 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 OK ){. assert
24f00 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
24f10 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
24f20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
24f30 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 70 43 ->iPage>=0 && pC
24f40 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
24f50 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 20 20 61 >iPage] );. a
24f60 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 ssert( pCur->aiI
24f70 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c dx[pCur->iPage]<
24f80 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
24f90 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
24fa0 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 63 63 );. rc = acc
24fb0 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c essPayload(pCur,
24fc0 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 70 42 offset, amt, pB
24fd0 75 66 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 uf, 0);. }. re
24fe0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
24ff0 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 * Return a point
25000 65 72 20 74 6f 20 70 61 79 6c 6f 61 64 20 69 6e er to payload in
25010 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 formation from t
25020 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 he entry that th
25030 65 20 0a 2a 2a 20 70 43 75 72 20 63 75 72 73 6f e .** pCur curso
25040 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f r is pointing to
25050 2e 20 20 54 68 65 20 70 6f 69 6e 74 65 72 20 69 . The pointer i
25060 73 20 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 s to the beginni
25070 6e 67 20 6f 66 0a 2a 2a 20 74 68 65 20 6b 65 79 ng of.** the key
25080 20 69 66 20 69 6e 64 65 78 20 62 74 72 65 65 73 if index btrees
25090 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d (pPage->intKey=
250a0 3d 30 29 20 61 6e 64 20 69 73 20 74 68 65 20 64 =0) and is the d
250b0 61 74 61 20 66 6f 72 0a 2a 2a 20 74 61 62 6c 65 ata for.** table
250c0 20 62 74 72 65 65 73 20 28 70 50 61 67 65 2d 3e btrees (pPage->
250d0 69 6e 74 4b 65 79 3d 3d 31 29 2e 20 54 68 65 20 intKey==1). The
250e0 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
250f0 6f 66 20 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 of available.**
25100 6b 65 79 2f 64 61 74 61 20 69 73 20 77 72 69 74 key/data is writ
25110 74 65 6e 20 69 6e 74 6f 20 2a 70 41 6d 74 2e 20 ten into *pAmt.
25120 20 49 66 20 2a 70 41 6d 74 3d 3d 30 2c 20 74 68 If *pAmt==0, th
25130 65 6e 20 74 68 65 20 76 61 6c 75 65 0a 2a 2a 20 en the value.**
25140 72 65 74 75 72 6e 65 64 20 77 69 6c 6c 20 6e 6f returned will no
25150 74 20 62 65 20 61 20 76 61 6c 69 64 20 70 6f 69 t be a valid poi
25160 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 nter..**.** This
25170 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6e 20 6f routine is an o
25180 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 49 74 ptimization. It
25190 20 69 73 20 63 6f 6d 6d 6f 6e 20 66 6f 72 20 74 is common for t
251a0 68 65 20 65 6e 74 69 72 65 20 6b 65 79 0a 2a 2a he entire key.**
251b0 20 61 6e 64 20 64 61 74 61 20 74 6f 20 66 69 74 and data to fit
251c0 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 on the local pa
251d0 67 65 20 61 6e 64 20 66 6f 72 20 74 68 65 72 65 ge and for there
251e0 20 74 6f 20 62 65 20 6e 6f 20 6f 76 65 72 66 6c to be no overfl
251f0 6f 77 0a 2a 2a 20 70 61 67 65 73 2e 20 20 57 68 ow.** pages. Wh
25200 65 6e 20 74 68 61 74 20 69 73 20 73 6f 2c 20 74 en that is so, t
25210 68 69 73 20 72 6f 75 74 69 6e 65 20 63 61 6e 20 his routine can
25220 62 65 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 be used to acces
25230 73 20 74 68 65 0a 2a 2a 20 6b 65 79 20 61 6e 64 s the.** key and
25240 20 64 61 74 61 20 77 69 74 68 6f 75 74 20 6d 61 data without ma
25250 6b 69 6e 67 20 61 20 63 6f 70 79 2e 20 20 49 66 king a copy. If
25260 20 74 68 65 20 6b 65 79 20 61 6e 64 2f 6f 72 20 the key and/or
25270 64 61 74 61 20 73 70 69 6c 6c 73 0a 2a 2a 20 6f data spills.** o
25280 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 nto overflow pag
25290 65 73 2c 20 74 68 65 6e 20 61 63 63 65 73 73 50 es, then accessP
252a0 61 79 6c 6f 61 64 28 29 20 6d 75 73 74 20 62 65 ayload() must be
252b0 20 75 73 65 64 20 74 6f 20 72 65 61 73 73 65 6d used to reassem
252c0 62 6c 65 0a 2a 2a 20 74 68 65 20 6b 65 79 2f 64 ble.** the key/d
252d0 61 74 61 20 61 6e 64 20 63 6f 70 79 20 69 74 20 ata and copy it
252e0 69 6e 74 6f 20 61 20 70 72 65 61 6c 6c 6f 63 61 into a prealloca
252f0 74 65 64 20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a ted buffer..**.*
25300 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 72 65 * The pointer re
25310 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 20 72 turned by this r
25320 6f 75 74 69 6e 65 20 6c 6f 6f 6b 73 20 64 69 72 outine looks dir
25330 65 63 74 6c 79 20 69 6e 74 6f 20 74 68 65 20 63 ectly into the c
25340 61 63 68 65 64 0a 2a 2a 20 70 61 67 65 20 6f 66 ached.** page of
25350 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 the database.
25360 54 68 65 20 64 61 74 61 20 6d 69 67 68 74 20 63 The data might c
25370 68 61 6e 67 65 20 6f 72 20 6d 6f 76 65 20 74 68 hange or move th
25380 65 20 6e 65 78 74 20 74 69 6d 65 0a 2a 2a 20 61 e next time.** a
25390 6e 79 20 62 74 72 65 65 20 72 6f 75 74 69 6e 65 ny btree routine
253a0 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 is called..*/.s
253b0 74 61 74 69 63 20 63 6f 6e 73 74 20 76 6f 69 64 tatic const void
253c0 20 2a 66 65 74 63 68 50 61 79 6c 6f 61 64 28 0a *fetchPayload(.
253d0 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
253e0 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 , /* Cursor
253f0 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 6e 74 pointing to ent
25400 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f 6d 20 ry to read from
25410 2a 2f 0a 20 20 75 33 32 20 2a 70 41 6d 74 20 20 */. u32 *pAmt
25420 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 /* Wri
25430 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 te the number of
25440 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 65 73 available bytes
25450 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 61 73 here */.){. as
25460 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 26 26 sert( pCur!=0 &&
25470 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 pCur->iPage>=0
25480 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b && pCur->apPage[
25490 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b 0a 20 pCur->iPage]);.
254a0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
254b0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
254c0 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
254d0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
254e0 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 eld(pCur->pBtree
254f0 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
25500 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
25510 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
25520 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
25530 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
25540 69 50 61 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 iPage]<pCur->apP
25550 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
25560 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 ->nCell );. ass
25570 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ert( pCur->info.
25580 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 20 2a 70 41 nSize>0 );. *pA
25590 6d 74 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e mt = pCur->info.
255a0 6e 4c 6f 63 61 6c 3b 0a 20 20 72 65 74 75 72 6e nLocal;. return
255b0 20 28 76 6f 69 64 2a 29 70 43 75 72 2d 3e 69 6e (void*)pCur->in
255c0 66 6f 2e 70 50 61 79 6c 6f 61 64 3b 0a 7d 0a 0a fo.pPayload;.}..
255d0 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 20 65 ./*.** For the e
255e0 6e 74 72 79 20 74 68 61 74 20 63 75 72 73 6f 72 ntry that cursor
255f0 20 70 43 75 72 20 69 73 20 70 6f 69 6e 74 20 74 pCur is point t
25600 6f 2c 20 72 65 74 75 72 6e 20 61 73 0a 2a 2a 20 o, return as.**
25610 6d 61 6e 79 20 62 79 74 65 73 20 6f 66 20 74 68 many bytes of th
25620 65 20 6b 65 79 20 6f 72 20 64 61 74 61 20 61 73 e key or data as
25630 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 6f are available o
25640 6e 20 74 68 65 20 6c 6f 63 61 6c 0a 2a 2a 20 62 n the local.** b
25650 2d 74 72 65 65 20 70 61 67 65 2e 20 20 57 72 69 -tree page. Wri
25660 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 te the number of
25670 20 61 76 61 69 6c 61 62 6c 65 20 62 79 74 65 73 available bytes
25680 20 69 6e 74 6f 20 2a 70 41 6d 74 2e 0a 2a 2a 0a into *pAmt..**.
25690 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 72 ** The pointer r
256a0 65 74 75 72 6e 65 64 20 69 73 20 65 70 68 65 6d eturned is ephem
256b0 65 72 61 6c 2e 20 20 54 68 65 20 6b 65 79 2f 64 eral. The key/d
256c0 61 74 61 20 6d 61 79 20 6d 6f 76 65 0a 2a 2a 20 ata may move.**
256d0 6f 72 20 62 65 20 64 65 73 74 72 6f 79 65 64 20 or be destroyed
256e0 6f 6e 20 74 68 65 20 6e 65 78 74 20 63 61 6c 6c on the next call
256f0 20 74 6f 20 61 6e 79 20 42 74 72 65 65 20 72 6f to any Btree ro
25700 75 74 69 6e 65 2c 0a 2a 2a 20 69 6e 63 6c 75 64 utine,.** includ
25710 69 6e 67 20 63 61 6c 6c 73 20 66 72 6f 6d 20 6f ing calls from o
25720 74 68 65 72 20 74 68 72 65 61 64 73 20 61 67 61 ther threads aga
25730 69 6e 73 74 20 74 68 65 20 73 61 6d 65 20 63 61 inst the same ca
25740 63 68 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20 61 che..** Hence, a
25750 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20 42 74 mutex on the Bt
25760 53 68 61 72 65 64 20 73 68 6f 75 6c 64 20 62 65 Shared should be
25770 20 68 65 6c 64 20 70 72 69 6f 72 20 74 6f 20 63 held prior to c
25780 61 6c 6c 69 6e 67 0a 2a 2a 20 74 68 69 73 20 72 alling.** this r
25790 6f 75 74 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 outine..**.** Th
257a0 65 73 65 20 72 6f 75 74 69 6e 65 73 20 69 73 20 ese routines is
257b0 75 73 65 64 20 74 6f 20 67 65 74 20 71 75 69 63 used to get quic
257c0 6b 20 61 63 63 65 73 73 20 74 6f 20 6b 65 79 20 k access to key
257d0 61 6e 64 20 64 61 74 61 0a 2a 2a 20 69 6e 20 74 and data.** in t
257e0 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 he common case w
257f0 68 65 72 65 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 here no overflow
25800 20 70 61 67 65 73 20 61 72 65 20 75 73 65 64 2e pages are used.
25810 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a .*/.const void *
25820 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 46 sqlite3BtreeKeyF
25830 65 74 63 68 28 42 74 43 75 72 73 6f 72 20 2a 70 etch(BtCursor *p
25840 43 75 72 2c 20 75 33 32 20 2a 70 41 6d 74 29 7b Cur, u32 *pAmt){
25850 0a 20 20 72 65 74 75 72 6e 20 66 65 74 63 68 50 . return fetchP
25860 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 6d ayload(pCur, pAm
25870 74 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 t);.}.const void
25880 20 2a 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 *sqlite3BtreeDa
25890 74 61 46 65 74 63 68 28 42 74 43 75 72 73 6f 72 taFetch(BtCursor
258a0 20 2a 70 43 75 72 2c 20 75 33 32 20 2a 70 41 6d *pCur, u32 *pAm
258b0 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 66 65 74 t){. return fet
258c0 63 68 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 chPayload(pCur,
258d0 70 41 6d 74 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a pAmt);.}.../*.**
258e0 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 Move the cursor
258f0 20 64 6f 77 6e 20 74 6f 20 61 20 6e 65 77 20 63 down to a new c
25900 68 69 6c 64 20 70 61 67 65 2e 20 20 54 68 65 20 hild page. The
25910 6e 65 77 50 67 6e 6f 20 61 72 67 75 6d 65 6e 74 newPgno argument
25920 20 69 73 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 is the.** page
25930 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 63 68 number of the ch
25940 69 6c 64 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 ild page to move
25950 20 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 to..**.** This
25960 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
25970 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 SQLITE_CORRUPT
25980 69 66 20 74 68 65 20 70 61 67 65 2d 68 65 61 64 if the page-head
25990 65 72 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f er flags field o
259a0 66 0a 2a 2a 20 74 68 65 20 6e 65 77 20 63 68 69 f.** the new chi
259b0 6c 64 20 70 61 67 65 20 64 6f 65 73 20 6e 6f 74 ld page does not
259c0 20 6d 61 74 63 68 20 74 68 65 20 66 6c 61 67 73 match the flags
259d0 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 70 61 field of the pa
259e0 72 65 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 69 66 rent (i.e..** if
259f0 20 61 6e 20 69 6e 74 6b 65 79 20 70 61 67 65 20 an intkey page
25a00 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 74 68 appears to be th
25a10 65 20 70 61 72 65 6e 74 20 6f 66 20 61 20 6e 6f e parent of a no
25a20 6e 2d 69 6e 74 6b 65 79 20 70 61 67 65 2c 20 6f n-intkey page, o
25a30 72 0a 2a 2a 20 76 69 63 65 2d 76 65 72 73 61 29 r.** vice-versa)
25a40 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
25a50 6d 6f 76 65 54 6f 43 68 69 6c 64 28 42 74 43 75 moveToChild(BtCu
25a60 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 rsor *pCur, u32
25a70 6e 65 77 50 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 newPgno){. int
25a80 72 63 3b 0a 20 20 69 6e 74 20 69 20 3d 20 70 43 rc;. int i = pC
25a90 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 4d 65 6d ur->iPage;. Mem
25aa0 50 61 67 65 20 2a 70 4e 65 77 50 61 67 65 3b 0a Page *pNewPage;.
25ab0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
25ac0 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 0a 20 20 = pCur->pBt;..
25ad0 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
25ae0 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
25af0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
25b00 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
25b10 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 _VALID );. asse
25b20 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3c rt( pCur->iPage<
25b30 42 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 45 50 BTCURSOR_MAX_DEP
25b40 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
25b50 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 29 pCur->iPage>=0 )
25b60 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 ;. if( pCur->iP
25b70 61 67 65 3e 3d 28 42 54 43 55 52 53 4f 52 5f 4d age>=(BTCURSOR_M
25b80 41 58 5f 44 45 50 54 48 2d 31 29 20 29 7b 0a 20 AX_DEPTH-1) ){.
25b90 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
25ba0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
25bb0 20 7d 0a 20 20 72 63 20 3d 20 67 65 74 41 6e 64 }. rc = getAnd
25bc0 49 6e 69 74 50 61 67 65 28 70 42 74 2c 20 6e 65 InitPage(pBt, ne
25bd0 77 50 67 6e 6f 2c 20 26 70 4e 65 77 50 61 67 65 wPgno, &pNewPage
25be0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
25bf0 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
25c00 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 & BTCF_WriteFla
25c10 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f 47 45 g)==0 ? PAGER_GE
25c20 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 29 3b T_READONLY : 0);
25c30 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 . if( rc ) retu
25c40 72 6e 20 72 63 3b 0a 20 20 70 43 75 72 2d 3e 61 rn rc;. pCur->a
25c50 70 50 61 67 65 5b 69 2b 31 5d 20 3d 20 70 4e 65 pPage[i+1] = pNe
25c60 77 50 61 67 65 3b 0a 20 20 70 43 75 72 2d 3e 61 wPage;. pCur->a
25c70 69 49 64 78 5b 69 2b 31 5d 20 3d 20 30 3b 0a 20 iIdx[i+1] = 0;.
25c80 20 70 43 75 72 2d 3e 69 50 61 67 65 2b 2b 3b 0a pCur->iPage++;.
25c90 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 . pCur->info.nS
25ca0 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d ize = 0;. pCur-
25cb0 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 >curFlags &= ~(B
25cc0 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 TCF_ValidNKey|BT
25cd0 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 CF_ValidOvfl);.
25ce0 20 69 66 28 20 70 4e 65 77 50 61 67 65 2d 3e 6e if( pNewPage->n
25cf0 43 65 6c 6c 3c 31 20 7c 7c 20 70 4e 65 77 50 61 Cell<1 || pNewPa
25d00 67 65 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 75 72 ge->intKey!=pCur
25d10 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 69 6e 74 ->apPage[i]->int
25d20 4b 65 79 20 29 7b 0a 20 20 20 20 72 65 74 75 72 Key ){. retur
25d30 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
25d40 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 65 74 _BKPT;. }. ret
25d50 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
25d60 0a 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 50 61 ..#if 0./*.** Pa
25d70 67 65 20 70 50 61 72 65 6e 74 20 69 73 20 61 6e ge pParent is an
25d80 20 69 6e 74 65 72 6e 61 6c 20 28 6e 6f 6e 2d 6c internal (non-l
25d90 65 61 66 29 20 74 72 65 65 20 70 61 67 65 2e 20 eaf) tree page.
25da0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 0a 2a This function .*
25db0 2a 20 61 73 73 65 72 74 73 20 74 68 61 74 20 70 * asserts that p
25dc0 61 67 65 20 6e 75 6d 62 65 72 20 69 43 68 69 6c age number iChil
25dd0 64 20 69 73 20 74 68 65 20 6c 65 66 74 2d 63 68 d is the left-ch
25de0 69 6c 64 20 69 66 20 74 68 65 20 69 49 64 78 27 ild if the iIdx'
25df0 74 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 70 61 th.** cell in pa
25e00 67 65 20 70 50 61 72 65 6e 74 2e 20 4f 72 2c 20 ge pParent. Or,
25e10 69 66 20 69 49 64 78 20 69 73 20 65 71 75 61 6c if iIdx is equal
25e20 20 74 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 to the total nu
25e30 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 65 6c 6c 73 mber of.** cells
25e40 20 69 6e 20 70 50 61 72 65 6e 74 2c 20 74 68 61 in pParent, tha
25e50 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 43 t page number iC
25e60 68 69 6c 64 20 69 73 20 74 68 65 20 72 69 67 68 hild is the righ
25e70 74 2d 63 68 69 6c 64 20 6f 66 0a 2a 2a 20 74 68 t-child of.** th
25e80 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 e page..*/.stati
25e90 63 20 76 6f 69 64 20 61 73 73 65 72 74 50 61 72 c void assertPar
25ea0 65 6e 74 49 6e 64 65 78 28 4d 65 6d 50 61 67 65 entIndex(MemPage
25eb0 20 2a 70 50 61 72 65 6e 74 2c 20 69 6e 74 20 69 *pParent, int i
25ec0 49 64 78 2c 20 50 67 6e 6f 20 69 43 68 69 6c 64 Idx, Pgno iChild
25ed0 29 7b 0a 20 20 61 73 73 65 72 74 28 20 69 49 64 ){. assert( iId
25ee0 78 3c 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c x<=pParent->nCel
25ef0 6c 20 29 3b 0a 20 20 69 66 28 20 69 49 64 78 3d l );. if( iIdx=
25f00 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 20 =pParent->nCell
25f10 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 ){. assert( g
25f20 65 74 34 62 79 74 65 28 26 70 50 61 72 65 6e 74 et4byte(&pParent
25f30 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d ->aData[pParent-
25f40 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3d 3d >hdrOffset+8])==
25f50 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 65 6c 73 iChild );. }els
25f60 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 e{. assert( g
25f70 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
25f80 28 70 50 61 72 65 6e 74 2c 20 69 49 64 78 29 29 (pParent, iIdx))
25f90 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 0a ==iChild );. }.
25fa0 7d 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e }.#else.# defin
25fb0 65 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e e assertParentIn
25fc0 64 65 78 28 78 2c 79 2c 7a 29 20 0a 23 65 6e 64 dex(x,y,z) .#end
25fd0 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 if../*.** Move t
25fe0 68 65 20 63 75 72 73 6f 72 20 75 70 20 74 6f 20 he cursor up to
25ff0 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e the parent page.
26000 0a 2a 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 64 78 .**.** pCur->idx
26010 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 63 is set to the c
26020 65 6c 6c 20 69 6e 64 65 78 20 74 68 61 74 20 63 ell index that c
26030 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 6f 69 6e ontains the poin
26040 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 ter.** to the pa
26050 67 65 20 77 65 20 61 72 65 20 63 6f 6d 69 6e 67 ge we are coming
26060 20 66 72 6f 6d 2e 20 20 49 66 20 77 65 20 61 72 from. If we ar
26070 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 74 68 e coming from th
26080 65 0a 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 20 e.** right-most
26090 63 68 69 6c 64 20 70 61 67 65 20 74 68 65 6e 20 child page then
260a0 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 65 74 pCur->idx is set
260b0 20 74 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 68 61 to one more tha
260c0 6e 0a 2a 2a 20 74 68 65 20 6c 61 72 67 65 73 74 n.** the largest
260d0 20 63 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a 2f 0a cell index..*/.
260e0 73 74 61 74 69 63 20 76 6f 69 64 20 6d 6f 76 65 static void move
260f0 54 6f 50 61 72 65 6e 74 28 42 74 43 75 72 73 6f ToParent(BtCurso
26100 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 73 65 r *pCur){. asse
26110 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
26120 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
26130 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
26140 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
26150 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ID );. assert(
26160 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 29 3b pCur->iPage>0 );
26170 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
26180 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
26190 61 67 65 5d 20 29 3b 0a 0a 20 20 2f 2a 20 55 50 age] );.. /* UP
261a0 44 41 54 45 3a 20 49 74 20 69 73 20 61 63 74 75 DATE: It is actu
261b0 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 66 6f ally possible fo
261c0 72 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 r the condition
261d0 74 65 73 74 65 64 20 62 79 20 74 68 65 20 61 73 tested by the as
261e0 73 65 72 74 0a 20 20 2a 2a 20 62 65 6c 6f 77 20 sert. ** below
261f0 74 6f 20 62 65 20 75 6e 74 72 75 65 20 69 66 20 to be untrue if
26200 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
26210 65 20 69 73 20 63 6f 72 72 75 70 74 2e 20 54 68 e is corrupt. Th
26220 69 73 20 63 61 6e 20 6f 63 63 75 72 20 69 66 0a is can occur if.
26230 20 20 2a 2a 20 6f 6e 65 20 63 75 72 73 6f 72 20 ** one cursor
26240 68 61 73 20 6d 6f 64 69 66 69 65 64 20 70 61 67 has modified pag
26250 65 20 70 50 61 72 65 6e 74 20 77 68 69 6c 65 20 e pParent while
26260 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 69 a reference to i
26270 74 20 69 73 20 68 65 6c 64 20 0a 20 20 2a 2a 20 t is held . **
26280 62 79 20 61 20 73 65 63 6f 6e 64 20 63 75 72 73 by a second curs
26290 6f 72 2e 20 57 68 69 63 68 20 63 61 6e 20 6f 6e or. Which can on
262a0 6c 79 20 68 61 70 70 65 6e 20 69 66 20 61 20 73 ly happen if a s
262b0 69 6e 67 6c 65 20 70 61 67 65 20 69 73 20 6c 69 ingle page is li
262c0 6e 6b 65 64 0a 20 20 2a 2a 20 69 6e 74 6f 20 6d nked. ** into m
262d0 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 62 2d 74 ore than one b-t
262e0 72 65 65 20 73 74 72 75 63 74 75 72 65 20 69 6e ree structure in
262f0 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 a corrupt datab
26300 61 73 65 2e 20 20 2a 2f 0a 23 69 66 20 30 0a 20 ase. */.#if 0.
26310 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 assertParentInd
26320 65 78 28 0a 20 20 20 20 70 43 75 72 2d 3e 61 70 ex(. pCur->ap
26330 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
26340 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d 3e -1], . pCur->
26350 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
26360 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d e-1], . pCur-
26370 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
26380 61 67 65 5d 2d 3e 70 67 6e 6f 0a 20 20 29 3b 0a age]->pgno. );.
26390 23 65 6e 64 69 66 0a 20 20 74 65 73 74 63 61 73 #endif. testcas
263a0 65 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 e( pCur->aiIdx[p
263b0 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 20 3e 20 Cur->iPage-1] >
263c0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
263d0 72 2d 3e 69 50 61 67 65 2d 31 5d 2d 3e 6e 43 65 r->iPage-1]->nCe
263e0 6c 6c 20 29 3b 0a 0a 20 20 72 65 6c 65 61 73 65 ll );.. release
263f0 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 67 Page(pCur->apPag
26400 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b e[pCur->iPage]);
26410 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d . pCur->iPage--
26420 3b 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e ;. pCur->info.n
26430 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 Size = 0;. pCur
26440 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 ->curFlags &= ~(
26450 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 BTCF_ValidNKey|B
26460 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a TCF_ValidOvfl);.
26470 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 }../*.** Move th
26480 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f 69 6e e cursor to poin
26490 74 20 74 6f 20 74 68 65 20 72 6f 6f 74 20 70 61 t to the root pa
264a0 67 65 20 6f 66 20 69 74 73 20 62 2d 74 72 65 65 ge of its b-tree
264b0 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a structure..**.*
264c0 2a 20 49 66 20 74 68 65 20 74 61 62 6c 65 20 68 * If the table h
264d0 61 73 20 61 20 76 69 72 74 75 61 6c 20 72 6f 6f as a virtual roo
264e0 74 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 t page, then the
264f0 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 65 64 cursor is moved
26500 20 74 6f 20 70 6f 69 6e 74 0a 2a 2a 20 74 6f 20 to point.** to
26510 74 68 65 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 the virtual root
26520 20 70 61 67 65 20 69 6e 73 74 65 61 64 20 6f 66 page instead of
26530 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 the actual root
26540 20 70 61 67 65 2e 20 41 20 74 61 62 6c 65 20 68 page. A table h
26550 61 73 20 61 0a 2a 2a 20 76 69 72 74 75 61 6c 20 as a.** virtual
26560 72 6f 6f 74 20 70 61 67 65 20 77 68 65 6e 20 74 root page when t
26570 68 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 20 70 he actual root p
26580 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 age contains no
26590 63 65 6c 6c 73 20 61 6e 64 20 61 20 0a 2a 2a 20 cells and a .**
265a0 73 69 6e 67 6c 65 20 63 68 69 6c 64 20 70 61 67 single child pag
265b0 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 e. This can only
265c0 20 68 61 70 70 65 6e 20 77 69 74 68 20 74 68 65 happen with the
265d0 20 74 61 62 6c 65 20 72 6f 6f 74 65 64 20 61 74 table rooted at
265e0 20 70 61 67 65 20 31 2e 0a 2a 2a 0a 2a 2a 20 49 page 1..**.** I
265f0 66 20 74 68 65 20 62 2d 74 72 65 65 20 73 74 72 f the b-tree str
26600 75 63 74 75 72 65 20 69 73 20 65 6d 70 74 79 2c ucture is empty,
26610 20 74 68 65 20 63 75 72 73 6f 72 20 73 74 61 74 the cursor stat
26620 65 20 69 73 20 73 65 74 20 74 6f 20 0a 2a 2a 20 e is set to .**
26630 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 2e 20 CURSOR_INVALID.
26640 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 63 Otherwise, the c
26650 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 6f 20 ursor is set to
26660 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 69 72 point to the fir
26670 73 74 0a 2a 2a 20 63 65 6c 6c 20 6c 6f 63 61 74 st.** cell locat
26680 65 64 20 6f 6e 20 74 68 65 20 72 6f 6f 74 20 28 ed on the root (
26690 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 29 or virtual root)
266a0 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 63 75 page and the cu
266b0 72 73 6f 72 20 73 74 61 74 65 0a 2a 2a 20 69 73 rsor state.** is
266c0 20 73 65 74 20 74 6f 20 43 55 52 53 4f 52 5f 56 set to CURSOR_V
266d0 41 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ALID..**.** If t
266e0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 his function ret
266f0 75 72 6e 73 20 73 75 63 63 65 73 73 66 75 6c 6c urns successfull
26700 79 2c 20 69 74 20 6d 61 79 20 62 65 20 61 73 73 y, it may be ass
26710 75 6d 65 64 20 74 68 61 74 20 74 68 65 0a 2a 2a umed that the.**
26720 20 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c 61 page-header fla
26730 67 73 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 gs indicate that
26740 20 74 68 65 20 5b 76 69 72 74 75 61 6c 5d 20 72 the [virtual] r
26750 6f 6f 74 2d 70 61 67 65 20 69 73 20 74 68 65 20 oot-page is the
26760 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 6b 69 6e expected .** kin
26770 64 20 6f 66 20 62 2d 74 72 65 65 20 70 61 67 65 d of b-tree page
26780 20 28 69 2e 65 2e 20 69 66 20 77 68 65 6e 20 6f (i.e. if when o
26790 70 65 6e 69 6e 67 20 74 68 65 20 63 75 72 73 6f pening the curso
267a0 72 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 r the caller did
267b0 20 6e 6f 74 0a 2a 2a 20 73 70 65 63 69 66 79 20 not.** specify
267c0 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 a KeyInfo struct
267d0 75 72 65 20 74 68 65 20 66 6c 61 67 73 20 62 79 ure the flags by
267e0 74 65 20 69 73 20 73 65 74 20 74 6f 20 30 78 30 te is set to 0x0
267f0 35 20 6f 72 20 30 78 30 44 2c 0a 2a 2a 20 69 6e 5 or 0x0D,.** in
26800 64 69 63 61 74 69 6e 67 20 61 20 74 61 62 6c 65 dicating a table
26810 20 62 2d 74 72 65 65 2c 20 6f 72 20 69 66 20 74 b-tree, or if t
26820 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 73 70 he caller did sp
26830 65 63 69 66 79 20 61 20 4b 65 79 49 6e 66 6f 20 ecify a KeyInfo
26840 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 74 68 .** structure th
26850 65 20 66 6c 61 67 73 20 62 79 74 65 20 69 73 20 e flags byte is
26860 73 65 74 20 74 6f 20 30 78 30 32 20 6f 72 20 30 set to 0x02 or 0
26870 78 30 41 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 x0A, indicating
26880 61 6e 20 69 6e 64 65 78 0a 2a 2a 20 62 2d 74 72 an index.** b-tr
26890 65 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ee)..*/.static i
268a0 6e 74 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 42 74 nt moveToRoot(Bt
268b0 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
268c0 20 4d 65 6d 50 61 67 65 20 2a 70 52 6f 6f 74 3b MemPage *pRoot;
268d0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
268e0 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 TE_OK;.. assert
268f0 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
26900 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
26910 73 65 72 74 28 20 43 55 52 53 4f 52 5f 49 4e 56 sert( CURSOR_INV
26920 41 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f 52 45 ALID < CURSOR_RE
26930 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 QUIRESEEK );. a
26940 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 41 ssert( CURSOR_VA
26950 4c 49 44 20 20 20 3c 20 43 55 52 53 4f 52 5f 52 LID < CURSOR_R
26960 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
26970 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 46 assert( CURSOR_F
26980 41 55 4c 54 20 20 20 3e 20 43 55 52 53 4f 52 5f AULT > CURSOR_
26990 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 REQUIRESEEK );.
269a0 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 if( pCur->eStat
269b0 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 49 52 e>=CURSOR_REQUIR
269c0 45 53 45 45 4b 20 29 7b 0a 20 20 20 20 69 66 28 ESEEK ){. if(
269d0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
269e0 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a 20 URSOR_FAULT ){.
269f0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
26a00 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 51 4c r->skipNext!=SQL
26a10 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 ITE_OK );.
26a20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 return pCur->ski
26a30 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 20 pNext;. }.
26a40 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 sqlite3BtreeCle
26a50 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a arCursor(pCur);.
26a60 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 75 72 2d }.. if( pCur-
26a70 3e 69 50 61 67 65 3e 3d 30 20 29 7b 0a 20 20 20 >iPage>=0 ){.
26a80 20 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 69 50 while( pCur->iP
26a90 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 61 67 age ) releasePag
26aa0 65 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 e(pCur->apPage[p
26ab0 43 75 72 2d 3e 69 50 61 67 65 2d 2d 5d 29 3b 0a Cur->iPage--]);.
26ac0 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 75 72 }else if( pCur
26ad0 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 29 7b ->pgnoRoot==0 ){
26ae0 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 . pCur->eStat
26af0 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c e = CURSOR_INVAL
26b00 49 44 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ID;. return S
26b10 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 QLITE_OK;. }els
26b20 65 7b 0a 20 20 20 20 72 63 20 3d 20 67 65 74 41 e{. rc = getA
26b30 6e 64 49 6e 69 74 50 61 67 65 28 70 43 75 72 2d ndInitPage(pCur-
26b40 3e 70 42 74 72 65 65 2d 3e 70 42 74 2c 20 70 43 >pBtree->pBt, pC
26b50 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 2c 20 26 70 ur->pgnoRoot, &p
26b60 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2c 0a Cur->apPage[0],.
26b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26b80 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
26b90 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 & BTCF_WriteFla
26ba0 67 29 3d 3d 30 20 3f 20 50 41 47 45 52 5f 47 45 g)==0 ? PAGER_GE
26bb0 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 29 3b T_READONLY : 0);
26bc0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
26bd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
26be0 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
26bf0 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 URSOR_INVALID;.
26c00 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
26c10 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e }. pCur->
26c20 69 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 iPage = 0;. }.
26c30 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d 3e 61 pRoot = pCur->a
26c40 70 50 61 67 65 5b 30 5d 3b 0a 20 20 61 73 73 65 pPage[0];. asse
26c50 72 74 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 3d rt( pRoot->pgno=
26c60 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 =pCur->pgnoRoot
26c70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 43 75 72 );.. /* If pCur
26c80 2d 3e 70 4b 65 79 49 6e 66 6f 20 69 73 20 6e 6f ->pKeyInfo is no
26c90 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 t NULL, then the
26ca0 20 63 61 6c 6c 65 72 20 74 68 61 74 20 6f 70 65 caller that ope
26cb0 6e 65 64 20 74 68 69 73 20 63 75 72 73 6f 72 0a ned this cursor.
26cc0 20 20 2a 2a 20 65 78 70 65 63 74 65 64 20 74 6f ** expected to
26cd0 20 6f 70 65 6e 20 69 74 20 6f 6e 20 61 6e 20 69 open it on an i
26ce0 6e 64 65 78 20 62 2d 74 72 65 65 2e 20 4f 74 68 ndex b-tree. Oth
26cf0 65 72 77 69 73 65 2c 20 69 66 20 70 4b 65 79 49 erwise, if pKeyI
26d00 6e 66 6f 20 69 73 0a 20 20 2a 2a 20 4e 55 4c 4c nfo is. ** NULL
26d10 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 65 78 70 , the caller exp
26d20 65 63 74 73 20 61 20 74 61 62 6c 65 20 62 2d 74 ects a table b-t
26d30 72 65 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 ree. If this is
26d40 6e 6f 74 20 74 68 65 20 63 61 73 65 2c 0a 20 20 not the case,.
26d50 2a 2a 20 72 65 74 75 72 6e 20 61 6e 20 53 51 4c ** return an SQL
26d60 49 54 45 5f 43 4f 52 52 55 50 54 20 65 72 72 6f ITE_CORRUPT erro
26d70 72 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 r. . **. ** Ea
26d80 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 6f rlier versions o
26d90 66 20 53 51 4c 69 74 65 20 61 73 73 75 6d 65 64 f SQLite assumed
26da0 20 74 68 61 74 20 74 68 69 73 20 74 65 73 74 20 that this test
26db0 63 6f 75 6c 64 20 6e 6f 74 20 66 61 69 6c 0a 20 could not fail.
26dc0 20 2a 2a 20 69 66 20 74 68 65 20 72 6f 6f 74 20 ** if the root
26dd0 70 61 67 65 20 77 61 73 20 61 6c 72 65 61 64 79 page was already
26de0 20 6c 6f 61 64 65 64 20 77 68 65 6e 20 74 68 69 loaded when thi
26df0 73 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 s function was c
26e00 61 6c 6c 65 64 20 28 69 2e 65 2e 0a 20 20 2a 2a alled (i.e.. **
26e10 20 69 66 20 70 43 75 72 2d 3e 69 50 61 67 65 3e if pCur->iPage>
26e20 3d 30 29 2e 20 42 75 74 20 74 68 69 73 20 69 73 =0). But this is
26e30 20 6e 6f 74 20 73 6f 20 69 66 20 74 68 65 20 64 not so if the d
26e40 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 75 atabase is corru
26e50 70 74 65 64 20 0a 20 20 2a 2a 20 69 6e 20 73 75 pted . ** in su
26e60 63 68 20 61 20 77 61 79 20 74 68 61 74 20 70 61 ch a way that pa
26e70 67 65 20 70 52 6f 6f 74 20 69 73 20 6c 69 6e 6b ge pRoot is link
26e80 65 64 20 69 6e 74 6f 20 61 20 73 65 63 6f 6e 64 ed into a second
26e90 20 62 2d 74 72 65 65 20 74 61 62 6c 65 20 0a 20 b-tree table .
26ea0 20 2a 2a 20 28 6f 72 20 74 68 65 20 66 72 65 65 ** (or the free
26eb0 6c 69 73 74 29 2e 20 20 2a 2f 0a 20 20 61 73 73 list). */. ass
26ec0 65 72 74 28 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b ert( pRoot->intK
26ed0 65 79 3d 3d 31 20 7c 7c 20 70 52 6f 6f 74 2d 3e ey==1 || pRoot->
26ee0 69 6e 74 4b 65 79 3d 3d 30 20 29 3b 0a 20 20 69 intKey==0 );. i
26ef0 66 28 20 70 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 f( pRoot->isInit
26f00 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e 70 4b ==0 || (pCur->pK
26f10 65 79 49 6e 66 6f 3d 3d 30 29 21 3d 70 52 6f 6f eyInfo==0)!=pRoo
26f20 74 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 t->intKey ){.
26f30 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
26f40 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d ORRUPT_BKPT;. }
26f50 0a 0a 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b .. pCur->aiIdx[
26f60 30 5d 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 0] = 0;. pCur->
26f70 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
26f80 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
26f90 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c 61 73 &= ~(BTCF_AtLas
26fa0 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 t|BTCF_ValidNKey
26fb0 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 |BTCF_ValidOvfl)
26fc0 3b 0a 0a 20 20 69 66 28 20 70 52 6f 6f 74 2d 3e ;.. if( pRoot->
26fd0 6e 43 65 6c 6c 3e 30 20 29 7b 0a 20 20 20 20 70 nCell>0 ){. p
26fe0 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
26ff0 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 7d 65 RSOR_VALID;. }e
27000 6c 73 65 20 69 66 28 20 21 70 52 6f 6f 74 2d 3e lse if( !pRoot->
27010 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 6e 6f leaf ){. Pgno
27020 20 73 75 62 70 61 67 65 3b 0a 20 20 20 20 69 66 subpage;. if
27030 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 21 3d 31 ( pRoot->pgno!=1
27040 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
27050 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
27060 20 20 20 73 75 62 70 61 67 65 20 3d 20 67 65 74 subpage = get
27070 34 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e 61 44 4byte(&pRoot->aD
27080 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 4f 66 ata[pRoot->hdrOf
27090 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 43 fset+8]);. pC
270a0 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
270b0 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 72 SOR_VALID;. r
270c0 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
270d0 70 43 75 72 2c 20 73 75 62 70 61 67 65 29 3b 0a pCur, subpage);.
270e0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 75 }else{. pCu
270f0 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
27100 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 7d 0a OR_INVALID;. }.
27110 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
27120 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 /*.** Move the c
27130 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 68 ursor down to th
27140 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 61 66 e left-most leaf
27150 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 entry beneath t
27160 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f 20 77 he.** entry to w
27170 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 65 hich it is curre
27180 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 0a 2a ntly pointing..*
27190 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d 6d 6f *.** The left-mo
271a0 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 20 6f st leaf is the o
271b0 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d 61 6c ne with the smal
271c0 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 20 66 lest key - the f
271d0 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 65 6e irst.** in ascen
271e0 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 ding order..*/.s
271f0 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f tatic int moveTo
27200 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 73 6f Leftmost(BtCurso
27210 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f r *pCur){. Pgno
27220 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 pgno;. int rc
27230 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d = SQLITE_OK;. M
27240 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a emPage *pPage;..
27250 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
27260 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
27270 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27280 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
27290 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 77 68 OR_VALID );. wh
272a0 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ile( rc==SQLITE_
272b0 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 3d 20 OK && !(pPage =
272c0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
272d0 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 61 66 r->iPage])->leaf
272e0 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
272f0 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
27300 2d 3e 69 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e ->iPage]<pPage->
27310 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 70 67 6e nCell );. pgn
27320 6f 20 3d 20 67 65 74 34 62 79 74 65 28 66 69 6e o = get4byte(fin
27330 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 75 dCell(pPage, pCu
27340 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
27350 50 61 67 65 5d 29 29 3b 0a 20 20 20 20 72 63 20 Page]));. rc
27360 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 = moveToChild(pC
27370 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 ur, pgno);. }.
27380 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
27390 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 *.** Move the cu
273a0 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 68 65 rsor down to the
273b0 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 61 66 right-most leaf
273c0 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 entry beneath t
273d0 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 77 68 he.** page to wh
273e0 69 63 68 20 69 74 20 69 73 20 63 75 72 72 65 6e ich it is curren
273f0 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 20 20 4e tly pointing. N
27400 6f 74 69 63 65 20 74 68 65 20 64 69 66 66 65 72 otice the differ
27410 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 65 6e 20 ence.** between
27420 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 29 moveToLeftmost()
27430 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 67 68 74 and moveToRight
27440 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 54 6f 4c most(). moveToL
27450 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e eftmost().** fin
27460 64 73 20 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 ds the left-most
27470 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 entry beneath t
27480 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 65 72 65 he *entry* where
27490 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f as moveToRightmo
274a0 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 74 68 st().** finds th
274b0 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e 74 e right-most ent
274c0 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 20 2a ry beneath the *
274d0 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 page*..**.** The
274e0 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e 74 72 right-most entr
274f0 79 20 69 73 20 74 68 65 20 6f 6e 65 20 77 69 74 y is the one wit
27500 68 20 74 68 65 20 6c 61 72 67 65 73 74 20 6b 65 h the largest ke
27510 79 20 2d 20 74 68 65 20 6c 61 73 74 0a 2a 2a 20 y - the last.**
27520 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 key in ascending
27530 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 order..*/.stati
27540 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 69 67 68 c int moveToRigh
27550 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 20 2a tmost(BtCursor *
27560 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 70 67 pCur){. Pgno pg
27570 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 no;. int rc = S
27580 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 6d 50 QLITE_OK;. MemP
27590 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a age *pPage = 0;.
275a0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
275b0 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
275c0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
275d0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
275e0 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 77 SOR_VALID );. w
275f0 68 69 6c 65 28 20 21 28 70 50 61 67 65 20 3d 20 hile( !(pPage =
27600 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27610 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 61 66 r->iPage])->leaf
27620 20 29 7b 0a 20 20 20 20 70 67 6e 6f 20 3d 20 67 ){. pgno = g
27630 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e et4byte(&pPage->
27640 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 aData[pPage->hdr
27650 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 Offset+8]);.
27660 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
27670 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 67 65 ->iPage] = pPage
27680 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 72 63 20 ->nCell;. rc
27690 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 = moveToChild(pC
276a0 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 69 ur, pgno);. i
276b0 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
276c0 63 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 61 c;. }. pCur->a
276d0 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
276e0 5d 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c ] = pPage->nCell
276f0 2d 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 -1;. assert( pC
27700 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d ur->info.nSize==
27710 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 0 );. assert( (
27720 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
27730 20 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 BTCF_ValidNKey)
27740 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 ==0 );. return
27750 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
27760 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 Move the cursor
27770 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 6e to the first en
27780 74 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 try in the table
27790 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 . Return SQLITE
277a0 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 73 _OK.** on succes
277b0 73 2e 20 20 53 65 74 20 2a 70 52 65 73 20 74 6f s. Set *pRes to
277c0 20 30 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 0 if the cursor
277d0 20 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e 74 73 actually points
277e0 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 2a 2a to something.**
277f0 20 6f 72 20 73 65 74 20 2a 70 52 65 73 20 74 6f or set *pRes to
27800 20 31 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 1 if the table
27810 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 is empty..*/.int
27820 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 69 72 sqlite3BtreeFir
27830 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 st(BtCursor *pCu
27840 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
27850 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
27860 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d rt( cursorHoldsM
27870 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 utex(pCur) );.
27880 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
27890 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
278a0 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
278b0 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 6d 6f ex) );. rc = mo
278c0 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a veToRoot(pCur);.
278d0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
278e0 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
278f0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
27900 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a 20 SOR_INVALID ){.
27910 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
27920 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c r->pgnoRoot==0 |
27930 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 | pCur->apPage[p
27940 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 Cur->iPage]->nCe
27950 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a ll==0 );. *
27960 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d 65 pRes = 1;. }e
27970 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
27980 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t( pCur->apPage[
27990 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
279a0 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 20 20 2a ell>0 );. *
279b0 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 pRes = 0;.
279c0 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 74 6d rc = moveToLeftm
279d0 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 7d ost(pCur);. }
279e0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
279f0 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 ;.}../* Move the
27a00 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6c cursor to the l
27a10 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ast entry in the
27a20 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 table. Return
27a30 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 SQLITE_OK.** on
27a40 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 success. Set *p
27a50 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 Res to 0 if the
27a60 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 cursor actually
27a70 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 points to someth
27a80 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 ing.** or set *p
27a90 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 Res to 1 if the
27aa0 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a table is empty..
27ab0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
27ac0 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 6f 72 reeLast(BtCursor
27ad0 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 *pCur, int *pRe
27ae0 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 0a s){. int rc;. .
27af0 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
27b00 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
27b10 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
27b20 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
27b30 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 (pCur->pBtree->d
27b40 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 b->mutex) );..
27b50 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 /* If the cursor
27b60 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 73 20 already points
27b70 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 to the last entr
27b80 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d y, this is a no-
27b90 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 55 52 op. */. if( CUR
27ba0 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 2d SOR_VALID==pCur-
27bb0 3e 65 53 74 61 74 65 20 26 26 20 28 70 43 75 72 >eState && (pCur
27bc0 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
27bd0 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 7b 0a F_AtLast)!=0 ){.
27be0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
27bf0 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 BUG. /* This
27c00 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 6f 20 block serves to
27c10 61 73 73 65 72 74 28 29 20 74 68 61 74 20 74 68 assert() that th
27c20 65 20 63 75 72 73 6f 72 20 72 65 61 6c 6c 79 20 e cursor really
27c30 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 20 20 does point .
27c40 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 ** to the last e
27c50 6e 74 72 79 20 69 6e 20 74 68 65 20 62 2d 74 72 ntry in the b-tr
27c60 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ee. */. int i
27c70 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 3b i;. for(ii=0;
27c80 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 65 3b ii<pCur->iPage;
27c90 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 73 ii++){. as
27ca0 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 sert( pCur->aiId
27cb0 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 70 50 x[ii]==pCur->apP
27cc0 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c 20 29 age[ii]->nCell )
27cd0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
27ce0 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b rt( pCur->aiIdx[
27cf0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d 70 43 pCur->iPage]==pC
27d00 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
27d10 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 2d 31 >iPage]->nCell-1
27d20 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
27d30 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27d40 72 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 66 20 r->iPage]->leaf
27d50 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 );.#endif. re
27d60 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
27d70 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d 6f 76 65 }.. rc = move
27d80 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a 20 20 ToRoot(pCur);.
27d90 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
27da0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 43 55 52 K ){. if( CUR
27db0 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 SOR_INVALID==pCu
27dc0 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 20 r->eState ){.
27dd0 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
27de0 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 >pgnoRoot==0 ||
27df0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27e00 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
27e10 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a 70 52 ==0 );. *pR
27e20 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 es = 1;. }els
27e30 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 e{. assert(
27e40 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
27e50 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
27e60 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a *pRes = 0;.
27e70 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 rc = moveT
27e80 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 72 29 oRightmost(pCur)
27e90 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
27ea0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
27eb0 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c pCur->curFl
27ec0 61 67 73 20 7c 3d 20 42 54 43 46 5f 41 74 4c 61 ags |= BTCF_AtLa
27ed0 73 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b st;. }else{
27ee0 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 . pCur->c
27ef0 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 46 urFlags &= ~BTCF
27f00 5f 41 74 4c 61 73 74 3b 0a 20 20 20 20 20 20 7d _AtLast;. }
27f10 0a 20 20 20 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 . . }. }.
27f20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
27f30 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f * Move the curso
27f40 72 20 73 6f 20 74 68 61 74 20 69 74 20 70 6f 69 r so that it poi
27f50 6e 74 73 20 74 6f 20 61 6e 20 65 6e 74 72 79 20 nts to an entry
27f60 6e 65 61 72 20 74 68 65 20 6b 65 79 20 0a 2a 2a near the key .**
27f70 20 73 70 65 63 69 66 69 65 64 20 62 79 20 70 49 specified by pI
27f80 64 78 4b 65 79 20 6f 72 20 69 6e 74 4b 65 79 2e dxKey or intKey.
27f90 20 20 20 52 65 74 75 72 6e 20 61 20 73 75 63 63 Return a succ
27fa0 65 73 73 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 ess code..**.**
27fb0 46 6f 72 20 49 4e 54 4b 45 59 20 74 61 62 6c 65 For INTKEY table
27fc0 73 2c 20 74 68 65 20 69 6e 74 4b 65 79 20 70 61 s, the intKey pa
27fd0 72 61 6d 65 74 65 72 20 69 73 20 75 73 65 64 2e rameter is used.
27fe0 20 20 70 49 64 78 4b 65 79 20 0a 2a 2a 20 6d 75 pIdxKey .** mu
27ff0 73 74 20 62 65 20 4e 55 4c 4c 2e 20 20 46 6f 72 st be NULL. For
28000 20 69 6e 64 65 78 20 74 61 62 6c 65 73 2c 20 70 index tables, p
28010 49 64 78 4b 65 79 20 69 73 20 75 73 65 64 20 61 IdxKey is used a
28020 6e 64 20 69 6e 74 4b 65 79 0a 2a 2a 20 69 73 20 nd intKey.** is
28030 69 67 6e 6f 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 ignored..**.** I
28040 66 20 61 6e 20 65 78 61 63 74 20 6d 61 74 63 68 f an exact match
28050 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c 20 74 is not found, t
28060 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 69 hen the cursor i
28070 73 20 61 6c 77 61 79 73 0a 2a 2a 20 6c 65 66 74 s always.** left
28080 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 20 6c pointing at a l
28090 65 61 66 20 70 61 67 65 20 77 68 69 63 68 20 77 eaf page which w
280a0 6f 75 6c 64 20 68 6f 6c 64 20 74 68 65 20 65 6e ould hold the en
280b0 74 72 79 20 69 66 20 69 74 0a 2a 2a 20 77 65 72 try if it.** wer
280c0 65 20 70 72 65 73 65 6e 74 2e 20 20 54 68 65 20 e present. The
280d0 63 75 72 73 6f 72 20 6d 69 67 68 74 20 70 6f 69 cursor might poi
280e0 6e 74 20 74 6f 20 61 6e 20 65 6e 74 72 79 20 74 nt to an entry t
280f0 68 61 74 20 63 6f 6d 65 73 0a 2a 2a 20 62 65 66 hat comes.** bef
28100 6f 72 65 20 6f 72 20 61 66 74 65 72 20 74 68 65 ore or after the
28110 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 69 key..**.** An i
28120 6e 74 65 67 65 72 20 69 73 20 77 72 69 74 74 65 nteger is writte
28130 6e 20 69 6e 74 6f 20 2a 70 52 65 73 20 77 68 69 n into *pRes whi
28140 63 68 20 69 73 20 74 68 65 20 72 65 73 75 6c 74 ch is the result
28150 20 6f 66 0a 2a 2a 20 63 6f 6d 70 61 72 69 6e 67 of.** comparing
28160 20 74 68 65 20 6b 65 79 20 77 69 74 68 20 74 68 the key with th
28170 65 20 65 6e 74 72 79 20 74 6f 20 77 68 69 63 68 e entry to which
28180 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 0a the cursor is .
28190 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 20 54 68 ** pointing. Th
281a0 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 65 e meaning of the
281b0 20 69 6e 74 65 67 65 72 20 77 72 69 74 74 65 6e integer written
281c0 20 69 6e 74 6f 0a 2a 2a 20 2a 70 52 65 73 20 69 into.** *pRes i
281d0 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a s as follows:.**
281e0 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3c 30 20 .** *pRes<0
281f0 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 20 The cursor
28200 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e 67 is left pointing
28210 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 61 at an entry tha
28220 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 t.**
28230 20 20 20 20 20 20 69 73 20 73 6d 61 6c 6c 65 72 is smaller
28240 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 64 than intKey/pId
28250 78 4b 65 79 20 6f 72 20 69 66 20 74 68 65 20 74 xKey or if the t
28260 61 62 6c 65 20 69 73 20 65 6d 70 74 79 0a 2a 2a able is empty.**
28270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28280 20 20 61 6e 64 20 74 68 65 20 63 75 72 73 6f 72 and the cursor
28290 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 6c 65 is therefore le
282a0 66 74 20 70 6f 69 6e 74 20 74 6f 20 6e 6f 74 68 ft point to noth
282b0 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a ing..**.** *
282c0 70 52 65 73 3d 3d 30 20 20 20 20 20 54 68 65 20 pRes==0 The
282d0 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 20 70 cursor is left p
282e0 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e ointing at an en
282f0 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 try that.**
28300 20 20 20 20 20 20 20 20 20 20 20 20 20 65 78 61 exa
28310 63 74 6c 79 20 6d 61 74 63 68 65 73 20 69 6e 74 ctly matches int
28320 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a 2a 0a Key/pIdxKey..**.
28330 2a 2a 20 20 20 20 20 2a 70 52 65 73 3e 30 20 20 ** *pRes>0
28340 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 20 69 The cursor i
28350 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e 67 20 s left pointing
28360 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 61 74 at an entry that
28370 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
28380 20 20 20 20 20 69 73 20 6c 61 72 67 65 72 20 74 is larger t
28390 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 64 78 4b han intKey/pIdxK
283a0 65 79 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 ey..**.*/.int sq
283b0 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f lite3BtreeMoveto
283c0 55 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 43 75 Unpacked(. BtCu
283d0 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 rsor *pCur,
283e0 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73 /* The curs
283f0 6f 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 20 2a or to be moved *
28400 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f /. UnpackedReco
28410 72 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f 2a 20 rd *pIdxKey, /*
28420 55 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 20 6b Unpacked index k
28430 65 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e 74 4b ey */. i64 intK
28440 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ey,
28450 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 6b 65 /* The table ke
28460 79 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 52 y */. int biasR
28470 69 67 68 74 2c 20 20 20 20 20 20 20 20 20 20 20 ight,
28480 2f 2a 20 49 66 20 74 72 75 65 2c 20 62 69 61 73 /* If true, bias
28490 20 74 68 65 20 73 65 61 72 63 68 20 74 6f 20 74 the search to t
284a0 68 65 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 he high end */.
284b0 20 69 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 int *pRes
284c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 /* Wri
284d0 74 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 te search result
284e0 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 s here */.){. i
284f0 6e 74 20 72 63 3b 0a 20 20 52 65 63 6f 72 64 43 nt rc;. RecordC
28500 6f 6d 70 61 72 65 20 78 52 65 63 6f 72 64 43 6f ompare xRecordCo
28510 6d 70 61 72 65 3b 0a 0a 20 20 61 73 73 65 72 74 mpare;.. assert
28520 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
28530 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
28540 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
28550 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 tex_held(pCur->p
28560 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 Btree->db->mutex
28570 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
28580 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 74 28 Res );. assert(
28590 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 (pIdxKey==0)==(
285a0 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d 3d pCur->pKeyInfo==
285b0 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 0) );.. /* If t
285c0 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 he cursor is alr
285d0 65 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 64 20 eady positioned
285e0 61 74 20 74 68 65 20 70 6f 69 6e 74 20 77 65 20 at the point we
285f0 61 72 65 20 74 72 79 69 6e 67 0a 20 20 2a 2a 20 are trying. **
28600 74 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 65 6e to move to, then
28610 20 6a 75 73 74 20 72 65 74 75 72 6e 20 77 69 74 just return wit
28620 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 20 77 hout doing any w
28630 6f 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 43 75 ork */. if( pCu
28640 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
28650 52 5f 56 41 4c 49 44 20 26 26 20 28 70 43 75 72 R_VALID && (pCur
28660 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
28670 46 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d 30 0a F_ValidNKey)!=0.
28680 20 20 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 && pCur->apPa
28690 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 0a 20 ge[0]->intKey .
286a0 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 ){. if( pCur
286b0 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e 74 ->info.nKey==int
286c0 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 Key ){. *pR
286d0 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 es = 0;. re
286e0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
286f0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 28 70 }. if( (p
28700 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 Cur->curFlags &
28710 42 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 BTCF_AtLast)!=0
28720 26 26 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b && pCur->info.nK
28730 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 ey<intKey ){.
28740 20 20 20 2a 70 52 65 73 20 3d 20 2d 31 3b 0a 20 *pRes = -1;.
28750 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
28760 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d TE_OK;. }. }
28770 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 20 .. if( pIdxKey
28780 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 6f ){. xRecordCo
28790 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 33 56 mpare = sqlite3V
287a0 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 28 70 dbeFindCompare(p
287b0 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 49 64 IdxKey);. pId
287c0 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 3d 20 xKey->errCode =
287d0 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 0;. assert( p
287e0 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c 74 5f IdxKey->default_
287f0 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 20 20 rc==1 .
28800 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 || pIdxKey->defa
28810 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 20 20 ult_rc==0 .
28820 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e || pIdxKey->
28830 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 0a 20 default_rc==-1.
28840 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 );. }else{.
28850 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 xRecordCompar
28860 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 6b 65 e = 0; /* All ke
28870 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 73 20 ys are integers
28880 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d */. }.. rc = m
28890 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b oveToRoot(pCur);
288a0 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 . if( rc ){.
288b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
288c0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
288d0 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 pgnoRoot==0 || p
288e0 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
288f0 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 73 ->iPage] );. as
28900 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f sert( pCur->pgno
28910 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Root==0 || pCur-
28920 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
28930 61 67 65 5d 2d 3e 69 73 49 6e 69 74 20 29 3b 0a age]->isInit );.
28940 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
28950 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 eState==CURSOR_I
28960 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e NVALID || pCur->
28970 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
28980 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a ge]->nCell>0 );.
28990 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
289a0 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c te==CURSOR_INVAL
289b0 49 44 20 29 7b 0a 20 20 20 20 2a 70 52 65 73 20 ID ){. *pRes
289c0 3d 20 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 74 = -1;. assert
289d0 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 ( pCur->pgnoRoot
289e0 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 ==0 || pCur->apP
289f0 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
28a00 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 ->nCell==0 );.
28a10 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
28a20 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 OK;. }. assert
28a30 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 ( pCur->apPage[0
28a40 5d 2d 3e 69 6e 74 4b 65 79 20 7c 7c 20 70 49 64 ]->intKey || pId
28a50 78 4b 65 79 20 29 3b 0a 20 20 66 6f 72 28 3b 3b xKey );. for(;;
28a60 29 7b 0a 20 20 20 20 69 6e 74 20 6c 77 72 2c 20 ){. int lwr,
28a70 75 70 72 2c 20 69 64 78 2c 20 63 3b 0a 20 20 20 upr, idx, c;.
28a80 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b 0a 20 20 Pgno chldPg;.
28a90 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
28aa0 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
28ab0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
28ac0 20 20 75 38 20 2a 70 43 65 6c 6c 3b 20 20 20 20 u8 *pCell;
28ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28ae0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
28af0 20 74 6f 20 63 75 72 72 65 6e 74 20 63 65 6c 6c to current cell
28b00 20 69 6e 20 70 50 61 67 65 20 2a 2f 0a 0a 20 20 in pPage */..
28b10 20 20 2f 2a 20 70 50 61 67 65 2d 3e 6e 43 65 6c /* pPage->nCel
28b20 6c 20 6d 75 73 74 20 62 65 20 67 72 65 61 74 65 l must be greate
28b30 72 20 74 68 61 6e 20 7a 65 72 6f 2e 20 49 66 20 r than zero. If
28b40 74 68 69 73 20 69 73 20 74 68 65 20 72 6f 6f 74 this is the root
28b50 2d 70 61 67 65 0a 20 20 20 20 2a 2a 20 74 68 65 -page. ** the
28b60 20 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 68 61 cursor would ha
28b70 76 65 20 62 65 65 6e 20 49 4e 56 41 4c 49 44 20 ve been INVALID
28b80 61 62 6f 76 65 20 61 6e 64 20 74 68 69 73 20 66 above and this f
28b90 6f 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 20 20 20 or(;;) loop.
28ba0 2a 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 66 20 74 ** not run. If t
28bb0 68 69 73 20 69 73 20 6e 6f 74 20 74 68 65 20 72 his is not the r
28bc0 6f 6f 74 2d 70 61 67 65 2c 20 74 68 65 6e 20 74 oot-page, then t
28bd0 68 65 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 he moveToChild()
28be0 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a 2a 20 routine. **
28bf0 77 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 would have alrea
28c00 64 79 20 64 65 74 65 63 74 65 64 20 64 62 20 63 dy detected db c
28c10 6f 72 72 75 70 74 69 6f 6e 2e 20 53 69 6d 69 6c orruption. Simil
28c20 61 72 6c 79 2c 20 70 50 61 67 65 20 6d 75 73 74 arly, pPage must
28c30 0a 20 20 20 20 2a 2a 20 62 65 20 74 68 65 20 72 . ** be the r
28c40 69 67 68 74 20 6b 69 6e 64 20 28 69 6e 64 65 78 ight kind (index
28c50 20 6f 72 20 74 61 62 6c 65 29 20 6f 66 20 62 2d or table) of b-
28c60 74 72 65 65 20 70 61 67 65 2e 20 4f 74 68 65 72 tree page. Other
28c70 77 69 73 65 0a 20 20 20 20 2a 2a 20 61 20 6d 6f wise. ** a mo
28c80 76 65 54 6f 43 68 69 6c 64 28 29 20 6f 72 20 6d veToChild() or m
28c90 6f 76 65 54 6f 52 6f 6f 74 28 29 20 63 61 6c 6c oveToRoot() call
28ca0 20 77 6f 75 6c 64 20 68 61 76 65 20 64 65 74 65 would have dete
28cb0 63 74 65 64 20 63 6f 72 72 75 70 74 69 6f 6e 2e cted corruption.
28cc0 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 */. assert(
28cd0 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 pPage->nCell>0
28ce0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
28cf0 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 28 70 Page->intKey==(p
28d00 49 64 78 4b 65 79 3d 3d 30 29 20 29 3b 0a 20 20 IdxKey==0) );.
28d10 20 20 6c 77 72 20 3d 20 30 3b 0a 20 20 20 20 75 lwr = 0;. u
28d20 70 72 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c pr = pPage->nCel
28d30 6c 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 74 28 l-1;. assert(
28d40 20 62 69 61 73 52 69 67 68 74 3d 3d 30 20 7c 7c biasRight==0 ||
28d50 20 62 69 61 73 52 69 67 68 74 3d 3d 31 20 29 3b biasRight==1 );
28d60 0a 20 20 20 20 69 64 78 20 3d 20 75 70 72 3e 3e . idx = upr>>
28d70 28 31 2d 62 69 61 73 52 69 67 68 74 29 3b 20 2f (1-biasRight); /
28d80 2a 20 69 64 78 20 3d 20 62 69 61 73 52 69 67 68 * idx = biasRigh
28d90 74 20 3f 20 75 70 72 20 3a 20 28 6c 77 72 2b 75 t ? upr : (lwr+u
28da0 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 70 43 pr)/2; */. pC
28db0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
28dc0 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 iPage] = (u16)id
28dd0 78 3b 0a 20 20 20 20 69 66 28 20 78 52 65 63 6f x;. if( xReco
28de0 72 64 43 6f 6d 70 61 72 65 3d 3d 30 20 29 7b 0a rdCompare==0 ){.
28df0 20 20 20 20 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 for(;;){.
28e00 20 20 20 20 20 20 20 69 36 34 20 6e 43 65 6c 6c i64 nCell
28e10 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 70 43 65 Key;. pCe
28e20 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 ll = findCell(pP
28e30 61 67 65 2c 20 69 64 78 29 20 2b 20 70 50 61 67 age, idx) + pPag
28e40 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
28e50 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50 61 . if( pPa
28e60 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 ge->intKeyLeaf )
28e70 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c {. whil
28e80 65 28 20 30 78 38 30 20 3c 3d 20 2a 28 70 43 65 e( 0x80 <= *(pCe
28e90 6c 6c 2b 2b 29 20 29 7b 0a 20 20 20 20 20 20 20 ll++) ){.
28ea0 20 20 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 3d if( pCell>=
28eb0 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
28ec0 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
28ed0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
28ee0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
28ef0 20 20 7d 0a 20 20 20 20 20 20 20 20 67 65 74 56 }. getV
28f00 61 72 69 6e 74 28 70 43 65 6c 6c 2c 20 28 75 36 arint(pCell, (u6
28f10 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 4*)&nCellKey);.
28f20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c if( nCell
28f30 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 Key<intKey ){.
28f40 20 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 lwr = id
28f50 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 20 20 69 x+1;. i
28f60 66 28 20 6c 77 72 3e 75 70 72 20 29 7b 20 63 20 f( lwr>upr ){ c
28f70 3d 20 2d 31 3b 20 62 72 65 61 6b 3b 20 7d 0a 20 = -1; break; }.
28f80 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 }else if(
28f90 20 6e 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b 65 79 nCellKey>intKey
28fa0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 70 ){. up
28fb0 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 r = idx-1;.
28fc0 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 if( lwr>upr
28fd0 20 29 7b 20 63 20 3d 20 2b 31 3b 20 62 72 65 61 ){ c = +1; brea
28fe0 6b 3b 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c k; }. }el
28ff0 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 se{. as
29000 73 65 72 74 28 20 6e 43 65 6c 6c 4b 65 79 3d 3d sert( nCellKey==
29010 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 intKey );.
29020 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 pCur->curFla
29030 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c 69 64 gs |= BTCF_Valid
29040 4e 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 NKey;.
29050 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 20 pCur->info.nKey
29060 3d 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 = nCellKey;.
29070 20 20 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 pCur->aiId
29080 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d x[pCur->iPage] =
29090 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 (u16)idx;.
290a0 20 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d if( !pPage-
290b0 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 20 >leaf ){.
290c0 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 3b 0a lwr = idx;.
290d0 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f goto
290e0 20 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c 61 79 moveto_next_lay
290f0 65 72 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 er;. }e
29100 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 lse{.
29110 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
29120 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
29130 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 ITE_OK;.
29140 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f goto moveto_
29150 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 finish;.
29160 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
29170 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 77 assert( lw
29180 72 2b 75 70 72 3e 3d 30 20 29 3b 0a 20 20 20 20 r+upr>=0 );.
29190 20 20 20 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 idx = (lwr+u
291a0 70 72 29 3e 3e 31 3b 20 20 2f 2a 20 69 64 78 20 pr)>>1; /* idx
291b0 3d 20 28 6c 77 72 2b 75 70 72 29 2f 32 3b 20 2a = (lwr+upr)/2; *
291c0 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 /. }. }e
291d0 6c 73 65 7b 0a 20 20 20 20 20 20 66 6f 72 28 3b lse{. for(;
291e0 3b 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 ;){. int
291f0 6e 43 65 6c 6c 3b 0a 20 20 20 20 20 20 20 20 70 nCell;. p
29200 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 Cell = findCell(
29210 70 50 61 67 65 2c 20 69 64 78 29 20 2b 20 70 50 pPage, idx) + pP
29220 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
29230 65 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 e;.. /* T
29240 68 65 20 6d 61 78 69 6d 75 6d 20 73 75 70 70 6f he maximum suppo
29250 72 74 65 64 20 70 61 67 65 2d 73 69 7a 65 20 69 rted page-size i
29260 73 20 36 35 35 33 36 20 62 79 74 65 73 2e 20 54 s 65536 bytes. T
29270 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 his means that.
29280 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 ** the ma
29290 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 ximum number of
292a0 72 65 63 6f 72 64 20 62 79 74 65 73 20 73 74 6f record bytes sto
292b0 72 65 64 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 red on an index
292c0 42 2d 54 72 65 65 0a 20 20 20 20 20 20 20 20 2a B-Tree. *
292d0 2a 20 70 61 67 65 20 69 73 20 6c 65 73 73 20 74 * page is less t
292e0 68 61 6e 20 31 36 33 38 34 20 62 79 74 65 73 20 han 16384 bytes
292f0 61 6e 64 20 6d 61 79 20 62 65 20 73 74 6f 72 65 and may be store
29300 64 20 61 73 20 61 20 32 2d 62 79 74 65 0a 20 20 d as a 2-byte.
29310 20 20 20 20 20 20 2a 2a 20 76 61 72 69 6e 74 2e ** varint.
29320 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f This informatio
29330 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 74 74 n is used to att
29340 65 6d 70 74 20 74 6f 20 61 76 6f 69 64 20 70 61 empt to avoid pa
29350 72 73 69 6e 67 20 0a 20 20 20 20 20 20 20 20 2a rsing . *
29360 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 65 6c * the entire cel
29370 6c 20 62 79 20 63 68 65 63 6b 69 6e 67 20 66 6f l by checking fo
29380 72 20 74 68 65 20 63 61 73 65 73 20 77 68 65 72 r the cases wher
29390 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 e the record is
293a0 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 . ** stor
293b0 65 64 20 65 6e 74 69 72 65 6c 79 20 77 69 74 68 ed entirely with
293c0 69 6e 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 in the b-tree pa
293d0 67 65 20 62 79 20 69 6e 73 70 65 63 74 69 6e 67 ge by inspecting
293e0 20 74 68 65 20 66 69 72 73 74 20 0a 20 20 20 20 the first .
293f0 20 20 20 20 2a 2a 20 32 20 62 79 74 65 73 20 6f ** 2 bytes o
29400 66 20 74 68 65 20 63 65 6c 6c 2e 0a 20 20 20 20 f the cell..
29410 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6e */. n
29420 43 65 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 5d 3b Cell = pCell[0];
29430 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 . if( nCe
29440 6c 6c 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 31 62 ll<=pPage->max1b
29450 79 74 65 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 ytePayload ){.
29460 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 /* This
29470 62 72 61 6e 63 68 20 72 75 6e 73 20 69 66 20 74 branch runs if t
29480 68 65 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 he record-size f
29490 69 65 6c 64 20 6f 66 20 74 68 65 20 63 65 6c 6c ield of the cell
294a0 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 is a.
294b0 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 65 20 76 ** single byte v
294c0 61 72 69 6e 74 20 61 6e 64 20 74 68 65 20 72 65 arint and the re
294d0 63 6f 72 64 20 66 69 74 73 20 65 6e 74 69 72 65 cord fits entire
294e0 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 ly on the main.
294f0 20 20 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 ** b-tr
29500 65 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 ee page. */.
29510 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
29520 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d pCell+nCell+1==
29530 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
29540 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d );. c =
29550 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 xRecordCompare(
29560 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 nCell, (void*)&p
29570 43 65 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b 65 79 Cell[1], pIdxKey
29580 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 );. }else
29590 20 69 66 28 20 21 28 70 43 65 6c 6c 5b 31 5d 20 if( !(pCell[1]
295a0 26 20 30 78 38 30 29 20 0a 20 20 20 20 20 20 20 & 0x80) .
295b0 20 20 20 26 26 20 28 6e 43 65 6c 6c 20 3d 20 28 && (nCell = (
295c0 28 6e 43 65 6c 6c 26 30 78 37 66 29 3c 3c 37 29 (nCell&0x7f)<<7)
295d0 20 2b 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 70 50 + pCell[1])<=pP
295e0 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a 20 20 age->maxLocal.
295f0 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
29600 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 /* The record
29610 2d 73 69 7a 65 20 66 69 65 6c 64 20 69 73 20 61 -size field is a
29620 20 32 20 62 79 74 65 20 76 61 72 69 6e 74 20 61 2 byte varint a
29630 6e 64 20 74 68 65 20 72 65 63 6f 72 64 20 0a 20 nd the record .
29640 20 20 20 20 20 20 20 20 20 2a 2a 20 66 69 74 73 ** fits
29650 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 entirely on the
29660 20 6d 61 69 6e 20 62 2d 74 72 65 65 20 70 61 67 main b-tree pag
29670 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 e. */.
29680 20 74 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c testcase( pCell
29690 2b 6e 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d +nCell+2==pPage-
296a0 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 >aDataEnd );.
296b0 20 20 20 20 20 20 20 63 20 3d 20 78 52 65 63 6f c = xReco
296c0 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c rdCompare(nCell,
296d0 20 28 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 32 (void*)&pCell[2
296e0 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 ], pIdxKey);.
296f0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
29700 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 /* The rec
29710 6f 72 64 20 66 6c 6f 77 73 20 6f 76 65 72 20 6f ord flows over o
29720 6e 74 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 nto one or more
29730 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 overflow pages.
29740 49 6e 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 In. **
29750 74 68 69 73 20 63 61 73 65 20 74 68 65 20 77 68 this case the wh
29760 6f 6c 65 20 63 65 6c 6c 20 6e 65 65 64 73 20 74 ole cell needs t
29770 6f 20 62 65 20 70 61 72 73 65 64 2c 20 61 20 62 o be parsed, a b
29780 75 66 66 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a uffer allocated.
29790 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 ** and
297a0 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 accessPayload()
297b0 20 75 73 65 64 20 74 6f 20 72 65 74 72 69 65 76 used to retriev
297c0 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 6e 74 e the record int
297d0 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 o the.
297e0 2a 2a 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 ** buffer before
297f0 20 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 VdbeRecordCompa
29800 72 65 28 29 20 63 61 6e 20 62 65 20 63 61 6c 6c re() can be call
29810 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 ed. */.
29820 20 76 6f 69 64 20 2a 70 43 65 6c 6c 4b 65 79 3b void *pCellKey;
29830 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 2a 20 . u8 *
29840 63 6f 6e 73 74 20 70 43 65 6c 6c 42 6f 64 79 20 const pCellBody
29850 3d 20 70 43 65 6c 6c 20 2d 20 70 50 61 67 65 2d = pCell - pPage-
29860 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 >childPtrSize;.
29870 20 20 20 20 20 20 20 20 20 62 74 72 65 65 50 61 btreePa
29880 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 rseCellPtr(pPage
29890 2c 20 70 43 65 6c 6c 42 6f 64 79 2c 20 26 70 43 , pCellBody, &pC
298a0 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 20 20 20 ur->info);.
298b0 20 20 20 20 20 6e 43 65 6c 6c 20 3d 20 28 69 6e nCell = (in
298c0 74 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 t)pCur->info.nKe
298d0 79 3b 0a 20 20 20 20 20 20 20 20 20 20 70 43 65 y;. pCe
298e0 6c 6c 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 4d llKey = sqlite3M
298f0 61 6c 6c 6f 63 28 20 6e 43 65 6c 6c 20 29 3b 0a alloc( nCell );.
29900 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 if( pC
29910 65 6c 6c 4b 65 79 3d 3d 30 20 29 7b 0a 20 20 20 ellKey==0 ){.
29920 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
29930 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
29940 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
29950 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 eto_finish;.
29960 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
29970 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
29980 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 ur->iPage] = (u1
29990 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 6)idx;.
299a0 20 72 63 20 3d 20 61 63 63 65 73 73 50 61 79 6c rc = accessPayl
299b0 6f 61 64 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 oad(pCur, 0, nCe
299c0 6c 6c 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 ll, (unsigned ch
299d0 61 72 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 32 29 ar*)pCellKey, 2)
299e0 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
299f0 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 rc ){.
29a00 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
29a10 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 20 20 CellKey);.
29a20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
29a30 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 o_finish;.
29a40 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
29a50 63 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 c = xRecordCompa
29a60 72 65 28 6e 43 65 6c 6c 2c 20 70 43 65 6c 6c 4b re(nCell, pCellK
29a70 65 79 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 ey, pIdxKey);.
29a80 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
29a90 66 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3b 0a free(pCellKey);.
29aa0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
29ab0 20 20 61 73 73 65 72 74 28 20 0a 20 20 20 20 20 assert( .
29ac0 20 20 20 20 20 20 20 28 70 49 64 78 4b 65 79 2d (pIdxKey-
29ad0 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 45 >errCode!=SQLITE
29ae0 5f 43 4f 52 52 55 50 54 20 7c 7c 20 63 3d 3d 30 _CORRUPT || c==0
29af0 29 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 70 ). && (p
29b00 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 21 IdxKey->errCode!
29b10 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c =SQLITE_NOMEM ||
29b20 20 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 pCur->pBtree->d
29b30 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 29 b->mallocFailed)
29b40 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 . );.
29b50 20 20 20 20 69 66 28 20 63 3c 30 20 29 7b 0a 20 if( c<0 ){.
29b60 20 20 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 lwr = i
29b70 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 7d 65 dx+1;. }e
29b80 6c 73 65 20 69 66 28 20 63 3e 30 20 29 7b 0a 20 lse if( c>0 ){.
29b90 20 20 20 20 20 20 20 20 20 75 70 72 20 3d 20 69 upr = i
29ba0 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 20 7d 65 dx-1;. }e
29bb0 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 61 lse{. a
29bc0 73 73 65 72 74 28 20 63 3d 3d 30 20 29 3b 0a 20 ssert( c==0 );.
29bd0 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d *pRes =
29be0 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 0;. rc
29bf0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
29c00 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 69 pCur->ai
29c10 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
29c20 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 = (u16)idx;.
29c30 20 20 20 20 20 20 20 69 66 28 20 70 49 64 78 4b if( pIdxK
29c40 65 79 2d 3e 65 72 72 43 6f 64 65 20 29 20 72 63 ey->errCode ) rc
29c50 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
29c60 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 T;. got
29c70 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b o moveto_finish;
29c80 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
29c90 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 if( lwr>upr )
29ca0 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
29cb0 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 72 3e assert( lwr+upr>
29cc0 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 64 =0 );. id
29cd0 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e 3e 31 x = (lwr+upr)>>1
29ce0 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c 77 72 ; /* idx = (lwr
29cf0 2b 75 70 72 29 2f 32 20 2a 2f 0a 20 20 20 20 20 +upr)/2 */.
29d00 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 }. }. ass
29d10 65 72 74 28 20 6c 77 72 3d 3d 75 70 72 2b 31 20 ert( lwr==upr+1
29d20 7c 7c 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 || (pPage->intKe
29d30 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 y && !pPage->lea
29d40 66 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 f) );. assert
29d50 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 ( pPage->isInit
29d60 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 );. if( pPage
29d70 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 ->leaf ){.
29d80 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
29d90 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
29da0 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 <pCur->apPage[pC
29db0 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c ur->iPage]->nCel
29dc0 6c 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d l );. pCur-
29dd0 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
29de0 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b 0a ge] = (u16)idx;.
29df0 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 63 3b *pRes = c;
29e00 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
29e10 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 67 6f 74 TE_OK;. got
29e20 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b o moveto_finish;
29e30 0a 20 20 20 20 7d 0a 6d 6f 76 65 74 6f 5f 6e 65 . }.moveto_ne
29e40 78 74 5f 6c 61 79 65 72 3a 0a 20 20 20 20 69 66 xt_layer:. if
29e50 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d 3e 6e 43 ( lwr>=pPage->nC
29e60 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 63 68 6c ell ){. chl
29e70 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 28 26 dPg = get4byte(&
29e80 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 pPage->aData[pPa
29e90 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ge->hdrOffset+8]
29ea0 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
29eb0 20 20 20 20 63 68 6c 64 50 67 20 3d 20 67 65 74 chldPg = get
29ec0 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 70 4byte(findCell(p
29ed0 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a 20 20 20 Page, lwr));.
29ee0 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 49 }. pCur->aiI
29ef0 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 dx[pCur->iPage]
29f00 3d 20 28 75 31 36 29 6c 77 72 3b 0a 20 20 20 20 = (u16)lwr;.
29f10 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 rc = moveToChild
29f20 28 70 43 75 72 2c 20 63 68 6c 64 50 67 29 3b 0a (pCur, chldPg);.
29f30 20 20 20 20 69 66 28 20 72 63 20 29 20 62 72 65 if( rc ) bre
29f40 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 65 74 6f 5f 66 ak;. }.moveto_f
29f50 69 6e 69 73 68 3a 0a 20 20 70 43 75 72 2d 3e 69 inish:. pCur->i
29f60 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
29f70 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
29f80 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e &= ~(BTCF_ValidN
29f90 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 Key|BTCF_ValidOv
29fa0 66 6c 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 fl);. return rc
29fb0 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ;.}.../*.** Retu
29fc0 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 20 63 rn TRUE if the c
29fd0 75 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f 69 ursor is not poi
29fe0 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 nting at an entr
29ff0 79 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a y of the table..
2a000 2a 2a 0a 2a 2a 20 54 52 55 45 20 77 69 6c 6c 20 **.** TRUE will
2a010 62 65 20 72 65 74 75 72 6e 65 64 20 61 66 74 65 be returned afte
2a020 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 r a call to sqli
2a030 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 20 6d te3BtreeNext() m
2a040 6f 76 65 73 0a 2a 2a 20 70 61 73 74 20 74 68 65 oves.** past the
2a050 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 last entry in t
2a060 68 65 20 74 61 62 6c 65 20 6f 72 20 73 71 6c 69 he table or sqli
2a070 74 65 33 42 74 72 65 65 50 72 65 76 28 29 20 6d te3BtreePrev() m
2a080 6f 76 65 73 20 70 61 73 74 0a 2a 2a 20 74 68 65 oves past.** the
2a090 20 66 69 72 73 74 20 65 6e 74 72 79 2e 20 20 54 first entry. T
2a0a0 52 55 45 20 69 73 20 61 6c 73 6f 20 72 65 74 75 RUE is also retu
2a0b0 72 6e 65 64 20 69 66 20 74 68 65 20 74 61 62 6c rned if the tabl
2a0c0 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 e is empty..*/.i
2a0d0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 nt sqlite3BtreeE
2a0e0 6f 66 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 of(BtCursor *pCu
2a0f0 72 29 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 57 r){. /* TODO: W
2a100 68 61 74 20 69 66 20 74 68 65 20 63 75 72 73 6f hat if the curso
2a110 72 20 69 73 20 69 6e 20 43 55 52 53 4f 52 5f 52 r is in CURSOR_R
2a120 45 51 55 49 52 45 53 45 45 4b 20 62 75 74 20 61 EQUIRESEEK but a
2a130 6c 6c 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 ll table entries
2a140 0a 20 20 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 . ** have been
2a150 64 65 6c 65 74 65 64 3f 20 54 68 69 73 20 41 50 deleted? This AP
2a160 49 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 63 I will need to c
2a170 68 61 6e 67 65 20 74 6f 20 72 65 74 75 72 6e 20 hange to return
2a180 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20 an error code.
2a190 2a 2a 20 61 73 20 77 65 6c 6c 20 61 73 20 74 68 ** as well as th
2a1a0 65 20 62 6f 6f 6c 65 61 6e 20 72 65 73 75 6c 74 e boolean result
2a1b0 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 72 value.. */. r
2a1c0 65 74 75 72 6e 20 28 43 55 52 53 4f 52 5f 56 41 eturn (CURSOR_VA
2a1d0 4c 49 44 21 3d 70 43 75 72 2d 3e 65 53 74 61 74 LID!=pCur->eStat
2a1e0 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 e);.}../*.** Adv
2a1f0 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 ance the cursor
2a200 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e 74 72 to the next entr
2a210 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
2a220 65 2e 20 20 49 66 0a 2a 2a 20 73 75 63 63 65 73 e. If.** succes
2a230 73 66 75 6c 20 74 68 65 6e 20 73 65 74 20 2a 70 sful then set *p
2a240 52 65 73 3d 30 2e 20 20 49 66 20 74 68 65 20 63 Res=0. If the c
2a250 75 72 73 6f 72 0a 2a 2a 20 77 61 73 20 61 6c 72 ursor.** was alr
2a260 65 61 64 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f eady pointing to
2a270 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 the last entry
2a280 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
2a290 62 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 20 72 before.** this r
2a2a0 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 outine was calle
2a2b0 64 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 d, then set *pRe
2a2c0 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d s=1..**.** The m
2a2d0 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 ain entry point
2a2e0 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e is sqlite3BtreeN
2a2f0 65 78 74 28 29 2e 20 20 54 68 61 74 20 72 6f 75 ext(). That rou
2a300 74 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 7a 65 tine is optimize
2a310 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 6f 6d d.** for the com
2a320 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 72 65 mon case of mere
2a330 6c 79 20 69 6e 63 72 65 6d 65 6e 74 69 6e 67 20 ly incrementing
2a340 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 65 72 the cell counter
2a350 20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 78 0a BtCursor.aiIdx.
2a360 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 20 63 ** to the next c
2a370 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 72 65 ell on the curre
2a380 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 28 73 nt page. The (s
2a390 6c 6f 77 65 72 29 20 62 74 72 65 65 4e 65 78 74 lower) btreeNext
2a3a0 28 29 20 68 65 6c 70 65 72 0a 2a 2a 20 72 6f 75 () helper.** rou
2a3b0 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 tine is called w
2a3c0 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 73 73 hen it is necess
2a3d0 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f 20 61 ary to move to a
2a3e0 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 65 20 different page
2a3f0 6f 72 0a 2a 2a 20 74 6f 20 72 65 73 74 6f 72 65 or.** to restore
2a400 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a the cursor..**.
2a410 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 66 ** The calling f
2a420 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 65 74 unction will set
2a430 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 20 31 *pRes to 0 or 1
2a440 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 20 2a . The initial *
2a450 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 77 69 pRes value.** wi
2a460 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 20 63 ll be 1 if the c
2a470 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 65 70 ursor being step
2a480 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 ped corresponds
2a490 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 78 20 to an SQL index
2a4a0 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 20 72 and.** if this r
2a4b0 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 61 76 outine could hav
2a4c0 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 20 69 e been skipped i
2a4d0 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 65 78 f that SQL index
2a4e0 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 20 75 had been.** a u
2a4f0 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 4f 74 nique index. Ot
2a500 68 65 72 77 69 73 65 20 74 68 65 20 63 61 6c 6c herwise the call
2a510 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 65 74 er will have set
2a520 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f 2e 0a *pRes to zero..
2a530 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 20 63 ** Zero is the c
2a540 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 65 20 ommon case. The
2a550 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 btree implementa
2a560 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 6f 20 tion is free to
2a570 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 74 69 use the.** initi
2a580 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 20 61 al *pRes value a
2a590 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d 70 72 s a hint to impr
2a5a0 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 2c ove performance,
2a5b0 20 62 75 74 20 74 68 65 20 63 75 72 72 65 6e 74 but the current
2a5c0 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 65 65 .** SQLite btree
2a5d0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
2a5e0 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 65 20 does not. (Note
2a5f0 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 32 20 that the comdb2
2a600 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 btree.** impleme
2a610 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 73 65 ntation does use
2a620 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f 77 65 this hint, howe
2a630 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 63 20 ver.).*/.static
2a640 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 SQLITE_NOINLINE
2a650 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 42 74 int btreeNext(Bt
2a660 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e Cursor *pCur, in
2a670 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 t *pRes){. int
2a680 72 63 3b 0a 20 20 69 6e 74 20 69 64 78 3b 0a 20 rc;. int idx;.
2a690 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
2a6a0 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
2a6b0 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
2a6c0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
2a6d0 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d pCur->skipNext==
2a6e0 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 0 || pCur->eStat
2a6f0 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e!=CURSOR_VALID
2a700 29 3b 0a 20 20 61 73 73 65 72 74 28 20 2a 70 52 );. assert( *pR
2a710 65 73 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 es==0 );. if( p
2a720 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2a730 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 SOR_VALID ){.
2a740 20 61 73 73 65 72 74 28 20 28 70 43 75 72 2d 3e assert( (pCur->
2a750 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
2a760 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 29 3b ValidOvfl)==0 );
2a770 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 6f 72 . rc = restor
2a780 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
2a790 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 20 72 pCur);. if( r
2a7a0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
2a7b0 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
2a7c0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 43 . }. if( C
2a7d0 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 URSOR_INVALID==p
2a7e0 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 Cur->eState ){.
2a7f0 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a *pRes = 1;.
2a800 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
2a810 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 ITE_OK;. }.
2a820 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 if( pCur->skip
2a830 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 61 73 Next ){. as
2a840 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
2a850 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
2a860 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 || pCur->eState
2a870 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 ==CURSOR_SKIPNEX
2a880 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d T );. pCur-
2a890 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
2a8a0 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 69 66 _VALID;. if
2a8b0 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
2a8c0 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 >0 ){. pC
2a8d0 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 ur->skipNext = 0
2a8e0 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
2a8f0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
2a900 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 2d 3e }. pCur->
2a910 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 skipNext = 0;.
2a920 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 }. }.. pPage
2a930 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2a940 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
2a950 69 64 78 20 3d 20 2b 2b 70 43 75 72 2d 3e 61 69 idx = ++pCur->ai
2a960 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
2a970 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
2a980 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 0a 20 20 e->isInit );..
2a990 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 /* If the databa
2a9a0 73 65 20 66 69 6c 65 20 69 73 20 63 6f 72 72 75 se file is corru
2a9b0 70 74 2c 20 69 74 20 69 73 20 70 6f 73 73 69 62 pt, it is possib
2a9c0 6c 65 20 66 6f 72 20 74 68 65 20 76 61 6c 75 65 le for the value
2a9d0 20 6f 66 20 69 64 78 20 0a 20 20 2a 2a 20 74 6f of idx . ** to
2a9e0 20 62 65 20 69 6e 76 61 6c 69 64 20 68 65 72 65 be invalid here
2a9f0 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 20 . This can only
2aa00 6f 63 63 75 72 20 69 66 20 61 20 73 65 63 6f 6e occur if a secon
2aa10 64 20 63 75 72 73 6f 72 20 6d 6f 64 69 66 69 65 d cursor modifie
2aa20 73 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 s. ** the page
2aa30 77 68 69 6c 65 20 63 75 72 73 6f 72 20 70 43 75 while cursor pCu
2aa40 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 20 72 r is holding a r
2aa50 65 66 65 72 65 6e 63 65 20 74 6f 20 69 74 2e 20 eference to it.
2aa60 57 68 69 63 68 20 63 61 6e 0a 20 20 2a 2a 20 6f Which can. ** o
2aa70 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 74 68 nly happen if th
2aa80 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6f e database is co
2aa90 72 72 75 70 74 20 69 6e 20 73 75 63 68 20 61 20 rrupt in such a
2aaa0 77 61 79 20 61 73 20 74 6f 20 6c 69 6e 6b 20 74 way as to link t
2aab0 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e 74 he. ** page int
2aac0 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 o more than one
2aad0 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 b-tree structure
2aae0 2e 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 . */. testcase(
2aaf0 20 69 64 78 3e 70 50 61 67 65 2d 3e 6e 43 65 6c idx>pPage->nCel
2ab00 6c 20 29 3b 0a 0a 20 20 69 66 28 20 69 64 78 3e l );.. if( idx>
2ab10 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b =pPage->nCell ){
2ab20 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d . if( !pPage-
2ab30 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 72 >leaf ){. r
2ab40 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
2ab50 70 43 75 72 2c 20 67 65 74 34 62 79 74 65 28 26 pCur, get4byte(&
2ab60 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 pPage->aData[pPa
2ab70 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ge->hdrOffset+8]
2ab80 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 ));. if( rc
2ab90 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
2aba0 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 65 54 return moveT
2abb0 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b oLeftmost(pCur);
2abc0 0a 20 20 20 20 7d 0a 20 20 20 20 64 6f 7b 0a 20 . }. do{.
2abd0 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 if( pCur->i
2abe0 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Page==0 ){.
2abf0 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 *pRes = 1;.
2ac00 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 pCur->eSta
2ac10 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 te = CURSOR_INVA
2ac20 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 72 65 74 LID;. ret
2ac30 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2ac40 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d 6f 76 }. mov
2ac50 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 29 3b eToParent(pCur);
2ac60 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 70 . pPage = p
2ac70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
2ac80 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 7d 77 ->iPage];. }w
2ac90 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 69 49 64 hile( pCur->aiId
2aca0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3e 3d x[pCur->iPage]>=
2acb0 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a pPage->nCell );.
2acc0 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 if( pPage->i
2acd0 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 72 ntKey ){. r
2ace0 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 74 72 eturn sqlite3Btr
2acf0 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 52 65 eeNext(pCur, pRe
2ad00 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 s);. }else{.
2ad10 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
2ad20 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d TE_OK;. }. }
2ad30 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 . if( pPage->le
2ad40 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e af ){. return
2ad50 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
2ad60 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 lse{. return
2ad70 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 moveToLeftmost(p
2ad80 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 6e 74 20 Cur);. }.}.int
2ad90 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 sqlite3BtreeNext
2ada0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
2adb0 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 4d int *pRes){. M
2adc0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 emPage *pPage;.
2add0 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
2ade0 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
2adf0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 );. assert( pRe
2ae00 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 s!=0 );. assert
2ae10 28 20 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 2a 70 ( *pRes==0 || *p
2ae20 52 65 73 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 Res==1 );. asse
2ae30 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 rt( pCur->skipNe
2ae40 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 xt==0 || pCur->e
2ae50 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 State!=CURSOR_VA
2ae60 4c 49 44 20 29 3b 0a 20 20 70 43 75 72 2d 3e 69 LID );. pCur->i
2ae70 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
2ae80 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
2ae90 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e &= ~(BTCF_ValidN
2aea0 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 Key|BTCF_ValidOv
2aeb0 66 6c 29 3b 0a 20 20 2a 70 52 65 73 20 3d 20 30 fl);. *pRes = 0
2aec0 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
2aed0 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
2aee0 49 44 20 29 20 72 65 74 75 72 6e 20 62 74 72 65 ID ) return btre
2aef0 65 4e 65 78 74 28 70 43 75 72 2c 20 70 52 65 73 eNext(pCur, pRes
2af00 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 70 43 75 );. pPage = pCu
2af10 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
2af20 69 50 61 67 65 5d 3b 0a 20 20 69 66 28 20 28 2b iPage];. if( (+
2af30 2b 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 +pCur->aiIdx[pCu
2af40 72 2d 3e 69 50 61 67 65 5d 29 3e 3d 70 50 61 67 r->iPage])>=pPag
2af50 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 e->nCell ){.
2af60 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
2af70 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 20 20 ->iPage]--;.
2af80 72 65 74 75 72 6e 20 62 74 72 65 65 4e 65 78 74 return btreeNext
2af90 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 (pCur, pRes);.
2afa0 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c }. if( pPage->l
2afb0 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 72 eaf ){. retur
2afc0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
2afd0 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e else{. return
2afe0 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 moveToLeftmost(
2aff0 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a pCur);. }.}../*
2b000 0a 2a 2a 20 53 74 65 70 20 74 68 65 20 63 75 72 .** Step the cur
2b010 73 6f 72 20 74 6f 20 74 68 65 20 62 61 63 6b 20 sor to the back
2b020 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 to the previous
2b030 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 entry in the dat
2b040 61 62 61 73 65 2e 20 20 49 66 0a 2a 2a 20 73 75 abase. If.** su
2b050 63 63 65 73 73 66 75 6c 20 74 68 65 6e 20 73 65 ccessful then se
2b060 74 20 2a 70 52 65 73 3d 30 2e 20 20 49 66 20 74 t *pRes=0. If t
2b070 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 73 he cursor.** was
2b080 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 69 6e already pointin
2b090 67 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 g to the first e
2b0a0 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 61 ntry in the data
2b0b0 62 61 73 65 20 62 65 66 6f 72 65 0a 2a 2a 20 74 base before.** t
2b0c0 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20 his routine was
2b0d0 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 73 65 74 called, then set
2b0e0 20 2a 70 52 65 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 *pRes=1..**.**
2b0f0 54 68 65 20 6d 61 69 6e 20 65 6e 74 72 79 20 70 The main entry p
2b100 6f 69 6e 74 20 69 73 20 73 71 6c 69 74 65 33 42 oint is sqlite3B
2b110 74 72 65 65 50 72 65 76 69 6f 75 73 28 29 2e 20 treePrevious().
2b120 20 54 68 61 74 20 72 6f 75 74 69 6e 65 20 69 73 That routine is
2b130 20 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 66 6f optimized.** fo
2b140 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 r the common cas
2b150 65 20 6f 66 20 6d 65 72 65 6c 79 20 64 65 63 72 e of merely decr
2b160 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 65 6c ementing the cel
2b170 6c 20 63 6f 75 6e 74 65 72 20 42 74 43 75 72 73 l counter BtCurs
2b180 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f 20 74 or.aiIdx.** to t
2b190 68 65 20 70 72 65 76 69 6f 75 73 20 63 65 6c 6c he previous cell
2b1a0 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 on the current
2b1b0 70 61 67 65 2e 20 20 54 68 65 20 28 73 6c 6f 77 page. The (slow
2b1c0 65 72 29 20 62 74 72 65 65 50 72 65 76 69 6f 75 er) btreePreviou
2b1d0 73 28 29 0a 2a 2a 20 68 65 6c 70 65 72 20 72 6f s().** helper ro
2b1e0 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 utine is called
2b1f0 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 73 when it is neces
2b200 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f 20 sary to move to
2b210 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 65 a different page
2b220 0a 2a 2a 20 6f 72 20 74 6f 20 72 65 73 74 6f 72 .** or to restor
2b230 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2a e the cursor..**
2b240 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 .** The calling
2b250 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 65 function will se
2b260 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 20 t *pRes to 0 or
2b270 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 20 1. The initial
2b280 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 77 *pRes value.** w
2b290 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 20 ill be 1 if the
2b2a0 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 65 cursor being ste
2b2b0 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 73 pped corresponds
2b2c0 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 78 to an SQL index
2b2d0 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 20 and.** if this
2b2e0 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 61 routine could ha
2b2f0 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 20 ve been skipped
2b300 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 65 if that SQL inde
2b310 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 20 x had been.** a
2b320 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 4f unique index. O
2b330 74 68 65 72 77 69 73 65 20 74 68 65 20 63 61 6c therwise the cal
2b340 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 65 ler will have se
2b350 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f 2e t *pRes to zero.
2b360 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 20 .** Zero is the
2b370 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 65 common case. The
2b380 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 btree implement
2b390 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 6f ation is free to
2b3a0 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 74 use the.** init
2b3b0 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 20 ial *pRes value
2b3c0 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d 70 as a hint to imp
2b3d0 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 rove performance
2b3e0 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 65 6e , but the curren
2b3f0 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 65 t.** SQLite btre
2b400 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e e implementation
2b410 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 65 does not. (Note
2b420 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 32 that the comdb2
2b430 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 6d btree.** implem
2b440 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 73 entation does us
2b450 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f 77 e this hint, how
2b460 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 63 ever.).*/.static
2b470 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 SQLITE_NOINLINE
2b480 20 69 6e 74 20 62 74 72 65 65 50 72 65 76 69 6f int btreePrevio
2b490 75 73 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 us(BtCursor *pCu
2b4a0 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
2b4b0 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65 6d 50 61 int rc;. MemPa
2b4c0 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 61 73 ge *pPage;.. as
2b4d0 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
2b4e0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
2b4f0 20 20 61 73 73 65 72 74 28 20 70 52 65 73 21 3d assert( pRes!=
2b500 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 2a 0 );. assert( *
2b510 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 61 73 73 pRes==0 );. ass
2b520 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e ert( pCur->skipN
2b530 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e ext==0 || pCur->
2b540 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
2b550 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 ALID );. assert
2b560 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 ( (pCur->curFlag
2b570 73 20 26 20 28 42 54 43 46 5f 41 74 4c 61 73 74 s & (BTCF_AtLast
2b580 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 7c |BTCF_ValidOvfl|
2b590 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 29 BTCF_ValidNKey))
2b5a0 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
2b5b0 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a pCur->info.nSiz
2b5c0 65 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 43 e==0 );. if( pC
2b5d0 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
2b5e0 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 OR_VALID ){.
2b5f0 72 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 rc = restoreCurs
2b600 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 orPosition(pCur)
2b610 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
2b620 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
2b630 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2b640 7d 0a 20 20 20 20 69 66 28 20 43 55 52 53 4f 52 }. if( CURSOR
2b650 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e _INVALID==pCur->
2b660 65 53 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 eState ){.
2b670 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 *pRes = 1;.
2b680 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2b690 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 K;. }. if(
2b6a0 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
2b6b0 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
2b6c0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
2b6d0 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 URSOR_VALID || p
2b6e0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
2b6f0 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 3b 0a SOR_SKIPNEXT );.
2b700 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 pCur->eSta
2b710 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 te = CURSOR_VALI
2b720 44 3b 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 D;. if( pCu
2b730 72 2d 3e 73 6b 69 70 4e 65 78 74 3c 30 20 29 7b r->skipNext<0 ){
2b740 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 73 . pCur->s
2b750 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 kipNext = 0;.
2b760 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
2b770 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 TE_OK;. }.
2b780 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e pCur->skipN
2b790 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 ext = 0;. }.
2b7a0 20 7d 0a 0a 20 20 70 50 61 67 65 20 3d 20 70 43 }.. pPage = pC
2b7b0 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
2b7c0 3e 69 50 61 67 65 5d 3b 0a 20 20 61 73 73 65 72 >iPage];. asser
2b7d0 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 t( pPage->isInit
2b7e0 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 67 65 );. if( !pPage
2b7f0 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 69 6e ->leaf ){. in
2b800 74 20 69 64 78 20 3d 20 70 43 75 72 2d 3e 61 69 t idx = pCur->ai
2b810 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
2b820 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 ;. rc = moveT
2b830 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 65 74 oChild(pCur, get
2b840 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 70 4byte(findCell(p
2b850 50 61 67 65 2c 20 69 64 78 29 29 29 3b 0a 20 20 Page, idx)));.
2b860 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
2b870 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 6d n rc;. rc = m
2b880 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 oveToRightmost(p
2b890 43 75 72 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 Cur);. }else{.
2b8a0 20 20 20 77 68 69 6c 65 28 20 70 43 75 72 2d 3e while( pCur->
2b8b0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2b8c0 65 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 e]==0 ){. i
2b8d0 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3d 3d f( pCur->iPage==
2b8e0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 0 ){. pCu
2b8f0 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
2b900 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 OR_INVALID;.
2b910 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 *pRes = 1;.
2b920 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
2b930 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
2b940 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f 50 61 72 . moveToPar
2b950 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 20 20 7d ent(pCur);. }
2b960 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
2b970 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
2b980 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
2b990 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
2b9a0 26 20 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 & (BTCF_ValidNKe
2b9b0 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c y|BTCF_ValidOvfl
2b9c0 29 29 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 70 43 ))==0 );.. pC
2b9d0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
2b9e0 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 20 20 70 50 iPage]--;. pP
2b9f0 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
2ba00 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
2ba10 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e . if( pPage->
2ba20 69 6e 74 4b 65 79 20 26 26 20 21 70 50 61 67 65 intKey && !pPage
2ba30 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 ->leaf ){.
2ba40 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
2ba50 65 50 72 65 76 69 6f 75 73 28 70 43 75 72 2c 20 ePrevious(pCur,
2ba60 70 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 pRes);. }else
2ba70 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
2ba80 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 ITE_OK;. }.
2ba90 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
2baa0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
2bab0 65 50 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 ePrevious(BtCurs
2bac0 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
2bad0 52 65 73 29 7b 0a 20 20 61 73 73 65 72 74 28 20 Res){. assert(
2bae0 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
2baf0 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
2bb00 72 74 28 20 70 52 65 73 21 3d 30 20 29 3b 0a 20 rt( pRes!=0 );.
2bb10 20 61 73 73 65 72 74 28 20 2a 70 52 65 73 3d 3d assert( *pRes==
2bb20 30 20 7c 7c 20 2a 70 52 65 73 3d 3d 31 20 29 3b 0 || *pRes==1 );
2bb30 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2bb40 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 >skipNext==0 ||
2bb50 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
2bb60 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
2bb70 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 70 43 75 *pRes = 0;. pCu
2bb80 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e r->curFlags &= ~
2bb90 28 42 54 43 46 5f 41 74 4c 61 73 74 7c 42 54 43 (BTCF_AtLast|BTC
2bba0 46 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 43 46 F_ValidOvfl|BTCF
2bbb0 5f 56 61 6c 69 64 4e 4b 65 79 29 3b 0a 20 20 70 _ValidNKey);. p
2bbc0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
2bbd0 3d 20 30 3b 0a 20 20 69 66 28 20 70 43 75 72 2d = 0;. if( pCur-
2bbe0 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
2bbf0 56 41 4c 49 44 0a 20 20 20 7c 7c 20 70 43 75 72 VALID. || pCur
2bc00 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2bc10 61 67 65 5d 3d 3d 30 0a 20 20 20 7c 7c 20 70 43 age]==0. || pC
2bc20 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
2bc30 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 66 3d 3d 30 >iPage]->leaf==0
2bc40 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e . ){. return
2bc50 20 62 74 72 65 65 50 72 65 76 69 6f 75 73 28 70 btreePrevious(p
2bc60 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 7d 0a Cur, pRes);. }.
2bc70 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
2bc80 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 ur->iPage]--;.
2bc90 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
2bca0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 ;.}../*.** Alloc
2bcb0 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 66 ate a new page f
2bcc0 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
2bcd0 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 file..**.** The
2bce0 20 6e 65 77 20 70 61 67 65 20 69 73 20 6d 61 72 new page is mar
2bcf0 6b 65 64 20 61 73 20 64 69 72 74 79 2e 20 20 28 ked as dirty. (
2bd00 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words,
2bd10 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2bd20 65 28 29 0a 2a 2a 20 68 61 73 20 61 6c 72 65 61 e().** has alrea
2bd30 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 6f dy been called o
2bd40 6e 20 74 68 65 20 6e 65 77 20 70 61 67 65 2e 29 n the new page.)
2bd50 20 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 68 The new page h
2bd60 61 73 20 61 6c 73 6f 0a 2a 2a 20 62 65 65 6e 20 as also.** been
2bd70 72 65 66 65 72 65 6e 63 65 64 20 61 6e 64 20 74 referenced and t
2bd80 68 65 20 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 he calling routi
2bd90 6e 65 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c ne is responsibl
2bda0 65 20 66 6f 72 20 63 61 6c 6c 69 6e 67 0a 2a 2a e for calling.**
2bdb0 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
2bdc0 65 66 28 29 20 6f 6e 20 74 68 65 20 6e 65 77 20 ef() on the new
2bdd0 70 61 67 65 20 77 68 65 6e 20 69 74 20 69 73 20 page when it is
2bde0 64 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 done..**.** SQLI
2bdf0 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
2be00 64 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 41 d on success. A
2be10 6e 79 20 6f 74 68 65 72 20 72 65 74 75 72 6e 20 ny other return
2be20 76 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 0a value indicates.
2be30 2a 2a 20 61 6e 20 65 72 72 6f 72 2e 20 20 2a 70 ** an error. *p
2be40 70 50 61 67 65 20 61 6e 64 20 2a 70 50 67 6e 6f pPage and *pPgno
2be50 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 20 69 are undefined i
2be60 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 n the event of a
2be70 6e 20 65 72 72 6f 72 2e 0a 2a 2a 20 44 6f 20 6e n error..** Do n
2be80 6f 74 20 69 6e 76 6f 6b 65 20 73 71 6c 69 74 65 ot invoke sqlite
2be90 33 50 61 67 65 72 55 6e 72 65 66 28 29 20 6f 6e 3PagerUnref() on
2bea0 20 2a 70 70 50 61 67 65 20 69 66 20 61 6e 20 65 *ppPage if an e
2beb0 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 rror is returned
2bec0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 22 ..**.** If the "
2bed0 6e 65 61 72 62 79 22 20 70 61 72 61 6d 65 74 65 nearby" paramete
2bee0 72 20 69 73 20 6e 6f 74 20 30 2c 20 74 68 65 6e r is not 0, then
2bef0 20 61 6e 20 65 66 66 6f 72 74 20 69 73 20 6d 61 an effort is ma
2bf00 64 65 20 74 6f 20 0a 2a 2a 20 6c 6f 63 61 74 65 de to .** locate
2bf10 20 61 20 70 61 67 65 20 63 6c 6f 73 65 20 74 6f a page close to
2bf20 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
2bf30 20 22 6e 65 61 72 62 79 22 2e 20 20 54 68 69 73 "nearby". This
2bf40 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 can be used in
2bf50 61 6e 0a 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f an.** attempt to
2bf60 20 6b 65 65 70 20 72 65 6c 61 74 65 64 20 70 61 keep related pa
2bf70 67 65 73 20 63 6c 6f 73 65 20 74 6f 20 65 61 63 ges close to eac
2bf80 68 20 6f 74 68 65 72 20 69 6e 20 74 68 65 20 64 h other in the d
2bf90 61 74 61 62 61 73 65 20 66 69 6c 65 2c 0a 2a 2a atabase file,.**
2bfa0 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 63 which in turn c
2bfb0 61 6e 20 6d 61 6b 65 20 64 61 74 61 62 61 73 65 an make database
2bfc0 20 61 63 63 65 73 73 20 66 61 73 74 65 72 2e 0a access faster..
2bfd0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 4d 6f **.** If the eMo
2bfe0 64 65 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 de parameter is
2bff0 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 61 6e BTALLOC_EXACT an
2c000 64 20 74 68 65 20 6e 65 61 72 62 79 20 70 61 67 d the nearby pag
2c010 65 20 65 78 69 73 74 73 0a 2a 2a 20 61 6e 79 77 e exists.** anyw
2c020 68 65 72 65 20 6f 6e 20 74 68 65 20 66 72 65 65 here on the free
2c030 2d 6c 69 73 74 2c 20 74 68 65 6e 20 69 74 20 69 -list, then it i
2c040 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20 s guaranteed to
2c050 62 65 20 72 65 74 75 72 6e 65 64 2e 20 20 49 66 be returned. If
2c060 0a 2a 2a 20 65 4d 6f 64 65 20 69 73 20 42 54 41 .** eMode is BTA
2c070 4c 4c 4f 43 5f 4c 54 20 74 68 65 6e 20 74 68 65 LLOC_LT then the
2c080 20 70 61 67 65 20 72 65 74 75 72 6e 65 64 20 77 page returned w
2c090 69 6c 6c 20 62 65 20 6c 65 73 73 20 74 68 61 6e ill be less than
2c0a0 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 74 6f 20 or equal.** to
2c0b0 6e 65 61 72 62 79 20 69 66 20 61 6e 79 20 73 75 nearby if any su
2c0c0 63 68 20 70 61 67 65 20 65 78 69 73 74 73 2e 20 ch page exists.
2c0d0 20 49 66 20 65 4d 6f 64 65 20 69 73 20 42 54 41 If eMode is BTA
2c0e0 4c 4c 4f 43 5f 41 4e 59 20 74 68 65 6e 20 74 68 LLOC_ANY then th
2c0f0 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 72 65 ere.** are no re
2c100 73 74 72 69 63 74 69 6f 6e 73 20 6f 6e 20 77 68 strictions on wh
2c110 69 63 68 20 70 61 67 65 20 69 73 20 72 65 74 75 ich page is retu
2c120 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 rned..*/.static
2c130 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 int allocateBtre
2c140 65 50 61 67 65 28 0a 20 20 42 74 53 68 61 72 65 ePage(. BtShare
2c150 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 20 20 d *pBt,
2c160 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f 0a /* The btree */.
2c170 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 MemPage **ppPa
2c180 67 65 2c 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 ge, /* Stor
2c190 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
2c1a0 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 20 allocated page
2c1b0 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 2a here */. Pgno *
2c1c0 70 50 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pPgno,
2c1d0 20 2f 2a 20 53 74 6f 72 65 20 74 68 65 20 70 61 /* Store the pa
2c1e0 67 65 20 6e 75 6d 62 65 72 20 68 65 72 65 20 2a ge number here *
2c1f0 2f 0a 20 20 50 67 6e 6f 20 6e 65 61 72 62 79 2c /. Pgno nearby,
2c200 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 /* Se
2c210 61 72 63 68 20 66 6f 72 20 61 20 70 61 67 65 20 arch for a page
2c220 6e 65 61 72 20 74 68 69 73 20 6f 6e 65 20 2a 2f near this one */
2c230 0a 20 20 75 38 20 65 4d 6f 64 65 20 20 20 20 20 . u8 eMode
2c240 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 54 41 /* BTA
2c250 4c 4c 4f 43 5f 45 58 41 43 54 2c 20 42 54 41 4c LLOC_EXACT, BTAL
2c260 4c 4f 43 5f 4c 54 2c 20 6f 72 20 42 54 41 4c 4c LOC_LT, or BTALL
2c270 4f 43 5f 41 4e 59 20 2a 2f 0a 29 7b 0a 20 20 4d OC_ANY */.){. M
2c280 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 3b 0a emPage *pPage1;.
2c290 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 32 20 int rc;. u32
2c2a0 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 n; /* Number
2c2b0 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 68 65 of pages on the
2c2c0 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a 20 20 75 freelist */. u
2c2d0 33 32 20 6b 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 32 k; /* Num
2c2e0 62 65 72 20 6f 66 20 6c 65 61 76 65 73 20 6f 6e ber of leaves on
2c2f0 20 74 68 65 20 74 72 75 6e 6b 20 6f 66 20 74 68 the trunk of th
2c300 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a 20 20 e freelist */.
2c310 4d 65 6d 50 61 67 65 20 2a 70 54 72 75 6e 6b 20 MemPage *pTrunk
2c320 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a = 0;. MemPage *
2c330 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 30 3b 0a pPrevTrunk = 0;.
2c340 20 20 50 67 6e 6f 20 6d 78 50 61 67 65 3b 20 20 Pgno mxPage;
2c350 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 69 7a 65 /* Total size
2c360 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
2c370 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 61 73 73 65 file */.. asse
2c380 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2c390 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
2c3a0 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
2c3b0 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 41 eMode==BTALLOC_A
2c3c0 4e 59 20 7c 7c 20 28 6e 65 61 72 62 79 3e 30 20 NY || (nearby>0
2c3d0 26 26 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 && IfNotOmitAV(p
2c3e0 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 29 Bt->autoVacuum))
2c3f0 20 29 3b 0a 20 20 70 50 61 67 65 31 20 3d 20 70 );. pPage1 = p
2c400 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 6d 78 Bt->pPage1;. mx
2c410 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 Page = btreePage
2c420 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 2f 2a count(pBt);. /*
2c430 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
2c440 30 35 31 31 39 2d 30 32 36 33 37 20 54 68 65 20 05119-02637 The
2c450 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 4-byte big-endia
2c460 6e 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 n integer at off
2c470 73 65 74 20 33 36 0a 20 20 2a 2a 20 73 74 6f 72 set 36. ** stor
2c480 65 73 20 73 74 6f 72 65 73 20 74 68 65 20 74 6f es stores the to
2c490 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 tal number of pa
2c4a0 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c ges on the freel
2c4b0 69 73 74 2e 20 2a 2f 0a 20 20 6e 20 3d 20 67 65 ist. */. n = ge
2c4c0 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
2c4d0 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 74 65 aData[36]);. te
2c4e0 73 74 63 61 73 65 28 20 6e 3d 3d 6d 78 50 61 67 stcase( n==mxPag
2c4f0 65 2d 31 20 29 3b 0a 20 20 69 66 28 20 6e 3e 3d e-1 );. if( n>=
2c500 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 72 65 mxPage ){. re
2c510 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
2c520 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 UPT_BKPT;. }.
2c530 69 66 28 20 6e 3e 30 20 29 7b 0a 20 20 20 20 2f if( n>0 ){. /
2c540 2a 20 54 68 65 72 65 20 61 72 65 20 70 61 67 65 * There are page
2c550 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 s on the freelis
2c560 74 2e 20 20 52 65 75 73 65 20 6f 6e 65 20 6f 66 t. Reuse one of
2c570 20 74 68 6f 73 65 20 70 61 67 65 73 2e 20 2a 2f those pages. */
2c580 0a 20 20 20 20 50 67 6e 6f 20 69 54 72 75 6e 6b . Pgno iTrunk
2c590 3b 0a 20 20 20 20 75 38 20 73 65 61 72 63 68 4c ;. u8 searchL
2c5a0 69 73 74 20 3d 20 30 3b 20 2f 2a 20 49 66 20 74 ist = 0; /* If t
2c5b0 68 65 20 66 72 65 65 2d 6c 69 73 74 20 6d 75 73 he free-list mus
2c5c0 74 20 62 65 20 73 65 61 72 63 68 65 64 20 66 6f t be searched fo
2c5d0 72 20 27 6e 65 61 72 62 79 27 20 2a 2f 0a 20 20 r 'nearby' */.
2c5e0 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 65 4d 6f . /* If eMo
2c5f0 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 43 de==BTALLOC_EXAC
2c600 54 20 61 6e 64 20 61 20 71 75 65 72 79 20 6f 66 T and a query of
2c610 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 the pointer-map
2c620 0a 20 20 20 20 2a 2a 20 73 68 6f 77 73 20 74 68 . ** shows th
2c630 61 74 20 74 68 65 20 70 61 67 65 20 27 6e 65 61 at the page 'nea
2c640 72 62 79 27 20 69 73 20 73 6f 6d 65 77 68 65 72 rby' is somewher
2c650 65 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 e on the free-li
2c660 73 74 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 st, then. **
2c670 74 68 65 20 65 6e 74 69 72 65 2d 6c 69 73 74 20 the entire-list
2c680 77 69 6c 6c 20 62 65 20 73 65 61 72 63 68 65 64 will be searched
2c690 20 66 6f 72 20 74 68 61 74 20 70 61 67 65 2e 0a for that page..
2c6a0 20 20 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 */.#ifndef S
2c6b0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
2c6c0 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 65 4d ACUUM. if( eM
2c6d0 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 ode==BTALLOC_EXA
2c6e0 43 54 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 CT ){. if(
2c6f0 6e 65 61 72 62 79 3c 3d 6d 78 50 61 67 65 20 29 nearby<=mxPage )
2c700 7b 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 79 {. u8 eTy
2c710 70 65 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 pe;. asse
2c720 72 74 28 20 6e 65 61 72 62 79 3e 30 20 29 3b 0a rt( nearby>0 );.
2c730 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
2c740 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
2c750 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
2c760 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 6e ptrmapGet(pBt, n
2c770 65 61 72 62 79 2c 20 26 65 54 79 70 65 2c 20 30 earby, &eType, 0
2c780 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
2c790 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
2c7a0 20 20 20 20 20 20 20 69 66 28 20 65 54 79 70 65 if( eType
2c7b0 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 50 41 47 ==PTRMAP_FREEPAG
2c7c0 45 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 E ){. s
2c7d0 65 61 72 63 68 4c 69 73 74 20 3d 20 31 3b 0a 20 earchList = 1;.
2c7e0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
2c7f0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 65 . }else if( e
2c800 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 Mode==BTALLOC_LE
2c810 20 29 7b 0a 20 20 20 20 20 20 73 65 61 72 63 68 ){. search
2c820 4c 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a List = 1;. }.
2c830 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 44 #endif.. /* D
2c840 65 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 65 ecrement the fre
2c850 65 2d 6c 69 73 74 20 63 6f 75 6e 74 20 62 79 20 e-list count by
2c860 31 2e 20 53 65 74 20 69 54 72 75 6e 6b 20 74 6f 1. Set iTrunk to
2c870 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 the index of th
2c880 65 0a 20 20 20 20 2a 2a 20 66 69 72 73 74 20 66 e. ** first f
2c890 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
2c8a0 61 67 65 2e 20 69 50 72 65 76 54 72 75 6e 6b 20 age. iPrevTrunk
2c8b0 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 31 2e 0a is initially 1..
2c8c0 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 */. rc =
2c8d0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2c8e0 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 e(pPage1->pDbPag
2c8f0 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 e);. if( rc )
2c900 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2c910 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
2c920 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 6e 2d 31 ->aData[36], n-1
2c930 29 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 );.. /* The c
2c940 6f 64 65 20 77 69 74 68 69 6e 20 74 68 69 73 20 ode within this
2c950 6c 6f 6f 70 20 69 73 20 72 75 6e 20 6f 6e 6c 79 loop is run only
2c960 20 6f 6e 63 65 20 69 66 20 74 68 65 20 27 73 65 once if the 'se
2c970 61 72 63 68 4c 69 73 74 27 20 76 61 72 69 61 62 archList' variab
2c980 6c 65 0a 20 20 20 20 2a 2a 20 69 73 20 6e 6f 74 le. ** is not
2c990 20 74 72 75 65 2e 20 4f 74 68 65 72 77 69 73 65 true. Otherwise
2c9a0 2c 20 69 74 20 72 75 6e 73 20 6f 6e 63 65 20 66 , it runs once f
2c9b0 6f 72 20 65 61 63 68 20 74 72 75 6e 6b 2d 70 61 or each trunk-pa
2c9c0 67 65 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a ge on the. **
2c9d0 20 66 72 65 65 2d 6c 69 73 74 20 75 6e 74 69 6c free-list until
2c9e0 20 74 68 65 20 70 61 67 65 20 27 6e 65 61 72 62 the page 'nearb
2c9f0 79 27 20 69 73 20 6c 6f 63 61 74 65 64 20 28 65 y' is located (e
2ca00 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 Mode==BTALLOC_EX
2ca10 41 43 54 29 0a 20 20 20 20 2a 2a 20 6f 72 20 75 ACT). ** or u
2ca20 6e 74 69 6c 20 61 20 70 61 67 65 20 6c 65 73 73 ntil a page less
2ca30 20 74 68 61 6e 20 27 6e 65 61 72 62 79 27 20 69 than 'nearby' i
2ca40 73 20 6c 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 s located (eMode
2ca50 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 54 29 0a 20 20 ==BTALLOC_LT).
2ca60 20 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 */. do {.
2ca70 20 20 20 20 70 50 72 65 76 54 72 75 6e 6b 20 3d pPrevTrunk =
2ca80 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 69 pTrunk;. i
2ca90 66 28 20 70 50 72 65 76 54 72 75 6e 6b 20 29 7b f( pPrevTrunk ){
2caa0 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 44 . /* EVID
2cab0 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 31 35 30 36 ENCE-OF: R-01506
2cac0 2d 31 31 30 35 33 20 54 68 65 20 66 69 72 73 74 -11053 The first
2cad0 20 69 6e 74 65 67 65 72 20 6f 6e 20 61 20 66 72 integer on a fr
2cae0 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 eelist trunk pag
2caf0 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 73 20 e. ** is
2cb00 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
2cb10 6f 66 20 74 68 65 20 6e 65 78 74 20 66 72 65 65 of the next free
2cb20 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 list trunk page
2cb30 69 6e 20 74 68 65 20 6c 69 73 74 20 6f 72 0a 20 in the list or.
2cb40 20 20 20 20 20 20 20 2a 2a 20 7a 65 72 6f 20 69 ** zero i
2cb50 66 20 74 68 69 73 20 69 73 20 74 68 65 20 6c 61 f this is the la
2cb60 73 74 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e st freelist trun
2cb70 6b 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 k page. */.
2cb80 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 iTrunk = get4
2cb90 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b byte(&pPrevTrunk
2cba0 2d 3e 61 44 61 74 61 5b 30 5d 29 3b 0a 20 20 20 ->aData[0]);.
2cbb0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2cbc0 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
2cbd0 3a 20 52 2d 35 39 38 34 31 2d 31 33 37 39 38 20 : R-59841-13798
2cbe0 54 68 65 20 34 2d 62 79 74 65 20 62 69 67 2d 65 The 4-byte big-e
2cbf0 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 61 74 ndian integer at
2cc00 20 6f 66 66 73 65 74 20 33 32 0a 20 20 20 20 20 offset 32.
2cc10 20 20 20 2a 2a 20 73 74 6f 72 65 73 20 74 68 65 ** stores the
2cc20 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
2cc30 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f the first page o
2cc40 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 2c 20 f the freelist,
2cc50 6f 72 20 7a 65 72 6f 20 69 66 0a 20 20 20 20 20 or zero if.
2cc60 20 20 20 2a 2a 20 74 68 65 20 66 72 65 65 6c 69 ** the freeli
2cc70 73 74 20 69 73 20 65 6d 70 74 79 2e 20 2a 2f 0a st is empty. */.
2cc80 20 20 20 20 20 20 20 20 69 54 72 75 6e 6b 20 3d iTrunk =
2cc90 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
2cca0 31 2d 3e 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 1->aData[32]);.
2ccb0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 74 65 73 }. tes
2ccc0 74 63 61 73 65 28 20 69 54 72 75 6e 6b 3d 3d 6d tcase( iTrunk==m
2ccd0 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 69 xPage );. i
2cce0 66 28 20 69 54 72 75 6e 6b 3e 6d 78 50 61 67 65 f( iTrunk>mxPage
2ccf0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
2cd00 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2cd10 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 65 6c 73 BKPT;. }els
2cd20 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 e{. rc =
2cd30 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
2cd40 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 6e , iTrunk, &pTrun
2cd50 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 k, 0);. }.
2cd60 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 if( rc ){.
2cd70 20 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 pTrunk =
2cd80 30 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 0;. goto
2cd90 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 end_allocate_pag
2cda0 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 e;. }.
2cdb0 20 61 73 73 65 72 74 28 20 70 54 72 75 6e 6b 21 assert( pTrunk!
2cdc0 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 =0 );. asse
2cdd0 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 44 61 74 rt( pTrunk->aDat
2cde0 61 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 2f 2a a!=0 );. /*
2cdf0 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
2ce00 31 33 35 32 33 2d 30 34 33 39 34 20 54 68 65 20 13523-04394 The
2ce10 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 72 20 6f second integer o
2ce20 6e 20 61 20 66 72 65 65 6c 69 73 74 20 74 72 75 n a freelist tru
2ce30 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a nk page. **
2ce40 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o
2ce50 66 20 6c 65 61 66 20 70 61 67 65 20 70 6f 69 6e f leaf page poin
2ce60 74 65 72 73 20 74 6f 20 66 6f 6c 6c 6f 77 2e 20 ters to follow.
2ce70 2a 2f 0a 20 20 20 20 20 20 6b 20 3d 20 67 65 74 */. k = get
2ce80 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
2ce90 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 20 20 20 Data[4]);.
2cea0 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 73 65 61 if( k==0 && !sea
2ceb0 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 20 20 20 rchList ){.
2cec0 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b 20 /* The trunk
2ced0 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 20 61 6e has no leaves an
2cee0 64 20 74 68 65 20 6c 69 73 74 20 69 73 20 6e 6f d the list is no
2cef0 74 20 62 65 69 6e 67 20 73 65 61 72 63 68 65 64 t being searched
2cf00 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 6f . . ** So
2cf10 20 65 78 74 72 61 63 74 20 74 68 65 20 74 72 75 extract the tru
2cf20 6e 6b 20 70 61 67 65 20 69 74 73 65 6c 66 20 61 nk page itself a
2cf30 6e 64 20 75 73 65 20 69 74 20 61 73 20 74 68 65 nd use it as the
2cf40 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 20 20 20 newly .
2cf50 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 ** allocated pag
2cf60 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 73 e */. ass
2cf70 65 72 74 28 20 70 50 72 65 76 54 72 75 6e 6b 3d ert( pPrevTrunk=
2cf80 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 63 =0 );. rc
2cf90 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
2cfa0 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 rite(pTrunk->pDb
2cfb0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 Page);. i
2cfc0 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
2cfd0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f goto end_allo
2cfe0 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 cate_page;.
2cff0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2a 70 50 }. *pP
2d000 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 gno = iTrunk;.
2d010 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 memcpy(&pP
2d020 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c age1->aData[32],
2d030 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
2d040 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 0], 4);.
2d050 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e 6b *ppPage = pTrunk
2d060 3b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b ;. pTrunk
2d070 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 54 52 = 0;. TR
2d080 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 ACE(("ALLOCATE:
2d090 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 20 66 72 %d trunk - %d fr
2d0a0 65 65 20 70 61 67 65 73 20 6c 65 66 74 5c 6e 22 ee pages left\n"
2d0b0 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b , *pPgno, n-1));
2d0c0 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
2d0d0 20 6b 3e 28 75 33 32 29 28 70 42 74 2d 3e 75 73 k>(u32)(pBt->us
2d0e0 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 29 20 ableSize/4 - 2)
2d0f0 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 56 61 ){. /* Va
2d100 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f 75 74 20 lue of k is out
2d110 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 74 61 62 of range. Datab
2d120 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 2a ase corruption *
2d130 2f 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 /. rc = S
2d140 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
2d150 50 54 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f PT;. goto
2d160 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
2d170 67 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ge;.#ifndef SQLI
2d180 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
2d190 55 4d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 UM. }else i
2d1a0 66 28 20 73 65 61 72 63 68 4c 69 73 74 20 0a 20 f( searchList .
2d1b0 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 6e && (n
2d1c0 65 61 72 62 79 3d 3d 69 54 72 75 6e 6b 20 7c 7c earby==iTrunk ||
2d1d0 20 28 69 54 72 75 6e 6b 3c 6e 65 61 72 62 79 20 (iTrunk<nearby
2d1e0 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f && eMode==BTALLO
2d1f0 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 20 29 7b C_LE)) . ){
2d200 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 . /* The
2d210 6c 69 73 74 20 69 73 20 62 65 69 6e 67 20 73 65 list is being se
2d220 61 72 63 68 65 64 20 61 6e 64 20 74 68 69 73 20 arched and this
2d230 74 72 75 6e 6b 20 70 61 67 65 20 69 73 20 74 68 trunk page is th
2d240 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a e page. *
2d250 2a 20 74 6f 20 61 6c 6c 6f 63 61 74 65 2c 20 72 * to allocate, r
2d260 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 egardless of whe
2d270 74 68 65 72 20 69 74 20 68 61 73 20 6c 65 61 76 ther it has leav
2d280 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 es.. */.
2d290 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 *pPgno =
2d2a0 69 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 iTrunk;.
2d2b0 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e 6b *ppPage = pTrunk
2d2c0 3b 0a 20 20 20 20 20 20 20 20 73 65 61 72 63 68 ;. search
2d2d0 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 List = 0;.
2d2e0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
2d2f0 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d gerWrite(pTrunk-
2d300 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
2d310 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 if( rc ){.
2d320 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
2d330 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
2d340 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
2d350 20 69 66 28 20 6b 3d 3d 30 20 29 7b 0a 20 20 20 if( k==0 ){.
2d360 20 20 20 20 20 20 20 69 66 28 20 21 70 50 72 65 if( !pPre
2d370 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 vTrunk ){.
2d380 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 memcpy(&pP
2d390 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c age1->aData[32],
2d3a0 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
2d3b0 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 0], 4);.
2d3c0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2d3d0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
2d3e0 33 50 61 67 65 72 57 72 69 74 65 28 70 50 72 65 3PagerWrite(pPre
2d3f0 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 vTrunk->pDbPage)
2d400 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
2d410 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
2d420 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2d430 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 goto end_alloca
2d440 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 te_page;.
2d450 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2d460 20 20 20 6d 65 6d 63 70 79 28 26 70 50 72 65 76 memcpy(&pPrev
2d470 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c Trunk->aData[0],
2d480 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
2d490 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 0], 4);.
2d4a0 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
2d4b0 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 e{. /*
2d4c0 54 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 The trunk page i
2d4d0 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68 s required by th
2d4e0 65 20 63 61 6c 6c 65 72 20 62 75 74 20 69 74 20 e caller but it
2d4f0 63 6f 6e 74 61 69 6e 73 20 0a 20 20 20 20 20 20 contains .
2d500 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 73 20 ** pointers
2d510 74 6f 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 to free-list lea
2d520 76 65 73 2e 20 54 68 65 20 66 69 72 73 74 20 6c ves. The first l
2d530 65 61 66 20 62 65 63 6f 6d 65 73 20 61 20 74 72 eaf becomes a tr
2d540 75 6e 6b 0a 20 20 20 20 20 20 20 20 20 20 2a 2a unk. **
2d550 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 63 61 page in this ca
2d560 73 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f se.. */
2d570 0a 20 20 20 20 20 20 20 20 20 20 4d 65 6d 50 61 . MemPa
2d580 67 65 20 2a 70 4e 65 77 54 72 75 6e 6b 3b 0a 20 ge *pNewTrunk;.
2d590 20 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 4e Pgno iN
2d5a0 65 77 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 ewTrunk = get4by
2d5b0 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 te(&pTrunk->aDat
2d5c0 61 5b 38 5d 29 3b 0a 20 20 20 20 20 20 20 20 20 a[8]);.
2d5d0 20 69 66 28 20 69 4e 65 77 54 72 75 6e 6b 3e 6d if( iNewTrunk>m
2d5e0 78 50 61 67 65 20 29 7b 20 0a 20 20 20 20 20 20 xPage ){ .
2d5f0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
2d600 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
2d610 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f goto
2d620 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
2d630 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ge;. }.
2d640 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 testca
2d650 73 65 28 20 69 4e 65 77 54 72 75 6e 6b 3d 3d 6d se( iNewTrunk==m
2d660 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 xPage );.
2d670 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
2d680 50 61 67 65 28 70 42 74 2c 20 69 4e 65 77 54 72 Page(pBt, iNewTr
2d690 75 6e 6b 2c 20 26 70 4e 65 77 54 72 75 6e 6b 2c unk, &pNewTrunk,
2d6a0 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 0);. i
2d6b0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
2d6c0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2d6d0 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 goto end_allocat
2d6e0 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 e_page;.
2d6f0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 72 63 }. rc
2d700 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
2d710 72 69 74 65 28 70 4e 65 77 54 72 75 6e 6b 2d 3e rite(pNewTrunk->
2d720 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
2d730 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
2d740 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
2d750 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
2d760 28 70 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 (pNewTrunk);.
2d770 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
2d780 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
2d790 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
2d7a0 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
2d7b0 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b NewTrunk->aData[
2d7c0 30 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 0], &pTrunk->aDa
2d7d0 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[0], 4);.
2d7e0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
2d7f0 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b NewTrunk->aData[
2d800 34 5d 2c 20 6b 2d 31 29 3b 0a 20 20 20 20 20 20 4], k-1);.
2d810 20 20 20 20 6d 65 6d 63 70 79 28 26 70 4e 65 77 memcpy(&pNew
2d820 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 38 5d 2c Trunk->aData[8],
2d830 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
2d840 31 32 5d 2c 20 28 6b 2d 31 29 2a 34 29 3b 0a 20 12], (k-1)*4);.
2d850 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 release
2d860 50 61 67 65 28 70 4e 65 77 54 72 75 6e 6b 29 3b Page(pNewTrunk);
2d870 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 . if( !
2d880 70 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 pPrevTrunk ){.
2d890 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 assert
2d8a0 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
2d8b0 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 31 writeable(pPage1
2d8c0 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
2d8d0 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 put4by
2d8e0 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
2d8f0 61 5b 33 32 5d 2c 20 69 4e 65 77 54 72 75 6e 6b a[32], iNewTrunk
2d900 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c );. }el
2d910 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 se{.
2d920 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
2d930 72 57 72 69 74 65 28 70 50 72 65 76 54 72 75 6e rWrite(pPrevTrun
2d940 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 k->pDbPage);.
2d950 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 if( rc
2d960 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2d970 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 goto end_alloca
2d980 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 te_page;.
2d990 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2d9a0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 72 put4byte(&pPr
2d9b0 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 evTrunk->aData[0
2d9c0 5d 2c 20 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 ], iNewTrunk);.
2d9d0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2d9e0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 54 72 }. pTr
2d9f0 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 unk = 0;.
2da00 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 TRACE(("ALLOCAT
2da10 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 E: %d trunk - %d
2da20 20 66 72 65 65 20 70 61 67 65 73 20 6c 65 66 74 free pages left
2da30 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 \n", *pPgno, n-1
2da40 29 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 ));.#endif.
2da50 20 7d 65 6c 73 65 20 69 66 28 20 6b 3e 30 20 29 }else if( k>0 )
2da60 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 78 74 {. /* Ext
2da70 72 61 63 74 20 61 20 6c 65 61 66 20 66 72 6f 6d ract a leaf from
2da80 20 74 68 65 20 74 72 75 6e 6b 20 2a 2f 0a 20 20 the trunk */.
2da90 20 20 20 20 20 20 75 33 32 20 63 6c 6f 73 65 73 u32 closes
2daa0 74 3b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 t;. Pgno
2dab0 69 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 75 iPage;. u
2dac0 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 61 44 nsigned char *aD
2dad0 61 74 61 20 3d 20 70 54 72 75 6e 6b 2d 3e 61 44 ata = pTrunk->aD
2dae0 61 74 61 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ata;. if(
2daf0 20 6e 65 61 72 62 79 3e 30 20 29 7b 0a 20 20 20 nearby>0 ){.
2db00 20 20 20 20 20 20 20 75 33 32 20 69 3b 0a 20 20 u32 i;.
2db10 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 20 closest
2db20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 69 = 0;. i
2db30 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f f( eMode==BTALLO
2db40 43 5f 4c 45 20 29 7b 0a 20 20 20 20 20 20 20 20 C_LE ){.
2db50 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6b for(i=0; i<k
2db60 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 ; i++){.
2db70 20 20 20 20 20 20 69 50 61 67 65 20 3d 20 67 65 iPage = ge
2db80 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 2b t4byte(&aData[8+
2db90 69 2a 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 20 i*4]);.
2dba0 20 20 20 20 20 69 66 28 20 69 50 61 67 65 3c 3d if( iPage<=
2dbb0 6e 65 61 72 62 79 20 29 7b 0a 20 20 20 20 20 20 nearby ){.
2dbc0 20 20 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 closes
2dbd0 74 20 3d 20 69 3b 0a 20 20 20 20 20 20 20 20 20 t = i;.
2dbe0 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
2dbf0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
2dc00 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2dc10 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
2dc20 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 69 73 int dis
2dc30 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 64 t;. d
2dc40 69 73 74 20 3d 20 73 71 6c 69 74 65 33 41 62 73 ist = sqlite3Abs
2dc50 49 6e 74 33 32 28 67 65 74 34 62 79 74 65 28 26 Int32(get4byte(&
2dc60 61 44 61 74 61 5b 38 5d 29 20 2d 20 6e 65 61 72 aData[8]) - near
2dc70 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 by);.
2dc80 20 66 6f 72 28 69 3d 31 3b 20 69 3c 6b 3b 20 69 for(i=1; i<k; i
2dc90 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ++){.
2dca0 20 20 20 69 6e 74 20 64 32 20 3d 20 73 71 6c 69 int d2 = sqli
2dcb0 74 65 33 41 62 73 49 6e 74 33 32 28 67 65 74 34 te3AbsInt32(get4
2dcc0 62 79 74 65 28 26 61 44 61 74 61 5b 38 2b 69 2a byte(&aData[8+i*
2dcd0 34 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 4]) - nearby);.
2dce0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 if(
2dcf0 20 64 32 3c 64 69 73 74 20 29 7b 0a 20 20 20 20 d2<dist ){.
2dd00 20 20 20 20 20 20 20 20 20 20 20 20 63 6c 6f 73 clos
2dd10 65 73 74 20 3d 20 69 3b 0a 20 20 20 20 20 20 20 est = i;.
2dd20 20 20 20 20 20 20 20 20 20 64 69 73 74 20 3d 20 dist =
2dd30 64 32 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 d2;.
2dd40 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
2dd50 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
2dd60 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
2dd70 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d closest =
2dd80 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 0;. }..
2dd90 20 20 20 20 20 20 20 69 50 61 67 65 20 3d 20 67 iPage = g
2dda0 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 et4byte(&aData[8
2ddb0 2b 63 6c 6f 73 65 73 74 2a 34 5d 29 3b 0a 20 20 +closest*4]);.
2ddc0 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
2ddd0 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b iPage==mxPage );
2dde0 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 50 61 . if( iPa
2ddf0 67 65 3e 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 ge>mxPage ){.
2de00 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
2de10 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
2de20 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 . goto
2de30 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 end_allocate_pag
2de40 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 e;. }.
2de50 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 69 testcase( i
2de60 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b 0a Page==mxPage );.
2de70 20 20 20 20 20 20 20 20 69 66 28 20 21 73 65 61 if( !sea
2de80 72 63 68 4c 69 73 74 20 0a 20 20 20 20 20 20 20 rchList .
2de90 20 20 7c 7c 20 28 69 50 61 67 65 3d 3d 6e 65 61 || (iPage==nea
2dea0 72 62 79 20 7c 7c 20 28 69 50 61 67 65 3c 6e 65 rby || (iPage<ne
2deb0 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d 42 arby && eMode==B
2dec0 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 20 TALLOC_LE)) .
2ded0 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 ){.
2dee0 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 3b int noContent;
2def0 0a 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 6e . *pPgn
2df00 6f 20 3d 20 69 50 61 67 65 3b 0a 20 20 20 20 20 o = iPage;.
2df10 20 20 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c TRACE(("ALL
2df20 4f 43 41 54 45 3a 20 25 64 20 77 61 73 20 6c 65 OCATE: %d was le
2df30 61 66 20 25 64 20 6f 66 20 25 64 20 6f 6e 20 74 af %d of %d on t
2df40 72 75 6e 6b 20 25 64 22 0a 20 20 20 20 20 20 20 runk %d".
2df50 20 20 20 20 20 20 20 20 20 20 22 3a 20 25 64 20 ": %d
2df60 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 5c more free pages\
2df70 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 n",.
2df80 20 20 20 20 20 2a 70 50 67 6e 6f 2c 20 63 6c 6f *pPgno, clo
2df90 73 65 73 74 2b 31 2c 20 6b 2c 20 70 54 72 75 6e sest+1, k, pTrun
2dfa0 6b 2d 3e 70 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a k->pgno, n-1));.
2dfb0 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 rc = s
2dfc0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
2dfd0 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 (pTrunk->pDbPage
2dfe0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
2dff0 20 72 63 20 29 20 67 6f 74 6f 20 65 6e 64 5f 61 rc ) goto end_a
2e000 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
2e010 20 20 20 20 20 20 20 20 69 66 28 20 63 6c 6f 73 if( clos
2e020 65 73 74 3c 6b 2d 31 20 29 7b 0a 20 20 20 20 20 est<k-1 ){.
2e030 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 61 memcpy(&a
2e040 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a 34 Data[8+closest*4
2e050 5d 2c 20 26 61 44 61 74 61 5b 34 2b 6b 2a 34 5d ], &aData[4+k*4]
2e060 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 4);.
2e070 7d 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 }. put4
2e080 62 79 74 65 28 26 61 44 61 74 61 5b 34 5d 2c 20 byte(&aData[4],
2e090 6b 2d 31 29 3b 0a 20 20 20 20 20 20 20 20 20 20 k-1);.
2e0a0 6e 6f 43 6f 6e 74 65 6e 74 20 3d 20 21 62 74 72 noContent = !btr
2e0b0 65 65 47 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 eeGetHasContent(
2e0c0 70 42 74 2c 20 2a 70 50 67 6e 6f 29 3f 20 50 41 pBt, *pPgno)? PA
2e0d0 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e GER_GET_NOCONTEN
2e0e0 54 20 3a 20 30 3b 0a 20 20 20 20 20 20 20 20 20 T : 0;.
2e0f0 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
2e100 67 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 ge(pBt, *pPgno,
2e110 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e ppPage, noConten
2e120 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 t);. if
2e130 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2e140 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 ){. r
2e150 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2e160 57 72 69 74 65 28 28 2a 70 70 50 61 67 65 29 2d Write((*ppPage)-
2e170 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
2e180 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 if( rc!=S
2e190 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2e1a0 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 releas
2e1b0 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a ePage(*ppPage);.
2e1c0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
2e1d0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2e1e0 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d searchList =
2e1f0 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 0;. }.
2e200 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 6c 65 }. rele
2e210 61 73 65 50 61 67 65 28 70 50 72 65 76 54 72 75 asePage(pPrevTru
2e220 6e 6b 29 3b 0a 20 20 20 20 20 20 70 50 72 65 76 nk);. pPrev
2e230 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 7d Trunk = 0;. }
2e240 77 68 69 6c 65 28 20 73 65 61 72 63 68 4c 69 73 while( searchLis
2e250 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 t );. }else{.
2e260 20 20 2f 2a 20 54 68 65 72 65 20 61 72 65 20 6e /* There are n
2e270 6f 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 o pages on the f
2e280 72 65 65 6c 69 73 74 2c 20 73 6f 20 61 70 70 65 reelist, so appe
2e290 6e 64 20 61 20 6e 65 77 20 70 61 67 65 20 74 6f nd a new page to
2e2a0 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 the. ** data
2e2b0 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 20 20 20 base image..
2e2c0 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 72 6d 61 6c **. ** Normal
2e2d0 6c 79 2c 20 6e 65 77 20 70 61 67 65 73 20 61 6c ly, new pages al
2e2e0 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 20 located by this
2e2f0 62 6c 6f 63 6b 20 63 61 6e 20 62 65 20 72 65 71 block can be req
2e300 75 65 73 74 65 64 20 66 72 6f 6d 20 74 68 65 0a uested from the.
2e310 20 20 20 20 2a 2a 20 70 61 67 65 72 20 6c 61 79 ** pager lay
2e320 65 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f 2d er with the 'no-
2e330 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 65 content' flag se
2e340 74 2e 20 54 68 69 73 20 70 72 65 76 65 6e 74 73 t. This prevents
2e350 20 74 68 65 20 70 61 67 65 72 0a 20 20 20 20 2a the pager. *
2e360 2a 20 66 72 6f 6d 20 74 72 79 69 6e 67 20 74 6f * from trying to
2e370 20 72 65 61 64 20 74 68 65 20 70 61 67 65 73 20 read the pages
2e380 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 73 content from dis
2e390 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 k. However, if t
2e3a0 68 65 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 6e he. ** curren
2e3b0 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 t transaction ha
2e3c0 73 20 61 6c 72 65 61 64 79 20 72 75 6e 20 6f 6e s already run on
2e3d0 65 20 6f 72 20 6d 6f 72 65 20 69 6e 63 72 65 6d e or more increm
2e3e0 65 6e 74 61 6c 2d 76 61 63 75 75 6d 0a 20 20 20 ental-vacuum.
2e3f0 20 2a 2a 20 73 74 65 70 73 2c 20 74 68 65 6e 20 ** steps, then
2e400 74 68 65 20 70 61 67 65 20 77 65 20 61 72 65 20 the page we are
2e410 61 62 6f 75 74 20 74 6f 20 61 6c 6c 6f 63 61 74 about to allocat
2e420 65 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 63 6f e may contain co
2e430 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 74 68 61 ntent. ** tha
2e440 74 20 69 73 20 72 65 71 75 69 72 65 64 20 69 6e t is required in
2e450 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 the event of a
2e460 72 6f 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 68 69 rollback. In thi
2e470 73 20 63 61 73 65 2c 20 64 6f 0a 20 20 20 20 2a s case, do. *
2e480 2a 20 6e 6f 74 20 73 65 74 20 74 68 65 20 6e 6f * not set the no
2e490 2d 63 6f 6e 74 65 6e 74 20 66 6c 61 67 2e 20 54 -content flag. T
2e4a0 68 69 73 20 63 61 75 73 65 73 20 74 68 65 20 70 his causes the p
2e4b0 61 67 65 72 20 74 6f 20 6c 6f 61 64 20 61 6e 64 ager to load and
2e4c0 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 journal. **
2e4d0 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 the current page
2e4e0 20 63 6f 6e 74 65 6e 74 20 62 65 66 6f 72 65 20 content before
2e4f0 6f 76 65 72 77 72 69 74 69 6e 67 20 69 74 2e 0a overwriting it..
2e500 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f **. ** No
2e510 74 65 20 74 68 61 74 20 74 68 65 20 70 61 67 65 te that the page
2e520 72 20 77 69 6c 6c 20 6e 6f 74 20 61 63 74 75 61 r will not actua
2e530 6c 6c 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6c lly attempt to l
2e540 6f 61 64 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 0a oad or journal .
2e550 20 20 20 20 2a 2a 20 63 6f 6e 74 65 6e 74 20 66 ** content f
2e560 6f 72 20 61 6e 79 20 70 61 67 65 20 74 68 61 74 or any page that
2e570 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 6c 69 65 really does lie
2e580 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
2e590 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
2e5a0 20 20 2a 2a 20 66 69 6c 65 20 6f 6e 20 64 69 73 ** file on dis
2e5b0 6b 2e 20 53 6f 20 74 68 65 20 65 66 66 65 63 74 k. So the effect
2e5c0 73 20 6f 66 20 64 69 73 61 62 6c 69 6e 67 20 74 s of disabling t
2e5d0 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 6f 70 he no-content op
2e5e0 74 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 20 20 2a timization. *
2e5f0 2a 20 68 65 72 65 20 61 72 65 20 63 6f 6e 66 69 * here are confi
2e600 6e 65 64 20 74 6f 20 74 68 6f 73 65 20 70 61 67 ned to those pag
2e610 65 73 20 74 68 61 74 20 6c 69 65 20 62 65 74 77 es that lie betw
2e620 65 65 6e 20 74 68 65 20 65 6e 64 20 6f 66 20 74 een the end of t
2e630 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 he. ** databa
2e640 73 65 20 69 6d 61 67 65 20 61 6e 64 20 74 68 65 se image and the
2e650 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 end of the data
2e660 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a base file.. *
2e670 2f 0a 20 20 20 20 69 6e 74 20 62 4e 6f 43 6f 6e /. int bNoCon
2e680 74 65 6e 74 20 3d 20 28 30 3d 3d 49 66 4e 6f 74 tent = (0==IfNot
2e690 4f 6d 69 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 OmitAV(pBt->bDoT
2e6a0 72 75 6e 63 61 74 65 29 29 3f 20 50 41 47 45 52 runcate))? PAGER
2e6b0 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 3a 30 _GET_NOCONTENT:0
2e6c0 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ;.. rc = sqli
2e6d0 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 42 te3PagerWrite(pB
2e6e0 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 t->pPage1->pDbPa
2e6f0 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 ge);. if( rc
2e700 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
2e710 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 pBt->nPage++;.
2e720 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 if( pBt->nPag
2e730 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f e==PENDING_BYTE_
2e740 50 41 47 45 28 70 42 74 29 20 29 20 70 42 74 2d PAGE(pBt) ) pBt-
2e750 3e 6e 50 61 67 65 2b 2b 3b 0a 0a 23 69 66 6e 64 >nPage++;..#ifnd
2e760 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
2e770 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 UTOVACUUM. if
2e780 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ( pBt->autoVacuu
2e790 6d 20 26 26 20 50 54 52 4d 41 50 5f 49 53 50 41 m && PTRMAP_ISPA
2e7a0 47 45 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 GE(pBt, pBt->nPa
2e7b0 67 65 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 ge) ){. /*
2e7c0 49 66 20 2a 70 50 67 6e 6f 20 72 65 66 65 72 73 If *pPgno refers
2e7d0 20 74 6f 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 to a pointer-ma
2e7e0 70 20 70 61 67 65 2c 20 61 6c 6c 6f 63 61 74 65 p page, allocate
2e7f0 20 74 77 6f 20 6e 65 77 20 70 61 67 65 73 0a 20 two new pages.
2e800 20 20 20 20 20 2a 2a 20 61 74 20 74 68 65 20 65 ** at the e
2e810 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 nd of the file i
2e820 6e 73 74 65 61 64 20 6f 66 20 6f 6e 65 2e 20 54 nstead of one. T
2e830 68 65 20 66 69 72 73 74 20 61 6c 6c 6f 63 61 74 he first allocat
2e840 65 64 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a ed page. **
2e850 20 62 65 63 6f 6d 65 73 20 61 20 6e 65 77 20 70 becomes a new p
2e860 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c ointer-map page,
2e870 20 74 68 65 20 73 65 63 6f 6e 64 20 69 73 20 75 the second is u
2e880 73 65 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 sed by the calle
2e890 72 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 r.. */.
2e8a0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 20 3d MemPage *pPg =
2e8b0 20 30 3b 0a 20 20 20 20 20 20 54 52 41 43 45 28 0;. TRACE(
2e8c0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 ("ALLOCATE: %d f
2e8d0 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 20 rom end of file
2e8e0 28 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 (pointer-map pag
2e8f0 65 29 5c 6e 22 2c 20 70 42 74 2d 3e 6e 50 61 67 e)\n", pBt->nPag
2e900 65 29 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 e));. asser
2e910 74 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 50 t( pBt->nPage!=P
2e920 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
2e930 28 70 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72 (pBt) );. r
2e940 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
2e950 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 65 (pBt, pBt->nPage
2e960 2c 20 26 70 50 67 2c 20 62 4e 6f 43 6f 6e 74 65 , &pPg, bNoConte
2e970 6e 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 nt);. if( r
2e980 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
2e990 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
2e9a0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
2e9b0 50 67 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 Pg->pDbPage);.
2e9c0 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
2e9d0 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a e(pPg);. }.
2e9e0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 if( rc ) r
2e9f0 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
2ea00 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 pBt->nPage++;.
2ea10 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 if( pBt->nPa
2ea20 67 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 ge==PENDING_BYTE
2ea30 5f 50 41 47 45 28 70 42 74 29 20 29 7b 20 70 42 _PAGE(pBt) ){ pB
2ea40 74 2d 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 20 t->nPage++; }.
2ea50 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 }.#endif. p
2ea60 75 74 34 62 79 74 65 28 32 38 20 2b 20 28 75 38 ut4byte(28 + (u8
2ea70 2a 29 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 *)pBt->pPage1->a
2ea80 44 61 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 65 Data, pBt->nPage
2ea90 29 3b 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 );. *pPgno =
2eaa0 70 42 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 20 pBt->nPage;..
2eab0 20 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 assert( *pPgno!
2eac0 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 =PENDING_BYTE_PA
2ead0 47 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 72 GE(pBt) );. r
2eae0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
2eaf0 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 (pBt, *pPgno, pp
2eb00 50 61 67 65 2c 20 62 4e 6f 43 6f 6e 74 65 6e 74 Page, bNoContent
2eb10 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
2eb20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72 return rc;. r
2eb30 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2eb40 57 72 69 74 65 28 28 2a 70 70 50 61 67 65 29 2d Write((*ppPage)-
2eb50 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 >pDbPage);. i
2eb60 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
2eb70 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 ){. releas
2eb80 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a ePage(*ppPage);.
2eb90 20 20 20 20 7d 0a 20 20 20 20 54 52 41 43 45 28 }. TRACE(
2eba0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 ("ALLOCATE: %d f
2ebb0 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 5c rom end of file\
2ebc0 6e 22 2c 20 2a 70 50 67 6e 6f 29 29 3b 0a 20 20 n", *pPgno));.
2ebd0 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 2a 70 50 }.. assert( *pP
2ebe0 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 gno!=PENDING_BYT
2ebf0 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a 0a E_PAGE(pBt) );..
2ec00 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 end_allocate_pag
2ec10 65 3a 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 e:. releasePage
2ec20 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 6c 65 (pTrunk);. rele
2ec30 61 73 65 50 61 67 65 28 70 50 72 65 76 54 72 75 asePage(pPrevTru
2ec40 6e 6b 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 nk);. if( rc==S
2ec50 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2ec60 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 if( sqlite3Pager
2ec70 50 61 67 65 52 65 66 63 6f 75 6e 74 28 28 2a 70 PageRefcount((*p
2ec80 70 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 pPage)->pDbPage)
2ec90 3e 31 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 >1 ){. rele
2eca0 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 asePage(*ppPage)
2ecb0 3b 0a 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 ;. *ppPage
2ecc0 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 75 72 = 0;. retur
2ecd0 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
2ece0 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 _BKPT;. }.
2ecf0 20 28 2a 70 70 50 61 67 65 29 2d 3e 69 73 49 6e (*ppPage)->isIn
2ed00 69 74 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b it = 0;. }else{
2ed10 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30 . *ppPage = 0
2ed20 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
2ed30 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc!=SQLITE_OK ||
2ed40 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
2ed50 72 69 74 65 61 62 6c 65 28 28 2a 70 70 50 61 67 riteable((*ppPag
2ed60 65 29 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a e)->pDbPage) );.
2ed70 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
2ed80 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
2ed90 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 ion is used to a
2eda0 64 64 20 70 61 67 65 20 69 50 61 67 65 20 74 6f dd page iPage to
2edb0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
2edc0 6c 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 0a 2a le free-list. .*
2edd0 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 * It is assumed
2ede0 74 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 that the page is
2edf0 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 70 not already a p
2ee00 61 72 74 20 6f 66 20 74 68 65 20 66 72 65 65 2d art of the free-
2ee10 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 list..**.** The
2ee20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 20 value passed as
2ee30 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d the second argum
2ee40 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 ent to this func
2ee50 74 69 6f 6e 20 69 73 20 6f 70 74 69 6f 6e 61 6c tion is optional
2ee60 2e 0a 2a 2a 20 49 66 20 74 68 65 20 63 61 6c 6c ..** If the call
2ee70 65 72 20 68 61 70 70 65 6e 73 20 74 6f 20 68 61 er happens to ha
2ee80 76 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 ve a pointer to
2ee90 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 the MemPage obje
2eea0 63 74 20 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e ct .** correspon
2eeb0 64 69 6e 67 20 74 6f 20 70 61 67 65 20 69 50 61 ding to page iPa
2eec0 67 65 20 68 61 6e 64 79 2c 20 69 74 20 6d 61 79 ge handy, it may
2eed0 20 70 61 73 73 20 69 74 20 61 73 20 74 68 65 20 pass it as the
2eee0 73 65 63 6f 6e 64 20 76 61 6c 75 65 2e 20 0a 2a second value. .*
2eef0 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 * Otherwise, it
2ef00 6d 61 79 20 70 61 73 73 20 4e 55 4c 4c 2e 0a 2a may pass NULL..*
2ef10 2a 0a 2a 2a 20 49 66 20 61 20 70 6f 69 6e 74 65 *.** If a pointe
2ef20 72 20 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 6f r to a MemPage o
2ef30 62 6a 65 63 74 20 69 73 20 70 61 73 73 65 64 20 bject is passed
2ef40 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 as the second ar
2ef50 67 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 73 20 72 gument,.** its r
2ef60 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 69 eference count i
2ef70 73 20 6e 6f 74 20 61 6c 74 65 72 65 64 20 62 79 s not altered by
2ef80 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a this function..
2ef90 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 72 */.static int fr
2efa0 65 65 50 61 67 65 32 28 42 74 53 68 61 72 65 64 eePage2(BtShared
2efb0 20 2a 70 42 74 2c 20 4d 65 6d 50 61 67 65 20 2a *pBt, MemPage *
2efc0 70 4d 65 6d 50 61 67 65 2c 20 50 67 6e 6f 20 69 pMemPage, Pgno i
2efd0 50 61 67 65 29 7b 0a 20 20 4d 65 6d 50 61 67 65 Page){. MemPage
2efe0 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 *pTrunk = 0;
2eff0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2f000 46 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 Free-list trunk
2f010 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 page */. Pgno i
2f020 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 20 20 Trunk = 0;
2f030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2f040 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 Page number of
2f050 66 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 free-list trunk
2f060 70 61 67 65 20 2a 2f 20 0a 20 20 4d 65 6d 50 61 page */ . MemPa
2f070 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 ge *pPage1 = pBt
2f080 2d 3e 70 50 61 67 65 31 3b 20 20 20 20 20 20 2f ->pPage1; /
2f090 2a 20 4c 6f 63 61 6c 20 72 65 66 65 72 65 6e 63 * Local referenc
2f0a0 65 20 74 6f 20 70 61 67 65 20 31 20 2a 2f 0a 20 e to page 1 */.
2f0b0 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
2f0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f0d0 20 20 20 20 20 2f 2a 20 50 61 67 65 20 62 65 69 /* Page bei
2f0e0 6e 67 20 66 72 65 65 64 2e 20 4d 61 79 20 62 65 ng freed. May be
2f0f0 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 6e 74 20 NULL. */. int
2f100 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
2f110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f120 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20 2a /* Return Code *
2f130 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b 20 20 /. int nFree;
2f140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f150 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 /* Initi
2f160 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 al number of pag
2f170 65 73 20 6f 6e 20 66 72 65 65 2d 6c 69 73 74 20 es on free-list
2f180 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 */.. assert( sq
2f190 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
2f1a0 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
2f1b0 20 20 61 73 73 65 72 74 28 20 69 50 61 67 65 3e assert( iPage>
2f1c0 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 1 );. assert( !
2f1d0 70 4d 65 6d 50 61 67 65 20 7c 7c 20 70 4d 65 6d pMemPage || pMem
2f1e0 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 67 Page->pgno==iPag
2f1f0 65 20 29 3b 0a 0a 20 20 69 66 28 20 70 4d 65 6d e );.. if( pMem
2f200 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 Page ){. pPag
2f210 65 20 3d 20 70 4d 65 6d 50 61 67 65 3b 0a 20 20 e = pMemPage;.
2f220 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 sqlite3PagerRe
2f230 66 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 f(pPage->pDbPage
2f240 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
2f250 70 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 pPage = btreePag
2f260 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 69 50 61 eLookup(pBt, iPa
2f270 67 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 ge);. }.. /* I
2f280 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 65 ncrement the fre
2f290 65 20 70 61 67 65 20 63 6f 75 6e 74 20 6f 6e 20 e page count on
2f2a0 70 50 61 67 65 31 20 2a 2f 0a 20 20 72 63 20 3d pPage1 */. rc =
2f2b0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
2f2c0 74 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 te(pPage1->pDbPa
2f2d0 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 ge);. if( rc )
2f2e0 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 goto freepage_ou
2f2f0 74 3b 0a 20 20 6e 46 72 65 65 20 3d 20 67 65 74 t;. nFree = get
2f300 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
2f310 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 70 75 74 Data[36]);. put
2f320 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
2f330 44 61 74 61 5b 33 36 5d 2c 20 6e 46 72 65 65 2b Data[36], nFree+
2f340 31 29 3b 0a 0a 20 20 69 66 28 20 70 42 74 2d 3e 1);.. if( pBt->
2f350 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 btsFlags & BTS_S
2f360 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a ECURE_DELETE ){.
2f370 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 73 65 /* If the se
2f380 63 75 72 65 5f 64 65 6c 65 74 65 20 6f 70 74 69 cure_delete opti
2f390 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 on is enabled, t
2f3a0 68 65 6e 0a 20 20 20 20 2a 2a 20 61 6c 77 61 79 hen. ** alway
2f3b0 73 20 66 75 6c 6c 79 20 6f 76 65 72 77 72 69 74 s fully overwrit
2f3c0 65 20 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 6d e deleted inform
2f3d0 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 ation with zeros
2f3e0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
2f3f0 20 28 21 70 50 61 67 65 20 26 26 20 28 28 72 63 (!pPage && ((rc
2f400 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
2f410 70 42 74 2c 20 69 50 61 67 65 2c 20 26 70 50 61 pBt, iPage, &pPa
2f420 67 65 2c 20 30 29 29 21 3d 30 29 20 29 0a 20 20 ge, 0))!=0) ).
2f430 20 20 20 7c 7c 20 20 20 20 20 20 20 20 20 20 20 ||
2f440 20 28 28 72 63 20 3d 20 73 71 6c 69 74 65 33 50 ((rc = sqlite3P
2f450 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 2d agerWrite(pPage-
2f460 3e 70 44 62 50 61 67 65 29 29 21 3d 30 29 0a 20 >pDbPage))!=0).
2f470 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f ){. goto
2f480 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 freepage_out;.
2f490 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28 }. memset(
2f4a0 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 30 2c pPage->aData, 0,
2f4b0 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 61 67 pPage->pBt->pag
2f4c0 65 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f eSize);. }.. /
2f4d0 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 * If the databas
2f4e0 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d e supports auto-
2f4f0 76 61 63 75 75 6d 2c 20 77 72 69 74 65 20 61 6e vacuum, write an
2f500 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 70 6f entry in the po
2f510 69 6e 74 65 72 2d 6d 61 70 0a 20 20 2a 2a 20 74 inter-map. ** t
2f520 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 o indicate that
2f530 74 68 65 20 70 61 67 65 20 69 73 20 66 72 65 65 the page is free
2f540 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 49 53 41 .. */. if( ISA
2f550 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 UTOVACUUM ){.
2f560 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 ptrmapPut(pBt,
2f570 69 50 61 67 65 2c 20 50 54 52 4d 41 50 5f 46 52 iPage, PTRMAP_FR
2f580 45 45 50 41 47 45 2c 20 30 2c 20 26 72 63 29 3b EEPAGE, 0, &rc);
2f590 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 67 6f . if( rc ) go
2f5a0 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b to freepage_out;
2f5b0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 6d . }.. /* Now m
2f5c0 61 6e 69 70 75 6c 61 74 65 20 74 68 65 20 61 63 anipulate the ac
2f5d0 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 66 72 tual database fr
2f5e0 65 65 2d 6c 69 73 74 20 73 74 72 75 63 74 75 72 ee-list structur
2f5f0 65 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 6f e. There are two
2f600 0a 20 20 2a 2a 20 70 6f 73 73 69 62 69 6c 69 74 . ** possibilit
2f610 69 65 73 2e 20 49 66 20 74 68 65 20 66 72 65 65 ies. If the free
2f620 2d 6c 69 73 74 20 69 73 20 63 75 72 72 65 6e 74 -list is current
2f630 6c 79 20 65 6d 70 74 79 2c 20 6f 72 20 69 66 20 ly empty, or if
2f640 74 68 65 20 66 69 72 73 74 0a 20 20 2a 2a 20 74 the first. ** t
2f650 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 65 runk page in the
2f660 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 75 free-list is fu
2f670 6c 6c 2c 20 74 68 65 6e 20 74 68 69 73 20 70 61 ll, then this pa
2f680 67 65 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 61 ge will become a
2f690 0a 20 20 2a 2a 20 6e 65 77 20 66 72 65 65 2d 6c . ** new free-l
2f6a0 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 ist trunk page.
2f6b0 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 77 69 Otherwise, it wi
2f6c0 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6c 65 61 66 ll become a leaf
2f6d0 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 66 69 72 of the. ** fir
2f6e0 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e st trunk page in
2f6f0 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 72 65 the current fre
2f700 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 62 6c 6f e-list. This blo
2f710 63 6b 20 74 65 73 74 73 20 69 66 20 69 74 0a 20 ck tests if it.
2f720 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 6c 65 20 ** is possible
2f730 74 6f 20 61 64 64 20 74 68 65 20 70 61 67 65 20 to add the page
2f740 61 73 20 61 20 6e 65 77 20 66 72 65 65 2d 6c 69 as a new free-li
2f750 73 74 20 6c 65 61 66 2e 0a 20 20 2a 2f 0a 20 20 st leaf.. */.
2f760 69 66 28 20 6e 46 72 65 65 21 3d 30 20 29 7b 0a if( nFree!=0 ){.
2f770 20 20 20 20 75 33 32 20 6e 4c 65 61 66 3b 20 20 u32 nLeaf;
2f780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2f790 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 72 20 Initial number
2f7a0 6f 66 20 6c 65 61 66 20 63 65 6c 6c 73 20 6f 6e of leaf cells on
2f7b0 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a 0a trunk page */..
2f7c0 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 iTrunk = get
2f7d0 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
2f7e0 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 72 Data[32]);. r
2f7f0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
2f800 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 (pBt, iTrunk, &p
2f810 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 69 Trunk, 0);. i
2f820 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
2f830 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 ){. goto f
2f840 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 reepage_out;.
2f850 20 7d 0a 0a 20 20 20 20 6e 4c 65 61 66 20 3d 20 }.. nLeaf =
2f860 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b get4byte(&pTrunk
2f870 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 ->aData[4]);.
2f880 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 73 assert( pBt->us
2f890 61 62 6c 65 53 69 7a 65 3e 33 32 20 29 3b 0a 20 ableSize>32 );.
2f8a0 20 20 20 69 66 28 20 6e 4c 65 61 66 20 3e 20 28 if( nLeaf > (
2f8b0 75 33 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 u32)pBt->usableS
2f8c0 69 7a 65 2f 34 20 2d 20 32 20 29 7b 0a 20 20 20 ize/4 - 2 ){.
2f8d0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
2f8e0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
2f8f0 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 goto freepage
2f900 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 _out;. }.
2f910 69 66 28 20 6e 4c 65 61 66 20 3c 20 28 75 33 32 if( nLeaf < (u32
2f920 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 )pBt->usableSize
2f930 2f 34 20 2d 20 38 20 29 7b 0a 20 20 20 20 20 20 /4 - 8 ){.
2f940 2f 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 /* In this case
2f950 74 68 65 72 65 20 69 73 20 72 6f 6f 6d 20 6f 6e there is room on
2f960 20 74 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 the trunk page
2f970 74 6f 20 69 6e 73 65 72 74 20 74 68 65 20 70 61 to insert the pa
2f980 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 65 69 6e ge. ** bein
2f990 67 20 66 72 65 65 64 20 61 73 20 61 20 6e 65 77 g freed as a new
2f9a0 20 6c 65 61 66 2e 0a 20 20 20 20 20 20 2a 2a 0a leaf.. **.
2f9b0 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 ** Note th
2f9c0 61 74 20 74 68 65 20 74 72 75 6e 6b 20 70 61 67 at the trunk pag
2f9d0 65 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 e is not really
2f9e0 66 75 6c 6c 20 75 6e 74 69 6c 20 69 74 20 63 6f full until it co
2f9f0 6e 74 61 69 6e 73 0a 20 20 20 20 20 20 2a 2a 20 ntains. **
2fa00 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 usableSize/4 - 2
2fa10 20 65 6e 74 72 69 65 73 2c 20 6e 6f 74 20 75 73 entries, not us
2fa20 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 ableSize/4 - 8 e
2fa30 6e 74 72 69 65 73 20 61 73 20 77 65 20 68 61 76 ntries as we hav
2fa40 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f 64 65 64 e. ** coded
2fa50 2e 20 20 42 75 74 20 64 75 65 20 74 6f 20 61 20 . But due to a
2fa60 63 6f 64 69 6e 67 20 65 72 72 6f 72 20 69 6e 20 coding error in
2fa70 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 versions of SQLi
2fa80 74 65 20 70 72 69 6f 72 20 74 6f 0a 20 20 20 20 te prior to.
2fa90 20 20 2a 2a 20 33 2e 36 2e 30 2c 20 64 61 74 61 ** 3.6.0, data
2faa0 62 61 73 65 73 20 77 69 74 68 20 66 72 65 65 6c bases with freel
2fab0 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 73 20 ist trunk pages
2fac0 68 6f 6c 64 69 6e 67 20 6d 6f 72 65 20 74 68 61 holding more tha
2fad0 6e 0a 20 20 20 20 20 20 2a 2a 20 75 73 61 62 6c n. ** usabl
2fae0 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 6e 74 72 eSize/4 - 8 entr
2faf0 69 65 73 20 77 69 6c 6c 20 62 65 20 72 65 70 6f ies will be repo
2fb00 72 74 65 64 20 61 73 20 63 6f 72 72 75 70 74 2e rted as corrupt.
2fb10 20 20 49 6e 20 6f 72 64 65 72 0a 20 20 20 20 20 In order.
2fb20 20 2a 2a 20 74 6f 20 6d 61 69 6e 74 61 69 6e 20 ** to maintain
2fb30 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 backwards compat
2fb40 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c 64 ibility with old
2fb50 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 er versions of S
2fb60 51 4c 69 74 65 2c 0a 20 20 20 20 20 20 2a 2a 20 QLite,. **
2fb70 77 65 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 we will continue
2fb80 20 74 6f 20 72 65 73 74 72 69 63 74 20 74 68 65 to restrict the
2fb90 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 number of entri
2fba0 65 73 20 74 6f 20 75 73 61 62 6c 65 53 69 7a 65 es to usableSize
2fbb0 2f 34 20 2d 20 38 0a 20 20 20 20 20 20 2a 2a 20 /4 - 8. **
2fbc0 66 6f 72 20 6e 6f 77 2e 20 20 41 74 20 73 6f 6d for now. At som
2fbd0 65 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 e point in the f
2fbe0 75 74 75 72 65 20 28 6f 6e 63 65 20 65 76 65 72 uture (once ever
2fbf0 79 6f 6e 65 20 68 61 73 20 75 70 67 72 61 64 65 yone has upgrade
2fc00 64 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 33 2e d. ** to 3.
2fc10 36 2e 30 20 6f 72 20 6c 61 74 65 72 29 20 77 65 6.0 or later) we
2fc20 20 73 68 6f 75 6c 64 20 63 6f 6e 73 69 64 65 72 should consider
2fc30 20 66 69 78 69 6e 67 20 74 68 65 20 63 6f 6e 64 fixing the cond
2fc40 69 74 69 6f 6e 61 6c 20 61 62 6f 76 65 0a 20 20 itional above.
2fc50 20 20 20 20 2a 2a 20 74 6f 20 72 65 61 64 20 22 ** to read "
2fc60 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d 32 22 20 usableSize/4-2"
2fc70 69 6e 73 74 65 61 64 20 6f 66 20 22 75 73 61 62 instead of "usab
2fc80 6c 65 53 69 7a 65 2f 34 2d 38 22 2e 0a 20 20 20 leSize/4-8"..
2fc90 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 45 **. ** E
2fca0 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 39 VIDENCE-OF: R-19
2fcb0 39 32 30 2d 31 31 35 37 36 20 48 6f 77 65 76 65 920-11576 Howeve
2fcc0 72 2c 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e r, newer version
2fcd0 73 20 6f 66 20 53 51 4c 69 74 65 20 73 74 69 6c s of SQLite stil
2fce0 6c 0a 20 20 20 20 20 20 2a 2a 20 61 76 6f 69 64 l. ** avoid
2fcf0 20 75 73 69 6e 67 20 74 68 65 20 6c 61 73 74 20 using the last
2fd00 73 69 78 20 65 6e 74 72 69 65 73 20 69 6e 20 74 six entries in t
2fd10 68 65 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e he freelist trun
2fd20 6b 20 70 61 67 65 20 61 72 72 61 79 20 69 6e 0a k page array in.
2fd30 20 20 20 20 20 20 2a 2a 20 6f 72 64 65 72 20 74 ** order t
2fd40 68 61 74 20 64 61 74 61 62 61 73 65 20 66 69 6c hat database fil
2fd50 65 73 20 63 72 65 61 74 65 64 20 62 79 20 6e 65 es created by ne
2fd60 77 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 wer versions of
2fd70 53 51 4c 69 74 65 20 63 61 6e 20 62 65 0a 20 20 SQLite can be.
2fd80 20 20 20 20 2a 2a 20 72 65 61 64 20 62 79 20 6f ** read by o
2fd90 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 lder versions of
2fda0 20 53 51 4c 69 74 65 2e 0a 20 20 20 20 20 20 2a SQLite.. *
2fdb0 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c /. rc = sql
2fdc0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
2fdd0 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
2fde0 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
2fdf0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2fe00 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 54 put4byte(&pT
2fe10 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 runk->aData[4],
2fe20 6e 4c 65 61 66 2b 31 29 3b 0a 20 20 20 20 20 20 nLeaf+1);.
2fe30 20 20 70 75 74 34 62 79 74 65 28 26 70 54 72 75 put4byte(&pTru
2fe40 6e 6b 2d 3e 61 44 61 74 61 5b 38 2b 6e 4c 65 61 nk->aData[8+nLea
2fe50 66 2a 34 5d 2c 20 69 50 61 67 65 29 3b 0a 20 20 f*4], iPage);.
2fe60 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 20 if( pPage
2fe70 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 && (pBt->btsFlag
2fe80 73 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 s & BTS_SECURE_D
2fe90 45 4c 45 54 45 29 3d 3d 30 20 29 7b 0a 20 20 20 ELETE)==0 ){.
2fea0 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 sqlite3Pa
2feb0 67 65 72 44 6f 6e 74 57 72 69 74 65 28 70 50 61 gerDontWrite(pPa
2fec0 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 ge->pDbPage);.
2fed0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2fee0 72 63 20 3d 20 62 74 72 65 65 53 65 74 48 61 73 rc = btreeSetHas
2fef0 43 6f 6e 74 65 6e 74 28 70 42 74 2c 20 69 50 61 Content(pBt, iPa
2ff00 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ge);. }.
2ff10 20 20 20 54 52 41 43 45 28 28 22 46 52 45 45 2d TRACE(("FREE-
2ff20 50 41 47 45 3a 20 25 64 20 6c 65 61 66 20 6f 6e PAGE: %d leaf on
2ff30 20 74 72 75 6e 6b 20 70 61 67 65 20 25 64 5c 6e trunk page %d\n
2ff40 22 2c 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 70 54 ",pPage->pgno,pT
2ff50 72 75 6e 6b 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 runk->pgno));.
2ff60 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 goto freepag
2ff70 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d e_out;. }. }
2ff80 0a 0a 20 20 2f 2a 20 49 66 20 63 6f 6e 74 72 6f .. /* If contro
2ff90 6c 20 66 6c 6f 77 73 20 74 6f 20 74 68 69 73 20 l flows to this
2ffa0 70 6f 69 6e 74 2c 20 74 68 65 6e 20 69 74 20 77 point, then it w
2ffb0 61 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 as not possible
2ffc0 74 6f 20 61 64 64 20 74 68 65 0a 20 20 2a 2a 20 to add the. **
2ffd0 74 68 65 20 70 61 67 65 20 62 65 69 6e 67 20 66 the page being f
2ffe0 72 65 65 64 20 61 73 20 61 20 6c 65 61 66 20 70 reed as a leaf p
2fff0 61 67 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 age of the first
30000 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 20 66 72 trunk in the fr
30010 65 65 2d 6c 69 73 74 2e 0a 20 20 2a 2a 20 50 6f ee-list.. ** Po
30020 73 73 69 62 6c 79 20 62 65 63 61 75 73 65 20 74 ssibly because t
30030 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 he free-list is
30040 65 6d 70 74 79 2c 20 6f 72 20 70 6f 73 73 69 62 empty, or possib
30050 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20 0a ly because the .
30060 20 20 2a 2a 20 66 69 72 73 74 20 74 72 75 6e 6b ** first trunk
30070 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 in the free-lis
30080 74 20 69 73 20 66 75 6c 6c 2e 20 45 69 74 68 65 t is full. Eithe
30090 72 20 77 61 79 2c 20 74 68 65 20 70 61 67 65 20 r way, the page
300a0 62 65 69 6e 67 20 66 72 65 65 64 0a 20 20 2a 2a being freed. **
300b0 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 will become the
300c0 20 6e 65 77 20 66 69 72 73 74 20 74 72 75 6e 6b new first trunk
300d0 20 70 61 67 65 20 69 6e 20 74 68 65 20 66 72 65 page in the fre
300e0 65 2d 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 69 e-list.. */. i
300f0 66 28 20 70 50 61 67 65 3d 3d 30 20 26 26 20 53 f( pPage==0 && S
30100 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 QLITE_OK!=(rc =
30110 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
30120 2c 20 69 50 61 67 65 2c 20 26 70 50 61 67 65 2c , iPage, &pPage,
30130 20 30 29 29 20 29 7b 0a 20 20 20 20 67 6f 74 6f 0)) ){. goto
30140 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 freepage_out;.
30150 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
30160 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 3PagerWrite(pPag
30170 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 e->pDbPage);. i
30180 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
30190 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 ){. goto fre
301a0 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 epage_out;. }.
301b0 20 70 75 74 34 62 79 74 65 28 70 50 61 67 65 2d put4byte(pPage-
301c0 3e 61 44 61 74 61 2c 20 69 54 72 75 6e 6b 29 3b >aData, iTrunk);
301d0 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 . put4byte(&pPa
301e0 67 65 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 30 29 ge->aData[4], 0)
301f0 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 50 ;. put4byte(&pP
30200 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c age1->aData[32],
30210 20 69 50 61 67 65 29 3b 0a 20 20 54 52 41 43 45 iPage);. TRACE
30220 28 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 64 (("FREE-PAGE: %d
30230 20 6e 65 77 20 74 72 75 6e 6b 20 70 61 67 65 20 new trunk page
30240 72 65 70 6c 61 63 69 6e 67 20 25 64 5c 6e 22 2c replacing %d\n",
30250 20 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 69 54 pPage->pgno, iT
30260 72 75 6e 6b 29 29 3b 0a 0a 66 72 65 65 70 61 67 runk));..freepag
30270 65 5f 6f 75 74 3a 0a 20 20 69 66 28 20 70 50 61 e_out:. if( pPa
30280 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d ge ){. pPage-
30290 3e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d >isInit = 0;. }
302a0 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 . releasePage(p
302b0 50 61 67 65 29 3b 0a 20 20 72 65 6c 65 61 73 65 Page);. release
302c0 50 61 67 65 28 70 54 72 75 6e 6b 29 3b 0a 20 20 Page(pTrunk);.
302d0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 return rc;.}.sta
302e0 74 69 63 20 76 6f 69 64 20 66 72 65 65 50 61 67 tic void freePag
302f0 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 e(MemPage *pPage
30300 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 69 , int *pRC){. i
30310 66 28 20 28 2a 70 52 43 29 3d 3d 53 51 4c 49 54 f( (*pRC)==SQLIT
30320 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 43 E_OK ){. *pRC
30330 20 3d 20 66 72 65 65 50 61 67 65 32 28 70 50 61 = freePage2(pPa
30340 67 65 2d 3e 70 42 74 2c 20 70 50 61 67 65 2c 20 ge->pBt, pPage,
30350 70 50 61 67 65 2d 3e 70 67 6e 6f 29 3b 0a 20 20 pPage->pgno);.
30360 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 }.}../*.** Free
30370 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 any overflow pag
30380 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 es associated wi
30390 74 68 20 74 68 65 20 67 69 76 65 6e 20 43 65 6c th the given Cel
303a0 6c 2e 20 20 57 72 69 74 65 20 74 68 65 0a 2a 2a l. Write the.**
303b0 20 6c 6f 63 61 6c 20 43 65 6c 6c 20 73 69 7a 65 local Cell size
303c0 20 28 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 (the number of
303d0 62 79 74 65 73 20 6f 6e 20 74 68 65 20 6f 72 69 bytes on the ori
303e0 67 69 6e 61 6c 20 70 61 67 65 2c 20 6f 6d 69 74 ginal page, omit
303f0 74 69 6e 67 0a 2a 2a 20 6f 76 65 72 66 6c 6f 77 ting.** overflow
30400 29 20 69 6e 74 6f 20 2a 70 6e 53 69 7a 65 2e 0a ) into *pnSize..
30410 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6c */.static int cl
30420 65 61 72 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 earCell(. MemPa
30430 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 ge *pPage,
30440 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 /* The page
30450 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
30460 65 20 43 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 69 e Cell */. unsi
30470 67 6e 65 64 20 63 68 61 72 20 2a 70 43 65 6c 6c gned char *pCell
30480 2c 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 , /* First by
30490 74 65 20 6f 66 20 74 68 65 20 43 65 6c 6c 20 2a te of the Cell *
304a0 2f 0a 20 20 75 31 36 20 2a 70 6e 53 69 7a 65 20 /. u16 *pnSize
304b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
304c0 57 72 69 74 65 20 74 68 65 20 73 69 7a 65 20 6f Write the size o
304d0 66 20 74 68 65 20 43 65 6c 6c 20 68 65 72 65 20 f the Cell here
304e0 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 64 */.){. BtShared
304f0 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 *pBt = pPage->p
30500 42 74 3b 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 69 Bt;. CellInfo i
30510 6e 66 6f 3b 0a 20 20 50 67 6e 6f 20 6f 76 66 6c nfo;. Pgno ovfl
30520 50 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 3b 0a Pgno;. int rc;.
30530 20 20 69 6e 74 20 6e 4f 76 66 6c 3b 0a 20 20 75 int nOvfl;. u
30540 33 32 20 6f 76 66 6c 50 61 67 65 53 69 7a 65 3b 32 ovflPageSize;
30550 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
30560 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
30570 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
30580 29 20 29 3b 0a 20 20 62 74 72 65 65 50 61 72 73 ) );. btreePars
30590 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 eCellPtr(pPage,
305a0 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 pCell, &info);.
305b0 20 2a 70 6e 53 69 7a 65 20 3d 20 69 6e 66 6f 2e *pnSize = info.
305c0 6e 53 69 7a 65 3b 0a 20 20 69 66 28 20 69 6e 66 nSize;. if( inf
305d0 6f 2e 69 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 29 o.iOverflow==0 )
305e0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
305f0 49 54 45 5f 4f 4b 3b 20 20 2f 2a 20 4e 6f 20 6f ITE_OK; /* No o
30600 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 52 verflow pages. R
30610 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 64 6f eturn without do
30620 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 2a 2f 0a ing anything */.
30630 20 20 7d 0a 20 20 69 66 28 20 70 43 65 6c 6c 2b }. if( pCell+
30640 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 2b 33 info.iOverflow+3
30650 20 3e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 2b > pPage->aData+
30660 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 pPage->maskPage
30670 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
30680 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
30690 54 3b 20 20 2f 2a 20 43 65 6c 6c 20 65 78 74 65 T; /* Cell exte
306a0 6e 64 73 20 70 61 73 74 20 65 6e 64 20 6f 66 20 nds past end of
306b0 70 61 67 65 20 2a 2f 0a 20 20 7d 0a 20 20 6f 76 page */. }. ov
306c0 66 6c 50 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 flPgno = get4byt
306d0 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f e(&pCell[info.iO
306e0 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 61 73 73 verflow]);. ass
306f0 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 ert( pBt->usable
30700 53 69 7a 65 20 3e 20 34 20 29 3b 0a 20 20 6f 76 Size > 4 );. ov
30710 66 6c 50 61 67 65 53 69 7a 65 20 3d 20 70 42 74 flPageSize = pBt
30720 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 ->usableSize - 4
30730 3b 0a 20 20 6e 4f 76 66 6c 20 3d 20 28 69 6e 66 ;. nOvfl = (inf
30740 6f 2e 6e 50 61 79 6c 6f 61 64 20 2d 20 69 6e 66 o.nPayload - inf
30750 6f 2e 6e 4c 6f 63 61 6c 20 2b 20 6f 76 66 6c 50 o.nLocal + ovflP
30760 61 67 65 53 69 7a 65 20 2d 20 31 29 2f 6f 76 66 ageSize - 1)/ovf
30770 6c 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 73 lPageSize;. ass
30780 65 72 74 28 20 6f 76 66 6c 50 67 6e 6f 3d 3d 30 ert( ovflPgno==0
30790 20 7c 7c 20 6e 4f 76 66 6c 3e 30 20 29 3b 0a 20 || nOvfl>0 );.
307a0 20 77 68 69 6c 65 28 20 6e 4f 76 66 6c 2d 2d 20 while( nOvfl--
307b0 29 7b 0a 20 20 20 20 50 67 6e 6f 20 69 4e 65 78 ){. Pgno iNex
307c0 74 20 3d 20 30 3b 0a 20 20 20 20 4d 65 6d 50 61 t = 0;. MemPa
307d0 67 65 20 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 ge *pOvfl = 0;.
307e0 20 20 20 69 66 28 20 6f 76 66 6c 50 67 6e 6f 3c if( ovflPgno<
307f0 32 20 7c 7c 20 6f 76 66 6c 50 67 6e 6f 3e 62 74 2 || ovflPgno>bt
30800 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
30810 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 30 20 ) ){. /* 0
30820 69 73 20 6e 6f 74 20 61 20 6c 65 67 61 6c 20 70 is not a legal p
30830 61 67 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 age number and p
30840 61 67 65 20 31 20 63 61 6e 6e 6f 74 20 62 65 20 age 1 cannot be
30850 61 6e 20 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 an . ** ove
30860 72 66 6c 6f 77 20 70 61 67 65 2e 20 54 68 65 72 rflow page. Ther
30870 65 66 6f 72 65 20 69 66 20 6f 76 66 6c 50 67 6e efore if ovflPgn
30880 6f 3c 32 20 6f 72 20 70 61 73 74 20 74 68 65 20 o<2 or past the
30890 65 6e 64 20 6f 66 20 74 68 65 20 0a 20 20 20 20 end of the .
308a0 20 20 2a 2a 20 66 69 6c 65 20 74 68 65 20 64 61 ** file the da
308b0 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 63 tabase must be c
308c0 6f 72 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 20 orrupt. */.
308d0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
308e0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
308f0 20 7d 0a 20 20 20 20 69 66 28 20 6e 4f 76 66 6c }. if( nOvfl
30900 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 67 ){. rc = g
30910 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 70 etOverflowPage(p
30920 42 74 2c 20 6f 76 66 6c 50 67 6e 6f 2c 20 26 70 Bt, ovflPgno, &p
30930 4f 76 66 6c 2c 20 26 69 4e 65 78 74 29 3b 0a 20 Ovfl, &iNext);.
30940 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
30950 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a turn rc;. }..
30960 20 20 20 20 69 66 28 20 28 20 70 4f 76 66 6c 20 if( ( pOvfl
30970 7c 7c 20 28 28 70 4f 76 66 6c 20 3d 20 62 74 72 || ((pOvfl = btr
30980 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 74 eePageLookup(pBt
30990 2c 20 6f 76 66 6c 50 67 6e 6f 29 29 21 3d 30 29 , ovflPgno))!=0)
309a0 20 29 0a 20 20 20 20 20 26 26 20 73 71 6c 69 74 ). && sqlit
309b0 65 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f e3PagerPageRefco
309c0 75 6e 74 28 70 4f 76 66 6c 2d 3e 70 44 62 50 61 unt(pOvfl->pDbPa
309d0 67 65 29 21 3d 31 0a 20 20 20 20 29 7b 0a 20 20 ge)!=1. ){.
309e0 20 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 20 /* There is
309f0 6e 6f 20 72 65 61 73 6f 6e 20 61 6e 79 20 63 75 no reason any cu
30a00 72 73 6f 72 20 73 68 6f 75 6c 64 20 68 61 76 65 rsor should have
30a10 20 61 6e 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 an outstanding
30a20 72 65 66 65 72 65 6e 63 65 20 0a 20 20 20 20 20 reference .
30a30 20 2a 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c ** to an overfl
30a40 6f 77 20 70 61 67 65 20 62 65 6c 6f 6e 67 69 6e ow page belongin
30a50 67 20 74 6f 20 61 20 63 65 6c 6c 20 74 68 61 74 g to a cell that
30a60 20 69 73 20 62 65 69 6e 67 20 64 65 6c 65 74 65 is being delete
30a70 64 2f 75 70 64 61 74 65 64 2e 0a 20 20 20 20 20 d/updated..
30a80 20 2a 2a 20 53 6f 20 69 66 20 74 68 65 72 65 20 ** So if there
30a90 65 78 69 73 74 73 20 6d 6f 72 65 20 74 68 61 6e exists more than
30aa0 20 6f 6e 65 20 72 65 66 65 72 65 6e 63 65 20 74 one reference t
30ab0 6f 20 74 68 69 73 20 70 61 67 65 2c 20 74 68 65 o this page, the
30ac0 6e 20 69 74 20 0a 20 20 20 20 20 20 2a 2a 20 6d n it . ** m
30ad0 75 73 74 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 ust not really b
30ae0 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 e an overflow pa
30af0 67 65 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 ge and the datab
30b00 61 73 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 ase must be corr
30b10 75 70 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 49 upt. . ** I
30b20 74 20 69 73 20 68 65 6c 70 66 75 6c 20 74 6f 20 t is helpful to
30b30 64 65 74 65 63 74 20 74 68 69 73 20 62 65 66 6f detect this befo
30b40 72 65 20 63 61 6c 6c 69 6e 67 20 66 72 65 65 50 re calling freeP
30b50 61 67 65 32 28 29 2c 20 61 73 20 0a 20 20 20 20 age2(), as .
30b60 20 20 2a 2a 20 66 72 65 65 50 61 67 65 32 28 29 ** freePage2()
30b70 20 6d 61 79 20 7a 65 72 6f 20 74 68 65 20 70 61 may zero the pa
30b80 67 65 20 63 6f 6e 74 65 6e 74 73 20 69 66 20 73 ge contents if s
30b90 65 63 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f 64 ecure-delete mod
30ba0 65 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 65 6e e is. ** en
30bb0 61 62 6c 65 64 2e 20 49 66 20 74 68 69 73 20 27 abled. If this '
30bc0 6f 76 65 72 66 6c 6f 77 27 20 70 61 67 65 20 68 overflow' page h
30bd0 61 70 70 65 6e 73 20 74 6f 20 62 65 20 61 20 70 appens to be a p
30be0 61 67 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 age that the.
30bf0 20 20 20 2a 2a 20 63 61 6c 6c 65 72 20 69 73 20 ** caller is
30c00 69 74 65 72 61 74 69 6e 67 20 74 68 72 6f 75 67 iterating throug
30c10 68 20 6f 72 20 75 73 69 6e 67 20 69 6e 20 73 6f h or using in so
30c20 6d 65 20 6f 74 68 65 72 20 77 61 79 2c 20 74 68 me other way, th
30c30 69 73 0a 20 20 20 20 20 20 2a 2a 20 63 61 6e 20 is. ** can
30c40 62 65 20 70 72 6f 62 6c 65 6d 61 74 69 63 2e 0a be problematic..
30c50 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 */. r
30c60 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
30c70 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c PT_BKPT;. }el
30c80 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 se{. rc = f
30c90 72 65 65 50 61 67 65 32 28 70 42 74 2c 20 70 4f reePage2(pBt, pO
30ca0 76 66 6c 2c 20 6f 76 66 6c 50 67 6e 6f 29 3b 0a vfl, ovflPgno);.
30cb0 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 }.. if( p
30cc0 4f 76 66 6c 20 29 7b 0a 20 20 20 20 20 20 73 71 Ovfl ){. sq
30cd0 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
30ce0 70 4f 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 3b pOvfl->pDbPage);
30cf0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
30d00 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
30d10 20 20 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 69 4e ovflPgno = iN
30d20 65 78 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ext;. }. retur
30d30 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
30d40 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 74 68 65 /*.** Create the
30d50 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 75 byte sequence u
30d60 73 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 sed to represent
30d70 20 61 20 63 65 6c 6c 20 6f 6e 20 70 61 67 65 20 a cell on page
30d80 70 50 61 67 65 0a 2a 2a 20 61 6e 64 20 77 72 69 pPage.** and wri
30d90 74 65 20 74 68 61 74 20 62 79 74 65 20 73 65 71 te that byte seq
30da0 75 65 6e 63 65 20 69 6e 74 6f 20 70 43 65 6c 6c uence into pCell
30db0 5b 5d 2e 20 20 4f 76 65 72 66 6c 6f 77 20 70 61 []. Overflow pa
30dc0 67 65 73 20 61 72 65 0a 2a 2a 20 61 6c 6c 6f 63 ges are.** alloc
30dd0 61 74 65 64 20 61 6e 64 20 66 69 6c 6c 65 64 20 ated and filled
30de0 69 6e 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e in as necessary.
30df0 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 The calling pr
30e00 6f 63 65 64 75 72 65 0a 2a 2a 20 69 73 20 72 65 ocedure.** is re
30e10 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 6d 61 sponsible for ma
30e20 6b 69 6e 67 20 73 75 72 65 20 73 75 66 66 69 63 king sure suffic
30e30 69 65 6e 74 20 73 70 61 63 65 20 68 61 73 20 62 ient space has b
30e40 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a een allocated.**
30e50 20 66 6f 72 20 70 43 65 6c 6c 5b 5d 2e 0a 2a 2a for pCell[]..**
30e60 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 70 43 .** Note that pC
30e70 65 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65 63 ell does not nec
30e80 65 73 73 61 72 79 20 6e 65 65 64 20 74 6f 20 70 essary need to p
30e90 6f 69 6e 74 20 74 6f 20 74 68 65 20 70 50 61 67 oint to the pPag
30ea0 65 2d 3e 61 44 61 74 61 0a 2a 2a 20 61 72 65 61 e->aData.** area
30eb0 2e 20 20 70 43 65 6c 6c 20 6d 69 67 68 74 20 70 . pCell might p
30ec0 6f 69 6e 74 20 74 6f 20 73 6f 6d 65 20 74 65 6d oint to some tem
30ed0 70 6f 72 61 72 79 20 73 74 6f 72 61 67 65 2e 20 porary storage.
30ee0 20 54 68 65 20 63 65 6c 6c 20 77 69 6c 6c 0a 2a The cell will.*
30ef0 2a 20 62 65 20 63 6f 6e 73 74 72 75 63 74 65 64 * be constructed
30f00 20 69 6e 20 74 68 69 73 20 74 65 6d 70 6f 72 61 in this tempora
30f10 72 79 20 61 72 65 61 20 74 68 65 6e 20 63 6f 70 ry area then cop
30f20 69 65 64 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e ied into pPage->
30f30 61 44 61 74 61 0a 2a 2a 20 6c 61 74 65 72 2e 0a aData.** later..
30f40 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69 */.static int fi
30f50 6c 6c 49 6e 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 llInCell(. MemP
30f60 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 age *pPage,
30f70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
30f80 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 e page that cont
30f90 61 69 6e 73 20 74 68 65 20 63 65 6c 6c 20 2a 2f ains the cell */
30fa0 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
30fb0 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 *pCell,
30fc0 20 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 74 65 /* Complete te
30fd0 78 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 2a xt of the cell *
30fe0 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a /. const void *
30ff0 70 4b 65 79 2c 20 69 36 34 20 6e 4b 65 79 2c 20 pKey, i64 nKey,
31000 20 20 20 2f 2a 20 54 68 65 20 6b 65 79 20 2a 2f /* The key */
31010 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 . const void *p
31020 44 61 74 61 2c 69 6e 74 20 6e 44 61 74 61 2c 20 Data,int nData,
31030 20 20 2f 2a 20 54 68 65 20 64 61 74 61 20 2a 2f /* The data */
31040 0a 20 20 69 6e 74 20 6e 5a 65 72 6f 2c 20 20 20 . int nZero,
31050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31060 20 20 2f 2a 20 45 78 74 72 61 20 7a 65 72 6f 20 /* Extra zero
31070 62 79 74 65 73 20 74 6f 20 61 70 70 65 6e 64 20 bytes to append
31080 74 6f 20 70 44 61 74 61 20 2a 2f 0a 20 20 69 6e to pData */. in
31090 74 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 t *pnSize
310a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
310b0 57 72 69 74 65 20 63 65 6c 6c 20 73 69 7a 65 20 Write cell size
310c0 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
310d0 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 63 6f 6e nPayload;. con
310e0 73 74 20 75 38 20 2a 70 53 72 63 3b 0a 20 20 69 st u8 *pSrc;. i
310f0 6e 74 20 6e 53 72 63 2c 20 6e 2c 20 72 63 3b 0a nt nSrc, n, rc;.
31100 20 20 69 6e 74 20 73 70 61 63 65 4c 65 66 74 3b int spaceLeft;
31110 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 . MemPage *pOvf
31120 6c 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 l = 0;. MemPage
31130 20 2a 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 30 *pToRelease = 0
31140 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 ;. unsigned cha
31150 72 20 2a 70 50 72 69 6f 72 3b 0a 20 20 75 6e 73 r *pPrior;. uns
31160 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 61 79 igned char *pPay
31170 6c 6f 61 64 3b 0a 20 20 42 74 53 68 61 72 65 64 load;. BtShared
31180 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 *pBt = pPage->p
31190 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4f Bt;. Pgno pgnoO
311a0 76 66 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e vfl = 0;. int n
311b0 48 65 61 64 65 72 3b 0a 0a 20 20 61 73 73 65 72 Header;.. asser
311c0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
311d0 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
311e0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f ->mutex) );.. /
311f0 2a 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 6e * pPage is not n
31200 65 63 65 73 73 61 72 69 6c 79 20 77 72 69 74 65 ecessarily write
31210 61 62 6c 65 20 73 69 6e 63 65 20 70 43 65 6c 6c able since pCell
31220 20 6d 69 67 68 74 20 62 65 20 61 75 78 69 6c 69 might be auxili
31230 61 72 79 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 ary. ** buffer
31240 73 70 61 63 65 20 74 68 61 74 20 69 73 20 73 65 space that is se
31250 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68 65 20 parate from the
31260 70 50 61 67 65 20 62 75 66 66 65 72 20 61 72 65 pPage buffer are
31270 61 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 a */. assert( p
31280 43 65 6c 6c 3c 70 50 61 67 65 2d 3e 61 44 61 74 Cell<pPage->aDat
31290 61 20 7c 7c 20 70 43 65 6c 6c 3e 3d 26 70 50 61 a || pCell>=&pPa
312a0 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 ge->aData[pBt->p
312b0 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 ageSize].
312c0 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 || sqlite3P
312d0 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
312e0 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
312f0 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e );.. /* Fill in
31300 20 74 68 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a the header. */.
31310 20 20 6e 48 65 61 64 65 72 20 3d 20 70 50 61 67 nHeader = pPag
31320 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
31330 0a 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 6e 44 . nPayload = nD
31340 61 74 61 20 2b 20 6e 5a 65 72 6f 3b 0a 20 20 69 ata + nZero;. i
31350 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 f( pPage->intKey
31360 4c 65 61 66 20 29 7b 0a 20 20 20 20 6e 48 65 61 Leaf ){. nHea
31370 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 6e 74 der += putVarint
31380 33 32 28 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 32(&pCell[nHeade
31390 72 5d 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 r], nPayload);.
313a0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
313b0 72 74 28 20 6e 44 61 74 61 3d 3d 30 20 29 3b 0a rt( nData==0 );.
313c0 20 20 20 20 61 73 73 65 72 74 28 20 6e 5a 65 72 assert( nZer
313d0 6f 3d 3d 30 20 29 3b 0a 20 20 7d 0a 20 20 6e 48 o==0 );. }. nH
313e0 65 61 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 eader += putVari
313f0 6e 74 28 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 nt(&pCell[nHeade
31400 72 5d 2c 20 2a 28 75 36 34 2a 29 26 6e 4b 65 79 r], *(u64*)&nKey
31410 29 3b 0a 20 20 0a 20 20 2f 2a 20 46 69 6c 6c 20 );. . /* Fill
31420 69 6e 20 74 68 65 20 70 61 79 6c 6f 61 64 20 73 in the payload s
31430 69 7a 65 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 ize */. if( pPa
31440 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 ge->intKey ){.
31450 20 20 70 53 72 63 20 3d 20 70 44 61 74 61 3b 0a pSrc = pData;.
31460 20 20 20 20 6e 53 72 63 20 3d 20 6e 44 61 74 61 nSrc = nData
31470 3b 0a 20 20 20 20 6e 44 61 74 61 20 3d 20 30 3b ;. nData = 0;
31480 0a 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20 69 . }else{ . i
31490 66 28 20 4e 45 56 45 52 28 6e 4b 65 79 3e 30 78 f( NEVER(nKey>0x
314a0 37 66 66 66 66 66 66 66 20 7c 7c 20 70 4b 65 79 7fffffff || pKey
314b0 3d 3d 30 29 20 29 7b 0a 20 20 20 20 20 20 72 65 ==0) ){. re
314c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
314d0 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a UPT_BKPT;. }.
314e0 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 nPayload = (
314f0 69 6e 74 29 6e 4b 65 79 3b 0a 20 20 20 20 70 53 int)nKey;. pS
31500 72 63 20 3d 20 70 4b 65 79 3b 0a 20 20 20 20 6e rc = pKey;. n
31510 53 72 63 20 3d 20 28 69 6e 74 29 6e 4b 65 79 3b Src = (int)nKey;
31520 0a 20 20 7d 0a 20 20 69 66 28 20 6e 50 61 79 6c . }. if( nPayl
31530 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c oad<=pPage->maxL
31540 6f 63 61 6c 20 29 7b 0a 20 20 20 20 6e 20 3d 20 ocal ){. n =
31550 6e 48 65 61 64 65 72 20 2b 20 6e 50 61 79 6c 6f nHeader + nPaylo
31560 61 64 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 ad;. testcase
31570 28 20 6e 3d 3d 33 20 29 3b 0a 20 20 20 20 74 65 ( n==3 );. te
31580 73 74 63 61 73 65 28 20 6e 3d 3d 34 20 29 3b 0a stcase( n==4 );.
31590 20 20 20 20 69 66 28 20 6e 3c 34 20 29 20 6e 20 if( n<4 ) n
315a0 3d 20 34 3b 0a 20 20 20 20 2a 70 6e 53 69 7a 65 = 4;. *pnSize
315b0 20 3d 20 6e 3b 0a 20 20 20 20 73 70 61 63 65 4c = n;. spaceL
315c0 65 66 74 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a eft = nPayload;.
315d0 20 20 20 20 70 50 72 69 6f 72 20 3d 20 70 43 65 pPrior = pCe
315e0 6c 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ll;. }else{.
315f0 20 69 6e 74 20 6d 6e 20 3d 20 70 50 61 67 65 2d int mn = pPage-
31600 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 6e >minLocal;. n
31610 20 3d 20 6d 6e 20 2b 20 28 6e 50 61 79 6c 6f 61 = mn + (nPayloa
31620 64 20 2d 20 6d 6e 29 20 25 20 28 70 50 61 67 65 d - mn) % (pPage
31630 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
31640 65 20 2d 20 34 29 3b 0a 20 20 20 20 74 65 73 74 e - 4);. test
31650 63 61 73 65 28 20 6e 3d 3d 70 50 61 67 65 2d 3e case( n==pPage->
31660 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 20 20 maxLocal );.
31670 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 61 testcase( n==pPa
31680 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 ge->maxLocal+1 )
31690 3b 0a 20 20 20 20 69 66 28 20 6e 20 3e 20 70 50 ;. if( n > pP
316a0 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 20 age->maxLocal )
316b0 6e 20 3d 20 6d 6e 3b 0a 20 20 20 20 73 70 61 63 n = mn;. spac
316c0 65 4c 65 66 74 20 3d 20 6e 3b 0a 20 20 20 20 2a eLeft = n;. *
316d0 70 6e 53 69 7a 65 20 3d 20 6e 20 2b 20 6e 48 65 pnSize = n + nHe
316e0 61 64 65 72 20 2b 20 34 3b 0a 20 20 20 20 70 50 ader + 4;. pP
316f0 72 69 6f 72 20 3d 20 26 70 43 65 6c 6c 5b 6e 48 rior = &pCell[nH
31700 65 61 64 65 72 2b 6e 5d 3b 0a 20 20 7d 0a 20 20 eader+n];. }.
31710 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 43 65 6c pPayload = &pCel
31720 6c 5b 6e 48 65 61 64 65 72 5d 3b 0a 0a 20 20 2f l[nHeader];.. /
31730 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 * At this point
31740 76 61 72 69 61 62 6c 65 73 20 73 68 6f 75 6c 64 variables should
31750 20 62 65 20 73 65 74 20 61 73 20 66 6f 6c 6c 6f be set as follo
31760 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 ws:. **. **
31770 6e 50 61 79 6c 6f 61 64 20 20 20 20 20 20 20 20 nPayload
31780 20 20 20 54 6f 74 61 6c 20 70 61 79 6c 6f 61 64 Total payload
31790 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 0a 20 size in bytes.
317a0 20 2a 2a 20 20 20 70 50 61 79 6c 6f 61 64 20 20 ** pPayload
317b0 20 20 20 20 20 20 20 20 20 42 65 67 69 6e 20 77 Begin w
317c0 72 69 74 69 6e 67 20 70 61 79 6c 6f 61 64 20 68 riting payload h
317d0 65 72 65 0a 20 20 2a 2a 20 20 20 73 70 61 63 65 ere. ** space
317e0 4c 65 66 74 20 20 20 20 20 20 20 20 20 20 53 70 Left Sp
317f0 61 63 65 20 61 76 61 69 6c 61 62 6c 65 20 61 74 ace available at
31800 20 70 50 61 79 6c 6f 61 64 2e 20 20 49 66 20 6e pPayload. If n
31810 50 61 79 6c 6f 61 64 3e 73 70 61 63 65 4c 65 66 Payload>spaceLef
31820 74 2c 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 20 t,. **
31830 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 61 tha
31840 74 20 6d 65 61 6e 73 20 63 6f 6e 74 65 6e 74 20 t means content
31850 6d 75 73 74 20 73 70 69 6c 6c 20 69 6e 74 6f 20 must spill into
31860 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a overflow pages..
31870 20 20 2a 2a 20 20 20 2a 70 6e 53 69 7a 65 20 20 ** *pnSize
31880 20 20 20 20 20 20 20 20 20 20 53 69 7a 65 20 6f Size o
31890 66 20 74 68 65 20 6c 6f 63 61 6c 20 63 65 6c 6c f the local cell
318a0 20 28 6e 6f 74 20 63 6f 75 6e 74 69 6e 67 20 6f (not counting o
318b0 76 65 72 66 6c 6f 77 20 70 61 67 65 73 29 0a 20 verflow pages).
318c0 20 2a 2a 20 20 20 70 50 72 69 6f 72 20 20 20 20 ** pPrior
318d0 20 20 20 20 20 20 20 20 20 57 68 65 72 65 20 74 Where t
318e0 6f 20 77 72 69 74 65 20 74 68 65 20 70 67 6e 6f o write the pgno
318f0 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 76 of the first ov
31900 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 2a 2a erflow page. **
31910 0a 20 20 2a 2a 20 55 73 65 20 61 20 63 61 6c 6c . ** Use a call
31920 20 74 6f 20 62 74 72 65 65 50 61 72 73 65 43 65 to btreeParseCe
31930 6c 6c 50 74 72 28 29 20 74 6f 20 76 65 72 69 66 llPtr() to verif
31940 79 20 74 68 61 74 20 74 68 65 20 76 61 6c 75 65 y that the value
31950 73 20 61 62 6f 76 65 0a 20 20 2a 2a 20 77 65 72 s above. ** wer
31960 65 20 63 6f 6d 70 75 74 65 64 20 63 6f 72 72 65 e computed corre
31970 63 74 6c 79 2e 0a 20 20 2a 2f 0a 23 69 66 20 53 ctly.. */.#if S
31980 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 7b 0a QLITE_DEBUG. {.
31990 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 CellInfo inf
319a0 6f 3b 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 o;. btreePars
319b0 65 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 eCellPtr(pPage,
319c0 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 pCell, &info);.
319d0 20 20 20 61 73 73 65 72 74 28 20 6e 48 65 61 64 assert( nHead
319e0 65 72 3d 28 69 6e 74 29 28 69 6e 66 6f 2e 70 50 er=(int)(info.pP
319f0 61 79 6c 6f 61 64 20 2d 20 70 43 65 6c 6c 29 20 ayload - pCell)
31a00 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 );. assert( i
31a10 6e 66 6f 2e 6e 4b 65 79 3d 3d 6e 4b 65 79 20 29 nfo.nKey==nKey )
31a20 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 ;. assert( *p
31a30 6e 53 69 7a 65 20 3d 3d 20 69 6e 66 6f 2e 6e 53 nSize == info.nS
31a40 69 7a 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ize );. asser
31a50 74 28 20 73 70 61 63 65 4c 65 66 74 20 3d 3d 20 t( spaceLeft ==
31a60 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 3b 0a 20 info.nLocal );.
31a70 20 20 20 61 73 73 65 72 74 28 20 70 50 72 69 6f assert( pPrio
31a80 72 20 3d 3d 20 26 70 43 65 6c 6c 5b 69 6e 66 6f r == &pCell[info
31a90 2e 69 4f 76 65 72 66 6c 6f 77 5d 20 29 3b 0a 20 .iOverflow] );.
31aa0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
31ab0 57 72 69 74 65 20 74 68 65 20 70 61 79 6c 6f 61 Write the payloa
31ac0 64 20 69 6e 74 6f 20 74 68 65 20 6c 6f 63 61 6c d into the local
31ad0 20 43 65 6c 6c 20 61 6e 64 20 61 6e 79 20 65 78 Cell and any ex
31ae0 74 72 61 20 69 6e 74 6f 20 6f 76 65 72 66 6c 6f tra into overflo
31af0 77 20 70 61 67 65 73 20 2a 2f 0a 20 20 77 68 69 w pages */. whi
31b00 6c 65 28 20 6e 50 61 79 6c 6f 61 64 3e 30 20 29 le( nPayload>0 )
31b10 7b 0a 20 20 20 20 69 66 28 20 73 70 61 63 65 4c {. if( spaceL
31b20 65 66 74 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 eft==0 ){.#ifnde
31b30 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
31b40 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 50 TOVACUUM. P
31b50 67 6e 6f 20 70 67 6e 6f 50 74 72 6d 61 70 20 3d gno pgnoPtrmap =
31b60 20 70 67 6e 6f 4f 76 66 6c 3b 20 2f 2a 20 4f 76 pgnoOvfl; /* Ov
31b70 65 72 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e erflow page poin
31b80 74 65 72 2d 6d 61 70 20 65 6e 74 72 79 20 70 61 ter-map entry pa
31b90 67 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 ge */. if(
31ba0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
31bb0 29 7b 0a 20 20 20 20 20 20 20 20 64 6f 7b 0a 20 ){. do{.
31bc0 20 20 20 20 20 20 20 20 20 70 67 6e 6f 4f 76 66 pgnoOvf
31bd0 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7d 20 77 l++;. } w
31be0 68 69 6c 65 28 20 0a 20 20 20 20 20 20 20 20 20 hile( .
31bf0 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 PTRMAP_ISPAGE(p
31c00 42 74 2c 20 70 67 6e 6f 4f 76 66 6c 29 20 7c 7c Bt, pgnoOvfl) ||
31c10 20 70 67 6e 6f 4f 76 66 6c 3d 3d 50 45 4e 44 49 pgnoOvfl==PENDI
31c20 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
31c30 29 20 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 ) . );.
31c40 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
31c50 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 rc = allocate
31c60 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 BtreePage(pBt, &
31c70 70 4f 76 66 6c 2c 20 26 70 67 6e 6f 4f 76 66 6c pOvfl, &pgnoOvfl
31c80 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 30 29 3b 0a , pgnoOvfl, 0);.
31c90 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
31ca0 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
31cb0 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 64 /* If the d
31cc0 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 73 atabase supports
31cd0 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 20 61 6e auto-vacuum, an
31ce0 64 20 74 68 65 20 73 65 63 6f 6e 64 20 6f 72 20 d the second or
31cf0 73 75 62 73 65 71 75 65 6e 74 0a 20 20 20 20 20 subsequent.
31d00 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ** overflow pag
31d10 65 20 69 73 20 62 65 69 6e 67 20 61 6c 6c 6f 63 e is being alloc
31d20 61 74 65 64 2c 20 61 64 64 20 61 6e 20 65 6e 74 ated, add an ent
31d30 72 79 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 ry to the pointe
31d40 72 2d 6d 61 70 0a 20 20 20 20 20 20 2a 2a 20 66 r-map. ** f
31d50 6f 72 20 74 68 61 74 20 70 61 67 65 20 6e 6f 77 or that page now
31d60 2e 20 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 . . **.
31d70 20 20 2a 2a 20 49 66 20 74 68 69 73 20 69 73 20 ** If this is
31d80 74 68 65 20 66 69 72 73 74 20 6f 76 65 72 66 6c the first overfl
31d90 6f 77 20 70 61 67 65 2c 20 74 68 65 6e 20 77 72 ow page, then wr
31da0 69 74 65 20 61 20 70 61 72 74 69 61 6c 20 65 6e ite a partial en
31db0 74 72 79 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f try . ** to
31dc0 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 the pointer-map
31dd0 2e 20 49 66 20 77 65 20 77 72 69 74 65 20 6e 6f . If we write no
31de0 74 68 69 6e 67 20 74 6f 20 74 68 69 73 20 70 6f thing to this po
31df0 69 6e 74 65 72 2d 6d 61 70 20 73 6c 6f 74 2c 0a inter-map slot,.
31e00 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 74 68 ** then th
31e10 65 20 6f 70 74 69 6d 69 73 74 69 63 20 6f 76 65 e optimistic ove
31e20 72 66 6c 6f 77 20 63 68 61 69 6e 20 70 72 6f 63 rflow chain proc
31e30 65 73 73 69 6e 67 20 69 6e 20 63 6c 65 61 72 43 essing in clearC
31e40 65 6c 6c 28 29 0a 20 20 20 20 20 20 2a 2a 20 6d ell(). ** m
31e50 61 79 20 6d 69 73 69 6e 74 65 72 70 72 65 74 20 ay misinterpret
31e60 74 68 65 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 the uninitialize
31e70 64 20 76 61 6c 75 65 73 20 61 6e 64 20 64 65 6c d values and del
31e80 65 74 65 20 74 68 65 0a 20 20 20 20 20 20 2a 2a ete the. **
31e90 20 77 72 6f 6e 67 20 70 61 67 65 73 20 66 72 6f wrong pages fro
31ea0 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a m the database..
31eb0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
31ec0 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 f( pBt->autoVacu
31ed0 75 6d 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 um && rc==SQLITE
31ee0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 75 _OK ){. u
31ef0 38 20 65 54 79 70 65 20 3d 20 28 70 67 6e 6f 50 8 eType = (pgnoP
31f00 74 72 6d 61 70 3f 50 54 52 4d 41 50 5f 4f 56 45 trmap?PTRMAP_OVE
31f10 52 46 4c 4f 57 32 3a 50 54 52 4d 41 50 5f 4f 56 RFLOW2:PTRMAP_OV
31f20 45 52 46 4c 4f 57 31 29 3b 0a 20 20 20 20 20 20 ERFLOW1);.
31f30 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
31f40 20 70 67 6e 6f 4f 76 66 6c 2c 20 65 54 79 70 65 pgnoOvfl, eType
31f50 2c 20 70 67 6e 6f 50 74 72 6d 61 70 2c 20 26 72 , pgnoPtrmap, &r
31f60 63 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 c);. if(
31f70 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 rc ){.
31f80 72 65 6c 65 61 73 65 50 61 67 65 28 70 4f 76 66 releasePage(pOvf
31f90 6c 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 l);. }.
31fa0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
31fb0 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 if( rc ){.
31fc0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
31fd0 28 70 54 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 (pToRelease);.
31fe0 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
31ff0 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
32000 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 73 65 /* If pToRelease
32010 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 68 61 is not zero tha
32020 6e 20 70 50 72 69 6f 72 20 70 6f 69 6e 74 73 20 n pPrior points
32030 69 6e 74 6f 20 74 68 65 20 64 61 74 61 20 61 72 into the data ar
32040 65 61 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 70 ea. ** of p
32050 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 6b 65 ToRelease. Make
32060 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 73 65 sure pToRelease
32070 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 is still writea
32080 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 20 20 61 73 ble. */. as
32090 73 65 72 74 28 20 70 54 6f 52 65 6c 65 61 73 65 sert( pToRelease
320a0 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 ==0 || sqlite3Pa
320b0 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
320c0 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 ToRelease->pDbPa
320d0 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 2f 2a ge) );.. /*
320e0 20 49 66 20 70 50 72 69 6f 72 20 69 73 20 70 61 If pPrior is pa
320f0 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 rt of the data a
32100 72 65 61 20 6f 66 20 70 50 61 67 65 2c 20 74 68 rea of pPage, th
32110 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 70 50 61 en make sure pPa
32120 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 73 ge. ** is s
32130 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 2a till writeable *
32140 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 /. assert(
32150 70 50 72 69 6f 72 3c 70 50 61 67 65 2d 3e 61 44 pPrior<pPage->aD
32160 61 74 61 20 7c 7c 20 70 50 72 69 6f 72 3e 3d 26 ata || pPrior>=&
32170 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 pPage->aData[pBt
32180 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 ->pageSize].
32190 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 || sqlit
321a0 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
321b0 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
321c0 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 70 75 74 e) );.. put
321d0 34 62 79 74 65 28 70 50 72 69 6f 72 2c 20 70 67 4byte(pPrior, pg
321e0 6e 6f 4f 76 66 6c 29 3b 0a 20 20 20 20 20 20 72 noOvfl);. r
321f0 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 65 eleasePage(pToRe
32200 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 70 54 lease);. pT
32210 6f 52 65 6c 65 61 73 65 20 3d 20 70 4f 76 66 6c oRelease = pOvfl
32220 3b 0a 20 20 20 20 20 20 70 50 72 69 6f 72 20 3d ;. pPrior =
32230 20 70 4f 76 66 6c 2d 3e 61 44 61 74 61 3b 0a 20 pOvfl->aData;.
32240 20 20 20 20 20 70 75 74 34 62 79 74 65 28 70 50 put4byte(pP
32250 72 69 6f 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 rior, 0);.
32260 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 4f 76 66 pPayload = &pOvf
32270 6c 2d 3e 61 44 61 74 61 5b 34 5d 3b 0a 20 20 20 l->aData[4];.
32280 20 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 70 spaceLeft = p
32290 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
322a0 20 34 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 20 4;. }. n
322b0 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 = nPayload;.
322c0 69 66 28 20 6e 3e 73 70 61 63 65 4c 65 66 74 20 if( n>spaceLeft
322d0 29 20 6e 20 3d 20 73 70 61 63 65 4c 65 66 74 3b ) n = spaceLeft;
322e0 0a 0a 20 20 20 20 2f 2a 20 49 66 20 70 54 6f 52 .. /* If pToR
322f0 65 6c 65 61 73 65 20 69 73 20 6e 6f 74 20 7a 65 elease is not ze
32300 72 6f 20 74 68 61 6e 20 70 50 61 79 6c 6f 61 64 ro than pPayload
32310 20 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 68 65 points into the
32320 20 64 61 74 61 20 61 72 65 61 0a 20 20 20 20 2a data area. *
32330 2a 20 6f 66 20 70 54 6f 52 65 6c 65 61 73 65 2e * of pToRelease.
32340 20 20 4d 61 6b 65 20 73 75 72 65 20 70 54 6f 52 Make sure pToR
32350 65 6c 65 61 73 65 20 69 73 20 73 74 69 6c 6c 20 elease is still
32360 77 72 69 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 writeable. */.
32370 20 20 61 73 73 65 72 74 28 20 70 54 6f 52 65 6c assert( pToRel
32380 65 61 73 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 ease==0 || sqlit
32390 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
323a0 6c 65 28 70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 le(pToRelease->p
323b0 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 DbPage) );..
323c0 2f 2a 20 49 66 20 70 50 61 79 6c 6f 61 64 20 69 /* If pPayload i
323d0 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 s part of the da
323e0 74 61 20 61 72 65 61 20 6f 66 20 70 50 61 67 65 ta area of pPage
323f0 2c 20 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 , then make sure
32400 20 70 50 61 67 65 0a 20 20 20 20 2a 2a 20 69 73 pPage. ** is
32410 20 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 still writeable
32420 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
32430 70 50 61 79 6c 6f 61 64 3c 70 50 61 67 65 2d 3e pPayload<pPage->
32440 61 44 61 74 61 20 7c 7c 20 70 50 61 79 6c 6f 61 aData || pPayloa
32450 64 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 61 d>=&pPage->aData
32460 5b 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a [pBt->pageSize].
32470 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 || s
32480 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
32490 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 teable(pPage->pD
324a0 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 69 bPage) );.. i
324b0 66 28 20 6e 53 72 63 3e 30 20 29 7b 0a 20 20 20 f( nSrc>0 ){.
324c0 20 20 20 69 66 28 20 6e 3e 6e 53 72 63 20 29 20 if( n>nSrc )
324d0 6e 20 3d 20 6e 53 72 63 3b 0a 20 20 20 20 20 20 n = nSrc;.
324e0 61 73 73 65 72 74 28 20 70 53 72 63 20 29 3b 0a assert( pSrc );.
324f0 20 20 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 memcpy(pPa
32500 79 6c 6f 61 64 2c 20 70 53 72 63 2c 20 6e 29 3b yload, pSrc, n);
32510 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
32520 20 20 6d 65 6d 73 65 74 28 70 50 61 79 6c 6f 61 memset(pPayloa
32530 64 2c 20 30 2c 20 6e 29 3b 0a 20 20 20 20 7d 0a d, 0, n);. }.
32540 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 2d 3d 20 nPayload -=
32550 6e 3b 0a 20 20 20 20 70 50 61 79 6c 6f 61 64 20 n;. pPayload
32560 2b 3d 20 6e 3b 0a 20 20 20 20 70 53 72 63 20 2b += n;. pSrc +
32570 3d 20 6e 3b 0a 20 20 20 20 6e 53 72 63 20 2d 3d = n;. nSrc -=
32580 20 6e 3b 0a 20 20 20 20 73 70 61 63 65 4c 65 66 n;. spaceLef
32590 74 20 2d 3d 20 6e 3b 0a 20 20 20 20 69 66 28 20 t -= n;. if(
325a0 6e 53 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 20 nSrc==0 ){.
325b0 20 6e 53 72 63 20 3d 20 6e 44 61 74 61 3b 0a 20 nSrc = nData;.
325c0 20 20 20 20 20 70 53 72 63 20 3d 20 70 44 61 74 pSrc = pDat
325d0 61 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 a;. }. }. r
325e0 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 65 eleasePage(pToRe
325f0 6c 65 61 73 65 29 3b 0a 20 20 72 65 74 75 72 6e lease);. return
32600 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
32610 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 *.** Remove the
32620 69 2d 74 68 20 63 65 6c 6c 20 66 72 6f 6d 20 70 i-th cell from p
32630 50 61 67 65 2e 20 20 54 68 69 73 20 72 6f 75 74 Page. This rout
32640 69 6e 65 20 65 66 66 65 63 74 73 20 70 50 61 67 ine effects pPag
32650 65 20 6f 6e 6c 79 2e 0a 2a 2a 20 54 68 65 20 63 e only..** The c
32660 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 73 20 6e ell content is n
32670 6f 74 20 66 72 65 65 64 20 6f 72 20 64 65 61 6c ot freed or deal
32680 6c 6f 63 61 74 65 64 2e 20 20 49 74 20 69 73 20 located. It is
32690 61 73 73 75 6d 65 64 20 74 68 61 74 0a 2a 2a 20 assumed that.**
326a0 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
326b0 20 68 61 73 20 62 65 65 6e 20 63 6f 70 69 65 64 has been copied
326c0 20 73 6f 6d 65 70 6c 61 63 65 20 65 6c 73 65 2e someplace else.
326d0 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6a This routine j
326e0 75 73 74 0a 2a 2a 20 72 65 6d 6f 76 65 73 20 74 ust.** removes t
326f0 68 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 he reference to
32700 74 68 65 20 63 65 6c 6c 20 66 72 6f 6d 20 70 50 the cell from pP
32710 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 22 73 7a 22 20 age..**.** "sz"
32720 6d 75 73 74 20 62 65 20 74 68 65 20 6e 75 6d 62 must be the numb
32730 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 74 er of bytes in t
32740 68 65 20 63 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 he cell..*/.stat
32750 69 63 20 76 6f 69 64 20 64 72 6f 70 43 65 6c 6c ic void dropCell
32760 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
32770 20 69 6e 74 20 69 64 78 2c 20 69 6e 74 20 73 7a int idx, int sz
32780 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 75 , int *pRC){. u
32790 33 32 20 70 63 3b 20 20 20 20 20 20 20 20 20 2f 32 pc; /
327a0 2a 20 4f 66 66 73 65 74 20 74 6f 20 63 65 6c 6c * Offset to cell
327b0 20 63 6f 6e 74 65 6e 74 20 6f 66 20 63 65 6c 6c content of cell
327c0 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 2a being deleted *
327d0 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 /. u8 *data;
327e0 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e 61 44 /* pPage->aD
327f0 61 74 61 20 2a 2f 0a 20 20 75 38 20 2a 70 74 72 ata */. u8 *ptr
32800 3b 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64 ; /* Used
32810 20 74 6f 20 6d 6f 76 65 20 62 79 74 65 73 20 61 to move bytes a
32820 72 6f 75 6e 64 20 77 69 74 68 69 6e 20 64 61 74 round within dat
32830 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b a[] */. int rc;
32840 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
32850 72 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 return code */.
32860 20 69 6e 74 20 68 64 72 3b 20 20 20 20 20 20 20 int hdr;
32870 20 2f 2a 20 42 65 67 69 6e 6e 69 6e 67 20 6f 66 /* Beginning of
32880 20 74 68 65 20 68 65 61 64 65 72 2e 20 20 30 20 the header. 0
32890 6d 6f 73 74 20 70 61 67 65 73 2e 20 20 31 30 30 most pages. 100
328a0 20 70 61 67 65 20 31 20 2a 2f 0a 0a 20 20 69 66 page 1 */.. if
328b0 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e 3b ( *pRC ) return;
328c0 0a 0a 20 20 61 73 73 65 72 74 28 20 69 64 78 3e .. assert( idx>
328d0 3d 30 20 26 26 20 69 64 78 3c 70 50 61 67 65 2d =0 && idx<pPage-
328e0 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 >nCell );. asse
328f0 72 74 28 20 73 7a 3d 3d 63 65 6c 6c 53 69 7a 65 rt( sz==cellSize
32900 28 70 50 61 67 65 2c 20 69 64 78 29 20 29 3b 0a (pPage, idx) );.
32910 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
32920 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
32930 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
32940 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
32950 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
32960 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
32970 74 65 78 29 20 29 3b 0a 20 20 64 61 74 61 20 3d tex) );. data =
32980 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 pPage->aData;.
32990 20 70 74 72 20 3d 20 26 70 50 61 67 65 2d 3e 61 ptr = &pPage->a
329a0 43 65 6c 6c 49 64 78 5b 32 2a 69 64 78 5d 3b 0a CellIdx[2*idx];.
329b0 20 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 pc = get2byte(
329c0 70 74 72 29 3b 0a 20 20 68 64 72 20 3d 20 70 50 ptr);. hdr = pP
329d0 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
329e0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
329f0 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 get2byte(&data[h
32a00 64 72 2b 35 5d 29 20 29 3b 0a 20 20 74 65 73 74 dr+5]) );. test
32a10 63 61 73 65 28 20 70 63 2b 73 7a 3d 3d 70 50 61 case( pc+sz==pPa
32a20 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
32a30 69 7a 65 20 29 3b 0a 20 20 69 66 28 20 70 63 20 ize );. if( pc
32a40 3c 20 28 75 33 32 29 67 65 74 32 62 79 74 65 28 < (u32)get2byte(
32a50 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 7c 7c &data[hdr+5]) ||
32a60 20 70 63 2b 73 7a 20 3e 20 70 50 61 67 65 2d 3e pc+sz > pPage->
32a70 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
32a80 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 ){. *pRC = SQ
32a90 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
32aa0 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 T;. return;.
32ab0 20 7d 0a 20 20 72 63 20 3d 20 66 72 65 65 53 70 }. rc = freeSp
32ac0 61 63 65 28 70 50 61 67 65 2c 20 70 63 2c 20 73 ace(pPage, pc, s
32ad0 7a 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a z);. if( rc ){.
32ae0 20 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 *pRC = rc;.
32af0 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 return;. }.
32b00 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d 2d 3b pPage->nCell--;
32b10 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 . if( pPage->nC
32b20 65 6c 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 6d 65 ell==0 ){. me
32b30 6d 73 65 74 28 26 64 61 74 61 5b 68 64 72 2b 31 mset(&data[hdr+1
32b40 5d 2c 20 30 2c 20 34 29 3b 0a 20 20 20 20 64 61 ], 0, 4);. da
32b50 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b 0a 20 ta[hdr+7] = 0;.
32b60 20 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 put2byte(&dat
32b70 61 5b 68 64 72 2b 35 5d 2c 20 70 50 61 67 65 2d a[hdr+5], pPage-
32b80 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
32b90 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 );. pPage->nF
32ba0 72 65 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 ree = pPage->pBt
32bb0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 70 ->usableSize - p
32bc0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 0a Page->hdrOffset.
32bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32be0 20 20 20 20 20 20 20 2d 20 70 50 61 67 65 2d 3e - pPage->
32bf0 63 68 69 6c 64 50 74 72 53 69 7a 65 20 2d 20 38 childPtrSize - 8
32c00 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6d ;. }else{. m
32c10 65 6d 6d 6f 76 65 28 70 74 72 2c 20 70 74 72 2b emmove(ptr, ptr+
32c20 32 2c 20 32 2a 28 70 50 61 67 65 2d 3e 6e 43 65 2, 2*(pPage->nCe
32c30 6c 6c 20 2d 20 69 64 78 29 29 3b 0a 20 20 20 20 ll - idx));.
32c40 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
32c50 64 72 2b 33 5d 2c 20 70 50 61 67 65 2d 3e 6e 43 dr+3], pPage->nC
32c60 65 6c 6c 29 3b 0a 20 20 20 20 70 50 61 67 65 2d ell);. pPage-
32c70 3e 6e 46 72 65 65 20 2b 3d 20 32 3b 0a 20 20 7d >nFree += 2;. }
32c80 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 73 65 72 74 .}../*.** Insert
32c90 20 61 20 6e 65 77 20 63 65 6c 6c 20 6f 6e 20 70 a new cell on p
32ca0 50 61 67 65 20 61 74 20 63 65 6c 6c 20 69 6e 64 Page at cell ind
32cb0 65 78 20 22 69 22 2e 20 20 70 43 65 6c 6c 20 70 ex "i". pCell p
32cc0 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a 2a 20 oints to the.**
32cd0 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 63 content of the c
32ce0 65 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ell..**.** If th
32cf0 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 77 e cell content w
32d00 69 6c 6c 20 66 69 74 20 6f 6e 20 74 68 65 20 70 ill fit on the p
32d10 61 67 65 2c 20 74 68 65 6e 20 70 75 74 20 69 74 age, then put it
32d20 20 74 68 65 72 65 2e 20 20 49 66 20 69 74 0a 2a there. If it.*
32d30 2a 20 77 69 6c 6c 20 6e 6f 74 20 66 69 74 2c 20 * will not fit,
32d40 74 68 65 6e 20 6d 61 6b 65 20 61 20 63 6f 70 79 then make a copy
32d50 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e of the cell con
32d60 74 65 6e 74 20 69 6e 74 6f 20 70 54 65 6d 70 20 tent into pTemp
32d70 69 66 0a 2a 2a 20 70 54 65 6d 70 20 69 73 20 6e if.** pTemp is n
32d80 6f 74 20 6e 75 6c 6c 2e 20 20 52 65 67 61 72 64 ot null. Regard
32d90 6c 65 73 73 20 6f 66 20 70 54 65 6d 70 2c 20 61 less of pTemp, a
32da0 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 65 6e llocate a new en
32db0 74 72 79 0a 2a 2a 20 69 6e 20 70 50 61 67 65 2d try.** in pPage-
32dc0 3e 61 70 4f 76 66 6c 5b 5d 20 61 6e 64 20 6d 61 >apOvfl[] and ma
32dd0 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 6f 20 74 ke it point to t
32de0 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
32df0 28 65 69 74 68 65 72 0a 2a 2a 20 69 6e 20 70 54 (either.** in pT
32e00 65 6d 70 20 6f 72 20 74 68 65 20 6f 72 69 67 69 emp or the origi
32e10 6e 61 6c 20 70 43 65 6c 6c 29 20 61 6e 64 20 61 nal pCell) and a
32e20 6c 73 6f 20 72 65 63 6f 72 64 20 69 74 73 20 69 lso record its i
32e30 6e 64 65 78 2e 20 0a 2a 2a 20 41 6c 6c 6f 63 61 ndex. .** Alloca
32e40 74 69 6e 67 20 61 20 6e 65 77 20 65 6e 74 72 79 ting a new entry
32e50 20 69 6e 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c in pPage->aCell
32e60 5b 5d 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 [] implies that
32e70 0a 2a 2a 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 .** pPage->nOver
32e80 66 6c 6f 77 20 69 73 20 69 6e 63 72 65 6d 65 6e flow is incremen
32e90 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ted..*/.static v
32ea0 6f 69 64 20 69 6e 73 65 72 74 43 65 6c 6c 28 0a oid insertCell(.
32eb0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
32ec0 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 6e 74 6f , /* Page into
32ed0 20 77 68 69 63 68 20 77 65 20 61 72 65 20 63 6f which we are co
32ee0 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 pying */. int i
32ef0 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
32f00 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f 6d 65 73 New cell becomes
32f10 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 6f the i-th cell o
32f20 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 f the page */.
32f30 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 u8 *pCell,
32f40 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 6f 66 20 /* Content of
32f50 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 2a 2f 0a the new cell */.
32f60 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 20 20 20 int sz,
32f70 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 /* Bytes of
32f80 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 65 6c 6c content in pCell
32f90 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 6d 70 2c */. u8 *pTemp,
32fa0 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 /* Temp
32fb0 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 66 6f storage space fo
32fc0 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e 65 65 64 r pCell, if need
32fd0 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 43 68 ed */. Pgno iCh
32fe0 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 49 66 20 ild, /* If
32ff0 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 6c 61 63 non-zero, replac
33000 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 20 e first 4 bytes
33010 77 69 74 68 20 74 68 69 73 20 76 61 6c 75 65 20 with this value
33020 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 20 20 20 */. int *pRC
33030 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 61 /* Read a
33040 6e 64 20 77 72 69 74 65 20 72 65 74 75 72 6e 20 nd write return
33050 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 65 20 2a code from here *
33060 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 78 20 3d /.){. int idx =
33070 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 68 65 72 0; /* Wher
33080 65 20 74 6f 20 77 72 69 74 65 20 6e 65 77 20 63 e to write new c
33090 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 20 64 ell content in d
330a0 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6a ata[] */. int j
330b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
330c0 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
330d0 20 20 69 6e 74 20 65 6e 64 3b 20 20 20 20 20 20 int end;
330e0 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 /* First byt
330f0 65 20 70 61 73 74 20 74 68 65 20 6c 61 73 74 20 e past the last
33100 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 6e 20 cell pointer in
33110 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 data[] */. int
33120 69 6e 73 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ins; /*
33130 20 49 6e 64 65 78 20 69 6e 20 64 61 74 61 5b 5d Index in data[]
33140 20 77 68 65 72 65 20 6e 65 77 20 63 65 6c 6c 20 where new cell
33150 70 6f 69 6e 74 65 72 20 69 73 20 69 6e 73 65 72 pointer is inser
33160 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 63 65 6c ted */. int cel
33170 6c 4f 66 66 73 65 74 3b 20 20 20 2f 2a 20 41 64 lOffset; /* Ad
33180 64 72 65 73 73 20 6f 66 20 66 69 72 73 74 20 63 dress of first c
33190 65 6c 6c 20 70 6f 69 6e 74 65 72 20 69 6e 20 64 ell pointer in d
331a0 61 74 61 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a 64 ata[] */. u8 *d
331b0 61 74 61 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ata; /*
331c0 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 The content of t
331d0 68 65 20 77 68 6f 6c 65 20 70 61 67 65 20 2a 2f he whole page */
331e0 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 .. if( *pRC ) r
331f0 65 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 eturn;.. assert
33200 28 20 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 61 ( i>=0 && i<=pPa
33210 67 65 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 2d ge->nCell+pPage-
33220 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 20 >nOverflow );.
33230 61 73 73 65 72 74 28 20 4d 58 5f 43 45 4c 4c 28 assert( MX_CELL(
33240 70 50 61 67 65 2d 3e 70 42 74 29 3c 3d 31 30 39 pPage->pBt)<=109
33250 32 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 );. assert(
33260 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d 58 pPage->nCell<=MX
33270 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 _CELL(pPage->pBt
33280 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 ) || CORRUPT_DB
33290 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
332a0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3c 3d 41 ge->nOverflow<=A
332b0 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e rraySize(pPage->
332c0 61 70 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 apOvfl) );. ass
332d0 65 72 74 28 20 41 72 72 61 79 53 69 7a 65 28 70 ert( ArraySize(p
332e0 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 3d 3d 41 Page->apOvfl)==A
332f0 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e rraySize(pPage->
33300 61 69 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 aiOvfl) );. ass
33310 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
33320 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
33330 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
33340 2f 2a 20 54 68 65 20 63 65 6c 6c 20 73 68 6f 75 /* The cell shou
33350 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 73 ld normally be s
33360 69 7a 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 ized correctly.
33370 20 48 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 6d However, when m
33380 6f 76 69 6e 67 20 61 0a 20 20 2a 2a 20 6d 61 6c oving a. ** mal
33390 66 6f 72 6d 65 64 20 63 65 6c 6c 20 66 72 6f 6d formed cell from
333a0 20 61 20 6c 65 61 66 20 70 61 67 65 20 74 6f 20 a leaf page to
333b0 61 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 65 an interior page
333c0 2c 20 69 66 20 74 68 65 20 63 65 6c 6c 20 73 69 , if the cell si
333d0 7a 65 0a 20 20 2a 2a 20 77 61 6e 74 65 64 20 74 ze. ** wanted t
333e0 6f 20 62 65 20 6c 65 73 73 20 74 68 61 6e 20 34 o be less than 4
333f0 20 62 75 74 20 67 6f 74 20 72 6f 75 6e 64 65 64 but got rounded
33400 20 75 70 20 74 6f 20 34 20 6f 6e 20 74 68 65 20 up to 4 on the
33410 6c 65 61 66 2c 20 74 68 65 6e 20 73 69 7a 65 0a leaf, then size.
33420 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 6c 65 ** might be le
33430 73 73 20 74 68 61 6e 20 38 20 28 6c 65 61 66 2d ss than 8 (leaf-
33440 73 69 7a 65 20 2b 20 70 6f 69 6e 74 65 72 29 20 size + pointer)
33450 6f 6e 20 74 68 65 20 69 6e 74 65 72 69 6f 72 20 on the interior
33460 6e 6f 64 65 2e 20 20 48 65 6e 63 65 0a 20 20 2a node. Hence. *
33470 2a 20 74 68 65 20 74 65 72 6d 20 61 66 74 65 72 * the term after
33480 20 74 68 65 20 7c 7c 20 69 6e 20 74 68 65 20 66 the || in the f
33490 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 28 ollowing assert(
334a0 29 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 ). */. assert(
334b0 73 7a 3d 3d 63 65 6c 6c 53 69 7a 65 50 74 72 28 sz==cellSizePtr(
334c0 70 50 61 67 65 2c 20 70 43 65 6c 6c 29 20 7c 7c pPage, pCell) ||
334d0 20 28 73 7a 3d 3d 38 20 26 26 20 69 43 68 69 6c (sz==8 && iChil
334e0 64 3e 30 29 20 29 3b 0a 20 20 69 66 28 20 70 50 d>0) );. if( pP
334f0 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 7c age->nOverflow |
33500 7c 20 73 7a 2b 32 3e 70 50 61 67 65 2d 3e 6e 46 | sz+2>pPage->nF
33510 72 65 65 20 29 7b 0a 20 20 20 20 69 66 28 20 70 ree ){. if( p
33520 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 6d 65 Temp ){. me
33530 6d 63 70 79 28 70 54 65 6d 70 2c 20 70 43 65 6c mcpy(pTemp, pCel
33540 6c 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 70 43 l, sz);. pC
33550 65 6c 6c 20 3d 20 70 54 65 6d 70 3b 0a 20 20 20 ell = pTemp;.
33560 20 7d 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c }. if( iChil
33570 64 20 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 d ){. put4b
33580 79 74 65 28 70 43 65 6c 6c 2c 20 69 43 68 69 6c yte(pCell, iChil
33590 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6a 20 d);. }. j
335a0 3d 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c = pPage->nOverfl
335b0 6f 77 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 74 ow++;. assert
335c0 28 20 6a 3c 28 69 6e 74 29 28 73 69 7a 65 6f 66 ( j<(int)(sizeof
335d0 28 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 2f (pPage->apOvfl)/
335e0 73 69 7a 65 6f 66 28 70 50 61 67 65 2d 3e 61 70 sizeof(pPage->ap
335f0 4f 76 66 6c 5b 30 5d 29 29 20 29 3b 0a 20 20 20 Ovfl[0])) );.
33600 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 6a pPage->apOvfl[j
33610 5d 20 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 20 70 ] = pCell;. p
33620 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 5d 20 Page->aiOvfl[j]
33630 3d 20 28 75 31 36 29 69 3b 0a 20 20 7d 65 6c 73 = (u16)i;. }els
33640 65 7b 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 e{. int rc =
33650 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
33660 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
33670 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
33680 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
33690 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 *pRC = rc;.
336a0 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d return;. }
336b0 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
336c0 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 ite3PagerIswrite
336d0 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 able(pPage->pDbP
336e0 61 67 65 29 20 29 3b 0a 20 20 20 20 64 61 74 61 age) );. data
336f0 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b = pPage->aData;
33700 0a 20 20 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 . cellOffset
33710 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 = pPage->cellOff
33720 73 65 74 3b 0a 20 20 20 20 65 6e 64 20 3d 20 63 set;. end = c
33730 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 ellOffset + 2*pP
33740 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 age->nCell;.
33750 69 6e 73 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 ins = cellOffset
33760 20 2b 20 32 2a 69 3b 0a 20 20 20 20 72 63 20 3d + 2*i;. rc =
33770 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 70 allocateSpace(p
33780 50 61 67 65 2c 20 73 7a 2c 20 26 69 64 78 29 3b Page, sz, &idx);
33790 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 20 2a . if( rc ){ *
337a0 70 52 43 20 3d 20 72 63 3b 20 72 65 74 75 72 6e pRC = rc; return
337b0 3b 20 7d 0a 20 20 20 20 2f 2a 20 54 68 65 20 61 ; }. /* The a
337c0 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 29 20 72 llocateSpace() r
337d0 6f 75 74 69 6e 65 20 67 75 61 72 61 6e 74 65 65 outine guarantee
337e0 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 s the following
337f0 74 77 6f 20 70 72 6f 70 65 72 74 69 65 73 0a 20 two properties.
33800 20 20 20 2a 2a 20 69 66 20 69 74 20 72 65 74 75 ** if it retu
33810 72 6e 73 20 73 75 63 63 65 73 73 20 2a 2f 0a 20 rns success */.
33820 20 20 20 61 73 73 65 72 74 28 20 69 64 78 20 3e assert( idx >
33830 3d 20 65 6e 64 2b 32 20 29 3b 0a 20 20 20 20 61 = end+2 );. a
33840 73 73 65 72 74 28 20 69 64 78 2b 73 7a 20 3c 3d ssert( idx+sz <=
33850 20 28 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 (int)pPage->pBt
33860 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ->usableSize );.
33870 20 20 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c pPage->nCell
33880 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e ++;. pPage->n
33890 46 72 65 65 20 2d 3d 20 28 75 31 36 29 28 32 20 Free -= (u16)(2
338a0 2b 20 73 7a 29 3b 0a 20 20 20 20 6d 65 6d 63 70 + sz);. memcp
338b0 79 28 26 64 61 74 61 5b 69 64 78 5d 2c 20 70 43 y(&data[idx], pC
338c0 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 20 69 66 ell, sz);. if
338d0 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 20 ( iChild ){.
338e0 20 20 70 75 74 34 62 79 74 65 28 26 64 61 74 61 put4byte(&data
338f0 5b 69 64 78 5d 2c 20 69 43 68 69 6c 64 29 3b 0a [idx], iChild);.
33900 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 6d 6f 76 }. memmov
33910 65 28 26 64 61 74 61 5b 69 6e 73 2b 32 5d 2c 20 e(&data[ins+2],
33920 26 64 61 74 61 5b 69 6e 73 5d 2c 20 65 6e 64 2d &data[ins], end-
33930 69 6e 73 29 3b 0a 20 20 20 20 70 75 74 32 62 79 ins);. put2by
33940 74 65 28 26 64 61 74 61 5b 69 6e 73 5d 2c 20 69 te(&data[ins], i
33950 64 78 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 dx);. put2byt
33960 65 28 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 68 e(&data[pPage->h
33970 64 72 4f 66 66 73 65 74 2b 33 5d 2c 20 70 50 61 drOffset+3], pPa
33980 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 23 69 66 6e ge->nCell);.#ifn
33990 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
339a0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 AUTOVACUUM. i
339b0 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 61 f( pPage->pBt->a
339c0 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 utoVacuum ){.
339d0 20 20 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 6d /* The cell m
339e0 61 79 20 63 6f 6e 74 61 69 6e 20 61 20 70 6f 69 ay contain a poi
339f0 6e 74 65 72 20 74 6f 20 61 6e 20 6f 76 65 72 66 nter to an overf
33a00 6c 6f 77 20 70 61 67 65 2e 20 49 66 20 73 6f 2c low page. If so,
33a10 20 77 72 69 74 65 0a 20 20 20 20 20 20 2a 2a 20 write. **
33a20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 the entry for th
33a30 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 e overflow page
33a40 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 into the pointer
33a50 20 6d 61 70 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 map.. */.
33a60 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 ptrmapPutOv
33a70 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 flPtr(pPage, pCe
33a80 6c 6c 2c 20 70 52 43 29 3b 0a 20 20 20 20 7d 0a ll, pRC);. }.
33a90 23 65 6e 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a #endif. }.}../*
33aa0 0a 2a 2a 20 41 72 72 61 79 20 61 70 43 65 6c 6c .** Array apCell
33ab0 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e [] contains poin
33ac0 74 65 72 73 20 74 6f 20 6e 43 65 6c 6c 20 62 2d ters to nCell b-
33ad0 74 72 65 65 20 70 61 67 65 20 63 65 6c 6c 73 2e tree page cells.
33ae0 20 54 68 65 20 0a 2a 2a 20 73 7a 43 65 6c 6c 5b The .** szCell[
33af0 5d 20 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 73 ] array contains
33b00 20 74 68 65 20 73 69 7a 65 20 69 6e 20 62 79 74 the size in byt
33b10 65 73 20 6f 66 20 65 61 63 68 20 63 65 6c 6c 2e es of each cell.
33b20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a This function.*
33b30 2a 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 63 * replaces the c
33b40 75 72 72 65 6e 74 20 63 6f 6e 74 65 6e 74 73 20 urrent contents
33b50 6f 66 20 70 61 67 65 20 70 50 67 20 77 69 74 68 of page pPg with
33b60 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 the contents of
33b70 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 61 72 72 the cell.** arr
33b80 61 79 2e 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 6f ay..**.** Some o
33b90 66 20 74 68 65 20 63 65 6c 6c 73 20 69 6e 20 61 f the cells in a
33ba0 70 43 65 6c 6c 5b 5d 20 6d 61 79 20 63 75 72 72 pCell[] may curr
33bb0 65 6e 74 6c 79 20 62 65 20 73 74 6f 72 65 64 20 ently be stored
33bc0 69 6e 20 70 50 67 2e 20 54 68 69 73 0a 2a 2a 20 in pPg. This.**
33bd0 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 61 function works a
33be0 72 6f 75 6e 64 20 70 72 6f 62 6c 65 6d 73 20 63 round problems c
33bf0 61 75 73 65 64 20 62 79 20 74 68 69 73 20 62 79 aused by this by
33c00 20 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 20 6f making a copy o
33c10 66 20 61 6e 79 20 0a 2a 2a 20 73 75 63 68 20 63 f any .** such c
33c20 65 6c 6c 73 20 62 65 66 6f 72 65 20 6f 76 65 72 ells before over
33c30 77 72 69 74 69 6e 67 20 74 68 65 20 70 61 67 65 writing the page
33c40 20 64 61 74 61 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 data..**.** The
33c50 20 4d 65 6d 50 61 67 65 2e 6e 46 72 65 65 20 66 MemPage.nFree f
33c60 69 65 6c 64 20 69 73 20 69 6e 76 61 6c 69 64 61 ield is invalida
33c70 74 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 ted by this func
33c80 74 69 6f 6e 2e 20 49 74 20 69 73 20 74 68 65 20 tion. It is the
33c90 0a 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 .** responsibili
33ca0 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 ty of the caller
33cb0 20 74 6f 20 73 65 74 20 69 74 20 63 6f 72 72 65 to set it corre
33cc0 63 74 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ctly..*/.static
33cd0 76 6f 69 64 20 72 65 62 75 69 6c 64 50 61 67 65 void rebuildPage
33ce0 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 (. MemPage *pPg
33cf0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
33d00 20 20 20 20 2f 2a 20 45 64 69 74 20 74 68 69 73 /* Edit this
33d10 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e page */. int n
33d20 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Cell,
33d30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
33d40 6e 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 nal number of ce
33d50 6c 6c 73 20 6f 6e 20 70 61 67 65 20 2a 2f 0a 20 lls on page */.
33d60 20 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 u8 **apCell,
33d70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33d80 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 6c /* Array of cel
33d90 6c 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 ls */. u16 *szC
33da0 65 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 ell
33db0 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 /* Array
33dc0 20 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a of cell sizes *
33dd0 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 /.){. const int
33de0 20 68 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f hdr = pPg->hdrO
33df0 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 20 ffset;
33e00 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 68 65 61 /* Offset of hea
33e10 64 65 72 20 6f 6e 20 70 50 67 20 2a 2f 0a 20 20 der on pPg */.
33e20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 61 u8 * const aData
33e30 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 3b 20 20 = pPg->aData;
33e40 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
33e50 74 65 72 20 74 6f 20 64 61 74 61 20 66 6f 72 20 ter to data for
33e60 70 50 67 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 pPg */. const i
33e70 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 nt usableSize =
33e80 70 50 67 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 pPg->pBt->usable
33e90 53 69 7a 65 3b 0a 20 20 75 38 20 2a 20 63 6f 6e Size;. u8 * con
33ea0 73 74 20 70 45 6e 64 20 3d 20 26 61 44 61 74 61 st pEnd = &aData
33eb0 5b 75 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 [usableSize];.
33ec0 69 6e 74 20 69 3b 0a 20 20 75 38 20 2a 70 43 65 int i;. u8 *pCe
33ed0 6c 6c 70 74 72 20 3d 20 70 50 67 2d 3e 61 43 65 llptr = pPg->aCe
33ee0 6c 6c 49 64 78 3b 0a 20 20 75 38 20 2a 70 54 6d llIdx;. u8 *pTm
33ef0 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 p = sqlite3Pager
33f00 54 65 6d 70 53 70 61 63 65 28 70 50 67 2d 3e 70 TempSpace(pPg->p
33f10 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 75 Bt->pPager);. u
33f20 38 20 2a 70 44 61 74 61 3b 0a 0a 20 20 69 20 3d 8 *pData;.. i =
33f30 20 67 65 74 32 62 79 74 65 28 26 61 44 61 74 61 get2byte(&aData
33f40 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 6d 65 6d 63 [hdr+5]);. memc
33f50 70 79 28 26 70 54 6d 70 5b 69 5d 2c 20 26 61 44 py(&pTmp[i], &aD
33f60 61 74 61 5b 69 5d 2c 20 75 73 61 62 6c 65 53 69 ata[i], usableSi
33f70 7a 65 20 2d 20 69 29 3b 0a 0a 20 20 70 44 61 74 ze - i);.. pDat
33f80 61 20 3d 20 70 45 6e 64 3b 0a 20 20 66 6f 72 28 a = pEnd;. for(
33f90 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b i=0; i<nCell; i+
33fa0 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 6c +){. u8 *pCel
33fb0 6c 20 3d 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a 20 l = apCell[i];.
33fc0 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 61 44 61 if( pCell>aDa
33fd0 74 61 20 26 26 20 70 43 65 6c 6c 3c 70 45 6e 64 ta && pCell<pEnd
33fe0 20 29 7b 0a 20 20 20 20 20 20 70 43 65 6c 6c 20 ){. pCell
33ff0 3d 20 26 70 54 6d 70 5b 70 43 65 6c 6c 20 2d 20 = &pTmp[pCell -
34000 61 44 61 74 61 5d 3b 0a 20 20 20 20 7d 0a 20 20 aData];. }.
34010 20 20 70 44 61 74 61 20 2d 3d 20 73 7a 43 65 6c pData -= szCel
34020 6c 5b 69 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 l[i];. memcpy
34030 28 70 44 61 74 61 2c 20 70 43 65 6c 6c 2c 20 73 (pData, pCell, s
34040 7a 43 65 6c 6c 5b 69 5d 29 3b 0a 20 20 20 20 70 zCell[i]);. p
34050 75 74 32 62 79 74 65 28 70 43 65 6c 6c 70 74 72 ut2byte(pCellptr
34060 2c 20 28 70 44 61 74 61 20 2d 20 61 44 61 74 61 , (pData - aData
34070 29 29 3b 0a 20 20 20 20 70 43 65 6c 6c 70 74 72 ));. pCellptr
34080 20 2b 3d 20 32 3b 0a 20 20 20 20 61 73 73 65 72 += 2;. asser
34090 74 28 20 73 7a 43 65 6c 6c 5b 69 5d 3d 3d 63 65 t( szCell[i]==ce
340a0 6c 6c 53 69 7a 65 50 74 72 28 70 50 67 2c 20 70 llSizePtr(pPg, p
340b0 43 65 6c 6c 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 Cell) );. }..
340c0 2f 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 72 65 /* The pPg->nFre
340d0 65 20 66 69 65 6c 64 20 69 73 20 6e 6f 77 20 73 e field is now s
340e0 65 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 2e 20 et incorrectly.
340f0 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 The caller will
34100 66 69 78 20 69 74 2e 20 2a 2f 0a 20 20 70 50 67 fix it. */. pPg
34110 2d 3e 6e 43 65 6c 6c 20 3d 20 6e 43 65 6c 6c 3b ->nCell = nCell;
34120 0a 20 20 70 50 67 2d 3e 6e 4f 76 65 72 66 6c 6f . pPg->nOverflo
34130 77 20 3d 20 30 3b 0a 0a 20 20 70 75 74 32 62 79 w = 0;.. put2by
34140 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b 31 5d te(&aData[hdr+1]
34150 2c 20 30 29 3b 0a 20 20 70 75 74 32 62 79 74 65 , 0);. put2byte
34160 28 26 61 44 61 74 61 5b 68 64 72 2b 33 5d 2c 20 (&aData[hdr+3],
34170 70 50 67 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 70 pPg->nCell);. p
34180 75 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 68 ut2byte(&aData[h
34190 64 72 2b 35 5d 2c 20 70 44 61 74 61 20 2d 20 61 dr+5], pData - a
341a0 44 61 74 61 29 3b 0a 20 20 61 44 61 74 61 5b 68 Data);. aData[h
341b0 64 72 2b 37 5d 20 3d 20 30 78 30 30 3b 0a 7d 0a dr+7] = 0x00;.}.
341c0 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 20 61 70 43 ./*.** Array apC
341d0 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 6e ell[] contains n
341e0 43 65 6c 6c 20 70 6f 69 6e 74 65 72 73 20 74 6f Cell pointers to
341f0 20 62 2d 74 72 65 65 20 63 65 6c 6c 73 2e 20 41 b-tree cells. A
34200 72 72 61 79 20 73 7a 43 65 6c 6c 0a 2a 2a 20 63 rray szCell.** c
34210 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 69 7a 65 ontains the size
34220 20 69 6e 20 62 79 74 65 73 20 6f 66 20 65 61 63 in bytes of eac
34230 68 20 73 75 63 68 20 63 65 6c 6c 2e 20 54 68 69 h such cell. Thi
34240 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d s function attem
34250 70 74 73 20 74 6f 20 0a 2a 2a 20 61 64 64 20 74 pts to .** add t
34260 68 65 20 63 65 6c 6c 73 20 73 74 6f 72 65 64 20 he cells stored
34270 69 6e 20 74 68 65 20 61 72 72 61 79 20 74 6f 20 in the array to
34280 70 61 67 65 20 70 50 67 2e 20 49 66 20 69 74 20 page pPg. If it
34290 63 61 6e 6e 6f 74 20 28 62 65 63 61 75 73 65 20 cannot (because
342a0 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 6e 65 65 .** the page nee
342b0 64 73 20 74 6f 20 62 65 20 64 65 66 72 61 67 6d ds to be defragm
342c0 65 6e 74 65 64 20 62 65 66 6f 72 65 20 74 68 65 ented before the
342d0 20 63 65 6c 6c 73 20 77 69 6c 6c 20 66 69 74 29 cells will fit)
342e0 2c 20 6e 6f 6e 2d 7a 65 72 6f 0a 2a 2a 20 69 73 , non-zero.** is
342f0 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 returned. Other
34300 77 69 73 65 2c 20 69 66 20 74 68 65 20 63 65 6c wise, if the cel
34310 6c 73 20 61 72 65 20 61 64 64 65 64 20 73 75 63 ls are added suc
34320 63 65 73 73 66 75 6c 6c 79 2c 20 7a 65 72 6f 20 cessfully, zero
34330 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 2e 0a is.** returned..
34340 2a 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 70 **.** Argument p
34350 43 65 6c 6c 70 74 72 20 70 6f 69 6e 74 73 20 74 Cellptr points t
34360 6f 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 o the first entr
34370 79 20 69 6e 20 74 68 65 20 63 65 6c 6c 2d 70 6f y in the cell-po
34380 69 6e 74 65 72 20 61 72 72 61 79 0a 2a 2a 20 28 inter array.** (
34390 70 61 72 74 20 6f 66 20 70 61 67 65 20 70 50 67 part of page pPg
343a0 29 20 74 6f 20 70 6f 70 75 6c 61 74 65 2e 20 41 ) to populate. A
343b0 66 74 65 72 20 63 65 6c 6c 20 61 70 43 65 6c 6c fter cell apCell
343c0 5b 30 5d 20 69 73 20 77 72 69 74 74 65 6e 20 74 [0] is written t
343d0 6f 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 62 6f o the.** page bo
343e0 64 79 2c 20 61 20 31 36 2d 62 69 74 20 6f 66 66 dy, a 16-bit off
343f0 73 65 74 20 69 73 20 77 72 69 74 74 65 6e 20 74 set is written t
34400 6f 20 70 43 65 6c 6c 70 74 72 2e 20 41 6e 64 20 o pCellptr. And
34410 73 6f 20 6f 6e 2c 20 66 6f 72 20 65 61 63 68 0a so on, for each.
34420 2a 2a 20 63 65 6c 6c 20 69 6e 20 74 68 65 20 61 ** cell in the a
34430 72 72 61 79 2e 20 49 74 20 69 73 20 74 68 65 20 rray. It is the
34440 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f responsibility o
34450 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 f the caller to
34460 65 6e 73 75 72 65 0a 2a 2a 20 74 68 61 74 20 69 ensure.** that i
34470 74 20 69 73 20 73 61 66 65 20 74 6f 20 6f 76 65 t is safe to ove
34480 72 77 72 69 74 65 20 74 68 69 73 20 70 61 72 74 rwrite this part
34490 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 70 6f 69 of the cell-poi
344a0 6e 74 65 72 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a nter array..**.*
344b0 2a 20 57 68 65 6e 20 74 68 69 73 20 66 75 6e 63 * When this func
344c0 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 tion is called,
344d0 2a 70 70 44 61 74 61 20 70 6f 69 6e 74 73 20 74 *ppData points t
344e0 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 o the start of t
344f0 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 61 he .** content a
34500 72 65 61 20 6f 6e 20 70 61 67 65 20 70 50 67 2e rea on page pPg.
34510 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f 66 20 If the size of
34520 74 68 65 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 the content area
34530 20 69 73 20 65 78 74 65 6e 64 65 64 2c 0a 2a 2a is extended,.**
34540 20 2a 70 70 44 61 74 61 20 69 73 20 75 70 64 61 *ppData is upda
34550 74 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 ted to point to
34560 74 68 65 20 6e 65 77 20 73 74 61 72 74 20 6f 66 the new start of
34570 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 61 72 65 the content are
34580 61 0a 2a 2a 20 62 65 66 6f 72 65 20 72 65 74 75 a.** before retu
34590 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 46 69 6e rning..**.** Fin
345a0 61 6c 6c 79 2c 20 61 72 67 75 6d 65 6e 74 20 70 ally, argument p
345b0 42 65 67 69 6e 20 70 6f 69 6e 74 73 20 74 6f 20 Begin points to
345c0 74 68 65 20 62 79 74 65 20 69 6d 6d 65 64 69 61 the byte immedia
345d0 74 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 tely following t
345e0 68 65 0a 2a 2a 20 65 6e 64 20 6f 66 20 74 68 65 he.** end of the
345f0 20 73 70 61 63 65 20 72 65 71 75 69 72 65 64 20 space required
34600 62 79 20 74 68 69 73 20 70 61 67 65 20 66 6f 72 by this page for
34610 20 74 68 65 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 the cell-pointe
34620 72 20 61 72 65 61 20 28 66 6f 72 0a 2a 2a 20 61 r area (for.** a
34630 6c 6c 20 63 65 6c 6c 73 20 2d 20 6e 6f 74 20 6a ll cells - not j
34640 75 73 74 20 74 68 6f 73 65 20 69 6e 73 65 72 74 ust those insert
34650 65 64 20 62 79 20 74 68 65 20 63 75 72 72 65 6e ed by the curren
34660 74 20 63 61 6c 6c 29 2e 20 49 66 20 74 68 65 20 t call). If the
34670 63 6f 6e 74 65 6e 74 0a 2a 2a 20 61 72 65 61 20 content.** area
34680 6d 75 73 74 20 62 65 20 65 78 74 65 6e 64 65 64 must be extended
34690 20 74 6f 20 62 65 66 6f 72 65 20 74 68 69 73 20 to before this
346a0 70 6f 69 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 point in order t
346b0 6f 20 61 63 63 6f 6d 6f 64 61 74 65 20 61 6c 6c o accomodate all
346c0 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 .** cells in apC
346d0 65 6c 6c 5b 5d 2c 20 74 68 65 6e 20 74 68 65 20 ell[], then the
346e0 63 65 6c 6c 73 20 64 6f 20 6e 6f 74 20 66 69 74 cells do not fit
346f0 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20 69 73 and non-zero is
34700 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 returned..*/.st
34710 61 74 69 63 20 69 6e 74 20 70 61 67 65 49 6e 73 atic int pageIns
34720 65 72 74 41 72 72 61 79 28 0a 20 20 4d 65 6d 50 ertArray(. MemP
34730 61 67 65 20 2a 70 50 67 2c 20 20 20 20 20 20 20 age *pPg,
34740 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
34750 61 67 65 20 74 6f 20 61 64 64 20 63 65 6c 6c 73 age to add cells
34760 20 74 6f 20 2a 2f 0a 20 20 75 38 20 2a 70 42 65 to */. u8 *pBe
34770 67 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 gin,
34780 20 20 20 20 20 20 20 20 20 2f 2a 20 45 6e 64 20 /* End
34790 6f 66 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 20 of cell-pointer
347a0 61 72 72 61 79 20 2a 2f 0a 20 20 75 38 20 2a 2a array */. u8 **
347b0 70 70 44 61 74 61 2c 20 20 20 20 20 20 20 20 20 ppData,
347c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4e /* IN
347d0 2f 4f 55 54 3a 20 50 61 67 65 20 63 6f 6e 74 65 /OUT: Page conte
347e0 6e 74 20 2d 61 72 65 61 20 70 6f 69 6e 74 65 72 nt -area pointer
347f0 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 70 */. u8 *pCellp
34800 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 tr,
34810 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
34820 20 74 6f 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 to cell-pointer
34830 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 6e area */. int n
34840 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Cell,
34850 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
34860 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 74 6f mber of cells to
34870 20 61 64 64 20 74 6f 20 70 50 67 20 2a 2f 0a 20 add to pPg */.
34880 20 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 u8 **apCell,
34890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
348a0 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 6c /* Array of cel
348b0 6c 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 ls */. u16 *szC
348c0 65 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 ell
348d0 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 /* Array
348e0 20 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a of cell sizes *
348f0 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 /.){. int i;.
34900 75 38 20 2a 61 44 61 74 61 20 3d 20 70 50 67 2d u8 *aData = pPg-
34910 3e 61 44 61 74 61 3b 0a 20 20 75 38 20 2a 70 44 >aData;. u8 *pD
34920 61 74 61 20 3d 20 2a 70 70 44 61 74 61 3b 0a 20 ata = *ppData;.
34930 20 63 6f 6e 73 74 20 69 6e 74 20 62 46 72 65 65 const int bFree
34940 6c 69 73 74 20 3d 20 61 44 61 74 61 5b 31 5d 20 list = aData[1]
34950 7c 7c 20 61 44 61 74 61 5b 32 5d 3b 0a 20 20 61 || aData[2];. a
34960 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 ssert( CORRUPT_D
34970 42 20 7c 7c 20 70 50 67 2d 3e 68 64 72 4f 66 66 B || pPg->hdrOff
34980 73 65 74 3d 3d 30 20 29 3b 20 20 20 20 2f 2a 20 set==0 ); /*
34990 4e 65 76 65 72 20 63 61 6c 6c 65 64 20 6f 6e 20 Never called on
349a0 70 61 67 65 20 31 20 2a 2f 0a 20 20 66 6f 72 28 page 1 */. for(
349b0 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b i=0; i<nCell; i+
349c0 2b 29 7b 0a 20 20 20 20 69 6e 74 20 73 7a 20 3d +){. int sz =
349d0 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 szCell[i];.
349e0 69 6e 74 20 72 63 3b 0a 20 20 20 20 75 38 20 2a int rc;. u8 *
349f0 70 53 6c 6f 74 3b 0a 20 20 20 20 69 66 28 20 62 pSlot;. if( b
34a00 46 72 65 65 6c 69 73 74 3d 3d 30 20 7c 7c 20 28 Freelist==0 || (
34a10 70 53 6c 6f 74 20 3d 20 70 61 67 65 46 69 6e 64 pSlot = pageFind
34a20 53 6c 6f 74 28 70 50 67 2c 20 73 7a 2c 20 26 72 Slot(pPg, sz, &r
34a30 63 2c 20 30 29 29 3d 3d 30 20 29 7b 0a 20 20 20 c, 0))==0 ){.
34a40 20 20 20 70 44 61 74 61 20 2d 3d 20 73 7a 3b 0a pData -= sz;.
34a50 20 20 20 20 20 20 69 66 28 20 70 44 61 74 61 3c if( pData<
34a60 70 42 65 67 69 6e 20 29 20 72 65 74 75 72 6e 20 pBegin ) return
34a70 31 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74 20 3d 1;. pSlot =
34a80 20 70 44 61 74 61 3b 0a 20 20 20 20 7d 0a 20 20 pData;. }.
34a90 20 20 6d 65 6d 63 70 79 28 70 53 6c 6f 74 2c 20 memcpy(pSlot,
34aa0 61 70 43 65 6c 6c 5b 69 5d 2c 20 73 7a 29 3b 0a apCell[i], sz);.
34ab0 20 20 20 20 70 75 74 32 62 79 74 65 28 70 43 65 put2byte(pCe
34ac0 6c 6c 70 74 72 2c 20 28 70 53 6c 6f 74 20 2d 20 llptr, (pSlot -
34ad0 61 44 61 74 61 29 29 3b 0a 20 20 20 20 70 43 65 aData));. pCe
34ae0 6c 6c 70 74 72 20 2b 3d 20 32 3b 0a 20 20 7d 0a llptr += 2;. }.
34af0 20 20 2a 70 70 44 61 74 61 20 3d 20 70 44 61 74 *ppData = pDat
34b00 61 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d a;. return 0;.}
34b10 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 20 61 70 ../*.** Array ap
34b20 43 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 Cell[] contains
34b30 6e 43 65 6c 6c 20 70 6f 69 6e 74 65 72 73 20 74 nCell pointers t
34b40 6f 20 62 2d 74 72 65 65 20 63 65 6c 6c 73 2e 20 o b-tree cells.
34b50 41 72 72 61 79 20 73 7a 43 65 6c 6c 20 0a 2a 2a Array szCell .**
34b60 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 69 contains the si
34b70 7a 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 65 ze in bytes of e
34b80 61 63 68 20 73 75 63 68 20 63 65 6c 6c 2e 20 54 ach such cell. T
34b90 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 64 64 his function add
34ba0 73 20 74 68 65 0a 2a 2a 20 73 70 61 63 65 20 61 s the.** space a
34bb0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 65 ssociated with e
34bc0 61 63 68 20 63 65 6c 6c 20 69 6e 20 74 68 65 20 ach cell in the
34bd0 61 72 72 61 79 20 74 68 61 74 20 69 73 20 63 75 array that is cu
34be0 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 0a rrently stored .
34bf0 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 62 6f ** within the bo
34c00 64 79 20 6f 66 20 70 50 67 20 74 6f 20 74 68 65 dy of pPg to the
34c10 20 70 50 67 20 66 72 65 65 2d 6c 69 73 74 2e 20 pPg free-list.
34c20 54 68 65 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 The cell-pointer
34c30 73 20 61 6e 64 20 6f 74 68 65 72 0a 2a 2a 20 66 s and other.** f
34c40 69 65 6c 64 73 20 6f 66 20 74 68 65 20 70 61 67 ields of the pag
34c50 65 20 61 72 65 20 6e 6f 74 20 75 70 64 61 74 65 e are not update
34c60 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 d..**.** This fu
34c70 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 nction returns t
34c80 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 he total number
34c90 6f 66 20 63 65 6c 6c 73 20 61 64 64 65 64 20 74 of cells added t
34ca0 6f 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e o the free-list.
34cb0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
34cc0 61 67 65 46 72 65 65 41 72 72 61 79 28 0a 20 20 ageFreeArray(.
34cd0 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 20 MemPage *pPg,
34ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34cf0 2f 2a 20 50 61 67 65 20 74 6f 20 65 64 69 74 20 /* Page to edit
34d00 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 2c 20 */. int nCell,
34d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34d20 20 20 20 20 20 2f 2a 20 43 65 6c 6c 73 20 74 6f /* Cells to
34d30 20 64 65 6c 65 74 65 20 2a 2f 0a 20 20 75 38 20 delete */. u8
34d40 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 **apCell,
34d50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
34d60 41 72 72 61 79 20 6f 66 20 63 65 6c 6c 73 20 2a Array of cells *
34d70 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c 6c 20 /. u16 *szCell
34d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34d90 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 /* Array of
34da0 63 65 6c 6c 20 73 69 7a 65 73 20 2a 2f 0a 29 7b cell sizes */.){
34db0 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 . u8 * const aD
34dc0 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 ata = pPg->aData
34dd0 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 ;. u8 * const p
34de0 45 6e 64 20 3d 20 26 61 44 61 74 61 5b 70 50 67 End = &aData[pPg
34df0 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
34e00 65 5d 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 e];. u8 * const
34e10 20 70 53 74 61 72 74 20 3d 20 26 61 44 61 74 61 pStart = &aData
34e20 5b 70 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 20 [pPg->hdrOffset
34e30 2b 20 38 20 2b 20 70 50 67 2d 3e 63 68 69 6c 64 + 8 + pPg->child
34e40 50 74 72 53 69 7a 65 5d 3b 0a 20 20 69 6e 74 20 PtrSize];. int
34e50 6e 52 65 74 20 3d 20 30 3b 0a 20 20 69 6e 74 20 nRet = 0;. int
34e60 69 3b 0a 20 20 75 38 20 2a 70 46 72 65 65 20 3d i;. u8 *pFree =
34e70 20 30 3b 0a 20 20 69 6e 74 20 73 7a 46 72 65 65 0;. int szFree
34e80 20 3d 20 30 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 = 0;.. for(i=0
34e90 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b ; i<nCell; i++){
34ea0 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d . u8 *pCell =
34eb0 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 apCell[i];.
34ec0 69 66 28 20 70 43 65 6c 6c 3e 3d 70 53 74 61 72 if( pCell>=pStar
34ed0 74 20 26 26 20 70 43 65 6c 6c 3c 70 45 6e 64 20 t && pCell<pEnd
34ee0 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 ){. int sz
34ef0 3d 20 73 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 = szCell[i];.
34f00 20 20 20 69 66 28 20 70 46 72 65 65 21 3d 28 70 if( pFree!=(p
34f10 43 65 6c 6c 20 2b 20 73 7a 29 20 29 7b 0a 20 20 Cell + sz) ){.
34f20 20 20 20 20 20 20 69 66 28 20 70 46 72 65 65 20 if( pFree
34f30 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 ){. ass
34f40 65 72 74 28 20 70 46 72 65 65 3e 61 44 61 74 61 ert( pFree>aData
34f50 20 26 26 20 28 70 46 72 65 65 20 2d 20 61 44 61 && (pFree - aDa
34f60 74 61 29 3c 36 35 35 33 36 20 29 3b 0a 20 20 20 ta)<65536 );.
34f70 20 20 20 20 20 20 20 66 72 65 65 53 70 61 63 65 freeSpace
34f80 28 70 50 67 2c 20 28 75 31 36 29 28 70 46 72 65 (pPg, (u16)(pFre
34f90 65 20 2d 20 61 44 61 74 61 29 2c 20 73 7a 46 72 e - aData), szFr
34fa0 65 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ee);. }.
34fb0 20 20 20 20 20 20 20 70 46 72 65 65 20 3d 20 70 pFree = p
34fc0 43 65 6c 6c 3b 0a 20 20 20 20 20 20 20 20 73 7a Cell;. sz
34fd0 46 72 65 65 20 3d 20 73 7a 3b 0a 20 20 20 20 20 Free = sz;.
34fe0 20 20 20 69 66 28 20 70 46 72 65 65 2b 73 7a 3e if( pFree+sz>
34ff0 70 45 6e 64 20 29 20 72 65 74 75 72 6e 20 30 3b pEnd ) return 0;
35000 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
35010 20 20 20 20 20 20 70 46 72 65 65 20 3d 20 70 43 pFree = pC
35020 65 6c 6c 3b 0a 20 20 20 20 20 20 20 20 73 7a 46 ell;. szF
35030 72 65 65 20 2b 3d 20 73 7a 3b 0a 20 20 20 20 20 ree += sz;.
35040 20 7d 0a 20 20 20 20 20 20 6e 52 65 74 2b 2b 3b }. nRet++;
35050 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 . }. }. if(
35060 20 70 46 72 65 65 20 29 7b 0a 20 20 20 20 61 73 pFree ){. as
35070 73 65 72 74 28 20 70 46 72 65 65 3e 61 44 61 74 sert( pFree>aDat
35080 61 20 26 26 20 28 70 46 72 65 65 20 2d 20 61 44 a && (pFree - aD
35090 61 74 61 29 3c 36 35 35 33 36 20 29 3b 0a 20 20 ata)<65536 );.
350a0 20 20 66 72 65 65 53 70 61 63 65 28 70 50 67 2c freeSpace(pPg,
350b0 20 28 75 31 36 29 28 70 46 72 65 65 20 2d 20 61 (u16)(pFree - a
350c0 44 61 74 61 29 2c 20 73 7a 46 72 65 65 29 3b 0a Data), szFree);.
350d0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 52 65 }. return nRe
350e0 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 61 70 43 65 t;.}../*.** apCe
350f0 6c 6c 5b 5d 20 61 6e 64 20 73 7a 43 65 6c 6c 5b ll[] and szCell[
35100 5d 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 ] contains point
35110 65 72 73 20 74 6f 20 61 6e 64 20 73 69 7a 65 73 ers to and sizes
35120 20 6f 66 20 61 6c 6c 20 63 65 6c 6c 73 20 69 6e of all cells in
35130 20 74 68 65 0a 2a 2a 20 70 61 67 65 73 20 62 65 the.** pages be
35140 69 6e 67 20 62 61 6c 61 6e 63 65 64 2e 20 20 54 ing balanced. T
35150 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 2c he current page,
35160 20 70 50 67 2c 20 68 61 73 20 70 50 67 2d 3e 6e pPg, has pPg->n
35170 43 65 6c 6c 20 63 65 6c 6c 73 20 73 74 61 72 74 Cell cells start
35180 69 6e 67 0a 2a 2a 20 77 69 74 68 20 61 70 43 65 ing.** with apCe
35190 6c 6c 5b 69 4f 6c 64 5d 2e 20 20 41 66 74 65 72 ll[iOld]. After
351a0 20 62 61 6c 61 6e 63 69 6e 67 2c 20 74 68 69 73 balancing, this
351b0 20 70 61 67 65 20 73 68 6f 75 6c 64 20 68 6f 6c page should hol
351c0 64 20 6e 4e 65 77 20 63 65 6c 6c 73 0a 2a 2a 20 d nNew cells.**
351d0 73 74 61 72 74 69 6e 67 20 61 74 20 61 70 43 65 starting at apCe
351e0 6c 6c 5b 69 4e 65 77 5d 2e 0a 2a 2a 0a 2a 2a 20 ll[iNew]..**.**
351f0 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 6b This routine mak
35200 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 72 79 es the necessary
35210 20 61 64 6a 75 73 74 6d 65 6e 74 73 20 74 6f 20 adjustments to
35220 70 50 67 20 73 6f 20 74 68 61 74 20 69 74 20 63 pPg so that it c
35230 6f 6e 74 61 69 6e 73 0a 2a 2a 20 74 68 65 20 63 ontains.** the c
35240 6f 72 72 65 63 74 20 63 65 6c 6c 73 20 61 66 74 orrect cells aft
35250 65 72 20 62 65 69 6e 67 20 62 61 6c 61 6e 63 65 er being balance
35260 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 50 67 d..**.** The pPg
35270 2d 3e 6e 46 72 65 65 20 66 69 65 6c 64 20 69 73 ->nFree field is
35280 20 69 6e 76 61 6c 69 64 20 77 68 65 6e 20 74 68 invalid when th
35290 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
352a0 72 6e 73 2e 20 49 74 20 69 73 20 74 68 65 0a 2a rns. It is the.*
352b0 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 * responsibility
352c0 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 of the caller t
352d0 6f 20 73 65 74 20 69 74 20 63 6f 72 72 65 63 74 o set it correct
352e0 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ly..*/.static vo
352f0 69 64 20 65 64 69 74 50 61 67 65 28 0a 20 20 4d id editPage(. M
35300 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 20 20 emPage *pPg,
35310 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
35320 2a 20 45 64 69 74 20 74 68 69 73 20 70 61 67 65 * Edit this page
35330 20 2a 2f 0a 20 20 69 6e 74 20 69 4f 6c 64 2c 20 */. int iOld,
35340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35350 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f /* Index o
35360 66 20 66 69 72 73 74 20 63 65 6c 6c 20 63 75 72 f first cell cur
35370 72 65 6e 74 6c 79 20 6f 6e 20 70 61 67 65 20 2a rently on page *
35380 2f 0a 20 20 69 6e 74 20 69 4e 65 77 2c 20 20 20 /. int iNew,
35390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
353a0 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 /* Index of
353b0 6e 65 77 20 66 69 72 73 74 20 63 65 6c 6c 20 6f new first cell o
353c0 6e 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 n page */. int
353d0 6e 4e 65 77 2c 20 20 20 20 20 20 20 20 20 20 20 nNew,
353e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
353f0 69 6e 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 inal number of c
35400 65 6c 6c 73 20 6f 6e 20 70 61 67 65 20 2a 2f 0a ells on page */.
35410 20 20 75 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 u8 **apCell,
35420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35430 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 65 /* Array of ce
35440 6c 6c 73 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a lls */. u16 *sz
35450 43 65 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 Cell
35460 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 /* Arra
35470 79 20 6f 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 y of cell sizes
35480 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 20 63 6f 6e */.){. u8 * con
35490 73 74 20 61 44 61 74 61 20 3d 20 70 50 67 2d 3e st aData = pPg->
354a0 61 44 61 74 61 3b 0a 20 20 63 6f 6e 73 74 20 69 aData;. const i
354b0 6e 74 20 68 64 72 20 3d 20 70 50 67 2d 3e 68 64 nt hdr = pPg->hd
354c0 72 4f 66 66 73 65 74 3b 0a 20 20 75 38 20 2a 70 rOffset;. u8 *p
354d0 42 65 67 69 6e 20 3d 20 26 70 50 67 2d 3e 61 43 Begin = &pPg->aC
354e0 65 6c 6c 49 64 78 5b 6e 4e 65 77 20 2a 20 32 5d ellIdx[nNew * 2]
354f0 3b 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 ;. int nCell =
35500 70 50 67 2d 3e 6e 43 65 6c 6c 3b 20 20 20 20 20 pPg->nCell;
35510 20 20 2f 2a 20 43 65 6c 6c 73 20 73 74 6f 72 65 /* Cells store
35520 64 20 6f 6e 20 70 50 67 20 2a 2f 0a 20 20 75 38 d on pPg */. u8
35530 20 2a 70 44 61 74 61 3b 0a 20 20 75 38 20 2a 70 *pData;. u8 *p
35540 43 65 6c 6c 70 74 72 3b 0a 20 20 69 6e 74 20 69 Cellptr;. int i
35550 3b 0a 20 20 69 6e 74 20 69 4f 6c 64 45 6e 64 20 ;. int iOldEnd
35560 3d 20 69 4f 6c 64 20 2b 20 70 50 67 2d 3e 6e 43 = iOld + pPg->nC
35570 65 6c 6c 20 2b 20 70 50 67 2d 3e 6e 4f 76 65 72 ell + pPg->nOver
35580 66 6c 6f 77 3b 0a 20 20 69 6e 74 20 69 4e 65 77 flow;. int iNew
35590 45 6e 64 20 3d 20 69 4e 65 77 20 2b 20 6e 4e 65 End = iNew + nNe
355a0 77 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 w;..#ifdef SQLIT
355b0 45 5f 44 45 42 55 47 0a 20 20 75 38 20 2a 70 54 E_DEBUG. u8 *pT
355c0 6d 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 mp = sqlite3Page
355d0 72 54 65 6d 70 53 70 61 63 65 28 70 50 67 2d 3e rTempSpace(pPg->
355e0 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 pBt->pPager);.
355f0 6d 65 6d 63 70 79 28 70 54 6d 70 2c 20 61 44 61 memcpy(pTmp, aDa
35600 74 61 2c 20 70 50 67 2d 3e 70 42 74 2d 3e 75 73 ta, pPg->pBt->us
35610 61 62 6c 65 53 69 7a 65 29 3b 0a 23 65 6e 64 69 ableSize);.#endi
35620 66 0a 0a 20 20 2f 2a 20 52 65 6d 6f 76 65 20 63 f.. /* Remove c
35630 65 6c 6c 73 20 66 72 6f 6d 20 74 68 65 20 73 74 ells from the st
35640 61 72 74 20 61 6e 64 20 65 6e 64 20 6f 66 20 74 art and end of t
35650 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 69 66 28 he page */. if(
35660 20 69 4f 6c 64 3c 69 4e 65 77 20 29 7b 0a 20 20 iOld<iNew ){.
35670 20 20 69 6e 74 20 6e 53 68 69 66 74 20 3d 20 70 int nShift = p
35680 61 67 65 46 72 65 65 41 72 72 61 79 28 0a 20 20 ageFreeArray(.
35690 20 20 20 20 20 20 70 50 67 2c 20 69 4e 65 77 2d pPg, iNew-
356a0 69 4f 6c 64 2c 20 26 61 70 43 65 6c 6c 5b 69 4f iOld, &apCell[iO
356b0 6c 64 5d 2c 20 26 73 7a 43 65 6c 6c 5b 69 4f 6c ld], &szCell[iOl
356c0 64 5d 0a 20 20 20 20 29 3b 0a 20 20 20 20 6d 65 d]. );. me
356d0 6d 6d 6f 76 65 28 70 50 67 2d 3e 61 43 65 6c 6c mmove(pPg->aCell
356e0 49 64 78 2c 20 26 70 50 67 2d 3e 61 43 65 6c 6c Idx, &pPg->aCell
356f0 49 64 78 5b 6e 53 68 69 66 74 2a 32 5d 2c 20 6e Idx[nShift*2], n
35700 43 65 6c 6c 2a 32 29 3b 0a 20 20 20 20 6e 43 65 Cell*2);. nCe
35710 6c 6c 20 2d 3d 20 6e 53 68 69 66 74 3b 0a 20 20 ll -= nShift;.
35720 7d 0a 20 20 69 66 28 20 69 4e 65 77 45 6e 64 20 }. if( iNewEnd
35730 3c 20 69 4f 6c 64 45 6e 64 20 29 7b 0a 20 20 20 < iOldEnd ){.
35740 20 6e 43 65 6c 6c 20 2d 3d 20 70 61 67 65 46 72 nCell -= pageFr
35750 65 65 41 72 72 61 79 28 0a 20 20 20 20 20 20 20 eeArray(.
35760 20 70 50 67 2c 20 69 4f 6c 64 45 6e 64 2d 69 4e pPg, iOldEnd-iN
35770 65 77 45 6e 64 2c 20 26 61 70 43 65 6c 6c 5b 69 ewEnd, &apCell[i
35780 4e 65 77 45 6e 64 5d 2c 20 26 73 7a 43 65 6c 6c NewEnd], &szCell
35790 5b 69 4e 65 77 45 6e 64 5d 0a 20 20 20 20 29 3b [iNewEnd]. );
357a0 0a 20 20 7d 0a 0a 20 20 70 44 61 74 61 20 3d 20 . }.. pData =
357b0 26 61 44 61 74 61 5b 67 65 74 32 62 79 74 65 4e &aData[get2byteN
357c0 6f 74 5a 65 72 6f 28 26 61 44 61 74 61 5b 68 64 otZero(&aData[hd
357d0 72 2b 35 5d 29 5d 3b 0a 20 20 69 66 28 20 70 44 r+5])];. if( pD
357e0 61 74 61 3c 70 42 65 67 69 6e 20 29 20 67 6f 74 ata<pBegin ) got
357f0 6f 20 65 64 69 74 70 61 67 65 5f 66 61 69 6c 3b o editpage_fail;
35800 0a 0a 20 20 2f 2a 20 41 64 64 20 63 65 6c 6c 73 .. /* Add cells
35810 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 to the start of
35820 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 69 the page */. i
35830 66 28 20 69 4e 65 77 3c 69 4f 6c 64 20 29 7b 0a f( iNew<iOld ){.
35840 20 20 20 20 69 6e 74 20 6e 41 64 64 20 3d 20 4d int nAdd = M
35850 49 4e 28 6e 4e 65 77 2c 69 4f 6c 64 2d 69 4e 65 IN(nNew,iOld-iNe
35860 77 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 w);. assert(
35870 28 69 4f 6c 64 2d 69 4e 65 77 29 3c 6e 4e 65 77 (iOld-iNew)<nNew
35880 20 7c 7c 20 6e 43 65 6c 6c 3d 3d 30 20 7c 7c 20 || nCell==0 ||
35890 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 CORRUPT_DB );.
358a0 20 20 70 43 65 6c 6c 70 74 72 20 3d 20 70 50 67 pCellptr = pPg
358b0 2d 3e 61 43 65 6c 6c 49 64 78 3b 0a 20 20 20 20 ->aCellIdx;.
358c0 6d 65 6d 6d 6f 76 65 28 26 70 43 65 6c 6c 70 74 memmove(&pCellpt
358d0 72 5b 6e 41 64 64 2a 32 5d 2c 20 70 43 65 6c 6c r[nAdd*2], pCell
358e0 70 74 72 2c 20 6e 43 65 6c 6c 2a 32 29 3b 0a 20 ptr, nCell*2);.
358f0 20 20 20 69 66 28 20 70 61 67 65 49 6e 73 65 72 if( pageInser
35900 74 41 72 72 61 79 28 0a 20 20 20 20 20 20 20 20 tArray(.
35910 20 20 70 50 67 2c 20 70 42 65 67 69 6e 2c 20 26 pPg, pBegin, &
35920 70 44 61 74 61 2c 20 70 43 65 6c 6c 70 74 72 2c pData, pCellptr,
35930 0a 20 20 20 20 20 20 20 20 20 20 6e 41 64 64 2c . nAdd,
35940 20 26 61 70 43 65 6c 6c 5b 69 4e 65 77 5d 2c 20 &apCell[iNew],
35950 26 73 7a 43 65 6c 6c 5b 69 4e 65 77 5d 0a 20 20 &szCell[iNew].
35960 20 20 29 20 29 20 67 6f 74 6f 20 65 64 69 74 70 ) ) goto editp
35970 61 67 65 5f 66 61 69 6c 3b 0a 20 20 20 20 6e 43 age_fail;. nC
35980 65 6c 6c 20 2b 3d 20 6e 41 64 64 3b 0a 20 20 7d ell += nAdd;. }
35990 0a 0a 20 20 2f 2a 20 41 64 64 20 61 6e 79 20 6f .. /* Add any o
359a0 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 2a 2f verflow cells */
359b0 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 50 . for(i=0; i<pP
359c0 67 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 20 69 2b g->nOverflow; i+
359d0 2b 29 7b 0a 20 20 20 20 69 6e 74 20 69 43 65 6c +){. int iCel
359e0 6c 20 3d 20 28 69 4f 6c 64 20 2b 20 70 50 67 2d l = (iOld + pPg-
359f0 3e 61 69 4f 76 66 6c 5b 69 5d 29 20 2d 20 69 4e >aiOvfl[i]) - iN
35a00 65 77 3b 0a 20 20 20 20 69 66 28 20 69 43 65 6c ew;. if( iCel
35a10 6c 3e 3d 30 20 26 26 20 69 43 65 6c 6c 3c 6e 4e l>=0 && iCell<nN
35a20 65 77 20 29 7b 0a 20 20 20 20 20 20 70 43 65 6c ew ){. pCel
35a30 6c 70 74 72 20 3d 20 26 70 50 67 2d 3e 61 43 65 lptr = &pPg->aCe
35a40 6c 6c 49 64 78 5b 69 43 65 6c 6c 20 2a 20 32 5d llIdx[iCell * 2]
35a50 3b 0a 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 28 ;. memmove(
35a60 26 70 43 65 6c 6c 70 74 72 5b 32 5d 2c 20 70 43 &pCellptr[2], pC
35a70 65 6c 6c 70 74 72 2c 20 28 6e 43 65 6c 6c 20 2d ellptr, (nCell -
35a80 20 69 43 65 6c 6c 29 20 2a 20 32 29 3b 0a 20 20 iCell) * 2);.
35a90 20 20 20 20 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 nCell++;.
35aa0 20 20 20 69 66 28 20 70 61 67 65 49 6e 73 65 72 if( pageInser
35ab0 74 41 72 72 61 79 28 0a 20 20 20 20 20 20 20 20 tArray(.
35ac0 20 20 20 20 70 50 67 2c 20 70 42 65 67 69 6e 2c pPg, pBegin,
35ad0 20 26 70 44 61 74 61 2c 20 70 43 65 6c 6c 70 74 &pData, pCellpt
35ae0 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 31 r,. 1
35af0 2c 20 26 61 70 43 65 6c 6c 5b 69 43 65 6c 6c 20 , &apCell[iCell
35b00 2b 20 69 4e 65 77 5d 2c 20 26 73 7a 43 65 6c 6c + iNew], &szCell
35b10 5b 69 43 65 6c 6c 20 2b 20 69 4e 65 77 5d 0a 20 [iCell + iNew].
35b20 20 20 20 20 20 29 20 29 20 67 6f 74 6f 20 65 64 ) ) goto ed
35b30 69 74 70 61 67 65 5f 66 61 69 6c 3b 0a 20 20 20 itpage_fail;.
35b40 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 70 70 }. }.. /* App
35b50 65 6e 64 20 63 65 6c 6c 73 20 74 6f 20 74 68 65 end cells to the
35b60 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 end of the page
35b70 20 2a 2f 0a 20 20 70 43 65 6c 6c 70 74 72 20 3d */. pCellptr =
35b80 20 26 70 50 67 2d 3e 61 43 65 6c 6c 49 64 78 5b &pPg->aCellIdx[
35b90 6e 43 65 6c 6c 2a 32 5d 3b 0a 20 20 69 66 28 20 nCell*2];. if(
35ba0 70 61 67 65 49 6e 73 65 72 74 41 72 72 61 79 28 pageInsertArray(
35bb0 0a 20 20 20 20 20 20 20 20 70 50 67 2c 20 70 42 . pPg, pB
35bc0 65 67 69 6e 2c 20 26 70 44 61 74 61 2c 20 70 43 egin, &pData, pC
35bd0 65 6c 6c 70 74 72 2c 0a 20 20 20 20 20 20 20 20 ellptr,.
35be0 6e 4e 65 77 2d 6e 43 65 6c 6c 2c 20 26 61 70 43 nNew-nCell, &apC
35bf0 65 6c 6c 5b 69 4e 65 77 2b 6e 43 65 6c 6c 5d 2c ell[iNew+nCell],
35c00 20 26 73 7a 43 65 6c 6c 5b 69 4e 65 77 2b 6e 43 &szCell[iNew+nC
35c10 65 6c 6c 5d 0a 20 20 29 20 29 20 67 6f 74 6f 20 ell]. ) ) goto
35c20 65 64 69 74 70 61 67 65 5f 66 61 69 6c 3b 0a 0a editpage_fail;..
35c30 20 20 70 50 67 2d 3e 6e 43 65 6c 6c 20 3d 20 6e pPg->nCell = n
35c40 4e 65 77 3b 0a 20 20 70 50 67 2d 3e 6e 4f 76 65 New;. pPg->nOve
35c50 72 66 6c 6f 77 20 3d 20 30 3b 0a 0a 20 20 70 75 rflow = 0;.. pu
35c60 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 68 64 t2byte(&aData[hd
35c70 72 2b 33 5d 2c 20 70 50 67 2d 3e 6e 43 65 6c 6c r+3], pPg->nCell
35c80 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 26 61 );. put2byte(&a
35c90 44 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 44 61 Data[hdr+5], pDa
35ca0 74 61 20 2d 20 61 44 61 74 61 29 3b 0a 0a 23 69 ta - aData);..#i
35cb0 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
35cc0 47 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e G. for(i=0; i<n
35cd0 4e 65 77 20 26 26 20 21 43 4f 52 52 55 50 54 5f New && !CORRUPT_
35ce0 44 42 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 DB; i++){. u8
35cf0 20 2a 70 43 65 6c 6c 20 3d 20 61 70 43 65 6c 6c *pCell = apCell
35d00 5b 69 2b 69 4e 65 77 5d 3b 0a 20 20 20 20 69 6e [i+iNew];. in
35d10 74 20 69 4f 66 66 20 3d 20 67 65 74 32 62 79 74 t iOff = get2byt
35d20 65 28 26 70 50 67 2d 3e 61 43 65 6c 6c 49 64 78 e(&pPg->aCellIdx
35d30 5b 69 2a 32 5d 29 3b 0a 20 20 20 20 69 66 28 20 [i*2]);. if(
35d40 70 43 65 6c 6c 3e 3d 61 44 61 74 61 20 26 26 20 pCell>=aData &&
35d50 70 43 65 6c 6c 3c 26 61 44 61 74 61 5b 70 50 67 pCell<&aData[pPg
35d60 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
35d70 65 5d 20 29 7b 0a 20 20 20 20 20 20 70 43 65 6c e] ){. pCel
35d80 6c 20 3d 20 26 70 54 6d 70 5b 70 43 65 6c 6c 20 l = &pTmp[pCell
35d90 2d 20 61 44 61 74 61 5d 3b 0a 20 20 20 20 7d 0a - aData];. }.
35da0 20 20 20 20 61 73 73 65 72 74 28 20 30 3d 3d 6d assert( 0==m
35db0 65 6d 63 6d 70 28 70 43 65 6c 6c 2c 20 26 61 44 emcmp(pCell, &aD
35dc0 61 74 61 5b 69 4f 66 66 5d 2c 20 73 7a 43 65 6c ata[iOff], szCel
35dd0 6c 5b 69 2b 69 4e 65 77 5d 29 20 29 3b 0a 20 20 l[i+iNew]) );.
35de0 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 }.#endif.. retu
35df0 72 6e 3b 0a 20 65 64 69 74 70 61 67 65 5f 66 61 rn;. editpage_fa
35e00 69 6c 3a 0a 20 20 2f 2a 20 55 6e 61 62 6c 65 20 il:. /* Unable
35e10 74 6f 20 65 64 69 74 20 74 68 69 73 20 70 61 67 to edit this pag
35e20 65 2e 20 52 65 62 75 69 6c 64 20 69 74 20 66 72 e. Rebuild it fr
35e30 6f 6d 20 73 63 72 61 74 63 68 20 69 6e 73 74 65 om scratch inste
35e40 61 64 2e 20 2a 2f 0a 20 20 72 65 62 75 69 6c 64 ad. */. rebuild
35e50 50 61 67 65 28 70 50 67 2c 20 6e 4e 65 77 2c 20 Page(pPg, nNew,
35e60 26 61 70 43 65 6c 6c 5b 69 4e 65 77 5d 2c 20 26 &apCell[iNew], &
35e70 73 7a 43 65 6c 6c 5b 69 4e 65 77 5d 29 3b 0a 7d szCell[iNew]);.}
35e80 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
35e90 6f 77 69 6e 67 20 70 61 72 61 6d 65 74 65 72 73 owing parameters
35ea0 20 64 65 74 65 72 6d 69 6e 65 20 68 6f 77 20 6d determine how m
35eb0 61 6e 79 20 61 64 6a 61 63 65 6e 74 20 70 61 67 any adjacent pag
35ec0 65 73 20 67 65 74 20 69 6e 76 6f 6c 76 65 64 0a es get involved.
35ed0 2a 2a 20 69 6e 20 61 20 62 61 6c 61 6e 63 69 6e ** in a balancin
35ee0 67 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 4e 4e g operation. NN
35ef0 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o
35f00 66 20 6e 65 69 67 68 62 6f 72 73 20 6f 6e 20 65 f neighbors on e
35f10 69 74 68 65 72 20 73 69 64 65 0a 2a 2a 20 6f 66 ither side.** of
35f20 20 74 68 65 20 70 61 67 65 20 74 68 61 74 20 70 the page that p
35f30 61 72 74 69 63 69 70 61 74 65 20 69 6e 20 74 68 articipate in th
35f40 65 20 62 61 6c 61 6e 63 69 6e 67 20 6f 70 65 72 e balancing oper
35f50 61 74 69 6f 6e 2e 20 20 4e 42 20 69 73 20 74 68 ation. NB is th
35f60 65 0a 2a 2a 20 74 6f 74 61 6c 20 6e 75 6d 62 65 e.** total numbe
35f70 72 20 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 r of pages that
35f80 70 61 72 74 69 63 69 70 61 74 65 2c 20 69 6e 63 participate, inc
35f90 6c 75 64 69 6e 67 20 74 68 65 20 74 61 72 67 65 luding the targe
35fa0 74 20 70 61 67 65 20 61 6e 64 0a 2a 2a 20 4e 4e t page and.** NN
35fb0 20 6e 65 69 67 68 62 6f 72 73 20 6f 6e 20 65 69 neighbors on ei
35fc0 74 68 65 72 20 73 69 64 65 2e 0a 2a 2a 0a 2a 2a ther side..**.**
35fd0 20 54 68 65 20 6d 69 6e 69 6d 75 6d 20 76 61 6c The minimum val
35fe0 75 65 20 6f 66 20 4e 4e 20 69 73 20 31 20 28 6f ue of NN is 1 (o
35ff0 66 20 63 6f 75 72 73 65 29 2e 20 20 49 6e 63 72 f course). Incr
36000 65 61 73 69 6e 67 20 4e 4e 20 61 62 6f 76 65 20 easing NN above
36010 31 0a 2a 2a 20 28 74 6f 20 32 20 6f 72 20 33 29 1.** (to 2 or 3)
36020 20 67 69 76 65 73 20 61 20 6d 6f 64 65 73 74 20 gives a modest
36030 69 6d 70 72 6f 76 65 6d 65 6e 74 20 69 6e 20 53 improvement in S
36040 45 4c 45 43 54 20 61 6e 64 20 44 45 4c 45 54 45 ELECT and DELETE
36050 20 70 65 72 66 6f 72 6d 61 6e 63 65 0a 2a 2a 20 performance.**
36060 69 6e 20 65 78 63 68 61 6e 67 65 20 66 6f 72 20 in exchange for
36070 61 20 6c 61 72 67 65 72 20 64 65 67 72 61 64 61 a larger degrada
36080 74 69 6f 6e 20 69 6e 20 49 4e 53 45 52 54 20 61 tion in INSERT a
36090 6e 64 20 55 50 44 41 54 45 20 70 65 72 66 6f 72 nd UPDATE perfor
360a0 6d 61 6e 63 65 2e 0a 2a 2a 20 54 68 65 20 76 61 mance..** The va
360b0 6c 75 65 20 6f 66 20 4e 4e 20 61 70 70 65 61 72 lue of NN appear
360c0 73 20 74 6f 20 67 69 76 65 20 74 68 65 20 62 65 s to give the be
360d0 73 74 20 72 65 73 75 6c 74 73 20 6f 76 65 72 61 st results overa
360e0 6c 6c 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4e ll..*/.#define N
360f0 4e 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 N 1
36100 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 65 69 /* Number of nei
36110 67 68 62 6f 72 73 20 6f 6e 20 65 69 74 68 65 72 ghbors on either
36120 20 73 69 64 65 20 6f 66 20 70 50 61 67 65 20 2a side of pPage *
36130 2f 0a 23 64 65 66 69 6e 65 20 4e 42 20 28 4e 4e /.#define NB (NN
36140 2a 32 2b 31 29 20 20 20 20 20 20 2f 2a 20 54 6f *2+1) /* To
36150 74 61 6c 20 70 61 67 65 73 20 69 6e 76 6f 6c 76 tal pages involv
36160 65 64 20 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 ed in the balanc
36170 65 20 2a 2f 0a 0a 0a 23 69 66 6e 64 65 66 20 53 e */...#ifndef S
36180 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55 49 43 4b QLITE_OMIT_QUICK
36190 42 41 4c 41 4e 43 45 0a 2f 2a 0a 2a 2a 20 54 68 BALANCE./*.** Th
361a0 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 62 61 is version of ba
361b0 6c 61 6e 63 65 28 29 20 68 61 6e 64 6c 65 73 20 lance() handles
361c0 74 68 65 20 63 6f 6d 6d 6f 6e 20 73 70 65 63 69 the common speci
361d0 61 6c 20 63 61 73 65 20 77 68 65 72 65 0a 2a 2a al case where.**
361e0 20 61 20 6e 65 77 20 65 6e 74 72 79 20 69 73 20 a new entry is
361f0 62 65 69 6e 67 20 69 6e 73 65 72 74 65 64 20 6f being inserted o
36200 6e 20 74 68 65 20 65 78 74 72 65 6d 65 20 72 69 n the extreme ri
36210 67 68 74 2d 65 6e 64 20 6f 66 20 74 68 65 0a 2a ght-end of the.*
36220 2a 20 74 72 65 65 2c 20 69 6e 20 6f 74 68 65 72 * tree, in other
36230 20 77 6f 72 64 73 2c 20 77 68 65 6e 20 74 68 65 words, when the
36240 20 6e 65 77 20 65 6e 74 72 79 20 77 69 6c 6c 20 new entry will
36250 62 65 63 6f 6d 65 20 74 68 65 20 6c 61 72 67 65 become the large
36260 73 74 0a 2a 2a 20 65 6e 74 72 79 20 69 6e 20 74 st.** entry in t
36270 68 65 20 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 49 he tree..**.** I
36280 6e 73 74 65 61 64 20 6f 66 20 74 72 79 69 6e 67 nstead of trying
36290 20 74 6f 20 62 61 6c 61 6e 63 65 20 74 68 65 20 to balance the
362a0 33 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 61 3 right-most lea
362b0 66 20 70 61 67 65 73 2c 20 6a 75 73 74 20 61 64 f pages, just ad
362c0 64 0a 2a 2a 20 61 20 6e 65 77 20 70 61 67 65 20 d.** a new page
362d0 74 6f 20 74 68 65 20 72 69 67 68 74 2d 68 61 6e to the right-han
362e0 64 20 73 69 64 65 20 61 6e 64 20 70 75 74 20 74 d side and put t
362f0 68 65 20 6f 6e 65 20 6e 65 77 20 65 6e 74 72 79 he one new entry
36300 20 69 6e 0a 2a 2a 20 74 68 61 74 20 70 61 67 65 in.** that page
36310 2e 20 20 54 68 69 73 20 6c 65 61 76 65 73 20 74 . This leaves t
36320 68 65 20 72 69 67 68 74 20 73 69 64 65 20 6f 66 he right side of
36330 20 74 68 65 20 74 72 65 65 20 73 6f 6d 65 77 68 the tree somewh
36340 61 74 0a 2a 2a 20 75 6e 62 61 6c 61 6e 63 65 64 at.** unbalanced
36350 2e 20 20 42 75 74 20 6f 64 64 73 20 61 72 65 20 . But odds are
36360 74 68 61 74 20 77 65 20 77 69 6c 6c 20 62 65 20 that we will be
36370 69 6e 73 65 72 74 69 6e 67 20 6e 65 77 20 65 6e inserting new en
36380 74 72 69 65 73 0a 2a 2a 20 61 74 20 74 68 65 20 tries.** at the
36390 65 6e 64 20 73 6f 6f 6e 20 61 66 74 65 72 77 61 end soon afterwa
363a0 72 64 73 20 73 6f 20 74 68 65 20 6e 65 61 72 6c rds so the nearl
363b0 79 20 65 6d 70 74 79 20 70 61 67 65 20 77 69 6c y empty page wil
363c0 6c 20 71 75 69 63 6b 6c 79 0a 2a 2a 20 66 69 6c l quickly.** fil
363d0 6c 20 75 70 2e 20 20 4f 6e 20 61 76 65 72 61 67 l up. On averag
363e0 65 2e 0a 2a 2a 0a 2a 2a 20 70 50 61 67 65 20 69 e..**.** pPage i
363f0 73 20 74 68 65 20 6c 65 61 66 20 70 61 67 65 20 s the leaf page
36400 77 68 69 63 68 20 69 73 20 74 68 65 20 72 69 67 which is the rig
36410 68 74 2d 6d 6f 73 74 20 70 61 67 65 20 69 6e 20 ht-most page in
36420 74 68 65 20 74 72 65 65 2e 0a 2a 2a 20 70 50 61 the tree..** pPa
36430 72 65 6e 74 20 69 73 20 69 74 73 20 70 61 72 65 rent is its pare
36440 6e 74 2e 20 20 70 50 61 67 65 20 6d 75 73 74 20 nt. pPage must
36450 68 61 76 65 20 61 20 73 69 6e 67 6c 65 20 6f 76 have a single ov
36460 65 72 66 6c 6f 77 20 65 6e 74 72 79 0a 2a 2a 20 erflow entry.**
36470 77 68 69 63 68 20 69 73 20 61 6c 73 6f 20 74 68 which is also th
36480 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e 74 e right-most ent
36490 72 79 20 6f 6e 20 74 68 65 20 70 61 67 65 2e 0a ry on the page..
364a0 2a 2a 0a 2a 2a 20 54 68 65 20 70 53 70 61 63 65 **.** The pSpace
364b0 20 62 75 66 66 65 72 20 69 73 20 75 73 65 64 20 buffer is used
364c0 74 6f 20 73 74 6f 72 65 20 61 20 74 65 6d 70 6f to store a tempo
364d0 72 61 72 79 20 63 6f 70 79 20 6f 66 20 74 68 65 rary copy of the
364e0 20 64 69 76 69 64 65 72 0a 2a 2a 20 63 65 6c 6c divider.** cell
364f0 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 69 6e that will be in
36500 73 65 72 74 65 64 20 69 6e 74 6f 20 70 50 61 72 serted into pPar
36510 65 6e 74 2e 20 53 75 63 68 20 61 20 63 65 6c 6c ent. Such a cell
36520 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 34 consists of a 4
36530 0a 2a 2a 20 62 79 74 65 20 70 61 67 65 20 6e 75 .** byte page nu
36540 6d 62 65 72 20 66 6f 6c 6c 6f 77 65 64 20 62 79 mber followed by
36550 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 a variable leng
36560 74 68 20 69 6e 74 65 67 65 72 2e 20 49 6e 20 6f th integer. In o
36570 74 68 65 72 0a 2a 2a 20 77 6f 72 64 73 2c 20 61 ther.** words, a
36580 74 20 6d 6f 73 74 20 31 33 20 62 79 74 65 73 2e t most 13 bytes.
36590 20 48 65 6e 63 65 20 74 68 65 20 70 53 70 61 63 Hence the pSpac
365a0 65 20 62 75 66 66 65 72 20 6d 75 73 74 20 62 65 e buffer must be
365b0 20 61 74 0a 2a 2a 20 6c 65 61 73 74 20 31 33 20 at.** least 13
365c0 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a bytes in size..*
365d0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 61 6c /.static int bal
365e0 61 6e 63 65 5f 71 75 69 63 6b 28 4d 65 6d 50 61 ance_quick(MemPa
365f0 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 4d 65 6d ge *pParent, Mem
36600 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 20 Page *pPage, u8
36610 2a 70 53 70 61 63 65 29 7b 0a 20 20 42 74 53 68 *pSpace){. BtSh
36620 61 72 65 64 20 2a 63 6f 6e 73 74 20 70 42 74 20 ared *const pBt
36630 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 20 20 20 = pPage->pBt;
36640 20 2f 2a 20 42 2d 54 72 65 65 20 44 61 74 61 62 /* B-Tree Datab
36650 61 73 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 ase */. MemPage
36660 20 2a 70 4e 65 77 3b 20 20 20 20 20 20 20 20 20 *pNew;
36670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
36680 20 4e 65 77 6c 79 20 61 6c 6c 6f 63 61 74 65 64 Newly allocated
36690 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 72 page */. int r
366a0 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
366b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
366c0 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20 2a /* Return Code *
366d0 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4e 65 77 /. Pgno pgnoNew
366e0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
366f0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
36700 20 6e 75 6d 62 65 72 20 6f 66 20 70 4e 65 77 20 number of pNew
36710 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 */.. assert( sq
36720 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
36730 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
36740 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
36750 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
36760 72 69 74 65 61 62 6c 65 28 70 50 61 72 65 6e 74 riteable(pParent
36770 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
36780 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e assert( pPage->n
36790 4f 76 65 72 66 6c 6f 77 3d 3d 31 20 29 3b 0a 0a Overflow==1 );..
367a0 20 20 2f 2a 20 54 68 69 73 20 65 72 72 6f 72 20 /* This error
367b0 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 6e 6f 77 condition is now
367c0 20 63 61 75 67 68 74 20 70 72 69 6f 72 20 74 6f caught prior to
367d0 20 72 65 61 63 68 69 6e 67 20 74 68 69 73 20 66 reaching this f
367e0 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 66 28 unction */. if(
367f0 20 4e 45 56 45 52 28 70 50 61 67 65 2d 3e 6e 43 NEVER(pPage->nC
36800 65 6c 6c 3d 3d 30 29 20 29 20 72 65 74 75 72 6e ell==0) ) return
36810 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
36820 42 4b 50 54 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f BKPT;.. /* Allo
36830 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e cate a new page.
36840 20 54 68 69 73 20 70 61 67 65 20 77 69 6c 6c 20 This page will
36850 62 65 63 6f 6d 65 20 74 68 65 20 72 69 67 68 74 become the right
36860 2d 73 69 62 6c 69 6e 67 20 6f 66 20 0a 20 20 2a -sibling of . *
36870 2a 20 70 50 61 67 65 2e 20 4d 61 6b 65 20 74 68 * pPage. Make th
36880 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 77 72 e parent page wr
36890 69 74 61 62 6c 65 2c 20 73 6f 20 74 68 61 74 20 itable, so that
368a0 74 68 65 20 6e 65 77 20 64 69 76 69 64 65 72 20 the new divider
368b0 63 65 6c 6c 0a 20 20 2a 2a 20 6d 61 79 20 62 65 cell. ** may be
368c0 20 69 6e 73 65 72 74 65 64 2e 20 49 66 20 62 6f inserted. If bo
368d0 74 68 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 th these operati
368e0 6f 6e 73 20 61 72 65 20 73 75 63 63 65 73 73 66 ons are successf
368f0 75 6c 2c 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a ul, proceed.. *
36900 2f 0a 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 /. rc = allocat
36910 65 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 eBtreePage(pBt,
36920 26 70 4e 65 77 2c 20 26 70 67 6e 6f 4e 65 77 2c &pNew, &pgnoNew,
36930 20 30 2c 20 30 29 3b 0a 0a 20 20 69 66 28 20 72 0, 0);.. if( r
36940 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
36950 0a 20 20 20 20 75 38 20 2a 70 4f 75 74 20 3d 20 . u8 *pOut =
36960 26 70 53 70 61 63 65 5b 34 5d 3b 0a 20 20 20 20 &pSpace[4];.
36970 75 38 20 2a 70 43 65 6c 6c 20 3d 20 70 50 61 67 u8 *pCell = pPag
36980 65 2d 3e 61 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 e->apOvfl[0];.
36990 20 20 75 31 36 20 73 7a 43 65 6c 6c 20 3d 20 63 u16 szCell = c
369a0 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 67 65 ellSizePtr(pPage
369b0 2c 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 75 38 , pCell);. u8
369c0 20 2a 70 53 74 6f 70 3b 0a 0a 20 20 20 20 61 73 *pStop;.. as
369d0 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
369e0 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 4e erIswriteable(pN
369f0 65 77 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ew->pDbPage) );.
36a00 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
36a10 65 2d 3e 61 44 61 74 61 5b 30 5d 3d 3d 28 50 54 e->aData[0]==(PT
36a20 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 F_INTKEY|PTF_LEA
36a30 46 44 41 54 41 7c 50 54 46 5f 4c 45 41 46 29 20 FDATA|PTF_LEAF)
36a40 29 3b 0a 20 20 20 20 7a 65 72 6f 50 61 67 65 28 );. zeroPage(
36a50 70 4e 65 77 2c 20 50 54 46 5f 49 4e 54 4b 45 59 pNew, PTF_INTKEY
36a60 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 |PTF_LEAFDATA|PT
36a70 46 5f 4c 45 41 46 29 3b 0a 20 20 20 20 72 65 62 F_LEAF);. reb
36a80 75 69 6c 64 50 61 67 65 28 70 4e 65 77 2c 20 31 uildPage(pNew, 1
36a90 2c 20 26 70 43 65 6c 6c 2c 20 26 73 7a 43 65 6c , &pCell, &szCel
36aa0 6c 29 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e 46 l);. pNew->nF
36ab0 72 65 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c ree = pBt->usabl
36ac0 65 53 69 7a 65 20 2d 20 70 4e 65 77 2d 3e 63 65 eSize - pNew->ce
36ad0 6c 6c 4f 66 66 73 65 74 20 2d 20 32 20 2d 20 73 llOffset - 2 - s
36ae0 7a 43 65 6c 6c 3b 0a 0a 20 20 20 20 2f 2a 20 49 zCell;.. /* I
36af0 66 20 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 f this is an aut
36b00 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 o-vacuum databas
36b10 65 2c 20 75 70 64 61 74 65 20 74 68 65 20 70 6f e, update the po
36b20 69 6e 74 65 72 20 6d 61 70 0a 20 20 20 20 2a 2a inter map. **
36b30 20 77 69 74 68 20 65 6e 74 72 69 65 73 20 66 6f with entries fo
36b40 72 20 74 68 65 20 6e 65 77 20 70 61 67 65 2c 20 r the new page,
36b50 61 6e 64 20 61 6e 79 20 70 6f 69 6e 74 65 72 20 and any pointer
36b60 66 72 6f 6d 20 74 68 65 20 0a 20 20 20 20 2a 2a from the . **
36b70 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 70 61 67 cell on the pag
36b80 65 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 e to an overflow
36b90 20 70 61 67 65 2e 20 49 66 20 65 69 74 68 65 72 page. If either
36ba0 20 6f 66 20 74 68 65 73 65 0a 20 20 20 20 2a 2a of these. **
36bb0 20 6f 70 65 72 61 74 69 6f 6e 73 20 66 61 69 6c operations fail
36bc0 73 2c 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f s, the return co
36bd0 64 65 20 69 73 20 73 65 74 2c 20 62 75 74 20 74 de is set, but t
36be0 68 65 20 63 6f 6e 74 65 6e 74 73 0a 20 20 20 20 he contents.
36bf0 2a 2a 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 ** of the parent
36c00 20 70 61 67 65 20 61 72 65 20 73 74 69 6c 6c 20 page are still
36c10 6d 61 6e 69 70 75 6c 61 74 65 64 20 62 79 20 74 manipulated by t
36c20 68 68 20 63 6f 64 65 20 62 65 6c 6f 77 2e 0a 20 hh code below..
36c30 20 20 20 2a 2a 20 54 68 61 74 20 69 73 20 4f 6b ** That is Ok
36c40 2c 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 , at this point
36c50 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 the parent page
36c60 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f is guaranteed to
36c70 0a 20 20 20 20 2a 2a 20 62 65 20 6d 61 72 6b 65 . ** be marke
36c80 64 20 61 73 20 64 69 72 74 79 2e 20 52 65 74 75 d as dirty. Retu
36c90 72 6e 69 6e 67 20 61 6e 20 65 72 72 6f 72 20 63 rning an error c
36ca0 6f 64 65 20 77 69 6c 6c 20 63 61 75 73 65 20 61 ode will cause a
36cb0 0a 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b . ** rollback
36cc0 2c 20 75 6e 64 6f 69 6e 67 20 61 6e 79 20 63 68 , undoing any ch
36cd0 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20 74 68 anges made to th
36ce0 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 0a 20 e parent page..
36cf0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 */. if( IS
36d00 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 AUTOVACUUM ){.
36d10 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 ptrmapPut(pB
36d20 74 2c 20 70 67 6e 6f 4e 65 77 2c 20 50 54 52 4d t, pgnoNew, PTRM
36d30 41 50 5f 42 54 52 45 45 2c 20 70 50 61 72 65 6e AP_BTREE, pParen
36d40 74 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 t->pgno, &rc);.
36d50 20 20 20 20 20 69 66 28 20 73 7a 43 65 6c 6c 3e if( szCell>
36d60 70 4e 65 77 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 29 pNew->minLocal )
36d70 7b 0a 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 {. ptrmap
36d80 50 75 74 4f 76 66 6c 50 74 72 28 70 4e 65 77 2c PutOvflPtr(pNew,
36d90 20 70 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 20 20 pCell, &rc);.
36da0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 }. }. .
36db0 20 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 64 /* Create a d
36dc0 69 76 69 64 65 72 20 63 65 6c 6c 20 74 6f 20 69 ivider cell to i
36dd0 6e 73 65 72 74 20 69 6e 74 6f 20 70 50 61 72 65 nsert into pPare
36de0 6e 74 2e 20 54 68 65 20 64 69 76 69 64 65 72 20 nt. The divider
36df0 63 65 6c 6c 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 cell. ** cons
36e00 69 73 74 73 20 6f 66 20 61 20 34 2d 62 79 74 65 ists of a 4-byte
36e10 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 74 68 page number (th
36e20 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
36e30 20 70 50 61 67 65 29 20 61 6e 64 0a 20 20 20 20 pPage) and.
36e40 2a 2a 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 ** a variable le
36e50 6e 67 74 68 20 6b 65 79 20 76 61 6c 75 65 20 28 ngth key value (
36e60 77 68 69 63 68 20 6d 75 73 74 20 62 65 20 74 68 which must be th
36e70 65 20 73 61 6d 65 20 76 61 6c 75 65 20 61 73 20 e same value as
36e80 74 68 65 0a 20 20 20 20 2a 2a 20 6c 61 72 67 65 the. ** large
36e90 73 74 20 6b 65 79 20 6f 6e 20 70 50 61 67 65 29 st key on pPage)
36ea0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
36eb0 54 6f 20 66 69 6e 64 20 74 68 65 20 6c 61 72 67 To find the larg
36ec0 65 73 74 20 6b 65 79 20 76 61 6c 75 65 20 6f 6e est key value on
36ed0 20 70 50 61 67 65 2c 20 66 69 72 73 74 20 66 69 pPage, first fi
36ee0 6e 64 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 nd the right-mos
36ef0 74 20 0a 20 20 20 20 2a 2a 20 63 65 6c 6c 20 6f t . ** cell o
36f00 6e 20 70 50 61 67 65 2e 20 54 68 65 20 66 69 72 n pPage. The fir
36f10 73 74 20 74 77 6f 20 66 69 65 6c 64 73 20 6f 66 st two fields of
36f20 20 74 68 69 73 20 63 65 6c 6c 20 61 72 65 20 74 this cell are t
36f30 68 65 20 0a 20 20 20 20 2a 2a 20 72 65 63 6f 72 he . ** recor
36f40 64 2d 6c 65 6e 67 74 68 20 28 61 20 76 61 72 69 d-length (a vari
36f50 61 62 6c 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 able length inte
36f60 67 65 72 20 61 74 20 6d 6f 73 74 20 33 32 2d 62 ger at most 32-b
36f70 69 74 73 20 69 6e 20 73 69 7a 65 29 0a 20 20 20 its in size).
36f80 20 2a 2a 20 61 6e 64 20 74 68 65 20 6b 65 79 20 ** and the key
36f90 76 61 6c 75 65 20 28 61 20 76 61 72 69 61 62 6c value (a variabl
36fa0 65 20 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 e length integer
36fb0 2c 20 6d 61 79 20 68 61 76 65 20 61 6e 79 20 76 , may have any v
36fc0 61 6c 75 65 29 2e 0a 20 20 20 20 2a 2a 20 54 68 alue).. ** Th
36fd0 65 20 66 69 72 73 74 20 6f 66 20 74 68 65 20 77 e first of the w
36fe0 68 69 6c 65 28 2e 2e 2e 29 20 6c 6f 6f 70 73 20 hile(...) loops
36ff0 62 65 6c 6f 77 20 73 6b 69 70 73 20 6f 76 65 72 below skips over
37000 20 74 68 65 20 72 65 63 6f 72 64 2d 6c 65 6e 67 the record-leng
37010 74 68 0a 20 20 20 20 2a 2a 20 66 69 65 6c 64 2e th. ** field.
37020 20 54 68 65 20 73 65 63 6f 6e 64 20 77 68 69 6c The second whil
37030 65 28 2e 2e 2e 29 20 6c 6f 6f 70 20 63 6f 70 69 e(...) loop copi
37040 65 73 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 es the key value
37050 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 2a 2a from the. **
37060 20 63 65 6c 6c 20 6f 6e 20 70 50 61 67 65 20 69 cell on pPage i
37070 6e 74 6f 20 74 68 65 20 70 53 70 61 63 65 20 62 nto the pSpace b
37080 75 66 66 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 uffer.. */.
37090 20 20 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 pCell = findCe
370a0 6c 6c 28 70 50 61 67 65 2c 20 70 50 61 67 65 2d ll(pPage, pPage-
370b0 3e 6e 43 65 6c 6c 2d 31 29 3b 0a 20 20 20 20 70 >nCell-1);. p
370c0 53 74 6f 70 20 3d 20 26 70 43 65 6c 6c 5b 39 5d Stop = &pCell[9]
370d0 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 2a 28 ;. while( (*(
370e0 70 43 65 6c 6c 2b 2b 29 26 30 78 38 30 29 20 26 pCell++)&0x80) &
370f0 26 20 70 43 65 6c 6c 3c 70 53 74 6f 70 20 29 3b & pCell<pStop );
37100 0a 20 20 20 20 70 53 74 6f 70 20 3d 20 26 70 43 . pStop = &pC
37110 65 6c 6c 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c ell[9];. whil
37120 65 28 20 28 28 2a 28 70 4f 75 74 2b 2b 29 20 3d e( ((*(pOut++) =
37130 20 2a 28 70 43 65 6c 6c 2b 2b 29 29 26 30 78 38 *(pCell++))&0x8
37140 30 29 20 26 26 20 70 43 65 6c 6c 3c 70 53 74 6f 0) && pCell<pSto
37150 70 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 6e 73 p );.. /* Ins
37160 65 72 74 20 74 68 65 20 6e 65 77 20 64 69 76 69 ert the new divi
37170 64 65 72 20 63 65 6c 6c 20 69 6e 74 6f 20 70 50 der cell into pP
37180 61 72 65 6e 74 2e 20 2a 2f 0a 20 20 20 20 69 6e arent. */. in
37190 73 65 72 74 43 65 6c 6c 28 70 50 61 72 65 6e 74 sertCell(pParent
371a0 2c 20 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c , pParent->nCell
371b0 2c 20 70 53 70 61 63 65 2c 20 28 69 6e 74 29 28 , pSpace, (int)(
371c0 70 4f 75 74 2d 70 53 70 61 63 65 29 2c 0a 20 20 pOut-pSpace),.
371d0 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 0,
371e0 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 26 72 63 pPage->pgno, &rc
371f0 29 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 );.. /* Set t
37200 68 65 20 72 69 67 68 74 2d 63 68 69 6c 64 20 70 he right-child p
37210 6f 69 6e 74 65 72 20 6f 66 20 70 50 61 72 65 6e ointer of pParen
37220 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 t to point to th
37230 65 20 6e 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 e new page. */.
37240 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
37250 72 65 6e 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 rent->aData[pPar
37260 65 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 ent->hdrOffset+8
37270 5d 2c 20 70 67 6e 6f 4e 65 77 29 3b 0a 20 20 0a ], pgnoNew);. .
37280 20 20 20 20 2f 2a 20 52 65 6c 65 61 73 65 20 74 /* Release t
37290 68 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 he reference to
372a0 74 68 65 20 6e 65 77 20 70 61 67 65 2e 20 2a 2f the new page. */
372b0 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 . releasePage
372c0 28 70 4e 65 77 29 3b 0a 20 20 7d 0a 0a 20 20 72 (pNew);. }.. r
372d0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 eturn rc;.}.#end
372e0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
372f0 54 5f 51 55 49 43 4b 42 41 4c 41 4e 43 45 20 2a T_QUICKBALANCE *
37300 2f 0a 0a 23 69 66 20 30 0a 2f 2a 0a 2a 2a 20 54 /..#if 0./*.** T
37310 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 his function doe
37320 73 20 6e 6f 74 20 63 6f 6e 74 72 69 62 75 74 65 s not contribute
37330 20 61 6e 79 74 68 69 6e 67 20 74 6f 20 74 68 65 anything to the
37340 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 53 51 operation of SQ
37350 4c 69 74 65 2e 0a 2a 2a 20 69 74 20 69 73 20 73 Lite..** it is s
37360 6f 6d 65 74 69 6d 65 73 20 61 63 74 69 76 61 74 ometimes activat
37370 65 64 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 77 ed temporarily w
37380 68 69 6c 65 20 64 65 62 75 67 67 69 6e 67 20 63 hile debugging c
37390 6f 64 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 ode responsible
373a0 0a 2a 2a 20 66 6f 72 20 73 65 74 74 69 6e 67 20 .** for setting
373b0 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 pointer-map entr
373c0 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ies..*/.static i
373d0 6e 74 20 70 74 72 6d 61 70 43 68 65 63 6b 50 61 nt ptrmapCheckPa
373e0 67 65 73 28 4d 65 6d 50 61 67 65 20 2a 2a 61 70 ges(MemPage **ap
373f0 50 61 67 65 2c 20 69 6e 74 20 6e 50 61 67 65 29 Page, int nPage)
37400 7b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 {. int i, j;.
37410 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 50 61 67 65 for(i=0; i<nPage
37420 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 50 67 6e 6f ; i++){. Pgno
37430 20 6e 3b 0a 20 20 20 20 75 38 20 65 3b 0a 20 20 n;. u8 e;.
37440 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
37450 20 3d 20 61 70 50 61 67 65 5b 69 5d 3b 0a 20 20 = apPage[i];.
37460 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
37470 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
37480 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
37490 3e 69 73 49 6e 69 74 20 29 3b 0a 0a 20 20 20 20 >isInit );..
374a0 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 50 61 67 65 for(j=0; j<pPage
374b0 2d 3e 6e 43 65 6c 6c 3b 20 6a 2b 2b 29 7b 0a 20 ->nCell; j++){.
374c0 20 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e CellInfo in
374d0 66 6f 3b 0a 20 20 20 20 20 20 75 38 20 2a 7a 3b fo;. u8 *z;
374e0 0a 20 20 20 20 20 0a 20 20 20 20 20 20 7a 20 3d . . z =
374f0 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c findCell(pPage,
37500 20 6a 29 3b 0a 20 20 20 20 20 20 62 74 72 65 65 j);. btree
37510 50 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 ParseCellPtr(pPa
37520 67 65 2c 20 7a 2c 20 26 69 6e 66 6f 29 3b 0a 20 ge, z, &info);.
37530 20 20 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f if( info.iO
37540 76 65 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 verflow ){.
37550 20 20 20 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 Pgno ovfl = g
37560 65 74 34 62 79 74 65 28 26 7a 5b 69 6e 66 6f 2e et4byte(&z[info.
37570 69 4f 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 20 iOverflow]);.
37580 20 20 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 ptrmapGet(p
37590 42 74 2c 20 6f 76 66 6c 2c 20 26 65 2c 20 26 6e Bt, ovfl, &e, &n
375a0 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
375b0 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e t( n==pPage->pgn
375c0 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 4f o && e==PTRMAP_O
375d0 56 45 52 46 4c 4f 57 31 20 29 3b 0a 20 20 20 20 VERFLOW1 );.
375e0 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 }. if( !p
375f0 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
37600 20 20 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 Pgno child
37610 20 3d 20 67 65 74 34 62 79 74 65 28 7a 29 3b 0a = get4byte(z);.
37620 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 ptrmapGe
37630 74 28 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 t(pBt, child, &e
37640 2c 20 26 6e 29 3b 0a 20 20 20 20 20 20 20 20 61 , &n);. a
37650 73 73 65 72 74 28 20 6e 3d 3d 70 50 61 67 65 2d ssert( n==pPage-
37660 3e 70 67 6e 6f 20 26 26 20 65 3d 3d 50 54 52 4d >pgno && e==PTRM
37670 41 50 5f 42 54 52 45 45 20 29 3b 0a 20 20 20 20 AP_BTREE );.
37680 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
37690 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 ( !pPage->leaf )
376a0 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 63 68 69 {. Pgno chi
376b0 6c 64 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 ld = get4byte(&p
376c0 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
376d0 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
376e0 3b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 47 65 ;. ptrmapGe
376f0 74 28 70 42 74 2c 20 63 68 69 6c 64 2c 20 26 65 t(pBt, child, &e
37700 2c 20 26 6e 29 3b 0a 20 20 20 20 20 20 61 73 73 , &n);. ass
37710 65 72 74 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 ert( n==pPage->p
37720 67 6e 6f 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 gno && e==PTRMAP
37730 5f 42 54 52 45 45 20 29 3b 0a 20 20 20 20 7d 0a _BTREE );. }.
37740 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a }. return 1;.
37750 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
37760 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
37770 20 75 73 65 64 20 74 6f 20 63 6f 70 79 20 74 68 used to copy th
37780 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
37790 65 20 62 2d 74 72 65 65 20 6e 6f 64 65 20 73 74 e b-tree node st
377a0 6f 72 65 64 20 0a 2a 2a 20 6f 6e 20 70 61 67 65 ored .** on page
377b0 20 70 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 70 pFrom to page p
377c0 54 6f 2e 20 49 66 20 70 61 67 65 20 70 46 72 6f To. If page pFro
377d0 6d 20 77 61 73 20 6e 6f 74 20 61 20 6c 65 61 66 m was not a leaf
377e0 20 70 61 67 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 page, then.** t
377f0 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 he pointer-map e
37800 6e 74 72 69 65 73 20 66 6f 72 20 65 61 63 68 20 ntries for each
37810 63 68 69 6c 64 20 70 61 67 65 20 61 72 65 20 75 child page are u
37820 70 64 61 74 65 64 20 73 6f 20 74 68 61 74 20 74 pdated so that t
37830 68 65 0a 2a 2a 20 70 61 72 65 6e 74 20 70 61 67 he.** parent pag
37840 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e stored in the
37850 70 6f 69 6e 74 65 72 20 6d 61 70 20 69 73 20 70 pointer map is p
37860 61 67 65 20 70 54 6f 2e 20 49 66 20 70 46 72 6f age pTo. If pFro
37870 6d 20 63 6f 6e 74 61 69 6e 65 64 0a 2a 2a 20 61 m contained.** a
37880 6e 79 20 63 65 6c 6c 73 20 77 69 74 68 20 6f 76 ny cells with ov
37890 65 72 66 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e erflow page poin
378a0 74 65 72 73 2c 20 74 68 65 6e 20 74 68 65 20 63 ters, then the c
378b0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 70 6f 69 orresponding poi
378c0 6e 74 65 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 nter.** map entr
378d0 69 65 73 20 61 72 65 20 61 6c 73 6f 20 75 70 64 ies are also upd
378e0 61 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 ated so that the
378f0 20 70 61 72 65 6e 74 20 70 61 67 65 20 69 73 20 parent page is
37900 70 61 67 65 20 70 54 6f 2e 0a 2a 2a 0a 2a 2a 20 page pTo..**.**
37910 49 66 20 70 46 72 6f 6d 20 69 73 20 63 75 72 72 If pFrom is curr
37920 65 6e 74 6c 79 20 63 61 72 72 79 69 6e 67 20 61 ently carrying a
37930 6e 79 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c ny overflow cell
37940 73 20 28 65 6e 74 72 69 65 73 20 69 6e 20 74 68 s (entries in th
37950 65 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 70 4f e.** MemPage.apO
37960 76 66 6c 5b 5d 20 61 72 72 61 79 29 2c 20 74 68 vfl[] array), th
37970 65 79 20 61 72 65 20 6e 6f 74 20 63 6f 70 69 65 ey are not copie
37980 64 20 74 6f 20 70 54 6f 2e 20 0a 2a 2a 0a 2a 2a d to pTo. .**.**
37990 20 42 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e Before returnin
379a0 67 2c 20 70 61 67 65 20 70 54 6f 20 69 73 20 72 g, page pTo is r
379b0 65 69 6e 69 74 69 61 6c 69 7a 65 64 20 75 73 69 einitialized usi
379c0 6e 67 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 ng btreeInitPage
379d0 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 65 ()..**.** The pe
379e0 72 66 6f 72 6d 61 6e 63 65 20 6f 66 20 74 68 69 rformance of thi
379f0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f s function is no
37a00 74 20 63 72 69 74 69 63 61 6c 2e 20 49 74 20 69 t critical. It i
37a10 73 20 6f 6e 6c 79 20 75 73 65 64 20 62 79 20 0a s only used by .
37a20 2a 2a 20 74 68 65 20 62 61 6c 61 6e 63 65 5f 73 ** the balance_s
37a30 68 61 6c 6c 6f 77 65 72 28 29 20 61 6e 64 20 62 hallower() and b
37a40 61 6c 61 6e 63 65 5f 64 65 65 70 65 72 28 29 20 alance_deeper()
37a50 70 72 6f 63 65 64 75 72 65 73 2c 20 6e 65 69 74 procedures, neit
37a60 68 65 72 20 6f 66 0a 2a 2a 20 77 68 69 63 68 20 her of.** which
37a70 61 72 65 20 63 61 6c 6c 65 64 20 6f 66 74 65 6e are called often
37a80 20 75 6e 64 65 72 20 6e 6f 72 6d 61 6c 20 63 69 under normal ci
37a90 72 63 75 6d 73 74 61 6e 63 65 73 2e 0a 2a 2f 0a rcumstances..*/.
37aa0 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 70 79 static void copy
37ab0 4e 6f 64 65 43 6f 6e 74 65 6e 74 28 4d 65 6d 50 NodeContent(MemP
37ac0 61 67 65 20 2a 70 46 72 6f 6d 2c 20 4d 65 6d 50 age *pFrom, MemP
37ad0 61 67 65 20 2a 70 54 6f 2c 20 69 6e 74 20 2a 70 age *pTo, int *p
37ae0 52 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 RC){. if( (*pRC
37af0 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a )==SQLITE_OK ){.
37b00 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 20 63 BtShared * c
37b10 6f 6e 73 74 20 70 42 74 20 3d 20 70 46 72 6f 6d onst pBt = pFrom
37b20 2d 3e 70 42 74 3b 0a 20 20 20 20 75 38 20 2a 20 ->pBt;. u8 *
37b30 63 6f 6e 73 74 20 61 46 72 6f 6d 20 3d 20 70 46 const aFrom = pF
37b40 72 6f 6d 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 rom->aData;.
37b50 75 38 20 2a 20 63 6f 6e 73 74 20 61 54 6f 20 3d u8 * const aTo =
37b60 20 70 54 6f 2d 3e 61 44 61 74 61 3b 0a 20 20 20 pTo->aData;.
37b70 20 69 6e 74 20 63 6f 6e 73 74 20 69 46 72 6f 6d int const iFrom
37b80 48 64 72 20 3d 20 70 46 72 6f 6d 2d 3e 68 64 72 Hdr = pFrom->hdr
37b90 4f 66 66 73 65 74 3b 0a 20 20 20 20 69 6e 74 20 Offset;. int
37ba0 63 6f 6e 73 74 20 69 54 6f 48 64 72 20 3d 20 28 const iToHdr = (
37bb0 28 70 54 6f 2d 3e 70 67 6e 6f 3d 3d 31 29 20 3f (pTo->pgno==1) ?
37bc0 20 31 30 30 20 3a 20 30 29 3b 0a 20 20 20 20 69 100 : 0);. i
37bd0 6e 74 20 72 63 3b 0a 20 20 20 20 69 6e 74 20 69 nt rc;. int i
37be0 44 61 74 61 3b 0a 20 20 0a 20 20 0a 20 20 20 20 Data;. . .
37bf0 61 73 73 65 72 74 28 20 70 46 72 6f 6d 2d 3e 69 assert( pFrom->i
37c00 73 49 6e 69 74 20 29 3b 0a 20 20 20 20 61 73 73 sInit );. ass
37c10 65 72 74 28 20 70 46 72 6f 6d 2d 3e 6e 46 72 65 ert( pFrom->nFre
37c20 65 3e 3d 69 54 6f 48 64 72 20 29 3b 0a 20 20 20 e>=iToHdr );.
37c30 20 61 73 73 65 72 74 28 20 67 65 74 32 62 79 74 assert( get2byt
37c40 65 28 26 61 46 72 6f 6d 5b 69 46 72 6f 6d 48 64 e(&aFrom[iFromHd
37c50 72 2b 35 5d 29 20 3c 3d 20 28 69 6e 74 29 70 42 r+5]) <= (int)pB
37c60 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b t->usableSize );
37c70 0a 20 20 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 . . /* Copy
37c80 74 68 65 20 62 2d 74 72 65 65 20 6e 6f 64 65 20 the b-tree node
37c90 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 70 61 67 content from pag
37ca0 65 20 70 46 72 6f 6d 20 74 6f 20 70 61 67 65 20 e pFrom to page
37cb0 70 54 6f 2e 20 2a 2f 0a 20 20 20 20 69 44 61 74 pTo. */. iDat
37cc0 61 20 3d 20 67 65 74 32 62 79 74 65 28 26 61 46 a = get2byte(&aF
37cd0 72 6f 6d 5b 69 46 72 6f 6d 48 64 72 2b 35 5d 29 rom[iFromHdr+5])
37ce0 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 61 54 ;. memcpy(&aT
37cf0 6f 5b 69 44 61 74 61 5d 2c 20 26 61 46 72 6f 6d o[iData], &aFrom
37d00 5b 69 44 61 74 61 5d 2c 20 70 42 74 2d 3e 75 73 [iData], pBt->us
37d10 61 62 6c 65 53 69 7a 65 2d 69 44 61 74 61 29 3b ableSize-iData);
37d20 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 61 54 6f . memcpy(&aTo
37d30 5b 69 54 6f 48 64 72 5d 2c 20 26 61 46 72 6f 6d [iToHdr], &aFrom
37d40 5b 69 46 72 6f 6d 48 64 72 5d 2c 20 70 46 72 6f [iFromHdr], pFro
37d50 6d 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 m->cellOffset +
37d60 32 2a 70 46 72 6f 6d 2d 3e 6e 43 65 6c 6c 29 3b 2*pFrom->nCell);
37d70 0a 20 20 0a 20 20 20 20 2f 2a 20 52 65 69 6e 69 . . /* Reini
37d80 74 69 61 6c 69 7a 65 20 70 61 67 65 20 70 54 6f tialize page pTo
37d90 20 73 6f 20 74 68 61 74 20 74 68 65 20 63 6f 6e so that the con
37da0 74 65 6e 74 73 20 6f 66 20 74 68 65 20 4d 65 6d tents of the Mem
37db0 50 61 67 65 20 73 74 72 75 63 74 75 72 65 0a 20 Page structure.
37dc0 20 20 20 2a 2a 20 6d 61 74 63 68 20 74 68 65 20 ** match the
37dd0 6e 65 77 20 64 61 74 61 2e 20 54 68 65 20 69 6e new data. The in
37de0 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 itialization of
37df0 70 54 6f 20 63 61 6e 20 61 63 74 75 61 6c 6c 79 pTo can actually
37e00 20 66 61 69 6c 20 75 6e 64 65 72 0a 20 20 20 20 fail under.
37e10 2a 2a 20 66 61 69 72 6c 79 20 6f 62 73 63 75 72 ** fairly obscur
37e20 65 20 63 69 72 63 75 6d 73 74 61 6e 63 65 73 2c e circumstances,
37e30 20 65 76 65 6e 20 74 68 6f 75 67 68 20 69 74 20 even though it
37e40 69 73 20 61 20 63 6f 70 79 20 6f 66 20 69 6e 69 is a copy of ini
37e50 74 69 61 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a tialized . **
37e60 20 70 61 67 65 20 70 46 72 6f 6d 2e 0a 20 20 20 page pFrom..
37e70 20 2a 2f 0a 20 20 20 20 70 54 6f 2d 3e 69 73 49 */. pTo->isI
37e80 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 nit = 0;. rc
37e90 3d 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 = btreeInitPage(
37ea0 70 54 6f 29 3b 0a 20 20 20 20 69 66 28 20 72 63 pTo);. if( rc
37eb0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
37ec0 20 20 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a *pRC = rc;.
37ed0 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 return;.
37ee0 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 }. . /* If
37ef0 20 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 6f this is an auto
37f00 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 -vacuum database
37f10 2c 20 75 70 64 61 74 65 20 74 68 65 20 70 6f 69 , update the poi
37f20 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 nter-map entries
37f30 0a 20 20 20 20 2a 2a 20 66 6f 72 20 61 6e 79 20 . ** for any
37f40 62 2d 74 72 65 65 20 6f 72 20 6f 76 65 72 66 6c b-tree or overfl
37f50 6f 77 20 70 61 67 65 73 20 74 68 61 74 20 70 54 ow pages that pT
37f60 6f 20 6e 6f 77 20 63 6f 6e 74 61 69 6e 73 20 74 o now contains t
37f70 68 65 20 70 6f 69 6e 74 65 72 73 20 74 6f 2e 0a he pointers to..
37f80 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 */. if( I
37f90 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 SAUTOVACUUM ){.
37fa0 20 20 20 20 20 2a 70 52 43 20 3d 20 73 65 74 43 *pRC = setC
37fb0 68 69 6c 64 50 74 72 6d 61 70 73 28 70 54 6f 29 hildPtrmaps(pTo)
37fc0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
37fd0 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
37fe0 65 20 72 65 64 69 73 74 72 69 62 75 74 65 73 20 e redistributes
37ff0 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 69 50 61 cells on the iPa
38000 72 65 6e 74 49 64 78 27 74 68 20 63 68 69 6c 64 rentIdx'th child
38010 20 6f 66 20 70 50 61 72 65 6e 74 0a 2a 2a 20 28 of pParent.** (
38020 68 65 72 65 61 66 74 65 72 20 22 74 68 65 20 70 hereafter "the p
38030 61 67 65 22 29 20 61 6e 64 20 75 70 20 74 6f 20 age") and up to
38040 32 20 73 69 62 6c 69 6e 67 73 20 73 6f 20 74 68 2 siblings so th
38050 61 74 20 61 6c 6c 20 70 61 67 65 73 20 68 61 76 at all pages hav
38060 65 20 61 62 6f 75 74 20 74 68 65 0a 2a 2a 20 73 e about the.** s
38070 61 6d 65 20 61 6d 6f 75 6e 74 20 6f 66 20 66 72 ame amount of fr
38080 65 65 20 73 70 61 63 65 2e 20 55 73 75 61 6c 6c ee space. Usuall
38090 79 20 61 20 73 69 6e 67 6c 65 20 73 69 62 6c 69 y a single sibli
380a0 6e 67 20 6f 6e 20 65 69 74 68 65 72 20 73 69 64 ng on either sid
380b0 65 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 67 65 e of the.** page
380c0 20 61 72 65 20 75 73 65 64 20 69 6e 20 74 68 65 are used in the
380d0 20 62 61 6c 61 6e 63 69 6e 67 2c 20 74 68 6f 75 balancing, thou
380e0 67 68 20 62 6f 74 68 20 73 69 62 6c 69 6e 67 73 gh both siblings
380f0 20 6d 69 67 68 74 20 63 6f 6d 65 20 66 72 6f 6d might come from
38100 20 6f 6e 65 0a 2a 2a 20 73 69 64 65 20 69 66 20 one.** side if
38110 74 68 65 20 70 61 67 65 20 69 73 20 74 68 65 20 the page is the
38120 66 69 72 73 74 20 6f 72 20 6c 61 73 74 20 63 68 first or last ch
38130 69 6c 64 20 6f 66 20 69 74 73 20 70 61 72 65 6e ild of its paren
38140 74 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 0a t. If the page .
38150 2a 2a 20 68 61 73 20 66 65 77 65 72 20 74 68 61 ** has fewer tha
38160 6e 20 32 20 73 69 62 6c 69 6e 67 73 20 28 73 6f n 2 siblings (so
38170 6d 65 74 68 69 6e 67 20 77 68 69 63 68 20 63 61 mething which ca
38180 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 n only happen if
38190 20 74 68 65 20 70 61 67 65 0a 2a 2a 20 69 73 20 the page.** is
381a0 61 20 72 6f 6f 74 20 70 61 67 65 20 6f 72 20 61 a root page or a
381b0 20 63 68 69 6c 64 20 6f 66 20 61 20 72 6f 6f 74 child of a root
381c0 20 70 61 67 65 29 20 74 68 65 6e 20 61 6c 6c 20 page) then all
381d0 61 76 61 69 6c 61 62 6c 65 20 73 69 62 6c 69 6e available siblin
381e0 67 73 0a 2a 2a 20 70 61 72 74 69 63 69 70 61 74 gs.** participat
381f0 65 20 69 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 e in the balanci
38200 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 75 ng..**.** The nu
38210 6d 62 65 72 20 6f 66 20 73 69 62 6c 69 6e 67 73 mber of siblings
38220 20 6f 66 20 74 68 65 20 70 61 67 65 20 6d 69 67 of the page mig
38230 68 74 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 ht be increased
38240 6f 72 20 64 65 63 72 65 61 73 65 64 20 62 79 20 or decreased by
38250 0a 2a 2a 20 6f 6e 65 20 6f 72 20 74 77 6f 20 69 .** one or two i
38260 6e 20 61 6e 20 65 66 66 6f 72 74 20 74 6f 20 6b n an effort to k
38270 65 65 70 20 70 61 67 65 73 20 6e 65 61 72 6c 79 eep pages nearly
38280 20 66 75 6c 6c 20 62 75 74 20 6e 6f 74 20 6f 76 full but not ov
38290 65 72 20 66 75 6c 6c 2e 20 0a 2a 2a 0a 2a 2a 20 er full. .**.**
382a0 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 74 Note that when t
382b0 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
382c0 61 6c 6c 65 64 2c 20 73 6f 6d 65 20 6f 66 20 74 alled, some of t
382d0 68 65 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 he cells on the
382e0 70 61 67 65 0a 2a 2a 20 6d 69 67 68 74 20 6e 6f page.** might no
382f0 74 20 61 63 74 75 61 6c 6c 79 20 62 65 20 73 74 t actually be st
38300 6f 72 65 64 20 69 6e 20 4d 65 6d 50 61 67 65 2e ored in MemPage.
38310 61 44 61 74 61 5b 5d 2e 20 54 68 69 73 20 63 61 aData[]. This ca
38320 6e 20 68 61 70 70 65 6e 0a 2a 2a 20 69 66 20 74 n happen.** if t
38330 68 65 20 70 61 67 65 20 69 73 20 6f 76 65 72 66 he page is overf
38340 75 6c 6c 2e 20 54 68 69 73 20 72 6f 75 74 69 6e ull. This routin
38350 65 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 61 e ensures that a
38360 6c 6c 20 63 65 6c 6c 73 20 61 6c 6c 6f 63 61 74 ll cells allocat
38370 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 ed.** to the pag
38380 65 20 61 6e 64 20 69 74 73 20 73 69 62 6c 69 6e e and its siblin
38390 67 73 20 66 69 74 20 69 6e 74 6f 20 4d 65 6d 50 gs fit into MemP
383a0 61 67 65 2e 61 44 61 74 61 5b 5d 20 62 65 66 6f age.aData[] befo
383b0 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a re returning..**
383c0 0a 2a 2a 20 49 6e 20 74 68 65 20 63 6f 75 72 73 .** In the cours
383d0 65 20 6f 66 20 62 61 6c 61 6e 63 69 6e 67 20 74 e of balancing t
383e0 68 65 20 70 61 67 65 20 61 6e 64 20 69 74 73 20 he page and its
383f0 73 69 62 6c 69 6e 67 73 2c 20 63 65 6c 6c 73 20 siblings, cells
38400 6d 61 79 20 62 65 0a 2a 2a 20 69 6e 73 65 72 74 may be.** insert
38410 65 64 20 69 6e 74 6f 20 6f 72 20 72 65 6d 6f 76 ed into or remov
38420 65 64 20 66 72 6f 6d 20 74 68 65 20 70 61 72 65 ed from the pare
38430 6e 74 20 70 61 67 65 20 28 70 50 61 72 65 6e 74 nt page (pParent
38440 29 2e 20 44 6f 69 6e 67 20 73 6f 0a 2a 2a 20 6d ). Doing so.** m
38450 61 79 20 63 61 75 73 65 20 74 68 65 20 70 61 72 ay cause the par
38460 65 6e 74 20 70 61 67 65 20 74 6f 20 62 65 63 6f ent page to beco
38470 6d 65 20 6f 76 65 72 66 75 6c 6c 20 6f 72 20 75