0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 41 70 72 69 6c /*.** 2004 April
0010: 20 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 6.**.** The aut
0020: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f hor disclaims co
0030: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 pyright to this
0040: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e source code. In
0050: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c place of.** a l
0060: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 egal notice, her
0070: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a e is a blessing:
0080: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f .**.** May yo
0090: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f u do good and no
00a0: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 t evil..** Ma
00b0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 y you find forgi
00c0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 veness for yours
00d0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 elf and forgive
00e0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 others..** Ma
00f0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 y you share free
0100: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 ly, never taking
0110: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 more than you g
0120: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a ive..**.********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 69 *.** This file i
0180: 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 65 78 74 mplements an ext
0190: 65 72 6e 61 6c 20 28 64 69 73 6b 2d 62 61 73 65 ernal (disk-base
01a0: 64 29 20 64 61 74 61 62 61 73 65 20 75 73 69 6e d) database usin
01b0: 67 20 42 54 72 65 65 73 2e 0a 2a 2a 20 53 65 65 g BTrees..** See
01c0: 20 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d 6d the header comm
01d0: 65 6e 74 20 6f 6e 20 22 62 74 72 65 65 49 6e 74 ent on "btreeInt
01e0: 2e 68 22 20 66 6f 72 20 61 64 64 69 74 69 6f 6e .h" for addition
01f0: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a al information..
0200: 2a 2a 20 49 6e 63 6c 75 64 69 6e 67 20 61 20 64 ** Including a d
0210: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 66 69 escription of fi
0220: 6c 65 20 66 6f 72 6d 61 74 20 61 6e 64 20 61 6e le format and an
0230: 20 6f 76 65 72 76 69 65 77 20 6f 66 20 6f 70 65 overview of ope
0240: 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 6e 63 6c ration..*/.#incl
0250: 75 64 65 20 22 62 74 72 65 65 49 6e 74 2e 68 22 ude "btreeInt.h"
0260: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 ../*.** The head
0270: 65 72 20 73 74 72 69 6e 67 20 74 68 61 74 20 61 er string that a
0280: 70 70 65 61 72 73 20 61 74 20 74 68 65 20 62 65 ppears at the be
0290: 67 69 6e 6e 69 6e 67 20 6f 66 20 65 76 65 72 79 ginning of every
02a0: 0a 2a 2a 20 53 51 4c 69 74 65 20 64 61 74 61 62 .** SQLite datab
02b0: 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 ase..*/.static c
02c0: 6f 6e 73 74 20 63 68 61 72 20 7a 4d 61 67 69 63 onst char zMagic
02d0: 48 65 61 64 65 72 5b 5d 20 3d 20 53 51 4c 49 54 Header[] = SQLIT
02e0: 45 5f 46 49 4c 45 5f 48 45 41 44 45 52 3b 0a 0a E_FILE_HEADER;..
02f0: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 69 73 20 67 /*.** Set this g
0300: 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 74 lobal variable t
0310: 6f 20 31 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 o 1 to enable tr
0320: 61 63 69 6e 67 20 75 73 69 6e 67 20 74 68 65 20 acing using the
0330: 54 52 41 43 45 0a 2a 2a 20 6d 61 63 72 6f 2e 0a TRACE.** macro..
0340: 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 71 6c */.#if 0.int sql
0350: 69 74 65 33 42 74 72 65 65 54 72 61 63 65 3d 31 ite3BtreeTrace=1
0360: 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e ; /* True to en
0370: 61 62 6c 65 20 74 72 61 63 69 6e 67 20 2a 2f 0a able tracing */.
0380: 23 20 64 65 66 69 6e 65 20 54 52 41 43 45 28 58 # define TRACE(X
0390: 29 20 20 69 66 28 73 71 6c 69 74 65 33 42 74 72 ) if(sqlite3Btr
03a0: 65 65 54 72 61 63 65 29 7b 70 72 69 6e 74 66 20 eeTrace){printf
03b0: 58 3b 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 X;fflush(stdout)
03c0: 3b 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e ;}.#else.# defin
03d0: 65 20 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 e TRACE(X).#endi
03e0: 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 f../*.** Extract
03f0: 20 61 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e a 2-byte big-en
0400: 64 69 61 6e 20 69 6e 74 65 67 65 72 20 66 72 6f dian integer fro
0410: 6d 20 61 6e 20 61 72 72 61 79 20 6f 66 20 75 6e m an array of un
0420: 73 69 67 6e 65 64 20 62 79 74 65 73 2e 0a 2a 2a signed bytes..**
0430: 20 42 75 74 20 69 66 20 74 68 65 20 76 61 6c 75 But if the valu
0440: 65 20 69 73 20 7a 65 72 6f 2c 20 6d 61 6b 65 20 e is zero, make
0450: 69 74 20 36 35 35 33 36 2e 0a 2a 2a 0a 2a 2a 20 it 65536..**.**
0460: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
0470: 75 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 used to extract
0480: 74 68 65 20 22 6f 66 66 73 65 74 20 74 6f 20 63 the "offset to c
0490: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
04a0: 22 20 76 61 6c 75 65 0a 2a 2a 20 66 72 6f 6d 20 " value.** from
04b0: 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 the header of a
04c0: 62 74 72 65 65 20 70 61 67 65 2e 20 20 49 66 20 btree page. If
04d0: 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 the page size is
04e0: 20 36 35 35 33 36 20 61 6e 64 20 74 68 65 20 70 65536 and the p
04f0: 61 67 65 0a 2a 2a 20 69 73 20 65 6d 70 74 79 2c age.** is empty,
0500: 20 74 68 65 20 6f 66 66 73 65 74 20 73 68 6f 75 the offset shou
0510: 6c 64 20 62 65 20 36 35 35 33 36 2c 20 62 75 74 ld be 65536, but
0520: 20 74 68 65 20 32 2d 62 79 74 65 20 76 61 6c 75 the 2-byte valu
0530: 65 20 73 74 6f 72 65 73 20 7a 65 72 6f 2e 0a 2a e stores zero..*
0540: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d * This routine m
0550: 61 6b 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 akes the necessa
0560: 72 79 20 61 64 6a 75 73 74 6d 65 6e 74 20 74 6f ry adjustment to
0570: 20 36 35 35 33 36 2e 0a 2a 2f 0a 23 64 65 66 69 65536..*/.#defi
0580: 6e 65 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 ne get2byteNotZe
0590: 72 6f 28 58 29 20 20 28 28 28 28 28 69 6e 74 29 ro(X) (((((int)
05a0: 67 65 74 32 62 79 74 65 28 58 29 29 2d 31 29 26 get2byte(X))-1)&
05b0: 30 78 66 66 66 66 29 2b 31 29 0a 0a 2f 2a 0a 2a 0xffff)+1)../*.*
05c0: 2a 20 56 61 6c 75 65 73 20 70 61 73 73 65 64 20 * Values passed
05d0: 61 73 20 74 68 65 20 35 74 68 20 61 72 67 75 6d as the 5th argum
05e0: 65 6e 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 42 ent to allocateB
05f0: 74 72 65 65 50 61 67 65 28 29 0a 2a 2f 0a 23 64 treePage().*/.#d
0600: 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f 41 4e efine BTALLOC_AN
0610: 59 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 Y 0
0620: 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 79 20 /* Allocate any
0630: 70 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 page */.#define
0640: 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 31 20 BTALLOC_EXACT 1
0650: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c /* All
0660: 6f 63 61 74 65 20 65 78 61 63 74 20 70 61 67 65 ocate exact page
0670: 20 69 66 20 70 6f 73 73 69 62 6c 65 20 2a 2f 0a if possible */.
0680: 23 64 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f #define BTALLOC_
0690: 4c 45 20 20 20 20 32 20 20 20 20 20 20 20 20 20 LE 2
06a0: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e /* Allocate an
06b0: 79 20 70 61 67 65 20 3c 3d 20 74 68 65 20 70 61 y page <= the pa
06c0: 72 61 6d 65 74 65 72 20 2a 2f 0a 0a 2f 2a 0a 2a rameter */../*.*
06d0: 2a 20 4d 61 63 72 6f 20 49 66 4e 6f 74 4f 6d 69 * Macro IfNotOmi
06e0: 74 41 56 28 78 29 20 72 65 74 75 72 6e 73 20 28 tAV(x) returns (
06f0: 78 29 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 x) if SQLITE_OMI
0700: 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 T_AUTOVACUUM is
0710: 6e 6f 74 20 0a 2a 2a 20 64 65 66 69 6e 65 64 2c not .** defined,
0720: 20 6f 72 20 30 20 69 66 20 69 74 20 69 73 2e 20 or 0 if it is.
0730: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a For example:.**.
0740: 2a 2a 20 20 20 62 49 6e 63 72 56 61 63 75 75 6d ** bIncrVacuum
0750: 20 3d 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 = IfNotOmitAV(p
0760: 42 74 53 68 61 72 65 64 2d 3e 69 6e 63 72 56 61 BtShared->incrVa
0770: 63 75 75 6d 29 3b 0a 2a 2f 0a 23 69 66 6e 64 65 cuum);.*/.#ifnde
0780: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
0790: 54 4f 56 41 43 55 55 4d 0a 23 64 65 66 69 6e 65 TOVACUUM.#define
07a0: 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 65 78 70 IfNotOmitAV(exp
07b0: 72 29 20 28 65 78 70 72 29 0a 23 65 6c 73 65 0a r) (expr).#else.
07c0: 23 64 65 66 69 6e 65 20 49 66 4e 6f 74 4f 6d 69 #define IfNotOmi
07d0: 74 41 56 28 65 78 70 72 29 20 30 0a 23 65 6e 64 tAV(expr) 0.#end
07e0: 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 if..#ifndef SQLI
07f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0800: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 ACHE./*.** A lis
0810: 74 20 6f 66 20 42 74 53 68 61 72 65 64 20 6f 62 t of BtShared ob
0820: 6a 65 63 74 73 20 74 68 61 74 20 61 72 65 20 65 jects that are e
0830: 6c 69 67 69 62 6c 65 20 66 6f 72 20 70 61 72 74 ligible for part
0840: 69 63 69 70 61 74 69 6f 6e 0a 2a 2a 20 69 6e 20 icipation.** in
0850: 73 68 61 72 65 64 20 63 61 63 68 65 2e 20 20 54 shared cache. T
0860: 68 69 73 20 76 61 72 69 61 62 6c 65 20 68 61 73 his variable has
0870: 20 66 69 6c 65 20 73 63 6f 70 65 20 64 75 72 69 file scope duri
0880: 6e 67 20 6e 6f 72 6d 61 6c 20 62 75 69 6c 64 73 ng normal builds
0890: 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 65 73 ,.** but the tes
08a0: 74 20 68 61 72 6e 65 73 73 20 6e 65 65 64 73 20 t harness needs
08b0: 74 6f 20 61 63 63 65 73 73 20 69 74 20 73 6f 20 to access it so
08c0: 77 65 20 6d 61 6b 65 20 69 74 20 67 6c 6f 62 61 we make it globa
08d0: 6c 20 66 6f 72 20 0a 2a 2a 20 74 65 73 74 20 62 l for .** test b
08e0: 75 69 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 41 63 63 uilds..**.** Acc
08f0: 65 73 73 20 74 6f 20 74 68 69 73 20 76 61 72 69 ess to this vari
0900: 61 62 6c 65 20 69 73 20 70 72 6f 74 65 63 74 65 able is protecte
0910: 64 20 62 79 20 53 51 4c 49 54 45 5f 4d 55 54 45 d by SQLITE_MUTE
0920: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 2e X_STATIC_MASTER.
0930: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
0940: 45 5f 54 45 53 54 0a 42 74 53 68 61 72 65 64 20 E_TEST.BtShared
0950: 2a 53 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 *SQLITE_WSD sqli
0960: 74 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 te3SharedCacheLi
0970: 73 74 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 73 74 st = 0;.#else.st
0980: 61 74 69 63 20 42 74 53 68 61 72 65 64 20 2a 53 atic BtShared *S
0990: 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 74 65 QLITE_WSD sqlite
09a0: 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 3SharedCacheList
09b0: 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 23 65 6e = 0;.#endif.#en
09c0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
09d0: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 IT_SHARED_CACHE
09e0: 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */..#ifndef SQLI
09f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0a00: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c ACHE./*.** Enabl
0a10: 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 65 e or disable the
0a20: 20 73 68 61 72 65 64 20 70 61 67 65 72 20 61 6e shared pager an
0a30: 64 20 73 63 68 65 6d 61 20 66 65 61 74 75 72 65 d schema feature
0a40: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f s..**.** This ro
0a50: 75 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 utine has no eff
0a60: 65 63 74 20 6f 6e 20 65 78 69 73 74 69 6e 67 20 ect on existing
0a70: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
0a80: 69 6f 6e 73 2e 0a 2a 2a 20 54 68 65 20 73 68 61 ions..** The sha
0a90: 72 65 64 20 63 61 63 68 65 20 73 65 74 74 69 6e red cache settin
0aa0: 67 20 65 66 66 65 63 74 73 20 6f 6e 6c 79 20 66 g effects only f
0ab0: 75 74 75 72 65 20 63 61 6c 6c 73 20 74 6f 0a 2a uture calls to.*
0ac0: 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 * sqlite3_open()
0ad0: 2c 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 , sqlite3_open16
0ae0: 28 29 2c 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f (), or sqlite3_o
0af0: 70 65 6e 5f 76 32 28 29 2e 0a 2a 2f 0a 69 6e 74 pen_v2()..*/.int
0b00: 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f sqlite3_enable_
0b10: 73 68 61 72 65 64 5f 63 61 63 68 65 28 69 6e 74 shared_cache(int
0b20: 20 65 6e 61 62 6c 65 29 7b 0a 23 69 66 20 64 65 enable){.#if de
0b30: 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
0b40: 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c && !defined(SQL
0b50: 49 54 45 5f 54 45 53 54 29 20 26 26 20 21 64 65 ITE_TEST) && !de
0b60: 66 69 6e 65 64 28 54 48 33 5f 43 4f 4d 50 41 54 fined(TH3_COMPAT
0b70: 49 42 49 4c 49 54 59 29 0a 20 20 2f 2a 20 45 6e IBILITY). /* En
0b80: 61 62 6c 65 20 67 6c 6f 62 61 6c 20 73 68 61 72 able global shar
0b90: 65 64 20 63 61 63 68 65 20 66 75 6e 63 74 69 6f ed cache functio
0ba0: 6e 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20 n for debugging
0bb0: 61 6e 64 20 75 6e 69 74 20 74 65 73 74 73 2c 20 and unit tests,
0bc0: 0a 20 20 2a 2a 20 62 75 74 20 6e 6f 74 20 66 6f . ** but not fo
0bd0: 72 20 72 65 6c 65 61 73 65 20 2a 2f 0a 20 20 72 r release */. r
0be0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
0bf0: 55 53 45 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c USE;.#else. sql
0c00: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
0c10: 2e 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 .sharedCacheEnab
0c20: 6c 65 64 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 led = enable;.
0c30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
0c40: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 23 65 6e 64 69 ;.#endif.}.#endi
0c50: 66 0a 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 f....#ifdef SQLI
0c60: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0c70: 41 43 48 45 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 ACHE. /*. ** T
0c80: 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 71 75 65 he functions que
0c90: 72 79 53 68 61 72 65 64 43 61 63 68 65 54 61 62 rySharedCacheTab
0ca0: 6c 65 4c 6f 63 6b 28 29 2c 20 73 65 74 53 68 61 leLock(), setSha
0cb0: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
0cc0: 6b 28 29 2c 0a 20 20 2a 2a 20 61 6e 64 20 63 6c k(),. ** and cl
0cd0: 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 earAllSharedCach
0ce0: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 29 0a 20 20 eTableLocks().
0cf0: 2a 2a 20 6d 61 6e 69 70 75 6c 61 74 65 20 65 6e ** manipulate en
0d00: 74 72 69 65 73 20 69 6e 20 74 68 65 20 42 74 53 tries in the BtS
0d10: 68 61 72 65 64 2e 70 4c 6f 63 6b 20 6c 69 6e 6b hared.pLock link
0d20: 65 64 20 6c 69 73 74 20 75 73 65 64 20 74 6f 20 ed list used to
0d30: 73 74 6f 72 65 0a 20 20 2a 2a 20 73 68 61 72 65 store. ** share
0d40: 64 2d 63 61 63 68 65 20 74 61 62 6c 65 20 6c 65 d-cache table le
0d50: 76 65 6c 20 6c 6f 63 6b 73 2e 20 49 66 20 74 68 vel locks. If th
0d60: 65 20 6c 69 62 72 61 72 79 20 69 73 20 63 6f 6d e library is com
0d70: 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 0a 20 piled with the.
0d80: 20 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 ** shared-cache
0d90: 20 66 65 61 74 75 72 65 20 64 69 73 61 62 6c 65 feature disable
0da0: 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 d, then there is
0db0: 20 6f 6e 6c 79 20 65 76 65 72 20 6f 6e 65 20 75 only ever one u
0dc0: 73 65 72 0a 20 20 2a 2a 20 6f 66 20 65 61 63 68 ser. ** of each
0dd0: 20 42 74 53 68 61 72 65 64 20 73 74 72 75 63 74 BtShared struct
0de0: 75 72 65 20 61 6e 64 20 73 6f 20 74 68 69 73 20 ure and so this
0df0: 6c 6f 63 6b 69 6e 67 20 69 73 20 6e 6f 74 20 6e locking is not n
0e00: 65 63 65 73 73 61 72 79 2e 20 0a 20 20 2a 2a 20 ecessary. . **
0e10: 53 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6c 6f So define the lo
0e20: 63 6b 20 72 65 6c 61 74 65 64 20 66 75 6e 63 74 ck related funct
0e30: 69 6f 6e 73 20 61 73 20 6e 6f 2d 6f 70 73 2e 0a ions as no-ops..
0e40: 20 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 71 */. #define q
0e50: 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 54 uerySharedCacheT
0e60: 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 29 20 ableLock(a,b,c)
0e70: 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 SQLITE_OK. #def
0e80: 69 6e 65 20 73 65 74 53 68 61 72 65 64 43 61 63 ine setSharedCac
0e90: 68 65 54 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c heTableLock(a,b,
0ea0: 63 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 c) SQLITE_OK. #
0eb0: 64 65 66 69 6e 65 20 63 6c 65 61 72 41 6c 6c 53 define clearAllS
0ec0: 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
0ed0: 6f 63 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e ocks(a). #defin
0ee0: 65 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 e downgradeAllSh
0ef0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0f00: 63 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e 65 cks(a). #define
0f10: 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 hasSharedCacheT
0f20: 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 2c 64 ableLock(a,b,c,d
0f30: 29 20 31 0a 20 20 23 64 65 66 69 6e 65 20 68 61 ) 1. #define ha
0f40: 73 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 61 sReadConflicts(a
0f50: 2c 20 62 29 20 30 0a 23 65 6e 64 69 66 0a 0a 23 , b) 0.#endif..#
0f60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
0f70: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
0f80: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
0f90: 45 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 EBUG./*.**** Thi
0fa0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e s function is on
0fb0: 6c 79 20 75 73 65 64 20 61 73 20 70 61 72 74 20 ly used as part
0fc0: 6f 66 20 61 6e 20 61 73 73 65 72 74 28 29 20 73 of an assert() s
0fd0: 74 61 74 65 6d 65 6e 74 2e 20 2a 2a 2a 0a 2a 2a tatement. ***.**
0fe0: 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 .** Check to see
0ff0: 20 69 66 20 70 42 74 72 65 65 20 68 6f 6c 64 73 if pBtree holds
1000: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6c 6f the required lo
1010: 63 6b 73 20 74 6f 20 72 65 61 64 20 6f 72 20 77 cks to read or w
1020: 72 69 74 65 20 74 6f 20 74 68 65 20 0a 2a 2a 20 rite to the .**
1030: 74 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 20 table with root
1040: 70 61 67 65 20 69 52 6f 6f 74 2e 20 20 20 52 65 page iRoot. Re
1050: 74 75 72 6e 20 31 20 69 66 20 69 74 20 64 6f 65 turn 1 if it doe
1060: 73 20 61 6e 64 20 30 20 69 66 20 6e 6f 74 2e 0a s and 0 if not..
1070: 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c **.** For exampl
1080: 65 2c 20 77 68 65 6e 20 77 72 69 74 69 6e 67 20 e, when writing
1090: 74 6f 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 to a table with
10a0: 72 6f 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 20 root-page iRoot
10b0: 76 69 61 20 0a 2a 2a 20 42 74 72 65 65 20 63 6f via .** Btree co
10c0: 6e 6e 65 63 74 69 6f 6e 20 70 42 74 72 65 65 3a nnection pBtree:
10d0: 0a 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 .**.** assert
10e0: 28 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 ( hasSharedCache
10f0: 54 61 62 6c 65 4c 6f 63 6b 28 70 42 74 72 65 65 TableLock(pBtree
1100: 2c 20 69 52 6f 6f 74 2c 20 30 2c 20 57 52 49 54 , iRoot, 0, WRIT
1110: 45 5f 4c 4f 43 4b 29 20 29 3b 0a 2a 2a 0a 2a 2a E_LOCK) );.**.**
1120: 20 57 68 65 6e 20 77 72 69 74 69 6e 67 20 74 6f When writing to
1130: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 20 72 an index that r
1140: 65 73 69 64 65 73 20 69 6e 20 61 20 73 68 61 72 esides in a shar
1150: 61 62 6c 65 20 64 61 74 61 62 61 73 65 2c 20 74 able database, t
1160: 68 65 20 0a 2a 2a 20 63 61 6c 6c 65 72 20 73 68 he .** caller sh
1170: 6f 75 6c 64 20 68 61 76 65 20 66 69 72 73 74 20 ould have first
1180: 6f 62 74 61 69 6e 65 64 20 61 20 6c 6f 63 6b 20 obtained a lock
1190: 73 70 65 63 69 66 79 69 6e 67 20 74 68 65 20 72 specifying the r
11a0: 6f 6f 74 20 70 61 67 65 20 6f 66 0a 2a 2a 20 74 oot page of.** t
11b0: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
11c0: 20 74 61 62 6c 65 2e 20 54 68 69 73 20 6d 61 6b table. This mak
11d0: 65 73 20 74 68 69 6e 67 73 20 61 20 62 69 74 20 es things a bit
11e0: 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 more complicated
11f0: 2c 0a 2a 2a 20 61 73 20 74 68 69 73 20 6d 6f 64 ,.** as this mod
1200: 75 6c 65 20 74 72 65 61 74 73 20 65 61 63 68 20 ule treats each
1210: 74 61 62 6c 65 20 61 73 20 61 20 73 65 70 61 72 table as a separ
1220: 61 74 65 20 73 74 72 75 63 74 75 72 65 2e 20 54 ate structure. T
1230: 6f 20 64 65 74 65 72 6d 69 6e 65 0a 2a 2a 20 74 o determine.** t
1240: 68 65 20 74 61 62 6c 65 20 63 6f 72 72 65 73 70 he table corresp
1250: 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 69 6e onding to the in
1260: 64 65 78 20 62 65 69 6e 67 20 77 72 69 74 74 65 dex being writte
1270: 6e 2c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 n, this.** funct
1280: 69 6f 6e 20 68 61 73 20 74 6f 20 73 65 61 72 63 ion has to searc
1290: 68 20 74 68 72 6f 75 67 68 20 74 68 65 20 64 61 h through the da
12a0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a tabase schema..*
12b0: 2a 0a 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 *.** Instead of
12c0: 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 74 61 a lock on the ta
12d0: 62 6c 65 2f 69 6e 64 65 78 20 72 6f 6f 74 65 64 ble/index rooted
12e0: 20 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 at page iRoot,
12f0: 74 68 65 20 63 61 6c 6c 65 72 20 6d 61 79 0a 2a the caller may.*
1300: 2a 20 68 6f 6c 64 20 61 20 77 72 69 74 65 2d 6c * hold a write-l
1310: 6f 63 6b 20 6f 6e 20 74 68 65 20 73 63 68 65 6d ock on the schem
1320: 61 20 74 61 62 6c 65 20 28 72 6f 6f 74 20 70 61 a table (root pa
1330: 67 65 20 31 29 2e 20 54 68 69 73 20 69 73 20 61 ge 1). This is a
1340: 6c 73 6f 0a 2a 2a 20 61 63 63 65 70 74 61 62 6c lso.** acceptabl
1350: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
1360: 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 hasSharedCacheT
1370: 61 62 6c 65 4c 6f 63 6b 28 0a 20 20 42 74 72 65 ableLock(. Btre
1380: 65 20 2a 70 42 74 72 65 65 2c 20 20 20 20 20 20 e *pBtree,
1390: 20 20 20 2f 2a 20 48 61 6e 64 6c 65 20 74 68 61 /* Handle tha
13a0: 74 20 6d 75 73 74 20 68 6f 6c 64 20 6c 6f 63 6b t must hold lock
13b0: 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 */. Pgno iRoot
13c0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
13d0: 52 6f 6f 74 20 70 61 67 65 20 6f 66 20 62 2d 74 Root page of b-t
13e0: 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 ree */. int isI
13f0: 6e 64 65 78 2c 20 20 20 20 20 20 20 20 20 20 20 ndex,
1400: 2f 2a 20 54 72 75 65 20 69 66 20 69 52 6f 6f 74 /* True if iRoot
1410: 20 69 73 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 is the root of
1420: 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 an index b-tree
1430: 2a 2f 0a 20 20 69 6e 74 20 65 4c 6f 63 6b 54 79 */. int eLockTy
1440: 70 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 pe /* R
1450: 65 71 75 69 72 65 64 20 6c 6f 63 6b 20 74 79 70 equired lock typ
1460: 65 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 e (READ_LOCK or
1470: 57 52 49 54 45 5f 4c 4f 43 4b 29 20 2a 2f 0a 29 WRITE_LOCK) */.)
1480: 7b 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 {. Schema *pSch
1490: 65 6d 61 20 3d 20 28 53 63 68 65 6d 61 20 2a 29 ema = (Schema *)
14a0: 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 53 63 pBtree->pBt->pSc
14b0: 68 65 6d 61 3b 0a 20 20 50 67 6e 6f 20 69 54 61 hema;. Pgno iTa
14c0: 62 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 b = 0;. BtLock
14d0: 2a 70 4c 6f 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66 *pLock;.. /* If
14e0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 this database i
14f0: 73 20 6e 6f 74 20 73 68 61 72 65 61 62 6c 65 2c s not shareable,
1500: 20 6f 72 20 69 66 20 74 68 65 20 63 6c 69 65 6e or if the clien
1510: 74 20 69 73 20 72 65 61 64 69 6e 67 0a 20 20 2a t is reading. *
1520: 2a 20 61 6e 64 20 68 61 73 20 74 68 65 20 72 65 * and has the re
1530: 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 ad-uncommitted f
1540: 6c 61 67 20 73 65 74 2c 20 74 68 65 6e 20 6e 6f lag set, then no
1550: 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 69 72 65 lock is require
1560: 64 2e 20 0a 20 20 2a 2a 20 52 65 74 75 72 6e 20 d. . ** Return
1570: 74 72 75 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 true immediately
1580: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 70 42 .. */. if( (pB
1590: 74 72 65 65 2d 3e 73 68 61 72 61 62 6c 65 3d 3d tree->sharable==
15a0: 30 29 0a 20 20 20 7c 7c 20 28 65 4c 6f 63 6b 54 0). || (eLockT
15b0: 79 70 65 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 26 ype==READ_LOCK &
15c0: 26 20 28 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 & (pBtree->db->f
15d0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 lags & SQLITE_Re
15e0: 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 29 0a adUncommitted)).
15f0: 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1600: 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 1;. }.. /* If
1610: 74 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 the client is re
1620: 61 64 69 6e 67 20 20 6f 72 20 77 72 69 74 69 6e ading or writin
1630: 67 20 61 6e 20 69 6e 64 65 78 20 61 6e 64 20 74 g an index and t
1640: 68 65 20 73 63 68 65 6d 61 20 69 73 0a 20 20 2a he schema is. *
1650: 2a 20 6e 6f 74 20 6c 6f 61 64 65 64 2c 20 74 68 * not loaded, th
1660: 65 6e 20 69 74 20 69 73 20 74 6f 6f 20 64 69 66 en it is too dif
1670: 66 69 63 75 6c 74 20 74 6f 20 61 63 74 75 61 6c ficult to actual
1680: 6c 79 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 ly check to see
1690: 69 66 0a 20 20 2a 2a 20 74 68 65 20 63 6f 72 72 if. ** the corr
16a0: 65 63 74 20 6c 6f 63 6b 73 20 61 72 65 20 68 65 ect locks are he
16b0: 6c 64 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 62 ld. So do not b
16c0: 6f 74 68 65 72 20 2d 20 6a 75 73 74 20 72 65 74 other - just ret
16d0: 75 72 6e 20 74 72 75 65 2e 0a 20 20 2a 2a 20 54 urn true.. ** T
16e0: 68 69 73 20 63 61 73 65 20 64 6f 65 73 20 6e 6f his case does no
16f0: 74 20 63 6f 6d 65 20 75 70 20 76 65 72 79 20 6f t come up very o
1700: 66 74 65 6e 20 61 6e 79 68 6f 77 2e 0a 20 20 2a ften anyhow.. *
1710: 2f 0a 20 20 69 66 28 20 69 73 49 6e 64 65 78 20 /. if( isIndex
1720: 26 26 20 28 21 70 53 63 68 65 6d 61 20 7c 7c 20 && (!pSchema ||
1730: 28 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 (pSchema->schema
1740: 46 6c 61 67 73 26 44 42 5f 53 63 68 65 6d 61 4c Flags&DB_SchemaL
1750: 6f 61 64 65 64 29 3d 3d 30 29 20 29 7b 0a 20 20 oaded)==0) ){.
1760: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a return 1;. }.
1770: 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 . /* Figure out
1780: 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 20 74 the root-page t
1790: 68 61 74 20 74 68 65 20 6c 6f 63 6b 20 73 68 6f hat the lock sho
17a0: 75 6c 64 20 62 65 20 68 65 6c 64 20 6f 6e 2e 20 uld be held on.
17b0: 46 6f 72 20 74 61 62 6c 65 0a 20 20 2a 2a 20 62 For table. ** b
17c0: 2d 74 72 65 65 73 2c 20 74 68 69 73 20 69 73 20 -trees, this is
17d0: 6a 75 73 74 20 74 68 65 20 72 6f 6f 74 20 70 61 just the root pa
17e0: 67 65 20 6f 66 20 74 68 65 20 62 2d 74 72 65 65 ge of the b-tree
17f0: 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 0a 20 being read or.
1800: 20 2a 2a 20 77 72 69 74 74 65 6e 2e 20 46 6f 72 ** written. For
1810: 20 69 6e 64 65 78 20 62 2d 74 72 65 65 73 2c 20 index b-trees,
1820: 69 74 20 69 73 20 74 68 65 20 72 6f 6f 74 20 70 it is the root p
1830: 61 67 65 20 6f 66 20 74 68 65 20 61 73 73 6f 63 age of the assoc
1840: 69 61 74 65 64 0a 20 20 2a 2a 20 74 61 62 6c 65 iated. ** table
1850: 2e 20 20 2a 2f 0a 20 20 69 66 28 20 69 73 49 6e . */. if( isIn
1860: 64 65 78 20 29 7b 0a 20 20 20 20 48 61 73 68 45 dex ){. HashE
1870: 6c 65 6d 20 2a 70 3b 0a 20 20 20 20 66 6f 72 28 lem *p;. for(
1880: 70 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 p=sqliteHashFirs
1890: 74 28 26 70 53 63 68 65 6d 61 2d 3e 69 64 78 48 t(&pSchema->idxH
18a0: 61 73 68 29 3b 20 70 3b 20 70 3d 73 71 6c 69 74 ash); p; p=sqlit
18b0: 65 48 61 73 68 4e 65 78 74 28 70 29 29 7b 0a 20 eHashNext(p)){.
18c0: 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 Index *pIdx
18d0: 20 3d 20 28 49 6e 64 65 78 20 2a 29 73 71 6c 69 = (Index *)sqli
18e0: 74 65 48 61 73 68 44 61 74 61 28 70 29 3b 0a 20 teHashData(p);.
18f0: 20 20 20 20 20 69 66 28 20 70 49 64 78 2d 3e 74 if( pIdx->t
1900: 6e 75 6d 3d 3d 28 69 6e 74 29 69 52 6f 6f 74 20 num==(int)iRoot
1910: 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 ){. if( i
1920: 54 61 62 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Tab ){.
1930: 20 2f 2a 20 54 77 6f 20 6f 72 20 6d 6f 72 65 20 /* Two or more
1940: 69 6e 64 65 78 65 73 20 73 68 61 72 65 20 74 68 indexes share th
1950: 65 20 73 61 6d 65 20 72 6f 6f 74 20 70 61 67 65 e same root page
1960: 2e 20 20 54 68 65 72 65 20 6d 75 73 74 0a 20 20 . There must.
1970: 20 20 20 20 20 20 20 20 2a 2a 20 62 65 20 69 6d ** be im
1980: 70 6f 73 74 65 72 20 74 61 62 6c 65 73 2e 20 20 poster tables.
1990: 53 6f 20 6a 75 73 74 20 72 65 74 75 72 6e 20 74 So just return t
19a0: 72 75 65 2e 20 20 54 68 65 20 61 73 73 65 72 74 rue. The assert
19b0: 20 69 73 20 6e 6f 74 0a 20 20 20 20 20 20 20 20 is not.
19c0: 20 20 2a 2a 20 75 73 65 66 75 6c 20 69 6e 20 74 ** useful in t
19d0: 68 61 74 20 63 61 73 65 2e 20 2a 2f 0a 20 20 20 hat case. */.
19e0: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b return 1;
19f0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
1a00: 20 20 20 69 54 61 62 20 3d 20 70 49 64 78 2d 3e iTab = pIdx->
1a10: 70 54 61 62 6c 65 2d 3e 74 6e 75 6d 3b 0a 20 20 pTable->tnum;.
1a20: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 }. }. }e
1a30: 6c 73 65 7b 0a 20 20 20 20 69 54 61 62 20 3d 20 lse{. iTab =
1a40: 69 52 6f 6f 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a iRoot;. }.. /*
1a50: 20 53 65 61 72 63 68 20 66 6f 72 20 74 68 65 20 Search for the
1a60: 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e 20 45 required lock. E
1a70: 69 74 68 65 72 20 61 20 77 72 69 74 65 2d 6c 6f ither a write-lo
1a80: 63 6b 20 6f 6e 20 72 6f 6f 74 2d 70 61 67 65 20 ck on root-page
1a90: 69 54 61 62 2c 20 61 20 0a 20 20 2a 2a 20 77 72 iTab, a . ** wr
1aa0: 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ite-lock on the
1ab0: 73 63 68 65 6d 61 20 74 61 62 6c 65 2c 20 6f 72 schema table, or
1ac0: 20 28 69 66 20 74 68 65 20 63 6c 69 65 6e 74 20 (if the client
1ad0: 69 73 20 72 65 61 64 69 6e 67 29 20 61 0a 20 20 is reading) a.
1ae0: 2a 2a 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 ** read-lock on
1af0: 69 54 61 62 20 77 69 6c 6c 20 73 75 66 66 69 63 iTab will suffic
1b00: 65 2e 20 52 65 74 75 72 6e 20 31 20 69 66 20 61 e. Return 1 if a
1b10: 6e 79 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 ny of these are
1b20: 66 6f 75 6e 64 2e 20 20 2a 2f 0a 20 20 66 6f 72 found. */. for
1b30: 28 70 4c 6f 63 6b 3d 70 42 74 72 65 65 2d 3e 70 (pLock=pBtree->p
1b40: 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b Bt->pLock; pLock
1b50: 3b 20 70 4c 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e 70 ; pLock=pLock->p
1b60: 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 Next){. if( p
1b70: 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 42 Lock->pBtree==pB
1b80: 74 72 65 65 20 0a 20 20 20 20 20 26 26 20 28 70 tree . && (p
1b90: 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 Lock->iTable==iT
1ba0: 61 62 20 7c 7c 20 28 70 4c 6f 63 6b 2d 3e 65 4c ab || (pLock->eL
1bb0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 ock==WRITE_LOCK
1bc0: 26 26 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 && pLock->iTable
1bd0: 3d 3d 31 29 29 0a 20 20 20 20 20 26 26 20 70 4c ==1)). && pL
1be0: 6f 63 6b 2d 3e 65 4c 6f 63 6b 3e 3d 65 4c 6f 63 ock->eLock>=eLoc
1bf0: 6b 54 79 70 65 20 0a 20 20 20 20 29 7b 0a 20 20 kType . ){.
1c00: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 return 1;.
1c10: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 61 }. }.. /* Fa
1c20: 69 6c 65 64 20 74 6f 20 66 69 6e 64 20 74 68 65 iled to find the
1c30: 20 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e 20 required lock.
1c40: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d */. return 0;.}
1c50: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
1c60: 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 23 69 66 64 E_DEBUG */..#ifd
1c70: 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
1c80: 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 73 20 66 75 6e /*.**** This fun
1c90: 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 75 73 65 ction may be use
1ca0: 64 20 61 73 20 70 61 72 74 20 6f 66 20 61 73 73 d as part of ass
1cb0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
1cc0: 20 6f 6e 6c 79 2e 20 2a 2a 2a 2a 0a 2a 2a 0a 2a only. ****.**.*
1cd0: 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
1ce0: 20 69 74 20 77 6f 75 6c 64 20 62 65 20 69 6c 6c it would be ill
1cf0: 65 67 61 6c 20 66 6f 72 20 70 42 74 72 65 65 20 egal for pBtree
1d00: 74 6f 20 77 72 69 74 65 20 69 6e 74 6f 20 74 68 to write into th
1d10: 65 0a 2a 2a 20 74 61 62 6c 65 20 6f 72 20 69 6e e.** table or in
1d20: 64 65 78 20 72 6f 6f 74 65 64 20 61 74 20 69 52 dex rooted at iR
1d30: 6f 6f 74 20 62 65 63 61 75 73 65 20 6f 74 68 65 oot because othe
1d40: 72 20 73 68 61 72 65 64 20 63 6f 6e 6e 65 63 74 r shared connect
1d50: 69 6f 6e 73 20 61 72 65 0a 2a 2a 20 73 69 6d 75 ions are.** simu
1d60: 6c 74 61 6e 65 6f 75 73 6c 79 20 72 65 61 64 69 ltaneously readi
1d70: 6e 67 20 74 68 61 74 20 73 61 6d 65 20 74 61 62 ng that same tab
1d80: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 0a 2a 2a 0a le or index..**.
1d90: 2a 2a 20 49 74 20 69 73 20 69 6c 6c 65 67 61 6c ** It is illegal
1da0: 20 66 6f 72 20 70 42 74 72 65 65 20 74 6f 20 77 for pBtree to w
1db0: 72 69 74 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 rite if some oth
1dc0: 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 er Btree object
1dd0: 74 68 61 74 0a 2a 2a 20 73 68 61 72 65 73 20 74 that.** shares t
1de0: 68 65 20 73 61 6d 65 20 42 74 53 68 61 72 65 64 he same BtShared
1df0: 20 6f 62 6a 65 63 74 20 69 73 20 63 75 72 72 65 object is curre
1e00: 6e 74 6c 79 20 72 65 61 64 69 6e 67 20 6f 72 20 ntly reading or
1e10: 77 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 69 writing.** the i
1e20: 52 6f 6f 74 20 74 61 62 6c 65 2e 20 20 45 78 63 Root table. Exc
1e30: 65 70 74 2c 20 69 66 20 74 68 65 20 6f 74 68 65 ept, if the othe
1e40: 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 68 r Btree object h
1e50: 61 73 20 74 68 65 0a 2a 2a 20 72 65 61 64 2d 75 as the.** read-u
1e60: 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c 61 67 20 ncommitted flag
1e70: 73 65 74 2c 20 74 68 65 6e 20 69 74 20 69 73 20 set, then it is
1e80: 4f 4b 20 66 6f 72 20 74 68 65 20 6f 74 68 65 72 OK for the other
1e90: 20 6f 62 6a 65 63 74 20 74 6f 0a 2a 2a 20 68 61 object to.** ha
1ea0: 76 65 20 61 20 72 65 61 64 20 63 75 72 73 6f 72 ve a read cursor
1eb0: 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d ..**.** For exam
1ec0: 70 6c 65 2c 20 62 65 66 6f 72 65 20 77 72 69 74 ple, before writ
1ed0: 69 6e 67 20 74 6f 20 61 6e 79 20 70 61 72 74 20 ing to any part
1ee0: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 of the table or
1ef0: 69 6e 64 65 78 0a 2a 2a 20 72 6f 6f 74 65 64 20 index.** rooted
1f00: 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 6f at page iRoot, o
1f10: 6e 65 20 73 68 6f 75 6c 64 20 63 61 6c 6c 3a 0a ne should call:.
1f20: 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 28 **.** assert(
1f30: 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 !hasReadConflic
1f40: 74 73 28 70 42 74 72 65 65 2c 20 69 52 6f 6f 74 ts(pBtree, iRoot
1f50: 29 20 29 3b 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ) );.*/.static i
1f60: 6e 74 20 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 nt hasReadConfli
1f70: 63 74 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 cts(Btree *pBtre
1f80: 65 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 29 7b 0a e, Pgno iRoot){.
1f90: 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 BtCursor *p;.
1fa0: 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e 70 for(p=pBtree->p
1fb0: 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 Bt->pCursor; p;
1fc0: 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 p=p->pNext){.
1fd0: 20 69 66 28 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 if( p->pgnoRoot
1fe0: 3d 3d 69 52 6f 6f 74 20 0a 20 20 20 20 20 26 26 ==iRoot . &&
1ff0: 20 70 2d 3e 70 42 74 72 65 65 21 3d 70 42 74 72 p->pBtree!=pBtr
2000: 65 65 0a 20 20 20 20 20 26 26 20 30 3d 3d 28 70 ee. && 0==(p
2010: 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 6c ->pBtree->db->fl
2020: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 61 ags & SQLITE_Rea
2030: 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 0a 20 20 dUncommitted).
2040: 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 ){. retur
2050: 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 n 1;. }. }.
2060: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e return 0;.}.#en
2070: 64 69 66 20 20 20 20 2f 2a 20 23 69 66 64 65 66 dif /* #ifdef
2080: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a 2f SQLITE_DEBUG */
2090: 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 6f ../*.** Query to
20a0: 20 73 65 65 20 69 66 20 42 74 72 65 65 20 68 61 see if Btree ha
20b0: 6e 64 6c 65 20 70 20 6d 61 79 20 6f 62 74 61 69 ndle p may obtai
20c0: 6e 20 61 20 6c 6f 63 6b 20 6f 66 20 74 79 70 65 n a lock of type
20d0: 20 65 4c 6f 63 6b 20 0a 2a 2a 20 28 52 45 41 44 eLock .** (READ
20e0: 5f 4c 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f 4c _LOCK or WRITE_L
20f0: 4f 43 4b 29 20 6f 6e 20 74 68 65 20 74 61 62 6c OCK) on the tabl
2100: 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 e with root-page
2110: 20 69 54 61 62 2e 20 52 65 74 75 72 6e 0a 2a 2a iTab. Return.**
2120: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 SQLITE_OK if th
2130: 65 20 6c 6f 63 6b 20 6d 61 79 20 62 65 20 6f 62 e lock may be ob
2140: 74 61 69 6e 65 64 20 28 62 79 20 63 61 6c 6c 69 tained (by calli
2150: 6e 67 0a 2a 2a 20 73 65 74 53 68 61 72 65 64 43 ng.** setSharedC
2160: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 29 acheTableLock())
2170: 2c 20 6f 72 20 53 51 4c 49 54 45 5f 4c 4f 43 4b , or SQLITE_LOCK
2180: 45 44 20 69 66 20 6e 6f 74 2e 0a 2a 2f 0a 73 74 ED if not..*/.st
2190: 61 74 69 63 20 69 6e 74 20 71 75 65 72 79 53 68 atic int querySh
21a0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
21b0: 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 50 67 6e ck(Btree *p, Pgn
21c0: 6f 20 69 54 61 62 2c 20 75 38 20 65 4c 6f 63 6b o iTab, u8 eLock
21d0: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
21e0: 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 Bt = p->pBt;. B
21f0: 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 0a 20 tLock *pIter;..
2200: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2210: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 BtreeHoldsMutex(
2220: 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 p) );. assert(
2230: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
2240: 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 || eLock==WRITE
2250: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 _LOCK );. asser
2260: 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b 0a 20 t( p->db!=0 );.
2270: 20 61 73 73 65 72 74 28 20 21 28 70 2d 3e 64 62 assert( !(p->db
2280: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 52 ->flags&SQLITE_R
2290: 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 7c eadUncommitted)|
22a0: 7c 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f |eLock==WRITE_LO
22b0: 43 4b 7c 7c 69 54 61 62 3d 3d 31 20 29 3b 0a 20 CK||iTab==1 );.
22c0: 20 0a 20 20 2f 2a 20 49 66 20 72 65 71 75 65 73 . /* If reques
22d0: 74 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 ting a write-loc
22e0: 6b 2c 20 74 68 65 6e 20 74 68 65 20 42 74 72 65 k, then the Btre
22f0: 65 20 6d 75 73 74 20 68 61 76 65 20 61 6e 20 6f e must have an o
2300: 70 65 6e 20 77 72 69 74 65 0a 20 20 2a 2a 20 74 pen write. ** t
2310: 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 ransaction on th
2320: 69 73 20 66 69 6c 65 2e 20 41 6e 64 2c 20 6f 62 is file. And, ob
2330: 76 69 6f 75 73 6c 79 2c 20 66 6f 72 20 74 68 69 viously, for thi
2340: 73 20 74 6f 20 62 65 20 73 6f 20 74 68 65 72 65 s to be so there
2350: 20 0a 20 20 2a 2a 20 6d 75 73 74 20 62 65 20 61 . ** must be a
2360: 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61 n open write tra
2370: 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65 20 nsaction on the
2380: 66 69 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20 2a file itself.. *
2390: 2f 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 /. assert( eLoc
23a0: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
23b0: 28 70 3d 3d 70 42 74 2d 3e 70 57 72 69 74 65 72 (p==pBt->pWriter
23c0: 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d && p->inTrans==
23d0: 54 52 41 4e 53 5f 57 52 49 54 45 29 20 29 3b 0a TRANS_WRITE) );.
23e0: 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d assert( eLock=
23f0: 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 42 =READ_LOCK || pB
2400: 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
2410: 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 3b ==TRANS_WRITE );
2420: 0a 20 20 0a 20 20 2f 2a 20 54 68 69 73 20 72 6f . . /* This ro
2430: 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
2440: 20 69 66 20 74 68 65 20 73 68 61 72 65 64 2d 63 if the shared-c
2450: 61 63 68 65 20 69 73 20 6e 6f 74 20 65 6e 61 62 ache is not enab
2460: 6c 65 64 20 2a 2f 0a 20 20 69 66 28 20 21 70 2d led */. if( !p-
2470: 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 >sharable ){.
2480: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2490: 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 K;. }.. /* If
24a0: 73 6f 6d 65 20 6f 74 68 65 72 20 63 6f 6e 6e 65 some other conne
24b0: 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 6e 67 ction is holding
24c0: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f an exclusive lo
24d0: 63 6b 2c 20 74 68 65 0a 20 20 2a 2a 20 72 65 71 ck, the. ** req
24e0: 75 65 73 74 65 64 20 6c 6f 63 6b 20 6d 61 79 20 uested lock may
24f0: 6e 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 2e not be obtained.
2500: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 42 74 2d . */. if( pBt-
2510: 3e 70 57 72 69 74 65 72 21 3d 70 20 26 26 20 28 >pWriter!=p && (
2520: 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
2530: 42 54 53 5f 45 58 43 4c 55 53 49 56 45 29 21 3d BTS_EXCLUSIVE)!=
2540: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 ){. sqlite3
2550: 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 ConnectionBlocke
2560: 64 28 70 2d 3e 64 62 2c 20 70 42 74 2d 3e 70 57 d(p->db, pBt->pW
2570: 72 69 74 65 72 2d 3e 64 62 29 3b 0a 20 20 20 20 riter->db);.
2580: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f return SQLITE_LO
2590: 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 CKED_SHAREDCACHE
25a0: 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 70 49 74 ;. }.. for(pIt
25b0: 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 er=pBt->pLock; p
25c0: 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 74 65 Iter; pIter=pIte
25d0: 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 2f r->pNext){. /
25e0: 2a 20 54 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 * The condition
25f0: 28 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 (pIter->eLock!=e
2600: 4c 6f 63 6b 29 20 69 6e 20 74 68 65 20 66 6f 6c Lock) in the fol
2610: 6c 6f 77 69 6e 67 20 69 66 28 2e 2e 2e 29 20 0a lowing if(...) .
2620: 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 ** statement
2630: 20 69 73 20 61 20 73 69 6d 70 6c 69 66 69 63 61 is a simplifica
2640: 74 69 6f 6e 20 6f 66 3a 0a 20 20 20 20 2a 2a 0a tion of:. **.
2650: 20 20 20 20 2a 2a 20 20 20 28 65 4c 6f 63 6b 3d ** (eLock=
2660: 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 7c 7c 20 70 =WRITE_LOCK || p
2670: 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 49 Iter->eLock==WRI
2680: 54 45 5f 4c 4f 43 4b 29 0a 20 20 20 20 2a 2a 0a TE_LOCK). **.
2690: 20 20 20 20 2a 2a 20 73 69 6e 63 65 20 77 65 20 ** since we
26a0: 6b 6e 6f 77 20 74 68 61 74 20 69 66 20 65 4c 6f know that if eLo
26b0: 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 2c 20 ck==WRITE_LOCK,
26c0: 74 68 65 6e 20 6e 6f 20 6f 74 68 65 72 20 63 6f then no other co
26d0: 6e 6e 65 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 nnection. **
26e0: 6d 61 79 20 68 6f 6c 64 20 61 20 57 52 49 54 45 may hold a WRITE
26f0: 5f 4c 4f 43 4b 20 6f 6e 20 61 6e 79 20 74 61 62 _LOCK on any tab
2700: 6c 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20 le in this file
2710: 28 73 69 6e 63 65 20 74 68 65 72 65 20 63 61 6e (since there can
2720: 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 62 65 20 . ** only be
2730: 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65 72 29 a single writer)
2740: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 .. */. ass
2750: 65 72 74 28 20 70 49 74 65 72 2d 3e 65 4c 6f 63 ert( pIter->eLoc
2760: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
2770: 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 pIter->eLock==WR
2780: 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 ITE_LOCK );.
2790: 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 assert( eLock==R
27a0: 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 EAD_LOCK || pIte
27b0: 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 7c 7c 20 r->pBtree==p ||
27c0: 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 pIter->eLock==RE
27d0: 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 66 AD_LOCK);. if
27e0: 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 21 ( pIter->pBtree!
27f0: 3d 70 20 26 26 20 70 49 74 65 72 2d 3e 69 54 61 =p && pIter->iTa
2800: 62 6c 65 3d 3d 69 54 61 62 20 26 26 20 70 49 74 ble==iTab && pIt
2810: 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 4c 6f 63 6b er->eLock!=eLock
2820: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
2830: 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 3ConnectionBlock
2840: 65 64 28 70 2d 3e 64 62 2c 20 70 49 74 65 72 2d ed(p->db, pIter-
2850: 3e 70 42 74 72 65 65 2d 3e 64 62 29 3b 0a 20 20 >pBtree->db);.
2860: 20 20 20 20 69 66 28 20 65 4c 6f 63 6b 3d 3d 57 if( eLock==W
2870: 52 49 54 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 RITE_LOCK ){.
2880: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 3d 3d assert( p==
2890: 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 3b 0a pBt->pWriter );.
28a0: 20 20 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 pBt->bts
28b0: 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 45 4e Flags |= BTS_PEN
28c0: 44 49 4e 47 3b 0a 20 20 20 20 20 20 7d 0a 20 20 DING;. }.
28d0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
28e0: 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 E_LOCKED_SHAREDC
28f0: 41 43 48 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a ACHE;. }. }.
2900: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2910: 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 OK;.}.#endif /*
2920: 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 !SQLITE_OMIT_SHA
2930: 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 69 RED_CACHE */..#i
2940: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
2950: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 2f T_SHARED_CACHE./
2960: 2a 0a 2a 2a 20 41 64 64 20 61 20 6c 6f 63 6b 20 *.** Add a lock
2970: 6f 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 on the table wit
2980: 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 h root-page iTab
2990: 6c 65 20 74 6f 20 74 68 65 20 73 68 61 72 65 64 le to the shared
29a0: 2d 62 74 72 65 65 20 75 73 65 64 0a 2a 2a 20 62 -btree used.** b
29b0: 79 20 42 74 72 65 65 20 68 61 6e 64 6c 65 20 70 y Btree handle p
29c0: 2e 20 50 61 72 61 6d 65 74 65 72 20 65 4c 6f 63 . Parameter eLoc
29d0: 6b 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 k must be either
29e0: 20 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 0a 2a READ_LOCK or .*
29f0: 2a 20 57 52 49 54 45 5f 4c 4f 43 4b 2e 0a 2a 2a * WRITE_LOCK..**
2a00: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
2a10: 6e 20 61 73 73 75 6d 65 73 20 74 68 65 20 66 6f n assumes the fo
2a20: 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 llowing:.**.**
2a30: 20 28 61 29 20 54 68 65 20 73 70 65 63 69 66 69 (a) The specifi
2a40: 65 64 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 ed Btree object
2a50: 70 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20 74 p is connected t
2a60: 6f 20 61 20 73 68 61 72 61 62 6c 65 0a 2a 2a 20 o a sharable.**
2a70: 20 20 20 20 20 20 64 61 74 61 62 61 73 65 20 28 database (
2a80: 6f 6e 65 20 77 69 74 68 20 74 68 65 20 42 74 53 one with the BtS
2a90: 68 61 72 65 64 2e 73 68 61 72 61 62 6c 65 20 66 hared.sharable f
2aa0: 6c 61 67 20 73 65 74 29 2c 20 61 6e 64 0a 2a 2a lag set), and.**
2ab0: 0a 2a 2a 20 20 20 28 62 29 20 4e 6f 20 6f 74 68 .** (b) No oth
2ac0: 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 73 er Btree objects
2ad0: 20 68 6f 6c 64 20 61 20 6c 6f 63 6b 20 74 68 61 hold a lock tha
2ae0: 74 20 63 6f 6e 66 6c 69 63 74 73 0a 2a 2a 20 20 t conflicts.**
2af0: 20 20 20 20 20 77 69 74 68 20 74 68 65 20 72 65 with the re
2b00: 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 28 69 2e quested lock (i.
2b10: 65 2e 20 71 75 65 72 79 53 68 61 72 65 64 43 61 e. querySharedCa
2b20: 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 20 68 cheTableLock() h
2b30: 61 73 0a 2a 2a 20 20 20 20 20 20 20 61 6c 72 65 as.** alre
2b40: 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 ady been called
2b50: 61 6e 64 20 72 65 74 75 72 6e 65 64 20 53 51 4c and returned SQL
2b60: 49 54 45 5f 4f 4b 29 2e 0a 2a 2a 0a 2a 2a 20 53 ITE_OK)..**.** S
2b70: 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
2b80: 72 6e 65 64 20 69 66 20 74 68 65 20 6c 6f 63 6b rned if the lock
2b90: 20 69 73 20 61 64 64 65 64 20 73 75 63 63 65 73 is added succes
2ba0: 73 66 75 6c 6c 79 2e 20 53 51 4c 49 54 45 5f 4e sfully. SQLITE_N
2bb0: 4f 4d 45 4d 20 0a 2a 2a 20 69 73 20 72 65 74 75 OMEM .** is retu
2bc0: 72 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 rned if a malloc
2bd0: 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2e 0a attempt fails..
2be0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 */.static int se
2bf0: 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c tSharedCacheTabl
2c00: 65 4c 6f 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 eLock(Btree *p,
2c10: 50 67 6e 6f 20 69 54 61 62 6c 65 2c 20 75 38 20 Pgno iTable, u8
2c20: 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 68 61 72 eLock){. BtShar
2c30: 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
2c40: 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 ;. BtLock *pLoc
2c50: 6b 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 k = 0;. BtLock
2c60: 2a 70 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 *pIter;.. asser
2c70: 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 t( sqlite3BtreeH
2c80: 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a oldsMutex(p) );.
2c90: 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d assert( eLock=
2ca0: 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c =READ_LOCK || eL
2cb0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 ock==WRITE_LOCK
2cc0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
2cd0: 64 62 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 41 db!=0 );.. /* A
2ce0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 connection with
2cf0: 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d 6d the read-uncomm
2d00: 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 20 77 itted flag set w
2d10: 69 6c 6c 20 6e 65 76 65 72 20 74 72 79 20 74 6f ill never try to
2d20: 0a 20 20 2a 2a 20 6f 62 74 61 69 6e 20 61 20 72 . ** obtain a r
2d30: 65 61 64 2d 6c 6f 63 6b 20 75 73 69 6e 67 20 74 ead-lock using t
2d40: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 his function. Th
2d50: 65 20 6f 6e 6c 79 20 72 65 61 64 2d 6c 6f 63 6b e only read-lock
2d60: 20 6f 62 74 61 69 6e 65 64 0a 20 20 2a 2a 20 62 obtained. ** b
2d70: 79 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 y a connection i
2d80: 6e 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 n read-uncommitt
2d90: 65 64 20 6d 6f 64 65 20 69 73 20 6f 6e 20 74 68 ed mode is on th
2da0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 e sqlite_master
2db0: 0a 20 20 2a 2a 20 74 61 62 6c 65 2c 20 61 6e 64 . ** table, and
2dc0: 20 74 68 61 74 20 6c 6f 63 6b 20 69 73 20 6f 62 that lock is ob
2dd0: 74 61 69 6e 65 64 20 69 6e 20 42 74 72 65 65 42 tained in BtreeB
2de0: 65 67 69 6e 54 72 61 6e 73 28 29 2e 20 20 2a 2f eginTrans(). */
2df0: 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 28 70 . assert( 0==(p
2e00: 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 ->db->flags&SQLI
2e10: 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 74 74 TE_ReadUncommitt
2e20: 65 64 29 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 ed) || eLock==WR
2e30: 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f ITE_LOCK );.. /
2e40: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
2e50: 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 should only be c
2e60: 61 6c 6c 65 64 20 6f 6e 20 61 20 73 68 61 72 61 alled on a shara
2e70: 62 6c 65 20 62 2d 74 72 65 65 20 61 66 74 65 72 ble b-tree after
2e80: 20 69 74 20 0a 20 20 2a 2a 20 68 61 73 20 62 65 it . ** has be
2e90: 65 6e 20 64 65 74 65 72 6d 69 6e 65 64 20 74 68 en determined th
2ea0: 61 74 20 6e 6f 20 6f 74 68 65 72 20 62 2d 74 72 at no other b-tr
2eb0: 65 65 20 68 6f 6c 64 73 20 61 20 63 6f 6e 66 6c ee holds a confl
2ec0: 69 63 74 69 6e 67 20 6c 6f 63 6b 2e 20 20 2a 2f icting lock. */
2ed0: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 73 68 . assert( p->sh
2ee0: 61 72 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 65 arable );. asse
2ef0: 72 74 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 71 rt( SQLITE_OK==q
2f00: 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 54 uerySharedCacheT
2f10: 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 62 ableLock(p, iTab
2f20: 6c 65 2c 20 65 4c 6f 63 6b 29 20 29 3b 0a 0a 20 le, eLock) );..
2f30: 20 2f 2a 20 46 69 72 73 74 20 73 65 61 72 63 68 /* First search
2f40: 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 61 6e the list for an
2f50: 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 6b 20 6f existing lock o
2f60: 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a 2f n this table. */
2f70: 0a 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 . for(pIter=pBt
2f80: 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 ->pLock; pIter;
2f90: 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 pIter=pIter->pNe
2fa0: 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49 74 xt){. if( pIt
2fb0: 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 62 er->iTable==iTab
2fc0: 6c 65 20 26 26 20 70 49 74 65 72 2d 3e 70 42 74 le && pIter->pBt
2fd0: 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 20 ree==p ){.
2fe0: 70 4c 6f 63 6b 20 3d 20 70 49 74 65 72 3b 0a 20 pLock = pIter;.
2ff0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
3000: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 }. }.. /* If t
3010: 68 65 20 61 62 6f 76 65 20 73 65 61 72 63 68 20 he above search
3020: 64 69 64 20 6e 6f 74 20 66 69 6e 64 20 61 20 42 did not find a B
3030: 74 4c 6f 63 6b 20 73 74 72 75 63 74 20 61 73 73 tLock struct ass
3040: 6f 63 69 61 74 69 6e 67 20 42 74 72 65 65 20 70 ociating Btree p
3050: 0a 20 20 2a 2a 20 77 69 74 68 20 74 61 62 6c 65 . ** with table
3060: 20 69 54 61 62 6c 65 2c 20 61 6c 6c 6f 63 61 74 iTable, allocat
3070: 65 20 6f 6e 65 20 61 6e 64 20 6c 69 6e 6b 20 69 e one and link i
3080: 74 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 2e t into the list.
3090: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 4c 6f . */. if( !pLo
30a0: 63 6b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b 20 ck ){. pLock
30b0: 3d 20 28 42 74 4c 6f 63 6b 20 2a 29 73 71 6c 69 = (BtLock *)sqli
30c0: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 te3MallocZero(si
30d0: 7a 65 6f 66 28 42 74 4c 6f 63 6b 29 29 3b 0a 20 zeof(BtLock));.
30e0: 20 20 20 69 66 28 20 21 70 4c 6f 63 6b 20 29 7b if( !pLock ){
30f0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
3100: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
3110: 0a 20 20 20 20 7d 0a 20 20 20 20 70 4c 6f 63 6b . }. pLock
3120: 2d 3e 69 54 61 62 6c 65 20 3d 20 69 54 61 62 6c ->iTable = iTabl
3130: 65 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 70 42 e;. pLock->pB
3140: 74 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 70 4c tree = p;. pL
3150: 6f 63 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 42 74 ock->pNext = pBt
3160: 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 20 70 42 74 ->pLock;. pBt
3170: 2d 3e 70 4c 6f 63 6b 20 3d 20 70 4c 6f 63 6b 3b ->pLock = pLock;
3180: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 74 20 74 . }.. /* Set t
3190: 68 65 20 42 74 4c 6f 63 6b 2e 65 4c 6f 63 6b 20 he BtLock.eLock
31a0: 76 61 72 69 61 62 6c 65 20 74 6f 20 74 68 65 20 variable to the
31b0: 6d 61 78 69 6d 75 6d 20 6f 66 20 74 68 65 20 63 maximum of the c
31c0: 75 72 72 65 6e 74 20 6c 6f 63 6b 0a 20 20 2a 2a urrent lock. **
31d0: 20 61 6e 64 20 74 68 65 20 72 65 71 75 65 73 74 and the request
31e0: 65 64 20 6c 6f 63 6b 2e 20 54 68 69 73 20 6d 65 ed lock. This me
31f0: 61 6e 73 20 69 66 20 61 20 77 72 69 74 65 2d 6c ans if a write-l
3200: 6f 63 6b 20 77 61 73 20 61 6c 72 65 61 64 79 20 ock was already
3210: 68 65 6c 64 0a 20 20 2a 2a 20 61 6e 64 20 61 20 held. ** and a
3220: 72 65 61 64 2d 6c 6f 63 6b 20 72 65 71 75 65 73 read-lock reques
3230: 74 65 64 2c 20 77 65 20 64 6f 6e 27 74 20 69 6e ted, we don't in
3240: 63 6f 72 72 65 63 74 6c 79 20 64 6f 77 6e 67 72 correctly downgr
3250: 61 64 65 20 74 68 65 20 6c 6f 63 6b 2e 0a 20 20 ade the lock..
3260: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 57 52 49 */. assert( WRI
3270: 54 45 5f 4c 4f 43 4b 3e 52 45 41 44 5f 4c 4f 43 TE_LOCK>READ_LOC
3280: 4b 20 29 3b 0a 20 20 69 66 28 20 65 4c 6f 63 6b K );. if( eLock
3290: 3e 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 29 7b >pLock->eLock ){
32a0: 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 . pLock->eLoc
32b0: 6b 20 3d 20 65 4c 6f 63 6b 3b 0a 20 20 7d 0a 0a k = eLock;. }..
32c0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
32d0: 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 OK;.}.#endif /*
32e0: 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 !SQLITE_OMIT_SHA
32f0: 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 69 RED_CACHE */..#i
3300: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
3310: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 2f T_SHARED_CACHE./
3320: 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 6c 6c *.** Release all
3330: 20 74 68 65 20 74 61 62 6c 65 20 6c 6f 63 6b 73 the table locks
3340: 20 28 6c 6f 63 6b 73 20 6f 62 74 61 69 6e 65 64 (locks obtained
3350: 20 76 69 61 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a via calls to.**
3360: 20 74 68 65 20 73 65 74 53 68 61 72 65 64 43 61 the setSharedCa
3370: 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 20 70 cheTableLock() p
3380: 72 6f 63 65 64 75 72 65 29 20 68 65 6c 64 20 62 rocedure) held b
3390: 79 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 70 y Btree object p
33a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
33b0: 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 20 74 68 ction assumes th
33c0: 61 74 20 42 74 72 65 65 20 70 20 68 61 73 20 61 at Btree p has a
33d0: 6e 20 6f 70 65 6e 20 72 65 61 64 20 6f 72 20 77 n open read or w
33e0: 72 69 74 65 20 0a 2a 2a 20 74 72 61 6e 73 61 63 rite .** transac
33f0: 74 69 6f 6e 2e 20 49 66 20 69 74 20 64 6f 65 73 tion. If it does
3400: 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 20 42 not, then the B
3410: 54 53 5f 50 45 4e 44 49 4e 47 20 66 6c 61 67 0a TS_PENDING flag.
3420: 2a 2a 20 6d 61 79 20 62 65 20 69 6e 63 6f 72 72 ** may be incorr
3430: 65 63 74 6c 79 20 63 6c 65 61 72 65 64 2e 0a 2a ectly cleared..*
3440: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6c /.static void cl
3450: 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 earAllSharedCach
3460: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 74 72 65 eTableLocks(Btre
3470: 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
3480: 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
3490: 0a 20 20 42 74 4c 6f 63 6b 20 2a 2a 70 70 49 74 . BtLock **ppIt
34a0: 65 72 20 3d 20 26 70 42 74 2d 3e 70 4c 6f 63 6b er = &pBt->pLock
34b0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
34c0: 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 ite3BtreeHoldsMu
34d0: 74 65 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 tex(p) );. asse
34e0: 72 74 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 rt( p->sharable
34f0: 7c 7c 20 30 3d 3d 2a 70 70 49 74 65 72 20 29 3b || 0==*ppIter );
3500: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e . assert( p->in
3510: 54 72 61 6e 73 3e 30 20 29 3b 0a 0a 20 20 77 68 Trans>0 );.. wh
3520: 69 6c 65 28 20 2a 70 70 49 74 65 72 20 29 7b 0a ile( *ppIter ){.
3530: 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 BtLock *pLoc
3540: 6b 20 3d 20 2a 70 70 49 74 65 72 3b 0a 20 20 20 k = *ppIter;.
3550: 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e 62 assert( (pBt->b
3560: 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 45 58 tsFlags & BTS_EX
3570: 43 4c 55 53 49 56 45 29 3d 3d 30 20 7c 7c 20 70 CLUSIVE)==0 || p
3580: 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 4c 6f Bt->pWriter==pLo
3590: 63 6b 2d 3e 70 42 74 72 65 65 20 29 3b 0a 20 20 ck->pBtree );.
35a0: 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d assert( pLock-
35b0: 3e 70 42 74 72 65 65 2d 3e 69 6e 54 72 61 6e 73 >pBtree->inTrans
35c0: 3e 3d 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 29 >=pLock->eLock )
35d0: 3b 0a 20 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d ;. if( pLock-
35e0: 3e 70 42 74 72 65 65 3d 3d 70 20 29 7b 0a 20 20 >pBtree==p ){.
35f0: 20 20 20 20 2a 70 70 49 74 65 72 20 3d 20 70 4c *ppIter = pL
3600: 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 ock->pNext;.
3610: 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d assert( pLock-
3620: 3e 69 54 61 62 6c 65 21 3d 31 20 7c 7c 20 70 4c >iTable!=1 || pL
3630: 6f 63 6b 3d 3d 26 70 2d 3e 6c 6f 63 6b 20 29 3b ock==&p->lock );
3640: 0a 20 20 20 20 20 20 69 66 28 20 70 4c 6f 63 6b . if( pLock
3650: 2d 3e 69 54 61 62 6c 65 21 3d 31 20 29 7b 0a 20 ->iTable!=1 ){.
3660: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
3670: 72 65 65 28 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 ree(pLock);.
3680: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
3690: 20 20 20 20 20 70 70 49 74 65 72 20 3d 20 26 70 ppIter = &p
36a0: 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 Lock->pNext;.
36b0: 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 }. }.. assert
36c0: 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 ( (pBt->btsFlags
36d0: 20 26 20 42 54 53 5f 50 45 4e 44 49 4e 47 29 3d & BTS_PENDING)=
36e0: 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 57 72 69 74 =0 || pBt->pWrit
36f0: 65 72 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d er );. if( pBt-
3700: 3e 70 57 72 69 74 65 72 3d 3d 70 20 29 7b 0a 20 >pWriter==p ){.
3710: 20 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 pBt->pWriter
3720: 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d 3e 62 74 = 0;. pBt->bt
3730: 73 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 53 5f sFlags &= ~(BTS_
3740: 45 58 43 4c 55 53 49 56 45 7c 42 54 53 5f 50 45 EXCLUSIVE|BTS_PE
3750: 4e 44 49 4e 47 29 3b 0a 20 20 7d 65 6c 73 65 20 NDING);. }else
3760: 69 66 28 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 if( pBt->nTransa
3770: 63 74 69 6f 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 ction==2 ){.
3780: 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e /* This function
3790: 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 is called when
37a0: 42 74 72 65 65 20 70 20 69 73 20 63 6f 6e 63 6c Btree p is concl
37b0: 75 64 69 6e 67 20 69 74 73 20 0a 20 20 20 20 2a uding its . *
37c0: 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 * transaction. I
37d0: 66 20 74 68 65 72 65 20 63 75 72 72 65 6e 74 6c f there currentl
37e0: 79 20 65 78 69 73 74 73 20 61 20 77 72 69 74 65 y exists a write
37f0: 72 2c 20 61 6e 64 20 70 20 69 73 20 6e 6f 74 0a r, and p is not.
3800: 20 20 20 20 2a 2a 20 74 68 61 74 20 77 72 69 74 ** that writ
3810: 65 72 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d er, then the num
3820: 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 68 65 6c ber of locks hel
3830: 64 20 62 79 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 d by connections
3840: 20 6f 74 68 65 72 0a 20 20 20 20 2a 2a 20 74 68 other. ** th
3850: 61 6e 20 74 68 65 20 77 72 69 74 65 72 20 6d 75 an the writer mu
3860: 73 74 20 62 65 20 61 62 6f 75 74 20 74 6f 20 64 st be about to d
3870: 72 6f 70 20 74 6f 20 7a 65 72 6f 2e 20 49 6e 20 rop to zero. In
3880: 74 68 69 73 20 63 61 73 65 0a 20 20 20 20 2a 2a this case. **
3890: 20 73 65 74 20 74 68 65 20 42 54 53 5f 50 45 4e set the BTS_PEN
38a0: 44 49 4e 47 20 66 6c 61 67 20 74 6f 20 30 2e 0a DING flag to 0..
38b0: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 **. ** If
38c0: 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 63 75 there is not cu
38d0: 72 72 65 6e 74 6c 79 20 61 20 77 72 69 74 65 72 rrently a writer
38e0: 2c 20 74 68 65 6e 20 42 54 53 5f 50 45 4e 44 49 , then BTS_PENDI
38f0: 4e 47 20 6d 75 73 74 0a 20 20 20 20 2a 2a 20 62 NG must. ** b
3900: 65 20 7a 65 72 6f 20 61 6c 72 65 61 64 79 2e 20 e zero already.
3910: 53 6f 20 74 68 69 73 20 6e 65 78 74 20 6c 69 6e So this next lin
3920: 65 20 69 73 20 68 61 72 6d 6c 65 73 73 20 69 6e e is harmless in
3930: 20 74 68 61 74 20 63 61 73 65 2e 0a 20 20 20 20 that case..
3940: 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 */. pBt->btsF
3950: 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f 50 45 4e lags &= ~BTS_PEN
3960: 44 49 4e 47 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a DING;. }.}../*.
3970: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
3980: 20 63 68 61 6e 67 65 73 20 61 6c 6c 20 77 72 69 changes all wri
3990: 74 65 2d 6c 6f 63 6b 73 20 68 65 6c 64 20 62 79 te-locks held by
39a0: 20 42 74 72 65 65 20 70 20 69 6e 74 6f 20 72 65 Btree p into re
39b0: 61 64 2d 6c 6f 63 6b 73 2e 0a 2a 2f 0a 73 74 61 ad-locks..*/.sta
39c0: 74 69 63 20 76 6f 69 64 20 64 6f 77 6e 67 72 61 tic void downgra
39d0: 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 deAllSharedCache
39e0: 54 61 62 6c 65 4c 6f 63 6b 73 28 42 74 72 65 65 TableLocks(Btree
39f0: 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 *p){. BtShared
3a00: 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
3a10: 20 20 69 66 28 20 70 42 74 2d 3e 70 57 72 69 74 if( pBt->pWrit
3a20: 65 72 3d 3d 70 20 29 7b 0a 20 20 20 20 42 74 4c er==p ){. BtL
3a30: 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a 20 20 20 20 ock *pLock;.
3a40: 70 42 74 2d 3e 70 57 72 69 74 65 72 20 3d 20 30 pBt->pWriter = 0
3a50: 3b 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c ;. pBt->btsFl
3a60: 61 67 73 20 26 3d 20 7e 28 42 54 53 5f 45 58 43 ags &= ~(BTS_EXC
3a70: 4c 55 53 49 56 45 7c 42 54 53 5f 50 45 4e 44 49 LUSIVE|BTS_PENDI
3a80: 4e 47 29 3b 0a 20 20 20 20 66 6f 72 28 70 4c 6f NG);. for(pLo
3a90: 63 6b 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 ck=pBt->pLock; p
3aa0: 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d 70 4c 6f 63 Lock; pLock=pLoc
3ab0: 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 k->pNext){.
3ac0: 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d 3e assert( pLock->
3ad0: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
3ae0: 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 || pLock->pBtre
3af0: 65 3d 3d 70 20 29 3b 0a 20 20 20 20 20 20 70 4c e==p );. pL
3b00: 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 52 45 41 ock->eLock = REA
3b10: 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d 0a 20 20 D_LOCK;. }.
3b20: 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 }.}..#endif /* S
3b30: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
3b40: 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 73 74 61 74 D_CACHE */..stat
3b50: 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 50 ic void releaseP
3b60: 61 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 age(MemPage *pPa
3b70: 67 65 29 3b 20 20 2f 2a 20 46 6f 72 77 61 72 64 ge); /* Forward
3b80: 20 72 65 66 65 72 65 6e 63 65 20 2a 2f 0a 0a 2f reference */../
3b90: 2a 0a 2a 2a 2a 2a 2a 20 54 68 69 73 20 72 6f 75 *.***** This rou
3ba0: 74 69 6e 65 20 69 73 20 75 73 65 64 20 69 6e 73 tine is used ins
3bb0: 69 64 65 20 6f 66 20 61 73 73 65 72 74 28 29 20 ide of assert()
3bc0: 6f 6e 6c 79 20 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 only ****.**.**
3bd0: 56 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 Verify that the
3be0: 63 75 72 73 6f 72 20 68 6f 6c 64 73 20 74 68 65 cursor holds the
3bf0: 20 6d 75 74 65 78 20 6f 6e 20 69 74 73 20 42 74 mutex on its Bt
3c00: 53 68 61 72 65 64 0a 2a 2f 0a 23 69 66 64 65 66 Shared.*/.#ifdef
3c10: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 73 74 SQLITE_DEBUG.st
3c20: 61 74 69 63 20 69 6e 74 20 63 75 72 73 6f 72 48 atic int cursorH
3c30: 6f 6c 64 73 4d 75 74 65 78 28 42 74 43 75 72 73 oldsMutex(BtCurs
3c40: 6f 72 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e or *p){. return
3c50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
3c60: 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 eld(p->pBt->mute
3c70: 78 29 3b 0a 7d 0a 0a 2f 2a 20 56 65 72 69 66 79 x);.}../* Verify
3c80: 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 that the cursor
3c90: 20 61 6e 64 20 74 68 65 20 42 74 53 68 61 72 65 and the BtShare
3ca0: 64 20 61 67 72 65 65 20 61 62 6f 75 74 20 77 68 d agree about wh
3cb0: 61 74 20 69 73 20 74 68 65 20 63 75 72 72 65 6e at is the curren
3cc0: 74 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f t.** database co
3cd0: 6e 6e 65 74 69 6f 6e 2e 20 54 68 69 73 20 69 73 nnetion. This is
3ce0: 20 69 6d 70 6f 72 74 61 6e 74 20 69 6e 20 73 68 important in sh
3cf0: 61 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 65 2e ared-cache mode.
3d00: 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 If the database
3d10: 20 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 .** connection
3d20: 70 6f 69 6e 74 65 72 73 20 67 65 74 20 6f 75 74 pointers get out
3d30: 2d 6f 66 2d 73 79 6e 63 2c 20 69 74 20 69 73 20 -of-sync, it is
3d40: 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 72 6f 75 possible for rou
3d50: 74 69 6e 65 73 20 6c 69 6b 65 0a 2a 2a 20 62 74 tines like.** bt
3d60: 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 74 6f reeInitPage() to
3d70: 20 72 65 66 65 72 65 6e 63 65 20 61 6e 20 73 74 reference an st
3d80: 61 6c 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 ale connection p
3d90: 6f 69 6e 74 65 72 20 74 68 61 74 20 72 65 66 65 ointer that refe
3da0: 72 65 6e 63 65 73 20 61 0a 2a 2a 20 61 20 63 6f rences a.** a co
3db0: 6e 6e 65 63 74 69 6f 6e 20 74 68 61 74 20 68 61 nnection that ha
3dc0: 73 20 61 6c 72 65 61 64 79 20 63 6c 6f 73 65 64 s already closed
3dd0: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
3de0: 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 61 is used inside a
3df0: 73 73 65 72 74 28 29 0a 2a 2a 20 73 74 61 74 65 ssert().** state
3e00: 6d 65 6e 74 73 20 6f 6e 6c 79 20 61 6e 64 20 66 ments only and f
3e10: 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 20 6f or the purpose o
3e20: 66 20 64 6f 75 62 6c 65 2d 63 68 65 63 6b 69 6e f double-checkin
3e30: 67 20 74 68 61 74 20 74 68 65 20 62 74 72 65 65 g that the btree
3e40: 20 63 6f 64 65 0a 2a 2a 20 64 6f 65 73 20 6b 65 code.** does ke
3e50: 65 70 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ep the database
3e60: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 connection point
3e70: 65 72 73 20 75 70 2d 74 6f 2d 64 61 74 65 2e 0a ers up-to-date..
3e80: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 75 */.static int cu
3e90: 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 rsorOwnsBtShared
3ea0: 28 42 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 (BtCursor *p){.
3eb0: 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
3ec0: 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a oldsMutex(p) );.
3ed0: 20 20 72 65 74 75 72 6e 20 28 70 2d 3e 70 42 74 return (p->pBt
3ee0: 72 65 65 2d 3e 64 62 3d 3d 70 2d 3e 70 42 74 2d ree->db==p->pBt-
3ef0: 3e 64 62 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a >db);.}.#endif..
3f00: 2f 2a 0a 2a 2a 20 49 6e 76 61 6c 69 64 61 74 65 /*.** Invalidate
3f10: 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 61 the overflow ca
3f20: 63 68 65 20 6f 66 20 74 68 65 20 63 75 72 73 6f che of the curso
3f30: 72 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 r passed as the
3f40: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a first argument..
3f50: 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 72 65 64 ** on the shared
3f60: 20 62 74 72 65 65 20 73 74 72 75 63 74 75 72 65 btree structure
3f70: 20 70 42 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 pBt..*/.#define
3f80: 20 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 66 invalidateOverf
3f90: 6c 6f 77 43 61 63 68 65 28 70 43 75 72 29 20 28 lowCache(pCur) (
3fa0: 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
3fb0: 3d 20 7e 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 = ~BTCF_ValidOvf
3fc0: 6c 29 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 61 6c 69 l)../*.** Invali
3fd0: 64 61 74 65 20 74 68 65 20 6f 76 65 72 66 6c 6f date the overflo
3fe0: 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 w page-list cach
3ff0: 65 20 66 6f 72 20 61 6c 6c 20 63 75 72 73 6f 72 e for all cursor
4000: 73 20 6f 70 65 6e 65 64 0a 2a 2a 20 6f 6e 20 74 s opened.** on t
4010: 68 65 20 73 68 61 72 65 64 20 62 74 72 65 65 20 he shared btree
4020: 73 74 72 75 63 74 75 72 65 20 70 42 74 2e 0a 2a structure pBt..*
4030: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 6e /.static void in
4040: 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 validateAllOverf
4050: 6c 6f 77 43 61 63 68 65 28 42 74 53 68 61 72 65 lowCache(BtShare
4060: 64 20 2a 70 42 74 29 7b 0a 20 20 42 74 43 75 72 d *pBt){. BtCur
4070: 73 6f 72 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 sor *p;. assert
4080: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
4090: 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
40a0: 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 2d );. for(p=pBt-
40b0: 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 >pCursor; p; p=p
40c0: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 6e ->pNext){. in
40d0: 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c 6f 77 validateOverflow
40e0: 43 61 63 68 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a Cache(p);. }.}.
40f0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
4100: 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 2f 2a OMIT_INCRBLOB./*
4110: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
4120: 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 65 66 6f n is called befo
4130: 72 65 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 re modifying the
4140: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 74 contents of a t
4150: 61 62 6c 65 0a 2a 2a 20 74 6f 20 69 6e 76 61 6c able.** to inval
4160: 69 64 61 74 65 20 61 6e 79 20 69 6e 63 72 62 6c idate any incrbl
4170: 6f 62 20 63 75 72 73 6f 72 73 20 74 68 61 74 20 ob cursors that
4180: 61 72 65 20 6f 70 65 6e 20 6f 6e 20 74 68 65 0a are open on the.
4190: 2a 2a 20 72 6f 77 20 6f 72 20 6f 6e 65 20 6f 66 ** row or one of
41a0: 20 74 68 65 20 72 6f 77 73 20 62 65 69 6e 67 20 the rows being
41b0: 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 modified..**.**
41c0: 49 66 20 61 72 67 75 6d 65 6e 74 20 69 73 43 6c If argument isCl
41d0: 65 61 72 54 61 62 6c 65 20 69 73 20 74 72 75 65 earTable is true
41e0: 2c 20 74 68 65 6e 20 74 68 65 20 65 6e 74 69 72 , then the entir
41f0: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
4200: 65 0a 2a 2a 20 74 61 62 6c 65 20 69 73 20 61 62 e.** table is ab
4210: 6f 75 74 20 74 6f 20 62 65 20 64 65 6c 65 74 65 out to be delete
4220: 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 d. In this case
4230: 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 69 invalidate all i
4240: 6e 63 72 62 6c 6f 62 0a 2a 2a 20 63 75 72 73 6f ncrblob.** curso
4250: 72 73 20 6f 70 65 6e 20 6f 6e 20 61 6e 79 20 72 rs open on any r
4260: 6f 77 20 77 69 74 68 69 6e 20 74 68 65 20 74 61 ow within the ta
4270: 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 ble with root-pa
4280: 67 65 20 70 67 6e 6f 52 6f 6f 74 2e 0a 2a 2a 0a ge pgnoRoot..**.
4290: 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 ** Otherwise, if
42a0: 20 61 72 67 75 6d 65 6e 74 20 69 73 43 6c 65 61 argument isClea
42b0: 72 54 61 62 6c 65 20 69 73 20 66 61 6c 73 65 2c rTable is false,
42c0: 20 74 68 65 6e 20 74 68 65 20 72 6f 77 20 77 69 then the row wi
42d0: 74 68 0a 2a 2a 20 72 6f 77 69 64 20 69 52 6f 77 th.** rowid iRow
42e0: 20 69 73 20 62 65 69 6e 67 20 72 65 70 6c 61 63 is being replac
42f0: 65 64 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 ed or deleted. I
4300: 6e 20 74 68 69 73 20 63 61 73 65 20 69 6e 76 61 n this case inva
4310: 6c 69 64 61 74 65 0a 2a 2a 20 6f 6e 6c 79 20 74 lidate.** only t
4320: 68 6f 73 65 20 69 6e 63 72 62 6c 6f 62 20 63 75 hose incrblob cu
4330: 72 73 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 74 68 rsors open on th
4340: 61 74 20 73 70 65 63 69 66 69 63 20 72 6f 77 2e at specific row.
4350: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
4360: 69 6e 76 61 6c 69 64 61 74 65 49 6e 63 72 62 6c invalidateIncrbl
4370: 6f 62 43 75 72 73 6f 72 73 28 0a 20 20 42 74 72 obCursors(. Btr
4380: 65 65 20 2a 70 42 74 72 65 65 2c 20 20 20 20 20 ee *pBtree,
4390: 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 /* The data
43a0: 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 68 65 base file to che
43b0: 63 6b 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e ck */. Pgno pgn
43c0: 6f 52 6f 6f 74 2c 20 20 20 20 20 20 20 20 20 20 oRoot,
43d0: 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 74 68 61 /* The table tha
43e0: 74 20 6d 69 67 68 74 20 62 65 20 63 68 61 6e 67 t might be chang
43f0: 69 6e 67 20 2a 2f 0a 20 20 69 36 34 20 69 52 6f ing */. i64 iRo
4400: 77 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 w,
4410: 20 2f 2a 20 54 68 65 20 72 6f 77 69 64 20 74 68 /* The rowid th
4420: 61 74 20 6d 69 67 68 74 20 62 65 20 63 68 61 6e at might be chan
4430: 67 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ging */. int is
4440: 43 6c 65 61 72 54 61 62 6c 65 20 20 20 20 20 20 ClearTable
4450: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6c 6c /* True if all
4460: 20 72 6f 77 73 20 61 72 65 20 62 65 69 6e 67 20 rows are being
4470: 64 65 6c 65 74 65 64 20 2a 2f 0a 29 7b 0a 20 20 deleted */.){.
4480: 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 69 BtCursor *p;. i
4490: 66 28 20 70 42 74 72 65 65 2d 3e 68 61 73 49 6e f( pBtree->hasIn
44a0: 63 72 62 6c 6f 62 43 75 72 3d 3d 30 20 29 20 72 crblobCur==0 ) r
44b0: 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 72 74 28 eturn;. assert(
44c0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
44d0: 64 73 4d 75 74 65 78 28 70 42 74 72 65 65 29 20 dsMutex(pBtree)
44e0: 29 3b 0a 20 20 70 42 74 72 65 65 2d 3e 68 61 73 );. pBtree->has
44f0: 49 6e 63 72 62 6c 6f 62 43 75 72 20 3d 20 30 3b IncrblobCur = 0;
4500: 0a 20 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d . for(p=pBtree-
4510: 3e 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 >pBt->pCursor; p
4520: 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 ; p=p->pNext){.
4530: 20 20 20 69 66 28 20 28 70 2d 3e 63 75 72 46 6c if( (p->curFl
4540: 61 67 73 20 26 20 42 54 43 46 5f 49 6e 63 72 62 ags & BTCF_Incrb
4550: 6c 6f 62 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 lob)!=0 ){.
4560: 20 70 42 74 72 65 65 2d 3e 68 61 73 49 6e 63 72 pBtree->hasIncr
4570: 62 6c 6f 62 43 75 72 20 3d 20 31 3b 0a 20 20 20 blobCur = 1;.
4580: 20 20 20 69 66 28 20 70 2d 3e 70 67 6e 6f 52 6f if( p->pgnoRo
4590: 6f 74 3d 3d 70 67 6e 6f 52 6f 6f 74 20 26 26 20 ot==pgnoRoot &&
45a0: 28 69 73 43 6c 65 61 72 54 61 62 6c 65 20 7c 7c (isClearTable ||
45b0: 20 70 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 p->info.nKey==i
45c0: 52 6f 77 29 20 29 7b 0a 20 20 20 20 20 20 20 20 Row) ){.
45d0: 70 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 p->eState = CURS
45e0: 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 OR_INVALID;.
45f0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a }. }. }.}.
4600: 0a 23 65 6c 73 65 0a 20 20 2f 2a 20 53 74 75 62 .#else. /* Stub
4610: 20 66 75 6e 63 74 69 6f 6e 20 77 68 65 6e 20 49 function when I
4620: 4e 43 52 42 4c 4f 42 20 69 73 20 6f 6d 69 74 74 NCRBLOB is omitt
4630: 65 64 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 ed */. #define
4640: 69 6e 76 61 6c 69 64 61 74 65 49 6e 63 72 62 6c invalidateIncrbl
4650: 6f 62 43 75 72 73 6f 72 73 28 77 2c 78 2c 79 2c obCursors(w,x,y,
4660: 7a 29 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c z).#endif /* SQL
4670: 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f ITE_OMIT_INCRBLO
4680: 42 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 B */../*.** Set
4690: 62 69 74 20 70 67 6e 6f 20 6f 66 20 74 68 65 20 bit pgno of the
46a0: 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e BtShared.pHasCon
46b0: 74 65 6e 74 20 62 69 74 76 65 63 2e 20 54 68 69 tent bitvec. Thi
46c0: 73 20 69 73 20 63 61 6c 6c 65 64 20 0a 2a 2a 20 s is called .**
46d0: 77 68 65 6e 20 61 20 70 61 67 65 20 74 68 61 74 when a page that
46e0: 20 70 72 65 76 69 6f 75 73 6c 79 20 63 6f 6e 74 previously cont
46f0: 61 69 6e 65 64 20 64 61 74 61 20 62 65 63 6f 6d ained data becom
4700: 65 73 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c es a free-list l
4710: 65 61 66 20 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2a eaf .** page..**
4720: 0a 2a 2a 20 54 68 65 20 42 74 53 68 61 72 65 64 .** The BtShared
4730: 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 .pHasContent bit
4740: 76 65 63 20 65 78 69 73 74 73 20 74 6f 20 77 6f vec exists to wo
4750: 72 6b 20 61 72 6f 75 6e 64 20 61 6e 20 6f 62 73 rk around an obs
4760: 63 75 72 65 0a 2a 2a 20 62 75 67 20 63 61 75 73 cure.** bug caus
4770: 65 64 20 62 79 20 74 68 65 20 69 6e 74 65 72 61 ed by the intera
4780: 63 74 69 6f 6e 20 6f 66 20 74 77 6f 20 75 73 65 ction of two use
4790: 66 75 6c 20 49 4f 20 6f 70 74 69 6d 69 7a 61 74 ful IO optimizat
47a0: 69 6f 6e 73 20 73 75 72 72 6f 75 6e 64 69 6e 67 ions surrounding
47b0: 0a 2a 2a 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 .** free-list le
47c0: 61 66 20 70 61 67 65 73 3a 0a 2a 2a 0a 2a 2a 20 af pages:.**.**
47d0: 20 20 31 29 20 57 68 65 6e 20 61 6c 6c 20 64 61 1) When all da
47e0: 74 61 20 69 73 20 64 65 6c 65 74 65 64 20 66 72 ta is deleted fr
47f0: 6f 6d 20 61 20 70 61 67 65 20 61 6e 64 20 74 68 om a page and th
4800: 65 20 70 61 67 65 20 62 65 63 6f 6d 65 73 0a 2a e page becomes.*
4810: 2a 20 20 20 20 20 20 61 20 66 72 65 65 2d 6c 69 * a free-li
4820: 73 74 20 6c 65 61 66 20 70 61 67 65 2c 20 74 68 st leaf page, th
4830: 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 77 72 e page is not wr
4840: 69 74 74 65 6e 20 74 6f 20 74 68 65 20 64 61 74 itten to the dat
4850: 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 28 61 abase.** (a
4860: 73 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 s free-list leaf
4870: 20 70 61 67 65 73 20 63 6f 6e 74 61 69 6e 20 6e pages contain n
4880: 6f 20 6d 65 61 6e 69 6e 67 66 75 6c 20 64 61 74 o meaningful dat
4890: 61 29 2e 20 53 6f 6d 65 74 69 6d 65 73 0a 2a 2a a). Sometimes.**
48a0: 20 20 20 20 20 20 73 75 63 68 20 61 20 70 61 67 such a pag
48b0: 65 20 69 73 20 6e 6f 74 20 65 76 65 6e 20 6a 6f e is not even jo
48c0: 75 72 6e 61 6c 6c 65 64 20 28 61 73 20 69 74 20 urnalled (as it
48d0: 77 69 6c 6c 20 6e 6f 74 20 62 65 20 6d 6f 64 69 will not be modi
48e0: 66 69 65 64 2c 0a 2a 2a 20 20 20 20 20 20 77 68 fied,.** wh
48f0: 79 20 62 6f 74 68 65 72 20 6a 6f 75 72 6e 61 6c y bother journal
4900: 6c 69 6e 67 20 69 74 3f 29 2e 0a 2a 2a 0a 2a 2a ling it?)..**.**
4910: 20 20 20 32 29 20 57 68 65 6e 20 61 20 66 72 65 2) When a fre
4920: 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 e-list leaf page
4930: 20 69 73 20 72 65 75 73 65 64 2c 20 69 74 73 20 is reused, its
4940: 63 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 72 content is not r
4950: 65 61 64 0a 2a 2a 20 20 20 20 20 20 66 72 6f 6d ead.** from
4960: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6f 72 the database or
4970: 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 written to the
4980: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 77 68 journal file (wh
4990: 79 20 73 68 6f 75 6c 64 20 69 74 0a 2a 2a 20 20 y should it.**
49a0: 20 20 20 20 62 65 2c 20 69 66 20 69 74 20 69 73 be, if it is
49b0: 20 6e 6f 74 20 61 74 20 61 6c 6c 20 6d 65 61 6e not at all mean
49c0: 69 6e 67 66 75 6c 3f 29 2e 0a 2a 2a 0a 2a 2a 20 ingful?)..**.**
49d0: 42 79 20 74 68 65 6d 73 65 6c 76 65 73 2c 20 74 By themselves, t
49e0: 68 65 73 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f hese optimizatio
49f0: 6e 73 20 77 6f 72 6b 20 66 69 6e 65 20 61 6e 64 ns work fine and
4a00: 20 70 72 6f 76 69 64 65 20 61 20 68 61 6e 64 79 provide a handy
4a10: 0a 2a 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 .** performance
4a20: 62 6f 6f 73 74 20 74 6f 20 62 75 6c 6b 20 64 65 boost to bulk de
4a30: 6c 65 74 65 20 6f 72 20 69 6e 73 65 72 74 20 6f lete or insert o
4a40: 70 65 72 61 74 69 6f 6e 73 2e 20 48 6f 77 65 76 perations. Howev
4a50: 65 72 2c 20 69 66 0a 2a 2a 20 61 20 70 61 67 65 er, if.** a page
4a60: 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 is moved to the
4a70: 20 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 74 free-list and t
4a80: 68 65 6e 20 72 65 75 73 65 64 20 77 69 74 68 69 hen reused withi
4a90: 6e 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 74 72 n the same.** tr
4aa0: 61 6e 73 61 63 74 69 6f 6e 2c 20 61 20 70 72 6f ansaction, a pro
4ab0: 62 6c 65 6d 20 63 6f 6d 65 73 20 75 70 2e 20 49 blem comes up. I
4ac0: 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f f the page is no
4ad0: 74 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 77 68 65 t journalled whe
4ae0: 6e 0a 2a 2a 20 69 74 20 69 73 20 6d 6f 76 65 64 n.** it is moved
4af0: 20 74 6f 20 74 68 65 20 66 72 65 65 2d 6c 69 73 to the free-lis
4b00: 74 20 61 6e 64 20 69 74 20 69 73 20 61 6c 73 6f t and it is also
4b10: 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 not journalled
4b20: 77 68 65 6e 20 69 74 0a 2a 2a 20 69 73 20 65 78 when it.** is ex
4b30: 74 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65 tracted from the
4b40: 20 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 72 free-list and r
4b50: 65 75 73 65 64 2c 20 74 68 65 6e 20 74 68 65 20 eused, then the
4b60: 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 0a 2a 2a original data.**
4b70: 20 6d 61 79 20 62 65 20 6c 6f 73 74 2e 20 49 6e may be lost. In
4b80: 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 the event of a
4b90: 72 6f 6c 6c 62 61 63 6b 2c 20 69 74 20 6d 61 79 rollback, it may
4ba0: 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 not be possible
4bb0: 0a 2a 2a 20 74 6f 20 72 65 73 74 6f 72 65 20 74 .** to restore t
4bc0: 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 69 he database to i
4bd0: 74 73 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 66 ts original conf
4be0: 69 67 75 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a iguration..**.**
4bf0: 20 54 68 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 The solution is
4c00: 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 48 the BtShared.pH
4c10: 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 asContent bitvec
4c20: 2e 20 57 68 65 6e 65 76 65 72 20 61 20 70 61 67 . Whenever a pag
4c30: 65 20 69 73 20 0a 2a 2a 20 6d 6f 76 65 64 20 74 e is .** moved t
4c40: 6f 20 62 65 63 6f 6d 65 20 61 20 66 72 65 65 2d o become a free-
4c50: 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 2c 20 list leaf page,
4c60: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
4c70: 67 20 62 69 74 20 69 73 0a 2a 2a 20 73 65 74 20 g bit is.** set
4c80: 69 6e 20 74 68 65 20 62 69 74 76 65 63 2e 20 57 in the bitvec. W
4c90: 68 65 6e 65 76 65 72 20 61 20 6c 65 61 66 20 70 henever a leaf p
4ca0: 61 67 65 20 69 73 20 65 78 74 72 61 63 74 65 64 age is extracted
4cb0: 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c from the free-l
4cc0: 69 73 74 2c 0a 2a 2a 20 6f 70 74 69 6d 69 7a 61 ist,.** optimiza
4cd0: 74 69 6f 6e 20 32 20 61 62 6f 76 65 20 69 73 20 tion 2 above is
4ce0: 6f 6d 69 74 74 65 64 20 69 66 20 74 68 65 20 63 omitted if the c
4cf0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 orresponding bit
4d00: 20 69 73 20 61 6c 72 65 61 64 79 0a 2a 2a 20 73 is already.** s
4d10: 65 74 20 69 6e 20 42 74 53 68 61 72 65 64 2e 70 et in BtShared.p
4d20: 48 61 73 43 6f 6e 74 65 6e 74 2e 20 54 68 65 20 HasContent. The
4d30: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
4d40: 62 69 74 76 65 63 20 61 72 65 20 63 6c 65 61 72 bitvec are clear
4d50: 65 64 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 ed.** at the end
4d60: 20 6f 66 20 65 76 65 72 79 20 74 72 61 6e 73 61 of every transa
4d70: 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ction..*/.static
4d80: 20 69 6e 74 20 62 74 72 65 65 53 65 74 48 61 73 int btreeSetHas
4d90: 43 6f 6e 74 65 6e 74 28 42 74 53 68 61 72 65 64 Content(BtShared
4da0: 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f *pBt, Pgno pgno
4db0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
4dc0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 21 LITE_OK;. if( !
4dd0: 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 pBt->pHasContent
4de0: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
4df0: 70 67 6e 6f 3c 3d 70 42 74 2d 3e 6e 50 61 67 65 pgno<=pBt->nPage
4e00: 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 48 61 );. pBt->pHa
4e10: 73 43 6f 6e 74 65 6e 74 20 3d 20 73 71 6c 69 74 sContent = sqlit
4e20: 65 33 42 69 74 76 65 63 43 72 65 61 74 65 28 70 e3BitvecCreate(p
4e30: 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 Bt->nPage);.
4e40: 69 66 28 20 21 70 42 74 2d 3e 70 48 61 73 43 6f if( !pBt->pHasCo
4e50: 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 72 ntent ){. r
4e60: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
4e70: 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 7d _BKPT;. }. }
4e80: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
4e90: 45 5f 4f 4b 20 26 26 20 70 67 6e 6f 3c 3d 73 71 E_OK && pgno<=sq
4ea0: 6c 69 74 65 33 42 69 74 76 65 63 53 69 7a 65 28 lite3BitvecSize(
4eb0: 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 pBt->pHasContent
4ec0: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 ) ){. rc = sq
4ed0: 6c 69 74 65 33 42 69 74 76 65 63 53 65 74 28 70 lite3BitvecSet(p
4ee0: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 2c Bt->pHasContent,
4ef0: 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 pgno);. }. re
4f00: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
4f10: 2a 20 51 75 65 72 79 20 74 68 65 20 42 74 53 68 * Query the BtSh
4f20: 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 ared.pHasContent
4f30: 20 76 65 63 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 vector..**.** T
4f40: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
4f50: 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 66 72 called when a fr
4f60: 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 ee-list leaf pag
4f70: 65 20 69 73 20 72 65 6d 6f 76 65 64 20 66 72 6f e is removed fro
4f80: 6d 20 74 68 65 0a 2a 2a 20 66 72 65 65 2d 6c 69 m the.** free-li
4f90: 73 74 20 66 6f 72 20 72 65 75 73 65 2e 20 49 74 st for reuse. It
4fa0: 20 72 65 74 75 72 6e 73 20 66 61 6c 73 65 20 69 returns false i
4fb0: 66 20 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 f it is safe to
4fc0: 72 65 74 72 69 65 76 65 20 74 68 65 0a 2a 2a 20 retrieve the.**
4fd0: 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 page from the pa
4fe0: 67 65 72 20 6c 61 79 65 72 20 77 69 74 68 20 74 ger layer with t
4ff0: 68 65 20 27 6e 6f 2d 63 6f 6e 74 65 6e 74 27 20 he 'no-content'
5000: 66 6c 61 67 20 73 65 74 2e 20 54 72 75 65 20 6f flag set. True o
5010: 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 74 61 therwise..*/.sta
5020: 74 69 63 20 69 6e 74 20 62 74 72 65 65 47 65 74 tic int btreeGet
5030: 48 61 73 43 6f 6e 74 65 6e 74 28 42 74 53 68 61 HasContent(BtSha
5040: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 red *pBt, Pgno p
5050: 67 6e 6f 29 7b 0a 20 20 42 69 74 76 65 63 20 2a gno){. Bitvec *
5060: 70 20 3d 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e p = pBt->pHasCon
5070: 74 65 6e 74 3b 0a 20 20 72 65 74 75 72 6e 20 28 tent;. return (
5080: 70 20 26 26 20 28 70 67 6e 6f 3e 73 71 6c 69 74 p && (pgno>sqlit
5090: 65 33 42 69 74 76 65 63 53 69 7a 65 28 70 29 20 e3BitvecSize(p)
50a0: 7c 7c 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 || sqlite3Bitvec
50b0: 54 65 73 74 28 70 2c 20 70 67 6e 6f 29 29 29 3b Test(p, pgno)));
50c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 .}../*.** Clear
50d0: 28 64 65 73 74 72 6f 79 29 20 74 68 65 20 42 74 (destroy) the Bt
50e0: 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 Shared.pHasConte
50f0: 6e 74 20 62 69 74 76 65 63 2e 20 54 68 69 73 20 nt bitvec. This
5100: 73 68 6f 75 6c 64 20 62 65 0a 2a 2a 20 69 6e 76 should be.** inv
5110: 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f 6e 63 oked at the conc
5120: 6c 75 73 69 6f 6e 20 6f 66 20 65 61 63 68 20 77 lusion of each w
5130: 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
5140: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
5150: 20 62 74 72 65 65 43 6c 65 61 72 48 61 73 43 6f btreeClearHasCo
5160: 6e 74 65 6e 74 28 42 74 53 68 61 72 65 64 20 2a ntent(BtShared *
5170: 70 42 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 42 pBt){. sqlite3B
5180: 69 74 76 65 63 44 65 73 74 72 6f 79 28 70 42 74 itvecDestroy(pBt
5190: 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 29 3b 0a ->pHasContent);.
51a0: 20 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 pBt->pHasConte
51b0: 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a nt = 0;.}../*.**
51c0: 20 52 65 6c 65 61 73 65 20 61 6c 6c 20 6f 66 20 Release all of
51d0: 74 68 65 20 61 70 50 61 67 65 5b 5d 20 70 61 67 the apPage[] pag
51e0: 65 73 20 66 6f 72 20 61 20 63 75 72 73 6f 72 2e es for a cursor.
51f0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
5200: 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c 43 btreeReleaseAllC
5210: 75 72 73 6f 72 50 61 67 65 73 28 42 74 43 75 72 ursorPages(BtCur
5220: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 6e sor *pCur){. in
5230: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 t i;. for(i=0;
5240: 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 i<=pCur->iPage;
5250: 69 2b 2b 29 7b 0a 20 20 20 20 72 65 6c 65 61 73 i++){. releas
5260: 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 ePage(pCur->apPa
5270: 67 65 5b 69 5d 29 3b 0a 20 20 20 20 70 43 75 72 ge[i]);. pCur
5280: 2d 3e 61 70 50 61 67 65 5b 69 5d 20 3d 20 30 3b ->apPage[i] = 0;
5290: 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 69 50 61 . }. pCur->iPa
52a0: 67 65 20 3d 20 2d 31 3b 0a 7d 0a 0a 2f 2a 0a 2a ge = -1;.}../*.*
52b0: 2a 20 54 68 65 20 63 75 72 73 6f 72 20 70 61 73 * The cursor pas
52c0: 73 65 64 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 sed as the only
52d0: 61 72 67 75 6d 65 6e 74 20 6d 75 73 74 20 70 6f argument must po
52e0: 69 6e 74 20 74 6f 20 61 20 76 61 6c 69 64 20 65 int to a valid e
52f0: 6e 74 72 79 0a 2a 2a 20 77 68 65 6e 20 74 68 69 ntry.** when thi
5300: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
5310: 6c 6c 65 64 20 28 69 2e 65 2e 20 68 61 76 65 20 lled (i.e. have
5320: 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
5330: 41 4c 49 44 29 2e 20 54 68 69 73 0a 2a 2a 20 66 ALID). This.** f
5340: 75 6e 63 74 69 6f 6e 20 73 61 76 65 73 20 74 68 unction saves th
5350: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
5360: 20 6b 65 79 20 69 6e 20 76 61 72 69 61 62 6c 65 key in variable
5370: 73 20 70 43 75 72 2d 3e 6e 4b 65 79 20 61 6e 64 s pCur->nKey and
5380: 0a 2a 2a 20 70 43 75 72 2d 3e 70 4b 65 79 2e 20 .** pCur->pKey.
5390: 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
53a0: 75 72 6e 65 64 20 69 66 20 73 75 63 63 65 73 73 urned if success
53b0: 66 75 6c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 ful or an SQLite
53c0: 20 65 72 72 6f 72 20 0a 2a 2a 20 63 6f 64 65 20 error .** code
53d0: 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2a 0a 2a 2a otherwise..**.**
53e0: 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 If the cursor i
53f0: 73 20 6f 70 65 6e 20 6f 6e 20 61 6e 20 69 6e 74 s open on an int
5400: 6b 65 79 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 key table, then
5410: 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 0a the integer key.
5420: 2a 2a 20 28 74 68 65 20 72 6f 77 69 64 29 20 69 ** (the rowid) i
5430: 73 20 73 74 6f 72 65 64 20 69 6e 20 70 43 75 72 s stored in pCur
5440: 2d 3e 6e 4b 65 79 20 61 6e 64 20 70 43 75 72 2d ->nKey and pCur-
5450: 3e 70 4b 65 79 20 69 73 20 6c 65 66 74 20 73 65 >pKey is left se
5460: 74 20 74 6f 0a 2a 2a 20 4e 55 4c 4c 2e 20 49 66 t to.** NULL. If
5470: 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 6f the cursor is o
5480: 70 65 6e 20 6f 6e 20 61 20 6e 6f 6e 2d 69 6e 74 pen on a non-int
5490: 6b 65 79 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 key table, then
54a0: 70 43 75 72 2d 3e 70 4b 65 79 20 69 73 20 0a 2a pCur->pKey is .*
54b0: 2a 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 * set to point t
54c0: 6f 20 61 20 6d 61 6c 6c 6f 63 65 64 20 62 75 66 o a malloced buf
54d0: 66 65 72 20 70 43 75 72 2d 3e 6e 4b 65 79 20 62 fer pCur->nKey b
54e0: 79 74 65 73 20 69 6e 20 73 69 7a 65 20 63 6f 6e ytes in size con
54f0: 74 61 69 6e 69 6e 67 20 0a 2a 2a 20 74 68 65 20 taining .** the
5500: 6b 65 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 key..*/.static i
5510: 6e 74 20 73 61 76 65 43 75 72 73 6f 72 4b 65 79 nt saveCursorKey
5520: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
5530: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
5540: 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 ITE_OK;. assert
5550: 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d ( CURSOR_VALID==
5560: 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 3b 0a pCur->eState );.
5570: 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70 43 75 assert( 0==pCu
5580: 72 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 61 73 73 r->pKey );. ass
5590: 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
55a0: 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 0a Mutex(pCur) );..
55b0: 20 20 69 66 28 20 70 43 75 72 2d 3e 63 75 72 49 if( pCur->curI
55c0: 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 2f 2a 20 ntKey ){. /*
55d0: 4f 6e 6c 79 20 74 68 65 20 72 6f 77 69 64 20 69 Only the rowid i
55e0: 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 61 s required for a
55f0: 20 74 61 62 6c 65 20 62 74 72 65 65 20 2a 2f 0a table btree */.
5600: 20 20 20 20 70 43 75 72 2d 3e 6e 4b 65 79 20 3d pCur->nKey =
5610: 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 6e 74 sqlite3BtreeInt
5620: 65 67 65 72 4b 65 79 28 70 43 75 72 29 3b 0a 20 egerKey(pCur);.
5630: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 46 }else{. /* F
5640: 6f 72 20 61 6e 20 69 6e 64 65 78 20 62 74 72 65 or an index btre
5650: 65 2c 20 73 61 76 65 20 74 68 65 20 63 6f 6d 70 e, save the comp
5660: 6c 65 74 65 20 6b 65 79 20 63 6f 6e 74 65 6e 74 lete key content
5670: 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20 2a 70 4b */. void *pK
5680: 65 79 3b 0a 20 20 20 20 70 43 75 72 2d 3e 6e 4b ey;. pCur->nK
5690: 65 79 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 ey = sqlite3Btre
56a0: 65 50 61 79 6c 6f 61 64 53 69 7a 65 28 70 43 75 ePayloadSize(pCu
56b0: 72 29 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20 73 r);. pKey = s
56c0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 70 43 qlite3Malloc( pC
56d0: 75 72 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 20 20 ur->nKey );.
56e0: 69 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 if( pKey ){.
56f0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 rc = sqlite3Bt
5700: 72 65 65 50 61 79 6c 6f 61 64 28 70 43 75 72 2c reePayload(pCur,
5710: 20 30 2c 20 28 69 6e 74 29 70 43 75 72 2d 3e 6e 0, (int)pCur->n
5720: 4b 65 79 2c 20 70 4b 65 79 29 3b 0a 20 20 20 20 Key, pKey);.
5730: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
5740: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 _OK ){. p
5750: 43 75 72 2d 3e 70 4b 65 79 20 3d 20 70 4b 65 79 Cur->pKey = pKey
5760: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
5770: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
5780: 72 65 65 28 70 4b 65 79 29 3b 0a 20 20 20 20 20 ree(pKey);.
5790: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
57a0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
57b0: 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
57c0: 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 }. }. assert(
57d0: 21 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 !pCur->curIntKey
57e0: 20 7c 7c 20 21 70 43 75 72 2d 3e 70 4b 65 79 20 || !pCur->pKey
57f0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
5800: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 }../*.** Save th
5810: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
5820: 20 70 6f 73 69 74 69 6f 6e 20 69 6e 20 74 68 65 position in the
5830: 20 76 61 72 69 61 62 6c 65 73 20 42 74 43 75 72 variables BtCur
5840: 73 6f 72 2e 6e 4b 65 79 20 0a 2a 2a 20 61 6e 64 sor.nKey .** and
5850: 20 42 74 43 75 72 73 6f 72 2e 70 4b 65 79 2e 20 BtCursor.pKey.
5860: 54 68 65 20 63 75 72 73 6f 72 27 73 20 73 74 61 The cursor's sta
5870: 74 65 20 69 73 20 73 65 74 20 74 6f 20 43 55 52 te is set to CUR
5880: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 2e SOR_REQUIRESEEK.
5890: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 .**.** The calle
58a0: 72 20 6d 75 73 74 20 65 6e 73 75 72 65 20 74 68 r must ensure th
58b0: 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 at the cursor is
58c0: 20 76 61 6c 69 64 20 28 68 61 73 20 65 53 74 61 valid (has eSta
58d0: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
58e0: 29 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 63 61 ).** prior to ca
58f0: 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 lling this routi
5900: 6e 65 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 20 ne. .*/.static
5910: 69 6e 74 20 73 61 76 65 43 75 72 73 6f 72 50 6f int saveCursorPo
5920: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
5930: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
5940: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 43 55 52 ;.. assert( CUR
5950: 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 2d SOR_VALID==pCur-
5960: 3e 65 53 74 61 74 65 20 7c 7c 20 43 55 52 53 4f >eState || CURSO
5970: 52 5f 53 4b 49 50 4e 45 58 54 3d 3d 70 43 75 72 R_SKIPNEXT==pCur
5980: 2d 3e 65 53 74 61 74 65 20 29 3b 0a 20 20 61 73 ->eState );. as
5990: 73 65 72 74 28 20 30 3d 3d 70 43 75 72 2d 3e 70 sert( 0==pCur->p
59a0: 4b 65 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 Key );. assert(
59b0: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
59c0: 78 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 69 66 x(pCur) );.. if
59d0: 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
59e0: 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 CURSOR_SKIPNEXT
59f0: 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
5a00: 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c ate = CURSOR_VAL
5a10: 49 44 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ID;. }else{.
5a20: 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
5a30: 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d = 0;. }.. rc =
5a40: 20 73 61 76 65 43 75 72 73 6f 72 4b 65 79 28 70 saveCursorKey(p
5a50: 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d Cur);. if( rc==
5a60: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
5a70: 20 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c btreeReleaseAll
5a80: 43 75 72 73 6f 72 50 61 67 65 73 28 70 43 75 72 CursorPages(pCur
5a90: 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 );. pCur->eSt
5aa0: 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 52 45 51 ate = CURSOR_REQ
5ab0: 55 49 52 45 53 45 45 4b 3b 0a 20 20 7d 0a 0a 20 UIRESEEK;. }..
5ac0: 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
5ad0: 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e &= ~(BTCF_ValidN
5ae0: 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 Key|BTCF_ValidOv
5af0: 66 6c 7c 42 54 43 46 5f 41 74 4c 61 73 74 29 3b fl|BTCF_AtLast);
5b00: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
5b10: 0a 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 ./* Forward refe
5b20: 72 65 6e 63 65 20 2a 2f 0a 73 74 61 74 69 63 20 rence */.static
5b30: 69 6e 74 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c int SQLITE_NOINL
5b40: 49 4e 45 20 73 61 76 65 43 75 72 73 6f 72 73 4f INE saveCursorsO
5b50: 6e 4c 69 73 74 28 42 74 43 75 72 73 6f 72 2a 2c nList(BtCursor*,
5b60: 50 67 6e 6f 2c 42 74 43 75 72 73 6f 72 2a 29 3b Pgno,BtCursor*);
5b70: 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 65 ../*.** Save the
5b80: 20 70 6f 73 69 74 69 6f 6e 73 20 6f 66 20 61 6c positions of al
5b90: 6c 20 63 75 72 73 6f 72 73 20 28 65 78 63 65 70 l cursors (excep
5ba0: 74 20 70 45 78 63 65 70 74 29 20 74 68 61 74 20 t pExcept) that
5bb0: 61 72 65 20 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 74 are open on.** t
5bc0: 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f he table with ro
5bd0: 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 2e 20 20 ot-page iRoot.
5be0: 22 53 61 76 69 6e 67 20 74 68 65 20 63 75 72 73 "Saving the curs
5bf0: 6f 72 20 70 6f 73 69 74 69 6f 6e 22 20 6d 65 61 or position" mea
5c00: 6e 73 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 6c ns that.** the l
5c10: 6f 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 62 ocation in the b
5c20: 74 72 65 65 20 69 73 20 72 65 6d 65 6d 62 65 72 tree is remember
5c30: 65 64 20 69 6e 20 73 75 63 68 20 61 20 77 61 79 ed in such a way
5c40: 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a that it can be.
5c50: 2a 2a 20 6d 6f 76 65 64 20 62 61 63 6b 20 74 6f ** moved back to
5c60: 20 74 68 65 20 73 61 6d 65 20 73 70 6f 74 20 61 the same spot a
5c70: 66 74 65 72 20 74 68 65 20 62 74 72 65 65 20 68 fter the btree h
5c80: 61 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 as been modified
5c90: 2e 20 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 . This.** routi
5ca0: 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 6a 75 73 ne is called jus
5cb0: 74 20 62 65 66 6f 72 65 20 63 75 72 73 6f 72 20 t before cursor
5cc0: 70 45 78 63 65 70 74 20 69 73 20 75 73 65 64 20 pExcept is used
5cd0: 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 0a 2a 2a to modify the.**
5ce0: 20 74 61 62 6c 65 2c 20 66 6f 72 20 65 78 61 6d table, for exam
5cf0: 70 6c 65 20 69 6e 20 42 74 72 65 65 44 65 6c 65 ple in BtreeDele
5d00: 74 65 28 29 20 6f 72 20 42 74 72 65 65 49 6e 73 te() or BtreeIns
5d10: 65 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ert()..**.** If
5d20: 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 6f 72 there are two or
5d30: 20 6d 6f 72 65 20 63 75 72 73 6f 72 73 20 6f 6e more cursors on
5d40: 20 74 68 65 20 73 61 6d 65 20 62 74 72 65 65 2c the same btree,
5d50: 20 74 68 65 6e 20 61 6c 6c 20 73 75 63 68 20 0a then all such .
5d60: 2a 2a 20 63 75 72 73 6f 72 73 20 73 68 6f 75 6c ** cursors shoul
5d70: 64 20 68 61 76 65 20 74 68 65 69 72 20 42 54 43 d have their BTC
5d80: 46 5f 4d 75 6c 74 69 70 6c 65 20 66 6c 61 67 20 F_Multiple flag
5d90: 73 65 74 2e 20 20 54 68 65 20 62 74 72 65 65 43 set. The btreeC
5da0: 75 72 73 6f 72 28 29 0a 2a 2a 20 72 6f 75 74 69 ursor().** routi
5db0: 6e 65 20 65 6e 66 6f 72 63 65 73 20 74 68 61 74 ne enforces that
5dc0: 20 72 75 6c 65 2e 20 20 54 68 69 73 20 72 6f 75 rule. This rou
5dd0: 74 69 6e 65 20 6f 6e 6c 79 20 6e 65 65 64 73 20 tine only needs
5de0: 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 69 6e 0a to be called in.
5df0: 2a 2a 20 74 68 65 20 75 6e 63 6f 6d 6d 6f 6e 20 ** the uncommon
5e00: 63 61 73 65 20 77 68 65 6e 20 70 45 78 70 65 63 case when pExpec
5e10: 74 20 68 61 73 20 74 68 65 20 42 54 43 46 5f 4d t has the BTCF_M
5e20: 75 6c 74 69 70 6c 65 20 66 6c 61 67 20 73 65 74 ultiple flag set
5e30: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 45 78 70 65 ..**.** If pExpe
5e40: 63 74 21 3d 4e 55 4c 4c 20 61 6e 64 20 69 66 20 ct!=NULL and if
5e50: 6e 6f 20 6f 74 68 65 72 20 63 75 72 73 6f 72 73 no other cursors
5e60: 20 61 72 65 20 66 6f 75 6e 64 20 6f 6e 20 74 68 are found on th
5e70: 65 20 73 61 6d 65 20 72 6f 6f 74 2d 70 61 67 65 e same root-page
5e80: 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 42 54 ,.** then the BT
5e90: 43 46 5f 4d 75 6c 74 69 70 6c 65 20 66 6c 61 67 CF_Multiple flag
5ea0: 20 6f 6e 20 70 45 78 70 65 63 74 20 69 73 20 63 on pExpect is c
5eb0: 6c 65 61 72 65 64 2c 20 74 6f 20 61 76 6f 69 64 leared, to avoid
5ec0: 20 61 6e 6f 74 68 65 72 0a 2a 2a 20 70 6f 69 6e another.** poin
5ed0: 74 6c 65 73 73 20 63 61 6c 6c 20 74 6f 20 74 68 tless call to th
5ee0: 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 0a 2a is routine..**.*
5ef0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e * Implementation
5f00: 20 6e 6f 74 65 3a 20 20 54 68 69 73 20 72 6f 75 note: This rou
5f10: 74 69 6e 65 20 6d 65 72 65 6c 79 20 63 68 65 63 tine merely chec
5f20: 6b 73 20 74 6f 20 73 65 65 20 69 66 20 61 6e 79 ks to see if any
5f30: 20 63 75 72 73 6f 72 73 0a 2a 2a 20 6e 65 65 64 cursors.** need
5f40: 20 74 6f 20 62 65 20 73 61 76 65 64 2e 20 20 49 to be saved. I
5f50: 74 20 63 61 6c 6c 73 20 6f 75 74 20 74 6f 20 73 t calls out to s
5f60: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
5f70: 28 29 20 69 6e 20 74 68 65 20 28 75 6e 75 73 75 () in the (unusu
5f80: 61 6c 29 0a 2a 2a 20 65 76 65 6e 74 20 74 68 61 al).** event tha
5f90: 74 20 63 75 72 73 6f 72 73 20 61 72 65 20 69 6e t cursors are in
5fa0: 20 6e 65 65 64 20 74 6f 20 62 65 69 6e 67 20 73 need to being s
5fb0: 61 76 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 aved..*/.static
5fc0: 69 6e 74 20 73 61 76 65 41 6c 6c 43 75 72 73 6f int saveAllCurso
5fd0: 72 73 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 rs(BtShared *pBt
5fe0: 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 42 74 , Pgno iRoot, Bt
5ff0: 43 75 72 73 6f 72 20 2a 70 45 78 63 65 70 74 29 Cursor *pExcept)
6000: 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b {. BtCursor *p;
6010: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
6020: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
6030: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
6040: 73 73 65 72 74 28 20 70 45 78 63 65 70 74 3d 3d ssert( pExcept==
6050: 30 20 7c 7c 20 70 45 78 63 65 70 74 2d 3e 70 42 0 || pExcept->pB
6060: 74 3d 3d 70 42 74 20 29 3b 0a 20 20 66 6f 72 28 t==pBt );. for(
6070: 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 p=pBt->pCursor;
6080: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a p; p=p->pNext){.
6090: 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 65 if( p!=pExce
60a0: 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 pt && (0==iRoot
60b0: 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d || p->pgnoRoot==
60c0: 69 52 6f 6f 74 29 20 29 20 62 72 65 61 6b 3b 0a iRoot) ) break;.
60d0: 20 20 7d 0a 20 20 69 66 28 20 70 20 29 20 72 65 }. if( p ) re
60e0: 74 75 72 6e 20 73 61 76 65 43 75 72 73 6f 72 73 turn saveCursors
60f0: 4f 6e 4c 69 73 74 28 70 2c 20 69 52 6f 6f 74 2c OnList(p, iRoot,
6100: 20 70 45 78 63 65 70 74 29 3b 0a 20 20 69 66 28 pExcept);. if(
6110: 20 70 45 78 63 65 70 74 20 29 20 70 45 78 63 65 pExcept ) pExce
6120: 70 74 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 pt->curFlags &=
6130: 7e 42 54 43 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a ~BTCF_Multiple;.
6140: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
6150: 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 54 68 69 73 20 68 OK;.}../* This h
6160: 65 6c 70 65 72 20 72 6f 75 74 69 6e 65 20 74 6f elper routine to
6170: 20 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 20 saveAllCursors
6180: 64 6f 65 73 20 74 68 65 20 61 63 74 75 61 6c 20 does the actual
6190: 77 6f 72 6b 20 6f 66 20 73 61 76 69 6e 67 0a 2a work of saving.*
61a0: 2a 20 74 68 65 20 63 75 72 73 6f 72 73 20 69 66 * the cursors if
61b0: 20 61 6e 64 20 77 68 65 6e 20 61 20 63 75 72 73 and when a curs
61c0: 6f 72 20 69 73 20 66 6f 75 6e 64 20 74 68 61 74 or is found that
61d0: 20 61 63 74 75 61 6c 6c 79 20 72 65 71 75 69 72 actually requir
61e0: 65 73 20 73 61 76 69 6e 67 2e 0a 2a 2a 20 54 68 es saving..** Th
61f0: 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 69 73 e common case is
6200: 20 74 68 61 74 20 6e 6f 20 63 75 72 73 6f 72 73 that no cursors
6210: 20 6e 65 65 64 20 74 6f 20 62 65 20 73 61 76 65 need to be save
6220: 64 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 d, so this routi
6230: 6e 65 20 69 73 0a 2a 2a 20 62 72 6f 6b 65 6e 20 ne is.** broken
6240: 6f 75 74 20 66 72 6f 6d 20 69 74 73 20 63 61 6c out from its cal
6250: 6c 65 72 20 74 6f 20 61 76 6f 69 64 20 75 6e 6e ler to avoid unn
6260: 65 63 65 73 73 61 72 79 20 73 74 61 63 6b 20 70 ecessary stack p
6270: 6f 69 6e 74 65 72 20 6d 6f 76 65 6d 65 6e 74 2e ointer movement.
6280: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 .*/.static int S
6290: 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 73 QLITE_NOINLINE s
62a0: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
62b0: 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 2c (. BtCursor *p,
62c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
62d0: 66 69 72 73 74 20 63 75 72 73 6f 72 20 74 68 61 first cursor tha
62e0: 74 20 6e 65 65 64 73 20 73 61 76 69 6e 67 20 2a t needs saving *
62f0: 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 /. Pgno iRoot,
6300: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 6c 79 /* Only
6310: 20 73 61 76 65 20 63 75 72 73 6f 72 20 77 69 74 save cursor wit
6320: 68 20 74 68 69 73 20 69 52 6f 6f 74 2e 20 53 61 h this iRoot. Sa
6330: 76 65 20 61 6c 6c 20 69 66 20 7a 65 72 6f 20 2a ve all if zero *
6340: 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 45 /. BtCursor *pE
6350: 78 63 65 70 74 20 20 20 20 2f 2a 20 44 6f 20 6e xcept /* Do n
6360: 6f 74 20 73 61 76 65 20 74 68 69 73 20 63 75 72 ot save this cur
6370: 73 6f 72 20 2a 2f 0a 29 7b 0a 20 20 64 6f 7b 0a sor */.){. do{.
6380: 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 65 if( p!=pExce
6390: 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 pt && (0==iRoot
63a0: 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d || p->pgnoRoot==
63b0: 69 52 6f 6f 74 29 20 29 7b 0a 20 20 20 20 20 20 iRoot) ){.
63c0: 69 66 28 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 if( p->eState==C
63d0: 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 URSOR_VALID || p
63e0: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
63f0: 5f 53 4b 49 50 4e 45 58 54 20 29 7b 0a 20 20 20 _SKIPNEXT ){.
6400: 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 61 int rc = sa
6410: 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e veCursorPosition
6420: 28 70 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 (p);. if(
6430: 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 SQLITE_OK!=rc )
6440: 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 {. retu
6450: 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d rn rc;. }
6460: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
6470: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
6480: 70 2d 3e 69 50 61 67 65 3e 30 20 29 3b 0a 20 20 p->iPage>0 );.
6490: 20 20 20 20 20 20 62 74 72 65 65 52 65 6c 65 61 btreeRelea
64a0: 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 65 73 seAllCursorPages
64b0: 28 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 (p);. }.
64c0: 20 7d 0a 20 20 20 20 70 20 3d 20 70 2d 3e 70 4e }. p = p->pN
64d0: 65 78 74 3b 0a 20 20 7d 77 68 69 6c 65 28 20 70 ext;. }while( p
64e0: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c );. return SQL
64f0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
6500: 20 43 6c 65 61 72 20 74 68 65 20 63 75 72 72 65 Clear the curre
6510: 6e 74 20 63 75 72 73 6f 72 20 70 6f 73 69 74 69 nt cursor positi
6520: 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 on..*/.void sqli
6530: 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 72 te3BtreeClearCur
6540: 73 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 sor(BtCursor *pC
6550: 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 ur){. assert( c
6560: 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
6570: 70 43 75 72 29 20 29 3b 0a 20 20 73 71 6c 69 74 pCur) );. sqlit
6580: 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 4b e3_free(pCur->pK
6590: 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 ey);. pCur->pKe
65a0: 79 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 65 y = 0;. pCur->e
65b0: 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 State = CURSOR_I
65c0: 4e 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a NVALID;.}../*.**
65d0: 20 49 6e 20 74 68 69 73 20 76 65 72 73 69 6f 6e In this version
65e0: 20 6f 66 20 42 74 72 65 65 4d 6f 76 65 74 6f 2c of BtreeMoveto,
65f0: 20 70 4b 65 79 20 69 73 20 61 20 70 61 63 6b 65 pKey is a packe
6600: 64 20 69 6e 64 65 78 20 72 65 63 6f 72 64 0a 2a d index record.*
6610: 2a 20 73 75 63 68 20 61 73 20 69 73 20 67 65 6e * such as is gen
6620: 65 72 61 74 65 64 20 62 79 20 74 68 65 20 4f 50 erated by the OP
6630: 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f _MakeRecord opco
6640: 64 65 2e 20 20 55 6e 70 61 63 6b 20 74 68 65 0a de. Unpack the.
6650: 2a 2a 20 72 65 63 6f 72 64 20 61 6e 64 20 74 68 ** record and th
6660: 65 6e 20 63 61 6c 6c 20 42 74 72 65 65 4d 6f 76 en call BtreeMov
6670: 65 74 6f 55 6e 70 61 63 6b 65 64 28 29 20 74 6f etoUnpacked() to
6680: 20 64 6f 20 74 68 65 20 77 6f 72 6b 2e 0a 2a 2f do the work..*/
6690: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
66a0: 65 4d 6f 76 65 74 6f 28 0a 20 20 42 74 43 75 72 eMoveto(. BtCur
66b0: 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 2f sor *pCur, /
66c0: 2a 20 43 75 72 73 6f 72 20 6f 70 65 6e 20 6f 6e * Cursor open on
66d0: 20 74 68 65 20 62 74 72 65 65 20 74 6f 20 62 65 the btree to be
66e0: 20 73 65 61 72 63 68 65 64 20 2a 2f 0a 20 20 63 searched */. c
66f0: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 2c onst void *pKey,
6700: 20 20 20 2f 2a 20 50 61 63 6b 65 64 20 6b 65 79 /* Packed key
6710: 20 69 66 20 74 68 65 20 62 74 72 65 65 20 69 73 if the btree is
6720: 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 an index */. i
6730: 36 34 20 6e 4b 65 79 2c 20 20 20 20 20 20 20 20 64 nKey,
6740: 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 6b 65 /* Integer ke
6750: 79 20 66 6f 72 20 74 61 62 6c 65 73 2e 20 20 53 y for tables. S
6760: 69 7a 65 20 6f 66 20 70 4b 65 79 20 66 6f 72 20 ize of pKey for
6770: 69 6e 64 69 63 65 73 20 2a 2f 0a 20 20 69 6e 74 indices */. int
6780: 20 62 69 61 73 2c 20 20 20 20 20 20 20 20 20 20 bias,
6790: 20 2f 2a 20 42 69 61 73 20 73 65 61 72 63 68 20 /* Bias search
67a0: 74 6f 20 74 68 65 20 68 69 67 68 20 65 6e 64 20 to the high end
67b0: 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 20 */. int *pRes
67c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 /* Writ
67d0: 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 e search results
67e0: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
67f0: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
6800: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 61 74 /* Stat
6810: 75 73 20 63 6f 64 65 20 2a 2f 0a 20 20 55 6e 70 us code */. Unp
6820: 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 49 64 ackedRecord *pId
6830: 78 4b 65 79 3b 20 20 20 2f 2a 20 55 6e 70 61 63 xKey; /* Unpac
6840: 6b 65 64 20 69 6e 64 65 78 20 6b 65 79 20 2a 2f ked index key */
6850: 0a 0a 20 20 69 66 28 20 70 4b 65 79 20 29 7b 0a .. if( pKey ){.
6860: 20 20 20 20 61 73 73 65 72 74 28 20 6e 4b 65 79 assert( nKey
6870: 3d 3d 28 69 36 34 29 28 69 6e 74 29 6e 4b 65 79 ==(i64)(int)nKey
6880: 20 29 3b 0a 20 20 20 20 70 49 64 78 4b 65 79 20 );. pIdxKey
6890: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 6c 6c = sqlite3VdbeAll
68a0: 6f 63 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 ocUnpackedRecord
68b0: 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 29 (pCur->pKeyInfo)
68c0: 3b 0a 20 20 20 20 69 66 28 20 70 49 64 78 4b 65 ;. if( pIdxKe
68d0: 79 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 y==0 ) return SQ
68e0: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
68f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 . sqlite3Vdbe
6900: 52 65 63 6f 72 64 55 6e 70 61 63 6b 28 70 43 75 RecordUnpack(pCu
6910: 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 28 69 6e r->pKeyInfo, (in
6920: 74 29 6e 4b 65 79 2c 20 70 4b 65 79 2c 20 70 49 t)nKey, pKey, pI
6930: 64 78 4b 65 79 29 3b 0a 20 20 20 20 69 66 28 20 dxKey);. if(
6940: 70 49 64 78 4b 65 79 2d 3e 6e 46 69 65 6c 64 3d pIdxKey->nField=
6950: 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d =0 ){. rc =
6960: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
6970: 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f BKPT;. goto
6980: 20 6d 6f 76 65 74 6f 5f 64 6f 6e 65 3b 0a 20 20 moveto_done;.
6990: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
69a0: 20 70 49 64 78 4b 65 79 20 3d 20 30 3b 0a 20 20 pIdxKey = 0;.
69b0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 }. rc = sqlite3
69c0: 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 61 63 BtreeMovetoUnpac
69d0: 6b 65 64 28 70 43 75 72 2c 20 70 49 64 78 4b 65 ked(pCur, pIdxKe
69e0: 79 2c 20 6e 4b 65 79 2c 20 62 69 61 73 2c 20 70 y, nKey, bias, p
69f0: 52 65 73 29 3b 0a 6d 6f 76 65 74 6f 5f 64 6f 6e Res);.moveto_don
6a00: 65 3a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 e:. if( pIdxKey
6a10: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 ){. sqlite3D
6a20: 62 46 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 bFree(pCur->pKey
6a30: 49 6e 66 6f 2d 3e 64 62 2c 20 70 49 64 78 4b 65 Info->db, pIdxKe
6a40: 79 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e y);. }. return
6a50: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
6a60: 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 6f 72 store the cursor
6a70: 20 74 6f 20 74 68 65 20 70 6f 73 69 74 69 6f 6e to the position
6a80: 20 69 74 20 77 61 73 20 69 6e 20 28 6f 72 20 61 it was in (or a
6a90: 73 20 63 6c 6f 73 65 20 74 6f 20 61 73 20 70 6f s close to as po
6aa0: 73 73 69 62 6c 65 29 0a 2a 2a 20 77 68 65 6e 20 ssible).** when
6ab0: 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 saveCursorPositi
6ac0: 6f 6e 28 29 20 77 61 73 20 63 61 6c 6c 65 64 2e on() was called.
6ad0: 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 Note that this
6ae0: 63 61 6c 6c 20 64 65 6c 65 74 65 73 20 74 68 65 call deletes the
6af0: 20 0a 2a 2a 20 73 61 76 65 64 20 70 6f 73 69 74 .** saved posit
6b00: 69 6f 6e 20 69 6e 66 6f 20 73 74 6f 72 65 64 20 ion info stored
6b10: 62 79 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 by saveCursorPos
6b20: 69 74 69 6f 6e 28 29 2c 20 73 6f 20 74 68 65 72 ition(), so ther
6b30: 65 20 63 61 6e 20 62 65 0a 2a 2a 20 61 74 20 6d e can be.** at m
6b40: 6f 73 74 20 6f 6e 65 20 65 66 66 65 63 74 69 76 ost one effectiv
6b50: 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 50 e restoreCursorP
6b60: 6f 73 69 74 69 6f 6e 28 29 20 63 61 6c 6c 20 61 osition() call a
6b70: 66 74 65 72 20 65 61 63 68 20 0a 2a 2a 20 73 61 fter each .** sa
6b80: 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e veCursorPosition
6b90: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ()..*/.static in
6ba0: 74 20 62 74 72 65 65 52 65 73 74 6f 72 65 43 75 t btreeRestoreCu
6bb0: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 42 74 43 rsorPosition(BtC
6bc0: 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
6bd0: 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 73 6b int rc;. int sk
6be0: 69 70 4e 65 78 74 3b 0a 20 20 61 73 73 65 72 74 ipNext;. assert
6bf0: 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 ( cursorOwnsBtSh
6c00: 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 ared(pCur) );.
6c10: 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
6c20: 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
6c30: 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 69 66 UIRESEEK );. if
6c40: 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
6c50: 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a CURSOR_FAULT ){.
6c60: 20 20 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d return pCur-
6c70: 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 >skipNext;. }.
6c80: 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
6c90: 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a CURSOR_INVALID;.
6ca0: 20 20 72 63 20 3d 20 62 74 72 65 65 4d 6f 76 65 rc = btreeMove
6cb0: 74 6f 28 70 43 75 72 2c 20 70 43 75 72 2d 3e 70 to(pCur, pCur->p
6cc0: 4b 65 79 2c 20 70 43 75 72 2d 3e 6e 4b 65 79 2c Key, pCur->nKey,
6cd0: 20 30 2c 20 26 73 6b 69 70 4e 65 78 74 29 3b 0a 0, &skipNext);.
6ce0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
6cf0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 _OK ){. sqlit
6d00: 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 4b e3_free(pCur->pK
6d10: 65 79 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 70 ey);. pCur->p
6d20: 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 Key = 0;. ass
6d30: 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
6d40: 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
6d50: 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d || pCur->eState=
6d60: 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 =CURSOR_INVALID
6d70: 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 );. pCur->ski
6d80: 70 4e 65 78 74 20 7c 3d 20 73 6b 69 70 4e 65 78 pNext |= skipNex
6d90: 74 3b 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d t;. if( pCur-
6da0: 3e 73 6b 69 70 4e 65 78 74 20 26 26 20 70 43 75 >skipNext && pCu
6db0: 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
6dc0: 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 20 R_VALID ){.
6dd0: 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
6de0: 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 3b CURSOR_SKIPNEXT;
6df0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
6e00: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 64 65 66 69 urn rc;.}..#defi
6e10: 6e 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 ne restoreCursor
6e20: 50 6f 73 69 74 69 6f 6e 28 70 29 20 5c 0a 20 20 Position(p) \.
6e30: 28 70 2d 3e 65 53 74 61 74 65 3e 3d 43 55 52 53 (p->eState>=CURS
6e40: 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 3f OR_REQUIRESEEK ?
6e50: 20 5c 0a 20 20 20 20 20 20 20 20 20 62 74 72 65 \. btre
6e60: 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f eRestoreCursorPo
6e70: 73 69 74 69 6f 6e 28 70 29 20 3a 20 5c 0a 20 20 sition(p) : \.
6e80: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b SQLITE_OK
6e90: 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 )../*.** Determi
6ea0: 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ne whether or no
6eb0: 74 20 61 20 63 75 72 73 6f 72 20 68 61 73 20 6d t a cursor has m
6ec0: 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 6f oved from the po
6ed0: 73 69 74 69 6f 6e 20 77 68 65 72 65 0a 2a 2a 20 sition where.**
6ee0: 69 74 20 77 61 73 20 6c 61 73 74 20 70 6c 61 63 it was last plac
6ef0: 65 64 2c 20 6f 72 20 68 61 73 20 62 65 65 6e 20 ed, or has been
6f00: 69 6e 76 61 6c 69 64 61 74 65 64 20 66 6f 72 20 invalidated for
6f10: 61 6e 79 20 6f 74 68 65 72 20 72 65 61 73 6f 6e any other reason
6f20: 2e 0a 2a 2a 20 43 75 72 73 6f 72 73 20 63 61 6e ..** Cursors can
6f30: 20 6d 6f 76 65 20 77 68 65 6e 20 74 68 65 20 72 move when the r
6f40: 6f 77 20 74 68 65 79 20 61 72 65 20 70 6f 69 6e ow they are poin
6f50: 74 69 6e 67 20 61 74 20 69 73 20 64 65 6c 65 74 ting at is delet
6f60: 65 64 20 6f 75 74 0a 2a 2a 20 66 72 6f 6d 20 75 ed out.** from u
6f70: 6e 64 65 72 20 74 68 65 6d 2c 20 66 6f 72 20 65 nder them, for e
6f80: 78 61 6d 70 6c 65 2e 20 20 43 75 72 73 6f 72 20 xample. Cursor
6f90: 6d 69 67 68 74 20 61 6c 73 6f 20 6d 6f 76 65 20 might also move
6fa0: 69 66 20 61 20 62 74 72 65 65 0a 2a 2a 20 69 73 if a btree.** is
6fb0: 20 72 65 62 61 6c 61 6e 63 65 64 2e 0a 2a 2a 0a rebalanced..**.
6fc0: 2a 2a 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 ** Calling this
6fd0: 72 6f 75 74 69 6e 65 20 77 69 74 68 20 61 20 4e routine with a N
6fe0: 55 4c 4c 20 63 75 72 73 6f 72 20 70 6f 69 6e 74 ULL cursor point
6ff0: 65 72 20 72 65 74 75 72 6e 73 20 66 61 6c 73 65 er returns false
7000: 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65 20 ..**.** Use the
7010: 73 65 70 61 72 61 74 65 20 73 71 6c 69 74 65 33 separate sqlite3
7020: 42 74 72 65 65 43 75 72 73 6f 72 52 65 73 74 6f BtreeCursorResto
7030: 72 65 28 29 20 72 6f 75 74 69 6e 65 20 74 6f 20 re() routine to
7040: 72 65 73 74 6f 72 65 20 61 20 63 75 72 73 6f 72 restore a cursor
7050: 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 77 68 65 72 .** back to wher
7060: 65 20 69 74 20 6f 75 67 68 74 20 74 6f 20 62 65 e it ought to be
7070: 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 if this routine
7080: 20 72 65 74 75 72 6e 73 20 74 72 75 65 2e 0a 2a returns true..*
7090: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
70a0: 65 65 43 75 72 73 6f 72 48 61 73 4d 6f 76 65 64 eeCursorHasMoved
70b0: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
70c0: 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d {. return pCur-
70d0: 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
70e0: 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 VALID;.}../*.**
70f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 73 This routine res
7100: 74 6f 72 65 73 20 61 20 63 75 72 73 6f 72 20 62 tores a cursor b
7110: 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 69 ack to its origi
7120: 6e 61 6c 20 70 6f 73 69 74 69 6f 6e 20 61 66 74 nal position aft
7130: 65 72 20 69 74 0a 2a 2a 20 68 61 73 20 62 65 65 er it.** has bee
7140: 6e 20 6d 6f 76 65 64 20 62 79 20 73 6f 6d 65 20 n moved by some
7150: 6f 75 74 73 69 64 65 20 61 63 74 69 76 69 74 79 outside activity
7160: 20 28 73 75 63 68 20 61 73 20 61 20 62 74 72 65 (such as a btre
7170: 65 20 72 65 62 61 6c 61 6e 63 65 20 6f 72 0a 2a e rebalance or.*
7180: 2a 20 61 20 72 6f 77 20 68 61 76 69 6e 67 20 62 * a row having b
7190: 65 65 6e 20 64 65 6c 65 74 65 64 20 6f 75 74 20 een deleted out
71a0: 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 20 63 from under the c
71b0: 75 72 73 6f 72 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 ursor). .**.**
71c0: 4f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 65 20 On success, the
71d0: 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 70 *pDifferentRow p
71e0: 61 72 61 6d 65 74 65 72 20 69 73 20 66 61 6c 73 arameter is fals
71f0: 65 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 e if the cursor
7200: 69 73 20 6c 65 66 74 0a 2a 2a 20 70 6f 69 6e 74 is left.** point
7210: 69 6e 67 20 61 74 20 65 78 61 63 74 6c 79 20 74 ing at exactly t
7220: 68 65 20 73 61 6d 65 20 72 6f 77 2e 20 20 2a 70 he same row. *p
7230: 44 69 66 66 65 72 6e 74 52 6f 77 20 69 73 20 74 DifferntRow is t
7240: 68 65 20 72 6f 77 20 74 68 65 20 63 75 72 73 6f he row the curso
7250: 72 0a 2a 2a 20 77 61 73 20 70 6f 69 6e 74 69 6e r.** was pointin
7260: 67 20 74 6f 20 68 61 73 20 62 65 65 6e 20 64 65 g to has been de
7270: 6c 65 74 65 64 2c 20 66 6f 72 63 69 6e 67 20 74 leted, forcing t
7280: 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f 69 he cursor to poi
7290: 6e 74 20 74 6f 20 73 6f 6d 65 0a 2a 2a 20 6e 65 nt to some.** ne
72a0: 61 72 62 79 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a 20 arby row..**.**
72b0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f This routine sho
72c0: 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c uld only be call
72d0: 65 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 20 ed for a cursor
72e0: 74 68 61 74 20 6a 75 73 74 20 72 65 74 75 72 6e that just return
72f0: 65 64 0a 2a 2a 20 54 52 55 45 20 66 72 6f 6d 20 ed.** TRUE from
7300: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
7310: 6f 72 48 61 73 4d 6f 76 65 64 28 29 2e 0a 2a 2f orHasMoved()..*/
7320: 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
7330: 65 43 75 72 73 6f 72 52 65 73 74 6f 72 65 28 42 eCursorRestore(B
7340: 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 tCursor *pCur, i
7350: 6e 74 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f nt *pDifferentRo
7360: 77 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 w){. int rc;..
7370: 20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 assert( pCur!=0
7380: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
7390: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
73a0: 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 72 63 OR_VALID );. rc
73b0: 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 = restoreCursor
73c0: 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a Position(pCur);.
73d0: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
73e0: 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 3d *pDifferentRow =
73f0: 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 1;. return r
7400: 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 75 c;. }. if( pCu
7410: 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
7420: 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a R_VALID ){. *
7430: 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 pDifferentRow =
7440: 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 1;. }else{.
7450: 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
7460: 69 70 4e 65 78 74 3d 3d 30 20 29 3b 0a 20 20 20 ipNext==0 );.
7470: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
7480: 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 = 0;. }. retur
7490: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
74a0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
74b0: 41 42 4c 45 5f 43 55 52 53 4f 52 5f 48 49 4e 54 ABLE_CURSOR_HINT
74c0: 53 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 65 20 S./*.** Provide
74d0: 68 69 6e 74 73 20 74 6f 20 74 68 65 20 63 75 72 hints to the cur
74e0: 73 6f 72 2e 20 20 54 68 65 20 70 61 72 74 69 63 sor. The partic
74f0: 75 6c 61 72 20 68 69 6e 74 20 67 69 76 65 6e 20 ular hint given
7500: 28 61 6e 64 20 74 68 65 20 74 79 70 65 0a 2a 2a (and the type.**
7510: 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f 66 20 74 and number of t
7520: 68 65 20 76 61 72 61 72 67 73 20 70 61 72 61 6d he varargs param
7530: 65 74 65 72 73 29 20 69 73 20 64 65 74 65 72 6d eters) is determ
7540: 69 6e 65 64 20 62 79 20 74 68 65 20 65 48 69 6e ined by the eHin
7550: 74 54 79 70 65 0a 2a 2a 20 70 61 72 61 6d 65 74 tType.** paramet
7560: 65 72 2e 20 20 53 65 65 20 74 68 65 20 64 65 66 er. See the def
7570: 69 6e 69 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 initions of the
7580: 42 54 52 45 45 5f 48 49 4e 54 5f 2a 20 6d 61 63 BTREE_HINT_* mac
7590: 72 6f 73 20 66 6f 72 20 64 65 74 61 69 6c 73 2e ros for details.
75a0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
75b0: 42 74 72 65 65 43 75 72 73 6f 72 48 69 6e 74 28 BtreeCursorHint(
75c0: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
75d0: 69 6e 74 20 65 48 69 6e 74 54 79 70 65 2c 20 2e int eHintType, .
75e0: 2e 2e 29 7b 0a 20 20 2f 2a 20 55 73 65 64 20 6f ..){. /* Used o
75f0: 6e 6c 79 20 62 79 20 73 79 73 74 65 6d 20 74 68 nly by system th
7600: 61 74 20 73 75 62 73 74 69 74 75 74 65 20 74 68 at substitute th
7610: 65 69 72 20 6f 77 6e 20 73 74 6f 72 61 67 65 20 eir own storage
7620: 65 6e 67 69 6e 65 20 2a 2f 0a 7d 0a 23 65 6e 64 engine */.}.#end
7630: 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 if../*.** Provid
7640: 65 20 66 6c 61 67 20 68 69 6e 74 73 20 74 6f 20 e flag hints to
7650: 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 76 the cursor..*/.v
7660: 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 oid sqlite3Btree
7670: 43 75 72 73 6f 72 48 69 6e 74 46 6c 61 67 73 28 CursorHintFlags(
7680: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
7690: 75 6e 73 69 67 6e 65 64 20 78 29 7b 0a 20 20 61 unsigned x){. a
76a0: 73 73 65 72 74 28 20 78 3d 3d 42 54 52 45 45 5f ssert( x==BTREE_
76b0: 53 45 45 4b 5f 45 51 20 7c 7c 20 78 3d 3d 42 54 SEEK_EQ || x==BT
76c0: 52 45 45 5f 42 55 4c 4b 4c 4f 41 44 20 7c 7c 20 REE_BULKLOAD ||
76d0: 78 3d 3d 30 20 29 3b 0a 20 20 70 43 75 72 2d 3e x==0 );. pCur->
76e0: 68 69 6e 74 73 20 3d 20 78 3b 0a 7d 0a 0a 0a 23 hints = x;.}...#
76f0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
7700: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a IT_AUTOVACUUM./*
7710: 0a 2a 2a 20 47 69 76 65 6e 20 61 20 70 61 67 65 .** Given a page
7720: 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 72 65 67 number of a reg
7730: 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 70 61 ular database pa
7740: 67 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 70 ge, return the p
7750: 61 67 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f age.** number fo
7760: 72 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 r the pointer-ma
7770: 70 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 p page that cont
7780: 61 69 6e 73 20 74 68 65 20 65 6e 74 72 79 20 66 ains the entry f
7790: 6f 72 20 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 or the.** input
77a0: 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a page number..**.
77b0: 2a 2a 20 52 65 74 75 72 6e 20 30 20 28 6e 6f 74 ** Return 0 (not
77c0: 20 61 20 76 61 6c 69 64 20 70 61 67 65 29 20 66 a valid page) f
77d0: 6f 72 20 70 67 6e 6f 3d 3d 31 20 73 69 6e 63 65 or pgno==1 since
77e0: 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 6e 6f 20 there is.** no
77f0: 70 6f 69 6e 74 65 72 20 6d 61 70 20 61 73 73 6f pointer map asso
7800: 63 69 61 74 65 64 20 77 69 74 68 20 70 61 67 65 ciated with page
7810: 20 31 2e 20 20 54 68 65 20 69 6e 74 65 67 72 69 1. The integri
7820: 74 79 5f 63 68 65 63 6b 20 6c 6f 67 69 63 0a 2a ty_check logic.*
7830: 2a 20 72 65 71 75 69 72 65 73 20 74 68 61 74 20 * requires that
7840: 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 2a 2c 31 ptrmapPageno(*,1
7850: 29 21 3d 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 )!=1..*/.static
7860: 50 67 6e 6f 20 70 74 72 6d 61 70 50 61 67 65 6e Pgno ptrmapPagen
7870: 6f 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c o(BtShared *pBt,
7880: 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 Pgno pgno){. i
7890: 6e 74 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 nt nPagesPerMapP
78a0: 61 67 65 3b 0a 20 20 50 67 6e 6f 20 69 50 74 72 age;. Pgno iPtr
78b0: 4d 61 70 2c 20 72 65 74 3b 0a 20 20 61 73 73 65 Map, ret;. asse
78c0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
78d0: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
78e0: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 67 6e 6f x) );. if( pgno
78f0: 3c 32 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 <2 ) return 0;.
7900: 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 nPagesPerMapPag
7910: 65 20 3d 20 28 70 42 74 2d 3e 75 73 61 62 6c 65 e = (pBt->usable
7920: 53 69 7a 65 2f 35 29 2b 31 3b 0a 20 20 69 50 74 Size/5)+1;. iPt
7930: 72 4d 61 70 20 3d 20 28 70 67 6e 6f 2d 32 29 2f rMap = (pgno-2)/
7940: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
7950: 3b 0a 20 20 72 65 74 20 3d 20 28 69 50 74 72 4d ;. ret = (iPtrM
7960: 61 70 2a 6e 50 61 67 65 73 50 65 72 4d 61 70 50 ap*nPagesPerMapP
7970: 61 67 65 29 20 2b 20 32 3b 20 0a 20 20 69 66 28 age) + 2; . if(
7980: 20 72 65 74 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 ret==PENDING_BY
7990: 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
79a0: 20 20 20 20 72 65 74 2b 2b 3b 0a 20 20 7d 0a 20 ret++;. }.
79b0: 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a return ret;.}..
79c0: 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 6e 20 65 /*.** Write an e
79d0: 6e 74 72 79 20 69 6e 74 6f 20 74 68 65 20 70 6f ntry into the po
79e0: 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a inter map..**.**
79f0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 75 70 This routine up
7a00: 64 61 74 65 73 20 74 68 65 20 70 6f 69 6e 74 65 dates the pointe
7a10: 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 20 r map entry for
7a20: 70 61 67 65 20 6e 75 6d 62 65 72 20 27 6b 65 79 page number 'key
7a30: 27 0a 2a 2a 20 73 6f 20 74 68 61 74 20 69 74 20 '.** so that it
7a40: 6d 61 70 73 20 74 6f 20 74 79 70 65 20 27 65 54 maps to type 'eT
7a50: 79 70 65 27 20 61 6e 64 20 70 61 72 65 6e 74 20 ype' and parent
7a60: 70 61 67 65 20 6e 75 6d 62 65 72 20 27 70 67 6e page number 'pgn
7a70: 6f 27 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 52 o'..**.** If *pR
7a80: 43 20 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e C is initially n
7a90: 6f 6e 2d 7a 65 72 6f 20 28 6e 6f 6e 2d 53 51 4c on-zero (non-SQL
7aa0: 49 54 45 5f 4f 4b 29 20 74 68 65 6e 20 74 68 69 ITE_OK) then thi
7ab0: 73 20 72 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 s routine is.**
7ac0: 61 20 6e 6f 2d 6f 70 2e 20 20 49 66 20 61 6e 20 a no-op. If an
7ad0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
7ae0: 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 e appropriate er
7af0: 72 6f 72 20 63 6f 64 65 20 69 73 20 77 72 69 74 ror code is writ
7b00: 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 2a 70 52 43 ten.** into *pRC
7b10: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
7b20: 20 70 74 72 6d 61 70 50 75 74 28 42 74 53 68 61 ptrmapPut(BtSha
7b30: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b red *pBt, Pgno k
7b40: 65 79 2c 20 75 38 20 65 54 79 70 65 2c 20 50 67 ey, u8 eType, Pg
7b50: 6e 6f 20 70 61 72 65 6e 74 2c 20 69 6e 74 20 2a no parent, int *
7b60: 70 52 43 29 7b 0a 20 20 44 62 50 61 67 65 20 2a pRC){. DbPage *
7b70: 70 44 62 50 61 67 65 3b 20 20 2f 2a 20 54 68 65 pDbPage; /* The
7b80: 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 pointer map pag
7b90: 65 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d e */. u8 *pPtrm
7ba0: 61 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ap; /* The
7bb0: 70 6f 69 6e 74 65 72 20 6d 61 70 20 64 61 74 61 pointer map data
7bc0: 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 50 74 72 6d */. Pgno iPtrm
7bd0: 61 70 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 70 ap; /* The p
7be0: 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 ointer map page
7bf0: 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 69 6e 74 20 number */. int
7c00: 6f 66 66 73 65 74 3b 20 20 20 20 20 20 20 2f 2a offset; /*
7c10: 20 4f 66 66 73 65 74 20 69 6e 20 70 6f 69 6e 74 Offset in point
7c20: 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 er map page */.
7c30: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
7c40: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
7c50: 65 20 66 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 e from subfuncti
7c60: 6f 6e 73 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 ons */.. if( *p
7c70: 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 RC ) return;..
7c80: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
7c90: 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
7ca0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 mutex) );. /* T
7cb0: 68 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 he master-journa
7cc0: 6c 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6d 75 l page number mu
7cd0: 73 74 20 6e 65 76 65 72 20 62 65 20 75 73 65 64 st never be used
7ce0: 20 61 73 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 as a pointer ma
7cf0: 70 20 70 61 67 65 20 2a 2f 0a 20 20 61 73 73 65 p page */. asse
7d00: 72 74 28 20 30 3d 3d 50 54 52 4d 41 50 5f 49 53 rt( 0==PTRMAP_IS
7d10: 50 41 47 45 28 70 42 74 2c 20 50 45 4e 44 49 4e PAGE(pBt, PENDIN
7d20: 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
7d30: 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ) );.. assert(
7d40: 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
7d50: 29 3b 0a 20 20 69 66 28 20 6b 65 79 3d 3d 30 20 );. if( key==0
7d60: 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 ){. *pRC = SQ
7d70: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
7d80: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 T;. return;.
7d90: 20 7d 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 }. iPtrmap = P
7da0: 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 TRMAP_PAGENO(pBt
7db0: 2c 20 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 , key);. rc = s
7dc0: 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
7dd0: 42 74 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 Bt->pPager, iPtr
7de0: 6d 61 70 2c 20 26 70 44 62 50 61 67 65 2c 20 30 map, &pDbPage, 0
7df0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
7e00: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 ITE_OK ){. *p
7e10: 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 65 74 RC = rc;. ret
7e20: 75 72 6e 3b 0a 20 20 7d 0a 20 20 6f 66 66 73 65 urn;. }. offse
7e30: 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f 46 t = PTRMAP_PTROF
7e40: 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b 65 FSET(iPtrmap, ke
7e50: 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 74 y);. if( offset
7e60: 3c 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d <0 ){. *pRC =
7e70: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
7e80: 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 70 BKPT;. goto p
7e90: 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 20 7d 0a trmap_exit;. }.
7ea0: 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 assert( offset
7eb0: 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e 75 73 <= (int)pBt->us
7ec0: 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a 20 20 ableSize-5 );.
7ed0: 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 2a 29 pPtrmap = (u8 *)
7ee0: 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 sqlite3PagerGetD
7ef0: 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a 0a 20 ata(pDbPage);..
7f00: 20 69 66 28 20 65 54 79 70 65 21 3d 70 50 74 72 if( eType!=pPtr
7f10: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 7c 7c 20 67 map[offset] || g
7f20: 65 74 34 62 79 74 65 28 26 70 50 74 72 6d 61 70 et4byte(&pPtrmap
7f30: 5b 6f 66 66 73 65 74 2b 31 5d 29 21 3d 70 61 72 [offset+1])!=par
7f40: 65 6e 74 20 29 7b 0a 20 20 20 20 54 52 41 43 45 ent ){. TRACE
7f50: 28 28 22 50 54 52 4d 41 50 5f 55 50 44 41 54 45 (("PTRMAP_UPDATE
7f60: 3a 20 25 64 2d 3e 28 25 64 2c 25 64 29 5c 6e 22 : %d->(%d,%d)\n"
7f70: 2c 20 6b 65 79 2c 20 65 54 79 70 65 2c 20 70 61 , key, eType, pa
7f80: 72 65 6e 74 29 29 3b 0a 20 20 20 20 2a 70 52 43 rent));. *pRC
7f90: 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 = rc = sqlite3Pa
7fa0: 67 65 72 57 72 69 74 65 28 70 44 62 50 61 67 65 gerWrite(pDbPage
7fb0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
7fc0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
7fd0: 20 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 74 pPtrmap[offset
7fe0: 5d 20 3d 20 65 54 79 70 65 3b 0a 20 20 20 20 20 ] = eType;.
7ff0: 20 70 75 74 34 62 79 74 65 28 26 70 50 74 72 6d put4byte(&pPtrm
8000: 61 70 5b 6f 66 66 73 65 74 2b 31 5d 2c 20 70 61 ap[offset+1], pa
8010: 72 65 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d rent);. }. }
8020: 0a 0a 70 74 72 6d 61 70 5f 65 78 69 74 3a 0a 20 ..ptrmap_exit:.
8030: 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
8040: 65 66 28 70 44 62 50 61 67 65 29 3b 0a 7d 0a 0a ef(pDbPage);.}..
8050: 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 6e 20 65 6e /*.** Read an en
8060: 74 72 79 20 66 72 6f 6d 20 74 68 65 20 70 6f 69 try from the poi
8070: 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 nter map..**.**
8080: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 This routine ret
8090: 72 69 65 76 65 73 20 74 68 65 20 70 6f 69 6e 74 rieves the point
80a0: 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 er map entry for
80b0: 20 70 61 67 65 20 27 6b 65 79 27 2c 20 77 72 69 page 'key', wri
80c0: 74 69 6e 67 0a 2a 2a 20 74 68 65 20 74 79 70 65 ting.** the type
80d0: 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 67 65 and parent page
80e0: 20 6e 75 6d 62 65 72 20 74 6f 20 2a 70 45 54 79 number to *pETy
80f0: 70 65 20 61 6e 64 20 2a 70 50 67 6e 6f 20 72 65 pe and *pPgno re
8100: 73 70 65 63 74 69 76 65 6c 79 2e 0a 2a 2a 20 41 spectively..** A
8110: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 n error code is
8120: 72 65 74 75 72 6e 65 64 20 69 66 20 73 6f 6d 65 returned if some
8130: 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 thing goes wrong
8140: 2c 20 6f 74 68 65 72 77 69 73 65 20 53 51 4c 49 , otherwise SQLI
8150: 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 TE_OK..*/.static
8160: 20 69 6e 74 20 70 74 72 6d 61 70 47 65 74 28 42 int ptrmapGet(B
8170: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
8180: 6e 6f 20 6b 65 79 2c 20 75 38 20 2a 70 45 54 79 no key, u8 *pETy
8190: 70 65 2c 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 29 pe, Pgno *pPgno)
81a0: 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 {. DbPage *pDbP
81b0: 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 70 6f age; /* The po
81c0: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 2a inter map page *
81d0: 2f 0a 20 20 69 6e 74 20 69 50 74 72 6d 61 70 3b /. int iPtrmap;
81e0: 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
81f0: 72 20 6d 61 70 20 70 61 67 65 20 69 6e 64 65 78 r map page index
8200: 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d 61 */. u8 *pPtrma
8210: 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e p; /* Poin
8220: 74 65 72 20 6d 61 70 20 70 61 67 65 20 64 61 74 ter map page dat
8230: 61 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 73 65 a */. int offse
8240: 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 t; /* Off
8250: 73 65 74 20 6f 66 20 65 6e 74 72 79 20 69 6e 20 set of entry in
8260: 70 6f 69 6e 74 65 72 20 6d 61 70 20 2a 2f 0a 20 pointer map */.
8270: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
8280: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
8290: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
82a0: 78 29 20 29 3b 0a 0a 20 20 69 50 74 72 6d 61 70 x) );.. iPtrmap
82b0: 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f = PTRMAP_PAGENO
82c0: 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 72 63 (pBt, key);. rc
82d0: 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 = sqlite3PagerG
82e0: 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 et(pBt->pPager,
82f0: 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 61 67 iPtrmap, &pDbPag
8300: 65 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 e, 0);. if( rc!
8310: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e =0 ){. return
8320: 20 72 63 3b 0a 20 20 7d 0a 20 20 70 50 74 72 6d rc;. }. pPtrm
8330: 61 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 ap = (u8 *)sqlit
8340: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
8350: 44 62 50 61 67 65 29 3b 0a 0a 20 20 6f 66 66 73 DbPage);.. offs
8360: 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f et = PTRMAP_PTRO
8370: 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b FFSET(iPtrmap, k
8380: 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 ey);. if( offse
8390: 74 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 t<0 ){. sqlit
83a0: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
83b0: 50 61 67 65 29 3b 0a 20 20 20 20 72 65 74 75 72 Page);. retur
83c0: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
83d0: 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 _BKPT;. }. ass
83e0: 65 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 ert( offset <= (
83f0: 69 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 int)pBt->usableS
8400: 69 7a 65 2d 35 20 29 3b 0a 20 20 61 73 73 65 72 ize-5 );. asser
8410: 74 28 20 70 45 54 79 70 65 21 3d 30 20 29 3b 0a t( pEType!=0 );.
8420: 20 20 2a 70 45 54 79 70 65 20 3d 20 70 50 74 72 *pEType = pPtr
8430: 6d 61 70 5b 6f 66 66 73 65 74 5d 3b 0a 20 20 69 map[offset];. i
8440: 66 28 20 70 50 67 6e 6f 20 29 20 2a 70 50 67 6e f( pPgno ) *pPgn
8450: 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 o = get4byte(&pP
8460: 74 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 trmap[offset+1])
8470: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 ;.. sqlite3Page
8480: 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b rUnref(pDbPage);
8490: 0a 20 20 69 66 28 20 2a 70 45 54 79 70 65 3c 31 . if( *pEType<1
84a0: 20 7c 7c 20 2a 70 45 54 79 70 65 3e 35 20 29 20 || *pEType>5 )
84b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
84c0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 72 65 RRUPT_BKPT;. re
84d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
84e0: 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 64 }..#else /* if d
84f0: 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4d efined SQLITE_OM
8500: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f IT_AUTOVACUUM */
8510: 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 . #define ptrma
8520: 70 50 75 74 28 77 2c 78 2c 79 2c 7a 2c 72 63 29 pPut(w,x,y,z,rc)
8530: 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 . #define ptrma
8540: 70 47 65 74 28 77 2c 78 2c 79 2c 7a 29 20 53 51 pGet(w,x,y,z) SQ
8550: 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 69 6e LITE_OK. #defin
8560: 65 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 e ptrmapPutOvflP
8570: 74 72 28 78 2c 20 79 2c 20 72 63 29 0a 23 65 6e tr(x, y, rc).#en
8580: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e dif../*.** Given
8590: 20 61 20 62 74 72 65 65 20 70 61 67 65 20 61 6e a btree page an
85a0: 64 20 61 20 63 65 6c 6c 20 69 6e 64 65 78 20 28 d a cell index (
85b0: 30 20 6d 65 61 6e 73 20 74 68 65 20 66 69 72 73 0 means the firs
85c0: 74 20 63 65 6c 6c 20 6f 6e 0a 2a 2a 20 74 68 65 t cell on.** the
85d0: 20 70 61 67 65 2c 20 31 20 6d 65 61 6e 73 20 74 page, 1 means t
85e0: 68 65 20 73 65 63 6f 6e 64 20 63 65 6c 6c 2c 20 he second cell,
85f0: 61 6e 64 20 73 6f 20 66 6f 72 74 68 29 20 72 65 and so forth) re
8600: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 0a 2a turn a pointer.*
8610: 2a 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f * to the cell co
8620: 6e 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 66 69 6e ntent..**.** fin
8630: 64 43 65 6c 6c 50 61 73 74 50 74 72 28 29 20 64 dCellPastPtr() d
8640: 6f 65 73 20 74 68 65 20 73 61 6d 65 20 65 78 63 oes the same exc
8650: 65 70 74 20 69 74 20 73 6b 69 70 73 20 70 61 73 ept it skips pas
8660: 74 20 74 68 65 20 69 6e 69 74 69 61 6c 0a 2a 2a t the initial.**
8670: 20 34 2d 62 79 74 65 20 63 68 69 6c 64 20 70 6f 4-byte child po
8680: 69 6e 74 65 72 20 66 6f 75 6e 64 20 6f 6e 20 69 inter found on i
8690: 6e 74 65 72 69 6f 72 20 70 61 67 65 73 2c 20 69 nterior pages, i
86a0: 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 2e 0a f there is one..
86b0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
86c0: 6e 65 20 77 6f 72 6b 73 20 6f 6e 6c 79 20 66 6f ne works only fo
86d0: 72 20 70 61 67 65 73 20 74 68 61 74 20 64 6f 20 r pages that do
86e0: 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 not contain over
86f0: 66 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 23 flow cells..*/.#
8700: 64 65 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c 28 define findCell(
8710: 50 2c 49 29 20 5c 0a 20 20 28 28 50 29 2d 3e 61 P,I) \. ((P)->a
8720: 44 61 74 61 20 2b 20 28 28 50 29 2d 3e 6d 61 73 Data + ((P)->mas
8730: 6b 50 61 67 65 20 26 20 67 65 74 32 62 79 74 65 kPage & get2byte
8740: 41 6c 69 67 6e 65 64 28 26 28 50 29 2d 3e 61 43 Aligned(&(P)->aC
8750: 65 6c 6c 49 64 78 5b 32 2a 28 49 29 5d 29 29 29 ellIdx[2*(I)])))
8760: 0a 23 64 65 66 69 6e 65 20 66 69 6e 64 43 65 6c .#define findCel
8770: 6c 50 61 73 74 50 74 72 28 50 2c 49 29 20 5c 0a lPastPtr(P,I) \.
8780: 20 20 28 28 50 29 2d 3e 61 44 61 74 61 4f 66 73 ((P)->aDataOfs
8790: 74 20 2b 20 28 28 50 29 2d 3e 6d 61 73 6b 50 61 t + ((P)->maskPa
87a0: 67 65 20 26 20 67 65 74 32 62 79 74 65 41 6c 69 ge & get2byteAli
87b0: 67 6e 65 64 28 26 28 50 29 2d 3e 61 43 65 6c 6c gned(&(P)->aCell
87c0: 49 64 78 5b 32 2a 28 49 29 5d 29 29 29 0a 0a 0a Idx[2*(I)])))...
87d0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 63 6f /*.** This is co
87e0: 6d 6d 6f 6e 20 74 61 69 6c 20 70 72 6f 63 65 73 mmon tail proces
87f0: 73 69 6e 67 20 66 6f 72 20 62 74 72 65 65 50 61 sing for btreePa
8800: 72 73 65 43 65 6c 6c 50 74 72 28 29 20 61 6e 64 rseCellPtr() and
8810: 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 43 65 .** btreeParseCe
8820: 6c 6c 50 74 72 49 6e 64 65 78 28 29 20 66 6f 72 llPtrIndex() for
8830: 20 74 68 65 20 63 61 73 65 20 77 68 65 6e 20 74 the case when t
8840: 68 65 20 63 65 6c 6c 20 64 6f 65 73 20 6e 6f 74 he cell does not
8850: 20 66 69 74 20 65 6e 74 69 72 65 6c 79 0a 2a 2a fit entirely.**
8860: 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 42 2d 74 on a single B-t
8870: 72 65 65 20 70 61 67 65 2e 20 20 4d 61 6b 65 20 ree page. Make
8880: 6e 65 63 65 73 73 61 72 79 20 61 64 6a 75 73 74 necessary adjust
8890: 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 43 65 6c ments to the Cel
88a0: 6c 49 6e 66 6f 0a 2a 2a 20 73 74 72 75 63 74 75 lInfo.** structu
88b0: 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 re..*/.static SQ
88c0: 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f LITE_NOINLINE vo
88d0: 69 64 20 62 74 72 65 65 50 61 72 73 65 43 65 6c id btreeParseCel
88e0: 6c 41 64 6a 75 73 74 53 69 7a 65 46 6f 72 4f 76 lAdjustSizeForOv
88f0: 65 72 66 6c 6f 77 28 0a 20 20 4d 65 6d 50 61 67 erflow(. MemPag
8900: 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 e *pPage,
8910: 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 /* Page contai
8920: 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f ning the cell */
8930: 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 . u8 *pCell,
8940: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
8950: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 65 6c inter to the cel
8960: 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c l text. */. Cel
8970: 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 lInfo *pInfo
8980: 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 /* Fill in
8990: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a this structure *
89a0: 2f 0a 29 7b 0a 20 20 2f 2a 20 49 66 20 74 68 65 /.){. /* If the
89b0: 20 70 61 79 6c 6f 61 64 20 77 69 6c 6c 20 6e 6f payload will no
89c0: 74 20 66 69 74 20 63 6f 6d 70 6c 65 74 65 6c 79 t fit completely
89d0: 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 on the local pa
89e0: 67 65 2c 20 77 65 20 68 61 76 65 0a 20 20 2a 2a ge, we have. **
89f0: 20 74 6f 20 64 65 63 69 64 65 20 68 6f 77 20 6d to decide how m
8a00: 75 63 68 20 74 6f 20 73 74 6f 72 65 20 6c 6f 63 uch to store loc
8a10: 61 6c 6c 79 20 61 6e 64 20 68 6f 77 20 6d 75 63 ally and how muc
8a20: 68 20 74 6f 20 73 70 69 6c 6c 20 6f 6e 74 6f 0a h to spill onto.
8a30: 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 ** overflow pa
8a40: 67 65 73 2e 20 20 54 68 65 20 73 74 72 61 74 65 ges. The strate
8a50: 67 79 20 69 73 20 74 6f 20 6d 69 6e 69 6d 69 7a gy is to minimiz
8a60: 65 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 e the amount of
8a70: 75 6e 75 73 65 64 0a 20 20 2a 2a 20 73 70 61 63 unused. ** spac
8a80: 65 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 e on overflow pa
8a90: 67 65 73 20 77 68 69 6c 65 20 6b 65 65 70 69 6e ges while keepin
8aa0: 67 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 g the amount of
8ab0: 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 0a 20 20 local storage.
8ac0: 2a 2a 20 69 6e 20 62 65 74 77 65 65 6e 20 6d 69 ** in between mi
8ad0: 6e 4c 6f 63 61 6c 20 61 6e 64 20 6d 61 78 4c 6f nLocal and maxLo
8ae0: 63 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 cal.. **. ** W
8af0: 61 72 6e 69 6e 67 3a 20 20 63 68 61 6e 67 69 6e arning: changin
8b00: 67 20 74 68 65 20 77 61 79 20 6f 76 65 72 66 6c g the way overfl
8b10: 6f 77 20 70 61 79 6c 6f 61 64 20 69 73 20 64 69 ow payload is di
8b20: 73 74 72 69 62 75 74 65 64 20 69 6e 20 61 6e 79 stributed in any
8b30: 0a 20 20 2a 2a 20 77 61 79 20 77 69 6c 6c 20 72 . ** way will r
8b40: 65 73 75 6c 74 20 69 6e 20 61 6e 20 69 6e 63 6f esult in an inco
8b50: 6d 70 61 74 69 62 6c 65 20 66 69 6c 65 20 66 6f mpatible file fo
8b60: 72 6d 61 74 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74 rmat.. */. int
8b70: 20 6d 69 6e 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d minLocal; /* M
8b80: 69 6e 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 inimum amount of
8b90: 20 70 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f payload held lo
8ba0: 63 61 6c 6c 79 20 2a 2f 0a 20 20 69 6e 74 20 6d cally */. int m
8bb0: 61 78 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d 61 78 axLocal; /* Max
8bc0: 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 70 imum amount of p
8bd0: 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f 63 61 ayload held loca
8be0: 6c 6c 79 20 2a 2f 0a 20 20 69 6e 74 20 73 75 72 lly */. int sur
8bf0: 70 6c 75 73 3b 20 20 20 2f 2a 20 4f 76 65 72 66 plus; /* Overf
8c00: 6c 6f 77 20 70 61 79 6c 6f 61 64 20 61 76 61 69 low payload avai
8c10: 6c 61 62 6c 65 20 66 6f 72 20 6c 6f 63 61 6c 20 lable for local
8c20: 73 74 6f 72 61 67 65 20 2a 2f 0a 0a 20 20 6d 69 storage */.. mi
8c30: 6e 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e nLocal = pPage->
8c40: 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 6d 61 78 4c minLocal;. maxL
8c50: 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 61 ocal = pPage->ma
8c60: 78 4c 6f 63 61 6c 3b 0a 20 20 73 75 72 70 6c 75 xLocal;. surplu
8c70: 73 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 28 s = minLocal + (
8c80: 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 pInfo->nPayload
8c90: 2d 20 6d 69 6e 4c 6f 63 61 6c 29 25 28 70 50 61 - minLocal)%(pPa
8ca0: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
8cb0: 69 7a 65 2d 34 29 3b 0a 20 20 74 65 73 74 63 61 ize-4);. testca
8cc0: 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 se( surplus==max
8cd0: 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 Local );. testc
8ce0: 61 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 ase( surplus==ma
8cf0: 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 69 66 xLocal+1 );. if
8d00: 28 20 73 75 72 70 6c 75 73 20 3c 3d 20 6d 61 78 ( surplus <= max
8d10: 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 70 49 6e Local ){. pIn
8d20: 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 fo->nLocal = (u1
8d30: 36 29 73 75 72 70 6c 75 73 3b 0a 20 20 7d 65 6c 6)surplus;. }el
8d40: 73 65 7b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e se{. pInfo->n
8d50: 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 6d 69 6e Local = (u16)min
8d60: 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 70 49 6e Local;. }. pIn
8d70: 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 28 75 31 36 fo->nSize = (u16
8d80: 29 28 26 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f )(&pInfo->pPaylo
8d90: 61 64 5b 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c ad[pInfo->nLocal
8da0: 5d 20 2d 20 70 43 65 6c 6c 29 20 2b 20 34 3b 0a ] - pCell) + 4;.
8db0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c }../*.** The fol
8dc0: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 lowing routines
8dd0: 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 are implementati
8de0: 6f 6e 73 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 ons of the MemPa
8df0: 67 65 2e 78 50 61 72 73 65 43 65 6c 6c 28 29 0a ge.xParseCell().
8e00: 2a 2a 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a ** method..**.**
8e10: 20 50 61 72 73 65 20 61 20 63 65 6c 6c 20 63 6f Parse a cell co
8e20: 6e 74 65 6e 74 20 62 6c 6f 63 6b 20 61 6e 64 20 ntent block and
8e30: 66 69 6c 6c 20 69 6e 20 74 68 65 20 43 65 6c 6c fill in the Cell
8e40: 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 2e 0a Info structure..
8e50: 2a 2a 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 **.** btreeParse
8e60: 43 65 6c 6c 50 74 72 28 29 20 20 20 20 20 20 20 CellPtr()
8e70: 20 3d 3e 20 20 20 74 61 62 6c 65 20 62 74 72 65 => table btre
8e80: 65 20 6c 65 61 66 20 6e 6f 64 65 73 0a 2a 2a 20 e leaf nodes.**
8e90: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 4e 6f btreeParseCellNo
8ea0: 50 61 79 6c 6f 61 64 28 29 20 20 3d 3e 20 20 20 Payload() =>
8eb0: 74 61 62 6c 65 20 62 74 72 65 65 20 69 6e 74 65 table btree inte
8ec0: 72 6e 61 6c 20 6e 6f 64 65 73 0a 2a 2a 20 62 74 rnal nodes.** bt
8ed0: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 49 reeParseCellPtrI
8ee0: 6e 64 65 78 28 29 20 20 20 3d 3e 20 20 20 69 6e ndex() => in
8ef0: 64 65 78 20 62 74 72 65 65 20 6e 6f 64 65 73 0a dex btree nodes.
8f00: 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73 20 61 **.** There is a
8f10: 6c 73 6f 20 61 20 77 72 61 70 70 65 72 20 66 75 lso a wrapper fu
8f20: 6e 63 74 69 6f 6e 20 62 74 72 65 65 50 61 72 73 nction btreePars
8f30: 65 43 65 6c 6c 28 29 20 74 68 61 74 20 77 6f 72 eCell() that wor
8f40: 6b 73 20 66 6f 72 0a 2a 2a 20 61 6c 6c 20 4d 65 ks for.** all Me
8f50: 6d 50 61 67 65 20 74 79 70 65 73 20 61 6e 64 20 mPage types and
8f60: 74 68 61 74 20 72 65 66 65 72 65 6e 63 65 73 20 that references
8f70: 74 68 65 20 63 65 6c 6c 20 62 79 20 69 6e 64 65 the cell by inde
8f80: 78 20 72 61 74 68 65 72 20 74 68 61 6e 0a 2a 2a x rather than.**
8f90: 20 62 79 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a by pointer..*/.
8fa0: 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 static void btre
8fb0: 65 50 61 72 73 65 43 65 6c 6c 50 74 72 4e 6f 50 eParseCellPtrNoP
8fc0: 61 79 6c 6f 61 64 28 0a 20 20 4d 65 6d 50 61 67 ayload(. MemPag
8fd0: 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 e *pPage,
8fe0: 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 /* Page contai
8ff0: 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f ning the cell */
9000: 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 . u8 *pCell,
9010: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
9020: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 65 6c inter to the cel
9030: 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c l text. */. Cel
9040: 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 lInfo *pInfo
9050: 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 /* Fill in
9060: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a this structure *
9070: 2f 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 /.){. assert( s
9080: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
9090: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
90a0: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
90b0: 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 ( pPage->leaf==0
90c0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
90d0: 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
90e0: 65 3d 3d 34 20 29 3b 0a 23 69 66 6e 64 65 66 20 e==4 );.#ifndef
90f0: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 55 SQLITE_DEBUG. U
9100: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
9110: 70 50 61 67 65 29 3b 0a 23 65 6e 64 69 66 0a 20 pPage);.#endif.
9120: 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 pInfo->nSize =
9130: 34 20 2b 20 67 65 74 56 61 72 69 6e 74 28 26 70 4 + getVarint(&p
9140: 43 65 6c 6c 5b 34 5d 2c 20 28 75 36 34 2a 29 26 Cell[4], (u64*)&
9150: 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a 20 20 pInfo->nKey);.
9160: 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 pInfo->nPayload
9170: 3d 20 30 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 4c = 0;. pInfo->nL
9180: 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 70 49 6e 66 ocal = 0;. pInf
9190: 6f 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 30 3b o->pPayload = 0;
91a0: 0a 20 20 72 65 74 75 72 6e 3b 0a 7d 0a 73 74 61 . return;.}.sta
91b0: 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 50 61 tic void btreePa
91c0: 72 73 65 43 65 6c 6c 50 74 72 28 0a 20 20 4d 65 rseCellPtr(. Me
91d0: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
91e0: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f /* Page co
91f0: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c ntaining the cel
9200: 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c l */. u8 *pCell
9210: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
9220: 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 * Pointer to the
9230: 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 cell text. */.
9240: 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f CellInfo *pInfo
9250: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c /* Fill
9260: 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 in this structu
9270: 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 re */.){. u8 *p
9280: 49 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 Iter;
9290: 20 20 20 2f 2a 20 46 6f 72 20 73 63 61 6e 6e 69 /* For scanni
92a0: 6e 67 20 74 68 72 6f 75 67 68 20 70 43 65 6c 6c ng through pCell
92b0: 20 2a 2f 0a 20 20 75 33 32 20 6e 50 61 79 6c 6f */. u32 nPaylo
92c0: 61 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ad; /*
92d0: 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 Number of bytes
92e0: 20 6f 66 20 63 65 6c 6c 20 70 61 79 6c 6f 61 64 of cell payload
92f0: 20 2a 2f 0a 20 20 75 36 34 20 69 4b 65 79 3b 20 */. u64 iKey;
9300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9310: 20 45 78 74 72 61 63 74 65 64 20 4b 65 79 20 76 Extracted Key v
9320: 61 6c 75 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 alue */.. asser
9330: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
9340: 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
9350: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
9360: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 sert( pPage->lea
9370: 66 3d 3d 30 20 7c 7c 20 70 50 61 67 65 2d 3e 6c f==0 || pPage->l
9380: 65 61 66 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 eaf==1 );. asse
9390: 72 74 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 rt( pPage->intKe
93a0: 79 4c 65 61 66 20 29 3b 0a 20 20 61 73 73 65 72 yLeaf );. asser
93b0: 74 28 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 t( pPage->childP
93c0: 74 72 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 70 trSize==0 );. p
93d0: 49 74 65 72 20 3d 20 70 43 65 6c 6c 3b 0a 0a 20 Iter = pCell;..
93e0: 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 62 6c 6f /* The next blo
93f0: 63 6b 20 6f 66 20 63 6f 64 65 20 69 73 20 65 71 ck of code is eq
9400: 75 69 76 61 6c 65 6e 74 20 74 6f 3a 0a 20 20 2a uivalent to:. *
9410: 2a 0a 20 20 2a 2a 20 20 20 20 20 70 49 74 65 72 *. ** pIter
9420: 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 32 28 += getVarint32(
9430: 70 49 74 65 72 2c 20 6e 50 61 79 6c 6f 61 64 29 pIter, nPayload)
9440: 3b 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 ;. **. ** The
9450: 63 6f 64 65 20 69 73 20 69 6e 6c 69 6e 65 64 20 code is inlined
9460: 74 6f 20 61 76 6f 69 64 20 61 20 66 75 6e 63 74 to avoid a funct
9470: 69 6f 6e 20 63 61 6c 6c 2e 0a 20 20 2a 2f 0a 20 ion call.. */.
9480: 20 6e 50 61 79 6c 6f 61 64 20 3d 20 2a 70 49 74 nPayload = *pIt
9490: 65 72 3b 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f er;. if( nPaylo
94a0: 61 64 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 ad>=0x80 ){.
94b0: 75 38 20 2a 70 45 6e 64 20 3d 20 26 70 49 74 65 u8 *pEnd = &pIte
94c0: 72 5b 38 5d 3b 0a 20 20 20 20 6e 50 61 79 6c 6f r[8];. nPaylo
94d0: 61 64 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 ad &= 0x7f;.
94e0: 64 6f 7b 0a 20 20 20 20 20 20 6e 50 61 79 6c 6f do{. nPaylo
94f0: 61 64 20 3d 20 28 6e 50 61 79 6c 6f 61 64 3c 3c ad = (nPayload<<
9500: 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 7) | (*++pIter &
9510: 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 69 0x7f);. }whi
9520: 6c 65 28 20 28 2a 70 49 74 65 72 29 3e 3d 30 78 le( (*pIter)>=0x
9530: 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 80 && pIter<pEnd
9540: 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b );. }. pIter+
9550: 2b 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 6e 65 78 +;.. /* The nex
9560: 74 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 t block of code
9570: 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f is equivalent to
9580: 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 :. **. **
9590: 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 72 69 pIter += getVari
95a0: 6e 74 28 70 49 74 65 72 2c 20 28 75 36 34 2a 29 nt(pIter, (u64*)
95b0: 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a 20 &pInfo->nKey);.
95c0: 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 63 6f 64 **. ** The cod
95d0: 65 20 69 73 20 69 6e 6c 69 6e 65 64 20 74 6f 20 e is inlined to
95e0: 61 76 6f 69 64 20 61 20 66 75 6e 63 74 69 6f 6e avoid a function
95f0: 20 63 61 6c 6c 2e 0a 20 20 2a 2f 0a 20 20 69 4b call.. */. iK
9600: 65 79 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 ey = *pIter;. i
9610: 66 28 20 69 4b 65 79 3e 3d 30 78 38 30 20 29 7b f( iKey>=0x80 ){
9620: 0a 20 20 20 20 75 38 20 2a 70 45 6e 64 20 3d 20 . u8 *pEnd =
9630: 26 70 49 74 65 72 5b 37 5d 3b 0a 20 20 20 20 69 &pIter[7];. i
9640: 4b 65 79 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 Key &= 0x7f;.
9650: 20 77 68 69 6c 65 28 31 29 7b 0a 20 20 20 20 20 while(1){.
9660: 20 69 4b 65 79 20 3d 20 28 69 4b 65 79 3c 3c 37 iKey = (iKey<<7
9670: 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 20 ) | (*++pIter &
9680: 30 78 37 66 29 3b 0a 20 20 20 20 20 20 69 66 28 0x7f);. if(
9690: 20 28 2a 70 49 74 65 72 29 3c 30 78 38 30 20 29 (*pIter)<0x80 )
96a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 69 66 break;. if
96b0: 28 20 70 49 74 65 72 3e 3d 70 45 6e 64 20 29 7b ( pIter>=pEnd ){
96c0: 0a 20 20 20 20 20 20 20 20 69 4b 65 79 20 3d 20 . iKey =
96d0: 28 69 4b 65 79 3c 3c 38 29 20 7c 20 2a 2b 2b 70 (iKey<<8) | *++p
96e0: 49 74 65 72 3b 0a 20 20 20 20 20 20 20 20 62 72 Iter;. br
96f0: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 eak;. }.
9700: 20 7d 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b 2b }. }. pIter++
9710: 3b 0a 0a 20 20 70 49 6e 66 6f 2d 3e 6e 4b 65 79 ;.. pInfo->nKey
9720: 20 3d 20 2a 28 69 36 34 2a 29 26 69 4b 65 79 3b = *(i64*)&iKey;
9730: 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f . pInfo->nPaylo
9740: 61 64 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 ad = nPayload;.
9750: 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 pInfo->pPayload
9760: 20 3d 20 70 49 74 65 72 3b 0a 20 20 74 65 73 74 = pIter;. test
9770: 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 3d 3d case( nPayload==
9780: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
9790: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e );. testcase( n
97a0: 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e Payload==pPage->
97b0: 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 maxLocal+1 );.
97c0: 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 if( nPayload<=pP
97d0: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b age->maxLocal ){
97e0: 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 . /* This is
97f0: 74 68 65 20 28 65 61 73 79 29 20 63 6f 6d 6d 6f the (easy) commo
9800: 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 68 65 n case where the
9810: 20 65 6e 74 69 72 65 20 70 61 79 6c 6f 61 64 20 entire payload
9820: 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 fits. ** on t
9830: 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2e 20 20 he local page.
9840: 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 73 20 72 No overflow is r
9850: 65 71 75 69 72 65 64 2e 0a 20 20 20 20 2a 2f 0a equired.. */.
9860: 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 pInfo->nSize
9870: 20 3d 20 6e 50 61 79 6c 6f 61 64 20 2b 20 28 75 = nPayload + (u
9880: 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 65 6c 16)(pIter - pCel
9890: 6c 29 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 66 l);. if( pInf
98a0: 6f 2d 3e 6e 53 69 7a 65 3c 34 20 29 20 70 49 6e o->nSize<4 ) pIn
98b0: 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 fo->nSize = 4;.
98c0: 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c pInfo->nLocal
98d0: 20 3d 20 28 75 31 36 29 6e 50 61 79 6c 6f 61 64 = (u16)nPayload
98e0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 62 ;. }else{. b
98f0: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 41 64 6a treeParseCellAdj
9900: 75 73 74 53 69 7a 65 46 6f 72 4f 76 65 72 66 6c ustSizeForOverfl
9910: 6f 77 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c ow(pPage, pCell,
9920: 20 70 49 6e 66 6f 29 3b 0a 20 20 7d 0a 7d 0a 73 pInfo);. }.}.s
9930: 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
9940: 50 61 72 73 65 43 65 6c 6c 50 74 72 49 6e 64 65 ParseCellPtrInde
9950: 78 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 x(. MemPage *pP
9960: 61 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 age, /*
9970: 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 Page containing
9980: 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 the cell */. u8
9990: 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 *pCell,
99a0: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
99b0: 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 to the cell tex
99c0: 74 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f t. */. CellInfo
99d0: 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 *pInfo
99e0: 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 /* Fill in this
99f0: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a structure */.){.
9a00: 20 20 75 38 20 2a 70 49 74 65 72 3b 20 20 20 20 u8 *pIter;
9a10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 /* For
9a20: 20 73 63 61 6e 6e 69 6e 67 20 74 68 72 6f 75 67 scanning throug
9a30: 68 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 33 32 h pCell */. u32
9a40: 20 6e 50 61 79 6c 6f 61 64 3b 20 20 20 20 20 20 nPayload;
9a50: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
9a60: 66 20 62 79 74 65 73 20 6f 66 20 63 65 6c 6c 20 f bytes of cell
9a70: 70 61 79 6c 6f 61 64 20 2a 2f 0a 0a 20 20 61 73 payload */.. as
9a80: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
9a90: 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
9aa0: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
9ab0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
9ac0: 6c 65 61 66 3d 3d 30 20 7c 7c 20 70 50 61 67 65 leaf==0 || pPage
9ad0: 2d 3e 6c 65 61 66 3d 3d 31 20 29 3b 0a 20 20 61 ->leaf==1 );. a
9ae0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 6e ssert( pPage->in
9af0: 74 4b 65 79 4c 65 61 66 3d 3d 30 20 29 3b 0a 20 tKeyLeaf==0 );.
9b00: 20 70 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b pIter = pCell +
9b10: 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
9b20: 53 69 7a 65 3b 0a 20 20 6e 50 61 79 6c 6f 61 64 Size;. nPayload
9b30: 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 66 28 = *pIter;. if(
9b40: 20 6e 50 61 79 6c 6f 61 64 3e 3d 30 78 38 30 20 nPayload>=0x80
9b50: 29 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 64 20 ){. u8 *pEnd
9b60: 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 20 20 = &pIter[8];.
9b70: 20 6e 50 61 79 6c 6f 61 64 20 26 3d 20 30 78 37 nPayload &= 0x7
9b80: 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 f;. do{.
9b90: 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 6e 50 61 nPayload = (nPa
9ba0: 79 6c 6f 61 64 3c 3c 37 29 20 7c 20 28 2a 2b 2b yload<<7) | (*++
9bb0: 70 49 74 65 72 20 26 20 30 78 37 66 29 3b 0a 20 pIter & 0x7f);.
9bc0: 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 49 74 }while( *(pIt
9bd0: 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 49 74 er)>=0x80 && pIt
9be0: 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a 20 er<pEnd );. }.
9bf0: 20 70 49 74 65 72 2b 2b 3b 0a 20 20 70 49 6e 66 pIter++;. pInf
9c00: 6f 2d 3e 6e 4b 65 79 20 3d 20 6e 50 61 79 6c 6f o->nKey = nPaylo
9c10: 61 64 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 ad;. pInfo->nPa
9c20: 79 6c 6f 61 64 20 3d 20 6e 50 61 79 6c 6f 61 64 yload = nPayload
9c30: 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c ;. pInfo->pPayl
9c40: 6f 61 64 20 3d 20 70 49 74 65 72 3b 0a 20 20 74 oad = pIter;. t
9c50: 65 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 estcase( nPayloa
9c60: 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 d==pPage->maxLoc
9c70: 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 al );. testcase
9c80: 28 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 ( nPayload==pPag
9c90: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b e->maxLocal+1 );
9ca0: 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c . if( nPayload<
9cb0: 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
9cc0: 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 ){. /* This
9cd0: 69 73 20 74 68 65 20 28 65 61 73 79 29 20 63 6f is the (easy) co
9ce0: 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 mmon case where
9cf0: 74 68 65 20 65 6e 74 69 72 65 20 70 61 79 6c 6f the entire paylo
9d00: 61 64 20 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f ad fits. ** o
9d10: 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 n the local page
9d20: 2e 20 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 . No overflow i
9d30: 73 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 s required..
9d40: 2a 2f 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 */. pInfo->nS
9d50: 69 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 64 20 2b ize = nPayload +
9d60: 20 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 (u16)(pIter - p
9d70: 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 70 Cell);. if( p
9d80: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 20 29 20 Info->nSize<4 )
9d90: 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 pInfo->nSize = 4
9da0: 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f ;. pInfo->nLo
9db0: 63 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 79 6c cal = (u16)nPayl
9dc0: 6f 61 64 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 oad;. }else{.
9dd0: 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c btreeParseCell
9de0: 41 64 6a 75 73 74 53 69 7a 65 46 6f 72 4f 76 65 AdjustSizeForOve
9df0: 72 66 6c 6f 77 28 70 50 61 67 65 2c 20 70 43 65 rflow(pPage, pCe
9e00: 6c 6c 2c 20 70 49 6e 66 6f 29 3b 0a 20 20 7d 0a ll, pInfo);. }.
9e10: 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 }.static void bt
9e20: 72 65 65 50 61 72 73 65 43 65 6c 6c 28 0a 20 20 reeParseCell(.
9e30: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
9e40: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
9e50: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
9e60: 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 ell */. int iCe
9e70: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
9e80: 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 69 6e 64 /* The cell ind
9e90: 65 78 2e 20 20 46 69 72 73 74 20 63 65 6c 6c 20 ex. First cell
9ea0: 69 73 20 30 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e is 0 */. CellIn
9eb0: 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 fo *pInfo
9ec0: 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 /* Fill in thi
9ed0: 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 s structure */.)
9ee0: 7b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 {. pPage->xPars
9ef0: 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 66 69 6e eCell(pPage, fin
9f00: 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 dCell(pPage, iCe
9f10: 6c 6c 29 2c 20 70 49 6e 66 6f 29 3b 0a 7d 0a 0a ll), pInfo);.}..
9f20: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
9f30: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61 72 65 ing routines are
9f40: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
9f50: 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 2e of the MemPage.
9f60: 78 43 65 6c 6c 53 69 7a 65 0a 2a 2a 20 6d 65 74 xCellSize.** met
9f70: 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 43 6f 6d 70 75 hod..**.** Compu
9f80: 74 65 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d te the total num
9f90: 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 68 61 ber of bytes tha
9fa0: 74 20 61 20 43 65 6c 6c 20 6e 65 65 64 73 20 69 t a Cell needs i
9fb0: 6e 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 n the cell.** da
9fc0: 74 61 20 61 72 65 61 20 6f 66 20 74 68 65 20 62 ta area of the b
9fd0: 74 72 65 65 2d 70 61 67 65 2e 20 20 54 68 65 20 tree-page. The
9fe0: 72 65 74 75 72 6e 20 6e 75 6d 62 65 72 20 69 6e return number in
9ff0: 63 6c 75 64 65 73 20 74 68 65 20 63 65 6c 6c 0a cludes the cell.
a000: 2a 2a 20 64 61 74 61 20 68 65 61 64 65 72 20 61 ** data header a
a010: 6e 64 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 79 nd the local pay
a020: 6c 6f 61 64 2c 20 62 75 74 20 6e 6f 74 20 61 6e load, but not an
a030: 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 y overflow page
a040: 6f 72 0a 2a 2a 20 74 68 65 20 73 70 61 63 65 20 or.** the space
a050: 75 73 65 64 20 62 79 20 74 68 65 20 63 65 6c 6c used by the cell
a060: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 pointer..**.**
a070: 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 61 79 cellSizePtrNoPay
a080: 6c 6f 61 64 28 29 20 20 20 20 3d 3e 20 20 20 74 load() => t
a090: 61 62 6c 65 20 69 6e 74 65 72 6e 61 6c 20 6e 6f able internal no
a0a0: 64 65 73 0a 2a 2a 20 63 65 6c 6c 53 69 7a 65 50 des.** cellSizeP
a0b0: 74 72 28 29 20 20 20 20 20 20 20 20 20 20 20 20 tr()
a0c0: 20 3d 3e 20 20 20 61 6c 6c 20 69 6e 64 65 78 20 => all index
a0d0: 6e 6f 64 65 73 20 26 20 74 61 62 6c 65 20 6c 65 nodes & table le
a0e0: 61 66 20 6e 6f 64 65 73 0a 2a 2f 0a 73 74 61 74 af nodes.*/.stat
a0f0: 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 50 ic u16 cellSizeP
a100: 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 tr(MemPage *pPag
a110: 65 2c 20 75 38 20 2a 70 43 65 6c 6c 29 7b 0a 20 e, u8 *pCell){.
a120: 20 75 38 20 2a 70 49 74 65 72 20 3d 20 70 43 65 u8 *pIter = pCe
a130: 6c 6c 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 6c ll + pPage->chil
a140: 64 50 74 72 53 69 7a 65 3b 20 2f 2a 20 46 6f 72 dPtrSize; /* For
a150: 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 62 79 looping over by
a160: 74 65 73 20 6f 66 20 70 43 65 6c 6c 20 2a 2f 0a tes of pCell */.
a170: 20 20 75 38 20 2a 70 45 6e 64 3b 20 20 20 20 20 u8 *pEnd;
a180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a190: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 6e /* En
a1a0: 64 20 6d 61 72 6b 20 66 6f 72 20 61 20 76 61 72 d mark for a var
a1b0: 69 6e 74 20 2a 2f 0a 20 20 75 33 32 20 6e 53 69 int */. u32 nSi
a1c0: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ze;
a1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a1e0: 20 20 2f 2a 20 53 69 7a 65 20 76 61 6c 75 65 20 /* Size value
a1f0: 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 0a 23 69 to return */..#i
a200: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
a210: 47 0a 20 20 2f 2a 20 54 68 65 20 76 61 6c 75 65 G. /* The value
a220: 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 returned by thi
a230: 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c s function shoul
a240: 64 20 61 6c 77 61 79 73 20 62 65 20 74 68 65 20 d always be the
a250: 73 61 6d 65 20 61 73 0a 20 20 2a 2a 20 74 68 65 same as. ** the
a260: 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e 53 69 7a 65 (CellInfo.nSize
a270: 29 20 76 61 6c 75 65 20 66 6f 75 6e 64 20 62 79 ) value found by
a280: 20 64 6f 69 6e 67 20 61 20 66 75 6c 6c 20 70 61 doing a full pa
a290: 72 73 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 rse of the. **
a2a0: 63 65 6c 6c 2e 20 49 66 20 53 51 4c 49 54 45 5f cell. If SQLITE_
a2b0: 44 45 42 55 47 20 69 73 20 64 65 66 69 6e 65 64 DEBUG is defined
a2c0: 2c 20 61 6e 20 61 73 73 65 72 74 28 29 20 61 74 , an assert() at
a2d0: 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 0a 20 the bottom of.
a2e0: 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 6f ** this functio
a2f0: 6e 20 76 65 72 69 66 69 65 73 20 74 68 61 74 20 n verifies that
a300: 74 68 69 73 20 69 6e 76 61 72 69 61 6e 74 20 69 this invariant i
a310: 73 20 6e 6f 74 20 76 69 6f 6c 61 74 65 64 2e 20 s not violated.
a320: 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 64 65 */. CellInfo de
a330: 62 75 67 69 6e 66 6f 3b 0a 20 20 70 50 61 67 65 buginfo;. pPage
a340: 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 61 ->xParseCell(pPa
a350: 67 65 2c 20 70 43 65 6c 6c 2c 20 26 64 65 62 75 ge, pCell, &debu
a360: 67 69 6e 66 6f 29 3b 0a 23 65 6e 64 69 66 0a 0a ginfo);.#endif..
a370: 20 20 6e 53 69 7a 65 20 3d 20 2a 70 49 74 65 72 nSize = *pIter
a380: 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 3e 3d 30 ;. if( nSize>=0
a390: 78 38 30 20 29 7b 0a 20 20 20 20 70 45 6e 64 20 x80 ){. pEnd
a3a0: 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 20 20 = &pIter[8];.
a3b0: 20 6e 53 69 7a 65 20 26 3d 20 30 78 37 66 3b 0a nSize &= 0x7f;.
a3c0: 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 6e 53 do{. nS
a3d0: 69 7a 65 20 3d 20 28 6e 53 69 7a 65 3c 3c 37 29 ize = (nSize<<7)
a3e0: 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 20 30 | (*++pIter & 0
a3f0: 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 69 6c 65 x7f);. }while
a400: 28 20 2a 28 70 49 74 65 72 29 3e 3d 30 78 38 30 ( *(pIter)>=0x80
a410: 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 && pIter<pEnd )
a420: 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b 2b 3b ;. }. pIter++;
a430: 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e . if( pPage->in
a440: 74 4b 65 79 20 29 7b 0a 20 20 20 20 2f 2a 20 70 tKey ){. /* p
a450: 49 74 65 72 20 6e 6f 77 20 70 6f 69 6e 74 73 20 Iter now points
a460: 61 74 20 74 68 65 20 36 34 2d 62 69 74 20 69 6e at the 64-bit in
a470: 74 65 67 65 72 20 6b 65 79 20 76 61 6c 75 65 2c teger key value,
a480: 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 a variable leng
a490: 74 68 20 0a 20 20 20 20 2a 2a 20 69 6e 74 65 67 th . ** integ
a4a0: 65 72 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e er. The followin
a4b0: 67 20 62 6c 6f 63 6b 20 6d 6f 76 65 73 20 70 49 g block moves pI
a4c0: 74 65 72 20 74 6f 20 70 6f 69 6e 74 20 61 74 20 ter to point at
a4d0: 74 68 65 20 66 69 72 73 74 20 62 79 74 65 0a 20 the first byte.
a4e0: 20 20 20 2a 2a 20 70 61 73 74 20 74 68 65 20 65 ** past the e
a4f0: 6e 64 20 6f 66 20 74 68 65 20 6b 65 79 20 76 61 nd of the key va
a500: 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 70 45 6e 64 lue. */. pEnd
a510: 20 3d 20 26 70 49 74 65 72 5b 39 5d 3b 0a 20 20 = &pIter[9];.
a520: 20 20 77 68 69 6c 65 28 20 28 2a 70 49 74 65 72 while( (*pIter
a530: 2b 2b 29 26 30 78 38 30 20 26 26 20 70 49 74 65 ++)&0x80 && pIte
a540: 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a 20 20 r<pEnd );. }.
a550: 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d testcase( nSize=
a560: 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
a570: 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 );. testcase(
a580: 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 nSize==pPage->ma
a590: 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 69 66 xLocal+1 );. if
a5a0: 28 20 6e 53 69 7a 65 3c 3d 70 50 61 67 65 2d 3e ( nSize<=pPage->
a5b0: 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 maxLocal ){.
a5c0: 6e 53 69 7a 65 20 2b 3d 20 28 75 33 32 29 28 70 nSize += (u32)(p
a5d0: 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 Iter - pCell);.
a5e0: 20 20 20 69 66 28 20 6e 53 69 7a 65 3c 34 20 29 if( nSize<4 )
a5f0: 20 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 20 7d 65 nSize = 4;. }e
a600: 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6d 69 6e lse{. int min
a610: 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d Local = pPage->m
a620: 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 6e 53 69 inLocal;. nSi
a630: 7a 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 ze = minLocal +
a640: 28 6e 53 69 7a 65 20 2d 20 6d 69 6e 4c 6f 63 61 (nSize - minLoca
a650: 6c 29 20 25 20 28 70 50 61 67 65 2d 3e 70 42 74 l) % (pPage->pBt
a660: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 ->usableSize - 4
a670: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
a680: 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d nSize==pPage->m
a690: 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 20 20 74 axLocal );. t
a6a0: 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d estcase( nSize==
a6b0: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b pPage->maxLocal+
a6c0: 31 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 53 69 1 );. if( nSi
a6d0: 7a 65 3e 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 ze>pPage->maxLoc
a6e0: 61 6c 20 29 7b 0a 20 20 20 20 20 20 6e 53 69 7a al ){. nSiz
a6f0: 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 e = minLocal;.
a700: 20 20 7d 0a 20 20 20 20 6e 53 69 7a 65 20 2b 3d }. nSize +=
a710: 20 34 20 2b 20 28 75 31 36 29 28 70 49 74 65 72 4 + (u16)(pIter
a720: 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 7d 0a 20 - pCell);. }.
a730: 20 61 73 73 65 72 74 28 20 6e 53 69 7a 65 3d 3d assert( nSize==
a740: 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 7a 65 20 debuginfo.nSize
a750: 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
a760: 0a 20 20 72 65 74 75 72 6e 20 28 75 31 36 29 6e . return (u16)n
a770: 53 69 7a 65 3b 0a 7d 0a 73 74 61 74 69 63 20 75 Size;.}.static u
a780: 31 36 20 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 16 cellSizePtrNo
a790: 50 61 79 6c 6f 61 64 28 4d 65 6d 50 61 67 65 20 Payload(MemPage
a7a0: 2a 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 6c *pPage, u8 *pCel
a7b0: 6c 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 20 l){. u8 *pIter
a7c0: 3d 20 70 43 65 6c 6c 20 2b 20 34 3b 20 2f 2a 20 = pCell + 4; /*
a7d0: 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 For looping over
a7e0: 20 62 79 74 65 73 20 6f 66 20 70 43 65 6c 6c 20 bytes of pCell
a7f0: 2a 2f 0a 20 20 75 38 20 2a 70 45 6e 64 3b 20 20 */. u8 *pEnd;
a800: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
a810: 6e 64 20 6d 61 72 6b 20 66 6f 72 20 61 20 76 61 nd mark for a va
a820: 72 69 6e 74 20 2a 2f 0a 0a 23 69 66 64 65 66 20 rint */..#ifdef
a830: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f SQLITE_DEBUG. /
a840: 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 * The value retu
a850: 72 6e 65 64 20 62 79 20 74 68 69 73 20 66 75 6e rned by this fun
a860: 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c 77 ction should alw
a870: 61 79 73 20 62 65 20 74 68 65 20 73 61 6d 65 20 ays be the same
a880: 61 73 0a 20 20 2a 2a 20 74 68 65 20 28 43 65 6c as. ** the (Cel
a890: 6c 49 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 61 6c lInfo.nSize) val
a8a0: 75 65 20 66 6f 75 6e 64 20 62 79 20 64 6f 69 6e ue found by doin
a8b0: 67 20 61 20 66 75 6c 6c 20 70 61 72 73 65 20 6f g a full parse o
a8c0: 66 20 74 68 65 0a 20 20 2a 2a 20 63 65 6c 6c 2e f the. ** cell.
a8d0: 20 49 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 If SQLITE_DEBUG
a8e0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 is defined, an
a8f0: 61 73 73 65 72 74 28 29 20 61 74 20 74 68 65 20 assert() at the
a900: 62 6f 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a 20 74 bottom of. ** t
a910: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 76 65 72 his function ver
a920: 69 66 69 65 73 20 74 68 61 74 20 74 68 69 73 20 ifies that this
a930: 69 6e 76 61 72 69 61 6e 74 20 69 73 20 6e 6f 74 invariant is not
a940: 20 76 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a 20 20 violated. */.
a950: 43 65 6c 6c 49 6e 66 6f 20 64 65 62 75 67 69 6e CellInfo debugin
a960: 66 6f 3b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 fo;. pPage->xPa
a970: 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 rseCell(pPage, p
a980: 43 65 6c 6c 2c 20 26 64 65 62 75 67 69 6e 66 6f Cell, &debuginfo
a990: 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e 55 53 45 );.#else. UNUSE
a9a0: 44 5f 50 41 52 41 4d 45 54 45 52 28 70 50 61 67 D_PARAMETER(pPag
a9b0: 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 e);.#endif.. as
a9c0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 68 69 sert( pPage->chi
a9d0: 6c 64 50 74 72 53 69 7a 65 3d 3d 34 20 29 3b 0a ldPtrSize==4 );.
a9e0: 20 20 70 45 6e 64 20 3d 20 70 49 74 65 72 20 2b pEnd = pIter +
a9f0: 20 39 3b 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 9;. while( (*p
aa00: 49 74 65 72 2b 2b 29 26 30 78 38 30 20 26 26 20 Iter++)&0x80 &&
aa10: 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 pIter<pEnd );.
aa20: 61 73 73 65 72 74 28 20 64 65 62 75 67 69 6e 66 assert( debuginf
aa30: 6f 2e 6e 53 69 7a 65 3d 3d 28 75 31 36 29 28 70 o.nSize==(u16)(p
aa40: 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 20 7c 7c Iter - pCell) ||
aa50: 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 CORRUPT_DB );.
aa60: 20 72 65 74 75 72 6e 20 28 75 31 36 29 28 70 49 return (u16)(pI
aa70: 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 7d 0a ter - pCell);.}.
aa80: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
aa90: 44 45 42 55 47 0a 2f 2a 20 54 68 69 73 20 76 61 DEBUG./* This va
aaa0: 72 69 61 74 69 6f 6e 20 6f 6e 20 63 65 6c 6c 53 riation on cellS
aab0: 69 7a 65 50 74 72 28 29 20 69 73 20 75 73 65 64 izePtr() is used
aac0: 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 65 72 inside of asser
aad0: 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a t() statements.*
aae0: 2a 20 6f 6e 6c 79 2e 20 2a 2f 0a 73 74 61 74 69 * only. */.stati
aaf0: 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 28 4d c u16 cellSize(M
ab00: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 emPage *pPage, i
ab10: 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 20 72 65 74 nt iCell){. ret
ab20: 75 72 6e 20 70 50 61 67 65 2d 3e 78 43 65 6c 6c urn pPage->xCell
ab30: 53 69 7a 65 28 70 50 61 67 65 2c 20 66 69 6e 64 Size(pPage, find
ab40: 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 65 6c Cell(pPage, iCel
ab50: 6c 29 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 l));.}.#endif..#
ab60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
ab70: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a IT_AUTOVACUUM./*
ab80: 0a 2a 2a 20 49 66 20 74 68 65 20 63 65 6c 6c 20 .** If the cell
ab90: 70 43 65 6c 6c 2c 20 70 61 72 74 20 6f 66 20 70 pCell, part of p
aba0: 61 67 65 20 70 50 61 67 65 20 63 6f 6e 74 61 69 age pPage contai
abb0: 6e 73 20 61 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 ns a pointer.**
abc0: 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 to an overflow p
abd0: 61 67 65 2c 20 69 6e 73 65 72 74 20 61 6e 20 65 age, insert an e
abe0: 6e 74 72 79 20 69 6e 74 6f 20 74 68 65 20 70 6f ntry into the po
abf0: 69 6e 74 65 72 2d 6d 61 70 0a 2a 2a 20 66 6f 72 inter-map.** for
ac00: 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
ac10: 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ge..*/.static vo
ac20: 69 64 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c id ptrmapPutOvfl
ac30: 50 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 Ptr(MemPage *pPa
ac40: 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c 2c 20 69 ge, u8 *pCell, i
ac50: 6e 74 20 2a 70 52 43 29 7b 0a 20 20 43 65 6c 6c nt *pRC){. Cell
ac60: 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 69 66 28 Info info;. if(
ac70: 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e 3b 0a *pRC ) return;.
ac80: 20 20 61 73 73 65 72 74 28 20 70 43 65 6c 6c 21 assert( pCell!
ac90: 3d 30 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 78 =0 );. pPage->x
aca0: 50 61 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c ParseCell(pPage,
acb0: 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a pCell, &info);.
acc0: 20 20 69 66 28 20 69 6e 66 6f 2e 6e 4c 6f 63 61 if( info.nLoca
acd0: 6c 3c 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 l<info.nPayload
ace0: 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6f 76 66 6c ){. Pgno ovfl
acf0: 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 43 65 = get4byte(&pCe
ad00: 6c 6c 5b 69 6e 66 6f 2e 6e 53 69 7a 65 2d 34 5d ll[info.nSize-4]
ad10: 29 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 );. ptrmapPut
ad20: 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 6f 76 66 (pPage->pBt, ovf
ad30: 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c l, PTRMAP_OVERFL
ad40: 4f 57 31 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f OW1, pPage->pgno
ad50: 2c 20 70 52 43 29 3b 0a 20 20 7d 0a 7d 0a 23 65 , pRC);. }.}.#e
ad60: 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 ndif.../*.** Def
ad70: 72 61 67 6d 65 6e 74 20 74 68 65 20 70 61 67 65 ragment the page
ad80: 20 67 69 76 65 6e 2e 20 54 68 69 73 20 72 6f 75 given. This rou
ad90: 74 69 6e 65 20 72 65 6f 72 67 61 6e 69 7a 65 73 tine reorganizes
ada0: 20 63 65 6c 6c 73 20 77 69 74 68 69 6e 20 74 68 cells within th
adb0: 65 0a 2a 2a 20 70 61 67 65 20 73 6f 20 74 68 61 e.** page so tha
adc0: 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 66 t there are no f
add0: 72 65 65 2d 62 6c 6f 63 6b 73 20 6f 6e 20 74 68 ree-blocks on th
ade0: 65 20 66 72 65 65 2d 62 6c 6f 63 6b 20 6c 69 73 e free-block lis
adf0: 74 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 t..**.** Paramet
ae00: 65 72 20 6e 4d 61 78 46 72 61 67 20 69 73 20 74 er nMaxFrag is t
ae10: 68 65 20 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e he maximum amoun
ae20: 74 20 6f 66 20 66 72 61 67 6d 65 6e 74 65 64 20 t of fragmented
ae30: 73 70 61 63 65 20 74 68 61 74 20 6d 61 79 20 62 space that may b
ae40: 65 0a 2a 2a 20 70 72 65 73 65 6e 74 20 69 6e 20 e.** present in
ae50: 74 68 65 20 70 61 67 65 20 61 66 74 65 72 20 74 the page after t
ae60: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 his routine retu
ae70: 72 6e 73 2e 0a 2a 2a 0a 2a 2a 20 45 56 49 44 45 rns..**.** EVIDE
ae80: 4e 43 45 2d 4f 46 3a 20 52 2d 34 34 35 38 32 2d NCE-OF: R-44582-
ae90: 36 30 31 33 38 20 53 51 4c 69 74 65 20 6d 61 79 60138 SQLite may
aea0: 20 66 72 6f 6d 20 74 69 6d 65 20 74 6f 20 74 69 from time to ti
aeb0: 6d 65 20 72 65 6f 72 67 61 6e 69 7a 65 20 61 0a me reorganize a.
aec0: 2a 2a 20 62 2d 74 72 65 65 20 70 61 67 65 20 73 ** b-tree page s
aed0: 6f 20 74 68 61 74 20 74 68 65 72 65 20 61 72 65 o that there are
aee0: 20 6e 6f 20 66 72 65 65 62 6c 6f 63 6b 73 20 6f no freeblocks o
aef0: 72 20 66 72 61 67 6d 65 6e 74 20 62 79 74 65 73 r fragment bytes
af00: 2c 20 61 6c 6c 0a 2a 2a 20 75 6e 75 73 65 64 20 , all.** unused
af10: 62 79 74 65 73 20 61 72 65 20 63 6f 6e 74 61 69 bytes are contai
af20: 6e 65 64 20 69 6e 20 74 68 65 20 75 6e 61 6c 6c ned in the unall
af30: 6f 63 61 74 65 64 20 73 70 61 63 65 20 72 65 67 ocated space reg
af40: 69 6f 6e 2c 20 61 6e 64 20 61 6c 6c 0a 2a 2a 20 ion, and all.**
af50: 63 65 6c 6c 73 20 61 72 65 20 70 61 63 6b 65 64 cells are packed
af60: 20 74 69 67 68 74 6c 79 20 61 74 20 74 68 65 20 tightly at the
af70: 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 2e end of the page.
af80: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 64 .*/.static int d
af90: 65 66 72 61 67 6d 65 6e 74 50 61 67 65 28 4d 65 efragmentPage(Me
afa0: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
afb0: 74 20 6e 4d 61 78 46 72 61 67 29 7b 0a 20 20 69 t nMaxFrag){. i
afc0: 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 nt i;
afd0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f /* Loo
afe0: 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 p counter */. i
aff0: 6e 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 nt pc;
b000: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 /* Add
b010: 72 65 73 73 20 6f 66 20 74 68 65 20 69 2d 74 68 ress of the i-th
b020: 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 68 cell */. int h
b030: 64 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 dr;
b040: 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 /* Offset
b050: 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 61 64 to the page head
b060: 65 72 20 2a 2f 0a 20 20 69 6e 74 20 73 69 7a 65 er */. int size
b070: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b080: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 /* Size of a
b090: 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 75 73 cell */. int us
b0a0: 61 62 6c 65 53 69 7a 65 3b 20 20 20 20 20 20 20 ableSize;
b0b0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
b0c0: 66 20 75 73 61 62 6c 65 20 62 79 74 65 73 20 6f f usable bytes o
b0d0: 6e 20 61 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e n a page */. in
b0e0: 74 20 63 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 t cellOffset;
b0f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
b100: 65 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 et to the cell p
b110: 6f 69 6e 74 65 72 20 61 72 72 61 79 20 2a 2f 0a ointer array */.
b120: 20 20 69 6e 74 20 63 62 72 6b 3b 20 20 20 20 20 int cbrk;
b130: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b140: 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 65 Offset to the ce
b150: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 ll content area
b160: 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 */. int nCell;
b170: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b180: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c /* Number of cel
b190: 6c 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a ls on the page *
b1a0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
b1b0: 72 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f r *data; /
b1c0: 2a 20 54 68 65 20 70 61 67 65 20 64 61 74 61 20 * The page data
b1d0: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 */. unsigned ch
b1e0: 61 72 20 2a 74 65 6d 70 3b 20 20 20 20 20 20 20 ar *temp;
b1f0: 2f 2a 20 54 65 6d 70 20 61 72 65 61 20 66 6f 72 /* Temp area for
b200: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f cell content */
b210: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
b220: 20 2a 73 72 63 3b 20 20 20 20 20 20 20 20 2f 2a *src; /*
b230: 20 53 6f 75 72 63 65 20 6f 66 20 63 6f 6e 74 65 Source of conte
b240: 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c nt */. int iCel
b250: 6c 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20 lFirst;
b260: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f /* First allo
b270: 77 61 62 6c 65 20 63 65 6c 6c 20 69 6e 64 65 78 wable cell index
b280: 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c 4c */. int iCellL
b290: 61 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ast;
b2a0: 20 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 6c /* Last possibl
b2b0: 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a e cell index */.
b2c0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
b2d0: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
b2e0: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
b2f0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
b300: 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b pPage->pBt!=0 );
b310: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
b320: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
b330: 65 20 3c 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f e <= SQLITE_MAX_
b340: 50 41 47 45 5f 53 49 5a 45 20 29 3b 0a 20 20 61 PAGE_SIZE );. a
b350: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f ssert( pPage->nO
b360: 76 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 verflow==0 );.
b370: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
b380: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
b390: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
b3a0: 0a 20 20 74 65 6d 70 20 3d 20 30 3b 0a 20 20 73 . temp = 0;. s
b3b0: 72 63 20 3d 20 64 61 74 61 20 3d 20 70 50 61 67 rc = data = pPag
b3c0: 65 2d 3e 61 44 61 74 61 3b 0a 20 20 68 64 72 20 e->aData;. hdr
b3d0: 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 = pPage->hdrOffs
b3e0: 65 74 3b 0a 20 20 63 65 6c 6c 4f 66 66 73 65 74 et;. cellOffset
b3f0: 20 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 = pPage->cellOf
b400: 66 73 65 74 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 fset;. nCell =
b410: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
b420: 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 3d 3d 67 assert( nCell==g
b430: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
b440: 72 2b 33 5d 29 20 29 3b 0a 20 20 69 43 65 6c 6c r+3]) );. iCell
b450: 46 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 66 73 First = cellOffs
b460: 65 74 20 2b 20 32 2a 6e 43 65 6c 6c 3b 0a 20 20 et + 2*nCell;.
b470: 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 61 usableSize = pPa
b480: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
b490: 69 7a 65 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 ize;.. /* This
b4a0: 62 6c 6f 63 6b 20 68 61 6e 64 6c 65 73 20 70 61 block handles pa
b4b0: 67 65 73 20 77 69 74 68 20 74 77 6f 20 6f 72 20 ges with two or
b4c0: 66 65 77 65 72 20 66 72 65 65 20 62 6c 6f 63 6b fewer free block
b4d0: 73 20 61 6e 64 20 6e 4d 61 78 46 72 61 67 0a 20 s and nMaxFrag.
b4e0: 20 2a 2a 20 6f 72 20 66 65 77 65 72 20 66 72 61 ** or fewer fra
b4f0: 67 6d 65 6e 74 65 64 20 62 79 74 65 73 2e 20 49 gmented bytes. I
b500: 6e 20 74 68 69 73 20 63 61 73 65 20 69 74 20 69 n this case it i
b510: 73 20 66 61 73 74 65 72 20 74 6f 20 6d 6f 76 65 s faster to move
b520: 20 74 68 65 0a 20 20 2a 2a 20 74 77 6f 20 28 6f the. ** two (o
b530: 72 20 6f 6e 65 29 20 62 6c 6f 63 6b 73 20 6f 66 r one) blocks of
b540: 20 63 65 6c 6c 73 20 75 73 69 6e 67 20 6d 65 6d cells using mem
b550: 6d 6f 76 65 28 29 20 61 6e 64 20 61 64 64 20 74 move() and add t
b560: 68 65 20 72 65 71 75 69 72 65 64 0a 20 20 2a 2a he required. **
b570: 20 6f 66 66 73 65 74 73 20 74 6f 20 65 61 63 68 offsets to each
b580: 20 70 6f 69 6e 74 65 72 20 69 6e 20 74 68 65 20 pointer in the
b590: 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 20 61 72 72 cell-pointer arr
b5a0: 61 79 20 74 68 61 6e 20 69 74 20 69 73 20 74 6f ay than it is to
b5b0: 20 0a 20 20 2a 2a 20 72 65 63 6f 6e 73 74 72 75 . ** reconstru
b5c0: 63 74 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 ct the entire pa
b5d0: 67 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 28 69 ge. */. if( (i
b5e0: 6e 74 29 64 61 74 61 5b 68 64 72 2b 37 5d 3c 3d nt)data[hdr+7]<=
b5f0: 6e 4d 61 78 46 72 61 67 20 29 7b 0a 20 20 20 20 nMaxFrag ){.
b600: 69 6e 74 20 69 46 72 65 65 20 3d 20 67 65 74 32 int iFree = get2
b610: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 31 byte(&data[hdr+1
b620: 5d 29 3b 0a 20 20 20 20 69 66 28 20 69 46 72 65 ]);. if( iFre
b630: 65 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 e ){. int i
b640: 46 72 65 65 32 20 3d 20 67 65 74 32 62 79 74 65 Free2 = get2byte
b650: 28 26 64 61 74 61 5b 69 46 72 65 65 5d 29 3b 0a (&data[iFree]);.
b660: 0a 20 20 20 20 20 20 2f 2a 20 70 61 67 65 46 69 . /* pageFi
b670: 6e 64 53 6c 6f 74 28 29 20 68 61 73 20 61 6c 72 ndSlot() has alr
b680: 65 61 64 79 20 76 65 72 69 66 69 65 64 20 74 68 eady verified th
b690: 61 74 20 66 72 65 65 20 62 6c 6f 63 6b 73 20 61 at free blocks a
b6a0: 72 65 20 73 6f 72 74 65 64 0a 20 20 20 20 20 20 re sorted.
b6b0: 2a 2a 20 69 6e 20 6f 72 64 65 72 20 6f 66 20 6f ** in order of o
b6c0: 66 66 73 65 74 20 77 69 74 68 69 6e 20 74 68 65 ffset within the
b6d0: 20 70 61 67 65 2c 20 61 6e 64 20 74 68 61 74 20 page, and that
b6e0: 6e 6f 20 62 6c 6f 63 6b 20 65 78 74 65 6e 64 73 no block extends
b6f0: 0a 20 20 20 20 20 20 2a 2a 20 70 61 73 74 20 74 . ** past t
b700: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 he end of the pa
b710: 67 65 2e 20 50 72 6f 76 69 64 65 64 20 74 68 65 ge. Provided the
b720: 20 74 77 6f 20 66 72 65 65 20 73 6c 6f 74 73 20 two free slots
b730: 64 6f 20 6e 6f 74 20 0a 20 20 20 20 20 20 2a 2a do not . **
b740: 20 6f 76 65 72 6c 61 70 2c 20 74 68 69 73 20 67 overlap, this g
b750: 75 61 72 61 6e 74 65 65 73 20 74 68 61 74 20 74 uarantees that t
b760: 68 65 20 6d 65 6d 6d 6f 76 65 28 29 20 63 61 6c he memmove() cal
b770: 6c 73 20 62 65 6c 6f 77 20 77 69 6c 6c 20 6e 6f ls below will no
b780: 74 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 77 t. ** overw
b790: 72 69 74 65 20 74 68 65 20 75 73 61 62 6c 65 53 rite the usableS
b7a0: 69 7a 65 20 62 79 74 65 20 62 75 66 66 65 72 2c ize byte buffer,
b7b0: 20 65 76 65 6e 20 69 66 20 74 68 65 20 64 61 74 even if the dat
b7c0: 61 62 61 73 65 20 70 61 67 65 0a 20 20 20 20 20 abase page.
b7d0: 20 2a 2a 20 69 73 20 63 6f 72 72 75 70 74 2e 20 ** is corrupt.
b7e0: 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 */. assert
b7f0: 28 20 69 46 72 65 65 32 3d 3d 30 20 7c 7c 20 69 ( iFree2==0 || i
b800: 46 72 65 65 32 3e 69 46 72 65 65 20 29 3b 0a 20 Free2>iFree );.
b810: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 46 72 assert( iFr
b820: 65 65 2b 67 65 74 32 62 79 74 65 28 26 64 61 74 ee+get2byte(&dat
b830: 61 5b 69 46 72 65 65 2b 32 5d 29 20 3c 3d 20 75 a[iFree+2]) <= u
b840: 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 sableSize );.
b850: 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 assert( iFree
b860: 32 3d 3d 30 20 7c 7c 20 69 46 72 65 65 32 2b 67 2==0 || iFree2+g
b870: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 et2byte(&data[iF
b880: 72 65 65 32 2b 32 5d 29 20 3c 3d 20 75 73 61 62 ree2+2]) <= usab
b890: 6c 65 53 69 7a 65 20 29 3b 0a 0a 20 20 20 20 20 leSize );..
b8a0: 20 69 66 28 20 30 3d 3d 69 46 72 65 65 32 20 7c if( 0==iFree2 |
b8b0: 7c 20 28 64 61 74 61 5b 69 46 72 65 65 32 5d 3d | (data[iFree2]=
b8c0: 3d 30 20 26 26 20 64 61 74 61 5b 69 46 72 65 65 =0 && data[iFree
b8d0: 32 2b 31 5d 3d 3d 30 29 20 29 7b 0a 20 20 20 20 2+1]==0) ){.
b8e0: 20 20 20 20 75 38 20 2a 70 45 6e 64 20 3d 20 26 u8 *pEnd = &
b8f0: 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 20 data[cellOffset
b900: 2b 20 6e 43 65 6c 6c 2a 32 5d 3b 0a 20 20 20 20 + nCell*2];.
b910: 20 20 20 20 75 38 20 2a 70 41 64 64 72 3b 0a 20 u8 *pAddr;.
b920: 20 20 20 20 20 20 20 69 6e 74 20 73 7a 32 20 3d int sz2 =
b930: 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 0;. int
b940: 73 7a 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 sz = get2byte(&d
b950: 61 74 61 5b 69 46 72 65 65 2b 32 5d 29 3b 0a 20 ata[iFree+2]);.
b960: 20 20 20 20 20 20 20 69 6e 74 20 74 6f 70 20 3d int top =
b970: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
b980: 68 64 72 2b 35 5d 29 3b 0a 20 20 20 20 20 20 20 hdr+5]);.
b990: 20 69 66 28 20 69 46 72 65 65 32 20 29 7b 0a 20 if( iFree2 ){.
b9a0: 20 20 20 20 20 20 20 20 20 69 66 28 20 69 46 72 if( iFr
b9b0: 65 65 2b 73 7a 3e 69 46 72 65 65 32 20 29 20 72 ee+sz>iFree2 ) r
b9c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
b9d0: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 RUPT_BKPT;.
b9e0: 20 20 20 20 20 73 7a 32 20 3d 20 67 65 74 32 62 sz2 = get2b
b9f0: 79 74 65 28 26 64 61 74 61 5b 69 46 72 65 65 32 yte(&data[iFree2
ba00: 2b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 20 20 +2]);.
ba10: 61 73 73 65 72 74 28 20 69 46 72 65 65 2b 73 7a assert( iFree+sz
ba20: 2b 73 7a 32 2b 69 46 72 65 65 32 2d 28 69 46 72 +sz2+iFree2-(iFr
ba30: 65 65 2b 73 7a 29 20 3c 3d 20 75 73 61 62 6c 65 ee+sz) <= usable
ba40: 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 20 20 Size );.
ba50: 20 20 6d 65 6d 6d 6f 76 65 28 26 64 61 74 61 5b memmove(&data[
ba60: 69 46 72 65 65 2b 73 7a 2b 73 7a 32 5d 2c 20 26 iFree+sz+sz2], &
ba70: 64 61 74 61 5b 69 46 72 65 65 2b 73 7a 5d 2c 20 data[iFree+sz],
ba80: 69 46 72 65 65 32 2d 28 69 46 72 65 65 2b 73 7a iFree2-(iFree+sz
ba90: 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 7a ));. sz
baa0: 20 2b 3d 20 73 7a 32 3b 0a 20 20 20 20 20 20 20 += sz2;.
bab0: 20 7d 0a 20 20 20 20 20 20 20 20 63 62 72 6b 20 }. cbrk
bac0: 3d 20 74 6f 70 2b 73 7a 3b 0a 20 20 20 20 20 20 = top+sz;.
bad0: 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 2b 28 assert( cbrk+(
bae0: 69 46 72 65 65 2d 74 6f 70 29 20 3c 3d 20 75 73 iFree-top) <= us
baf0: 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 ableSize );.
bb00: 20 20 20 20 6d 65 6d 6d 6f 76 65 28 26 64 61 74 memmove(&dat
bb10: 61 5b 63 62 72 6b 5d 2c 20 26 64 61 74 61 5b 74 a[cbrk], &data[t
bb20: 6f 70 5d 2c 20 69 46 72 65 65 2d 74 6f 70 29 3b op], iFree-top);
bb30: 0a 20 20 20 20 20 20 20 20 66 6f 72 28 70 41 64 . for(pAd
bb40: 64 72 3d 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 dr=&data[cellOff
bb50: 73 65 74 5d 3b 20 70 41 64 64 72 3c 70 45 6e 64 set]; pAddr<pEnd
bb60: 3b 20 70 41 64 64 72 2b 3d 32 29 7b 0a 20 20 20 ; pAddr+=2){.
bb70: 20 20 20 20 20 20 20 70 63 20 3d 20 67 65 74 32 pc = get2
bb80: 62 79 74 65 28 70 41 64 64 72 29 3b 0a 20 20 20 byte(pAddr);.
bb90: 20 20 20 20 20 20 20 69 66 28 20 70 63 3c 69 46 if( pc<iF
bba0: 72 65 65 20 29 7b 20 70 75 74 32 62 79 74 65 28 ree ){ put2byte(
bbb0: 70 41 64 64 72 2c 20 70 63 2b 73 7a 29 3b 20 7d pAddr, pc+sz); }
bbc0: 0a 20 20 20 20 20 20 20 20 20 20 65 6c 73 65 20 . else
bbd0: 69 66 28 20 70 63 3c 69 46 72 65 65 32 20 29 7b if( pc<iFree2 ){
bbe0: 20 70 75 74 32 62 79 74 65 28 70 41 64 64 72 2c put2byte(pAddr,
bbf0: 20 70 63 2b 73 7a 32 29 3b 20 7d 0a 20 20 20 20 pc+sz2); }.
bc00: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 67 6f }. go
bc10: 74 6f 20 64 65 66 72 61 67 6d 65 6e 74 5f 6f 75 to defragment_ou
bc20: 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d t;. }. }
bc30: 0a 20 20 7d 0a 0a 20 20 63 62 72 6b 20 3d 20 75 . }.. cbrk = u
bc40: 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 69 43 65 sableSize;. iCe
bc50: 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c 65 53 llLast = usableS
bc60: 69 7a 65 20 2d 20 34 3b 0a 20 20 66 6f 72 28 69 ize - 4;. for(i
bc70: 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b =0; i<nCell; i++
bc80: 29 7b 0a 20 20 20 20 75 38 20 2a 70 41 64 64 72 ){. u8 *pAddr
bc90: 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 69 2d 74 ; /* The i-t
bca0: 68 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 2a h cell pointer *
bcb0: 2f 0a 20 20 20 20 70 41 64 64 72 20 3d 20 26 64 /. pAddr = &d
bcc0: 61 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 20 2b ata[cellOffset +
bcd0: 20 69 2a 32 5d 3b 0a 20 20 20 20 70 63 20 3d 20 i*2];. pc =
bce0: 67 65 74 32 62 79 74 65 28 70 41 64 64 72 29 3b get2byte(pAddr);
bcf0: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 . testcase( p
bd00: 63 3d 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b c==iCellFirst );
bd10: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 . testcase( p
bd20: 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a c==iCellLast );.
bd30: 20 20 20 20 2f 2a 20 54 68 65 73 65 20 63 6f 6e /* These con
bd40: 64 69 74 69 6f 6e 73 20 68 61 76 65 20 61 6c 72 ditions have alr
bd50: 65 61 64 79 20 62 65 65 6e 20 76 65 72 69 66 69 eady been verifi
bd60: 65 64 20 69 6e 20 62 74 72 65 65 49 6e 69 74 50 ed in btreeInitP
bd70: 61 67 65 28 29 0a 20 20 20 20 2a 2a 20 69 66 20 age(). ** if
bd80: 50 52 41 47 4d 41 20 63 65 6c 6c 5f 73 69 7a 65 PRAGMA cell_size
bd90: 5f 63 68 65 63 6b 3d 4f 4e 2e 0a 20 20 20 20 2a _check=ON.. *
bda0: 2f 0a 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 /. if( pc<iCe
bdb0: 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 llFirst || pc>iC
bdc0: 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 ellLast ){.
bdd0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
bde0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
bdf0: 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 }. assert( p
be00: 63 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 26 26 c>=iCellFirst &&
be10: 20 70 63 3c 3d 69 43 65 6c 6c 4c 61 73 74 20 29 pc<=iCellLast )
be20: 3b 0a 20 20 20 20 73 69 7a 65 20 3d 20 70 50 61 ;. size = pPa
be30: 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 ge->xCellSize(pP
be40: 61 67 65 2c 20 26 73 72 63 5b 70 63 5d 29 3b 0a age, &src[pc]);.
be50: 20 20 20 20 63 62 72 6b 20 2d 3d 20 73 69 7a 65 cbrk -= size
be60: 3b 0a 20 20 20 20 69 66 28 20 63 62 72 6b 3c 69 ;. if( cbrk<i
be70: 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 2b CellFirst || pc+
be80: 73 69 7a 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 size>usableSize
be90: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
bea0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
beb0: 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 KPT;. }. a
bec0: 73 73 65 72 74 28 20 63 62 72 6b 2b 73 69 7a 65 ssert( cbrk+size
bed0: 3c 3d 75 73 61 62 6c 65 53 69 7a 65 20 26 26 20 <=usableSize &&
bee0: 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 72 73 74 cbrk>=iCellFirst
bef0: 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 );. testcase
bf00: 28 20 63 62 72 6b 2b 73 69 7a 65 3d 3d 75 73 61 ( cbrk+size==usa
bf10: 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 74 bleSize );. t
bf20: 65 73 74 63 61 73 65 28 20 70 63 2b 73 69 7a 65 estcase( pc+size
bf30: 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ==usableSize );.
bf40: 20 20 20 20 70 75 74 32 62 79 74 65 28 70 41 64 put2byte(pAd
bf50: 64 72 2c 20 63 62 72 6b 29 3b 0a 20 20 20 20 69 dr, cbrk);. i
bf60: 66 28 20 74 65 6d 70 3d 3d 30 20 29 7b 0a 20 20 f( temp==0 ){.
bf70: 20 20 20 20 69 6e 74 20 78 3b 0a 20 20 20 20 20 int x;.
bf80: 20 69 66 28 20 63 62 72 6b 3d 3d 70 63 20 29 20 if( cbrk==pc )
bf90: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 continue;.
bfa0: 74 65 6d 70 20 3d 20 73 71 6c 69 74 65 33 50 61 temp = sqlite3Pa
bfb0: 67 65 72 54 65 6d 70 53 70 61 63 65 28 70 50 61 gerTempSpace(pPa
bfc0: 67 65 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 29 ge->pBt->pPager)
bfd0: 3b 0a 20 20 20 20 20 20 78 20 3d 20 67 65 74 32 ;. x = get2
bfe0: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
bff0: 5d 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 ]);. memcpy
c000: 28 26 74 65 6d 70 5b 78 5d 2c 20 26 64 61 74 61 (&temp[x], &data
c010: 5b 78 5d 2c 20 28 63 62 72 6b 2b 73 69 7a 65 29 [x], (cbrk+size)
c020: 20 2d 20 78 29 3b 0a 20 20 20 20 20 20 73 72 63 - x);. src
c030: 20 3d 20 74 65 6d 70 3b 0a 20 20 20 20 7d 0a 20 = temp;. }.
c040: 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b memcpy(&data[
c050: 63 62 72 6b 5d 2c 20 26 73 72 63 5b 70 63 5d 2c cbrk], &src[pc],
c060: 20 73 69 7a 65 29 3b 0a 20 20 7d 0a 20 20 64 61 size);. }. da
c070: 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b 0a 0a ta[hdr+7] = 0;..
c080: 20 64 65 66 72 61 67 6d 65 6e 74 5f 6f 75 74 3a defragment_out:
c090: 0a 20 20 69 66 28 20 64 61 74 61 5b 68 64 72 2b . if( data[hdr+
c0a0: 37 5d 2b 63 62 72 6b 2d 69 43 65 6c 6c 46 69 72 7]+cbrk-iCellFir
c0b0: 73 74 21 3d 70 50 61 67 65 2d 3e 6e 46 72 65 65 st!=pPage->nFree
c0c0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
c0d0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
c0e0: 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 PT;. }. assert
c0f0: 28 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 72 ( cbrk>=iCellFir
c100: 73 74 20 29 3b 0a 20 20 70 75 74 32 62 79 74 65 st );. put2byte
c110: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 63 (&data[hdr+5], c
c120: 62 72 6b 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 brk);. data[hdr
c130: 2b 31 5d 20 3d 20 30 3b 0a 20 20 64 61 74 61 5b +1] = 0;. data[
c140: 68 64 72 2b 32 5d 20 3d 20 30 3b 0a 20 20 6d 65 hdr+2] = 0;. me
c150: 6d 73 65 74 28 26 64 61 74 61 5b 69 43 65 6c 6c mset(&data[iCell
c160: 46 69 72 73 74 5d 2c 20 30 2c 20 63 62 72 6b 2d First], 0, cbrk-
c170: 69 43 65 6c 6c 46 69 72 73 74 29 3b 0a 20 20 61 iCellFirst);. a
c180: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
c190: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
c1a0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
c1b0: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
c1c0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 E_OK;.}../*.** S
c1d0: 65 61 72 63 68 20 74 68 65 20 66 72 65 65 2d 6c earch the free-l
c1e0: 69 73 74 20 6f 6e 20 70 61 67 65 20 70 50 67 20 ist on page pPg
c1f0: 66 6f 72 20 73 70 61 63 65 20 74 6f 20 73 74 6f for space to sto
c200: 72 65 20 61 20 63 65 6c 6c 20 6e 42 79 74 65 20 re a cell nByte
c210: 62 79 74 65 73 20 69 6e 0a 2a 2a 20 73 69 7a 65 bytes in.** size
c220: 2e 20 49 66 20 6f 6e 65 20 63 61 6e 20 62 65 20 . If one can be
c230: 66 6f 75 6e 64 2c 20 72 65 74 75 72 6e 20 61 20 found, return a
c240: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 pointer to the s
c250: 70 61 63 65 20 61 6e 64 20 72 65 6d 6f 76 65 20 pace and remove
c260: 69 74 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 66 it.** from the f
c270: 72 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 ree-list..**.**
c280: 49 66 20 6e 6f 20 73 75 69 74 61 62 6c 65 20 73 If no suitable s
c290: 70 61 63 65 20 63 61 6e 20 62 65 20 66 6f 75 6e pace can be foun
c2a0: 64 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 d on the free-li
c2b0: 73 74 2c 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e st, return NULL.
c2c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
c2d0: 74 69 6f 6e 20 6d 61 79 20 64 65 74 65 63 74 20 tion may detect
c2e0: 63 6f 72 72 75 70 74 69 6f 6e 20 77 69 74 68 69 corruption withi
c2f0: 6e 20 70 50 67 2e 20 20 49 66 20 63 6f 72 72 75 n pPg. If corru
c300: 70 74 69 6f 6e 20 69 73 0a 2a 2a 20 64 65 74 65 ption is.** dete
c310: 63 74 65 64 20 74 68 65 6e 20 2a 70 52 63 20 69 cted then *pRc i
c320: 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f s set to SQLITE_
c330: 43 4f 52 52 55 50 54 20 61 6e 64 20 4e 55 4c 4c CORRUPT and NULL
c340: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a is returned..**
c350: 0a 2a 2a 20 53 6c 6f 74 73 20 6f 6e 20 74 68 65 .** Slots on the
c360: 20 66 72 65 65 20 6c 69 73 74 20 74 68 61 74 20 free list that
c370: 61 72 65 20 62 65 74 77 65 65 6e 20 31 20 61 6e are between 1 an
c380: 64 20 33 20 62 79 74 65 73 20 6c 61 72 67 65 72 d 3 bytes larger
c390: 20 74 68 61 6e 20 6e 42 79 74 65 0a 2a 2a 20 77 than nByte.** w
c3a0: 69 6c 6c 20 62 65 20 69 67 6e 6f 72 65 64 20 69 ill be ignored i
c3b0: 66 20 61 64 64 69 6e 67 20 74 68 65 20 65 78 74 f adding the ext
c3c0: 72 61 20 73 70 61 63 65 20 74 6f 20 74 68 65 20 ra space to the
c3d0: 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 63 6f fragmentation co
c3e0: 75 6e 74 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 unt.** causes th
c3f0: 65 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 e fragmentation
c400: 63 6f 75 6e 74 20 74 6f 20 65 78 63 65 65 64 20 count to exceed
c410: 36 30 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 38 60..*/.static u8
c420: 20 2a 70 61 67 65 46 69 6e 64 53 6c 6f 74 28 4d *pageFindSlot(M
c430: 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 69 6e 74 emPage *pPg, int
c440: 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 52 63 nByte, int *pRc
c450: 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 ){. const int h
c460: 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 dr = pPg->hdrOff
c470: 73 65 74 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 set;. u8 * cons
c480: 74 20 61 44 61 74 61 20 3d 20 70 50 67 2d 3e 61 t aData = pPg->a
c490: 44 61 74 61 3b 0a 20 20 69 6e 74 20 69 41 64 64 Data;. int iAdd
c4a0: 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 r = hdr + 1;. i
c4b0: 6e 74 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 nt pc = get2byte
c4c0: 28 26 61 44 61 74 61 5b 69 41 64 64 72 5d 29 3b (&aData[iAddr]);
c4d0: 0a 20 20 69 6e 74 20 78 3b 0a 20 20 69 6e 74 20 . int x;. int
c4e0: 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 67 usableSize = pPg
c4f0: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
c500: 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 63 e;.. assert( pc
c510: 3e 30 20 29 3b 0a 20 20 64 6f 7b 0a 20 20 20 20 >0 );. do{.
c520: 69 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 20 int size;
c530: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
c540: 74 68 65 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f the free slot */
c550: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
c560: 2d 4f 46 3a 20 52 2d 30 36 38 36 36 2d 33 39 31 -OF: R-06866-391
c570: 32 35 20 46 72 65 65 62 6c 6f 63 6b 73 20 61 72 25 Freeblocks ar
c580: 65 20 61 6c 77 61 79 73 20 63 6f 6e 6e 65 63 74 e always connect
c590: 65 64 20 69 6e 20 6f 72 64 65 72 20 6f 66 0a 20 ed in order of.
c5a0: 20 20 20 2a 2a 20 69 6e 63 72 65 61 73 69 6e 67 ** increasing
c5b0: 20 6f 66 66 73 65 74 2e 20 2a 2f 0a 20 20 20 20 offset. */.
c5c0: 69 66 28 20 70 63 3e 75 73 61 62 6c 65 53 69 7a if( pc>usableSiz
c5d0: 65 2d 34 20 7c 7c 20 70 63 3c 69 41 64 64 72 2b e-4 || pc<iAddr+
c5e0: 34 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 63 20 4 ){. *pRc
c5f0: 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
c600: 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 72 65 74 _BKPT;. ret
c610: 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 urn 0;. }.
c620: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
c630: 20 52 2d 32 32 37 31 30 2d 35 33 33 32 38 20 54 R-22710-53328 T
c640: 68 65 20 74 68 69 72 64 20 61 6e 64 20 66 6f 75 he third and fou
c650: 72 74 68 20 62 79 74 65 73 20 6f 66 20 65 61 63 rth bytes of eac
c660: 68 0a 20 20 20 20 2a 2a 20 66 72 65 65 62 6c 6f h. ** freeblo
c670: 63 6b 20 66 6f 72 6d 20 61 20 62 69 67 2d 65 6e ck form a big-en
c680: 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 dian integer whi
c690: 63 68 20 69 73 20 74 68 65 20 73 69 7a 65 20 6f ch is the size o
c6a0: 66 20 74 68 65 20 66 72 65 65 62 6c 6f 63 6b 0a f the freeblock.
c6b0: 20 20 20 20 2a 2a 20 69 6e 20 62 79 74 65 73 2c ** in bytes,
c6c0: 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 34 including the 4
c6d0: 2d 62 79 74 65 20 68 65 61 64 65 72 2e 20 2a 2f -byte header. */
c6e0: 0a 20 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 . size = get2
c6f0: 62 79 74 65 28 26 61 44 61 74 61 5b 70 63 2b 32 byte(&aData[pc+2
c700: 5d 29 3b 0a 20 20 20 20 69 66 28 20 28 78 20 3d ]);. if( (x =
c710: 20 73 69 7a 65 20 2d 20 6e 42 79 74 65 29 3e 3d size - nByte)>=
c720: 30 20 29 7b 0a 20 20 20 20 20 20 74 65 73 74 63 0 ){. testc
c730: 61 73 65 28 20 78 3d 3d 34 20 29 3b 0a 20 20 20 ase( x==4 );.
c740: 20 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d testcase( x==
c750: 33 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 3 );. if( p
c760: 63 20 3c 20 70 50 67 2d 3e 63 65 6c 6c 4f 66 66 c < pPg->cellOff
c770: 73 65 74 2b 32 2a 70 50 67 2d 3e 6e 43 65 6c 6c set+2*pPg->nCell
c780: 20 7c 7c 20 73 69 7a 65 2b 70 63 20 3e 20 75 73 || size+pc > us
c790: 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 ableSize ){.
c7a0: 20 20 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 *pRc = SQLIT
c7b0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
c7c0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 30 return 0
c7d0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 ;. }else if
c7e0: 28 20 78 3c 34 20 29 7b 0a 20 20 20 20 20 20 20 ( x<4 ){.
c7f0: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
c800: 20 52 2d 31 31 34 39 38 2d 35 38 30 32 32 20 49 R-11498-58022 I
c810: 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 n a well-formed
c820: 62 2d 74 72 65 65 20 70 61 67 65 2c 20 74 68 65 b-tree page, the
c830: 20 74 6f 74 61 6c 0a 20 20 20 20 20 20 20 20 2a total. *
c840: 2a 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 * number of byte
c850: 73 20 69 6e 20 66 72 61 67 6d 65 6e 74 73 20 6d s in fragments m
c860: 61 79 20 6e 6f 74 20 65 78 63 65 65 64 20 36 30 ay not exceed 60
c870: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 . */. if(
c880: 20 61 44 61 74 61 5b 68 64 72 2b 37 5d 3e 35 37 aData[hdr+7]>57
c890: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 0a 20 20 ) return 0;..
c8a0: 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 /* Remove
c8b0: 74 68 65 20 73 6c 6f 74 20 66 72 6f 6d 20 74 68 the slot from th
c8c0: 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 55 70 64 e free-list. Upd
c8d0: 61 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ate the number o
c8e0: 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 72 61 f. ** fra
c8f0: 67 6d 65 6e 74 65 64 20 62 79 74 65 73 20 77 69 gmented bytes wi
c900: 74 68 69 6e 20 74 68 65 20 70 61 67 65 2e 20 2a thin the page. *
c910: 2f 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 /. memcpy
c920: 28 26 61 44 61 74 61 5b 69 41 64 64 72 5d 2c 20 (&aData[iAddr],
c930: 26 61 44 61 74 61 5b 70 63 5d 2c 20 32 29 3b 0a &aData[pc], 2);.
c940: 20 20 20 20 20 20 20 20 61 44 61 74 61 5b 68 64 aData[hd
c950: 72 2b 37 5d 20 2b 3d 20 28 75 38 29 78 3b 0a 20 r+7] += (u8)x;.
c960: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
c970: 20 20 20 20 2f 2a 20 54 68 65 20 73 6c 6f 74 20 /* The slot
c980: 72 65 6d 61 69 6e 73 20 6f 6e 20 74 68 65 20 66 remains on the f
c990: 72 65 65 2d 6c 69 73 74 2e 20 52 65 64 75 63 65 ree-list. Reduce
c9a0: 20 69 74 73 20 73 69 7a 65 20 74 6f 20 61 63 63 its size to acc
c9b0: 6f 75 6e 74 0a 20 20 20 20 20 20 20 20 20 2a 2a ount. **
c9c0: 20 66 6f 72 20 74 68 65 20 70 6f 72 74 69 6f 6e for the portion
c9d0: 20 75 73 65 64 20 62 79 20 74 68 65 20 6e 65 77 used by the new
c9e0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 2a 2f 0a allocation. */.
c9f0: 20 20 20 20 20 20 20 20 70 75 74 32 62 79 74 65 put2byte
ca00: 28 26 61 44 61 74 61 5b 70 63 2b 32 5d 2c 20 78 (&aData[pc+2], x
ca10: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
ca20: 20 72 65 74 75 72 6e 20 26 61 44 61 74 61 5b 70 return &aData[p
ca30: 63 20 2b 20 78 5d 3b 0a 20 20 20 20 7d 0a 20 20 c + x];. }.
ca40: 20 20 69 41 64 64 72 20 3d 20 70 63 3b 0a 20 20 iAddr = pc;.
ca50: 20 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 pc = get2byte(
ca60: 26 61 44 61 74 61 5b 70 63 5d 29 3b 0a 20 20 7d &aData[pc]);. }
ca70: 77 68 69 6c 65 28 20 70 63 20 29 3b 0a 0a 20 20 while( pc );..
ca80: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a return 0;.}../*.
ca90: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6e 42 79 74 ** Allocate nByt
caa0: 65 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 e bytes of space
cab0: 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 from within the
cac0: 20 42 2d 54 72 65 65 20 70 61 67 65 20 70 61 73 B-Tree page pas
cad0: 73 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69 sed.** as the fi
cae0: 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 20 57 72 rst argument. Wr
caf0: 69 74 65 20 69 6e 74 6f 20 2a 70 49 64 78 20 74 ite into *pIdx t
cb00: 68 65 20 69 6e 64 65 78 20 69 6e 74 6f 20 70 50 he index into pP
cb10: 61 67 65 2d 3e 61 44 61 74 61 5b 5d 0a 2a 2a 20 age->aData[].**
cb20: 6f 66 20 74 68 65 20 66 69 72 73 74 20 62 79 74 of the first byt
cb30: 65 20 6f 66 20 61 6c 6c 6f 63 61 74 65 64 20 73 e of allocated s
cb40: 70 61 63 65 2e 20 52 65 74 75 72 6e 20 65 69 74 pace. Return eit
cb50: 68 65 72 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 her SQLITE_OK or
cb60: 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 .** an error cod
cb70: 65 20 28 75 73 75 61 6c 6c 79 20 53 51 4c 49 54 e (usually SQLIT
cb80: 45 5f 43 4f 52 52 55 50 54 29 2e 0a 2a 2a 0a 2a E_CORRUPT)..**.*
cb90: 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 67 75 61 * The caller gua
cba0: 72 61 6e 74 65 65 73 20 74 68 61 74 20 74 68 65 rantees that the
cbb0: 72 65 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 re is sufficient
cbc0: 20 73 70 61 63 65 20 74 6f 20 6d 61 6b 65 20 74 space to make t
cbd0: 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e he.** allocation
cbe0: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
cbf0: 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 64 65 might need to de
cc00: 66 72 61 67 6d 65 6e 74 20 69 6e 20 6f 72 64 65 fragment in orde
cc10: 72 20 74 6f 20 62 72 69 6e 67 0a 2a 2a 20 61 6c r to bring.** al
cc20: 6c 20 74 68 65 20 73 70 61 63 65 20 74 6f 67 65 l the space toge
cc30: 74 68 65 72 2c 20 68 6f 77 65 76 65 72 2e 20 20 ther, however.
cc40: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c This routine wil
cc50: 6c 20 61 76 6f 69 64 20 75 73 69 6e 67 0a 2a 2a l avoid using.**
cc60: 20 74 68 65 20 66 69 72 73 74 20 74 77 6f 20 62 the first two b
cc70: 79 74 65 73 20 70 61 73 74 20 74 68 65 20 63 65 ytes past the ce
cc80: 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 65 61 20 ll pointer area
cc90: 73 69 6e 63 65 20 70 72 65 73 75 6d 61 62 6c 79 since presumably
cca0: 20 74 68 69 73 0a 2a 2a 20 61 6c 6c 6f 63 61 74 this.** allocat
ccb0: 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 6d 61 64 ion is being mad
ccc0: 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e e in order to in
ccd0: 73 65 72 74 20 61 20 6e 65 77 20 63 65 6c 6c 2c sert a new cell,
cce0: 20 73 6f 20 77 65 20 77 69 6c 6c 0a 2a 2a 20 61 so we will.** a
ccf0: 6c 73 6f 20 65 6e 64 20 75 70 20 6e 65 65 64 69 lso end up needi
cd00: 6e 67 20 61 20 6e 65 77 20 63 65 6c 6c 20 70 6f ng a new cell po
cd10: 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 inter..*/.static
cd20: 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 53 70 61 int allocateSpa
cd30: 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ce(MemPage *pPag
cd40: 65 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 69 6e e, int nByte, in
cd50: 74 20 2a 70 49 64 78 29 7b 0a 20 20 63 6f 6e 73 t *pIdx){. cons
cd60: 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 61 67 t int hdr = pPag
cd70: 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 20 20 e->hdrOffset;
cd80: 20 2f 2a 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 /* Local cache
cd90: 6f 66 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 of pPage->hdrOff
cda0: 73 65 74 20 2a 2f 0a 20 20 75 38 20 2a 20 63 6f set */. u8 * co
cdb0: 6e 73 74 20 64 61 74 61 20 3d 20 70 50 61 67 65 nst data = pPage
cdc0: 2d 3e 61 44 61 74 61 3b 20 20 20 20 20 20 2f 2a ->aData; /*
cdd0: 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 Local cache of
cde0: 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a pPage->aData */.
cdf0: 20 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 int top;
ce00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ce10: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
ce20: 62 79 74 65 20 6f 66 20 63 65 6c 6c 20 63 6f 6e byte of cell con
ce30: 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 69 tent area */. i
ce40: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
ce50: 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 K;
ce60: 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 72 /* Integer r
ce70: 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
ce80: 69 6e 74 20 67 61 70 3b 20 20 20 20 20 20 20 20 int gap;
ce90: 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 /* First byte of
cea0: 20 67 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c gap between cel
ceb0: 6c 20 70 6f 69 6e 74 65 72 73 20 61 6e 64 20 63 l pointers and c
cec0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 ell content */.
ced0: 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 . assert( sqli
cee0: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
cef0: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
cf00: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
cf10: 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 pPage->pBt );.
cf20: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
cf30: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
cf40: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
cf50: 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 42 79 74 ;. assert( nByt
cf60: 65 3e 3d 30 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 e>=0 ); /* Mini
cf70: 6d 75 6d 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 mum cell size is
cf80: 20 34 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 4 */. assert(
cf90: 70 50 61 67 65 2d 3e 6e 46 72 65 65 3e 3d 6e 42 pPage->nFree>=nB
cfa0: 79 74 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 yte );. assert(
cfb0: 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
cfc0: 77 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 w==0 );. assert
cfd0: 28 20 6e 42 79 74 65 20 3c 20 28 69 6e 74 29 28 ( nByte < (int)(
cfe0: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
cff0: 6c 65 53 69 7a 65 2d 38 29 20 29 3b 0a 0a 20 20 leSize-8) );..
d000: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 assert( pPage->c
d010: 65 6c 6c 4f 66 66 73 65 74 20 3d 3d 20 68 64 72 ellOffset == hdr
d020: 20 2b 20 31 32 20 2d 20 34 2a 70 50 61 67 65 2d + 12 - 4*pPage-
d030: 3e 6c 65 61 66 20 29 3b 0a 20 20 67 61 70 20 3d >leaf );. gap =
d040: 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
d050: 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e 43 et + 2*pPage->nC
d060: 65 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 67 ell;. assert( g
d070: 61 70 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 2f ap<=65536 );. /
d080: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
d090: 2d 32 39 33 35 36 2d 30 32 33 39 31 20 49 66 20 -29356-02391 If
d0a0: 74 68 65 20 64 61 74 61 62 61 73 65 20 75 73 65 the database use
d0b0: 73 20 61 20 36 35 35 33 36 2d 62 79 74 65 20 70 s a 65536-byte p
d0c0: 61 67 65 20 73 69 7a 65 0a 20 20 2a 2a 20 61 6e age size. ** an
d0d0: 64 20 74 68 65 20 72 65 73 65 72 76 65 64 20 73 d the reserved s
d0e0: 70 61 63 65 20 69 73 20 7a 65 72 6f 20 28 74 68 pace is zero (th
d0f0: 65 20 75 73 75 61 6c 20 76 61 6c 75 65 20 66 6f e usual value fo
d100: 72 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 r reserved space
d110: 29 0a 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 ). ** then the
d120: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 6f 66 66 cell content off
d130: 73 65 74 20 6f 66 20 61 6e 20 65 6d 70 74 79 20 set of an empty
d140: 70 61 67 65 20 77 61 6e 74 73 20 74 6f 20 62 65 page wants to be
d150: 20 36 35 35 33 36 2e 0a 20 20 2a 2a 20 48 6f 77 65536.. ** How
d160: 65 76 65 72 2c 20 74 68 61 74 20 69 6e 74 65 67 ever, that integ
d170: 65 72 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 20 er is too large
d180: 74 6f 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 to be stored in
d190: 61 20 32 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 a 2-byte unsigne
d1a0: 64 0a 20 20 2a 2a 20 69 6e 74 65 67 65 72 2c 20 d. ** integer,
d1b0: 73 6f 20 61 20 76 61 6c 75 65 20 6f 66 20 30 20 so a value of 0
d1c0: 69 73 20 75 73 65 64 20 69 6e 20 69 74 73 20 70 is used in its p
d1d0: 6c 61 63 65 2e 20 2a 2f 0a 20 20 74 6f 70 20 3d lace. */. top =
d1e0: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
d1f0: 68 64 72 2b 35 5d 29 3b 0a 20 20 61 73 73 65 72 hdr+5]);. asser
d200: 74 28 20 74 6f 70 3c 3d 28 69 6e 74 29 70 50 61 t( top<=(int)pPa
d210: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
d220: 69 7a 65 20 29 3b 20 2f 2a 20 50 72 65 76 65 6e ize ); /* Preven
d230: 74 20 62 79 20 67 65 74 41 6e 64 49 6e 69 74 50 t by getAndInitP
d240: 61 67 65 28 29 20 2a 2f 0a 20 20 69 66 28 20 67 age() */. if( g
d250: 61 70 3e 74 6f 70 20 29 7b 0a 20 20 20 20 69 66 ap>top ){. if
d260: 28 20 74 6f 70 3d 3d 30 20 26 26 20 70 50 61 67 ( top==0 && pPag
d270: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
d280: 7a 65 3d 3d 36 35 35 33 36 20 29 7b 0a 20 20 20 ze==65536 ){.
d290: 20 20 20 74 6f 70 20 3d 20 36 35 35 33 36 3b 0a top = 65536;.
d2a0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
d2b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
d2c0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
d2d0: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 }. }.. /* If
d2e0: 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 68 20 there is enough
d2f0: 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 67 61 space between ga
d300: 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 6f 6e p and top for on
d310: 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f 69 6e e more cell poin
d320: 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 20 65 ter. ** array e
d330: 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 6e 64 ntry offset, and
d340: 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 if the freelist
d350: 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c 20 74 is not empty, t
d360: 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 0a 20 hen search the.
d370: 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c 6f 6f ** freelist loo
d380: 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 65 20 king for a free
d390: 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 68 20 slot big enough
d3a0: 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 20 72 to satisfy the r
d3b0: 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 20 74 equest.. */. t
d3c0: 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 3d 3d estcase( gap+2==
d3d0: 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 61 73 top );. testcas
d3e0: 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 29 3b e( gap+1==top );
d3f0: 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 70 . testcase( gap
d400: 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 28 ==top );. if( (
d410: 64 61 74 61 5b 68 64 72 2b 32 5d 20 7c 7c 20 64 data[hdr+2] || d
d420: 61 74 61 5b 68 64 72 2b 31 5d 29 20 26 26 20 67 ata[hdr+1]) && g
d430: 61 70 2b 32 3c 3d 74 6f 70 20 29 7b 0a 20 20 20 ap+2<=top ){.
d440: 20 75 38 20 2a 70 53 70 61 63 65 20 3d 20 70 61 u8 *pSpace = pa
d450: 67 65 46 69 6e 64 53 6c 6f 74 28 70 50 61 67 65 geFindSlot(pPage
d460: 2c 20 6e 42 79 74 65 2c 20 26 72 63 29 3b 0a 20 , nByte, &rc);.
d470: 20 20 20 69 66 28 20 70 53 70 61 63 65 20 29 7b if( pSpace ){
d480: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
d490: 53 70 61 63 65 3e 3d 64 61 74 61 20 26 26 20 28 Space>=data && (
d4a0: 70 53 70 61 63 65 20 2d 20 64 61 74 61 29 3c 36 pSpace - data)<6
d4b0: 35 35 33 36 20 29 3b 0a 20 20 20 20 20 20 2a 70 5536 );. *p
d4c0: 49 64 78 20 3d 20 28 69 6e 74 29 28 70 53 70 61 Idx = (int)(pSpa
d4d0: 63 65 20 2d 20 64 61 74 61 29 3b 0a 20 20 20 20 ce - data);.
d4e0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d4f0: 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 OK;. }else if
d500: 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 ( rc ){. re
d510: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
d520: 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 72 65 71 }.. /* The req
d530: 75 65 73 74 20 63 6f 75 6c 64 20 6e 6f 74 20 62 uest could not b
d540: 65 20 66 75 6c 66 69 6c 6c 65 64 20 75 73 69 6e e fulfilled usin
d550: 67 20 61 20 66 72 65 65 6c 69 73 74 20 73 6c 6f g a freelist slo
d560: 74 2e 20 20 43 68 65 63 6b 0a 20 20 2a 2a 20 74 t. Check. ** t
d570: 6f 20 73 65 65 20 69 66 20 64 65 66 72 61 67 6d o see if defragm
d580: 65 6e 74 61 74 69 6f 6e 20 69 73 20 6e 65 63 65 entation is nece
d590: 73 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 74 65 ssary.. */. te
d5a0: 73 74 63 61 73 65 28 20 67 61 70 2b 32 2b 6e 42 stcase( gap+2+nB
d5b0: 79 74 65 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 yte==top );. if
d5c0: 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3e 74 6f ( gap+2+nByte>to
d5d0: 70 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 p ){. assert(
d5e0: 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 pPage->nCell>0
d5f0: 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
d600: 0a 20 20 20 20 72 63 20 3d 20 64 65 66 72 61 67 . rc = defrag
d610: 6d 65 6e 74 50 61 67 65 28 70 50 61 67 65 2c 20 mentPage(pPage,
d620: 4d 49 4e 28 34 2c 20 70 50 61 67 65 2d 3e 6e 46 MIN(4, pPage->nF
d630: 72 65 65 20 2d 20 28 32 2b 6e 42 79 74 65 29 29 ree - (2+nByte))
d640: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
d650: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 74 return rc;. t
d660: 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e 6f 74 op = get2byteNot
d670: 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 2b 35 Zero(&data[hdr+5
d680: 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ]);. assert(
d690: 67 61 70 2b 32 2b 6e 42 79 74 65 3c 3d 74 6f 70 gap+2+nByte<=top
d6a0: 20 29 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 41 );. }... /* A
d6b0: 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20 66 llocate memory f
d6c0: 72 6f 6d 20 74 68 65 20 67 61 70 20 69 6e 20 62 rom the gap in b
d6d0: 65 74 77 65 65 6e 20 74 68 65 20 63 65 6c 6c 20 etween the cell
d6e0: 70 6f 69 6e 74 65 72 20 61 72 72 61 79 0a 20 20 pointer array.
d6f0: 2a 2a 20 61 6e 64 20 74 68 65 20 63 65 6c 6c 20 ** and the cell
d700: 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 20 54 content area. T
d710: 68 65 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 he btreeInitPage
d720: 28 29 20 63 61 6c 6c 20 68 61 73 20 61 6c 72 65 () call has alre
d730: 61 64 79 0a 20 20 2a 2a 20 76 61 6c 69 64 61 74 ady. ** validat
d740: 65 64 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e ed the freelist.
d750: 20 20 47 69 76 65 6e 20 74 68 61 74 20 74 68 65 Given that the
d760: 20 66 72 65 65 6c 69 73 74 20 69 73 20 76 61 6c freelist is val
d770: 69 64 2c 20 74 68 65 72 65 0a 20 20 2a 2a 20 69 id, there. ** i
d780: 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 74 68 s no way that th
d790: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 63 61 6e e allocation can
d7a0: 20 65 78 74 65 6e 64 20 6f 66 66 20 74 68 65 20 extend off the
d7b0: 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 2e end of the page.
d7c0: 0a 20 20 2a 2a 20 54 68 65 20 61 73 73 65 72 74 . ** The assert
d7d0: 28 29 20 62 65 6c 6f 77 20 76 65 72 69 66 69 65 () below verifie
d7e0: 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 s the previous s
d7f0: 65 6e 74 65 6e 63 65 2e 0a 20 20 2a 2f 0a 20 20 entence.. */.
d800: 74 6f 70 20 2d 3d 20 6e 42 79 74 65 3b 0a 20 20 top -= nByte;.
d810: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
d820: 64 72 2b 35 5d 2c 20 74 6f 70 29 3b 0a 20 20 61 dr+5], top);. a
d830: 73 73 65 72 74 28 20 74 6f 70 2b 6e 42 79 74 65 ssert( top+nByte
d840: 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 2d 3e <= (int)pPage->
d850: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
d860: 29 3b 0a 20 20 2a 70 49 64 78 20 3d 20 74 6f 70 );. *pIdx = top
d870: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
d880: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 E_OK;.}../*.** R
d890: 65 74 75 72 6e 20 61 20 73 65 63 74 69 6f 6e 20 eturn a section
d8a0: 6f 66 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 of the pPage->aD
d8b0: 61 74 61 20 74 6f 20 74 68 65 20 66 72 65 65 6c ata to the freel
d8c0: 69 73 74 2e 0a 2a 2a 20 54 68 65 20 66 69 72 73 ist..** The firs
d8d0: 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 6e 65 t byte of the ne
d8e0: 77 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 73 20 w free block is
d8f0: 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 69 53 74 pPage->aData[iSt
d900: 61 72 74 5d 0a 2a 2a 20 61 6e 64 20 74 68 65 20 art].** and the
d910: 73 69 7a 65 20 6f 66 20 74 68 65 20 62 6c 6f 63 size of the bloc
d920: 6b 20 69 73 20 69 53 69 7a 65 20 62 79 74 65 73 k is iSize bytes
d930: 2e 0a 2a 2a 0a 2a 2a 20 41 64 6a 61 63 65 6e 74 ..**.** Adjacent
d940: 20 66 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 20 freeblocks are
d950: 63 6f 61 6c 65 73 63 65 64 2e 0a 2a 2a 0a 2a 2a coalesced..**.**
d960: 20 4e 6f 74 65 20 74 68 61 74 20 65 76 65 6e 20 Note that even
d970: 74 68 6f 75 67 68 20 74 68 65 20 66 72 65 65 62 though the freeb
d980: 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 20 63 68 lock list was ch
d990: 65 63 6b 65 64 20 62 79 20 62 74 72 65 65 49 6e ecked by btreeIn
d9a0: 69 74 50 61 67 65 28 29 2c 0a 2a 2a 20 74 68 61 itPage(),.** tha
d9b0: 74 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6e t routine will n
d9c0: 6f 74 20 64 65 74 65 63 74 20 6f 76 65 72 6c 61 ot detect overla
d9d0: 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c 73 20 p between cells
d9e0: 6f 72 20 66 72 65 65 62 6c 6f 63 6b 73 2e 20 20 or freeblocks.
d9f0: 4e 6f 72 0a 2a 2a 20 64 6f 65 73 20 69 74 20 64 Nor.** does it d
da00: 65 74 65 63 74 20 63 65 6c 6c 73 20 6f 72 20 66 etect cells or f
da10: 72 65 65 62 6c 6f 63 6b 73 20 74 68 61 74 20 65 reeblocks that e
da20: 6e 63 72 6f 75 63 68 20 69 6e 74 6f 20 74 68 65 ncrouch into the
da30: 20 72 65 73 65 72 76 65 64 20 62 79 74 65 73 0a reserved bytes.
da40: 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 ** at the end of
da50: 20 74 68 65 20 70 61 67 65 2e 20 20 53 6f 20 64 the page. So d
da60: 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6f 72 o additional cor
da70: 72 75 70 74 69 6f 6e 20 63 68 65 63 6b 73 20 69 ruption checks i
da80: 6e 73 69 64 65 20 74 68 69 73 0a 2a 2a 20 72 6f nside this.** ro
da90: 75 74 69 6e 65 20 61 6e 64 20 72 65 74 75 72 6e utine and return
daa0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 SQLITE_CORRUPT
dab0: 69 66 20 61 6e 79 20 70 72 6f 62 6c 65 6d 73 20 if any problems
dac0: 61 72 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 are found..*/.st
dad0: 61 74 69 63 20 69 6e 74 20 66 72 65 65 53 70 61 atic int freeSpa
dae0: 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ce(MemPage *pPag
daf0: 65 2c 20 75 31 36 20 69 53 74 61 72 74 2c 20 75 e, u16 iStart, u
db00: 31 36 20 69 53 69 7a 65 29 7b 0a 20 20 75 31 36 16 iSize){. u16
db10: 20 69 50 74 72 3b 20 20 20 20 20 20 20 20 20 20 iPtr;
db20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db30: 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 /* Address of
db40: 20 70 74 72 20 74 6f 20 6e 65 78 74 20 66 72 65 ptr to next fre
db50: 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 31 36 20 eblock */. u16
db60: 69 46 72 65 65 42 6c 6b 3b 20 20 20 20 20 20 20 iFreeBlk;
db70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db80: 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 /* Address of
db90: 74 68 65 20 6e 65 78 74 20 66 72 65 65 62 6c 6f the next freeblo
dba0: 63 6b 20 2a 2f 0a 20 20 75 38 20 68 64 72 3b 20 ck */. u8 hdr;
dbb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dbc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
dbd0: 20 50 61 67 65 20 68 65 61 64 65 72 20 73 69 7a Page header siz
dbe0: 65 2e 20 20 30 20 6f 72 20 31 30 30 20 2a 2f 0a e. 0 or 100 */.
dbf0: 20 20 75 38 20 6e 46 72 61 67 20 3d 20 30 3b 20 u8 nFrag = 0;
dc00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dc10: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 64 75 63 /* Reduc
dc20: 74 69 6f 6e 20 69 6e 20 66 72 61 67 6d 65 6e 74 tion in fragment
dc30: 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 36 20 69 ation */. u16 i
dc40: 4f 72 69 67 53 69 7a 65 20 3d 20 69 53 69 7a 65 OrigSize = iSize
dc50: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
dc60: 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 61 6c /* Original val
dc70: 75 65 20 6f 66 20 69 53 69 7a 65 20 2a 2f 0a 20 ue of iSize */.
dc80: 20 75 33 32 20 69 4c 61 73 74 20 3d 20 70 50 61 u32 iLast = pPa
dc90: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
dca0: 69 7a 65 2d 34 3b 20 2f 2a 20 4c 61 72 67 65 73 ize-4; /* Larges
dcb0: 74 20 70 6f 73 73 69 62 6c 65 20 66 72 65 65 62 t possible freeb
dcc0: 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 20 lock offset */.
dcd0: 20 75 33 32 20 69 45 6e 64 20 3d 20 69 53 74 61 u32 iEnd = iSta
dce0: 72 74 20 2b 20 69 53 69 7a 65 3b 20 20 20 20 20 rt + iSize;
dcf0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
dd00: 62 79 74 65 20 70 61 73 74 20 74 68 65 20 69 53 byte past the iS
dd10: 74 61 72 74 20 62 75 66 66 65 72 20 2a 2f 0a 20 tart buffer */.
dd20: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
dd30: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
dd40: 61 74 61 3b 20 20 20 2f 2a 20 50 61 67 65 20 63 ata; /* Page c
dd50: 6f 6e 74 65 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 ontent */.. ass
dd60: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 21 ert( pPage->pBt!
dd70: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
dd80: 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
dd90: 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
dda0: 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 DbPage) );. ass
ddb0: 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 42 20 ert( CORRUPT_DB
ddc0: 7c 7c 20 69 53 74 61 72 74 3e 3d 70 50 61 67 65 || iStart>=pPage
ddd0: 2d 3e 68 64 72 4f 66 66 73 65 74 2b 36 2b 70 50 ->hdrOffset+6+pP
dde0: 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
ddf0: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 43 e );. assert( C
de00: 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 69 45 6e ORRUPT_DB || iEn
de10: 64 20 3c 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d d <= pPage->pBt-
de20: 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 >usableSize );.
de30: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
de40: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
de50: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
de60: 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 69 7a ;. assert( iSiz
de70: 65 3e 3d 34 20 29 3b 20 20 20 2f 2a 20 4d 69 6e e>=4 ); /* Min
de80: 69 6d 75 6d 20 63 65 6c 6c 20 73 69 7a 65 20 69 imum cell size i
de90: 73 20 34 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 s 4 */. assert(
dea0: 20 69 53 74 61 72 74 3c 3d 69 4c 61 73 74 20 29 iStart<=iLast )
deb0: 3b 0a 0a 20 20 2f 2a 20 4f 76 65 72 77 72 69 74 ;.. /* Overwrit
dec0: 65 20 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 6d e deleted inform
ded0: 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 ation with zeros
dee0: 20 77 68 65 6e 20 74 68 65 20 73 65 63 75 72 65 when the secure
def0: 5f 64 65 6c 65 74 65 0a 20 20 2a 2a 20 6f 70 74 _delete. ** opt
df00: 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 20 2a ion is enabled *
df10: 2f 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 /. if( pPage->p
df20: 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
df30: 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 TS_SECURE_DELETE
df40: 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 ){. memset(&
df50: 64 61 74 61 5b 69 53 74 61 72 74 5d 2c 20 30 2c data[iStart], 0,
df60: 20 69 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 iSize);. }..
df70: 2f 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 66 /* The list of f
df80: 72 65 65 62 6c 6f 63 6b 73 20 6d 75 73 74 20 62 reeblocks must b
df90: 65 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f e in ascending o
dfa0: 72 64 65 72 2e 20 20 46 69 6e 64 20 74 68 65 20 rder. Find the
dfb0: 0a 20 20 2a 2a 20 73 70 6f 74 20 6f 6e 20 74 68 . ** spot on th
dfc0: 65 20 6c 69 73 74 20 77 68 65 72 65 20 69 53 74 e list where iSt
dfd0: 61 72 74 20 73 68 6f 75 6c 64 20 62 65 20 69 6e art should be in
dfe0: 73 65 72 74 65 64 2e 0a 20 20 2a 2f 0a 20 20 68 serted.. */. h
dff0: 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f dr = pPage->hdrO
e000: 66 66 73 65 74 3b 0a 20 20 69 50 74 72 20 3d 20 ffset;. iPtr =
e010: 68 64 72 20 2b 20 31 3b 0a 20 20 69 66 28 20 64 hdr + 1;. if( d
e020: 61 74 61 5b 69 50 74 72 2b 31 5d 3d 3d 30 20 26 ata[iPtr+1]==0 &
e030: 26 20 64 61 74 61 5b 69 50 74 72 5d 3d 3d 30 20 & data[iPtr]==0
e040: 29 7b 0a 20 20 20 20 69 46 72 65 65 42 6c 6b 20 ){. iFreeBlk
e050: 3d 20 30 3b 20 20 2f 2a 20 53 68 6f 72 74 63 75 = 0; /* Shortcu
e060: 74 20 66 6f 72 20 74 68 65 20 63 61 73 65 20 77 t for the case w
e070: 68 65 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 hen the freelist
e080: 20 69 73 20 65 6d 70 74 79 20 2a 2f 0a 20 20 7d is empty */. }
e090: 65 6c 73 65 7b 0a 20 20 20 20 77 68 69 6c 65 28 else{. while(
e0a0: 20 28 69 46 72 65 65 42 6c 6b 20 3d 20 67 65 74 (iFreeBlk = get
e0b0: 32 62 79 74 65 28 26 64 61 74 61 5b 69 50 74 72 2byte(&data[iPtr
e0c0: 5d 29 29 3c 69 53 74 61 72 74 20 29 7b 0a 20 20 ]))<iStart ){.
e0d0: 20 20 20 20 69 66 28 20 69 46 72 65 65 42 6c 6b if( iFreeBlk
e0e0: 3c 69 50 74 72 2b 34 20 29 7b 0a 20 20 20 20 20 <iPtr+4 ){.
e0f0: 20 20 20 69 66 28 20 69 46 72 65 65 42 6c 6b 3d if( iFreeBlk=
e100: 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 =0 ) break;.
e110: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
e120: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
e130: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 50 }. iP
e140: 74 72 20 3d 20 69 46 72 65 65 42 6c 6b 3b 0a 20 tr = iFreeBlk;.
e150: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 46 72 }. if( iFr
e160: 65 65 42 6c 6b 3e 69 4c 61 73 74 20 29 20 72 65 eeBlk>iLast ) re
e170: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
e180: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 61 73 UPT_BKPT;. as
e190: 73 65 72 74 28 20 69 46 72 65 65 42 6c 6b 3e 69 sert( iFreeBlk>i
e1a0: 50 74 72 20 7c 7c 20 69 46 72 65 65 42 6c 6b 3d Ptr || iFreeBlk=
e1b0: 3d 30 20 29 3b 0a 20 20 0a 20 20 20 20 2f 2a 20 =0 );. . /*
e1c0: 41 74 20 74 68 69 73 20 70 6f 69 6e 74 3a 0a 20 At this point:.
e1d0: 20 20 20 2a 2a 20 20 20 20 69 46 72 65 65 42 6c ** iFreeBl
e1e0: 6b 3a 20 20 20 46 69 72 73 74 20 66 72 65 65 62 k: First freeb
e1f0: 6c 6f 63 6b 20 61 66 74 65 72 20 69 53 74 61 72 lock after iStar
e200: 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 20 6e 6f t, or zero if no
e210: 6e 65 0a 20 20 20 20 2a 2a 20 20 20 20 69 50 74 ne. ** iPt
e220: 72 3a 20 20 20 20 20 20 20 54 68 65 20 61 64 64 r: The add
e230: 72 65 73 73 20 6f 66 20 61 20 70 6f 69 6e 74 65 ress of a pointe
e240: 72 20 74 6f 20 69 46 72 65 65 42 6c 6b 0a 20 20 r to iFreeBlk.
e250: 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 68 65 63 **. ** Chec
e260: 6b 20 74 6f 20 73 65 65 20 69 66 20 69 46 72 65 k to see if iFre
e270: 65 42 6c 6b 20 73 68 6f 75 6c 64 20 62 65 20 63 eBlk should be c
e280: 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 oalesced onto th
e290: 65 20 65 6e 64 20 6f 66 20 69 53 74 61 72 74 2e e end of iStart.
e2a0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
e2b0: 69 46 72 65 65 42 6c 6b 20 26 26 20 69 45 6e 64 iFreeBlk && iEnd
e2c0: 2b 33 3e 3d 69 46 72 65 65 42 6c 6b 20 29 7b 0a +3>=iFreeBlk ){.
e2d0: 20 20 20 20 20 20 6e 46 72 61 67 20 3d 20 69 46 nFrag = iF
e2e0: 72 65 65 42 6c 6b 20 2d 20 69 45 6e 64 3b 0a 20 reeBlk - iEnd;.
e2f0: 20 20 20 20 20 69 66 28 20 69 45 6e 64 3e 69 46 if( iEnd>iF
e300: 72 65 65 42 6c 6b 20 29 20 72 65 74 75 72 6e 20 reeBlk ) return
e310: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
e320: 4b 50 54 3b 0a 20 20 20 20 20 20 69 45 6e 64 20 KPT;. iEnd
e330: 3d 20 69 46 72 65 65 42 6c 6b 20 2b 20 67 65 74 = iFreeBlk + get
e340: 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 72 65 2byte(&data[iFre
e350: 65 42 6c 6b 2b 32 5d 29 3b 0a 20 20 20 20 20 20 eBlk+2]);.
e360: 69 66 28 20 69 45 6e 64 20 3e 20 70 50 61 67 65 if( iEnd > pPage
e370: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
e380: 65 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 e ) return SQLIT
e390: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
e3a0: 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 69 45 iSize = iE
e3b0: 6e 64 20 2d 20 69 53 74 61 72 74 3b 0a 20 20 20 nd - iStart;.
e3c0: 20 20 20 69 46 72 65 65 42 6c 6b 20 3d 20 67 65 iFreeBlk = ge
e3d0: 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 72 t2byte(&data[iFr
e3e0: 65 65 42 6c 6b 5d 29 3b 0a 20 20 20 20 7d 0a 20 eeBlk]);. }.
e3f0: 20 0a 20 20 20 20 2f 2a 20 49 66 20 69 50 74 72 . /* If iPtr
e400: 20 69 73 20 61 6e 6f 74 68 65 72 20 66 72 65 65 is another free
e410: 62 6c 6f 63 6b 20 28 74 68 61 74 20 69 73 2c 20 block (that is,
e420: 69 66 20 69 50 74 72 20 69 73 20 6e 6f 74 20 74 if iPtr is not t
e430: 68 65 20 66 72 65 65 6c 69 73 74 0a 20 20 20 20 he freelist.
e440: 2a 2a 20 70 6f 69 6e 74 65 72 20 69 6e 20 74 68 ** pointer in th
e450: 65 20 70 61 67 65 20 68 65 61 64 65 72 29 20 74 e page header) t
e460: 68 65 6e 20 63 68 65 63 6b 20 74 6f 20 73 65 65 hen check to see
e470: 20 69 66 20 69 53 74 61 72 74 20 73 68 6f 75 6c if iStart shoul
e480: 64 20 62 65 0a 20 20 20 20 2a 2a 20 63 6f 61 6c d be. ** coal
e490: 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 esced onto the e
e4a0: 6e 64 20 6f 66 20 69 50 74 72 2e 0a 20 20 20 20 nd of iPtr..
e4b0: 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 74 72 3e */. if( iPtr>
e4c0: 68 64 72 2b 31 20 29 7b 0a 20 20 20 20 20 20 69 hdr+1 ){. i
e4d0: 6e 74 20 69 50 74 72 45 6e 64 20 3d 20 69 50 74 nt iPtrEnd = iPt
e4e0: 72 20 2b 20 67 65 74 32 62 79 74 65 28 26 64 61 r + get2byte(&da
e4f0: 74 61 5b 69 50 74 72 2b 32 5d 29 3b 0a 20 20 20 ta[iPtr+2]);.
e500: 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 2b 33 if( iPtrEnd+3
e510: 3e 3d 69 53 74 61 72 74 20 29 7b 0a 20 20 20 20 >=iStart ){.
e520: 20 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 3e if( iPtrEnd>
e530: 69 53 74 61 72 74 20 29 20 72 65 74 75 72 6e 20 iStart ) return
e540: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
e550: 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 6e 46 72 KPT;. nFr
e560: 61 67 20 2b 3d 20 69 53 74 61 72 74 20 2d 20 69 ag += iStart - i
e570: 50 74 72 45 6e 64 3b 0a 20 20 20 20 20 20 20 20 PtrEnd;.
e580: 69 53 69 7a 65 20 3d 20 69 45 6e 64 20 2d 20 69 iSize = iEnd - i
e590: 50 74 72 3b 0a 20 20 20 20 20 20 20 20 69 53 74 Ptr;. iSt
e5a0: 61 72 74 20 3d 20 69 50 74 72 3b 0a 20 20 20 20 art = iPtr;.
e5b0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
e5c0: 28 20 6e 46 72 61 67 3e 64 61 74 61 5b 68 64 72 ( nFrag>data[hdr
e5d0: 2b 37 5d 20 29 20 72 65 74 75 72 6e 20 53 51 4c +7] ) return SQL
e5e0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
e5f0: 3b 0a 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 ;. data[hdr+7
e600: 5d 20 2d 3d 20 6e 46 72 61 67 3b 0a 20 20 7d 0a ] -= nFrag;. }.
e610: 20 20 69 66 28 20 69 53 74 61 72 74 3d 3d 67 65 if( iStart==ge
e620: 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 t2byte(&data[hdr
e630: 2b 35 5d 29 20 29 7b 0a 20 20 20 20 2f 2a 20 54 +5]) ){. /* T
e640: 68 65 20 6e 65 77 20 66 72 65 65 62 6c 6f 63 6b he new freeblock
e650: 20 69 73 20 61 74 20 74 68 65 20 62 65 67 69 6e is at the begin
e660: 6e 69 6e 67 20 6f 66 20 74 68 65 20 63 65 6c 6c ning of the cell
e670: 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 2c 0a 20 content area,.
e680: 20 20 20 2a 2a 20 73 6f 20 6a 75 73 74 20 65 78 ** so just ex
e690: 74 65 6e 64 20 74 68 65 20 63 65 6c 6c 20 63 6f tend the cell co
e6a0: 6e 74 65 6e 74 20 61 72 65 61 20 72 61 74 68 65 ntent area rathe
e6b0: 72 20 74 68 61 6e 20 63 72 65 61 74 65 20 61 6e r than create an
e6c0: 6f 74 68 65 72 0a 20 20 20 20 2a 2a 20 66 72 65 other. ** fre
e6d0: 65 6c 69 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20 elist entry */.
e6e0: 20 20 20 69 66 28 20 69 50 74 72 21 3d 68 64 72 if( iPtr!=hdr
e6f0: 2b 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 +1 ) return SQLI
e700: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
e710: 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 64 . put2byte(&d
e720: 61 74 61 5b 68 64 72 2b 31 5d 2c 20 69 46 72 65 ata[hdr+1], iFre
e730: 65 42 6c 6b 29 3b 0a 20 20 20 20 70 75 74 32 62 eBlk);. put2b
e740: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
e750: 2c 20 69 45 6e 64 29 3b 0a 20 20 7d 65 6c 73 65 , iEnd);. }else
e760: 7b 0a 20 20 20 20 2f 2a 20 49 6e 73 65 72 74 20 {. /* Insert
e770: 74 68 65 20 6e 65 77 20 66 72 65 65 62 6c 6f 63 the new freebloc
e780: 6b 20 69 6e 74 6f 20 74 68 65 20 66 72 65 65 6c k into the freel
e790: 69 73 74 20 2a 2f 0a 20 20 20 20 70 75 74 32 62 ist */. put2b
e7a0: 79 74 65 28 26 64 61 74 61 5b 69 50 74 72 5d 2c yte(&data[iPtr],
e7b0: 20 69 53 74 61 72 74 29 3b 0a 20 20 20 20 70 75 iStart);. pu
e7c0: 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 53 74 t2byte(&data[iSt
e7d0: 61 72 74 5d 2c 20 69 46 72 65 65 42 6c 6b 29 3b art], iFreeBlk);
e7e0: 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 64 . put2byte(&d
e7f0: 61 74 61 5b 69 53 74 61 72 74 2b 32 5d 2c 20 69 ata[iStart+2], i
e800: 53 69 7a 65 29 3b 0a 20 20 7d 0a 20 20 70 50 61 Size);. }. pPa
e810: 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 69 4f 72 ge->nFree += iOr
e820: 69 67 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e igSize;. return
e830: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
e840: 2a 0a 2a 2a 20 44 65 63 6f 64 65 20 74 68 65 20 *.** Decode the
e850: 66 6c 61 67 73 20 62 79 74 65 20 28 74 68 65 20 flags byte (the
e860: 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 first byte of th
e870: 65 20 68 65 61 64 65 72 29 20 66 6f 72 20 61 20 e header) for a
e880: 70 61 67 65 0a 2a 2a 20 61 6e 64 20 69 6e 69 74 page.** and init
e890: 69 61 6c 69 7a 65 20 66 69 65 6c 64 73 20 6f 66 ialize fields of
e8a0: 20 74 68 65 20 4d 65 6d 50 61 67 65 20 73 74 72 the MemPage str
e8b0: 75 63 74 75 72 65 20 61 63 63 6f 72 64 69 6e 67 ucture according
e8c0: 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 74 ly..**.** Only t
e8d0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d he following com
e8e0: 62 69 6e 61 74 69 6f 6e 73 20 61 72 65 20 73 75 binations are su
e8f0: 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 74 68 69 pported. Anythi
e900: 6e 67 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20 ng different.**
e910: 69 6e 64 69 63 61 74 65 73 20 61 20 63 6f 72 72 indicates a corr
e920: 75 70 74 20 64 61 74 61 62 61 73 65 20 66 69 6c upt database fil
e930: 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 es:.**.**
e940: 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 41 0a 2a PTF_ZERODATA.*
e950: 2a 20 20 20 20 20 20 20 20 20 50 54 46 5f 5a 45 * PTF_ZE
e960: 52 4f 44 41 54 41 20 7c 20 50 54 46 5f 4c 45 41 RODATA | PTF_LEA
e970: 46 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 F.** PTF
e980: 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 54 46 5f _LEAFDATA | PTF_
e990: 49 4e 54 4b 45 59 0a 2a 2a 20 20 20 20 20 20 20 INTKEY.**
e9a0: 20 20 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c PTF_LEAFDATA |
e9b0: 20 50 54 46 5f 49 4e 54 4b 45 59 20 7c 20 50 54 PTF_INTKEY | PT
e9c0: 46 5f 4c 45 41 46 0a 2a 2f 0a 73 74 61 74 69 63 F_LEAF.*/.static
e9d0: 20 69 6e 74 20 64 65 63 6f 64 65 46 6c 61 67 73 int decodeFlags
e9e0: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
e9f0: 20 69 6e 74 20 66 6c 61 67 42 79 74 65 29 7b 0a int flagByte){.
ea00: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b BtShared *pBt;
ea10: 20 20 20 20 20 2f 2a 20 41 20 63 6f 70 79 20 6f /* A copy o
ea20: 66 20 70 50 61 67 65 2d 3e 70 42 74 20 2a 2f 0a f pPage->pBt */.
ea30: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
ea40: 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d 28 70 50 ->hdrOffset==(pP
ea50: 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 3f 20 31 age->pgno==1 ? 1
ea60: 30 30 20 3a 20 30 29 20 29 3b 0a 20 20 61 73 73 00 : 0) );. ass
ea70: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
ea80: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
ea90: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
eaa0: 70 50 61 67 65 2d 3e 6c 65 61 66 20 3d 20 28 75 pPage->leaf = (u
eab0: 38 29 28 66 6c 61 67 42 79 74 65 3e 3e 33 29 3b 8)(flagByte>>3);
eac0: 20 20 61 73 73 65 72 74 28 20 50 54 46 5f 4c 45 assert( PTF_LE
ead0: 41 46 20 3d 3d 20 31 3c 3c 33 20 29 3b 0a 20 20 AF == 1<<3 );.
eae0: 66 6c 61 67 42 79 74 65 20 26 3d 20 7e 50 54 46 flagByte &= ~PTF
eaf0: 5f 4c 45 41 46 3b 0a 20 20 70 50 61 67 65 2d 3e _LEAF;. pPage->
eb00: 63 68 69 6c 64 50 74 72 53 69 7a 65 20 3d 20 34 childPtrSize = 4
eb10: 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 66 3b 0a -4*pPage->leaf;.
eb20: 20 20 70 50 61 67 65 2d 3e 78 43 65 6c 6c 53 69 pPage->xCellSi
eb30: 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 72 ze = cellSizePtr
eb40: 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d ;. pBt = pPage-
eb50: 3e 70 42 74 3b 0a 20 20 69 66 28 20 66 6c 61 67 >pBt;. if( flag
eb60: 42 79 74 65 3d 3d 28 50 54 46 5f 4c 45 41 46 44 Byte==(PTF_LEAFD
eb70: 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 ATA | PTF_INTKEY
eb80: 29 20 29 7b 0a 20 20 20 20 2f 2a 20 45 56 49 44 ) ){. /* EVID
eb90: 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 37 32 39 31 ENCE-OF: R-07291
eba0: 2d 33 35 33 32 38 20 41 20 76 61 6c 75 65 20 6f -35328 A value o
ebb0: 66 20 35 20 28 30 78 30 35 29 20 6d 65 61 6e 73 f 5 (0x05) means
ebc0: 20 74 68 65 20 70 61 67 65 20 69 73 20 61 6e 0a the page is an.
ebd0: 20 20 20 20 2a 2a 20 69 6e 74 65 72 69 6f 72 20 ** interior
ebe0: 74 61 62 6c 65 20 62 2d 74 72 65 65 20 70 61 67 table b-tree pag
ebf0: 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 e. */. assert
ec00: 28 20 28 50 54 46 5f 4c 45 41 46 44 41 54 41 7c ( (PTF_LEAFDATA|
ec10: 50 54 46 5f 49 4e 54 4b 45 59 29 3d 3d 35 20 29 PTF_INTKEY)==5 )
ec20: 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 ;. /* EVIDENC
ec30: 45 2d 4f 46 3a 20 52 2d 32 36 39 30 30 2d 30 39 E-OF: R-26900-09
ec40: 31 37 36 20 41 20 76 61 6c 75 65 20 6f 66 20 31 176 A value of 1
ec50: 33 20 28 30 78 30 64 29 20 6d 65 61 6e 73 20 74 3 (0x0d) means t
ec60: 68 65 20 70 61 67 65 20 69 73 20 61 0a 20 20 20 he page is a.
ec70: 20 2a 2a 20 6c 65 61 66 20 74 61 62 6c 65 20 62 ** leaf table b
ec80: 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a 20 -tree page. */.
ec90: 20 20 20 61 73 73 65 72 74 28 20 28 50 54 46 5f assert( (PTF_
eca0: 4c 45 41 46 44 41 54 41 7c 50 54 46 5f 49 4e 54 LEAFDATA|PTF_INT
ecb0: 4b 45 59 7c 50 54 46 5f 4c 45 41 46 29 3d 3d 31 KEY|PTF_LEAF)==1
ecc0: 33 20 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 3 );. pPage->
ecd0: 69 6e 74 4b 65 79 20 3d 20 31 3b 0a 20 20 20 20 intKey = 1;.
ece0: 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 if( pPage->leaf
ecf0: 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e ){. pPage->
ed00: 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 31 3b 0a intKeyLeaf = 1;.
ed10: 20 20 20 20 20 20 70 50 61 67 65 2d 3e 78 50 61 pPage->xPa
ed20: 72 73 65 43 65 6c 6c 20 3d 20 62 74 72 65 65 50 rseCell = btreeP
ed30: 61 72 73 65 43 65 6c 6c 50 74 72 3b 0a 20 20 20 arseCellPtr;.
ed40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 50 }else{. pP
ed50: 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 age->intKeyLeaf
ed60: 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 65 = 0;. pPage
ed70: 2d 3e 78 43 65 6c 6c 53 69 7a 65 20 3d 20 63 65 ->xCellSize = ce
ed80: 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 61 79 6c 6f llSizePtrNoPaylo
ed90: 61 64 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d ad;. pPage-
eda0: 3e 78 50 61 72 73 65 43 65 6c 6c 20 3d 20 62 74 >xParseCell = bt
edb0: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 4e reeParseCellPtrN
edc0: 6f 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 7d 0a oPayload;. }.
edd0: 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f pPage->maxLo
ede0: 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 78 4c 65 cal = pBt->maxLe
edf0: 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d af;. pPage->m
ee00: 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d inLocal = pBt->m
ee10: 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c 73 65 20 inLeaf;. }else
ee20: 69 66 28 20 66 6c 61 67 42 79 74 65 3d 3d 50 54 if( flagByte==PT
ee30: 46 5f 5a 45 52 4f 44 41 54 41 20 29 7b 0a 20 20 F_ZERODATA ){.
ee40: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
ee50: 3a 20 52 2d 34 33 33 31 36 2d 33 37 33 30 38 20 : R-43316-37308
ee60: 41 20 76 61 6c 75 65 20 6f 66 20 32 20 28 30 78 A value of 2 (0x
ee70: 30 32 29 20 6d 65 61 6e 73 20 74 68 65 20 70 61 02) means the pa
ee80: 67 65 20 69 73 20 61 6e 0a 20 20 20 20 2a 2a 20 ge is an. **
ee90: 69 6e 74 65 72 69 6f 72 20 69 6e 64 65 78 20 62 interior index b
eea0: 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a 20 -tree page. */.
eeb0: 20 20 20 61 73 73 65 72 74 28 20 28 50 54 46 5f assert( (PTF_
eec0: 5a 45 52 4f 44 41 54 41 29 3d 3d 32 20 29 3b 0a ZERODATA)==2 );.
eed0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
eee0: 4f 46 3a 20 52 2d 35 39 36 31 35 2d 34 32 38 32 OF: R-59615-4282
eef0: 38 20 41 20 76 61 6c 75 65 20 6f 66 20 31 30 20 8 A value of 10
ef00: 28 30 78 30 61 29 20 6d 65 61 6e 73 20 74 68 65 (0x0a) means the
ef10: 20 70 61 67 65 20 69 73 20 61 0a 20 20 20 20 2a page is a. *
ef20: 2a 20 6c 65 61 66 20 69 6e 64 65 78 20 62 2d 74 * leaf index b-t
ef30: 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 ree page. */.
ef40: 20 61 73 73 65 72 74 28 20 28 50 54 46 5f 5a 45 assert( (PTF_ZE
ef50: 52 4f 44 41 54 41 7c 50 54 46 5f 4c 45 41 46 29 RODATA|PTF_LEAF)
ef60: 3d 3d 31 30 20 29 3b 0a 20 20 20 20 70 50 61 67 ==10 );. pPag
ef70: 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 30 3b 0a 20 e->intKey = 0;.
ef80: 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 pPage->intKey
ef90: 4c 65 61 66 20 3d 20 30 3b 0a 20 20 20 20 70 50 Leaf = 0;. pP
efa0: 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 20 age->xParseCell
efb0: 3d 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c = btreeParseCell
efc0: 50 74 72 49 6e 64 65 78 3b 0a 20 20 20 20 70 50 PtrIndex;. pP
efd0: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d 20 age->maxLocal =
efe0: 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 pBt->maxLocal;.
eff0: 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 pPage->minLoc
f000: 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c 6f 63 al = pBt->minLoc
f010: 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 al;. }else{.
f020: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
f030: 20 52 2d 34 37 36 30 38 2d 35 36 34 36 39 20 41 R-47608-56469 A
f040: 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 65 20 66 ny other value f
f050: 6f 72 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 or the b-tree pa
f060: 67 65 20 74 79 70 65 20 69 73 0a 20 20 20 20 2a ge type is. *
f070: 2a 20 61 6e 20 65 72 72 6f 72 2e 20 2a 2f 0a 20 * an error. */.
f080: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
f090: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
f0a0: 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6d 61 78 31 }. pPage->max1
f0b0: 62 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 70 42 bytePayload = pB
f0c0: 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f t->max1bytePaylo
f0d0: 61 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ad;. return SQL
f0e0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
f0f0: 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 Initialize the
f100: 61 75 78 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d auxiliary inform
f110: 61 74 69 6f 6e 20 66 6f 72 20 61 20 64 69 73 6b ation for a disk
f120: 20 62 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 52 65 block..**.** Re
f130: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f turn SQLITE_OK o
f140: 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 77 n success. If w
f150: 65 20 73 65 65 20 74 68 61 74 20 74 68 65 20 70 e see that the p
f160: 61 67 65 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 age does.** not
f170: 63 6f 6e 74 61 69 6e 20 61 20 77 65 6c 6c 2d 66 contain a well-f
f180: 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 ormed database p
f190: 61 67 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e age, then return
f1a0: 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 .** SQLITE_CORR
f1b0: 55 50 54 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 UPT. Note that
f1c0: 61 20 72 65 74 75 72 6e 20 6f 66 20 53 51 4c 49 a return of SQLI
f1d0: 54 45 5f 4f 4b 20 64 6f 65 73 20 6e 6f 74 0a 2a TE_OK does not.*
f1e0: 2a 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 * guarantee that
f1f0: 20 74 68 65 20 70 61 67 65 20 69 73 20 77 65 6c the page is wel
f200: 6c 2d 66 6f 72 6d 65 64 2e 20 20 49 74 20 6f 6e l-formed. It on
f210: 6c 79 20 73 68 6f 77 73 20 74 68 61 74 0a 2a 2a ly shows that.**
f220: 20 77 65 20 66 61 69 6c 65 64 20 74 6f 20 64 65 we failed to de
f230: 74 65 63 74 20 61 6e 79 20 63 6f 72 72 75 70 74 tect any corrupt
f240: 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ion..*/.static i
f250: 6e 74 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 nt btreeInitPage
f260: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
f270: 7b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 {.. assert( pPa
f280: 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 20 ge->pBt!=0 );.
f290: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 assert( pPage->p
f2a0: 42 74 2d 3e 64 62 21 3d 30 20 29 3b 0a 20 20 61 Bt->db!=0 );. a
f2b0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
f2c0: 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
f2d0: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
f2e0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
f2f0: 3e 70 67 6e 6f 3d 3d 73 71 6c 69 74 65 33 50 61 >pgno==sqlite3Pa
f300: 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 50 gerPagenumber(pP
f310: 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
f320: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
f330: 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 == sqlite3Pager
f340: 47 65 74 45 78 74 72 61 28 70 50 61 67 65 2d 3e GetExtra(pPage->
f350: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
f360: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 61 sert( pPage->aDa
f370: 74 61 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 67 ta == sqlite3Pag
f380: 65 72 47 65 74 44 61 74 61 28 70 50 61 67 65 2d erGetData(pPage-
f390: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 >pDbPage) );..
f3a0: 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73 49 6e if( !pPage->isIn
f3b0: 69 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 70 63 it ){. int pc
f3c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
f3d0: 41 64 64 72 65 73 73 20 6f 66 20 61 20 66 72 65 Address of a fre
f3e0: 65 62 6c 6f 63 6b 20 77 69 74 68 69 6e 20 70 50 eblock within pP
f3f0: 61 67 65 2d 3e 61 44 61 74 61 5b 5d 20 2a 2f 0a age->aData[] */.
f400: 20 20 20 20 75 38 20 68 64 72 3b 20 20 20 20 20 u8 hdr;
f410: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 /* Offset
f420: 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 to beginning of
f430: 20 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f 0a page header */.
f440: 20 20 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 u8 *data;
f450: 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c 20 /* Equal
f460: 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 to pPage->aData
f470: 2a 2f 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 */. BtShared
f480: 2a 70 42 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 *pBt; /*
f490: 54 68 65 20 6d 61 69 6e 20 62 74 72 65 65 20 73 The main btree s
f4a0: 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 20 tructure */.
f4b0: 69 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b 20 int usableSize;
f4c0: 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 /* Amount of
f4d0: 75 73 61 62 6c 65 20 73 70 61 63 65 20 6f 6e 20 usable space on
f4e0: 65 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 20 each page */.
f4f0: 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 65 74 3b u16 cellOffset;
f500: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 66 72 /* Offset fr
f510: 6f 6d 20 73 74 61 72 74 20 6f 66 20 70 61 67 65 om start of page
f520: 20 74 6f 20 66 69 72 73 74 20 63 65 6c 6c 20 70 to first cell p
f530: 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 6e ointer */. in
f540: 74 20 6e 46 72 65 65 3b 20 20 20 20 20 20 20 20 t nFree;
f550: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e /* Number of un
f560: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 74 68 used bytes on th
f570: 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 69 6e e page */. in
f580: 74 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 t top;
f590: 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f /* First byte o
f5a0: 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 f the cell conte
f5b0: 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 20 20 69 nt area */. i
f5c0: 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 20 nt iCellFirst;
f5d0: 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f 77 /* First allow
f5e0: 61 62 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 65 able cell or fre
f5f0: 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f eblock offset */
f600: 0a 20 20 20 20 69 6e 74 20 69 43 65 6c 6c 4c 61 . int iCellLa
f610: 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 st; /* Last
f620: 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 6f 72 possible cell or
f630: 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 freeblock offse
f640: 74 20 2a 2f 0a 0a 20 20 20 20 70 42 74 20 3d 20 t */.. pBt =
f650: 70 50 61 67 65 2d 3e 70 42 74 3b 0a 0a 20 20 20 pPage->pBt;..
f660: 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 hdr = pPage->hd
f670: 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 64 61 74 rOffset;. dat
f680: 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 a = pPage->aData
f690: 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 ;. /* EVIDENC
f6a0: 45 2d 4f 46 3a 20 52 2d 32 38 35 39 34 2d 30 32 E-OF: R-28594-02
f6b0: 38 39 30 20 54 68 65 20 6f 6e 65 2d 62 79 74 65 890 The one-byte
f6c0: 20 66 6c 61 67 20 61 74 20 6f 66 66 73 65 74 20 flag at offset
f6d0: 30 20 69 6e 64 69 63 61 74 69 6e 67 0a 20 20 20 0 indicating.
f6e0: 20 2a 2a 20 74 68 65 20 62 2d 74 72 65 65 20 70 ** the b-tree p
f6f0: 61 67 65 20 74 79 70 65 2e 20 2a 2f 0a 20 20 20 age type. */.
f700: 20 69 66 28 20 64 65 63 6f 64 65 46 6c 61 67 73 if( decodeFlags
f710: 28 70 50 61 67 65 2c 20 64 61 74 61 5b 68 64 72 (pPage, data[hdr
f720: 5d 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 ]) ) return SQLI
f730: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
f740: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 . assert( pBt
f750: 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 ->pageSize>=512
f760: 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 && pBt->pageSize
f770: 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 20 20 70 <=65536 );. p
f780: 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d Page->maskPage =
f790: 20 28 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 (u16)(pBt->page
f7a0: 53 69 7a 65 20 2d 20 31 29 3b 0a 20 20 20 20 70 Size - 1);. p
f7b0: 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 Page->nOverflow
f7c0: 3d 20 30 3b 0a 20 20 20 20 75 73 61 62 6c 65 53 = 0;. usableS
f7d0: 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c ize = pBt->usabl
f7e0: 65 53 69 7a 65 3b 0a 20 20 20 20 70 50 61 67 65 eSize;. pPage
f7f0: 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 63 ->cellOffset = c
f800: 65 6c 6c 4f 66 66 73 65 74 20 3d 20 68 64 72 20 ellOffset = hdr
f810: 2b 20 38 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 + 8 + pPage->chi
f820: 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 20 20 70 ldPtrSize;. p
f830: 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d Page->aDataEnd =
f840: 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 69 7a &data[usableSiz
f850: 65 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 e];. pPage->a
f860: 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b CellIdx = &data[
f870: 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 20 cellOffset];.
f880: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 4f 66 73 pPage->aDataOfs
f890: 74 20 3d 20 26 64 61 74 61 5b 70 50 61 67 65 2d t = &data[pPage-
f8a0: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 5d 3b 0a >childPtrSize];.
f8b0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
f8c0: 4f 46 3a 20 52 2d 35 38 30 31 35 2d 34 38 31 37 OF: R-58015-4817
f8d0: 35 20 54 68 65 20 74 77 6f 2d 62 79 74 65 20 69 5 The two-byte i
f8e0: 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 nteger at offset
f8f0: 20 35 20 64 65 73 69 67 6e 61 74 65 73 0a 20 20 5 designates.
f900: 20 20 2a 2a 20 74 68 65 20 73 74 61 72 74 20 6f ** the start o
f910: 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 f the cell conte
f920: 6e 74 20 61 72 65 61 2e 20 41 20 7a 65 72 6f 20 nt area. A zero
f930: 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73 20 69 value for this i
f940: 6e 74 65 67 65 72 20 69 73 0a 20 20 20 20 2a 2a nteger is. **
f950: 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 20 interpreted as
f960: 36 35 35 33 36 2e 20 2a 2f 0a 20 20 20 20 74 6f 65536. */. to
f970: 70 20 3d 20 67 65 74 32 62 79 74 65 4e 6f 74 5a p = get2byteNotZ
f980: 65 72 6f 28 26 64 61 74 61 5b 68 64 72 2b 35 5d ero(&data[hdr+5]
f990: 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e );. /* EVIDEN
f9a0: 43 45 2d 4f 46 3a 20 52 2d 33 37 30 30 32 2d 33 CE-OF: R-37002-3
f9b0: 32 37 37 34 20 54 68 65 20 74 77 6f 2d 62 79 74 2774 The two-byt
f9c0: 65 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 e integer at off
f9d0: 73 65 74 20 33 20 67 69 76 65 73 20 74 68 65 0a set 3 gives the.
f9e0: 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 ** number of
f9f0: 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 61 cells on the pa
fa00: 67 65 2e 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 ge. */. pPage
fa10: 2d 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 ->nCell = get2by
fa20: 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 te(&data[hdr+3])
fa30: 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d ;. if( pPage-
fa40: 3e 6e 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 >nCell>MX_CELL(p
fa50: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 Bt) ){. /*
fa60: 54 6f 20 6d 61 6e 79 20 63 65 6c 6c 73 20 66 6f To many cells fo
fa70: 72 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 2e r a single page.
fa80: 20 20 54 68 65 20 70 61 67 65 20 6d 75 73 74 20 The page must
fa90: 62 65 20 63 6f 72 72 75 70 74 20 2a 2f 0a 20 20 be corrupt */.
faa0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
fab0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
fac0: 20 20 20 20 7d 0a 20 20 20 20 74 65 73 74 63 61 }. testca
fad0: 73 65 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c se( pPage->nCell
fae0: 3d 3d 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 ==MX_CELL(pBt) )
faf0: 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 ;. /* EVIDENC
fb00: 45 2d 4f 46 3a 20 52 2d 32 34 30 38 39 2d 35 37 E-OF: R-24089-57
fb10: 39 37 39 20 49 66 20 61 20 70 61 67 65 20 63 6f 979 If a page co
fb20: 6e 74 61 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 ntains no cells
fb30: 28 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 0a 20 (which is only.
fb40: 20 20 20 2a 2a 20 70 6f 73 73 69 62 6c 65 20 66 ** possible f
fb50: 6f 72 20 61 20 72 6f 6f 74 20 70 61 67 65 20 6f or a root page o
fb60: 66 20 61 20 74 61 62 6c 65 20 74 68 61 74 20 63 f a table that c
fb70: 6f 6e 74 61 69 6e 73 20 6e 6f 20 72 6f 77 73 29 ontains no rows)
fb80: 20 74 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a then the. **
fb90: 20 6f 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 offset to the c
fba0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
fbb0: 20 77 69 6c 6c 20 65 71 75 61 6c 20 74 68 65 20 will equal the
fbc0: 70 61 67 65 20 73 69 7a 65 20 6d 69 6e 75 73 20 page size minus
fbd0: 74 68 65 0a 20 20 20 20 2a 2a 20 62 79 74 65 73 the. ** bytes
fbe0: 20 6f 66 20 72 65 73 65 72 76 65 64 20 73 70 61 of reserved spa
fbf0: 63 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 ce. */. asser
fc00: 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e t( pPage->nCell>
fc10: 30 20 7c 7c 20 74 6f 70 3d 3d 75 73 61 62 6c 65 0 || top==usable
fc20: 53 69 7a 65 20 7c 7c 20 43 4f 52 52 55 50 54 5f Size || CORRUPT_
fc30: 44 42 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 41 20 DB );.. /* A
fc40: 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 61 62 61 malformed databa
fc50: 73 65 20 70 61 67 65 20 6d 69 67 68 74 20 63 61 se page might ca
fc60: 75 73 65 20 75 73 20 74 6f 20 72 65 61 64 20 70 use us to read p
fc70: 61 73 74 20 74 68 65 20 65 6e 64 0a 20 20 20 20 ast the end.
fc80: 2a 2a 20 6f 66 20 70 61 67 65 20 77 68 65 6e 20 ** of page when
fc90: 70 61 72 73 69 6e 67 20 61 20 63 65 6c 6c 2e 20 parsing a cell.
fca0: 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 . **. **
fcb0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c The following bl
fcc0: 6f 63 6b 20 6f 66 20 63 6f 64 65 20 63 68 65 63 ock of code chec
fcd0: 6b 73 20 65 61 72 6c 79 20 74 6f 20 73 65 65 20 ks early to see
fce0: 69 66 20 61 20 63 65 6c 6c 20 65 78 74 65 6e 64 if a cell extend
fcf0: 73 0a 20 20 20 20 2a 2a 20 70 61 73 74 20 74 68 s. ** past th
fd00: 65 20 65 6e 64 20 6f 66 20 61 20 70 61 67 65 20 e end of a page
fd10: 62 6f 75 6e 64 61 72 79 20 61 6e 64 20 63 61 75 boundary and cau
fd20: 73 65 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 ses SQLITE_CORRU
fd30: 50 54 20 74 6f 20 62 65 20 0a 20 20 20 20 2a 2a PT to be . **
fd40: 20 72 65 74 75 72 6e 65 64 20 69 66 20 69 74 20 returned if it
fd50: 64 6f 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 does.. */.
fd60: 20 69 43 65 6c 6c 46 69 72 73 74 20 3d 20 63 65 iCellFirst = ce
fd70: 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 61 llOffset + 2*pPa
fd80: 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 ge->nCell;. i
fd90: 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c CellLast = usabl
fda0: 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 20 20 69 eSize - 4;. i
fdb0: 66 28 20 70 42 74 2d 3e 64 62 2d 3e 66 6c 61 67 f( pBt->db->flag
fdc0: 73 20 26 20 53 51 4c 49 54 45 5f 43 65 6c 6c 53 s & SQLITE_CellS
fdd0: 69 7a 65 43 6b 20 29 7b 0a 20 20 20 20 20 20 69 izeCk ){. i
fde0: 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 nt i;
fdf0: 20 2f 2a 20 49 6e 64 65 78 20 69 6e 74 6f 20 74 /* Index into t
fe00: 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 he cell pointer
fe10: 61 72 72 61 79 20 2a 2f 0a 20 20 20 20 20 20 69 array */. i
fe20: 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 nt sz;
fe30: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 63 65 /* Size of a ce
fe40: 6c 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 69 66 28 ll */.. if(
fe50: 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 20 !pPage->leaf )
fe60: 69 43 65 6c 6c 4c 61 73 74 2d 2d 3b 0a 20 20 20 iCellLast--;.
fe70: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 50 for(i=0; i<pP
fe80: 61 67 65 2d 3e 6e 43 65 6c 6c 3b 20 69 2b 2b 29 age->nCell; i++)
fe90: 7b 0a 20 20 20 20 20 20 20 20 70 63 20 3d 20 67 {. pc = g
fea0: 65 74 32 62 79 74 65 41 6c 69 67 6e 65 64 28 26 et2byteAligned(&
feb0: 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 2b data[cellOffset+
fec0: 69 2a 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 i*2]);. t
fed0: 65 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 estcase( pc==iCe
fee0: 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 20 20 20 llFirst );.
fef0: 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d testcase( pc=
ff00: 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 =iCellLast );.
ff10: 20 20 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 if( pc<iCe
ff20: 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 llFirst || pc>iC
ff30: 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 ellLast ){.
ff40: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
ff50: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
ff60: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
ff70: 20 20 20 73 7a 20 3d 20 70 50 61 67 65 2d 3e 78 sz = pPage->x
ff80: 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 CellSize(pPage,
ff90: 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 &data[pc]);.
ffa0: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
ffb0: 2b 73 7a 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 +sz==usableSize
ffc0: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
ffd0: 63 2b 73 7a 3e 75 73 61 62 6c 65 53 69 7a 65 20 c+sz>usableSize
ffe0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 ){. ret
fff0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
10000 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 PT_BKPT;.
10010 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
10020 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
10030 66 20 29 20 69 43 65 6c 6c 4c 61 73 74 2b 2b 3b f ) iCellLast++;
10040 0a 20 20 20 20 7d 20 20 0a 0a 20 20 20 20 2f 2a . } .. /*
10050 20 43 6f 6d 70 75 74 65 20 74 68 65 20 74 6f 74 Compute the tot
10060 61 6c 20 66 72 65 65 20 73 70 61 63 65 20 6f 6e al free space on
10070 20 74 68 65 20 70 61 67 65 0a 20 20 20 20 2a 2a the page. **
10080 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
10090 32 33 35 38 38 2d 33 34 34 35 30 20 54 68 65 20 23588-34450 The
100a0 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 67 65 72 two-byte integer
100b0 20 61 74 20 6f 66 66 73 65 74 20 31 20 67 69 76 at offset 1 giv
100c0 65 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 73 74 es the. ** st
100d0 61 72 74 20 6f 66 20 74 68 65 20 66 69 72 73 74 art of the first
100e0 20 66 72 65 65 62 6c 6f 63 6b 20 6f 6e 20 74 68 freeblock on th
100f0 65 20 70 61 67 65 2c 20 6f 72 20 69 73 20 7a 65 e page, or is ze
10100 72 6f 20 69 66 20 74 68 65 72 65 20 61 72 65 20 ro if there are
10110 6e 6f 0a 20 20 20 20 2a 2a 20 66 72 65 65 62 6c no. ** freebl
10120 6f 63 6b 73 2e 20 2a 2f 0a 20 20 20 20 70 63 20 ocks. */. pc
10130 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
10140 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 20 6e 46 [hdr+1]);. nF
10150 72 65 65 20 3d 20 64 61 74 61 5b 68 64 72 2b 37 ree = data[hdr+7
10160 5d 20 2b 20 74 6f 70 3b 20 20 2f 2a 20 49 6e 69 ] + top; /* Ini
10170 74 20 6e 46 72 65 65 20 74 6f 20 6e 6f 6e 2d 66 t nFree to non-f
10180 72 65 65 62 6c 6f 63 6b 20 66 72 65 65 20 73 70 reeblock free sp
10190 61 63 65 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 ace */. if( p
101a0 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 75 33 32 c>0 ){. u32
101b0 20 6e 65 78 74 2c 20 73 69 7a 65 3b 0a 20 20 20 next, size;.
101c0 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 if( pc<iCellF
101d0 69 72 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 irst ){.
101e0 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
101f0 52 2d 35 35 35 33 30 2d 35 32 39 33 30 20 49 6e R-55530-52930 In
10200 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 62 a well-formed b
10210 2d 74 72 65 65 20 70 61 67 65 2c 20 74 68 65 72 -tree page, ther
10220 65 20 77 69 6c 6c 0a 20 20 20 20 20 20 20 20 2a e will. *
10230 2a 20 61 6c 77 61 79 73 20 62 65 20 61 74 20 6c * always be at l
10240 65 61 73 74 20 6f 6e 65 20 63 65 6c 6c 20 62 65 east one cell be
10250 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 66 fore the first f
10260 72 65 65 62 6c 6f 63 6b 2e 0a 20 20 20 20 20 20 reeblock..
10270 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 65 74 */. ret
10280 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
10290 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 20 20 20 PT_BKPT; .
102a0 7d 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 31 }. while( 1
102b0 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 ){. if(
102c0 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
102d0 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
102e0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
102f0 42 4b 50 54 3b 20 2f 2a 20 46 72 65 65 62 6c 6f BKPT; /* Freeblo
10300 63 6b 20 6f 66 66 20 74 68 65 20 65 6e 64 20 6f ck off the end o
10310 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 f the page */.
10320 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
10330 6e 65 78 74 20 3d 20 67 65 74 32 62 79 74 65 28 next = get2byte(
10340 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 &data[pc]);.
10350 20 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 size = get2b
10360 79 74 65 28 26 64 61 74 61 5b 70 63 2b 32 5d 29 yte(&data[pc+2])
10370 3b 0a 20 20 20 20 20 20 20 20 6e 46 72 65 65 20 ;. nFree
10380 3d 20 6e 46 72 65 65 20 2b 20 73 69 7a 65 3b 0a = nFree + size;.
10390 20 20 20 20 20 20 20 20 69 66 28 20 6e 65 78 74 if( next
103a0 3c 3d 70 63 2b 73 69 7a 65 2b 33 20 29 20 62 72 <=pc+size+3 ) br
103b0 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 70 63 20 eak;. pc
103c0 3d 20 6e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a = next;. }.
103d0 20 20 20 20 20 20 69 66 28 20 6e 65 78 74 3e 30 if( next>0
103e0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ){. retu
103f0 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
10400 54 5f 42 4b 50 54 3b 20 20 2f 2a 20 46 72 65 65 T_BKPT; /* Free
10410 62 6c 6f 63 6b 20 6e 6f 74 20 69 6e 20 61 73 63 block not in asc
10420 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a ending order */.
10430 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
10440 28 20 70 63 2b 73 69 7a 65 3e 28 75 6e 73 69 67 ( pc+size>(unsig
10450 6e 65 64 20 69 6e 74 29 75 73 61 62 6c 65 53 69 ned int)usableSi
10460 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 ze ){. re
10470 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
10480 55 50 54 5f 42 4b 50 54 3b 20 20 2f 2a 20 4c 61 UPT_BKPT; /* La
10490 73 74 20 66 72 65 65 62 6c 6f 63 6b 20 65 78 74 st freeblock ext
104a0 65 6e 64 73 20 70 61 73 74 20 70 61 67 65 20 65 ends past page e
104b0 6e 64 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 nd */. }.
104c0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 74 20 74 }.. /* At t
104d0 68 69 73 20 70 6f 69 6e 74 2c 20 6e 46 72 65 65 his point, nFree
104e0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 75 contains the su
104f0 6d 20 6f 66 20 74 68 65 20 6f 66 66 73 65 74 20 m of the offset
10500 74 6f 20 74 68 65 20 73 74 61 72 74 0a 20 20 20 to the start.
10510 20 2a 2a 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d ** of the cell-
10520 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 70 6c 75 content area plu
10530 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
10540 66 72 65 65 20 62 79 74 65 73 20 77 69 74 68 69 free bytes withi
10550 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 65 6c n. ** the cel
10560 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 l-content area.
10570 49 66 20 74 68 69 73 20 69 73 20 67 72 65 61 74 If this is great
10580 65 72 20 74 68 61 6e 20 74 68 65 20 75 73 61 62 er than the usab
10590 6c 65 2d 73 69 7a 65 0a 20 20 20 20 2a 2a 20 6f le-size. ** o
105a0 66 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 6e f the page, then
105b0 20 74 68 65 20 70 61 67 65 20 6d 75 73 74 20 62 the page must b
105c0 65 20 63 6f 72 72 75 70 74 65 64 2e 20 54 68 69 e corrupted. Thi
105d0 73 20 63 68 65 63 6b 20 61 6c 73 6f 0a 20 20 20 s check also.
105e0 20 2a 2a 20 73 65 72 76 65 73 20 74 6f 20 76 65 ** serves to ve
105f0 72 69 66 79 20 74 68 61 74 20 74 68 65 20 6f 66 rify that the of
10600 66 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 fset to the star
10610 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f t of the cell-co
10620 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 61 72 65 ntent. ** are
10630 61 2c 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 a, according to
10640 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 2c the page header,
10650 20 6c 69 65 73 20 77 69 74 68 69 6e 20 74 68 65 lies within the
10660 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 page.. */.
10670 20 20 69 66 28 20 6e 46 72 65 65 3e 75 73 61 62 if( nFree>usab
10680 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 leSize ){.
10690 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
106a0 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 RRUPT_BKPT; .
106b0 20 7d 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 }. pPage->nF
106c0 72 65 65 20 3d 20 28 75 31 36 29 28 6e 46 72 65 ree = (u16)(nFre
106d0 65 20 2d 20 69 43 65 6c 6c 46 69 72 73 74 29 3b e - iCellFirst);
106e0 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 6e . pPage->isIn
106f0 69 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 it = 1;. }. re
10700 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
10710 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 20 }../*.** Set up
10720 61 20 72 61 77 20 70 61 67 65 20 73 6f 20 74 68 a raw page so th
10730 61 74 20 69 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 at it looks like
10740 20 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 a database page
10750 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6e 6f 20 65 holding.** no e
10760 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 ntries..*/.stati
10770 63 20 76 6f 69 64 20 7a 65 72 6f 50 61 67 65 28 c void zeroPage(
10780 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
10790 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 75 6e int flags){. un
107a0 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 signed char *dat
107b0 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 a = pPage->aData
107c0 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
107d0 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a t = pPage->pBt;.
107e0 20 20 75 38 20 68 64 72 20 3d 20 70 50 61 67 65 u8 hdr = pPage
107f0 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 75 ->hdrOffset;. u
10800 31 36 20 66 69 72 73 74 3b 0a 0a 20 20 61 73 73 16 first;.. ass
10810 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
10820 72 50 61 67 65 6e 75 6d 62 65 72 28 70 50 61 67 rPagenumber(pPag
10830 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 50 61 e->pDbPage)==pPa
10840 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a 20 20 61 73 ge->pgno );. as
10850 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
10860 65 72 47 65 74 45 78 74 72 61 28 70 50 61 67 65 erGetExtra(pPage
10870 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 28 76 ->pDbPage) == (v
10880 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a 20 20 oid*)pPage );.
10890 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
108a0 61 67 65 72 47 65 74 44 61 74 61 28 70 50 61 67 agerGetData(pPag
108b0 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 64 e->pDbPage) == d
108c0 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ata );. assert(
108d0 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
108e0 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
108f0 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
10900 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
10910 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
10920 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 tex) );. if( pB
10930 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
10940 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 S_SECURE_DELETE
10950 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 64 ){. memset(&d
10960 61 74 61 5b 68 64 72 5d 2c 20 30 2c 20 70 42 74 ata[hdr], 0, pBt
10970 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 68 ->usableSize - h
10980 64 72 29 3b 0a 20 20 7d 0a 20 20 64 61 74 61 5b dr);. }. data[
10990 68 64 72 5d 20 3d 20 28 63 68 61 72 29 66 6c 61 hdr] = (char)fla
109a0 67 73 3b 0a 20 20 66 69 72 73 74 20 3d 20 68 64 gs;. first = hd
109b0 72 20 2b 20 28 28 66 6c 61 67 73 26 50 54 46 5f r + ((flags&PTF_
109c0 4c 45 41 46 29 3d 3d 30 20 3f 20 31 32 20 3a 20 LEAF)==0 ? 12 :
109d0 38 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 8);. memset(&da
109e0 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 ta[hdr+1], 0, 4)
109f0 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 ;. data[hdr+7]
10a00 3d 20 30 3b 0a 20 20 70 75 74 32 62 79 74 65 28 = 0;. put2byte(
10a10 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 42 &data[hdr+5], pB
10a20 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a t->usableSize);.
10a30 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d pPage->nFree =
10a40 20 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 (u16)(pBt->usab
10a50 6c 65 53 69 7a 65 20 2d 20 66 69 72 73 74 29 3b leSize - first);
10a60 0a 20 20 64 65 63 6f 64 65 46 6c 61 67 73 28 70 . decodeFlags(p
10a70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
10a80 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
10a90 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 61 t = first;. pPa
10aa0 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 26 ge->aDataEnd = &
10ab0 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 data[pBt->usable
10ac0 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e Size];. pPage->
10ad0 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 aCellIdx = &data
10ae0 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 65 [first];. pPage
10af0 2d 3e 61 44 61 74 61 4f 66 73 74 20 3d 20 26 64 ->aDataOfst = &d
10b00 61 74 61 5b 70 50 61 67 65 2d 3e 63 68 69 6c 64 ata[pPage->child
10b10 50 74 72 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 PtrSize];. pPag
10b20 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 e->nOverflow = 0
10b30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d ;. assert( pBt-
10b40 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 >pageSize>=512 &
10b50 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c & pBt->pageSize<
10b60 3d 36 35 35 33 36 20 29 3b 0a 20 20 70 50 61 67 =65536 );. pPag
10b70 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 e->maskPage = (u
10b80 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 16)(pBt->pageSiz
10b90 65 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 65 2d e - 1);. pPage-
10ba0 3e 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 50 >nCell = 0;. pP
10bb0 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 3b age->isInit = 1;
10bc0 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 .}.../*.** Conve
10bd0 72 74 20 61 20 44 62 50 61 67 65 20 6f 62 74 61 rt a DbPage obta
10be0 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 70 61 ined from the pa
10bf0 67 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d 50 61 ger into a MemPa
10c00 67 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 74 68 ge used by.** th
10c10 65 20 62 74 72 65 65 20 6c 61 79 65 72 2e 0a 2a e btree layer..*
10c20 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 /.static MemPage
10c30 20 2a 62 74 72 65 65 50 61 67 65 46 72 6f 6d 44 *btreePageFromD
10c40 62 50 61 67 65 28 44 62 50 61 67 65 20 2a 70 44 bPage(DbPage *pD
10c50 62 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 6e 6f bPage, Pgno pgno
10c60 2c 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 , BtShared *pBt)
10c70 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 {. MemPage *pPa
10c80 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 73 ge = (MemPage*)s
10c90 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 qlite3PagerGetEx
10ca0 74 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 tra(pDbPage);.
10cb0 69 66 28 20 70 67 6e 6f 21 3d 70 50 61 67 65 2d if( pgno!=pPage-
10cc0 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50 61 >pgno ){. pPa
10cd0 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c 69 ge->aData = sqli
10ce0 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 te3PagerGetData(
10cf0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 70 50 pDbPage);. pP
10d00 61 67 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 70 age->pDbPage = p
10d10 44 62 50 61 67 65 3b 0a 20 20 20 20 70 50 61 67 DbPage;. pPag
10d20 65 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 e->pBt = pBt;.
10d30 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 pPage->pgno =
10d40 70 67 6e 6f 3b 0a 20 20 20 20 70 50 61 67 65 2d pgno;. pPage-
10d50 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 70 67 6e >hdrOffset = pgn
10d60 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b 0a o==1 ? 100 : 0;.
10d70 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 }. assert( pP
10d80 61 67 65 2d 3e 61 44 61 74 61 3d 3d 73 71 6c 69 age->aData==sqli
10d90 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 te3PagerGetData(
10da0 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 65 pDbPage) );. re
10db0 74 75 72 6e 20 70 50 61 67 65 3b 20 0a 7d 0a 0a turn pPage; .}..
10dc0 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 67 65 /*.** Get a page
10dd0 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 2e from the pager.
10de0 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 Initialize the
10df0 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 6e 64 MemPage.pBt and
10e00 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 61 74 .** MemPage.aDat
10e10 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 6e 65 a elements if ne
10e20 65 64 65 64 2e 20 20 53 65 65 20 61 6c 73 6f 3a eded. See also:
10e30 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 50 btreeGetUnusedP
10e40 61 67 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 age()..**.** If
10e50 74 68 65 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f the PAGER_GET_NO
10e60 43 4f 4e 54 45 4e 54 20 66 6c 61 67 20 69 73 20 CONTENT flag is
10e70 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 set, it means th
10e80 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 at we do not car
10e90 65 0a 2a 2a 20 61 62 6f 75 74 20 74 68 65 20 63 e.** about the c
10ea0 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 61 ontent of the pa
10eb0 67 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 2e ge at this time.
10ec0 20 20 53 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 74 So do not go t
10ed0 6f 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 74 6f o the disk.** to
10ee0 20 66 65 74 63 68 20 74 68 65 20 63 6f 6e 74 65 fetch the conte
10ef0 6e 74 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 69 nt. Just fill i
10f00 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 69 n the content wi
10f10 74 68 20 7a 65 72 6f 73 20 66 6f 72 20 6e 6f 77 th zeros for now
10f20 2e 0a 2a 2a 20 49 66 20 69 6e 20 74 68 65 20 66 ..** If in the f
10f30 75 74 75 72 65 20 77 65 20 63 61 6c 6c 20 73 71 uture we call sq
10f40 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
10f50 29 20 6f 6e 20 74 68 69 73 20 70 61 67 65 2c 20 ) on this page,
10f60 74 68 61 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 65 that.** means we
10f70 20 68 61 76 65 20 73 74 61 72 74 65 64 20 74 6f have started to
10f80 20 62 65 20 63 6f 6e 63 65 72 6e 65 64 20 61 62 be concerned ab
10f90 6f 75 74 20 63 6f 6e 74 65 6e 74 20 61 6e 64 20 out content and
10fa0 74 68 65 20 64 69 73 6b 0a 2a 2a 20 72 65 61 64 the disk.** read
10fb0 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 74 should occur at
10fc0 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f 0a that point..*/.
10fd0 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 static int btree
10fe0 47 65 74 50 61 67 65 28 0a 20 20 42 74 53 68 61 GetPage(. BtSha
10ff0 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
11000 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f 0a /* The btree */.
11010 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 Pgno pgno,
11020 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
11030 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f 20 of the page to
11040 66 65 74 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 61 fetch */. MemPa
11050 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 ge **ppPage,
11060 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 70 61 /* Return the pa
11070 67 65 20 69 6e 20 74 68 69 73 20 70 61 72 61 6d ge in this param
11080 65 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 66 6c eter */. int fl
11090 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 2f ags /
110a0 2a 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f * PAGER_GET_NOCO
110b0 4e 54 45 4e 54 20 6f 72 20 50 41 47 45 52 5f 47 NTENT or PAGER_G
110c0 45 54 5f 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a 29 ET_READONLY */.)
110d0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 {. int rc;. Db
110e0 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 0a Page *pDbPage;..
110f0 20 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 3d assert( flags=
11100 3d 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 =0 || flags==PAG
11110 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 ER_GET_NOCONTENT
11120 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 45 52 || flags==PAGER
11130 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 29 3b _GET_READONLY );
11140 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
11150 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
11160 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 t->mutex) );. r
11170 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
11180 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c Get(pBt->pPager,
11190 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 2a 2a pgno, (DbPage**
111a0 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 67 73 )&pDbPage, flags
111b0 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 );. if( rc ) re
111c0 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 61 turn rc;. *ppPa
111d0 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 72 ge = btreePageFr
111e0 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 omDbPage(pDbPage
111f0 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 , pgno, pBt);.
11200 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
11210 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 69 ;.}../*.** Retri
11220 65 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d 20 eve a page from
11230 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 2e the pager cache.
11240 20 49 66 20 74 68 65 20 72 65 71 75 65 73 74 65 If the requeste
11250 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a 2a d page is not.**
11260 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
11270 70 61 67 65 72 20 63 61 63 68 65 20 72 65 74 75 pager cache retu
11280 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 6c rn NULL. Initial
11290 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 2e ize the MemPage.
112a0 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 61 pBt and.** MemPa
112b0 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e 74 ge.aData element
112c0 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f 0a s if needed..*/.
112d0 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 2a static MemPage *
112e0 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 btreePageLookup(
112f0 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
11300 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 50 gno pgno){. DbP
11310 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 age *pDbPage;.
11320 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
11330 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
11340 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 50 mutex) );. pDbP
11350 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 67 age = sqlite3Pag
11360 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 50 erLookup(pBt->pP
11370 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 69 ager, pgno);. i
11380 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 20 f( pDbPage ){.
11390 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 61 return btreePa
113a0 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 62 geFromDbPage(pDb
113b0 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 Page, pgno, pBt)
113c0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 ;. }. return 0
113d0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
113e0 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 n the size of th
113f0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
11400 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 65 in pages. If the
11410 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 6f re is any kind o
11420 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 75 f.** error, retu
11430 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 6e rn ((unsigned in
11440 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 t)-1)..*/.static
11450 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 63 Pgno btreePagec
11460 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 ount(BtShared *p
11470 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 42 Bt){. return pB
11480 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 20 t->nPage;.}.u32
11490 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 74 sqlite3BtreeLast
114a0 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b 0a Page(Btree *p){.
114b0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
114c0 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 3BtreeHoldsMutex
114d0 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 (p) );. assert(
114e0 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 ((p->pBt->nPage
114f0 29 26 30 78 38 30 30 30 30 30 30 29 3d 3d 30 20 )&0x8000000)==0
11500 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 74 72 65 );. return btre
11510 65 50 61 67 65 63 6f 75 6e 74 28 70 2d 3e 70 42 ePagecount(p->pB
11520 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 t);.}../*.** Get
11530 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 a page from the
11540 20 70 61 67 65 72 20 61 6e 64 20 69 6e 69 74 69 pager and initi
11550 61 6c 69 7a 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 alize it..**.**
11560 49 66 20 70 43 75 72 21 3d 30 20 74 68 65 6e 20 If pCur!=0 then
11570 74 68 65 20 70 61 67 65 20 69 73 20 62 65 69 6e the page is bein
11580 67 20 66 65 74 63 68 65 64 20 61 73 20 70 61 72 g fetched as par
11590 74 20 6f 66 20 61 20 6d 6f 76 65 54 6f 43 68 69 t of a moveToChi
115a0 6c 64 28 29 0a 2a 2a 20 63 61 6c 6c 2e 20 20 44 ld().** call. D
115b0 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 61 6e o additional san
115c0 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e 20 ity checking on
115d0 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 69 73 the page in this
115e0 20 63 61 73 65 2e 0a 2a 2a 20 41 6e 64 20 69 66 case..** And if
115f0 20 74 68 65 20 66 65 74 63 68 20 66 61 69 6c 73 the fetch fails
11600 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6d , this routine m
11610 75 73 74 20 64 65 63 72 65 6d 65 6e 74 20 70 43 ust decrement pC
11620 75 72 2d 3e 69 50 61 67 65 2e 0a 2a 2a 0a 2a 2a ur->iPage..**.**
11630 20 54 68 65 20 70 61 67 65 20 69 73 20 66 65 74 The page is fet
11640 63 68 65 64 20 61 73 20 72 65 61 64 2d 77 72 69 ched as read-wri
11650 74 65 20 75 6e 6c 65 73 73 20 70 43 75 72 20 69 te unless pCur i
11660 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 69 s not NULL and i
11670 73 0a 2a 2a 20 61 20 72 65 61 64 2d 6f 6e 6c 79 s.** a read-only
11680 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 cursor..**.** I
11690 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
116a0 73 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 65 20 s, then *ppPage
116b0 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 49 74 is undefined. It
116c0 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e 20 75 .** may remain u
116d0 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 74 20 nchanged, or it
116e0 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 61 6e may be set to an
116f0 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 2e 0a invalid value..
11700 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 65 */.static int ge
11710 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a 20 20 tAndInitPage(.
11720 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 BtShared *pBt,
11730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11740 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 /* The database
11750 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 file */. Pgno p
11760 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 gno,
11770 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
11780 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 ber of the page
11790 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 6d 50 to get */. MemP
117a0 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
117b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
117c0 72 69 74 65 20 74 68 65 20 70 61 67 65 20 70 6f rite the page po
117d0 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a 20 20 inter here */.
117e0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
117f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11800 2f 2a 20 43 75 72 73 6f 72 20 74 6f 20 72 65 63 /* Cursor to rec
11810 65 69 76 65 20 74 68 65 20 70 61 67 65 2c 20 6f eive the page, o
11820 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 69 6e 74 20 r NULL */. int
11830 62 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 20 20 bReadOnly
11840 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
11850 72 75 65 20 66 6f 72 20 61 20 72 65 61 64 2d 6f rue for a read-o
11860 6e 6c 79 20 70 61 67 65 20 2a 2f 0a 29 7b 0a 20 nly page */.){.
11870 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 50 61 67 int rc;. DbPag
11880 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 61 73 e *pDbPage;. as
11890 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
118a0 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
118b0 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
118c0 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 70 70 50 ( pCur==0 || ppP
118d0 61 67 65 3d 3d 26 70 43 75 72 2d 3e 61 70 50 61 age==&pCur->apPa
118e0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 ge[pCur->iPage]
118f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
11900 72 3d 3d 30 20 7c 7c 20 62 52 65 61 64 4f 6e 6c r==0 || bReadOnl
11910 79 3d 3d 70 43 75 72 2d 3e 63 75 72 50 61 67 65 y==pCur->curPage
11920 72 46 6c 61 67 73 20 29 3b 0a 20 20 61 73 73 65 rFlags );. asse
11930 72 74 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 70 rt( pCur==0 || p
11940 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 29 3b 0a Cur->iPage>0 );.
11950 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 74 72 65 . if( pgno>btre
11960 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 20 ePagecount(pBt)
11970 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 ){. rc = SQLI
11980 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
11990 0a 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 . goto getAnd
119a0 49 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a InitPage_error;.
119b0 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
119c0 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d 3e e3PagerGet(pBt->
119d0 70 50 61 67 65 72 2c 20 70 67 6e 6f 2c 20 28 44 pPager, pgno, (D
119e0 62 50 61 67 65 2a 2a 29 26 70 44 62 50 61 67 65 bPage**)&pDbPage
119f0 2c 20 62 52 65 61 64 4f 6e 6c 79 29 3b 0a 20 20 , bReadOnly);.
11a00 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 67 6f if( rc ){. go
11a10 74 6f 20 67 65 74 41 6e 64 49 6e 69 74 50 61 67 to getAndInitPag
11a20 65 5f 65 72 72 6f 72 3b 0a 20 20 7d 0a 20 20 2a e_error;. }. *
11a30 70 70 50 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 ppPage = (MemPag
11a40 65 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 e*)sqlite3PagerG
11a50 65 74 45 78 74 72 61 28 70 44 62 50 61 67 65 29 etExtra(pDbPage)
11a60 3b 0a 20 20 69 66 28 20 28 2a 70 70 50 61 67 65 ;. if( (*ppPage
11a70 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 7b 0a )->isInit==0 ){.
11a80 20 20 20 20 62 74 72 65 65 50 61 67 65 46 72 6f btreePageFro
11a90 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 2c mDbPage(pDbPage,
11aa0 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 20 pgno, pBt);.
11ab0 20 72 63 20 3d 20 62 74 72 65 65 49 6e 69 74 50 rc = btreeInitP
11ac0 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 age(*ppPage);.
11ad0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
11ae0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 6c _OK ){. rel
11af0 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 easePage(*ppPage
11b00 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 67 65 );. goto ge
11b10 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 72 tAndInitPage_err
11b20 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 or;. }. }.
11b30 61 73 73 65 72 74 28 20 28 2a 70 70 50 61 67 65 assert( (*ppPage
11b40 29 2d 3e 70 67 6e 6f 3d 3d 70 67 6e 6f 20 29 3b )->pgno==pgno );
11b50 0a 20 20 61 73 73 65 72 74 28 20 28 2a 70 70 50 . assert( (*ppP
11b60 61 67 65 29 2d 3e 61 44 61 74 61 3d 3d 73 71 6c age)->aData==sql
11b70 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
11b80 28 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 (pDbPage) );..
11b90 2f 2a 20 49 66 20 6f 62 74 61 69 6e 69 6e 67 20 /* If obtaining
11ba0 61 20 63 68 69 6c 64 20 70 61 67 65 20 66 6f 72 a child page for
11bb0 20 61 20 63 75 72 73 6f 72 2c 20 77 65 20 6d 75 a cursor, we mu
11bc0 73 74 20 76 65 72 69 66 79 20 74 68 61 74 20 74 st verify that t
11bd0 68 65 20 70 61 67 65 20 69 73 0a 20 20 2a 2a 20 he page is. **
11be0 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 compatible with
11bf0 74 68 65 20 72 6f 6f 74 20 70 61 67 65 2e 20 2a the root page. *
11c00 2f 0a 20 20 69 66 28 20 70 43 75 72 20 26 26 20 /. if( pCur &&
11c10 28 28 2a 70 70 50 61 67 65 29 2d 3e 6e 43 65 6c ((*ppPage)->nCel
11c20 6c 3c 31 20 7c 7c 20 28 2a 70 70 50 61 67 65 29 l<1 || (*ppPage)
11c30 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 75 72 2d 3e ->intKey!=pCur->
11c40 63 75 72 49 6e 74 4b 65 79 29 20 29 7b 0a 20 20 curIntKey) ){.
11c50 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
11c60 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
11c70 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
11c80 61 67 65 29 3b 0a 20 20 20 20 67 6f 74 6f 20 67 age);. goto g
11c90 65 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 etAndInitPage_er
11ca0 72 6f 72 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ror;. }. retur
11cb0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 67 65 n SQLITE_OK;..ge
11cc0 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 72 tAndInitPage_err
11cd0 6f 72 3a 0a 20 20 69 66 28 20 70 43 75 72 20 29 or:. if( pCur )
11ce0 20 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 3b 0a pCur->iPage--;.
11cf0 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e 6f testcase( pgno
11d00 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
11d10 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d 3d pgno!=0 || rc==
11d20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 29 SQLITE_CORRUPT )
11d30 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
11d40 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 ../*.** Release
11d50 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 73 a MemPage. This
11d60 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c 65 should be calle
11d70 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 d once for each
11d80 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 6f prior.** call to
11d90 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a 2a btreeGetPage..*
11da0 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 /.static void re
11db0 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c leasePageNotNull
11dc0 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
11dd0 7b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 {. assert( pPag
11de0 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 61 73 e->aData );. as
11df0 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 sert( pPage->pBt
11e00 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
11e10 61 67 65 2d 3e 70 44 62 50 61 67 65 21 3d 30 20 age->pDbPage!=0
11e20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
11e30 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 ite3PagerGetExtr
11e40 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 a(pPage->pDbPage
11e50 29 20 3d 3d 20 28 76 6f 69 64 2a 29 70 50 61 67 ) == (void*)pPag
11e60 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 e );. assert( s
11e70 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61 qlite3PagerGetDa
11e80 74 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ta(pPage->pDbPag
11e90 65 29 3d 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 e)==pPage->aData
11ea0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
11eb0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
11ec0 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
11ed0 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 ex) );. sqlite3
11ee0 50 61 67 65 72 55 6e 72 65 66 4e 6f 74 4e 75 6c PagerUnrefNotNul
11ef0 6c 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 l(pPage->pDbPage
11f00 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 );.}.static void
11f10 20 72 65 6c 65 61 73 65 50 61 67 65 28 4d 65 6d releasePage(Mem
11f20 50 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 Page *pPage){.
11f30 69 66 28 20 70 50 61 67 65 20 29 20 72 65 6c 65 if( pPage ) rele
11f40 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 asePageNotNull(p
11f50 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
11f60 47 65 74 20 61 6e 20 75 6e 75 73 65 64 20 70 61 Get an unused pa
11f70 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 ge..**.** This w
11f80 6f 72 6b 73 20 6a 75 73 74 20 6c 69 6b 65 20 62 orks just like b
11f90 74 72 65 65 47 65 74 50 61 67 65 28 29 20 77 69 treeGetPage() wi
11fa0 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e 3a th the addition:
11fb0 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 49 66 20 74 .**.** * If t
11fc0 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 he page is alrea
11fd0 64 79 20 69 6e 20 75 73 65 20 66 6f 72 20 73 6f dy in use for so
11fe0 6d 65 20 6f 74 68 65 72 20 70 75 72 70 6f 73 65 me other purpose
11ff0 2c 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a , immediately.**
12000 20 20 20 20 20 20 72 65 6c 65 61 73 65 20 69 74 release it
12010 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 53 and return an S
12020 51 4c 49 54 45 5f 43 55 52 52 55 50 54 20 65 72 QLITE_CURRUPT er
12030 72 6f 72 2e 0a 2a 2a 20 20 20 2a 20 20 4d 61 6b ror..** * Mak
12040 65 20 73 75 72 65 20 74 68 65 20 69 73 49 6e 69 e sure the isIni
12050 74 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 0a t flag is clear.
12060 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
12070 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 reeGetUnusedPage
12080 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
12090 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 t, /* The
120a0 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 btree */. Pgno
120b0 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
120c0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 /* Number of the
120d0 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 2a page to fetch *
120e0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
120f0 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 75 Page, /* Retu
12100 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 rn the page in t
12110 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a 2f his parameter */
12120 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 . int flags
12130 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 /* PAGER
12140 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 6f _GET_NOCONTENT o
12150 72 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 r PAGER_GET_READ
12160 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ONLY */.){. int
12170 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
12180 67 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 ge(pBt, pgno, pp
12190 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
121a0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
121b0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 73 71 6c K ){. if( sql
121c0 69 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 ite3PagerPageRef
121d0 63 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 2d count((*ppPage)-
121e0 3e 70 44 62 50 61 67 65 29 3e 31 20 29 7b 0a 20 >pDbPage)>1 ){.
121f0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
12200 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 (*ppPage);.
12210 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 *ppPage = 0;.
12220 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
12230 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
12240 20 20 20 20 7d 0a 20 20 20 20 28 2a 70 70 50 61 }. (*ppPa
12250 67 65 29 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b ge)->isInit = 0;
12260 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 . }else{. *p
12270 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 pPage = 0;. }.
12280 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
12290 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 20 72 /*.** During a r
122a0 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 74 68 ollback, when th
122b0 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 73 20 e pager reloads
122c0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 6f information into
122d0 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 73 6f the cache.** so
122e0 20 74 68 61 74 20 74 68 65 20 63 61 63 68 65 20 that the cache
122f0 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 is restored to i
12300 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 ts original stat
12310 65 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f e at the start o
12320 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 63 f.** the transac
12330 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 20 70 tion, for each p
12340 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 68 69 age restored thi
12350 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
12360 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 led..**.** This
12370 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 6f routine needs to
12380 20 72 65 73 65 74 20 74 68 65 20 65 78 74 72 61 reset the extra
12390 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 61 74 data section at
123a0 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 0a the end of the.
123b0 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 65 65 ** page to agree
123c0 20 77 69 74 68 20 74 68 65 20 72 65 73 74 6f 72 with the restor
123d0 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 74 ed data..*/.stat
123e0 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 69 6e ic void pageRein
123f0 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 74 61 it(DbPage *pData
12400 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
12410 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d 20 28 age;. pPage = (
12420 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 74 65 MemPage *)sqlite
12430 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 3PagerGetExtra(p
12440 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74 28 Data);. assert(
12450 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
12460 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12470 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 >0 );. if( pPag
12480 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 e->isInit ){.
12490 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
124a0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
124b0 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
124c0 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 ;. pPage->isI
124d0 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 nit = 0;. if(
124e0 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
124f0 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12500 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 70 >1 ){. /* p
12510 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 20 62 Page might not b
12520 65 20 61 20 62 74 72 65 65 20 70 61 67 65 3b 20 e a btree page;
12530 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 6e 20 it might be an
12540 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 overflow page.
12550 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d 61 70 ** or ptrmap
12560 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 65 20 page or a free
12570 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 65 20 page. In those
12580 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c 6c 6f cases, the follo
12590 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 63 61 wing. ** ca
125a0 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 74 50 ll to btreeInitP
125b0 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b 65 6c age() will likel
125c0 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f y return SQLITE_
125d0 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 20 2a CORRUPT.. *
125e0 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 69 73 * But no harm is
125f0 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e 20 20 done by this.
12600 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 20 69 And it is very i
12610 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a 20 20 mportant that.
12620 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e 69 74 ** btreeInit
12630 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c 65 64 Page() be called
12640 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 65 20 on every btree
12650 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b 65 0a page so we make.
12660 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 61 6c ** the cal
12670 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 67 65 l for every page
12680 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e 20 66 that comes in f
12690 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e 20 2a or re-initing. *
126a0 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 6e 69 /. btreeIni
126b0 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 tPage(pPage);.
126c0 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
126d0 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 Invoke the busy
126e0 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 20 62 handler for a b
126f0 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tree..*/.static
12700 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 int btreeInvokeB
12710 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64 20 usyHandler(void
12720 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 61 72 *pArg){. BtShar
12730 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 68 61 ed *pBt = (BtSha
12740 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 73 73 red*)pArg;. ass
12750 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 3b 0a ert( pBt->db );.
12760 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
12770 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
12780 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
12790 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
127a0 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
127b0 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 73 79 r(&pBt->db->busy
127c0 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a 2f 2a 0a Handler);.}../*.
127d0 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 62 61 ** Open a databa
127e0 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a 20 se file..** .**
127f0 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 zFilename is the
12800 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 name of the dat
12810 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 abase file. If
12820 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c zFilename is NUL
12830 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 70 68 L.** then an eph
12840 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 20 emeral database
12850 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 65 is created. The
12860 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 62 ephemeral datab
12870 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 65 20 ase might.** be
12880 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e 20 6d exclusively in m
12890 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d 69 67 emory, or it mig
128a0 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d 62 61 ht use a disk-ba
128b0 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 68 65 sed memory cache
128c0 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 79 2c ..** Either way,
128d0 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c 20 64 the ephemeral d
128e0 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20 atabase will be
128f0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 automatically de
12900 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e 20 73 leted .** when s
12910 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 qlite3BtreeClose
12920 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a () is called..**
12930 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 .** If zFilename
12940 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 is ":memory:" t
12950 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 hen an in-memory
12960 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 65 database is cre
12970 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 73 20 ated.** that is
12980 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 automatically de
12990 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 74 20 stroyed when it
129a0 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a is closed..**.**
129b0 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 61 72 The "flags" par
129c0 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 74 6d ameter is a bitm
129d0 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 20 63 ask that might c
129e0 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 6b 65 ontain bits like
129f0 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 5f 4a .** BTREE_OMIT_J
12a00 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 42 54 OURNAL and/or BT
12a10 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a 0a 2a REE_MEMORY..**.*
12a20 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 * If the databas
12a30 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 e is already ope
12a40 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 20 ned in the same
12a50 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
12a60 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 61 72 ion.** and we ar
12a70 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 68 e in shared cach
12a80 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 65 e mode, then the
12a90 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 6c 20 open will fail
12aa0 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c 49 54 with an.** SQLIT
12ab0 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 72 72 E_CONSTRAINT err
12ac0 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 20 61 or. We cannot a
12ad0 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f 72 65 llow two or more
12ae0 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f 62 6a BtShared.** obj
12af0 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 6d 65 ects in the same
12b00 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
12b10 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 6e 67 tion since doing
12b20 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a 2a 2a so will lead.**
12b30 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 to problems wit
12b40 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e h locking..*/.in
12b50 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 t sqlite3BtreeOp
12b60 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 en(. sqlite3_vf
12b70 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 2f 2a s *pVfs, /*
12b80 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f 72 20 VFS to use for
12b90 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f 0a 20 this b-tree */.
12ba0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 const char *zFi
12bb0 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 6d 65 lename, /* Name
12bc0 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f 6e of the file con
12bd0 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 65 taining the BTre
12be0 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 e database */.
12bf0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
12c00 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 6f 63 /* Assoc
12c10 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 68 iated database h
12c20 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65 65 andle */. Btree
12c30 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 20 20 **ppBtree,
12c40 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
12c50 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63 new Btree objec
12c60 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a t written here *
12c70 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 /. int flags,
12c80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
12c90 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 ptions */. int
12ca0 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 20 20 vfsFlags
12cb0 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 73 /* Flags pas
12cc0 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 73 sed through to s
12cd0 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 6e qlite3_vfs.xOpen
12ce0 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 () */.){. BtSha
12cf0 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 20 20 red *pBt = 0;
12d00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 61 /* Sha
12d10 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 72 65 red part of btre
12d20 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 e structure */.
12d30 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 20 20 Btree *p;
12d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12d50 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 65 74 /* Handle to ret
12d60 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 urn */. sqlite3
12d70 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f 70 65 _mutex *mutexOpe
12d80 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 76 65 n = 0; /* Preve
12d90 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e 64 69 nts a race condi
12da0 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 33 35 tion. Ticket #35
12db0 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 37 */. int rc =
12dc0 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 SQLITE_OK;
12dd0 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 /* Result
12de0 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 73 20 code from this
12df0 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 function */. u8
12e00 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 20 nReserve;
12e10 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
12e20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 20 73 Byte of unused s
12e30 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 67 pace on each pag
12e40 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 e */. unsigned
12e50 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 5b 31 char zDbHeader[1
12e60 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 61 73 00]; /* Databas
12e70 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 6e 74 e header content
12e80 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 20 69 */.. /* True i
12e90 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 70 68 f opening an eph
12ea0 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 61 72 emeral, temporar
12eb0 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 y database */.
12ec0 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 6d 70 const int isTemp
12ed0 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d Db = zFilename==
12ee0 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 0 || zFilename[0
12ef0 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 ]==0;.. /* Set
12f00 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 4d the variable isM
12f10 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 6f 72 emdb to true for
12f20 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 an in-memory da
12f30 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 2a 2a tabase, or . **
12f40 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 69 6c false for a fil
12f50 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 73 65 e-based database
12f60 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 .. */.#ifdef SQ
12f70 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 LITE_OMIT_MEMORY
12f80 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 DB. const int i
12f90 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 6c 73 sMemdb = 0;.#els
12fa0 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 e. const int is
12fb0 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 6e 61 Memdb = (zFilena
12fc0 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a 46 69 me && strcmp(zFi
12fd0 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f 72 79 lename, ":memory
12fe0 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 20 20 :")==0).
12ff0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
13000 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 20 73 | (isTempDb && s
13010 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f qlite3TempInMemo
13020 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 20 20 ry(db)).
13030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
13040 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 53 51 | (vfsFlags & SQ
13050 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 59 LITE_OPEN_MEMORY
13060 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 )!=0;.#endif..
13070 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 3b assert( db!=0 );
13080 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 73 21 . assert( pVfs!
13090 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
130a0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
130b0 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
130c0 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 67 . assert( (flag
130d0 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 20 29 s&0xff)==flags )
130e0 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 74 ; /* flags fit
130f0 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a 0a 20 in 8 bits */..
13100 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 45 45 /* Only a BTREE
13110 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 _SINGLE database
13120 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f 55 4e can be BTREE_UN
13130 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 73 73 ORDERED */. ass
13140 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 ert( (flags & BT
13150 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 3d 3d REE_UNORDERED)==
13160 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 42 54 0 || (flags & BT
13170 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 20 29 REE_SINGLE)!=0 )
13180 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 45 5f ;.. /* A BTREE_
13190 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 20 SINGLE database
131a0 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 6d 70 is always a temp
131b0 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 70 68 orary and/or eph
131c0 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 73 65 emeral */. asse
131d0 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 52 rt( (flags & BTR
131e0 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 7c 7c EE_SINGLE)==0 ||
131f0 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a 20 20 isTempDb );..
13200 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a 20 if( isMemdb ){.
13210 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 flags |= BTRE
13220 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 20 20 E_MEMORY;. }.
13230 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 20 if( (vfsFlags &
13240 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
13250 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 4d 65 _DB)!=0 && (isMe
13260 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 62 29 mdb || isTempDb)
13270 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 73 ){. vfsFlags
13280 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 7e = (vfsFlags & ~
13290 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
132a0 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f 50 _DB) | SQLITE_OP
132b0 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d 0a EN_TEMP_DB;. }.
132c0 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c p = sqlite3Mal
132d0 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 42 locZero(sizeof(B
132e0 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 21 70 tree));. if( !p
132f0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
13300 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
13310 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 61 ;. }. p->inTra
13320 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b ns = TRANS_NONE;
13330 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a 23 . p->db = db;.#
13340 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
13350 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
13360 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 p->lock.pBtree
13370 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b 2e = p;. p->lock.
13380 69 54 61 62 6c 65 20 3d 20 31 3b 0a 23 65 6e 64 iTable = 1;.#end
13390 69 66 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 if..#if !defined
133a0 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 (SQLITE_OMIT_SHA
133b0 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 64 RED_CACHE) && !d
133c0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
133d0 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 0a IT_DISKIO). /*.
133e0 20 20 2a 2a 20 49 66 20 74 68 69 73 20 42 74 72 ** If this Btr
133f0 65 65 20 69 73 20 61 20 63 61 6e 64 69 64 61 74 ee is a candidat
13400 65 20 66 6f 72 20 73 68 61 72 65 64 20 63 61 63 e for shared cac
13410 68 65 2c 20 74 72 79 20 74 6f 20 66 69 6e 64 20 he, try to find
13420 61 6e 0a 20 20 2a 2a 20 65 78 69 73 74 69 6e 67 an. ** existing
13430 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 BtShared object
13440 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 68 61 that we can sha
13450 72 65 20 77 69 74 68 0a 20 20 2a 2f 0a 20 20 69 re with. */. i
13460 66 28 20 69 73 54 65 6d 70 44 62 3d 3d 30 20 26 f( isTempDb==0 &
13470 26 20 28 69 73 4d 65 6d 64 62 3d 3d 30 20 7c 7c & (isMemdb==0 ||
13480 20 28 76 66 73 46 6c 61 67 73 26 53 51 4c 49 54 (vfsFlags&SQLIT
13490 45 5f 4f 50 45 4e 5f 55 52 49 29 21 3d 30 29 20 E_OPEN_URI)!=0)
134a0 29 7b 0a 20 20 20 20 69 66 28 20 76 66 73 46 6c ){. if( vfsFl
134b0 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
134c0 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 29 7b N_SHAREDCACHE ){
134d0 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 69 6c 65 . int nFile
134e0 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 name = sqlite3St
134f0 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 rlen30(zFilename
13500 29 2b 31 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e )+1;. int n
13510 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 70 FullPathname = p
13520 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b Vfs->mxPathname+
13530 31 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 1;. char *z
13540 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 73 FullPathname = s
13550 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 4d 41 58 qlite3Malloc(MAX
13560 28 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c 6e (nFullPathname,n
13570 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 20 20 Filename));.
13580 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 MUTEX_LOGIC( s
13590 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 qlite3_mutex *mu
135a0 74 65 78 53 68 61 72 65 64 3b 20 29 0a 0a 20 20 texShared; )..
135b0 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 p->sharable
135c0 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 21 = 1;. if( !
135d0 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 7b zFullPathname ){
135e0 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
135f0 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 _free(p);.
13600 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
13610 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
13620 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 69 73 }. if( is
13630 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 20 20 20 Memdb ){.
13640 20 6d 65 6d 63 70 79 28 7a 46 75 6c 6c 50 61 74 memcpy(zFullPat
13650 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 6e 61 6d 65 hname, zFilename
13660 2c 20 6e 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 , nFilename);.
13670 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
13680 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
13690 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56 sFullPathname(pV
136a0 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 fs, zFilename,.
136b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
136c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
136d0 20 20 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c nFullPathname,
136e0 20 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b zFullPathname);
136f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 . if( rc
13700 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c ){. sql
13710 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 ite3_free(zFullP
13720 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 athname);.
13730 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
13740 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 (p);. r
13750 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
13760 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 69 66 20 }. }.#if
13770 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 SQLITE_THREADSAF
13780 45 0a 20 20 20 20 20 20 6d 75 74 65 78 4f 70 65 E. mutexOpe
13790 6e 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 n = sqlite3Mutex
137a0 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 Alloc(SQLITE_MUT
137b0 45 58 5f 53 54 41 54 49 43 5f 4f 50 45 4e 29 3b EX_STATIC_OPEN);
137c0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
137d0 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 utex_enter(mutex
137e0 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 6d 75 74 Open);. mut
137f0 65 78 53 68 61 72 65 64 20 3d 20 73 71 6c 69 74 exShared = sqlit
13800 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c e3MutexAlloc(SQL
13810 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 ITE_MUTEX_STATIC
13820 5f 4d 41 53 54 45 52 29 3b 0a 20 20 20 20 20 20 _MASTER);.
13830 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
13840 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 29 ter(mutexShared)
13850 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 66 ;.#endif. f
13860 6f 72 28 70 42 74 3d 47 4c 4f 42 41 4c 28 42 74 or(pBt=GLOBAL(Bt
13870 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
13880 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b haredCacheList);
13890 20 70 42 74 3b 20 70 42 74 3d 70 42 74 2d 3e 70 pBt; pBt=pBt->p
138a0 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 61 Next){. a
138b0 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 52 65 66 ssert( pBt->nRef
138c0 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 >0 );. if
138d0 28 20 30 3d 3d 73 74 72 63 6d 70 28 7a 46 75 6c ( 0==strcmp(zFul
138e0 6c 50 61 74 68 6e 61 6d 65 2c 20 73 71 6c 69 74 lPathname, sqlit
138f0 65 33 50 61 67 65 72 46 69 6c 65 6e 61 6d 65 28 e3PagerFilename(
13900 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 30 29 29 pBt->pPager, 0))
13910 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
13920 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 && sqlite3Page
13930 72 56 66 73 28 70 42 74 2d 3e 70 50 61 67 65 72 rVfs(pBt->pPager
13940 29 3d 3d 70 56 66 73 20 29 7b 0a 20 20 20 20 20 )==pVfs ){.
13950 20 20 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 int iDb;.
13960 20 20 20 20 20 20 20 20 66 6f 72 28 69 44 62 3d for(iDb=
13970 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 44 62 3e 3d db->nDb-1; iDb>=
13980 30 3b 20 69 44 62 2d 2d 29 7b 0a 20 20 20 20 20 0; iDb--){.
13990 20 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 45 Btree *pE
139a0 78 69 73 74 69 6e 67 20 3d 20 64 62 2d 3e 61 44 xisting = db->aD
139b0 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 b[iDb].pBt;.
139c0 20 20 20 20 20 20 20 20 69 66 28 20 70 45 78 69 if( pExi
139d0 73 74 69 6e 67 20 26 26 20 70 45 78 69 73 74 69 sting && pExisti
139e0 6e 67 2d 3e 70 42 74 3d 3d 70 42 74 20 29 7b 0a ng->pBt==pBt ){.
139f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 sq
13a00 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
13a10 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a e(mutexShared);.
13a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 sq
13a30 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
13a40 65 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 e(mutexOpen);.
13a50 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
13a60 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 te3_free(zFullPa
13a70 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 thname);.
13a80 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
13a90 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 ree(p);.
13aa0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
13ab0 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3b 0a ITE_CONSTRAINT;.
13ac0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
13ad0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
13ae0 20 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 p->pBt = pBt
13af0 3b 0a 20 20 20 20 20 20 20 20 20 20 70 42 74 2d ;. pBt-
13b00 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 20 >nRef++;.
13b10 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
13b20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
13b30 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
13b40 6c 65 61 76 65 28 6d 75 74 65 78 53 68 61 72 65 leave(mutexShare
13b50 64 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 d);. sqlite
13b60 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 3_free(zFullPath
13b70 6e 61 6d 65 29 3b 0a 20 20 20 20 7d 0a 23 69 66 name);. }.#if
13b80 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
13b90 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 20 . else{.
13ba0 20 2f 2a 20 49 6e 20 64 65 62 75 67 20 6d 6f 64 /* In debug mod
13bb0 65 2c 20 77 65 20 6d 61 72 6b 20 61 6c 6c 20 70 e, we mark all p
13bc0 65 72 73 69 73 74 65 6e 74 20 64 61 74 61 62 61 ersistent databa
13bd0 73 65 73 20 61 73 20 73 68 61 72 61 62 6c 65 0a ses as sharable.
13be0 20 20 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 68 ** even wh
13bf0 65 6e 20 74 68 65 79 20 61 72 65 20 6e 6f 74 2e en they are not.
13c00 20 20 54 68 69 73 20 65 78 65 72 63 69 73 65 73 This exercises
13c10 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f 64 the locking cod
13c20 65 20 61 6e 64 0a 20 20 20 20 20 20 2a 2a 20 67 e and. ** g
13c30 69 76 65 73 20 6d 6f 72 65 20 6f 70 70 6f 72 74 ives more opport
13c40 75 6e 69 74 79 20 66 6f 72 20 61 73 73 65 72 74 unity for assert
13c50 73 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f s(sqlite3_mutex_
13c60 68 65 6c 64 28 29 29 0a 20 20 20 20 20 20 2a 2a held()). **
13c70 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 66 statements to f
13c80 69 6e 64 20 6c 6f 63 6b 69 6e 67 20 70 72 6f 62 ind locking prob
13c90 6c 65 6d 73 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 lems.. */.
13ca0 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 p->sharable
13cb0 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 = 1;. }.#end
13cc0 69 66 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 if. }.#endif.
13cd0 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 20 if( pBt==0 ){.
13ce0 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 /*. ** The
13cf0 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 following assert
13d00 73 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 s make sure that
13d10 20 73 74 72 75 63 74 75 72 65 73 20 75 73 65 64 structures used
13d20 20 62 79 20 74 68 65 20 62 74 72 65 65 20 61 72 by the btree ar
13d30 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 72 69 67 e. ** the rig
13d40 68 74 20 73 69 7a 65 2e 20 20 54 68 69 73 20 69 ht size. This i
13d50 73 20 74 6f 20 67 75 61 72 64 20 61 67 61 69 6e s to guard again
13d60 73 74 20 73 69 7a 65 20 63 68 61 6e 67 65 73 20 st size changes
13d70 74 68 61 74 20 72 65 73 75 6c 74 0a 20 20 20 20 that result.
13d80 2a 2a 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e ** when compilin
13d90 67 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e 74 g on a different
13da0 20 61 72 63 68 69 74 65 63 74 75 72 65 2e 0a 20 architecture..
13db0 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 */. assert
13dc0 28 20 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d 38 ( sizeof(i64)==8
13dd0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
13de0 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 29 sizeof(u64)==8 )
13df0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 ;. assert( si
13e00 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 3b 0a zeof(u32)==4 );.
13e10 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 assert( size
13e20 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a 20 20 of(u16)==2 );.
13e30 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
13e40 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 20 0a (Pgno)==4 );. .
13e50 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 74 65 pBt = sqlite
13e60 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 3MallocZero( siz
13e70 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 20 20 eof(*pBt) );.
13e80 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 if( pBt==0 ){.
13e90 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
13ea0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
13eb0 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 goto btree_op
13ec0 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 en_out;. }.
13ed0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
13ee0 67 65 72 4f 70 65 6e 28 70 56 66 73 2c 20 26 70 gerOpen(pVfs, &p
13ef0 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a 46 69 6c Bt->pPager, zFil
13f00 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 ename,.
13f10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13f20 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 sizeof(MemPage)
13f30 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 67 , flags, vfsFlag
13f40 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b 0a s, pageReinit);.
13f50 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
13f60 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 TE_OK ){. s
13f70 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d 6d qlite3PagerSetMm
13f80 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 61 apLimit(pBt->pPa
13f90 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 29 ger, db->szMmap)
13fa0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
13fb0 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 6c ite3PagerReadFil
13fc0 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 61 eheader(pBt->pPa
13fd0 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 65 ger,sizeof(zDbHe
13fe0 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 29 ader),zDbHeader)
13ff0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
14000 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
14010 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 65 . goto btre
14020 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 e_open_out;.
14030 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e 46 }. pBt->openF
14040 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 73 lags = (u8)flags
14050 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d 20 ;. pBt->db =
14060 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 db;. sqlite3P
14070 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 64 6c agerSetBusyhandl
14080 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 er(pBt->pPager,
14090 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 btreeInvokeBusyH
140a0 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 20 andler, pBt);.
140b0 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a p->pBt = pBt;.
140c0 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 72 . pBt->pCur
140d0 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 sor = 0;. pBt
140e0 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 ->pPage1 = 0;.
140f0 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 if( sqlite3Pag
14100 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 74 erIsreadonly(pBt
14110 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 2d ->pPager) ) pBt-
14120 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
14130 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 64 _READ_ONLY;.#ifd
14140 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 52 45 ef SQLITE_SECURE
14150 5f 44 45 4c 45 54 45 0a 20 20 20 20 70 42 74 2d _DELETE. pBt-
14160 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
14170 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a _SECURE_DELETE;.
14180 23 65 6e 64 69 66 0a 20 20 20 20 2f 2a 20 45 56 #endif. /* EV
14190 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 31 38 IDENCE-OF: R-518
141a0 37 33 2d 33 39 36 31 38 20 54 68 65 20 70 61 67 73-39618 The pag
141b0 65 20 73 69 7a 65 20 66 6f 72 20 61 20 64 61 74 e size for a dat
141c0 61 62 61 73 65 20 66 69 6c 65 20 69 73 0a 20 20 abase file is.
141d0 20 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 ** determined
141e0 62 79 20 74 68 65 20 32 2d 62 79 74 65 20 69 6e by the 2-byte in
141f0 74 65 67 65 72 20 6c 6f 63 61 74 65 64 20 61 74 teger located at
14200 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 20 31 36 an offset of 16
14210 20 62 79 74 65 73 20 66 72 6f 6d 0a 20 20 20 20 bytes from.
14220 2a 2a 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 ** the beginning
14230 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
14240 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 70 42 file. */. pB
14250 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 7a t->pageSize = (z
14260 44 62 48 65 61 64 65 72 5b 31 36 5d 3c 3c 38 29 DbHeader[16]<<8)
14270 20 7c 20 28 7a 44 62 48 65 61 64 65 72 5b 31 37 | (zDbHeader[17
14280 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 20 ]<<16);. if(
14290 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 35 31 pBt->pageSize<51
142a0 32 20 7c 7c 20 70 42 74 2d 3e 70 61 67 65 53 69 2 || pBt->pageSi
142b0 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 ze>SQLITE_MAX_PA
142c0 47 45 5f 53 49 5a 45 0a 20 20 20 20 20 20 20 20 GE_SIZE.
142d0 20 7c 7c 20 28 28 70 42 74 2d 3e 70 61 67 65 53 || ((pBt->pageS
142e0 69 7a 65 2d 31 29 26 70 42 74 2d 3e 70 61 67 65 ize-1)&pBt->page
142f0 53 69 7a 65 29 21 3d 30 20 29 7b 0a 20 20 20 20 Size)!=0 ){.
14300 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 pBt->pageSize
14310 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c = 0;.#ifndef SQL
14320 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
14330 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 UUM. /* If
14340 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 the magic name "
14350 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 6c 6c 20 63 :memory:" will c
14360 72 65 61 74 65 20 61 6e 20 69 6e 2d 6d 65 6d 6f reate an in-memo
14370 72 79 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 ry database, the
14380 6e 0a 20 20 20 20 20 20 2a 2a 20 6c 65 61 76 65 n. ** leave
14390 20 74 68 65 20 61 75 74 6f 56 61 63 75 75 6d 20 the autoVacuum
143a0 6d 6f 64 65 20 61 74 20 30 20 28 64 6f 20 6e 6f mode at 0 (do no
143b0 74 20 61 75 74 6f 2d 76 61 63 75 75 6d 29 2c 20 t auto-vacuum),
143c0 65 76 65 6e 20 69 66 0a 20 20 20 20 20 20 2a 2a even if. **
143d0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
143e0 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 74 72 AUTOVACUUM is tr
143f0 75 65 2e 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 ue. On the other
14400 20 68 61 6e 64 2c 20 69 66 0a 20 20 20 20 20 20 hand, if.
14410 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d ** SQLITE_OMIT_M
14420 45 4d 4f 52 59 44 42 20 68 61 73 20 62 65 65 6e EMORYDB has been
14430 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 22 defined, then "
14440 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 20 6a 75 73 :memory:" is jus
14450 74 20 61 0a 20 20 20 20 20 20 2a 2a 20 72 65 67 t a. ** reg
14460 75 6c 61 72 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 ular file-name.
14470 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
14480 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 61 70 70 auto-vacuum app
14490 6c 69 65 73 20 61 73 20 70 65 72 20 6e 6f 72 6d lies as per norm
144a0 61 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 al.. */.
144b0 20 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 if( zFilename
144c0 20 26 26 20 21 69 73 4d 65 6d 64 62 20 29 7b 0a && !isMemdb ){.
144d0 20 20 20 20 20 20 20 20 70 42 74 2d 3e 61 75 74 pBt->aut
144e0 6f 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 oVacuum = (SQLIT
144f0 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 E_DEFAULT_AUTOVA
14500 43 55 55 4d 20 3f 20 31 20 3a 20 30 29 3b 0a 20 CUUM ? 1 : 0);.
14510 20 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 pBt->incr
14520 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 Vacuum = (SQLITE
14530 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 _DEFAULT_AUTOVAC
14540 55 55 4d 3d 3d 32 20 3f 20 31 20 3a 20 30 29 3b UUM==2 ? 1 : 0);
14550 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a . }.#endif.
14560 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d nReserve =
14570 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 0;. }else{.
14580 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
14590 2d 4f 46 3a 20 52 2d 33 37 34 39 37 2d 34 32 34 -OF: R-37497-424
145a0 31 32 20 54 68 65 20 73 69 7a 65 20 6f 66 20 74 12 The size of t
145b0 68 65 20 72 65 73 65 72 76 65 64 20 72 65 67 69 he reserved regi
145c0 6f 6e 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 64 on is. ** d
145d0 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 etermined by the
145e0 20 6f 6e 65 2d 62 79 74 65 20 75 6e 73 69 67 6e one-byte unsign
145f0 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 6e 64 ed integer found
14600 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 at an offset of
14610 20 32 30 0a 20 20 20 20 20 20 2a 2a 20 69 6e 74 20. ** int
14620 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 o the database f
14630 69 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 ile header. */.
14640 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d 20 nReserve =
14650 7a 44 62 48 65 61 64 65 72 5b 32 30 5d 3b 0a 20 zDbHeader[20];.
14660 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
14670 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 gs |= BTS_PAGESI
14680 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 ZE_FIXED;.#ifnde
14690 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
146a0 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 70 TOVACUUM. p
146b0 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d Bt->autoVacuum =
146c0 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 48 (get4byte(&zDbH
146d0 65 61 64 65 72 5b 33 36 20 2b 20 34 2a 34 5d 29 eader[36 + 4*4])
146e0 3f 31 3a 30 29 3b 0a 20 20 20 20 20 20 70 42 74 ?1:0);. pBt
146f0 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 ->incrVacuum = (
14700 67 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 61 get4byte(&zDbHea
14710 64 65 72 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 der[36 + 7*4])?1
14720 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 :0);.#endif.
14730 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
14740 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 e3PagerSetPagesi
14750 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 ze(pBt->pPager,
14760 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 &pBt->pageSize,
14770 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 20 20 69 nReserve);. i
14780 66 28 20 72 63 20 29 20 67 6f 74 6f 20 62 74 72 f( rc ) goto btr
14790 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
147a0 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
147b0 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 = pBt->pageSize
147c0 20 2d 20 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 - nReserve;.
147d0 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e 70 assert( (pBt->p
147e0 61 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 ageSize & 7)==0
147f0 29 3b 20 20 2f 2a 20 38 2d 62 79 74 65 20 61 6c ); /* 8-byte al
14800 69 67 6e 6d 65 6e 74 20 6f 66 20 70 61 67 65 53 ignment of pageS
14810 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 69 66 20 21 ize */. .#if !
14820 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
14830 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
14840 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
14850 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f LITE_OMIT_DISKIO
14860 29 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 ). /* Add the
14870 20 6e 65 77 20 42 74 53 68 61 72 65 64 20 6f 62 new BtShared ob
14880 6a 65 63 74 20 74 6f 20 74 68 65 20 6c 69 6e 6b ject to the link
14890 65 64 20 6c 69 73 74 20 73 68 61 72 61 62 6c 65 ed list sharable
148a0 20 42 74 53 68 61 72 65 64 73 2e 0a 20 20 20 20 BtShareds..
148b0 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 6e 52 65 66 */. pBt->nRef
148c0 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 70 2d = 1;. if( p-
148d0 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 >sharable ){.
148e0 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
148f0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
14900 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 20 20 utexShared; ).
14910 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 MUTEX_LOGIC(
14920 20 6d 75 74 65 78 53 68 61 72 65 64 20 3d 20 73 mutexShared = s
14930 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
14940 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 (SQLITE_MUTEX_ST
14950 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 29 0a 20 ATIC_MASTER);).
14960 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f if( SQLITE_
14970 54 48 52 45 41 44 53 41 46 45 20 26 26 20 73 71 THREADSAFE && sq
14980 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
14990 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a g.bCoreMutex ){.
149a0 20 20 20 20 20 20 20 20 70 42 74 2d 3e 6d 75 74 pBt->mut
149b0 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 ex = sqlite3Mute
149c0 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
149d0 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 20 TEX_FAST);.
149e0 20 20 20 69 66 28 20 70 42 74 2d 3e 6d 75 74 65 if( pBt->mute
149f0 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 x==0 ){.
14a00 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
14a10 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 MEM_BKPT;.
14a20 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f goto btree_o
14a30 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 pen_out;.
14a40 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
14a50 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
14a60 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 nter(mutexShared
14a70 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 4e );. pBt->pN
14a80 65 78 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 53 ext = GLOBAL(BtS
14a90 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
14aa0 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b 0a aredCacheList);.
14ab0 20 20 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 53 GLOBAL(BtS
14ac0 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
14ad0 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 20 3d aredCacheList) =
14ae0 20 70 42 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 pBt;. sqli
14af0 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
14b00 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 mutexShared);.
14b10 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a }.#endif. }..
14b20 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
14b30 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
14b40 43 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e CACHE) && !defin
14b50 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ed(SQLITE_OMIT_D
14b60 49 53 4b 49 4f 29 0a 20 20 2f 2a 20 49 66 20 74 ISKIO). /* If t
14b70 68 65 20 6e 65 77 20 42 74 72 65 65 20 75 73 65 he new Btree use
14b80 73 20 61 20 73 68 61 72 61 62 6c 65 20 70 42 74 s a sharable pBt
14b90 53 68 61 72 65 64 2c 20 74 68 65 6e 20 6c 69 6e Shared, then lin
14ba0 6b 20 74 68 65 20 6e 65 77 0a 20 20 2a 2a 20 42 k the new. ** B
14bb0 74 72 65 65 20 69 6e 74 6f 20 74 68 65 20 6c 69 tree into the li
14bc0 73 74 20 6f 66 20 61 6c 6c 20 73 68 61 72 61 62 st of all sharab
14bd0 6c 65 20 42 74 72 65 65 73 20 66 6f 72 20 74 68 le Btrees for th
14be0 65 20 73 61 6d 65 20 63 6f 6e 6e 65 63 74 69 6f e same connectio
14bf0 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6c 69 73 74 n.. ** The list
14c00 20 69 73 20 6b 65 70 74 20 69 6e 20 61 73 63 65 is kept in asce
14c10 6e 64 69 6e 67 20 6f 72 64 65 72 20 62 79 20 70 nding order by p
14c20 42 74 20 61 64 64 72 65 73 73 2e 0a 20 20 2a 2f Bt address.. */
14c30 0a 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 62 . if( p->sharab
14c40 6c 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b le ){. int i;
14c50 0a 20 20 20 20 42 74 72 65 65 20 2a 70 53 69 62 . Btree *pSib
14c60 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 ;. for(i=0; i
14c70 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a <db->nDb; i++){.
14c80 20 20 20 20 20 20 69 66 28 20 28 70 53 69 62 20 if( (pSib
14c90 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 = db->aDb[i].pBt
14ca0 29 21 3d 30 20 26 26 20 70 53 69 62 2d 3e 73 68 )!=0 && pSib->sh
14cb0 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 arable ){.
14cc0 20 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 while( pSib->p
14cd0 50 72 65 76 20 29 7b 20 70 53 69 62 20 3d 20 70 Prev ){ pSib = p
14ce0 53 69 62 2d 3e 70 50 72 65 76 3b 20 7d 0a 20 20 Sib->pPrev; }.
14cf0 20 20 20 20 20 20 69 66 28 20 28 75 70 74 72 29 if( (uptr)
14d00 70 2d 3e 70 42 74 3c 28 75 70 74 72 29 70 53 69 p->pBt<(uptr)pSi
14d10 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 b->pBt ){.
14d20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 p->pNext = p
14d30 53 69 62 3b 0a 20 20 20 20 20 20 20 20 20 20 70 Sib;. p
14d40 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 ->pPrev = 0;.
14d50 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 50 72 pSib->pPr
14d60 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 ev = p;.
14d70 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
14d80 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 4e while( pSib->pN
14d90 65 78 74 20 26 26 20 28 75 70 74 72 29 70 53 69 ext && (uptr)pSi
14da0 62 2d 3e 70 4e 65 78 74 2d 3e 70 42 74 3c 28 75 b->pNext->pBt<(u
14db0 70 74 72 29 70 2d 3e 70 42 74 20 29 7b 0a 20 20 ptr)p->pBt ){.
14dc0 20 20 20 20 20 20 20 20 20 20 70 53 69 62 20 3d pSib =
14dd0 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 20 pSib->pNext;.
14de0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
14df0 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 p->pNext = p
14e00 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 Sib->pNext;.
14e10 20 20 20 20 20 20 70 2d 3e 70 50 72 65 76 20 3d p->pPrev =
14e20 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 20 20 pSib;.
14e30 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 7b if( p->pNext ){
14e40 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e . p->
14e50 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 pNext->pPrev = p
14e60 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
14e70 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 4e pSib->pN
14e80 65 78 74 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 ext = p;.
14e90 20 7d 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b }. break
14ea0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
14eb0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 }.#endif. *pp
14ec0 42 74 72 65 65 20 3d 20 70 3b 0a 0a 62 74 72 65 Btree = p;..btre
14ed0 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a 20 20 69 66 e_open_out:. if
14ee0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
14ef0 29 7b 0a 20 20 20 20 69 66 28 20 70 42 74 20 26 ){. if( pBt &
14f00 26 20 70 42 74 2d 3e 70 50 61 67 65 72 20 29 7b & pBt->pPager ){
14f10 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
14f20 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e 70 50 gerClose(pBt->pP
14f30 61 67 65 72 2c 20 30 29 3b 0a 20 20 20 20 7d 0a ager, 0);. }.
14f40 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
14f50 28 70 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 (pBt);. sqlit
14f60 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 e3_free(p);.
14f70 2a 70 70 42 74 72 65 65 20 3d 20 30 3b 0a 20 20 *ppBtree = 0;.
14f80 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 }else{. sqlit
14f90 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 3b 0a e3_file *pFile;.
14fa0 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 42 . /* If the B
14fb0 2d 54 72 65 65 20 77 61 73 20 73 75 63 63 65 73 -Tree was succes
14fc0 73 66 75 6c 6c 79 20 6f 70 65 6e 65 64 2c 20 73 sfully opened, s
14fd0 65 74 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 et the pager-cac
14fe0 68 65 20 73 69 7a 65 20 74 6f 20 74 68 65 0a 20 he size to the.
14ff0 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 20 76 61 ** default va
15000 6c 75 65 2e 20 45 78 63 65 70 74 2c 20 77 68 65 lue. Except, whe
15010 6e 20 6f 70 65 6e 69 6e 67 20 6f 6e 20 61 6e 20 n opening on an
15020 65 78 69 73 74 69 6e 67 20 73 68 61 72 65 64 20 existing shared
15030 70 61 67 65 72 2d 63 61 63 68 65 2c 0a 20 20 20 pager-cache,.
15040 20 2a 2a 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 ** do not chang
15050 65 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 68 e the pager-cach
15060 65 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 e size.. */.
15070 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 74 if( sqlite3Bt
15080 72 65 65 53 63 68 65 6d 61 28 70 2c 20 30 2c 20 reeSchema(p, 0,
15090 30 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 0)==0 ){. s
150a0 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 61 qlite3PagerSetCa
150b0 63 68 65 73 69 7a 65 28 70 2d 3e 70 42 74 2d 3e chesize(p->pBt->
150c0 70 50 61 67 65 72 2c 20 53 51 4c 49 54 45 5f 44 pPager, SQLITE_D
150d0 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a EFAULT_CACHE_SIZ
150e0 45 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 E);. }.. p
150f0 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 50 61 File = sqlite3Pa
15100 67 65 72 46 69 6c 65 28 70 42 74 2d 3e 70 50 61 gerFile(pBt->pPa
15110 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 70 46 ger);. if( pF
15120 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b ile->pMethods ){
15130 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 . sqlite3Os
15140 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 FileControlHint(
15150 70 46 69 6c 65 2c 20 53 51 4c 49 54 45 5f 46 43 pFile, SQLITE_FC
15160 4e 54 4c 5f 50 44 42 2c 20 28 76 6f 69 64 2a 29 NTL_PDB, (void*)
15170 26 70 42 74 2d 3e 64 62 29 3b 0a 20 20 20 20 7d &pBt->db);. }
15180 0a 20 20 7d 0a 20 20 69 66 28 20 6d 75 74 65 78 . }. if( mutex
15190 4f 70 65 6e 20 29 7b 0a 20 20 20 20 61 73 73 65 Open ){. asse
151a0 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
151b0 78 5f 68 65 6c 64 28 6d 75 74 65 78 4f 70 65 6e x_held(mutexOpen
151c0 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) );. sqlite3
151d0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 _mutex_leave(mut
151e0 65 78 4f 70 65 6e 29 3b 0a 20 20 7d 0a 20 20 61 exOpen);. }. a
151f0 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
15200 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 74 65 33 42 E_OK || sqlite3B
15210 74 72 65 65 43 6f 6e 6e 65 63 74 69 6f 6e 43 6f treeConnectionCo
15220 75 6e 74 28 2a 70 70 42 74 72 65 65 29 3e 30 20 unt(*ppBtree)>0
15230 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
15240 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 72 65 6d 65 }../*.** Decreme
15250 6e 74 20 74 68 65 20 42 74 53 68 61 72 65 64 2e nt the BtShared.
15260 6e 52 65 66 20 63 6f 75 6e 74 65 72 2e 20 20 57 nRef counter. W
15270 68 65 6e 20 69 74 20 72 65 61 63 68 65 73 20 7a hen it reaches z
15280 65 72 6f 2c 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 ero,.** remove t
15290 68 65 20 42 74 53 68 61 72 65 64 20 73 74 72 75 he BtShared stru
152a0 63 74 75 72 65 20 66 72 6f 6d 20 74 68 65 20 73 cture from the s
152b0 68 61 72 69 6e 67 20 6c 69 73 74 2e 20 20 52 65 haring list. Re
152c0 74 75 72 6e 0a 2a 2a 20 74 72 75 65 20 69 66 20 turn.** true if
152d0 74 68 65 20 42 74 53 68 61 72 65 64 2e 6e 52 65 the BtShared.nRe
152e0 66 20 63 6f 75 6e 74 65 72 20 72 65 61 63 68 65 f counter reache
152f0 73 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 s zero and retur
15300 6e 0a 2a 2a 20 66 61 6c 73 65 20 69 66 20 69 74 n.** false if it
15310 20 69 73 20 73 74 69 6c 6c 20 70 6f 73 69 74 69 is still positi
15320 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ve..*/.static in
15330 74 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 72 t removeFromShar
15340 69 6e 67 4c 69 73 74 28 42 74 53 68 61 72 65 64 ingList(BtShared
15350 20 2a 70 42 74 29 7b 0a 23 69 66 6e 64 65 66 20 *pBt){.#ifndef
15360 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
15370 45 44 5f 43 41 43 48 45 0a 20 20 4d 55 54 45 58 ED_CACHE. MUTEX
15380 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 5f _LOGIC( sqlite3_
15390 6d 75 74 65 78 20 2a 70 4d 61 73 74 65 72 3b 20 mutex *pMaster;
153a0 29 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 4c ). BtShared *pL
153b0 69 73 74 3b 0a 20 20 69 6e 74 20 72 65 6d 6f 76 ist;. int remov
153c0 65 64 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 ed = 0;.. asser
153d0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
153e0 5f 6e 6f 74 68 65 6c 64 28 70 42 74 2d 3e 6d 75 _notheld(pBt->mu
153f0 74 65 78 29 20 29 3b 0a 20 20 4d 55 54 45 58 5f tex) );. MUTEX_
15400 4c 4f 47 49 43 28 20 70 4d 61 73 74 65 72 20 3d LOGIC( pMaster =
15410 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c sqlite3MutexAll
15420 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
15430 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 20 STATIC_MASTER);
15440 29 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ). sqlite3_mute
15450 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 x_enter(pMaster)
15460 3b 0a 20 20 70 42 74 2d 3e 6e 52 65 66 2d 2d 3b ;. pBt->nRef--;
15470 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 52 65 66 . if( pBt->nRef
15480 3c 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 47 <=0 ){. if( G
15490 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c LOBAL(BtShared*,
154a0 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 sqlite3SharedCac
154b0 68 65 4c 69 73 74 29 3d 3d 70 42 74 20 29 7b 0a heList)==pBt ){.
154c0 20 20 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 53 GLOBAL(BtS
154d0 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
154e0 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 20 3d aredCacheList) =
154f0 20 70 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 pBt->pNext;.
15500 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4c }else{. pL
15510 69 73 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 53 ist = GLOBAL(BtS
15520 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
15530 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b 0a aredCacheList);.
15540 20 20 20 20 20 20 77 68 69 6c 65 28 20 41 4c 57 while( ALW
15550 41 59 53 28 70 4c 69 73 74 29 20 26 26 20 70 4c AYS(pList) && pL
15560 69 73 74 2d 3e 70 4e 65 78 74 21 3d 70 42 74 20 ist->pNext!=pBt
15570 29 7b 0a 20 20 20 20 20 20 20 20 70 4c 69 73 74 ){. pList
15580 3d 70 4c 69 73 74 2d 3e 70 4e 65 78 74 3b 0a 20 =pList->pNext;.
15590 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 }. if(
155a0 20 41 4c 57 41 59 53 28 70 4c 69 73 74 29 20 29 ALWAYS(pList) )
155b0 7b 0a 20 20 20 20 20 20 20 20 70 4c 69 73 74 2d {. pList-
155c0 3e 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4e >pNext = pBt->pN
155d0 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ext;. }.
155e0 20 7d 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 }. if( SQLIT
155f0 45 5f 54 48 52 45 41 44 53 41 46 45 20 29 7b 0a E_THREADSAFE ){.
15600 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
15610 74 65 78 5f 66 72 65 65 28 70 42 74 2d 3e 6d 75 tex_free(pBt->mu
15620 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 tex);. }.
15630 72 65 6d 6f 76 65 64 20 3d 20 31 3b 0a 20 20 7d removed = 1;. }
15640 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
15650 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b _leave(pMaster);
15660 0a 20 20 72 65 74 75 72 6e 20 72 65 6d 6f 76 65 . return remove
15670 64 3b 0a 23 65 6c 73 65 0a 20 20 72 65 74 75 72 d;.#else. retur
15680 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f n 1;.#endif.}../
15690 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 70 *.** Make sure p
156a0 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 70 6f Bt->pTmpSpace po
156b0 69 6e 74 73 20 74 6f 20 61 6e 20 61 6c 6c 6f 63 ints to an alloc
156c0 61 74 69 6f 6e 20 6f 66 20 0a 2a 2a 20 4d 58 5f ation of .** MX_
156d0 43 45 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 62 CELL_SIZE(pBt) b
156e0 79 74 65 73 20 77 69 74 68 20 61 20 34 2d 62 79 ytes with a 4-by
156f0 74 65 20 70 72 65 66 69 78 20 66 6f 72 20 61 20 te prefix for a
15700 6c 65 66 74 2d 63 68 69 6c 64 0a 2a 2a 20 70 6f left-child.** po
15710 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 inter..*/.static
15720 20 76 6f 69 64 20 61 6c 6c 6f 63 61 74 65 54 65 void allocateTe
15730 6d 70 53 70 61 63 65 28 42 74 53 68 61 72 65 64 mpSpace(BtShared
15740 20 2a 70 42 74 29 7b 0a 20 20 69 66 28 20 21 70 *pBt){. if( !p
15750 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 29 7b Bt->pTmpSpace ){
15760 0a 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 . pBt->pTmpSp
15770 61 63 65 20 3d 20 73 71 6c 69 74 65 33 50 61 67 ace = sqlite3Pag
15780 65 4d 61 6c 6c 6f 63 28 20 70 42 74 2d 3e 70 61 eMalloc( pBt->pa
15790 67 65 53 69 7a 65 20 29 3b 0a 0a 20 20 20 20 2f geSize );.. /
157a0 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 75 73 65 * One of the use
157b0 73 20 6f 66 20 70 42 74 2d 3e 70 54 6d 70 53 70 s of pBt->pTmpSp
157c0 61 63 65 20 69 73 20 74 6f 20 66 6f 72 6d 61 74 ace is to format
157d0 20 63 65 6c 6c 73 20 62 65 66 6f 72 65 0a 20 20 cells before.
157e0 20 20 2a 2a 20 69 6e 73 65 72 74 69 6e 67 20 74 ** inserting t
157f0 68 65 6d 20 69 6e 74 6f 20 61 20 6c 65 61 66 20 hem into a leaf
15800 70 61 67 65 20 28 66 75 6e 63 74 69 6f 6e 20 66 page (function f
15810 69 6c 6c 49 6e 43 65 6c 6c 28 29 29 2e 20 49 66 illInCell()). If
15820 0a 20 20 20 20 2a 2a 20 61 20 63 65 6c 6c 20 69 . ** a cell i
15830 73 20 6c 65 73 73 20 74 68 61 6e 20 34 20 62 79 s less than 4 by
15840 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 69 74 20 tes in size, it
15850 69 73 20 72 6f 75 6e 64 65 64 20 75 70 20 74 6f is rounded up to
15860 20 34 20 62 79 74 65 73 0a 20 20 20 20 2a 2a 20 4 bytes. **
15870 62 79 20 74 68 65 20 76 61 72 69 6f 75 73 20 72 by the various r
15880 6f 75 74 69 6e 65 73 20 74 68 61 74 20 6d 61 6e outines that man
15890 69 70 75 6c 61 74 65 20 62 69 6e 61 72 79 20 63 ipulate binary c
158a0 65 6c 6c 73 2e 20 57 68 69 63 68 0a 20 20 20 20 ells. Which.
158b0 2a 2a 20 63 61 6e 20 6d 65 61 6e 20 74 68 61 74 ** can mean that
158c0 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f 6e fillInCell() on
158d0 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 ly initializes t
158e0 68 65 20 66 69 72 73 74 20 32 20 6f 72 20 33 0a he first 2 or 3.
158f0 20 20 20 20 2a 2a 20 62 79 74 65 73 20 6f 66 20 ** bytes of
15900 70 54 6d 70 53 70 61 63 65 2c 20 62 75 74 20 74 pTmpSpace, but t
15910 68 61 74 20 74 68 65 20 66 69 72 73 74 20 34 20 hat the first 4
15920 62 79 74 65 73 20 61 72 65 20 63 6f 70 69 65 64 bytes are copied
15930 20 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 69 74 20 from. ** it
15940 69 6e 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 into a database
15950 70 61 67 65 2e 20 54 68 69 73 20 69 73 20 6e 6f page. This is no
15960 74 20 61 63 74 75 61 6c 6c 79 20 61 20 70 72 6f t actually a pro
15970 62 6c 65 6d 2c 20 62 75 74 20 69 74 0a 20 20 20 blem, but it.
15980 20 2a 2a 20 64 6f 65 73 20 63 61 75 73 65 20 61 ** does cause a
15990 20 76 61 6c 67 72 69 6e 64 20 65 72 72 6f 72 20 valgrind error
159a0 77 68 65 6e 20 74 68 65 20 31 20 6f 72 20 32 20 when the 1 or 2
159b0 62 79 74 65 73 20 6f 66 20 75 6e 69 74 69 61 6c bytes of unitial
159c0 69 7a 65 64 20 0a 20 20 20 20 2a 2a 20 64 61 74 ized . ** dat
159d0 61 20 69 73 20 70 61 73 73 65 64 20 74 6f 20 73 a is passed to s
159e0 79 73 74 65 6d 20 63 61 6c 6c 20 77 72 69 74 65 ystem call write
159f0 28 29 2e 20 53 6f 20 74 6f 20 61 76 6f 69 64 20 (). So to avoid
15a00 74 68 69 73 20 65 72 72 6f 72 2c 0a 20 20 20 20 this error,.
15a10 2a 2a 20 7a 65 72 6f 20 74 68 65 20 66 69 72 73 ** zero the firs
15a20 74 20 34 20 62 79 74 65 73 20 6f 66 20 74 65 6d t 4 bytes of tem
15a30 70 20 73 70 61 63 65 20 68 65 72 65 2e 0a 20 20 p space here..
15a40 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c 73 6f **. ** Also
15a50 3a 20 20 50 72 6f 76 69 64 65 20 66 6f 75 72 20 : Provide four
15a60 62 79 74 65 73 20 6f 66 20 69 6e 69 74 69 61 6c bytes of initial
15a70 69 7a 65 64 20 73 70 61 63 65 20 62 65 66 6f 72 ized space befor
15a80 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 62 65 67 e the. ** beg
15a90 69 6e 6e 69 6e 67 20 6f 66 20 70 54 6d 70 53 70 inning of pTmpSp
15aa0 61 63 65 20 61 73 20 61 6e 20 61 72 65 61 20 61 ace as an area a
15ab0 76 61 69 6c 61 62 6c 65 20 74 6f 20 70 72 65 70 vailable to prep
15ac0 65 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 6c end the. ** l
15ad0 65 66 74 2d 63 68 69 6c 64 20 70 6f 69 6e 74 65 eft-child pointe
15ae0 72 20 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 r to the beginni
15af0 6e 67 20 6f 66 20 61 20 63 65 6c 6c 2e 0a 20 20 ng of a cell..
15b00 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 42 74 */. if( pBt
15b10 2d 3e 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 ->pTmpSpace ){.
15b20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 42 74 2d memset(pBt-
15b30 3e 70 54 6d 70 53 70 61 63 65 2c 20 30 2c 20 38 >pTmpSpace, 0, 8
15b40 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 54 );. pBt->pT
15b50 6d 70 53 70 61 63 65 20 2b 3d 20 34 3b 0a 20 20 mpSpace += 4;.
15b60 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
15b70 20 46 72 65 65 20 74 68 65 20 70 42 74 2d 3e 70 Free the pBt->p
15b80 54 6d 70 53 70 61 63 65 20 61 6c 6c 6f 63 61 74 TmpSpace allocat
15b90 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ion.*/.static vo
15ba0 69 64 20 66 72 65 65 54 65 6d 70 53 70 61 63 65 id freeTempSpace
15bb0 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
15bc0 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 54 6d 70 . if( pBt->pTmp
15bd0 53 70 61 63 65 20 29 7b 0a 20 20 20 20 70 42 74 Space ){. pBt
15be0 2d 3e 70 54 6d 70 53 70 61 63 65 20 2d 3d 20 34 ->pTmpSpace -= 4
15bf0 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 ;. sqlite3Pag
15c00 65 46 72 65 65 28 70 42 74 2d 3e 70 54 6d 70 53 eFree(pBt->pTmpS
15c10 70 61 63 65 29 3b 0a 20 20 20 20 70 42 74 2d 3e pace);. pBt->
15c20 70 54 6d 70 53 70 61 63 65 20 3d 20 30 3b 0a 20 pTmpSpace = 0;.
15c30 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 }.}../*.** Clos
15c40 65 20 61 6e 20 6f 70 65 6e 20 64 61 74 61 62 61 e an open databa
15c50 73 65 20 61 6e 64 20 69 6e 76 61 6c 69 64 61 74 se and invalidat
15c60 65 20 61 6c 6c 20 63 75 72 73 6f 72 73 2e 0a 2a e all cursors..*
15c70 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
15c80 65 65 43 6c 6f 73 65 28 42 74 72 65 65 20 2a 70 eeClose(Btree *p
15c90 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
15ca0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 Bt = p->pBt;. B
15cb0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a 0a tCursor *pCur;..
15cc0 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 63 /* Close all c
15cd0 75 72 73 6f 72 73 20 6f 70 65 6e 65 64 20 76 69 ursors opened vi
15ce0 61 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 20 20 a this handle.
15cf0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c */. assert( sql
15d00 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
15d10 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b p->db->mutex) );
15d20 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
15d30 6e 74 65 72 28 70 29 3b 0a 20 20 70 43 75 72 20 nter(p);. pCur
15d40 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
15d50 20 20 77 68 69 6c 65 28 20 70 43 75 72 20 29 7b while( pCur ){
15d60 0a 20 20 20 20 42 74 43 75 72 73 6f 72 20 2a 70 . BtCursor *p
15d70 54 6d 70 20 3d 20 70 43 75 72 3b 0a 20 20 20 20 Tmp = pCur;.
15d80 70 43 75 72 20 3d 20 70 43 75 72 2d 3e 70 4e 65 pCur = pCur->pNe
15d90 78 74 3b 0a 20 20 20 20 69 66 28 20 70 54 6d 70 xt;. if( pTmp
15da0 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 7b 0a 20 ->pBtree==p ){.
15db0 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
15dc0 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70 54 6d eCloseCursor(pTm
15dd0 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 p);. }. }..
15de0 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6e 79 /* Rollback any
15df0 20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 active transact
15e00 69 6f 6e 20 61 6e 64 20 66 72 65 65 20 74 68 65 ion and free the
15e10 20 68 61 6e 64 6c 65 20 73 74 72 75 63 74 75 72 handle structur
15e20 65 2e 0a 20 20 2a 2a 20 54 68 65 20 63 61 6c 6c e.. ** The call
15e30 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 to sqlite3Btree
15e40 52 6f 6c 6c 62 61 63 6b 28 29 20 64 72 6f 70 73 Rollback() drops
15e50 20 61 6e 79 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 any table-locks
15e60 20 68 65 6c 64 20 62 79 0a 20 20 2a 2a 20 74 68 held by. ** th
15e70 69 73 20 68 61 6e 64 6c 65 2e 0a 20 20 2a 2f 0a is handle.. */.
15e80 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f sqlite3BtreeRo
15e90 6c 6c 62 61 63 6b 28 70 2c 20 53 51 4c 49 54 45 llback(p, SQLITE
15ea0 5f 4f 4b 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 _OK, 0);. sqlit
15eb0 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
15ec0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 .. /* If there
15ed0 61 72 65 20 73 74 69 6c 6c 20 6f 74 68 65 72 20 are still other
15ee0 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 outstanding refe
15ef0 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 73 68 rences to the sh
15f00 61 72 65 64 2d 62 74 72 65 65 0a 20 20 2a 2a 20 ared-btree. **
15f10 73 74 72 75 63 74 75 72 65 2c 20 72 65 74 75 72 structure, retur
15f20 6e 20 6e 6f 77 2e 20 54 68 65 20 72 65 6d 61 69 n now. The remai
15f30 6e 64 65 72 20 6f 66 20 74 68 69 73 20 70 72 6f nder of this pro
15f40 63 65 64 75 72 65 20 63 6c 65 61 6e 73 20 0a 20 cedure cleans .
15f50 20 2a 2a 20 75 70 20 74 68 65 20 73 68 61 72 65 ** up the share
15f60 64 2d 62 74 72 65 65 2e 0a 20 20 2a 2f 0a 20 20 d-btree.. */.
15f70 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e 74 54 assert( p->wantT
15f80 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 70 2d 3e 6c oLock==0 && p->l
15f90 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 69 66 ocked==0 );. if
15fa0 28 20 21 70 2d 3e 73 68 61 72 61 62 6c 65 20 7c ( !p->sharable |
15fb0 7c 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 72 | removeFromShar
15fc0 69 6e 67 4c 69 73 74 28 70 42 74 29 20 29 7b 0a ingList(pBt) ){.
15fd0 20 20 20 20 2f 2a 20 54 68 65 20 70 42 74 20 69 /* The pBt i
15fe0 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6f 6e 20 74 s no longer on t
15ff0 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 2c he sharing list,
16000 20 73 6f 20 77 65 20 63 61 6e 20 61 63 63 65 73 so we can acces
16010 73 0a 20 20 20 20 2a 2a 20 69 74 20 77 69 74 68 s. ** it with
16020 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 68 6f out having to ho
16030 6c 64 20 74 68 65 20 6d 75 74 65 78 2e 0a 20 20 ld the mutex..
16040 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 6c 65 61 **. ** Clea
16050 6e 20 6f 75 74 20 61 6e 64 20 64 65 6c 65 74 65 n out and delete
16060 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6f 62 the BtShared ob
16070 6a 65 63 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ject.. */.
16080 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e 70 assert( !pBt->p
16090 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 20 73 71 Cursor );. sq
160a0 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 28 lite3PagerClose(
160b0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 2d 3e pBt->pPager, p->
160c0 64 62 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 db);. if( pBt
160d0 2d 3e 78 46 72 65 65 53 63 68 65 6d 61 20 26 26 ->xFreeSchema &&
160e0 20 70 42 74 2d 3e 70 53 63 68 65 6d 61 20 29 7b pBt->pSchema ){
160f0 0a 20 20 20 20 20 20 70 42 74 2d 3e 78 46 72 65 . pBt->xFre
16100 65 53 63 68 65 6d 61 28 70 42 74 2d 3e 70 53 63 eSchema(pBt->pSc
16110 68 65 6d 61 29 3b 0a 20 20 20 20 7d 0a 20 20 20 hema);. }.
16120 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 30 sqlite3DbFree(0
16130 2c 20 70 42 74 2d 3e 70 53 63 68 65 6d 61 29 3b , pBt->pSchema);
16140 0a 20 20 20 20 66 72 65 65 54 65 6d 70 53 70 61 . freeTempSpa
16150 63 65 28 70 42 74 29 3b 0a 20 20 20 20 73 71 6c ce(pBt);. sql
16160 69 74 65 33 5f 66 72 65 65 28 70 42 74 29 3b 0a ite3_free(pBt);.
16170 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c }..#ifndef SQL
16180 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
16190 43 41 43 48 45 0a 20 20 61 73 73 65 72 74 28 20 CACHE. assert(
161a0 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 p->wantToLock==0
161b0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d );. assert( p-
161c0 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 >locked==0 );.
161d0 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29 20 70 if( p->pPrev ) p
161e0 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d ->pPrev->pNext =
161f0 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 69 66 28 p->pNext;. if(
16200 20 70 2d 3e 70 4e 65 78 74 20 29 20 70 2d 3e 70 p->pNext ) p->p
16210 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 2d Next->pPrev = p-
16220 3e 70 50 72 65 76 3b 0a 23 65 6e 64 69 66 0a 0a >pPrev;.#endif..
16230 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
16240 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
16250 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
16260 43 68 61 6e 67 65 20 74 68 65 20 22 73 6f 66 74 Change the "soft
16270 22 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 6e " limit on the n
16280 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 umber of pages i
16290 6e 20 74 68 65 20 63 61 63 68 65 2e 0a 2a 2a 20 n the cache..**
162a0 55 6e 75 73 65 64 20 61 6e 64 20 75 6e 6d 6f 64 Unused and unmod
162b0 69 66 69 65 64 20 70 61 67 65 73 20 77 69 6c 6c ified pages will
162c0 20 62 65 20 72 65 63 79 63 6c 65 64 20 77 68 65 be recycled whe
162d0 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a n the number of.
162e0 2a 2a 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 ** pages in the
162f0 63 61 63 68 65 20 65 78 63 65 65 64 73 20 74 68 cache exceeds th
16300 69 73 20 73 6f 66 74 20 6c 69 6d 69 74 2e 20 20 is soft limit.
16310 42 75 74 20 74 68 65 20 73 69 7a 65 20 6f 66 20 But the size of
16320 74 68 65 0a 2a 2a 20 63 61 63 68 65 20 69 73 20 the.** cache is
16330 61 6c 6c 6f 77 65 64 20 74 6f 20 67 72 6f 77 20 allowed to grow
16340 6c 61 72 67 65 72 20 74 68 61 6e 20 74 68 69 73 larger than this
16350 20 6c 69 6d 69 74 20 69 66 20 69 74 20 63 6f 6e limit if it con
16360 74 61 69 6e 73 0a 2a 2a 20 64 69 72 74 79 20 70 tains.** dirty p
16370 61 67 65 73 20 6f 72 20 70 61 67 65 73 20 73 74 ages or pages st
16380 69 6c 6c 20 69 6e 20 61 63 74 69 76 65 20 75 73 ill in active us
16390 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
163a0 33 42 74 72 65 65 53 65 74 43 61 63 68 65 53 69 3BtreeSetCacheSi
163b0 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 ze(Btree *p, int
163c0 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 74 53 68 mxPage){. BtSh
163d0 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
163e0 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 Bt;. assert( sq
163f0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
16400 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 (p->db->mutex) )
16410 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
16420 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 Enter(p);. sqli
16430 74 65 33 50 61 67 65 72 53 65 74 43 61 63 68 65 te3PagerSetCache
16440 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 size(pBt->pPager
16450 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 6c , mxPage);. sql
16460 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
16470 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
16480 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
16490 43 68 61 6e 67 65 20 74 68 65 20 22 73 70 69 6c Change the "spil
164a0 6c 22 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 l" limit on the
164b0 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
164c0 69 6e 20 74 68 65 20 63 61 63 68 65 2e 0a 2a 2a in the cache..**
164d0 20 49 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f If the number o
164e0 66 20 70 61 67 65 73 20 65 78 63 65 65 64 73 20 f pages exceeds
164f0 74 68 69 73 20 6c 69 6d 69 74 20 64 75 72 69 6e this limit durin
16500 67 20 61 20 77 72 69 74 65 20 74 72 61 6e 73 61 g a write transa
16510 63 74 69 6f 6e 2c 0a 2a 2a 20 74 68 65 20 70 61 ction,.** the pa
16520 67 65 72 20 6d 69 67 68 74 20 61 74 74 65 6d 70 ger might attemp
16530 74 20 74 6f 20 22 73 70 69 6c 6c 22 20 70 61 67 t to "spill" pag
16540 65 73 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 es to the journa
16550 6c 20 65 61 72 6c 79 20 69 6e 0a 2a 2a 20 6f 72 l early in.** or
16560 64 65 72 20 74 6f 20 66 72 65 65 20 75 70 20 6d der to free up m
16570 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 emory..**.** The
16580 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 value returned
16590 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 is the current s
165a0 70 69 6c 6c 20 73 69 7a 65 2e 20 20 49 66 20 7a pill size. If z
165b0 65 72 6f 20 69 73 20 70 61 73 73 65 64 0a 2a 2a ero is passed.**
165c0 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2c as an argument,
165d0 20 6e 6f 20 63 68 61 6e 67 65 73 20 61 72 65 20 no changes are
165e0 6d 61 64 65 20 74 6f 20 74 68 65 20 73 70 69 6c made to the spil
165f0 6c 20 73 69 7a 65 20 73 65 74 74 69 6e 67 2c 20 l size setting,
16600 73 6f 0a 2a 2a 20 75 73 69 6e 67 20 6d 78 50 61 so.** using mxPa
16610 67 65 20 6f 66 20 30 20 69 73 20 61 20 77 61 79 ge of 0 is a way
16620 20 74 6f 20 71 75 65 72 79 20 74 68 65 20 63 75 to query the cu
16630 72 72 65 6e 74 20 73 70 69 6c 6c 20 73 69 7a 65 rrent spill size
16640 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
16650 42 74 72 65 65 53 65 74 53 70 69 6c 6c 53 69 7a BtreeSetSpillSiz
16660 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 e(Btree *p, int
16670 6d 78 50 61 67 65 29 7b 0a 20 20 42 74 53 68 61 mxPage){. BtSha
16680 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
16690 74 3b 0a 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 t;. int res;.
166a0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
166b0 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 mutex_held(p->db
166c0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 ->mutex) );. sq
166d0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
166e0 70 29 3b 0a 20 20 72 65 73 20 3d 20 73 71 6c 69 p);. res = sqli
166f0 74 65 33 50 61 67 65 72 53 65 74 53 70 69 6c 6c te3PagerSetSpill
16700 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 size(pBt->pPager
16710 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 6c , mxPage);. sql
16720 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
16730 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 73 3b );. return res;
16740 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d .}..#if SQLITE_M
16750 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 2f AX_MMAP_SIZE>0./
16760 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
16770 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 61 6d 6f limit on the amo
16780 75 6e 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 unt of the datab
16790 61 73 65 20 66 69 6c 65 20 74 68 61 74 20 6d 61 ase file that ma
167a0 79 20 62 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 6d y be.** memory m
167b0 61 70 70 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 apped..*/.int sq
167c0 6c 69 74 65 33 42 74 72 65 65 53 65 74 4d 6d 61 lite3BtreeSetMma
167d0 70 4c 69 6d 69 74 28 42 74 72 65 65 20 2a 70 2c pLimit(Btree *p,
167e0 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 sqlite3_int64 s
167f0 7a 4d 6d 61 70 29 7b 0a 20 20 42 74 53 68 61 72 zMmap){. BtShar
16800 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
16810 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
16820 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
16830 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
16840 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
16850 74 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 ter(p);. sqlite
16860 33 50 61 67 65 72 53 65 74 4d 6d 61 70 4c 69 6d 3PagerSetMmapLim
16870 69 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 it(pBt->pPager,
16880 73 7a 4d 6d 61 70 29 3b 0a 20 20 73 71 6c 69 74 szMmap);. sqlit
16890 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
168a0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
168b0 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a _OK;.}.#endif /*
168c0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
168d0 5f 53 49 5a 45 3e 30 20 2a 2f 0a 0a 2f 2a 0a 2a _SIZE>0 */../*.*
168e0 2a 20 43 68 61 6e 67 65 20 74 68 65 20 77 61 79 * Change the way
168f0 20 64 61 74 61 20 69 73 20 73 79 6e 63 65 64 20 data is synced
16900 74 6f 20 64 69 73 6b 20 69 6e 20 6f 72 64 65 72 to disk in order
16910 20 74 6f 20 69 6e 63 72 65 61 73 65 20 6f 72 20 to increase or
16920 64 65 63 72 65 61 73 65 0a 2a 2a 20 68 6f 77 20 decrease.** how
16930 77 65 6c 6c 20 74 68 65 20 64 61 74 61 62 61 73 well the databas
16940 65 20 72 65 73 69 73 74 73 20 64 61 6d 61 67 65 e resists damage
16950 20 64 75 65 20 74 6f 20 4f 53 20 63 72 61 73 68 due to OS crash
16960 65 73 20 61 6e 64 20 70 6f 77 65 72 0a 2a 2a 20 es and power.**
16970 66 61 69 6c 75 72 65 73 2e 20 20 4c 65 76 65 6c failures. Level
16980 20 31 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 1 is the same a
16990 73 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 28 s asynchronous (
169a0 6e 6f 20 73 79 6e 63 73 28 29 20 6f 63 63 75 72 no syncs() occur
169b0 20 61 6e 64 0a 2a 2a 20 74 68 65 72 65 20 69 73 and.** there is
169c0 20 61 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c a high probabil
169d0 69 74 79 20 6f 66 20 64 61 6d 61 67 65 29 20 20 ity of damage)
169e0 4c 65 76 65 6c 20 32 20 69 73 20 74 68 65 20 64 Level 2 is the d
169f0 65 66 61 75 6c 74 2e 20 20 54 68 65 72 65 0a 2a efault. There.*
16a00 2a 20 69 73 20 61 20 76 65 72 79 20 6c 6f 77 20 * is a very low
16a10 62 75 74 20 6e 6f 6e 2d 7a 65 72 6f 20 70 72 6f but non-zero pro
16a20 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 bability of dama
16a30 67 65 2e 20 20 4c 65 76 65 6c 20 33 20 72 65 64 ge. Level 3 red
16a40 75 63 65 73 20 74 68 65 0a 2a 2a 20 70 72 6f 62 uces the.** prob
16a50 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 ability of damag
16a60 65 20 74 6f 20 6e 65 61 72 20 7a 65 72 6f 20 62 e to near zero b
16a70 75 74 20 77 69 74 68 20 61 20 77 72 69 74 65 20 ut with a write
16a80 70 65 72 66 6f 72 6d 61 6e 63 65 20 72 65 64 75 performance redu
16a90 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 ction..*/.#ifnde
16aa0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 f SQLITE_OMIT_PA
16ab0 47 45 52 5f 50 52 41 47 4d 41 53 0a 69 6e 74 20 GER_PRAGMAS.int
16ac0 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 50 sqlite3BtreeSetP
16ad0 61 67 65 72 46 6c 61 67 73 28 0a 20 20 42 74 72 agerFlags(. Btr
16ae0 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 ee *p,
16af0 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 /* The btree
16b00 20 74 6f 20 73 65 74 20 74 68 65 20 73 61 66 65 to set the safe
16b10 74 79 20 6c 65 76 65 6c 20 6f 6e 20 2a 2f 0a 20 ty level on */.
16b20 20 75 6e 73 69 67 6e 65 64 20 70 67 46 6c 61 67 unsigned pgFlag
16b30 73 20 20 20 20 20 20 20 2f 2a 20 56 61 72 69 6f s /* Vario
16b40 75 73 20 50 41 47 45 52 5f 2a 20 66 6c 61 67 73 us PAGER_* flags
16b50 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 */.){. BtShare
16b60 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
16b70 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
16b80 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d e3_mutex_held(p-
16b90 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 >db->mutex) );.
16ba0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
16bb0 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 er(p);. sqlite3
16bc0 50 61 67 65 72 53 65 74 46 6c 61 67 73 28 70 42 PagerSetFlags(pB
16bd0 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 46 6c 61 t->pPager, pgFla
16be0 67 73 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 gs);. sqlite3Bt
16bf0 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
16c00 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
16c10 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
16c20 20 43 68 61 6e 67 65 20 74 68 65 20 64 65 66 61 Change the defa
16c30 75 6c 74 20 70 61 67 65 73 20 73 69 7a 65 20 61 ult pages size a
16c40 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 nd the number of
16c50 20 72 65 73 65 72 76 65 64 20 62 79 74 65 73 20 reserved bytes
16c60 70 65 72 20 70 61 67 65 2e 0a 2a 2a 20 4f 72 2c per page..** Or,
16c70 20 69 66 20 74 68 65 20 70 61 67 65 20 73 69 7a if the page siz
16c80 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 e has already be
16c90 65 6e 20 66 69 78 65 64 2c 20 72 65 74 75 72 6e en fixed, return
16ca0 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
16cb0 20 0a 2a 2a 20 77 69 74 68 6f 75 74 20 63 68 61 .** without cha
16cc0 6e 67 69 6e 67 20 61 6e 79 74 68 69 6e 67 2e 0a nging anything..
16cd0 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 73 **.** The page s
16ce0 69 7a 65 20 6d 75 73 74 20 62 65 20 61 20 70 6f ize must be a po
16cf0 77 65 72 20 6f 66 20 32 20 62 65 74 77 65 65 6e wer of 2 between
16d00 20 35 31 32 20 61 6e 64 20 36 35 35 33 36 2e 20 512 and 65536.
16d10 20 49 66 20 74 68 65 20 70 61 67 65 0a 2a 2a 20 If the page.**
16d20 73 69 7a 65 20 73 75 70 70 6c 69 65 64 20 64 6f size supplied do
16d30 65 73 20 6e 6f 74 20 6d 65 65 74 20 74 68 69 73 es not meet this
16d40 20 63 6f 6e 73 74 72 61 69 6e 74 20 74 68 65 6e constraint then
16d50 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 the page size i
16d60 73 20 6e 6f 74 0a 2a 2a 20 63 68 61 6e 67 65 64 s not.** changed
16d70 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 20 73 69 7a ..**.** Page siz
16d80 65 73 20 61 72 65 20 63 6f 6e 73 74 72 61 69 6e es are constrain
16d90 65 64 20 74 6f 20 62 65 20 61 20 70 6f 77 65 72 ed to be a power
16da0 20 6f 66 20 74 77 6f 20 73 6f 20 74 68 61 74 20 of two so that
16db0 74 68 65 20 72 65 67 69 6f 6e 0a 2a 2a 20 6f 66 the region.** of
16dc0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
16dd0 6c 65 20 75 73 65 64 20 66 6f 72 20 6c 6f 63 6b le used for lock
16de0 69 6e 67 20 28 62 65 67 69 6e 6e 69 6e 67 20 61 ing (beginning a
16df0 74 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 0a t PENDING_BYTE,.
16e00 2a 2a 20 74 68 65 20 66 69 72 73 74 20 62 79 74 ** the first byt
16e10 65 20 70 61 73 74 20 74 68 65 20 31 47 42 20 62 e past the 1GB b
16e20 6f 75 6e 64 61 72 79 2c 20 30 78 34 30 30 30 30 oundary, 0x40000
16e30 30 30 30 29 20 6e 65 65 64 73 20 74 6f 20 6f 63 000) needs to oc
16e40 63 75 72 0a 2a 2a 20 61 74 20 74 68 65 20 62 65 cur.** at the be
16e50 67 69 6e 6e 69 6e 67 20 6f 66 20 61 20 70 61 67 ginning of a pag
16e60 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 72 61 e..**.** If para
16e70 6d 65 74 65 72 20 6e 52 65 73 65 72 76 65 20 69 meter nReserve i
16e80 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f s less than zero
16e90 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 , then the numbe
16ea0 72 20 6f 66 20 72 65 73 65 72 76 65 64 0a 2a 2a r of reserved.**
16eb0 20 62 79 74 65 73 20 70 65 72 20 70 61 67 65 20 bytes per page
16ec0 69 73 20 6c 65 66 74 20 75 6e 63 68 61 6e 67 65 is left unchange
16ed0 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 d..**.** If the
16ee0 69 46 69 78 21 3d 30 20 74 68 65 6e 20 74 68 65 iFix!=0 then the
16ef0 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 BTS_PAGESIZE_FI
16f00 58 45 44 20 66 6c 61 67 20 69 73 20 73 65 74 20 XED flag is set
16f10 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 67 65 so that the page
16f20 20 73 69 7a 65 0a 2a 2a 20 61 6e 64 20 61 75 74 size.** and aut
16f30 6f 76 61 63 75 75 6d 20 6d 6f 64 65 20 63 61 6e ovacuum mode can
16f40 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 65 20 63 68 no longer be ch
16f50 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 anged..*/.int sq
16f60 6c 69 74 65 33 42 74 72 65 65 53 65 74 50 61 67 lite3BtreeSetPag
16f70 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 eSize(Btree *p,
16f80 69 6e 74 20 70 61 67 65 53 69 7a 65 2c 20 69 6e int pageSize, in
16f90 74 20 6e 52 65 73 65 72 76 65 2c 20 69 6e 74 20 t nReserve, int
16fa0 69 46 69 78 29 7b 0a 20 20 69 6e 74 20 72 63 20 iFix){. int rc
16fb0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 42 = SQLITE_OK;. B
16fc0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
16fd0 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 ->pBt;. assert(
16fe0 20 6e 52 65 73 65 72 76 65 3e 3d 2d 31 20 26 26 nReserve>=-1 &&
16ff0 20 6e 52 65 73 65 72 76 65 3c 3d 32 35 35 20 29 nReserve<=255 )
17000 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
17010 45 6e 74 65 72 28 70 29 3b 0a 23 69 66 20 53 51 Enter(p);.#if SQ
17020 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 LITE_HAS_CODEC.
17030 20 69 66 28 20 6e 52 65 73 65 72 76 65 3e 70 42 if( nReserve>pB
17040 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 73 65 72 76 t->optimalReserv
17050 65 20 29 20 70 42 74 2d 3e 6f 70 74 69 6d 61 6c e ) pBt->optimal
17060 52 65 73 65 72 76 65 20 3d 20 28 75 38 29 6e 52 Reserve = (u8)nR
17070 65 73 65 72 76 65 3b 0a 23 65 6e 64 69 66 0a 20 eserve;.#endif.
17080 20 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 if( pBt->btsFla
17090 67 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 5a gs & BTS_PAGESIZ
170a0 45 5f 46 49 58 45 44 20 29 7b 0a 20 20 20 20 73 E_FIXED ){. s
170b0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
170c0 28 70 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 (p);. return
170d0 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b SQLITE_READONLY;
170e0 0a 20 20 7d 0a 20 20 69 66 28 20 6e 52 65 73 65 . }. if( nRese
170f0 72 76 65 3c 30 20 29 7b 0a 20 20 20 20 6e 52 65 rve<0 ){. nRe
17100 73 65 72 76 65 20 3d 20 70 42 74 2d 3e 70 61 67 serve = pBt->pag
17110 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 61 eSize - pBt->usa
17120 62 6c 65 53 69 7a 65 3b 0a 20 20 7d 0a 20 20 61 bleSize;. }. a
17130 73 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e ssert( nReserve>
17140 3d 30 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d =0 && nReserve<=
17150 32 35 35 20 29 3b 0a 20 20 69 66 28 20 70 61 67 255 );. if( pag
17160 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 61 eSize>=512 && pa
17170 67 65 53 69 7a 65 3c 3d 53 51 4c 49 54 45 5f 4d geSize<=SQLITE_M
17180 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 26 26 0a AX_PAGE_SIZE &&.
17190 20 20 20 20 20 20 20 20 28 28 70 61 67 65 53 69 ((pageSi
171a0 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 3d ze-1)&pageSize)=
171b0 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 =0 ){. assert
171c0 28 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 29 ( (pageSize & 7)
171d0 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ==0 );. asser
171e0 74 28 20 21 70 42 74 2d 3e 70 43 75 72 73 6f 72 t( !pBt->pCursor
171f0 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 61 67 );. pBt->pag
17200 65 53 69 7a 65 20 3d 20 28 75 33 32 29 70 61 67 eSize = (u32)pag
17210 65 53 69 7a 65 3b 0a 20 20 20 20 66 72 65 65 54 eSize;. freeT
17220 65 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 empSpace(pBt);.
17230 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
17240 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
17250 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 e(pBt->pPager, &
17260 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e pBt->pageSize, n
17270 52 65 73 65 72 76 65 29 3b 0a 20 20 70 42 74 2d Reserve);. pBt-
17280 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 >usableSize = pB
17290 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 28 75 t->pageSize - (u
172a0 31 36 29 6e 52 65 73 65 72 76 65 3b 0a 20 20 69 16)nReserve;. i
172b0 66 28 20 69 46 69 78 20 29 20 70 42 74 2d 3e 62 f( iFix ) pBt->b
172c0 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 tsFlags |= BTS_P
172d0 41 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 20 AGESIZE_FIXED;.
172e0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
172f0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
17300 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 rc;.}../*.** Ret
17310 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 6c urn the currentl
17320 79 20 64 65 66 69 6e 65 64 20 70 61 67 65 20 73 y defined page s
17330 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ize.*/.int sqlit
17340 65 33 42 74 72 65 65 47 65 74 50 61 67 65 53 69 e3BtreeGetPageSi
17350 7a 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ze(Btree *p){.
17360 72 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e 70 return p->pBt->p
17370 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a 2f 2a 0a 2a ageSize;.}../*.*
17380 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
17390 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 73 71 is similar to sq
173a0 6c 69 74 65 33 42 74 72 65 65 47 65 74 52 65 73 lite3BtreeGetRes
173b0 65 72 76 65 28 29 2c 20 65 78 63 65 70 74 20 74 erve(), except t
173c0 68 61 74 20 69 74 0a 2a 2a 20 6d 61 79 20 6f 6e hat it.** may on
173d0 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 69 66 20 ly be called if
173e0 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 it is guaranteed
173f0 20 74 68 61 74 20 74 68 65 20 62 2d 74 72 65 65 that the b-tree
17400 20 6d 75 74 65 78 20 69 73 20 61 6c 72 65 61 64 mutex is alread
17410 79 0a 2a 2a 20 68 65 6c 64 2e 0a 2a 2a 0a 2a 2a y.** held..**.**
17420 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 This is useful
17430 69 6e 20 6f 6e 65 20 73 70 65 63 69 61 6c 20 63 in one special c
17440 61 73 65 20 69 6e 20 74 68 65 20 62 61 63 6b 75 ase in the backu
17450 70 20 41 50 49 20 63 6f 64 65 20 77 68 65 72 65 p API code where
17460 20 69 74 20 69 73 0a 2a 2a 20 6b 6e 6f 77 6e 20 it is.** known
17470 74 68 61 74 20 74 68 65 20 73 68 61 72 65 64 20 that the shared
17480 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 b-tree mutex is
17490 68 65 6c 64 2c 20 62 75 74 20 74 68 65 20 6d 75 held, but the mu
174a0 74 65 78 20 6f 6e 20 74 68 65 20 0a 2a 2a 20 64 tex on the .** d
174b0 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 atabase handle t
174c0 68 61 74 20 6f 77 6e 73 20 2a 70 20 69 73 20 6e hat owns *p is n
174d0 6f 74 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ot. In this case
174e0 20 69 66 20 73 71 6c 69 74 65 33 42 74 72 65 65 if sqlite3Btree
174f0 45 6e 74 65 72 28 29 0a 2a 2a 20 77 65 72 65 20 Enter().** were
17500 74 6f 20 62 65 20 63 61 6c 6c 65 64 2c 20 69 74 to be called, it
17510 20 6d 69 67 68 74 20 63 6f 6c 6c 69 64 65 20 77 might collide w
17520 69 74 68 20 73 6f 6d 65 20 6f 74 68 65 72 20 6f ith some other o
17530 70 65 72 61 74 69 6f 6e 20 6f 6e 20 74 68 65 0a peration on the.
17540 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 ** database hand
17550 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a 70 2c le that owns *p,
17560 20 63 61 75 73 69 6e 67 20 75 6e 64 65 66 69 6e causing undefin
17570 65 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2f 0a ed behavior..*/.
17580 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
17590 47 65 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 65 GetReserveNoMute
175a0 78 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 x(Btree *p){. i
175b0 6e 74 20 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 nt n;. assert(
175c0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
175d0 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 ld(p->pBt->mutex
175e0 29 20 29 3b 0a 20 20 6e 20 3d 20 70 2d 3e 70 42 ) );. n = p->pB
175f0 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 2d t->pageSize - p-
17600 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
17610 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a ;. return n;.}.
17620 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
17630 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
17640 73 20 6f 66 20 73 70 61 63 65 20 61 74 20 74 68 s of space at th
17650 65 20 65 6e 64 20 6f 66 20 65 76 65 72 79 20 70 e end of every p
17660 61 67 65 20 74 68 61 74 0a 2a 2a 20 61 72 65 20 age that.** are
17670 69 6e 74 65 6e 74 75 61 6c 6c 79 20 6c 65 66 74 intentually left
17680 20 75 6e 75 73 65 64 2e 20 20 54 68 69 73 20 69 unused. This i
17690 73 20 74 68 65 20 22 72 65 73 65 72 76 65 64 22 s the "reserved"
176a0 20 73 70 61 63 65 20 74 68 61 74 20 69 73 0a 2a space that is.*
176b0 2a 20 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 64 * sometimes used
176c0 20 62 79 20 65 78 74 65 6e 73 69 6f 6e 73 2e 0a by extensions..
176d0 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f **.** If SQLITE_
176e0 48 41 53 5f 4d 55 54 45 58 20 69 73 20 64 65 66 HAS_MUTEX is def
176f0 69 6e 65 64 20 74 68 65 6e 20 74 68 65 20 6e 75 ined then the nu
17700 6d 62 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 mber returned is
17710 20 74 68 65 0a 2a 2a 20 67 72 65 61 74 65 72 20 the.** greater
17720 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 of the current r
17730 65 73 65 72 76 65 64 20 73 70 61 63 65 20 61 6e eserved space an
17740 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 72 65 d the maximum re
17750 71 75 65 73 74 65 64 0a 2a 2a 20 72 65 73 65 72 quested.** reser
17760 76 65 20 73 70 61 63 65 2e 0a 2a 2f 0a 69 6e 74 ve space..*/.int
17770 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
17780 4f 70 74 69 6d 61 6c 52 65 73 65 72 76 65 28 42 OptimalReserve(B
17790 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 tree *p){. int
177a0 6e 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 n;. sqlite3Btre
177b0 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 6e 20 3d eEnter(p);. n =
177c0 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
177d0 52 65 73 65 72 76 65 4e 6f 4d 75 74 65 78 28 70 ReserveNoMutex(p
177e0 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 );.#ifdef SQLITE
177f0 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 69 66 28 _HAS_CODEC. if(
17800 20 6e 3c 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 6d n<p->pBt->optim
17810 61 6c 52 65 73 65 72 76 65 20 29 20 6e 20 3d 20 alReserve ) n =
17820 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 p->pBt->optimalR
17830 65 73 65 72 76 65 3b 0a 23 65 6e 64 69 66 0a 20 eserve;.#endif.
17840 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
17850 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
17860 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 n;.}.../*.** Set
17870 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 the maximum pag
17880 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 20 64 61 e count for a da
17890 74 61 62 61 73 65 20 69 66 20 6d 78 50 61 67 65 tabase if mxPage
178a0 20 69 73 20 70 6f 73 69 74 69 76 65 2e 0a 2a 2a is positive..**
178b0 20 4e 6f 20 63 68 61 6e 67 65 73 20 61 72 65 20 No changes are
178c0 6d 61 64 65 20 69 66 20 6d 78 50 61 67 65 20 69 made if mxPage i
178d0 73 20 30 20 6f 72 20 6e 65 67 61 74 69 76 65 2e s 0 or negative.
178e0 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 20 6f .** Regardless o
178f0 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 6d f the value of m
17900 78 50 61 67 65 2c 20 72 65 74 75 72 6e 20 74 68 xPage, return th
17910 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 e maximum page c
17920 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ount..*/.int sql
17930 69 74 65 33 42 74 72 65 65 4d 61 78 50 61 67 65 ite3BtreeMaxPage
17940 43 6f 75 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 Count(Btree *p,
17950 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 69 int mxPage){. i
17960 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 42 nt n;. sqlite3B
17970 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
17980 6e 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 n = sqlite3Pager
17990 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 70 2d 3e MaxPageCount(p->
179a0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 pBt->pPager, mxP
179b0 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 age);. sqlite3B
179c0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
179d0 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a return n;.}../*.
179e0 2a 2a 20 53 65 74 20 74 68 65 20 42 54 53 5f 53 ** Set the BTS_S
179f0 45 43 55 52 45 5f 44 45 4c 45 54 45 20 66 6c 61 ECURE_DELETE fla
17a00 67 20 69 66 20 6e 65 77 46 6c 61 67 20 69 73 20 g if newFlag is
17a10 30 20 6f 72 20 31 2e 20 20 49 66 20 6e 65 77 46 0 or 1. If newF
17a20 6c 61 67 20 69 73 20 2d 31 2c 0a 2a 2a 20 74 68 lag is -1,.** th
17a30 65 6e 20 6d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 en make no chang
17a40 65 73 2e 20 20 41 6c 77 61 79 73 20 72 65 74 75 es. Always retu
17a50 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 rn the value of
17a60 74 68 65 20 42 54 53 5f 53 45 43 55 52 45 5f 44 the BTS_SECURE_D
17a70 45 4c 45 54 45 0a 2a 2a 20 73 65 74 74 69 6e 67 ELETE.** setting
17a80 20 61 66 74 65 72 20 74 68 65 20 63 68 61 6e 67 after the chang
17a90 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
17aa0 33 42 74 72 65 65 53 65 63 75 72 65 44 65 6c 65 3BtreeSecureDele
17ab0 74 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 te(Btree *p, int
17ac0 20 6e 65 77 46 6c 61 67 29 7b 0a 20 20 69 6e 74 newFlag){. int
17ad0 20 62 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 b;. if( p==0 )
17ae0 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 6c return 0;. sql
17af0 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
17b00 29 3b 0a 20 20 69 66 28 20 6e 65 77 46 6c 61 67 );. if( newFlag
17b10 3e 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 70 42 >=0 ){. p->pB
17b20 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e t->btsFlags &= ~
17b30 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 BTS_SECURE_DELET
17b40 45 3b 0a 20 20 20 20 69 66 28 20 6e 65 77 46 6c E;. if( newFl
17b50 61 67 20 29 20 70 2d 3e 70 42 74 2d 3e 62 74 73 ag ) p->pBt->bts
17b60 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 53 45 43 Flags |= BTS_SEC
17b70 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 7d 20 URE_DELETE;. }
17b80 0a 20 20 62 20 3d 20 28 70 2d 3e 70 42 74 2d 3e . b = (p->pBt->
17b90 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 btsFlags & BTS_S
17ba0 45 43 55 52 45 5f 44 45 4c 45 54 45 29 21 3d 30 ECURE_DELETE)!=0
17bb0 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
17bc0 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
17bd0 72 6e 20 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 rn b;.}../*.** C
17be0 68 61 6e 67 65 20 74 68 65 20 27 61 75 74 6f 2d hange the 'auto-
17bf0 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 79 vacuum' property
17c00 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
17c10 2e 20 49 66 20 74 68 65 20 27 61 75 74 6f 56 61 . If the 'autoVa
17c20 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 6d 65 74 cuum'.** paramet
17c30 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 er is non-zero,
17c40 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d then auto-vacuum
17c50 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 6c 65 64 mode is enabled
17c60 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 0a 2a 2a . If zero, it.**
17c70 20 69 73 20 64 69 73 61 62 6c 65 64 2e 20 54 68 is disabled. Th
17c80 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 e default value
17c90 66 6f 72 20 74 68 65 20 61 75 74 6f 2d 76 61 63 for the auto-vac
17ca0 75 75 6d 20 70 72 6f 70 65 72 74 79 20 69 73 20 uum property is
17cb0 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 .** determined b
17cc0 79 20 74 68 65 20 53 51 4c 49 54 45 5f 44 45 46 y the SQLITE_DEF
17cd0 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 AULT_AUTOVACUUM
17ce0 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 73 71 macro..*/.int sq
17cf0 6c 69 74 65 33 42 74 72 65 65 53 65 74 41 75 74 lite3BtreeSetAut
17d00 6f 56 61 63 75 75 6d 28 42 74 72 65 65 20 2a 70 oVacuum(Btree *p
17d10 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 75 75 6d , int autoVacuum
17d20 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
17d30 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
17d40 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
17d50 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 6c 73 65 _READONLY;.#else
17d60 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
17d70 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 = p->pBt;. int
17d80 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
17d90 0a 20 20 75 38 20 61 76 20 3d 20 28 75 38 29 61 . u8 av = (u8)a
17da0 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 20 73 71 utoVacuum;.. sq
17db0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
17dc0 70 29 3b 0a 20 20 69 66 28 20 28 70 42 74 2d 3e p);. if( (pBt->
17dd0 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 btsFlags & BTS_P
17de0 41 47 45 53 49 5a 45 5f 46 49 58 45 44 29 21 3d AGESIZE_FIXED)!=
17df0 30 20 26 26 20 28 61 76 20 3f 31 3a 30 29 21 3d 0 && (av ?1:0)!=
17e00 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
17e10 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 ){. rc = SQLI
17e20 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 7d TE_READONLY;. }
17e30 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 2d 3e 61 else{. pBt->a
17e40 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 76 20 3f utoVacuum = av ?
17e50 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 1:0;. pBt->in
17e60 63 72 56 61 63 75 75 6d 20 3d 20 61 76 3d 3d 32 crVacuum = av==2
17e70 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 73 71 6c ?1:0;. }. sql
17e80 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
17e90 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
17ea0 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 #endif.}../*.**
17eb0 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 Return the value
17ec0 20 6f 66 20 74 68 65 20 27 61 75 74 6f 2d 76 61 of the 'auto-va
17ed0 63 75 75 6d 27 20 70 72 6f 70 65 72 74 79 2e 20 cuum' property.
17ee0 49 66 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 69 If auto-vacuum i
17ef0 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 20 31 20 s .** enabled 1
17f00 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 is returned. Oth
17f10 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a 69 6e 74 erwise 0..*/.int
17f20 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
17f30 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 AutoVacuum(Btree
17f40 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *p){.#ifdef SQL
17f50 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
17f60 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 42 54 52 UUM. return BTR
17f70 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 4e 4f EE_AUTOVACUUM_NO
17f80 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 NE;.#else. int
17f90 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 rc;. sqlite3Btr
17fa0 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 eeEnter(p);. rc
17fb0 20 3d 20 28 0a 20 20 20 20 28 21 70 2d 3e 70 42 = (. (!p->pB
17fc0 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 3f 42 t->autoVacuum)?B
17fd0 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f TREE_AUTOVACUUM_
17fe0 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 2d 3e 70 NONE:. (!p->p
17ff0 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 3f Bt->incrVacuum)?
18000 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d BTREE_AUTOVACUUM
18010 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 52 45 45 _FULL:. BTREE
18020 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 4e 43 52 _AUTOVACUUM_INCR
18030 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 . );. sqlite3B
18040 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
18050 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
18060 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 f.}../*.** If th
18070 65 20 75 73 65 72 20 68 61 73 20 6e 6f 74 20 73 e user has not s
18080 65 74 20 74 68 65 20 73 61 66 65 74 79 2d 6c 65 et the safety-le
18090 76 65 6c 20 66 6f 72 20 74 68 69 73 20 64 61 74 vel for this dat
180a0 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
180b0 0a 2a 2a 20 75 73 69 6e 67 20 22 50 52 41 47 4d .** using "PRAGM
180c0 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 22 2c 20 A synchronous",
180d0 61 6e 64 20 69 66 20 74 68 65 20 73 61 66 65 74 and if the safet
180e0 79 2d 6c 65 76 65 6c 20 69 73 20 6e 6f 74 20 61 y-level is not a
180f0 6c 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 74 6f lready.** set to
18100 20 74 68 65 20 76 61 6c 75 65 20 70 61 73 73 65 the value passe
18110 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 d to this functi
18120 6f 6e 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 on as the second
18130 20 70 61 72 61 6d 65 74 65 72 2c 0a 2a 2a 20 73 parameter,.** s
18140 65 74 20 69 74 20 73 6f 2e 0a 2a 2f 0a 23 69 66 et it so..*/.#if
18150 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
18160 53 59 4e 43 48 52 4f 4e 4f 55 53 21 3d 53 51 4c SYNCHRONOUS!=SQL
18170 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f ITE_DEFAULT_WAL_
18180 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 73 74 61 74 SYNCHRONOUS.stat
18190 69 63 20 76 6f 69 64 20 73 65 74 44 65 66 61 75 ic void setDefau
181a0 6c 74 53 79 6e 63 46 6c 61 67 28 42 74 53 68 61 ltSyncFlag(BtSha
181b0 72 65 64 20 2a 70 42 74 2c 20 75 38 20 73 61 66 red *pBt, u8 saf
181c0 65 74 79 5f 6c 65 76 65 6c 29 7b 0a 20 20 73 71 ety_level){. sq
181d0 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 44 62 20 lite3 *db;. Db
181e0 2a 70 44 62 3b 0a 20 20 69 66 28 20 28 64 62 3d *pDb;. if( (db=
181f0 70 42 74 2d 3e 64 62 29 21 3d 30 20 26 26 20 28 pBt->db)!=0 && (
18200 70 44 62 3d 64 62 2d 3e 61 44 62 29 21 3d 30 20 pDb=db->aDb)!=0
18210 29 7b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 44 ){. while( pD
18220 62 2d 3e 70 42 74 3d 3d 30 20 7c 7c 20 70 44 62 b->pBt==0 || pDb
18230 2d 3e 70 42 74 2d 3e 70 42 74 21 3d 70 42 74 20 ->pBt->pBt!=pBt
18240 29 7b 20 70 44 62 2b 2b 3b 20 7d 0a 20 20 20 20 ){ pDb++; }.
18250 69 66 28 20 70 44 62 2d 3e 62 53 79 6e 63 53 65 if( pDb->bSyncSe
18260 74 3d 3d 30 20 0a 20 20 20 20 20 26 26 20 70 44 t==0 . && pD
18270 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 21 b->safety_level!
18280 3d 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 0a 20 =safety_level .
18290 20 20 20 20 26 26 20 70 44 62 21 3d 26 64 62 2d && pDb!=&db-
182a0 3e 61 44 62 5b 31 5d 20 0a 20 20 20 20 29 7b 0a >aDb[1] . ){.
182b0 20 20 20 20 20 20 70 44 62 2d 3e 73 61 66 65 74 pDb->safet
182c0 79 5f 6c 65 76 65 6c 20 3d 20 73 61 66 65 74 79 y_level = safety
182d0 5f 6c 65 76 65 6c 3b 0a 20 20 20 20 20 20 73 71 _level;. sq
182e0 6c 69 74 65 33 50 61 67 65 72 53 65 74 46 6c 61 lite3PagerSetFla
182f0 67 73 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 0a gs(pBt->pPager,.
18300 20 20 20 20 20 20 20 20 20 20 70 44 62 2d 3e 73 pDb->s
18310 61 66 65 74 79 5f 6c 65 76 65 6c 20 7c 20 28 64 afety_level | (d
18320 62 2d 3e 66 6c 61 67 73 20 26 20 50 41 47 45 52 b->flags & PAGER
18330 5f 46 4c 41 47 53 5f 4d 41 53 4b 29 29 3b 0a 20 _FLAGS_MASK));.
18340 20 20 20 7d 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 }. }.}.#else
18350 0a 23 20 64 65 66 69 6e 65 20 73 65 74 44 65 66 .# define setDef
18360 61 75 6c 74 53 79 6e 63 46 6c 61 67 28 70 42 74 aultSyncFlag(pBt
18370 2c 73 61 66 65 74 79 5f 6c 65 76 65 6c 29 0a 23 ,safety_level).#
18380 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 endif../*.** Get
18390 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
183a0 70 50 61 67 65 31 20 6f 66 20 74 68 65 20 64 61 pPage1 of the da
183b0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68 tabase file. Th
183c0 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 is will.** also
183d0 61 63 71 75 69 72 65 20 61 20 72 65 61 64 6c 6f acquire a readlo
183e0 63 6b 20 6f 6e 20 74 68 61 74 20 66 69 6c 65 2e ck on that file.
183f0 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
18400 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 is returned on
18410 73 75 63 63 65 73 73 2e 20 20 49 66 20 74 68 65 success. If the
18420 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 0a 2a file is not a.*
18430 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 * well-formed da
18440 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 tabase file, the
18450 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
18460 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a is returned..**
18470 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 SQLITE_BUSY is
18480 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 returned if the
18490 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b database is lock
184a0 65 64 2e 20 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 ed. SQLITE_NOME
184b0 4d 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 M.** is returned
184c0 20 69 66 20 77 65 20 72 75 6e 20 6f 75 74 20 6f if we run out o
184d0 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a 2f 0a 73 74 f memory. .*/.st
184e0 61 74 69 63 20 69 6e 74 20 6c 6f 63 6b 42 74 72 atic int lockBtr
184f0 65 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 ee(BtShared *pBt
18500 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
18510 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 /* Res
18520 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 73 75 ult code from su
18530 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 bfunctions */.
18540 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 3b MemPage *pPage1;
18550 20 20 20 20 20 2f 2a 20 50 61 67 65 20 31 20 6f /* Page 1 o
18560 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
18570 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 ile */. int nPa
18580 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ge; /*
18590 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
185a0 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
185b0 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 46 */. int nPageF
185c0 69 6c 65 20 3d 20 30 3b 20 20 20 2f 2a 20 4e 75 ile = 0; /* Nu
185d0 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
185e0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
185f0 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 le */. int nPag
18600 65 48 65 61 64 65 72 3b 20 20 20 20 20 2f 2a 20 eHeader; /*
18610 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
18620 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
18630 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 68 64 72 according to hdr
18640 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
18650 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
18660 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
18670 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
18680 70 50 61 67 65 31 3d 3d 30 20 29 3b 0a 20 20 72 pPage1==0 );. r
18690 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
186a0 53 68 61 72 65 64 4c 6f 63 6b 28 70 42 74 2d 3e SharedLock(pBt->
186b0 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 72 pPager);. if( r
186c0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 c!=SQLITE_OK ) r
186d0 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 20 3d eturn rc;. rc =
186e0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
186f0 74 2c 20 31 2c 20 26 70 50 61 67 65 31 2c 20 30 t, 1, &pPage1, 0
18700 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
18710 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
18720 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 73 6f 6d rc;.. /* Do som
18730 65 20 63 68 65 63 6b 69 6e 67 20 74 6f 20 68 65 e checking to he
18740 6c 70 20 69 6e 73 75 72 65 20 74 68 65 20 66 69 lp insure the fi
18750 6c 65 20 77 65 20 6f 70 65 6e 65 64 20 72 65 61 le we opened rea
18760 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 61 20 76 61 lly is. ** a va
18770 6c 69 64 20 64 61 74 61 62 61 73 65 20 66 69 6c lid database fil
18780 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 61 67 65 e. . */. nPage
18790 20 3d 20 6e 50 61 67 65 48 65 61 64 65 72 20 3d = nPageHeader =
187a0 20 67 65 74 34 62 79 74 65 28 32 38 2b 28 75 38 get4byte(28+(u8
187b0 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 *)pPage1->aData)
187c0 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
187d0 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d 3e 70 Pagecount(pBt->p
187e0 50 61 67 65 72 2c 20 26 6e 50 61 67 65 46 69 6c Pager, &nPageFil
187f0 65 29 3b 0a 20 20 69 66 28 20 6e 50 61 67 65 3d e);. if( nPage=
18800 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 32 34 2b =0 || memcmp(24+
18810 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 (u8*)pPage1->aDa
18820 74 61 2c 20 39 32 2b 28 75 38 2a 29 70 50 61 67 ta, 92+(u8*)pPag
18830 65 31 2d 3e 61 44 61 74 61 2c 34 29 21 3d 30 20 e1->aData,4)!=0
18840 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 6e ){. nPage = n
18850 50 61 67 65 46 69 6c 65 3b 0a 20 20 7d 0a 20 20 PageFile;. }.
18860 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b 0a 20 if( nPage>0 ){.
18870 20 20 20 75 33 32 20 70 61 67 65 53 69 7a 65 3b u32 pageSize;
18880 0a 20 20 20 20 75 33 32 20 75 73 61 62 6c 65 53 . u32 usableS
18890 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 61 67 ize;. u8 *pag
188a0 65 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 44 61 e1 = pPage1->aDa
188b0 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ta;. rc = SQL
188c0 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 ITE_NOTADB;.
188d0 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
188e0 52 2d 34 33 37 33 37 2d 33 39 39 39 39 20 45 76 R-43737-39999 Ev
188f0 65 72 79 20 76 61 6c 69 64 20 53 51 4c 69 74 65 ery valid SQLite
18900 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 database file b
18910 65 67 69 6e 73 0a 20 20 20 20 2a 2a 20 77 69 74 egins. ** wit
18920 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 h the following
18930 31 36 20 62 79 74 65 73 20 28 69 6e 20 68 65 78 16 bytes (in hex
18940 29 3a 20 35 33 20 35 31 20 34 63 20 36 39 20 37 ): 53 51 4c 69 7
18950 34 20 36 35 20 32 30 20 36 36 20 36 66 20 37 32 4 65 20 66 6f 72
18960 20 36 64 0a 20 20 20 20 2a 2a 20 36 31 20 37 34 6d. ** 61 74
18970 20 32 30 20 33 33 20 30 30 2e 20 2a 2f 0a 20 20 20 33 00. */.
18980 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 70 61 67 if( memcmp(pag
18990 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 e1, zMagicHeader
189a0 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 20 20 20 , 16)!=0 ){.
189b0 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
189c0 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
189d0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
189e0 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 66 28 20 MIT_WAL. if(
189f0 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 7b 0a 20 page1[18]>1 ){.
18a00 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
18a10 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f gs |= BTS_READ_O
18a20 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 NLY;. }. i
18a30 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 31 20 29 f( page1[19]>1 )
18a40 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
18a50 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
18a60 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 }.#else.
18a70 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 32 20 if( page1[18]>2
18a80 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ){. pBt->bt
18a90 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 sFlags |= BTS_RE
18aa0 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 AD_ONLY;. }.
18ab0 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
18ac0 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f >2 ){. goto
18ad0 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
18ae0 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ed;. }.. /
18af0 2a 20 49 66 20 74 68 65 20 77 72 69 74 65 20 76 * If the write v
18b00 65 72 73 69 6f 6e 20 69 73 20 73 65 74 20 74 6f ersion is set to
18b10 20 32 2c 20 74 68 69 73 20 64 61 74 61 62 61 73 2, this databas
18b20 65 20 73 68 6f 75 6c 64 20 62 65 20 61 63 63 65 e should be acce
18b30 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 6e 20 57 ssed. ** in W
18b40 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 AL mode. If the
18b50 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 log is not alrea
18b60 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 74 dy open, open it
18b70 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 20 20 20 now. Then .
18b80 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ** return SQLITE
18b90 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 6e 20 77 _OK and return w
18ba0 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 74 69 6e ithout populatin
18bb0 67 20 42 74 53 68 61 72 65 64 2e 70 50 61 67 65 g BtShared.pPage
18bc0 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 63 61 1.. ** The ca
18bd0 6c 6c 65 72 20 64 65 74 65 63 74 73 20 74 68 69 ller detects thi
18be0 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 68 69 73 s and calls this
18bf0 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 2e function again.
18c00 20 54 68 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 This is. **
18c10 72 65 71 75 69 72 65 64 20 61 73 20 74 68 65 20 required as the
18c20 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 65 20 version of page
18c30 31 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 1 currently in t
18c40 68 65 20 70 61 67 65 31 20 62 75 66 66 65 72 0a he page1 buffer.
18c50 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 62 ** may not b
18c60 65 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 e the latest ver
18c70 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 6d 61 79 sion - there may
18c80 20 62 65 20 61 20 6e 65 77 65 72 20 6f 6e 65 20 be a newer one
18c90 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 20 20 2a in the log. *
18ca0 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 * file.. */.
18cb0 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
18cc0 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 62 74 73 ==2 && (pBt->bts
18cd0 46 6c 61 67 73 20 26 20 42 54 53 5f 4e 4f 5f 57 Flags & BTS_NO_W
18ce0 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 AL)==0 ){.
18cf0 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 30 3b 0a int isOpen = 0;.
18d00 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
18d10 65 33 50 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 e3PagerOpenWal(p
18d20 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 69 73 4f Bt->pPager, &isO
18d30 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pen);. if(
18d40 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
18d50 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 . goto pa
18d60 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
18d70 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
18d80 20 20 20 20 20 20 73 65 74 44 65 66 61 75 6c 74 setDefault
18d90 53 79 6e 63 46 6c 61 67 28 70 42 74 2c 20 53 51 SyncFlag(pBt, SQ
18da0 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c LITE_DEFAULT_WAL
18db0 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 2b 31 29 3b _SYNCHRONOUS+1);
18dc0 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 73 4f . if( isO
18dd0 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 pen==0 ){.
18de0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
18df0 70 50 61 67 65 31 29 3b 0a 20 20 20 20 20 20 20 pPage1);.
18e00 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
18e10 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 _OK;. }.
18e20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 20 }. rc
18e30 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b = SQLITE_NOTADB;
18e40 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
18e50 20 20 73 65 74 44 65 66 61 75 6c 74 53 79 6e 63 setDefaultSync
18e60 46 6c 61 67 28 70 42 74 2c 20 53 51 4c 49 54 45 Flag(pBt, SQLITE
18e70 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f _DEFAULT_SYNCHRO
18e80 4e 4f 55 53 2b 31 29 3b 0a 20 20 20 20 7d 0a 23 NOUS+1);. }.#
18e90 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 45 56 endif.. /* EV
18ea0 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 35 34 IDENCE-OF: R-154
18eb0 36 35 2d 32 30 38 31 33 20 54 68 65 20 6d 61 78 65-20813 The max
18ec0 69 6d 75 6d 20 61 6e 64 20 6d 69 6e 69 6d 75 6d imum and minimum
18ed0 20 65 6d 62 65 64 64 65 64 20 70 61 79 6c 6f 61 embedded payloa
18ee0 64 0a 20 20 20 20 2a 2a 20 66 72 61 63 74 69 6f d. ** fractio
18ef0 6e 73 20 61 6e 64 20 74 68 65 20 6c 65 61 66 20 ns and the leaf
18f00 70 61 79 6c 6f 61 64 20 66 72 61 63 74 69 6f 6e payload fraction
18f10 20 76 61 6c 75 65 73 20 6d 75 73 74 20 62 65 20 values must be
18f20 36 34 2c 20 33 32 2c 20 61 6e 64 20 33 32 2e 0a 64, 32, and 32..
18f30 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 **. ** Th
18f40 65 20 6f 72 69 67 69 6e 61 6c 20 64 65 73 69 67 e original desig
18f50 6e 20 61 6c 6c 6f 77 65 64 20 74 68 65 73 65 20 n allowed these
18f60 61 6d 6f 75 6e 74 73 20 74 6f 20 76 61 72 79 2c amounts to vary,
18f70 20 62 75 74 20 61 73 20 6f 66 0a 20 20 20 20 2a but as of. *
18f80 2a 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e 30 2c * version 3.6.0,
18f90 20 77 65 20 72 65 71 75 69 72 65 20 74 68 65 6d we require them
18fa0 20 74 6f 20 62 65 20 66 69 78 65 64 2e 0a 20 20 to be fixed..
18fb0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6d 65 6d */. if( mem
18fc0 63 6d 70 28 26 70 61 67 65 31 5b 32 31 5d 2c 20 cmp(&page1[21],
18fd0 22 5c 31 30 30 5c 30 34 30 5c 30 34 30 22 2c 33 "\100\040\040",3
18fe0 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 6f )!=0 ){. go
18ff0 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 to page1_init_fa
19000 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 iled;. }.
19010 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
19020 52 2d 35 31 38 37 33 2d 33 39 36 31 38 20 54 68 R-51873-39618 Th
19030 65 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20 e page size for
19040 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 a database file
19050 69 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 6d is. ** determ
19060 69 6e 65 64 20 62 79 20 74 68 65 20 32 2d 62 79 ined by the 2-by
19070 74 65 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 74 te integer locat
19080 65 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 ed at an offset
19090 6f 66 20 31 36 20 62 79 74 65 73 20 66 72 6f 6d of 16 bytes from
190a0 0a 20 20 20 20 2a 2a 20 74 68 65 20 62 65 67 69 . ** the begi
190b0 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 nning of the dat
190c0 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 abase file. */.
190d0 20 20 20 70 61 67 65 53 69 7a 65 20 3d 20 28 70 pageSize = (p
190e0 61 67 65 31 5b 31 36 5d 3c 3c 38 29 20 7c 20 28 age1[16]<<8) | (
190f0 70 61 67 65 31 5b 31 37 5d 3c 3c 31 36 29 3b 0a page1[17]<<16);.
19100 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
19110 4f 46 3a 20 52 2d 32 35 30 30 38 2d 32 31 36 38 OF: R-25008-2168
19120 38 20 54 68 65 20 73 69 7a 65 20 6f 66 20 61 20 8 The size of a
19130 70 61 67 65 20 69 73 20 61 20 70 6f 77 65 72 20 page is a power
19140 6f 66 20 74 77 6f 0a 20 20 20 20 2a 2a 20 62 65 of two. ** be
19150 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 tween 512 and 65
19160 35 33 36 20 69 6e 63 6c 75 73 69 76 65 2e 20 2a 536 inclusive. *
19170 2f 0a 20 20 20 20 69 66 28 20 28 28 70 61 67 65 /. if( ((page
19180 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 Size-1)&pageSize
19190 29 21 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 67 )!=0. || pag
191a0 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 eSize>SQLITE_MAX
191b0 5f 50 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 20 _PAGE_SIZE .
191c0 20 7c 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 35 || pageSize<=25
191d0 36 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 6 . ){.
191e0 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f goto page1_init_
191f0 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 failed;. }.
19200 20 20 61 73 73 65 72 74 28 20 28 70 61 67 65 53 assert( (pageS
19210 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 ize & 7)==0 );.
19220 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
19230 46 3a 20 52 2d 35 39 33 31 30 2d 35 31 32 30 35 F: R-59310-51205
19240 20 54 68 65 20 22 72 65 73 65 72 76 65 64 20 73 The "reserved s
19250 70 61 63 65 22 20 73 69 7a 65 20 69 6e 20 74 68 pace" size in th
19260 65 20 31 2d 62 79 74 65 0a 20 20 20 20 2a 2a 20 e 1-byte. **
19270 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 integer at offse
19280 74 20 32 30 20 69 73 20 74 68 65 20 6e 75 6d 62 t 20 is the numb
19290 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 73 er of bytes of s
192a0 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 20 pace at the end
192b0 6f 66 0a 20 20 20 20 2a 2a 20 65 61 63 68 20 70 of. ** each p
192c0 61 67 65 20 74 6f 20 72 65 73 65 72 76 65 20 66 age to reserve f
192d0 6f 72 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 0a or extensions. .
192e0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 56 **. ** EV
192f0 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 34 IDENCE-OF: R-374
19300 39 37 2d 34 32 34 31 32 20 54 68 65 20 73 69 7a 97-42412 The siz
19310 65 20 6f 66 20 74 68 65 20 72 65 73 65 72 76 65 e of the reserve
19320 64 20 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 20 d region is.
19330 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 ** determined by
19340 20 74 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e the one-byte un
19350 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 66 signed integer f
19360 6f 75 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 65 ound at an offse
19370 74 20 6f 66 20 32 30 0a 20 20 20 20 2a 2a 20 69 t of 20. ** i
19380 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 nto the database
19390 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f file header. */
193a0 0a 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 20 . usableSize
193b0 3d 20 70 61 67 65 53 69 7a 65 20 2d 20 70 61 67 = pageSize - pag
193c0 65 31 5b 32 30 5d 3b 0a 20 20 20 20 69 66 28 20 e1[20];. if(
193d0 28 75 33 32 29 70 61 67 65 53 69 7a 65 21 3d 70 (u32)pageSize!=p
193e0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a Bt->pageSize ){.
193f0 20 20 20 20 20 20 2f 2a 20 41 66 74 65 72 20 72 /* After r
19400 65 61 64 69 6e 67 20 74 68 65 20 66 69 72 73 74 eading the first
19410 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 page of the dat
19420 61 62 61 73 65 20 61 73 73 75 6d 69 6e 67 20 61 abase assuming a
19430 20 70 61 67 65 20 73 69 7a 65 0a 20 20 20 20 20 page size.
19440 20 2a 2a 20 6f 66 20 42 74 53 68 61 72 65 64 2e ** of BtShared.
19450 70 61 67 65 53 69 7a 65 2c 20 77 65 20 68 61 76 pageSize, we hav
19460 65 20 64 69 73 63 6f 76 65 72 65 64 20 74 68 61 e discovered tha
19470 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 t the page-size
19480 69 73 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 75 is. ** actu
19490 61 6c 6c 79 20 70 61 67 65 53 69 7a 65 2e 20 55 ally pageSize. U
194a0 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 nlock the databa
194b0 73 65 2c 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 se, leave pBt->p
194c0 50 61 67 65 31 20 61 74 0a 20 20 20 20 20 20 2a Page1 at. *
194d0 2a 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 * zero and retur
194e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 65 n SQLITE_OK. The
194f0 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 63 61 6c caller will cal
19500 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a l this function.
19510 20 20 20 20 20 20 2a 2a 20 61 67 61 69 6e 20 77 ** again w
19520 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 74 20 ith the correct
19530 70 61 67 65 2d 73 69 7a 65 2e 0a 20 20 20 20 20 page-size..
19540 20 2a 2f 0a 20 20 20 20 20 20 72 65 6c 65 61 73 */. releas
19550 65 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 ePage(pPage1);.
19560 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 pBt->usable
19570 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 7a Size = usableSiz
19580 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 61 e;. pBt->pa
19590 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a geSize = pageSiz
195a0 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 6d e;. freeTem
195b0 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 pSpace(pBt);.
195c0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
195d0 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 agerSetPagesize(
195e0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 pBt->pPager, &pB
195f0 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 20 t->pageSize,.
19600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19620 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 53 pageSize-usableS
19630 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 ize);. retu
19640 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
19650 20 69 66 28 20 28 70 42 74 2d 3e 64 62 2d 3e 66 if( (pBt->db->f
19660 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 lags & SQLITE_Re
19670 63 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 20 26 coveryMode)==0 &
19680 26 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 69 6c & nPage>nPageFil
19690 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 e ){. rc =
196a0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
196b0 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 KPT;. goto
196c0 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 page1_init_faile
196d0 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 d;. }. /*
196e0 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 EVIDENCE-OF: R-2
196f0 38 33 31 32 2d 36 34 37 30 34 20 48 6f 77 65 76 8312-64704 Howev
19700 65 72 2c 20 74 68 65 20 75 73 61 62 6c 65 20 73 er, the usable s
19710 69 7a 65 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 ize is not allow
19720 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 ed to. ** be
19730 6c 65 73 73 20 74 68 61 6e 20 34 38 30 2e 20 49 less than 480. I
19740 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 69 n other words, i
19750 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 f the page size
19760 69 73 20 35 31 32 2c 20 74 68 65 6e 20 74 68 65 is 512, then the
19770 0a 20 20 20 20 2a 2a 20 72 65 73 65 72 76 65 64 . ** reserved
19780 20 73 70 61 63 65 20 73 69 7a 65 20 63 61 6e 6e space size cann
19790 6f 74 20 65 78 63 65 65 64 20 33 32 2e 20 2a 2f ot exceed 32. */
197a0 0a 20 20 20 20 69 66 28 20 75 73 61 62 6c 65 53 . if( usableS
197b0 69 7a 65 3c 34 38 30 20 29 7b 0a 20 20 20 20 20 ize<480 ){.
197c0 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
197d0 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
197e0 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 pBt->pageSize
197f0 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 = pageSize;.
19800 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
19810 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a 23 = usableSize;.#
19820 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
19830 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
19840 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 pBt->autoVacuu
19850 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 70 m = (get4byte(&p
19860 61 67 65 31 5b 33 36 20 2b 20 34 2a 34 5d 29 3f age1[36 + 4*4])?
19870 31 3a 30 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 1:0);. pBt->i
19880 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 74 ncrVacuum = (get
19890 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 20 4byte(&page1[36
198a0 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 0a 23 65 + 7*4])?1:0);.#e
198b0 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 6d ndif. }.. /* m
198c0 61 78 4c 6f 63 61 6c 20 69 73 20 74 68 65 20 6d axLocal is the m
198d0 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 aximum amount of
198e0 20 70 61 79 6c 6f 61 64 20 74 6f 20 73 74 6f 72 payload to stor
198f0 65 20 6c 6f 63 61 6c 6c 79 20 66 6f 72 0a 20 20 e locally for.
19900 2a 2a 20 61 20 63 65 6c 6c 2e 20 20 4d 61 6b 65 ** a cell. Make
19910 20 73 75 72 65 20 69 74 20 69 73 20 73 6d 61 6c sure it is smal
19920 6c 20 65 6e 6f 75 67 68 20 73 6f 20 74 68 61 74 l enough so that
19930 20 61 74 20 6c 65 61 73 74 20 6d 69 6e 46 61 6e at least minFan
19940 6f 75 74 0a 20 20 2a 2a 20 63 65 6c 6c 73 20 63 out. ** cells c
19950 61 6e 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 6f an will fit on o
19960 6e 65 20 70 61 67 65 2e 20 20 57 65 20 61 73 73 ne page. We ass
19970 75 6d 65 20 61 20 31 30 2d 62 79 74 65 20 70 61 ume a 10-byte pa
19980 67 65 20 68 65 61 64 65 72 2e 0a 20 20 2a 2a 20 ge header.. **
19990 42 65 73 69 64 65 73 20 74 68 65 20 70 61 79 6c Besides the payl
199a0 6f 61 64 2c 20 74 68 65 20 63 65 6c 6c 20 6d 75 oad, the cell mu
199b0 73 74 20 73 74 6f 72 65 3a 0a 20 20 2a 2a 20 20 st store:. **
199c0 20 20 20 32 2d 62 79 74 65 20 70 6f 69 6e 74 65 2-byte pointe
199d0 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 0a 20 20 r to the cell.
199e0 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 63 68 ** 4-byte ch
199f0 69 6c 64 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a ild pointer. **
19a00 20 20 20 20 20 39 2d 62 79 74 65 20 6e 4b 65 79 9-byte nKey
19a10 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 value. **
19a20 34 2d 62 79 74 65 20 6e 44 61 74 61 20 76 61 6c 4-byte nData val
19a30 75 65 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 79 ue. ** 4-by
19a40 74 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 te overflow page
19a50 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 53 6f pointer. ** So
19a60 20 61 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 a cell consists
19a70 20 6f 66 20 61 20 32 2d 62 79 74 65 20 70 6f 69 of a 2-byte poi
19a80 6e 74 65 72 2c 20 61 20 68 65 61 64 65 72 20 77 nter, a header w
19a90 68 69 63 68 20 69 73 20 61 73 20 6d 75 63 68 20 hich is as much
19aa0 61 73 0a 20 20 2a 2a 20 31 37 20 62 79 74 65 73 as. ** 17 bytes
19ab0 20 6c 6f 6e 67 2c 20 30 20 74 6f 20 4e 20 62 79 long, 0 to N by
19ac0 74 65 73 20 6f 66 20 70 61 79 6c 6f 61 64 2c 20 tes of payload,
19ad0 61 6e 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 and an optional
19ae0 34 20 62 79 74 65 20 6f 76 65 72 66 6c 6f 77 0a 4 byte overflow.
19af0 20 20 2a 2a 20 70 61 67 65 20 70 6f 69 6e 74 65 ** page pointe
19b00 72 2e 0a 20 20 2a 2f 0a 20 20 70 42 74 2d 3e 6d r.. */. pBt->m
19b10 61 78 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 28 axLocal = (u16)(
19b20 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 (pBt->usableSize
19b30 2d 31 32 29 2a 36 34 2f 32 35 35 20 2d 20 32 33 -12)*64/255 - 23
19b40 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 6f 63 );. pBt->minLoc
19b50 61 6c 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d al = (u16)((pBt-
19b60 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a >usableSize-12)*
19b70 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 32/255 - 23);.
19b80 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 3d 20 28 pBt->maxLeaf = (
19b90 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 u16)(pBt->usable
19ba0 53 69 7a 65 20 2d 20 33 35 29 3b 0a 20 20 70 42 Size - 35);. pB
19bb0 74 2d 3e 6d 69 6e 4c 65 61 66 20 3d 20 28 75 31 t->minLeaf = (u1
19bc0 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 6)((pBt->usableS
19bd0 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d ize-12)*32/255 -
19be0 20 32 33 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 23);. if( pBt-
19bf0 3e 6d 61 78 4c 6f 63 61 6c 3e 31 32 37 20 29 7b >maxLocal>127 ){
19c00 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 . pBt->max1by
19c10 74 65 50 61 79 6c 6f 61 64 20 3d 20 31 32 37 3b tePayload = 127;
19c20 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 . }else{. pB
19c30 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f t->max1bytePaylo
19c40 61 64 20 3d 20 28 75 38 29 70 42 74 2d 3e 6d 61 ad = (u8)pBt->ma
19c50 78 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 61 73 xLocal;. }. as
19c60 73 65 72 74 28 20 70 42 74 2d 3e 6d 61 78 4c 65 sert( pBt->maxLe
19c70 61 66 20 2b 20 32 33 20 3c 3d 20 4d 58 5f 43 45 af + 23 <= MX_CE
19c80 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 29 3b 0a LL_SIZE(pBt) );.
19c90 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 pBt->pPage1 =
19ca0 70 50 61 67 65 31 3b 0a 20 20 70 42 74 2d 3e 6e pPage1;. pBt->n
19cb0 50 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 Page = nPage;.
19cc0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
19cd0 3b 0a 0a 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 ;..page1_init_fa
19ce0 69 6c 65 64 3a 0a 20 20 72 65 6c 65 61 73 65 50 iled:. releaseP
19cf0 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 70 age(pPage1);. p
19d00 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a Bt->pPage1 = 0;.
19d10 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
19d20 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 2f #ifndef NDEBUG./
19d30 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
19d40 6e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f 72 number of cursor
19d50 73 20 6f 70 65 6e 20 6f 6e 20 70 42 74 2e 20 54 s open on pBt. T
19d60 68 69 73 20 69 73 20 66 6f 72 20 75 73 65 0a 2a his is for use.*
19d70 2a 20 69 6e 20 61 73 73 65 72 74 28 29 20 65 78 * in assert() ex
19d80 70 72 65 73 73 69 6f 6e 73 2c 20 73 6f 20 69 74 pressions, so it
19d90 20 69 73 20 6f 6e 6c 79 20 63 6f 6d 70 69 6c 65 is only compile
19da0 64 20 69 66 20 4e 44 45 42 55 47 20 69 73 20 6e d if NDEBUG is n
19db0 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 64 2e 0a 2a ot.** defined..*
19dc0 2a 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 65 20 *.** Only write
19dd0 63 75 72 73 6f 72 73 20 61 72 65 20 63 6f 75 6e cursors are coun
19de0 74 65 64 20 69 66 20 77 72 4f 6e 6c 79 20 69 73 ted if wrOnly is
19df0 20 74 72 75 65 2e 20 20 49 66 20 77 72 4f 6e 6c true. If wrOnl
19e00 79 20 69 73 0a 2a 2a 20 66 61 6c 73 65 20 74 68 y is.** false th
19e10 65 6e 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 61 en all cursors a
19e20 72 65 20 63 6f 75 6e 74 65 64 2e 0a 2a 2a 0a 2a re counted..**.*
19e30 2a 20 46 6f 72 20 74 68 65 20 70 75 72 70 6f 73 * For the purpos
19e40 65 73 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 es of this routi
19e50 6e 65 2c 20 61 20 63 75 72 73 6f 72 20 69 73 20 ne, a cursor is
19e60 61 6e 79 20 63 75 72 73 6f 72 20 74 68 61 74 0a any cursor that.
19e70 2a 2a 20 69 73 20 63 61 70 61 62 6c 65 20 6f 66 ** is capable of
19e80 20 72 65 61 64 69 6e 67 20 6f 72 20 77 72 69 74 reading or writ
19e90 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 ing to the datab
19ea0 61 73 65 2e 20 20 43 75 72 73 6f 72 73 20 74 68 ase. Cursors th
19eb0 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 at.** have been
19ec0 74 72 69 70 70 65 64 20 69 6e 74 6f 20 74 68 65 tripped into the
19ed0 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 73 74 CURSOR_FAULT st
19ee0 61 74 65 20 61 72 65 20 6e 6f 74 20 63 6f 75 6e ate are not coun
19ef0 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ted..*/.static i
19f00 6e 74 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 nt countValidCur
19f10 73 6f 72 73 28 42 74 53 68 61 72 65 64 20 2a 70 sors(BtShared *p
19f20 42 74 2c 20 69 6e 74 20 77 72 4f 6e 6c 79 29 7b Bt, int wrOnly){
19f30 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
19f40 72 3b 0a 20 20 69 6e 74 20 72 20 3d 20 30 3b 0a r;. int r = 0;.
19f50 20 20 66 6f 72 28 70 43 75 72 3d 70 42 74 2d 3e for(pCur=pBt->
19f60 70 43 75 72 73 6f 72 3b 20 70 43 75 72 3b 20 70 pCursor; pCur; p
19f70 43 75 72 3d 70 43 75 72 2d 3e 70 4e 65 78 74 29 Cur=pCur->pNext)
19f80 7b 0a 20 20 20 20 69 66 28 20 28 77 72 4f 6e 6c {. if( (wrOnl
19f90 79 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e 63 y==0 || (pCur->c
19fa0 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 57 urFlags & BTCF_W
19fb0 72 69 74 65 46 6c 61 67 29 21 3d 30 29 0a 20 20 riteFlag)!=0).
19fc0 20 20 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 && pCur->eSta
19fd0 74 65 21 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 te!=CURSOR_FAULT
19fe0 20 29 20 72 2b 2b 3b 20 0a 20 20 7d 0a 20 20 72 ) r++; . }. r
19ff0 65 74 75 72 6e 20 72 3b 0a 7d 0a 23 65 6e 64 69 eturn r;.}.#endi
1a000 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 72 f../*.** If ther
1a010 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e e are no outstan
1a020 64 69 6e 67 20 63 75 72 73 6f 72 73 20 61 6e 64 ding cursors and
1a030 20 77 65 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 we are not in t
1a040 68 65 20 6d 69 64 64 6c 65 0a 2a 2a 20 6f 66 20 he middle.** of
1a050 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 75 a transaction bu
1a060 74 20 74 68 65 72 65 20 69 73 20 61 20 72 65 61 t there is a rea
1a070 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 d lock on the da
1a080 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 2a 2a 20 tabase, then.**
1a090 74 68 69 73 20 72 6f 75 74 69 6e 65 20 75 6e 72 this routine unr
1a0a0 65 66 73 20 74 68 65 20 66 69 72 73 74 20 70 61 efs the first pa
1a0b0 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ge of the databa
1a0c0 73 65 20 66 69 6c 65 20 77 68 69 63 68 20 0a 2a se file which .*
1a0d0 2a 20 68 61 73 20 74 68 65 20 65 66 66 65 63 74 * has the effect
1a0e0 20 6f 66 20 72 65 6c 65 61 73 69 6e 67 20 74 68 of releasing th
1a0f0 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2a 0a e read lock..**.
1a100 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61 ** If there is a
1a110 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 transaction in
1a120 70 72 6f 67 72 65 73 73 2c 20 74 68 69 73 20 72 progress, this r
1a130 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f outine is a no-o
1a140 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 p..*/.static voi
1a150 64 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 d unlockBtreeIfU
1a160 6e 75 73 65 64 28 42 74 53 68 61 72 65 64 20 2a nused(BtShared *
1a170 70 42 74 29 7b 0a 20 20 61 73 73 65 72 74 28 20 pBt){. assert(
1a180 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
1a190 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
1a1a0 3b 0a 20 20 61 73 73 65 72 74 28 20 63 6f 75 6e ;. assert( coun
1a1b0 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 70 42 tValidCursors(pB
1a1c0 74 2c 30 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e t,0)==0 || pBt->
1a1d0 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3e 54 52 inTransaction>TR
1a1e0 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 69 66 ANS_NONE );. if
1a1f0 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 ( pBt->inTransac
1a200 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 tion==TRANS_NONE
1a210 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 21 && pBt->pPage1!
1a220 3d 30 20 29 7b 0a 20 20 20 20 4d 65 6d 50 61 67 =0 ){. MemPag
1a230 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 2d e *pPage1 = pBt-
1a240 3e 70 50 61 67 65 31 3b 0a 20 20 20 20 61 73 73 >pPage1;. ass
1a250 65 72 74 28 20 70 50 61 67 65 31 2d 3e 61 44 61 ert( pPage1->aDa
1a260 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 ta );. assert
1a270 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 ( sqlite3PagerRe
1a280 66 63 6f 75 6e 74 28 70 42 74 2d 3e 70 50 61 67 fcount(pBt->pPag
1a290 65 72 29 3d 3d 31 20 29 3b 0a 20 20 20 20 70 42 er)==1 );. pB
1a2a0 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 t->pPage1 = 0;.
1a2b0 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 4e 6f releasePageNo
1a2c0 74 4e 75 6c 6c 28 70 50 61 67 65 31 29 3b 0a 20 tNull(pPage1);.
1a2d0 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 70 }.}../*.** If p
1a2e0 42 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 Bt points to an
1a2f0 65 6d 70 74 79 20 66 69 6c 65 20 74 68 65 6e 20 empty file then
1a300 63 6f 6e 76 65 72 74 20 74 68 61 74 20 65 6d 70 convert that emp
1a310 74 79 20 66 69 6c 65 0a 2a 2a 20 69 6e 74 6f 20 ty file.** into
1a320 61 20 6e 65 77 20 65 6d 70 74 79 20 64 61 74 61 a new empty data
1a330 62 61 73 65 20 62 79 20 69 6e 69 74 69 61 6c 69 base by initiali
1a340 7a 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 zing the first p
1a350 61 67 65 20 6f 66 0a 2a 2a 20 74 68 65 20 64 61 age of.** the da
1a360 74 61 62 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 tabase..*/.stati
1a370 63 20 69 6e 74 20 6e 65 77 44 61 74 61 62 61 73 c int newDatabas
1a380 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 e(BtShared *pBt)
1a390 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 31 {. MemPage *pP1
1a3a0 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 ;. unsigned cha
1a3b0 72 20 2a 64 61 74 61 3b 0a 20 20 69 6e 74 20 72 r *data;. int r
1a3c0 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 c;.. assert( sq
1a3d0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
1a3e0 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
1a3f0 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 if( pBt->nPage
1a400 3e 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e >0 ){. return
1a410 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
1a420 20 20 70 50 31 20 3d 20 70 42 74 2d 3e 70 50 61 pP1 = pBt->pPa
1a430 67 65 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ge1;. assert( p
1a440 50 31 21 3d 30 20 29 3b 0a 20 20 64 61 74 61 20 P1!=0 );. data
1a450 3d 20 70 50 31 2d 3e 61 44 61 74 61 3b 0a 20 20 = pP1->aData;.
1a460 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
1a470 72 57 72 69 74 65 28 70 50 31 2d 3e 70 44 62 50 rWrite(pP1->pDbP
1a480 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 age);. if( rc )
1a490 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 6d 65 return rc;. me
1a4a0 6d 63 70 79 28 64 61 74 61 2c 20 7a 4d 61 67 69 mcpy(data, zMagi
1a4b0 63 48 65 61 64 65 72 2c 20 73 69 7a 65 6f 66 28 cHeader, sizeof(
1a4c0 7a 4d 61 67 69 63 48 65 61 64 65 72 29 29 3b 0a zMagicHeader));.
1a4d0 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 assert( sizeof
1a4e0 28 7a 4d 61 67 69 63 48 65 61 64 65 72 29 3d 3d (zMagicHeader)==
1a4f0 31 36 20 29 3b 0a 20 20 64 61 74 61 5b 31 36 5d 16 );. data[16]
1a500 20 3d 20 28 75 38 29 28 28 70 42 74 2d 3e 70 61 = (u8)((pBt->pa
1a510 67 65 53 69 7a 65 3e 3e 38 29 26 30 78 66 66 29 geSize>>8)&0xff)
1a520 3b 0a 20 20 64 61 74 61 5b 31 37 5d 20 3d 20 28 ;. data[17] = (
1a530 75 38 29 28 28 70 42 74 2d 3e 70 61 67 65 53 69 u8)((pBt->pageSi
1a540 7a 65 3e 3e 31 36 29 26 30 78 66 66 29 3b 0a 20 ze>>16)&0xff);.
1a550 20 64 61 74 61 5b 31 38 5d 20 3d 20 31 3b 0a 20 data[18] = 1;.
1a560 20 64 61 74 61 5b 31 39 5d 20 3d 20 31 3b 0a 20 data[19] = 1;.
1a570 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 73 assert( pBt->us
1a580 61 62 6c 65 53 69 7a 65 3c 3d 70 42 74 2d 3e 70 ableSize<=pBt->p
1a590 61 67 65 53 69 7a 65 20 26 26 20 70 42 74 2d 3e ageSize && pBt->
1a5a0 75 73 61 62 6c 65 53 69 7a 65 2b 32 35 35 3e 3d usableSize+255>=
1a5b0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a pBt->pageSize);.
1a5c0 20 20 64 61 74 61 5b 32 30 5d 20 3d 20 28 75 38 data[20] = (u8
1a5d0 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 )(pBt->pageSize
1a5e0 2d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a - pBt->usableSiz
1a5f0 65 29 3b 0a 20 20 64 61 74 61 5b 32 31 5d 20 3d e);. data[21] =
1a600 20 36 34 3b 0a 20 20 64 61 74 61 5b 32 32 5d 20 64;. data[22]
1a610 3d 20 33 32 3b 0a 20 20 64 61 74 61 5b 32 33 5d = 32;. data[23]
1a620 20 3d 20 33 32 3b 0a 20 20 6d 65 6d 73 65 74 28 = 32;. memset(
1a630 26 64 61 74 61 5b 32 34 5d 2c 20 30 2c 20 31 30 &data[24], 0, 10
1a640 30 2d 32 34 29 3b 0a 20 20 7a 65 72 6f 50 61 67 0-24);. zeroPag
1a650 65 28 70 50 31 2c 20 50 54 46 5f 49 4e 54 4b 45 e(pP1, PTF_INTKE
1a660 59 7c 50 54 46 5f 4c 45 41 46 7c 50 54 46 5f 4c Y|PTF_LEAF|PTF_L
1a670 45 41 46 44 41 54 41 20 29 3b 0a 20 20 70 42 74 EAFDATA );. pBt
1a680 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
1a690 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 S_PAGESIZE_FIXED
1a6a0 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
1a6b0 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
1a6c0 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
1a6d0 61 75 74 6f 56 61 63 75 75 6d 3d 3d 31 20 7c 7c autoVacuum==1 ||
1a6e0 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
1a6f0 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
1a700 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
1a710 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 69 6e 63 72 ==1 || pBt->incr
1a720 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 70 Vacuum==0 );. p
1a730 75 74 34 62 79 74 65 28 26 64 61 74 61 5b 33 36 ut4byte(&data[36
1a740 20 2b 20 34 2a 34 5d 2c 20 70 42 74 2d 3e 61 75 + 4*4], pBt->au
1a750 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 70 75 74 toVacuum);. put
1a760 34 62 79 74 65 28 26 64 61 74 61 5b 33 36 20 2b 4byte(&data[36 +
1a770 20 37 2a 34 5d 2c 20 70 42 74 2d 3e 69 6e 63 72 7*4], pBt->incr
1a780 56 61 63 75 75 6d 29 3b 0a 23 65 6e 64 69 66 0a Vacuum);.#endif.
1a790 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 31 pBt->nPage = 1
1a7a0 3b 0a 20 20 64 61 74 61 5b 33 31 5d 20 3d 20 31 ;. data[31] = 1
1a7b0 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
1a7c0 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 E_OK;.}../*.** I
1a7d0 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 66 69 nitialize the fi
1a7e0 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 rst page of the
1a7f0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 63 database file (c
1a800 72 65 61 74 69 6e 67 20 61 20 64 61 74 61 62 61 reating a databa
1a810 73 65 0a 2a 2a 20 63 6f 6e 73 69 73 74 69 6e 67 se.** consisting
1a820 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 70 61 67 of a single pag
1a830 65 20 61 6e 64 20 6e 6f 20 73 63 68 65 6d 61 20 e and no schema
1a840 6f 62 6a 65 63 74 73 29 2e 20 52 65 74 75 72 6e objects). Return
1a850 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 66 SQLITE_OK.** if
1a860 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 successful, or
1a870 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
1a880 63 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a code otherwise..
1a890 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1a8a0 72 65 65 4e 65 77 44 62 28 42 74 72 65 65 20 2a reeNewDb(Btree *
1a8b0 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 p){. int rc;.
1a8c0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1a8d0 72 28 70 29 3b 0a 20 20 70 2d 3e 70 42 74 2d 3e r(p);. p->pBt->
1a8e0 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 72 63 20 nPage = 0;. rc
1a8f0 3d 20 6e 65 77 44 61 74 61 62 61 73 65 28 70 2d = newDatabase(p-
1a900 3e 70 42 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 >pBt);. sqlite3
1a910 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1a920 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1a930 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 *.** Attempt to
1a940 73 74 61 72 74 20 61 20 6e 65 77 20 74 72 61 6e start a new tran
1a950 73 61 63 74 69 6f 6e 2e 20 41 20 77 72 69 74 65 saction. A write
1a960 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 -transaction.**
1a970 69 73 20 73 74 61 72 74 65 64 20 69 66 20 74 68 is started if th
1a980 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
1a990 74 20 69 73 20 6e 6f 6e 7a 65 72 6f 2c 20 6f 74 t is nonzero, ot
1a9a0 68 65 72 77 69 73 65 20 61 20 72 65 61 64 2d 0a herwise a read-.
1a9b0 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ** transaction.
1a9c0 20 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 If the second a
1a9d0 72 67 75 6d 65 6e 74 20 69 73 20 32 20 6f 72 20 rgument is 2 or
1a9e0 6d 6f 72 65 20 61 6e 64 20 65 78 63 6c 75 73 69 more and exclusi
1a9f0 76 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f ve.** transactio
1aa00 6e 20 69 73 20 73 74 61 72 74 65 64 2c 20 6d 65 n is started, me
1aa10 61 6e 69 6e 67 20 74 68 61 74 20 6e 6f 20 6f 74 aning that no ot
1aa20 68 65 72 20 70 72 6f 63 65 73 73 20 69 73 20 61 her process is a
1aa30 6c 6c 6f 77 65 64 0a 2a 2a 20 74 6f 20 61 63 63 llowed.** to acc
1aa40 65 73 73 20 74 68 65 20 64 61 74 61 62 61 73 65 ess the database
1aa50 2e 20 20 41 20 70 72 65 65 78 69 73 74 69 6e 67 . A preexisting
1aa60 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 79 transaction may
1aa70 20 6e 6f 74 20 62 65 0a 2a 2a 20 75 70 67 72 61 not be.** upgra
1aa80 64 65 64 20 74 6f 20 65 78 63 6c 75 73 69 76 65 ded to exclusive
1aa90 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 by calling this
1aaa0 20 72 6f 75 74 69 6e 65 20 61 20 73 65 63 6f 6e routine a secon
1aab0 64 20 74 69 6d 65 20 2d 20 74 68 65 0a 2a 2a 20 d time - the.**
1aac0 65 78 63 6c 75 73 69 76 69 74 79 20 66 6c 61 67 exclusivity flag
1aad0 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 6f 72 20 only works for
1aae0 61 20 6e 65 77 20 74 72 61 6e 73 61 63 74 69 6f a new transactio
1aaf0 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 77 72 69 74 65 n..**.** A write
1ab00 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 -transaction mus
1ab10 74 20 62 65 20 73 74 61 72 74 65 64 20 62 65 66 t be started bef
1ab20 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 61 ore attempting a
1ab30 6e 79 20 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74 ny .** changes t
1ab40 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 o the database.
1ab50 20 4e 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c None of the fol
1ab60 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 lowing routines
1ab70 0a 2a 2a 20 77 69 6c 6c 20 77 6f 72 6b 20 75 6e .** will work un
1ab80 6c 65 73 73 20 61 20 74 72 61 6e 73 61 63 74 69 less a transacti
1ab90 6f 6e 20 69 73 20 73 74 61 72 74 65 64 20 66 69 on is started fi
1aba0 72 73 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 rst:.**.**
1abb0 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 61 sqlite3BtreeCrea
1abc0 74 65 54 61 62 6c 65 28 29 0a 2a 2a 20 20 20 20 teTable().**
1abd0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 sqlite3BtreeCr
1abe0 65 61 74 65 49 6e 64 65 78 28 29 0a 2a 2a 20 20 eateIndex().**
1abf0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1ac00 43 6c 65 61 72 54 61 62 6c 65 28 29 0a 2a 2a 20 ClearTable().**
1ac10 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
1ac20 65 44 72 6f 70 54 61 62 6c 65 28 29 0a 2a 2a 20 eDropTable().**
1ac30 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
1ac40 65 49 6e 73 65 72 74 28 29 0a 2a 2a 20 20 20 20 eInsert().**
1ac50 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 65 sqlite3BtreeDe
1ac60 6c 65 74 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 lete().** s
1ac70 71 6c 69 74 65 33 42 74 72 65 65 55 70 64 61 74 qlite3BtreeUpdat
1ac80 65 4d 65 74 61 28 29 0a 2a 2a 0a 2a 2a 20 49 66 eMeta().**.** If
1ac90 20 61 6e 20 69 6e 69 74 69 61 6c 20 61 74 74 65 an initial atte
1aca0 6d 70 74 20 74 6f 20 61 63 71 75 69 72 65 20 74 mpt to acquire t
1acb0 68 65 20 6c 6f 63 6b 20 66 61 69 6c 73 20 62 65 he lock fails be
1acc0 63 61 75 73 65 20 6f 66 20 6c 6f 63 6b 20 63 6f cause of lock co
1acd0 6e 74 65 6e 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 ntention.** and
1ace0 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61 73 the database was
1acf0 20 70 72 65 76 69 6f 75 73 6c 79 20 75 6e 6c 6f previously unlo
1ad00 63 6b 65 64 2c 20 74 68 65 6e 20 69 6e 76 6f 6b cked, then invok
1ad10 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c e the busy handl
1ad20 65 72 0a 2a 2a 20 69 66 20 74 68 65 72 65 20 69 er.** if there i
1ad30 73 20 6f 6e 65 2e 20 20 42 75 74 20 69 66 20 74 s one. But if t
1ad40 68 65 72 65 20 77 61 73 20 70 72 65 76 69 6f 75 here was previou
1ad50 73 6c 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 2c sly a read-lock,
1ad60 20 64 6f 20 6e 6f 74 0a 2a 2a 20 69 6e 76 6f 6b do not.** invok
1ad70 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c e the busy handl
1ad80 65 72 20 2d 20 6a 75 73 74 20 72 65 74 75 72 6e er - just return
1ad90 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 20 53 SQLITE_BUSY. S
1ada0 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 0a 2a QLITE_BUSY is .*
1adb0 2a 20 72 65 74 75 72 6e 65 64 20 77 68 65 6e 20 * returned when
1adc0 74 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 79 there is already
1add0 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 69 6e 20 a read-lock in
1ade0 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 61 order to avoid a
1adf0 20 64 65 61 64 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a deadlock..**.**
1ae00 20 53 75 70 70 6f 73 65 20 74 68 65 72 65 20 61 Suppose there a
1ae10 72 65 20 74 77 6f 20 70 72 6f 63 65 73 73 65 73 re two processes
1ae20 20 41 20 61 6e 64 20 42 2e 20 20 41 20 68 61 73 A and B. A has
1ae30 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 61 6e 64 a read lock and
1ae40 20 42 20 68 61 73 0a 2a 2a 20 61 20 72 65 73 65 B has.** a rese
1ae50 72 76 65 64 20 6c 6f 63 6b 2e 20 20 42 20 74 72 rved lock. B tr
1ae60 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 74 ies to promote t
1ae70 6f 20 65 78 63 6c 75 73 69 76 65 20 62 75 74 20 o exclusive but
1ae80 69 73 20 62 6c 6f 63 6b 65 64 20 62 65 63 61 75 is blocked becau
1ae90 73 65 0a 2a 2a 20 6f 66 20 41 27 73 20 72 65 61 se.** of A's rea
1aea0 64 20 6c 6f 63 6b 2e 20 20 41 20 74 72 69 65 73 d lock. A tries
1aeb0 20 74 6f 20 70 72 6f 6d 6f 74 65 20 74 6f 20 72 to promote to r
1aec0 65 73 65 72 76 65 64 20 62 75 74 20 69 73 20 62 eserved but is b
1aed0 6c 6f 63 6b 65 64 20 62 79 20 42 2e 0a 2a 2a 20 locked by B..**
1aee0 4f 6e 65 20 6f 72 20 74 68 65 20 6f 74 68 65 72 One or the other
1aef0 20 6f 66 20 74 68 65 20 74 77 6f 20 70 72 6f 63 of the two proc
1af00 65 73 73 65 73 20 6d 75 73 74 20 67 69 76 65 20 esses must give
1af10 77 61 79 20 6f 72 20 74 68 65 72 65 20 63 61 6e way or there can
1af20 20 62 65 0a 2a 2a 20 6e 6f 20 70 72 6f 67 72 65 be.** no progre
1af30 73 73 2e 20 20 42 79 20 72 65 74 75 72 6e 69 6e ss. By returnin
1af40 67 20 53 51 4c 49 54 45 5f 42 55 53 59 20 61 6e g SQLITE_BUSY an
1af50 64 20 6e 6f 74 20 69 6e 76 6f 6b 69 6e 67 20 74 d not invoking t
1af60 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b he busy callback
1af70 0a 2a 2a 20 77 68 65 6e 20 41 20 61 6c 72 65 61 .** when A alrea
1af80 64 79 20 68 61 73 20 61 20 72 65 61 64 20 6c 6f dy has a read lo
1af90 63 6b 2c 20 77 65 20 65 6e 63 6f 75 72 61 67 65 ck, we encourage
1afa0 20 41 20 74 6f 20 67 69 76 65 20 75 70 20 61 6e A to give up an
1afb0 64 20 6c 65 74 20 42 0a 2a 2a 20 70 72 6f 63 65 d let B.** proce
1afc0 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
1afd0 65 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e e3BtreeBeginTran
1afe0 73 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 s(Btree *p, int
1aff0 77 72 66 6c 61 67 29 7b 0a 20 20 42 74 53 68 61 wrflag){. BtSha
1b000 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
1b010 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 t;. int rc = SQ
1b020 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c 69 LITE_OK;.. sqli
1b030 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
1b040 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 ;. btreeIntegri
1b050 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 ty(p);.. /* If
1b060 74 68 65 20 62 74 72 65 65 20 69 73 20 61 6c 72 the btree is alr
1b070 65 61 64 79 20 69 6e 20 61 20 77 72 69 74 65 2d eady in a write-
1b080 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 20 transaction, or
1b090 69 74 0a 20 20 2a 2a 20 69 73 20 61 6c 72 65 61 it. ** is alrea
1b0a0 64 79 20 69 6e 20 61 20 72 65 61 64 2d 74 72 61 dy in a read-tra
1b0b0 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 61 20 72 nsaction and a r
1b0c0 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a ead-transaction.
1b0d0 20 20 2a 2a 20 69 73 20 72 65 71 75 65 73 74 65 ** is requeste
1b0e0 64 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d d, this is a no-
1b0f0 6f 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 op.. */. if( p
1b100 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
1b110 5f 57 52 49 54 45 20 7c 7c 20 28 70 2d 3e 69 6e _WRITE || (p->in
1b120 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 41 Trans==TRANS_REA
1b130 44 20 26 26 20 21 77 72 66 6c 61 67 29 20 29 7b D && !wrflag) ){
1b140 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f . goto trans_
1b150 62 65 67 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 73 begun;. }. ass
1b160 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e ert( pBt->inTran
1b170 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 saction==TRANS_W
1b180 52 49 54 45 20 7c 7c 20 49 66 4e 6f 74 4f 6d 69 RITE || IfNotOmi
1b190 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 75 6e tAV(pBt->bDoTrun
1b1a0 63 61 74 65 29 3d 3d 30 20 29 3b 0a 0a 20 20 2f cate)==0 );.. /
1b1b0 2a 20 57 72 69 74 65 20 74 72 61 6e 73 61 63 74 * Write transact
1b1c0 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 70 6f 73 ions are not pos
1b1d0 73 69 62 6c 65 20 6f 6e 20 61 20 72 65 61 64 2d sible on a read-
1b1e0 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 20 2a 2f only database */
1b1f0 0a 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 . if( (pBt->bts
1b200 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 44 Flags & BTS_READ
1b210 5f 4f 4e 4c 59 29 21 3d 30 20 26 26 20 77 72 66 _ONLY)!=0 && wrf
1b220 6c 61 67 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 lag ){. rc =
1b230 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b SQLITE_READONLY;
1b240 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f . goto trans_
1b250 62 65 67 75 6e 3b 0a 20 20 7d 0a 0a 23 69 66 6e begun;. }..#ifn
1b260 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1b270 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 7b SHARED_CACHE. {
1b280 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 70 42 . sqlite3 *pB
1b290 6c 6f 63 6b 20 3d 20 30 3b 0a 20 20 20 20 2f 2a lock = 0;. /*
1b2a0 20 49 66 20 61 6e 6f 74 68 65 72 20 64 61 74 61 If another data
1b2b0 62 61 73 65 20 68 61 6e 64 6c 65 20 68 61 73 20 base handle has
1b2c0 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20 61 already opened a
1b2d0 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
1b2e0 6f 6e 20 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 on . ** on th
1b2f0 69 73 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 is shared-btree
1b300 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 61 20 structure and a
1b310 73 65 63 6f 6e 64 20 77 72 69 74 65 20 74 72 61 second write tra
1b320 6e 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 20 20 nsaction is.
1b330 2a 2a 20 72 65 71 75 65 73 74 65 64 2c 20 72 65 ** requested, re
1b340 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b turn SQLITE_LOCK
1b350 45 44 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ED.. */. i
1b360 66 28 20 28 77 72 66 6c 61 67 20 26 26 20 70 42 f( (wrflag && pB
1b370 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
1b380 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 29 0a 20 ==TRANS_WRITE).
1b390 20 20 20 20 7c 7c 20 28 70 42 74 2d 3e 62 74 73 || (pBt->bts
1b3a0 46 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e 44 Flags & BTS_PEND
1b3b0 49 4e 47 29 21 3d 30 0a 20 20 20 20 29 7b 0a 20 ING)!=0. ){.
1b3c0 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 pBlock = pB
1b3d0 74 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a t->pWriter->db;.
1b3e0 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 77 72 }else if( wr
1b3f0 66 6c 61 67 3e 31 20 29 7b 0a 20 20 20 20 20 20 flag>1 ){.
1b400 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 20 BtLock *pIter;.
1b410 20 20 20 20 20 66 6f 72 28 70 49 74 65 72 3d 70 for(pIter=p
1b420 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 Bt->pLock; pIter
1b430 3b 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 ; pIter=pIter->p
1b440 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 69 Next){. i
1b450 66 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 f( pIter->pBtree
1b460 21 3d 70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 !=p ){.
1b470 20 70 42 6c 6f 63 6b 20 3d 20 70 49 74 65 72 2d pBlock = pIter-
1b480 3e 70 42 74 72 65 65 2d 3e 64 62 3b 0a 20 20 20 >pBtree->db;.
1b490 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
1b4a0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
1b4b0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 42 }. if( pB
1b4c0 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 73 71 lock ){. sq
1b4d0 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 lite3ConnectionB
1b4e0 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 42 locked(p->db, pB
1b4f0 6c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 72 63 20 lock);. rc
1b500 3d 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f = SQLITE_LOCKED_
1b510 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 20 SHAREDCACHE;.
1b520 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 goto trans_be
1b530 67 75 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 gun;. }. }.#
1b540 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 endif.. /* Any
1b550 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 read-only or rea
1b560 64 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 d-write transact
1b570 69 6f 6e 20 69 6d 70 6c 69 65 73 20 61 20 72 65 ion implies a re
1b580 61 64 2d 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a ad-lock on . **
1b590 20 70 61 67 65 20 31 2e 20 53 6f 20 69 66 20 73 page 1. So if s
1b5a0 6f 6d 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 ome other shared
1b5b0 2d 63 61 63 68 65 20 63 6c 69 65 6e 74 20 61 6c -cache client al
1b5c0 72 65 61 64 79 20 68 61 73 20 61 20 77 72 69 74 ready has a writ
1b5d0 65 2d 6c 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 e-lock . ** on
1b5e0 70 61 67 65 20 31 2c 20 74 68 65 20 74 72 61 6e page 1, the tran
1b5f0 73 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 saction cannot b
1b600 65 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 e opened. */. r
1b610 63 20 3d 20 71 75 65 72 79 53 68 61 72 65 64 43 c = querySharedC
1b620 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c acheTableLock(p,
1b630 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 MASTER_ROOT, RE
1b640 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 AD_LOCK);. if(
1b650 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 SQLITE_OK!=rc )
1b660 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e goto trans_begun
1b670 3b 0a 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 ;.. pBt->btsFla
1b680 67 73 20 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 gs &= ~BTS_INITI
1b690 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 ALLY_EMPTY;. if
1b6a0 28 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 ( pBt->nPage==0
1b6b0 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ) pBt->btsFlags
1b6c0 7c 3d 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 |= BTS_INITIALLY
1b6d0 5f 45 4d 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 _EMPTY;. do {.
1b6e0 20 20 20 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 /* Call lockB
1b6f0 74 72 65 65 28 29 20 75 6e 74 69 6c 20 65 69 74 tree() until eit
1b700 68 65 72 20 70 42 74 2d 3e 70 50 61 67 65 31 20 her pBt->pPage1
1b710 69 73 20 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a is populated or.
1b720 20 20 20 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 ** lockBtree
1b730 28 29 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 () returns somet
1b740 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 hing other than
1b750 53 51 4c 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 SQLITE_OK. lockB
1b760 74 72 65 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 tree(). ** ma
1b770 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f y return SQLITE_
1b780 4f 4b 20 62 75 74 20 6c 65 61 76 65 20 70 42 74 OK but leave pBt
1b790 2d 3e 70 50 61 67 65 31 20 73 65 74 20 74 6f 20 ->pPage1 set to
1b7a0 30 20 69 66 20 61 66 74 65 72 0a 20 20 20 20 2a 0 if after. *
1b7b0 2a 20 72 65 61 64 69 6e 67 20 70 61 67 65 20 31 * reading page 1
1b7c0 20 69 74 20 64 69 73 63 6f 76 65 72 73 20 74 68 it discovers th
1b7d0 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 at the page-size
1b7e0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1b7f0 20 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 . ** file is
1b800 20 6e 6f 74 20 70 42 74 2d 3e 70 61 67 65 53 69 not pBt->pageSi
1b810 7a 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ze. In this case
1b820 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 77 69 6c lockBtree() wil
1b830 6c 20 75 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 l update. **
1b840 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f pBt->pageSize to
1b850 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f the page-size o
1b860 66 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 f the file on di
1b870 73 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 sk.. */. w
1b880 68 69 6c 65 28 20 70 42 74 2d 3e 70 50 61 67 65 hile( pBt->pPage
1b890 31 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 1==0 && SQLITE_O
1b8a0 4b 3d 3d 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 K==(rc = lockBtr
1b8b0 65 65 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 ee(pBt)) );..
1b8c0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1b8d0 4f 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a OK && wrflag ){.
1b8e0 20 20 20 20 20 20 69 66 28 20 28 70 42 74 2d 3e if( (pBt->
1b8f0 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 btsFlags & BTS_R
1b900 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a EAD_ONLY)!=0 ){.
1b910 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
1b920 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 ITE_READONLY;.
1b930 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
1b940 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1b950 61 67 65 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 agerBegin(pBt->p
1b960 50 61 67 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 Pager,wrflag>1,s
1b970 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f qlite3TempInMemo
1b980 72 79 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 ry(p->db));.
1b990 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1b9a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1b9b0 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 rc = newDatab
1b9c0 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 ase(pBt);.
1b9d0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
1b9e0 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 72 63 21 }. . if( rc!
1b9f0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1ba00 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 unlockBtreeI
1ba10 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 fUnused(pBt);.
1ba20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 }. }while( (r
1ba30 63 26 30 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f c&0xFF)==SQLITE_
1ba40 42 55 53 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 BUSY && pBt->inT
1ba50 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
1ba60 53 5f 4e 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 S_NONE &&.
1ba70 20 20 20 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 btreeInvokeB
1ba80 75 73 79 48 61 6e 64 6c 65 72 28 70 42 74 29 20 usyHandler(pBt)
1ba90 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );.. if( rc==SQ
1baa0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
1bab0 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
1bac0 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 RANS_NONE ){.
1bad0 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 pBt->nTransac
1bae0 74 69 6f 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 tion++;.#ifndef
1baf0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
1bb00 45 44 5f 43 41 43 48 45 0a 20 20 20 20 20 20 69 ED_CACHE. i
1bb10 66 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 f( p->sharable )
1bb20 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
1bb30 28 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 ( p->lock.pBtree
1bb40 3d 3d 70 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 ==p && p->lock.i
1bb50 54 61 62 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 20 Table==1 );.
1bb60 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 p->lock.eLoc
1bb70 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 k = READ_LOCK;.
1bb80 20 20 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 p->lock.p
1bb90 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 Next = pBt->pLoc
1bba0 6b 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e k;. pBt->
1bbb0 70 4c 6f 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b pLock = &p->lock
1bbc0 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 ;. }.#endif
1bbd0 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 6e . }. p->in
1bbe0 54 72 61 6e 73 20 3d 20 28 77 72 66 6c 61 67 3f Trans = (wrflag?
1bbf0 54 52 41 4e 53 5f 57 52 49 54 45 3a 54 52 41 4e TRANS_WRITE:TRAN
1bc00 53 5f 52 45 41 44 29 3b 0a 20 20 20 20 69 66 28 S_READ);. if(
1bc10 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 70 42 74 2d p->inTrans>pBt-
1bc20 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 >inTransaction )
1bc30 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 {. pBt->inT
1bc40 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 70 2d 3e ransaction = p->
1bc50 69 6e 54 72 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 inTrans;. }.
1bc60 20 20 20 69 66 28 20 77 72 66 6c 61 67 20 29 7b if( wrflag ){
1bc70 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a . MemPage *
1bc80 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 pPage1 = pBt->pP
1bc90 61 67 65 31 3b 0a 23 69 66 6e 64 65 66 20 53 51 age1;.#ifndef SQ
1bca0 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
1bcb0 5f 43 41 43 48 45 0a 20 20 20 20 20 20 61 73 73 _CACHE. ass
1bcc0 65 72 74 28 20 21 70 42 74 2d 3e 70 57 72 69 74 ert( !pBt->pWrit
1bcd0 65 72 20 29 3b 0a 20 20 20 20 20 20 70 42 74 2d er );. pBt-
1bce0 3e 70 57 72 69 74 65 72 20 3d 20 70 3b 0a 20 20 >pWriter = p;.
1bcf0 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
1bd00 73 20 26 3d 20 7e 42 54 53 5f 45 58 43 4c 55 53 s &= ~BTS_EXCLUS
1bd10 49 56 45 3b 0a 20 20 20 20 20 20 69 66 28 20 77 IVE;. if( w
1bd20 72 66 6c 61 67 3e 31 20 29 20 70 42 74 2d 3e 62 rflag>1 ) pBt->b
1bd30 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 45 tsFlags |= BTS_E
1bd40 58 43 4c 55 53 49 56 45 3b 0a 23 65 6e 64 69 66 XCLUSIVE;.#endif
1bd50 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 .. /* If th
1bd60 65 20 64 62 2d 73 69 7a 65 20 68 65 61 64 65 72 e db-size header
1bd70 20 66 69 65 6c 64 20 69 73 20 69 6e 63 6f 72 72 field is incorr
1bd80 65 63 74 20 28 61 73 20 69 74 20 6d 61 79 20 62 ect (as it may b
1bd90 65 20 69 66 20 61 6e 20 6f 6c 64 0a 20 20 20 20 e if an old.
1bda0 20 20 2a 2a 20 63 6c 69 65 6e 74 20 68 61 73 20 ** client has
1bdb0 62 65 65 6e 20 77 72 69 74 69 6e 67 20 74 68 65 been writing the
1bdc0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 2c database file),
1bdd0 20 75 70 64 61 74 65 20 69 74 20 6e 6f 77 2e 20 update it now.
1bde0 44 6f 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 74 Doing. ** t
1bdf0 68 69 73 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 his sooner rathe
1be00 72 20 74 68 61 6e 20 6c 61 74 65 72 20 6d 65 61 r than later mea
1be10 6e 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ns the database
1be20 73 69 7a 65 20 63 61 6e 20 73 61 66 65 6c 79 20 size can safely
1be30 0a 20 20 20 20 20 20 2a 2a 20 72 65 2d 72 65 61 . ** re-rea
1be40 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 d the database s
1be50 69 7a 65 20 66 72 6f 6d 20 70 61 67 65 20 31 20 ize from page 1
1be60 69 66 20 61 20 73 61 76 65 70 6f 69 6e 74 20 6f if a savepoint o
1be70 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 r transaction.
1be80 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 ** rollback
1be90 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 occurs within th
1bea0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 e transaction..
1beb0 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 */. if
1bec0 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 67 65 ( pBt->nPage!=ge
1bed0 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
1bee0 61 44 61 74 61 5b 32 38 5d 29 20 29 7b 0a 20 20 aData[28]) ){.
1bef0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
1bf00 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 e3PagerWrite(pPa
1bf10 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
1bf20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 if( rc==S
1bf30 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1bf40 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 put4byte(&
1bf50 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 pPage1->aData[28
1bf60 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a ], pBt->nPage);.
1bf70 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
1bf80 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 }. }. }...tr
1bf90 61 6e 73 5f 62 65 67 75 6e 3a 0a 20 20 69 66 28 ans_begun:. if(
1bfa0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
1bfb0 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 20 & wrflag ){.
1bfc0 2f 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 61 6b /* This call mak
1bfd0 65 73 20 73 75 72 65 20 74 68 61 74 20 74 68 65 es sure that the
1bfe0 20 70 61 67 65 72 20 68 61 73 20 74 68 65 20 63 pager has the c
1bff0 6f 72 72 65 63 74 20 6e 75 6d 62 65 72 20 6f 66 orrect number of
1c000 0a 20 20 20 20 2a 2a 20 6f 70 65 6e 20 73 61 76 . ** open sav
1c010 65 70 6f 69 6e 74 73 2e 20 49 66 20 74 68 65 20 epoints. If the
1c020 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 second parameter
1c030 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
1c040 20 30 20 61 6e 64 0a 20 20 20 20 2a 2a 20 74 68 0 and. ** th
1c050 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 e sub-journal is
1c060 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 not already ope
1c070 6e 2c 20 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 n, then it will
1c080 62 65 20 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a be opened here..
1c090 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 */. rc =
1c0a0 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e sqlite3PagerOpen
1c0b0 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 Savepoint(pBt->p
1c0c0 50 61 67 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 Pager, p->db->nS
1c0d0 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a avepoint);. }..
1c0e0 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 btreeIntegrity
1c0f0 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 (p);. sqlite3Bt
1c100 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
1c110 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 eturn rc;.}..#if
1c120 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
1c130 5f 41 55 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a _AUTOVACUUM../*.
1c140 2a 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e 74 ** Set the point
1c150 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 20 66 er-map entries f
1c160 6f 72 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 or all children
1c170 6f 66 20 70 61 67 65 20 70 50 61 67 65 2e 20 41 of page pPage. A
1c180 6c 73 6f 2c 20 69 66 0a 2a 2a 20 70 50 61 67 65 lso, if.** pPage
1c190 20 63 6f 6e 74 61 69 6e 73 20 63 65 6c 6c 73 20 contains cells
1c1a0 74 68 61 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 that point to ov
1c1b0 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 73 65 erflow pages, se
1c1c0 74 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a t the pointer.**
1c1d0 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 map entries for
1c1e0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
1c1f0 67 65 73 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a ges as well..*/.
1c200 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 43 68 static int setCh
1c210 69 6c 64 50 74 72 6d 61 70 73 28 4d 65 6d 50 61 ildPtrmaps(MemPa
1c220 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
1c230 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
1c240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c250 20 2f 2a 20 43 6f 75 6e 74 65 72 20 76 61 72 69 /* Counter vari
1c260 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 able */. int nC
1c270 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
1c280 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1c290 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 Number of cells
1c2a0 69 6e 20 70 61 67 65 20 70 50 61 67 65 20 2a 2f in page pPage */
1c2b0 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
1c2c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c2d0 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
1c2e0 63 6f 64 65 20 2a 2f 0a 20 20 42 74 53 68 61 72 code */. BtShar
1c2f0 65 64 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d ed *pBt = pPage-
1c300 3e 70 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e >pBt;. Pgno pgn
1c310 6f 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3b o = pPage->pgno;
1c320 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
1c330 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
1c340 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
1c350 29 20 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 ) );. rc = btre
1c360 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 eInitPage(pPage)
1c370 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
1c380 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
1c390 63 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 61 c;. nCell = pPa
1c3a0 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 66 6f ge->nCell;.. fo
1c3b0 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 r(i=0; i<nCell;
1c3c0 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 43 i++){. u8 *pC
1c3d0 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 ell = findCell(p
1c3e0 50 61 67 65 2c 20 69 29 3b 0a 0a 20 20 20 20 70 Page, i);.. p
1c3f0 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 28 trmapPutOvflPtr(
1c400 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 72 pPage, pCell, &r
1c410 63 29 3b 0a 0a 20 20 20 20 69 66 28 20 21 70 50 c);.. if( !pP
1c420 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 age->leaf ){.
1c430 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 67 6e Pgno childPgn
1c440 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 43 65 o = get4byte(pCe
1c450 6c 6c 29 3b 0a 20 20 20 20 20 20 70 74 72 6d 61 ll);. ptrma
1c460 70 50 75 74 28 70 42 74 2c 20 63 68 69 6c 64 50 pPut(pBt, childP
1c470 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 54 52 45 gno, PTRMAP_BTRE
1c480 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 E, pgno, &rc);.
1c490 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 }. }.. if(
1c4a0 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a !pPage->leaf ){.
1c4b0 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 67 Pgno childPg
1c4c0 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 no = get4byte(&p
1c4d0 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
1c4e0 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
1c4f0 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 ;. ptrmapPut(
1c500 70 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 pBt, childPgno,
1c510 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 PTRMAP_BTREE, pg
1c520 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 7d 0a 0a 20 no, &rc);. }..
1c530 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1c540 2a 0a 2a 2a 20 53 6f 6d 65 77 68 65 72 65 20 6f *.** Somewhere o
1c550 6e 20 70 50 61 67 65 20 69 73 20 61 20 70 6f 69 n pPage is a poi
1c560 6e 74 65 72 20 74 6f 20 70 61 67 65 20 69 46 72 nter to page iFr
1c570 6f 6d 2e 20 20 4d 6f 64 69 66 79 20 74 68 69 73 om. Modify this
1c580 20 70 6f 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 74 pointer so.** t
1c590 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 6f hat it points to
1c5a0 20 69 54 6f 2e 20 50 61 72 61 6d 65 74 65 72 20 iTo. Parameter
1c5b0 65 54 79 70 65 20 64 65 73 63 72 69 62 65 73 20 eType describes
1c5c0 74 68 65 20 74 79 70 65 20 6f 66 20 70 6f 69 6e the type of poin
1c5d0 74 65 72 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f 64 ter to.** be mod
1c5e0 69 66 69 65 64 2c 20 61 73 20 20 66 6f 6c 6c 6f ified, as follo
1c5f0 77 73 3a 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 ws:.**.** PTRMAP
1c600 5f 42 54 52 45 45 3a 20 20 20 20 20 70 50 61 67 _BTREE: pPag
1c610 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 67 e is a btree-pag
1c620 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 e. The pointer p
1c630 6f 69 6e 74 73 20 61 74 20 61 20 63 68 69 6c 64 oints at a child
1c640 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 .**
1c650 20 20 20 20 20 20 20 70 61 67 65 20 6f 66 20 70 page of p
1c660 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d Page..**.** PTRM
1c670 41 50 5f 4f 56 45 52 46 4c 4f 57 31 3a 20 70 50 AP_OVERFLOW1: pP
1c680 61 67 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 age is a btree-p
1c690 61 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 age. The pointer
1c6a0 20 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 6f 76 points at an ov
1c6b0 65 72 66 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 20 erflow.**
1c6c0 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 page
1c6d0 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 6f pointed to by o
1c6e0 6e 65 20 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 ne of the cells
1c6f0 6f 6e 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 on pPage..**.**
1c700 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
1c710 3a 20 70 50 61 67 65 20 69 73 20 61 6e 20 6f 76 : pPage is an ov
1c720 65 72 66 6c 6f 77 2d 70 61 67 65 2e 20 54 68 65 erflow-page. The
1c730 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 pointer points
1c740 61 74 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 20 at the next.**
1c750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c760 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 overflow page i
1c770 6e 20 74 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 n the list..*/.s
1c780 74 61 74 69 63 20 69 6e 74 20 6d 6f 64 69 66 79 tatic int modify
1c790 50 61 67 65 50 6f 69 6e 74 65 72 28 4d 65 6d 50 PagePointer(MemP
1c7a0 61 67 65 20 2a 70 50 61 67 65 2c 20 50 67 6e 6f age *pPage, Pgno
1c7b0 20 69 46 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 6f iFrom, Pgno iTo
1c7c0 2c 20 75 38 20 65 54 79 70 65 29 7b 0a 20 20 61 , u8 eType){. a
1c7d0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
1c7e0 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
1c7f0 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
1c800 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
1c810 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
1c820 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
1c830 29 20 29 3b 0a 20 20 69 66 28 20 65 54 79 70 65 ) );. if( eType
1c840 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f ==PTRMAP_OVERFLO
1c850 57 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 W2 ){. /* The
1c860 20 70 6f 69 6e 74 65 72 20 69 73 20 61 6c 77 61 pointer is alwa
1c870 79 73 20 74 68 65 20 66 69 72 73 74 20 34 20 62 ys the first 4 b
1c880 79 74 65 73 20 6f 66 20 74 68 65 20 70 61 67 65 ytes of the page
1c890 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 in this case.
1c8a0 2a 2f 0a 20 20 20 20 69 66 28 20 67 65 74 34 62 */. if( get4b
1c8b0 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 yte(pPage->aData
1c8c0 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 )!=iFrom ){.
1c8d0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1c8e0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
1c8f0 20 20 7d 0a 20 20 20 20 70 75 74 34 62 79 74 65 }. put4byte
1c900 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 (pPage->aData, i
1c910 54 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 To);. }else{.
1c920 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 int i;. int
1c930 20 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e 74 20 nCell;. int
1c940 72 63 3b 0a 0a 20 20 20 20 72 63 20 3d 20 62 74 rc;.. rc = bt
1c950 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 reeInitPage(pPag
1c960 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 e);. if( rc )
1c970 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
1c980 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e nCell = pPage->n
1c990 43 65 6c 6c 3b 0a 0a 20 20 20 20 66 6f 72 28 69 Cell;.. for(i
1c9a0 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b =0; i<nCell; i++
1c9b0 29 7b 0a 20 20 20 20 20 20 75 38 20 2a 70 43 65 ){. u8 *pCe
1c9c0 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 ll = findCell(pP
1c9d0 61 67 65 2c 20 69 29 3b 0a 20 20 20 20 20 20 69 age, i);. i
1c9e0 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 f( eType==PTRMAP
1c9f0 5f 4f 56 45 52 46 4c 4f 57 31 20 29 7b 0a 20 20 _OVERFLOW1 ){.
1ca00 20 20 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 CellInfo i
1ca10 6e 66 6f 3b 0a 20 20 20 20 20 20 20 20 70 50 61 nfo;. pPa
1ca20 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 ge->xParseCell(p
1ca30 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e Page, pCell, &in
1ca40 66 6f 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 fo);. if(
1ca50 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 6e 66 info.nLocal<inf
1ca60 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 o.nPayload ){.
1ca70 20 20 20 20 20 20 20 20 69 66 28 20 70 43 65 6c if( pCel
1ca80 6c 2b 69 6e 66 6f 2e 6e 53 69 7a 65 20 3e 20 70 l+info.nSize > p
1ca90 50 61 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 Page->aData+pPag
1caa0 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
1cab0 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ze ){.
1cac0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1cad0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
1cae0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
1caf0 20 20 20 20 69 66 28 20 69 46 72 6f 6d 3d 3d 67 if( iFrom==g
1cb00 65 74 34 62 79 74 65 28 70 43 65 6c 6c 2b 69 6e et4byte(pCell+in
1cb10 66 6f 2e 6e 53 69 7a 65 2d 34 29 20 29 7b 0a 20 fo.nSize-4) ){.
1cb20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 put4b
1cb30 79 74 65 28 70 43 65 6c 6c 2b 69 6e 66 6f 2e 6e yte(pCell+info.n
1cb40 53 69 7a 65 2d 34 2c 20 69 54 6f 29 3b 0a 20 20 Size-4, iTo);.
1cb50 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
1cb60 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
1cb70 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c }. }el
1cb80 73 65 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 se{. if(
1cb90 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3d get4byte(pCell)=
1cba0 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 =iFrom ){.
1cbb0 20 20 20 20 70 75 74 34 62 79 74 65 28 70 43 65 put4byte(pCe
1cbc0 6c 6c 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 ll, iTo);.
1cbd0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
1cbe0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
1cbf0 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 69 3d }. . if( i=
1cc00 3d 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 =nCell ){.
1cc10 69 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 if( eType!=PTRMA
1cc20 50 5f 42 54 52 45 45 20 7c 7c 20 0a 20 20 20 20 P_BTREE || .
1cc30 20 20 20 20 20 20 67 65 74 34 62 79 74 65 28 26 get4byte(&
1cc40 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 pPage->aData[pPa
1cc50 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ge->hdrOffset+8]
1cc60 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 )!=iFrom ){.
1cc70 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1cc80 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
1cc90 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 75 }. pu
1cca0 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 t4byte(&pPage->a
1ccb0 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f Data[pPage->hdrO
1ccc0 66 66 73 65 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a ffset+8], iTo);.
1ccd0 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
1cce0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
1ccf0 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
1cd00 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 70 open database p
1cd10 61 67 65 20 70 44 62 50 61 67 65 20 74 6f 20 6c age pDbPage to l
1cd20 6f 63 61 74 69 6f 6e 20 69 46 72 65 65 50 61 67 ocation iFreePag
1cd30 65 20 69 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 e in the .** dat
1cd40 61 62 61 73 65 2e 20 54 68 65 20 70 44 62 50 61 abase. The pDbPa
1cd50 67 65 20 72 65 66 65 72 65 6e 63 65 20 72 65 6d ge reference rem
1cd60 61 69 6e 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a ains valid..**.*
1cd70 2a 20 54 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 * The isCommit f
1cd80 6c 61 67 20 69 6e 64 69 63 61 74 65 73 20 74 68 lag indicates th
1cd90 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e at there is no n
1cda0 65 65 64 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 eed to remember
1cdb0 74 68 61 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 that.** the jour
1cdc0 6e 61 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 20 nal needs to be
1cdd0 73 79 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 sync()ed before
1cde0 64 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 database page pD
1cdf0 62 50 61 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 bPage->pgno .**
1ce00 63 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 74 can be written t
1ce10 6f 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 68 61 o. The caller ha
1ce20 73 20 61 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 s already promis
1ce30 65 64 20 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 ed not to write
1ce40 74 6f 20 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e to that.** page.
1ce50 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 .*/.static int r
1ce60 65 6c 6f 63 61 74 65 50 61 67 65 28 0a 20 20 42 elocatePage(. B
1ce70 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 tShared *pBt,
1ce80 20 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 65 /* Btree
1ce90 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 */. MemPage *p
1cea0 44 62 50 61 67 65 2c 20 20 20 20 20 20 20 20 2f DbPage, /
1ceb0 2a 20 4f 70 65 6e 20 70 61 67 65 20 74 6f 20 6d * Open page to m
1cec0 6f 76 65 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 ove */. u8 eTyp
1ced0 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
1cee0 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 /* Pointer map
1cef0 20 27 74 79 70 65 27 20 65 6e 74 72 79 20 66 6f 'type' entry fo
1cf00 72 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 r pDbPage */. P
1cf10 67 6e 6f 20 69 50 74 72 50 61 67 65 2c 20 20 20 gno iPtrPage,
1cf20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
1cf30 65 72 20 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 er map 'page-no'
1cf40 20 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 61 entry for pDbPa
1cf50 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 ge */. Pgno iFr
1cf60 65 65 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 eePage,
1cf70 20 2f 2a 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e /* The location
1cf80 20 74 6f 20 6d 6f 76 65 20 70 44 62 50 61 67 65 to move pDbPage
1cf90 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 to */. int isC
1cfa0 6f 6d 6d 69 74 20 20 20 20 20 20 20 20 20 20 20 ommit
1cfb0 20 20 2f 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c /* isCommit fl
1cfc0 61 67 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c ag passed to sql
1cfd0 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 ite3PagerMovepag
1cfe0 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 e */.){. MemPag
1cff0 65 20 2a 70 50 74 72 50 61 67 65 3b 20 20 20 2f e *pPtrPage; /
1d000 2a 20 54 68 65 20 70 61 67 65 20 74 68 61 74 20 * The page that
1d010 63 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 contains a point
1d020 65 72 20 74 6f 20 70 44 62 50 61 67 65 20 2a 2f er to pDbPage */
1d030 0a 20 20 50 67 6e 6f 20 69 44 62 50 61 67 65 20 . Pgno iDbPage
1d040 3d 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b = pDbPage->pgno;
1d050 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
1d060 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a = pBt->pPager;.
1d070 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 int rc;.. ass
1d080 65 72 74 28 20 65 54 79 70 65 3d 3d 50 54 52 4d ert( eType==PTRM
1d090 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 AP_OVERFLOW2 ||
1d0a0 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 eType==PTRMAP_OV
1d0b0 45 52 46 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 ERFLOW1 || .
1d0c0 20 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f eType==PTRMAP_
1d0d0 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d BTREE || eType==
1d0e0 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 PTRMAP_ROOTPAGE
1d0f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
1d100 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
1d110 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
1d120 20 61 73 73 65 72 74 28 20 70 44 62 50 61 67 65 assert( pDbPage
1d130 2d 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 ->pBt==pBt );..
1d140 20 2f 2a 20 4d 6f 76 65 20 70 61 67 65 20 69 44 /* Move page iD
1d150 62 50 61 67 65 20 66 72 6f 6d 20 69 74 73 20 63 bPage from its c
1d160 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 urrent location
1d170 74 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 to page number i
1d180 46 72 65 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 FreePage */. TR
1d190 41 43 45 28 28 22 41 55 54 4f 56 41 43 55 55 4d ACE(("AUTOVACUUM
1d1a0 3a 20 4d 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 : Moving %d to f
1d1b0 72 65 65 20 70 61 67 65 20 25 64 20 28 70 74 72 ree page %d (ptr
1d1c0 20 70 61 67 65 20 25 64 20 74 79 70 65 20 25 64 page %d type %d
1d1d0 29 5c 6e 22 2c 20 0a 20 20 20 20 20 20 69 44 62 )\n", . iDb
1d1e0 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c Page, iFreePage,
1d1f0 20 69 50 74 72 50 61 67 65 2c 20 65 54 79 70 65 iPtrPage, eType
1d200 29 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 ));. rc = sqlit
1d210 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 e3PagerMovepage(
1d220 70 50 61 67 65 72 2c 20 70 44 62 50 61 67 65 2d pPager, pDbPage-
1d230 3e 70 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 >pDbPage, iFreeP
1d240 61 67 65 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a age, isCommit);.
1d250 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1d260 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 _OK ){. retur
1d270 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 n rc;. }. pDbP
1d280 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 age->pgno = iFre
1d290 65 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 ePage;.. /* If
1d2a0 70 44 62 50 61 67 65 20 77 61 73 20 61 20 62 74 pDbPage was a bt
1d2b0 72 65 65 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 ree-page, then i
1d2c0 74 20 6d 61 79 20 68 61 76 65 20 63 68 69 6c 64 t may have child
1d2d0 20 70 61 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 pages and/or ce
1d2e0 6c 6c 73 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f lls. ** that po
1d2f0 69 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 int to overflow
1d300 70 61 67 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 pages. The point
1d310 65 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 er map entries f
1d320 6f 72 20 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a or all these. *
1d330 2a 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f 20 * pages need to
1d340 62 65 20 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a be changed.. **
1d350 0a 20 20 2a 2a 20 49 66 20 70 44 62 50 61 67 65 . ** If pDbPage
1d360 20 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 is an overflow
1d370 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 66 page, then the f
1d380 69 72 73 74 20 34 20 62 79 74 65 73 20 6d 61 79 irst 4 bytes may
1d390 20 73 74 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f store a. ** po
1d3a0 69 6e 74 65 72 20 74 6f 20 61 20 73 75 62 73 65 inter to a subse
1d3b0 71 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 quent overflow p
1d3c0 61 67 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 age. If this is
1d3d0 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 the case, then.
1d3e0 20 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 20 ** the pointer
1d3f0 6d 61 70 20 6e 65 65 64 73 20 74 6f 20 62 65 20 map needs to be
1d400 75 70 64 61 74 65 64 20 66 6f 72 20 74 68 65 20 updated for the
1d410 73 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 66 subsequent overf
1d420 6c 6f 77 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 low page.. */.
1d430 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d if( eType==PTRM
1d440 41 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 70 AP_BTREE || eTyp
1d450 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 e==PTRMAP_ROOTPA
1d460 47 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 GE ){. rc = s
1d470 65 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 70 etChildPtrmaps(p
1d480 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 DbPage);. if(
1d490 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
1d4a0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
1d4b0 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 c;. }. }else
1d4c0 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f {. Pgno nextO
1d4d0 76 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 70 vfl = get4byte(p
1d4e0 44 62 50 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a DbPage->aData);.
1d4f0 20 20 20 20 69 66 28 20 6e 65 78 74 4f 76 66 6c if( nextOvfl
1d500 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 74 72 !=0 ){. ptr
1d510 6d 61 70 50 75 74 28 70 42 74 2c 20 6e 65 78 74 mapPut(pBt, next
1d520 4f 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 Ovfl, PTRMAP_OVE
1d530 52 46 4c 4f 57 32 2c 20 69 46 72 65 65 50 61 67 RFLOW2, iFreePag
1d540 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 69 e, &rc);. i
1d550 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1d560 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ){. retu
1d570 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 rn rc;. }.
1d580 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 }. }.. /* F
1d590 69 78 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ix the database
1d5a0 70 6f 69 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 pointer on page
1d5b0 69 50 74 72 50 61 67 65 20 74 68 61 74 20 70 6f iPtrPage that po
1d5c0 69 6e 74 65 64 20 61 74 20 69 44 62 50 61 67 65 inted at iDbPage
1d5d0 20 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 so. ** that it
1d5e0 20 70 6f 69 6e 74 73 20 61 74 20 69 46 72 65 65 points at iFree
1d5f0 50 61 67 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 Page. Also fix t
1d600 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 he pointer map e
1d610 6e 74 72 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 ntry for. ** iP
1d620 74 72 50 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 trPage.. */. i
1d630 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 f( eType!=PTRMAP
1d640 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 _ROOTPAGE ){.
1d650 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
1d660 67 65 28 70 42 74 2c 20 69 50 74 72 50 61 67 65 ge(pBt, iPtrPage
1d670 2c 20 26 70 50 74 72 50 61 67 65 2c 20 30 29 3b , &pPtrPage, 0);
1d680 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
1d690 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1d6a0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
1d6b0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
1d6c0 33 50 61 67 65 72 57 72 69 74 65 28 70 50 74 72 3PagerWrite(pPtr
1d6d0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a Page->pDbPage);.
1d6e0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1d6f0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
1d700 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 50 eleasePage(pPtrP
1d710 61 67 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 age);. retu
1d720 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
1d730 20 72 63 20 3d 20 6d 6f 64 69 66 79 50 61 67 65 rc = modifyPage
1d740 50 6f 69 6e 74 65 72 28 70 50 74 72 50 61 67 65 Pointer(pPtrPage
1d750 2c 20 69 44 62 50 61 67 65 2c 20 69 46 72 65 65 , iDbPage, iFree
1d760 50 61 67 65 2c 20 65 54 79 70 65 29 3b 0a 20 20 Page, eType);.
1d770 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
1d780 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 trPage);. if(
1d790 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1d7a0 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 {. ptrmapPu
1d7b0 74 28 70 42 74 2c 20 69 46 72 65 65 50 61 67 65 t(pBt, iFreePage
1d7c0 2c 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 , eType, iPtrPag
1d7d0 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 e, &rc);. }.
1d7e0 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
1d7f0 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 }../* Forward de
1d800 63 6c 61 72 61 74 69 6f 6e 20 72 65 71 75 69 72 claration requir
1d810 65 64 20 62 79 20 69 6e 63 72 56 61 63 75 75 6d ed by incrVacuum
1d820 53 74 65 70 28 29 2e 20 2a 2f 0a 73 74 61 74 69 Step(). */.stati
1d830 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 c int allocateBt
1d840 72 65 65 50 61 67 65 28 42 74 53 68 61 72 65 64 reePage(BtShared
1d850 20 2a 2c 20 4d 65 6d 50 61 67 65 20 2a 2a 2c 20 *, MemPage **,
1d860 50 67 6e 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 38 Pgno *, Pgno, u8
1d870 29 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 72 );../*.** Perfor
1d880 6d 20 61 20 73 69 6e 67 6c 65 20 73 74 65 70 20 m a single step
1d890 6f 66 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 of an incrementa
1d8a0 6c 2d 76 61 63 75 75 6d 2e 20 49 66 20 73 75 63 l-vacuum. If suc
1d8b0 63 65 73 73 66 75 6c 2c 20 72 65 74 75 72 6e 0a cessful, return.
1d8c0 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 ** SQLITE_OK. If
1d8d0 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 6f 72 there is no wor
1d8e0 6b 20 74 6f 20 64 6f 20 28 61 6e 64 20 74 68 65 k to do (and the
1d8f0 72 65 66 6f 72 65 20 6e 6f 20 70 6f 69 6e 74 20 refore no point
1d900 69 6e 20 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 74 in .** calling t
1d910 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 his function aga
1d920 69 6e 29 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 in), return SQLI
1d930 54 45 5f 44 4f 4e 45 2e 20 4f 72 2c 20 69 66 20 TE_DONE. Or, if
1d940 61 6e 20 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 63 an error .** occ
1d950 75 72 73 2c 20 72 65 74 75 72 6e 20 73 6f 6d 65 urs, return some
1d960 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 other error cod
1d970 65 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 73 70 e..**.** More sp
1d980 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 ecifically, this
1d990 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 function attemp
1d9a0 74 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a ts to re-organiz
1d9b0 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 e the database s
1d9c0 6f 20 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 6c o .** that the l
1d9d0 61 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 ast page of the
1d9e0 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 69 file currently i
1d9f0 6e 20 75 73 65 20 69 73 20 6e 6f 20 6c 6f 6e 67 n use is no long
1da00 65 72 20 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a 2a er in use..**.**
1da10 20 50 61 72 61 6d 65 74 65 72 20 6e 46 69 6e 20 Parameter nFin
1da20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
1da30 20 70 61 67 65 73 20 74 68 61 74 20 74 68 69 73 pages that this
1da40 20 64 61 74 61 62 61 73 65 20 77 6f 75 6c 64 20 database would
1da50 63 6f 6e 74 61 69 6e 0a 2a 2a 20 77 65 72 65 20 contain.** were
1da60 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 this function ca
1da70 6c 6c 65 64 20 75 6e 74 69 6c 20 69 74 20 72 65 lled until it re
1da80 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e turns SQLITE_DON
1da90 45 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 E..**.** If the
1daa0 62 43 6f 6d 6d 69 74 20 70 61 72 61 6d 65 74 65 bCommit paramete
1dab0 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 r is non-zero, t
1dac0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 his function ass
1dad0 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 0a 2a umes that the .*
1dae0 2a 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6b 65 * caller will ke
1daf0 65 70 20 63 61 6c 6c 69 6e 67 20 69 6e 63 72 56 ep calling incrV
1db00 61 63 75 75 6d 53 74 65 70 28 29 20 75 6e 74 69 acuumStep() unti
1db10 6c 20 69 74 20 72 65 74 75 72 6e 73 20 53 51 4c l it returns SQL
1db20 49 54 45 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 20 ITE_DONE .** or
1db30 61 6e 20 65 72 72 6f 72 2e 20 62 43 6f 6d 6d 69 an error. bCommi
1db40 74 20 69 73 20 70 61 73 73 65 64 20 74 72 75 65 t is passed true
1db50 20 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 for an auto-vac
1db60 75 75 6d 2d 6f 6e 2d 63 6f 6d 6d 69 74 20 0a 2a uum-on-commit .*
1db70 2a 20 6f 70 65 72 61 74 69 6f 6e 2c 20 6f 72 20 * operation, or
1db80 66 61 6c 73 65 20 66 6f 72 20 61 6e 20 69 6e 63 false for an inc
1db90 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e remental vacuum.
1dba0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 69 .*/.static int i
1dbb0 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 42 74 ncrVacuumStep(Bt
1dbc0 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e Shared *pBt, Pgn
1dbd0 6f 20 6e 46 69 6e 2c 20 50 67 6e 6f 20 69 4c 61 o nFin, Pgno iLa
1dbe0 73 74 50 67 2c 20 69 6e 74 20 62 43 6f 6d 6d 69 stPg, int bCommi
1dbf0 74 29 7b 0a 20 20 50 67 6e 6f 20 6e 46 72 65 65 t){. Pgno nFree
1dc00 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 List;
1dc10 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
1dc20 65 73 20 73 74 69 6c 6c 20 6f 6e 20 74 68 65 20 es still on the
1dc30 66 72 65 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 69 free-list */. i
1dc40 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
1dc50 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
1dc60 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
1dc70 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 4c );. assert( iL
1dc80 61 73 74 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a 20 astPg>nFin );..
1dc90 20 69 66 28 20 21 50 54 52 4d 41 50 5f 49 53 50 if( !PTRMAP_ISP
1dca0 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 67 AGE(pBt, iLastPg
1dcb0 29 20 26 26 20 69 4c 61 73 74 50 67 21 3d 50 45 ) && iLastPg!=PE
1dcc0 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
1dcd0 70 42 74 29 20 29 7b 0a 20 20 20 20 75 38 20 65 pBt) ){. u8 e
1dce0 54 79 70 65 3b 0a 20 20 20 20 50 67 6e 6f 20 69 Type;. Pgno i
1dcf0 50 74 72 50 61 67 65 3b 0a 0a 20 20 20 20 6e 46 PtrPage;.. nF
1dd00 72 65 65 4c 69 73 74 20 3d 20 67 65 74 34 62 79 reeList = get4by
1dd10 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d te(&pBt->pPage1-
1dd20 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 >aData[36]);.
1dd30 20 69 66 28 20 6e 46 72 65 65 4c 69 73 74 3d 3d if( nFreeList==
1dd40 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 0 ){. retur
1dd50 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 n SQLITE_DONE;.
1dd60 20 20 20 7d 0a 0a 20 20 20 20 72 63 20 3d 20 70 }.. rc = p
1dd70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 69 4c trmapGet(pBt, iL
1dd80 61 73 74 50 67 2c 20 26 65 54 79 70 65 2c 20 26 astPg, &eType, &
1dd90 69 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 iPtrPage);. i
1dda0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1ddb0 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1ddc0 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 rc;. }. i
1ddd0 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 f( eType==PTRMAP
1dde0 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 _ROOTPAGE ){.
1ddf0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
1de00 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
1de10 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 65 54 }.. if( eT
1de20 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 ype==PTRMAP_FREE
1de30 50 41 47 45 20 29 7b 0a 20 20 20 20 20 20 69 66 PAGE ){. if
1de40 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a ( bCommit==0 ){.
1de50 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 /* Remov
1de60 65 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 e the page from
1de70 74 68 65 20 66 69 6c 65 73 20 66 72 65 65 2d 6c the files free-l
1de80 69 73 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 ist. This is not
1de90 20 72 65 71 75 69 72 65 64 0a 20 20 20 20 20 20 required.
1dea0 20 20 2a 2a 20 69 66 20 62 43 6f 6d 6d 69 74 20 ** if bCommit
1deb0 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e 20 is non-zero. In
1dec0 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 66 that case, the f
1ded0 72 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 ree-list will be
1dee0 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 75 6e . ** trun
1def0 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 61 66 cated to zero af
1df00 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
1df10 6e 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 69 74 n returns, so it
1df20 20 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 20 20 doesn't .
1df30 20 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 20 69 ** matter if i
1df40 74 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 6e 73 t still contains
1df50 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 65 6e some garbage en
1df60 74 72 69 65 73 2e 0a 20 20 20 20 20 20 20 20 2a tries.. *
1df70 2f 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 /. Pgno i
1df80 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 FreePg;.
1df90 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 67 MemPage *pFreePg
1dfa0 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 ;. rc = a
1dfb0 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
1dfc0 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c 20 (pBt, &pFreePg,
1dfd0 26 69 46 72 65 65 50 67 2c 20 69 4c 61 73 74 50 &iFreePg, iLastP
1dfe0 67 2c 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 g, BTALLOC_EXACT
1dff0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
1e000 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1e010 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
1e020 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 rc;. }.
1e030 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 assert( i
1e040 46 72 65 65 50 67 3d 3d 69 4c 61 73 74 50 67 20 FreePg==iLastPg
1e050 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 );. relea
1e060 73 65 50 61 67 65 28 70 46 72 65 65 50 67 29 3b sePage(pFreePg);
1e070 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 . }. } e
1e080 6c 73 65 20 7b 0a 20 20 20 20 20 20 50 67 6e 6f lse {. Pgno
1e090 20 69 46 72 65 65 50 67 3b 20 20 20 20 20 20 20 iFreePg;
1e0a0 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f /* Index o
1e0b0 66 20 66 72 65 65 20 70 61 67 65 20 74 6f 20 6d f free page to m
1e0c0 6f 76 65 20 70 4c 61 73 74 50 67 20 74 6f 20 2a ove pLastPg to *
1e0d0 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 /. MemPage
1e0e0 2a 70 4c 61 73 74 50 67 3b 0a 20 20 20 20 20 20 *pLastPg;.
1e0f0 75 38 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c u8 eMode = BTALL
1e100 4f 43 5f 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f 64 OC_ANY; /* Mod
1e110 65 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 e parameter for
1e120 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
1e130 65 28 29 20 2a 2f 0a 20 20 20 20 20 20 50 67 6e e() */. Pgn
1e140 6f 20 69 4e 65 61 72 20 3d 20 30 3b 20 20 20 20 o iNear = 0;
1e150 20 20 20 20 20 20 20 2f 2a 20 6e 65 61 72 62 79 /* nearby
1e160 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 parameter for a
1e170 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
1e180 28 29 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 20 () */.. rc
1e190 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 = btreeGetPage(p
1e1a0 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 70 4c Bt, iLastPg, &pL
1e1b0 61 73 74 50 67 2c 20 30 29 3b 0a 20 20 20 20 20 astPg, 0);.
1e1c0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1e1d0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 OK ){. re
1e1e0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
1e1f0 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 62 43 .. /* If bC
1e200 6f 6d 6d 69 74 20 69 73 20 7a 65 72 6f 2c 20 74 ommit is zero, t
1e210 68 69 73 20 6c 6f 6f 70 20 72 75 6e 73 20 65 78 his loop runs ex
1e220 61 63 74 6c 79 20 6f 6e 63 65 20 61 6e 64 20 70 actly once and p
1e230 61 67 65 20 70 4c 61 73 74 50 67 0a 20 20 20 20 age pLastPg.
1e240 20 20 2a 2a 20 69 73 20 73 77 61 70 70 65 64 20 ** is swapped
1e250 77 69 74 68 20 74 68 65 20 66 69 72 73 74 20 66 with the first f
1e260 72 65 65 20 70 61 67 65 20 70 75 6c 6c 65 64 20 ree page pulled
1e270 6f 66 66 20 74 68 65 20 66 72 65 65 20 6c 69 73 off the free lis
1e280 74 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 t.. **.
1e290 20 20 2a 2a 20 4f 6e 20 74 68 65 20 6f 74 68 65 ** On the othe
1e2a0 72 20 68 61 6e 64 2c 20 69 66 20 62 43 6f 6d 6d r hand, if bComm
1e2b0 69 74 20 69 73 20 67 72 65 61 74 65 72 20 74 68 it is greater th
1e2c0 61 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6b 65 an zero, then ke
1e2d0 65 70 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 6f 70 ep. ** loop
1e2e0 69 6e 67 20 75 6e 74 69 6c 20 61 20 66 72 65 65 ing until a free
1e2f0 2d 70 61 67 65 20 6c 6f 63 61 74 65 64 20 77 69 -page located wi
1e300 74 68 69 6e 20 74 68 65 20 66 69 72 73 74 20 6e thin the first n
1e310 46 69 6e 20 70 61 67 65 73 0a 20 20 20 20 20 20 Fin pages.
1e320 2a 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 ** of the file i
1e330 73 20 66 6f 75 6e 64 2e 0a 20 20 20 20 20 20 2a s found.. *
1e340 2f 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f 6d /. if( bCom
1e350 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 mit==0 ){.
1e360 20 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f eMode = BTALLO
1e370 43 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 69 4e C_LE;. iN
1e380 65 61 72 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 ear = nFin;.
1e390 20 20 7d 0a 20 20 20 20 20 20 64 6f 20 7b 0a 20 }. do {.
1e3a0 20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a MemPage *
1e3b0 70 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 pFreePg;.
1e3c0 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 rc = allocateBt
1e3d0 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 46 reePage(pBt, &pF
1e3e0 72 65 65 50 67 2c 20 26 69 46 72 65 65 50 67 2c reePg, &iFreePg,
1e3f0 20 69 4e 65 61 72 2c 20 65 4d 6f 64 65 29 3b 0a iNear, eMode);.
1e400 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
1e410 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1e420 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 releasePa
1e430 67 65 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 ge(pLastPg);.
1e440 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
1e450 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
1e460 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
1e470 70 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 20 pFreePg);.
1e480 7d 77 68 69 6c 65 28 20 62 43 6f 6d 6d 69 74 20 }while( bCommit
1e490 26 26 20 69 46 72 65 65 50 67 3e 6e 46 69 6e 20 && iFreePg>nFin
1e4a0 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
1e4b0 20 69 46 72 65 65 50 67 3c 69 4c 61 73 74 50 67 iFreePg<iLastPg
1e4c0 20 29 3b 0a 20 20 20 20 20 20 0a 20 20 20 20 20 );. .
1e4d0 20 72 63 20 3d 20 72 65 6c 6f 63 61 74 65 50 61 rc = relocatePa
1e4e0 67 65 28 70 42 74 2c 20 70 4c 61 73 74 50 67 2c ge(pBt, pLastPg,
1e4f0 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 eType, iPtrPage
1e500 2c 20 69 46 72 65 65 50 67 2c 20 62 43 6f 6d 6d , iFreePg, bComm
1e510 69 74 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 it);. relea
1e520 73 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b sePage(pLastPg);
1e530 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
1e540 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1e550 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1e560 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
1e570 0a 0a 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d .. if( bCommit=
1e580 3d 30 20 29 7b 0a 20 20 20 20 64 6f 20 7b 0a 20 =0 ){. do {.
1e590 20 20 20 20 20 69 4c 61 73 74 50 67 2d 2d 3b 0a iLastPg--;.
1e5a0 20 20 20 20 7d 77 68 69 6c 65 28 20 69 4c 61 73 }while( iLas
1e5b0 74 50 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 tPg==PENDING_BYT
1e5c0 45 5f 50 41 47 45 28 70 42 74 29 20 7c 7c 20 50 E_PAGE(pBt) || P
1e5d0 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
1e5e0 2c 20 69 4c 61 73 74 50 67 29 20 29 3b 0a 20 20 , iLastPg) );.
1e5f0 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 pBt->bDoTrunca
1e600 74 65 20 3d 20 31 3b 0a 20 20 20 20 70 42 74 2d te = 1;. pBt-
1e610 3e 6e 50 61 67 65 20 3d 20 69 4c 61 73 74 50 67 >nPage = iLastPg
1e620 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
1e630 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
1e640 2a 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 ** The database
1e650 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 66 69 opened by the fi
1e660 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 rst argument is
1e670 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 an auto-vacuum d
1e680 61 74 61 62 61 73 65 0a 2a 2a 20 6e 4f 72 69 67 atabase.** nOrig
1e690 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 20 63 pages in size c
1e6a0 6f 6e 74 61 69 6e 69 6e 67 20 6e 46 72 65 65 20 ontaining nFree
1e6b0 66 72 65 65 20 70 61 67 65 73 2e 20 52 65 74 75 free pages. Retu
1e6c0 72 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 20 rn the expected
1e6d0 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 74 68 65 20 .** size of the
1e6e0 64 61 74 61 62 61 73 65 20 69 6e 20 70 61 67 65 database in page
1e6f0 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 20 61 s following an a
1e700 75 74 6f 2d 76 61 63 75 75 6d 20 6f 70 65 72 61 uto-vacuum opera
1e710 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
1e720 50 67 6e 6f 20 66 69 6e 61 6c 44 62 53 69 7a 65 Pgno finalDbSize
1e730 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
1e740 50 67 6e 6f 20 6e 4f 72 69 67 2c 20 50 67 6e 6f Pgno nOrig, Pgno
1e750 20 6e 46 72 65 65 29 7b 0a 20 20 69 6e 74 20 6e nFree){. int n
1e760 45 6e 74 72 79 3b 20 20 20 20 20 20 20 20 20 20 Entry;
1e770 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
1e780 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 mber of entries
1e790 6f 6e 20 6f 6e 65 20 70 74 72 6d 61 70 20 70 61 on one ptrmap pa
1e7a0 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 50 74 ge */. Pgno nPt
1e7b0 72 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 rmap;
1e7c0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1e7d0 72 20 6f 66 20 50 74 72 4d 61 70 20 70 61 67 65 r of PtrMap page
1e7e0 73 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f s to be freed */
1e7f0 0a 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 20 . Pgno nFin;
1e800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e810 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61 6c /* Return val
1e820 75 65 20 2a 2f 0a 0a 20 20 6e 45 6e 74 72 79 20 ue */.. nEntry
1e830 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
1e840 65 2f 35 3b 0a 20 20 6e 50 74 72 6d 61 70 20 3d e/5;. nPtrmap =
1e850 20 28 6e 46 72 65 65 2d 6e 4f 72 69 67 2b 50 54 (nFree-nOrig+PT
1e860 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c RMAP_PAGENO(pBt,
1e870 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 72 79 29 2f nOrig)+nEntry)/
1e880 6e 45 6e 74 72 79 3b 0a 20 20 6e 46 69 6e 20 3d nEntry;. nFin =
1e890 20 6e 4f 72 69 67 20 2d 20 6e 46 72 65 65 20 2d nOrig - nFree -
1e8a0 20 6e 50 74 72 6d 61 70 3b 0a 20 20 69 66 28 20 nPtrmap;. if(
1e8b0 6e 4f 72 69 67 3e 50 45 4e 44 49 4e 47 5f 42 59 nOrig>PENDING_BY
1e8c0 54 45 5f 50 41 47 45 28 70 42 74 29 20 26 26 20 TE_PAGE(pBt) &&
1e8d0 6e 46 69 6e 3c 50 45 4e 44 49 4e 47 5f 42 59 54 nFin<PENDING_BYT
1e8e0 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 E_PAGE(pBt) ){.
1e8f0 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 20 nFin--;. }.
1e900 20 77 68 69 6c 65 28 20 50 54 52 4d 41 50 5f 49 while( PTRMAP_I
1e910 53 50 41 47 45 28 70 42 74 2c 20 6e 46 69 6e 29 SPAGE(pBt, nFin)
1e920 20 7c 7c 20 6e 46 69 6e 3d 3d 50 45 4e 44 49 4e || nFin==PENDIN
1e930 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
1e940 20 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a ){. nFin--;.
1e950 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 6e 46 }.. return nF
1e960 69 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 77 in;.}../*.** A w
1e970 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
1e980 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 65 64 20 must be opened
1e990 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 before calling t
1e9a0 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a his function..**
1e9b0 20 49 74 20 70 65 72 66 6f 72 6d 73 20 61 20 73 It performs a s
1e9c0 69 6e 67 6c 65 20 75 6e 69 74 20 6f 66 20 77 6f ingle unit of wo
1e9d0 72 6b 20 74 6f 77 61 72 64 73 20 61 6e 20 69 6e rk towards an in
1e9e0 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
1e9f0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 ..**.** If the i
1ea00 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 ncremental vacuu
1ea10 6d 20 69 73 20 66 69 6e 69 73 68 65 64 20 61 66 m is finished af
1ea20 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
1ea30 6e 20 68 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 51 n has run,.** SQ
1ea40 4c 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 LITE_DONE is ret
1ea50 75 72 6e 65 64 2e 20 49 66 20 69 74 20 69 73 20 urned. If it is
1ea60 6e 6f 74 20 66 69 6e 69 73 68 65 64 2c 20 62 75 not finished, bu
1ea70 74 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 t no error occur
1ea80 72 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f red,.** SQLITE_O
1ea90 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f K is returned. O
1eaa0 74 68 65 72 77 69 73 65 20 61 6e 20 53 51 4c 69 therwise an SQLi
1eab0 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 0a te error code. .
1eac0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
1ead0 72 65 65 49 6e 63 72 56 61 63 75 75 6d 28 42 74 reeIncrVacuum(Bt
1eae0 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 ree *p){. int r
1eaf0 63 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 c;. BtShared *p
1eb00 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 20 Bt = p->pBt;..
1eb10 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1eb20 72 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r(p);. assert(
1eb30 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
1eb40 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 on==TRANS_WRITE
1eb50 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 && p->inTrans==T
1eb60 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 RANS_WRITE );.
1eb70 69 66 28 20 21 70 42 74 2d 3e 61 75 74 6f 56 61 if( !pBt->autoVa
1eb80 63 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d cuum ){. rc =
1eb90 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 SQLITE_DONE;.
1eba0 7d 65 6c 73 65 7b 0a 20 20 20 20 50 67 6e 6f 20 }else{. Pgno
1ebb0 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 nOrig = btreePag
1ebc0 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 ecount(pBt);.
1ebd0 20 50 67 6e 6f 20 6e 46 72 65 65 20 3d 20 67 65 Pgno nFree = ge
1ebe0 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
1ebf0 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b ge1->aData[36]);
1ec00 0a 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 20 3d . Pgno nFin =
1ec10 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 finalDbSize(pBt
1ec20 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b , nOrig, nFree);
1ec30 0a 0a 20 20 20 20 69 66 28 20 6e 4f 72 69 67 3c .. if( nOrig<
1ec40 6e 46 69 6e 20 29 7b 0a 20 20 20 20 20 20 72 63 nFin ){. rc
1ec50 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
1ec60 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 T_BKPT;. }els
1ec70 65 20 69 66 28 20 6e 46 72 65 65 3e 30 20 29 7b e if( nFree>0 ){
1ec80 0a 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 . rc = save
1ec90 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 AllCursors(pBt,
1eca0 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 0, 0);. if(
1ecb0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1ecc0 7b 0a 20 20 20 20 20 20 20 20 69 6e 76 61 6c 69 {. invali
1ecd0 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 dateAllOverflowC
1ece0 61 63 68 65 28 70 42 74 29 3b 0a 20 20 20 20 20 ache(pBt);.
1ecf0 20 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 75 rc = incrVacu
1ed00 75 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 6e umStep(pBt, nFin
1ed10 2c 20 6e 4f 72 69 67 2c 20 30 29 3b 0a 20 20 20 , nOrig, 0);.
1ed20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 }. if( r
1ed30 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1ed40 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
1ed50 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
1ed60 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 Bt->pPage1->pDbP
1ed70 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 75 age);. pu
1ed80 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
1ed90 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 ge1->aData[28],
1eda0 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 pBt->nPage);.
1edb0 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
1edc0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
1edd0 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 E_DONE;. }.
1ede0 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 }. sqlite3Btree
1edf0 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
1ee00 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1ee10 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
1ee20 63 61 6c 6c 65 64 20 70 72 69 6f 72 20 74 6f 20 called prior to
1ee30 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d sqlite3PagerComm
1ee40 69 74 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 it when a transa
1ee50 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 6f 6d 6d ction.** is comm
1ee60 69 74 74 65 64 20 66 6f 72 20 61 6e 20 61 75 74 itted for an aut
1ee70 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 o-vacuum databas
1ee80 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 e..**.** If SQLI
1ee90 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
1eea0 64 2c 20 74 68 65 6e 20 2a 70 6e 54 72 75 6e 63 d, then *pnTrunc
1eeb0 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6e is set to the n
1eec0 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 0a 2a umber of pages.*
1eed0 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
1eee0 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 74 72 ile should be tr
1eef0 75 6e 63 61 74 65 64 20 74 6f 20 64 75 72 69 6e uncated to durin
1ef00 67 20 74 68 65 20 63 6f 6d 6d 69 74 20 70 72 6f g the commit pro
1ef10 63 65 73 73 2e 20 0a 2a 2a 20 69 2e 65 2e 20 74 cess. .** i.e. t
1ef20 68 65 20 64 61 74 61 62 61 73 65 20 68 61 73 20 he database has
1ef30 62 65 65 6e 20 72 65 6f 72 67 61 6e 69 7a 65 64 been reorganized
1ef40 20 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20 74 68 so that only th
1ef50 65 20 66 69 72 73 74 20 2a 70 6e 54 72 75 6e 63 e first *pnTrunc
1ef60 0a 2a 2a 20 70 61 67 65 73 20 61 72 65 20 69 6e .** pages are in
1ef70 20 75 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 use..*/.static
1ef80 69 6e 74 20 61 75 74 6f 56 61 63 75 75 6d 43 6f int autoVacuumCo
1ef90 6d 6d 69 74 28 42 74 53 68 61 72 65 64 20 2a 70 mmit(BtShared *p
1efa0 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 Bt){. int rc =
1efb0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 67 SQLITE_OK;. Pag
1efc0 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 42 74 er *pPager = pBt
1efd0 2d 3e 70 50 61 67 65 72 3b 0a 20 20 56 56 41 5f ->pPager;. VVA_
1efe0 4f 4e 4c 59 28 20 69 6e 74 20 6e 52 65 66 20 3d ONLY( int nRef =
1eff0 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 sqlite3PagerRef
1f000 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 20 29 count(pPager); )
1f010 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
1f020 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
1f030 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
1f040 69 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 invalidateAllOve
1f050 72 66 6c 6f 77 43 61 63 68 65 28 70 42 74 29 3b rflowCache(pBt);
1f060 0a 20 20 61 73 73 65 72 74 28 70 42 74 2d 3e 61 . assert(pBt->a
1f070 75 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 69 66 utoVacuum);. if
1f080 28 20 21 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 ( !pBt->incrVacu
1f090 75 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e um ){. Pgno n
1f0a0 46 69 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 Fin; /*
1f0b0 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
1f0c0 69 6e 20 64 61 74 61 62 61 73 65 20 61 66 74 65 in database afte
1f0d0 72 20 61 75 74 6f 76 61 63 75 75 6d 69 6e 67 20 r autovacuuming
1f0e0 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 */. Pgno nFre
1f0f0 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d e; /* Num
1f100 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 ber of pages on
1f110 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 6e 69 the freelist ini
1f120 74 69 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 50 67 tially */. Pg
1f130 6e 6f 20 69 46 72 65 65 3b 20 20 20 20 20 20 20 no iFree;
1f140 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 70 61 67 /* The next pag
1f150 65 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f e to be freed */
1f160 0a 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 3b . Pgno nOrig;
1f170 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1f180 61 73 65 20 73 69 7a 65 20 62 65 66 6f 72 65 20 ase size before
1f190 66 72 65 65 69 6e 67 20 2a 2f 0a 0a 20 20 20 20 freeing */..
1f1a0 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 nOrig = btreePag
1f1b0 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 ecount(pBt);.
1f1c0 20 69 66 28 20 50 54 52 4d 41 50 5f 49 53 50 41 if( PTRMAP_ISPA
1f1d0 47 45 28 70 42 74 2c 20 6e 4f 72 69 67 29 20 7c GE(pBt, nOrig) |
1f1e0 7c 20 6e 4f 72 69 67 3d 3d 50 45 4e 44 49 4e 47 | nOrig==PENDING
1f1f0 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
1f200 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 74 20 69 ){. /* It i
1f210 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 s not possible t
1f220 6f 20 63 72 65 61 74 65 20 61 20 64 61 74 61 62 o create a datab
1f230 61 73 65 20 66 6f 72 20 77 68 69 63 68 20 74 68 ase for which th
1f240 65 20 66 69 6e 61 6c 20 70 61 67 65 0a 20 20 20 e final page.
1f250 20 20 20 2a 2a 20 69 73 20 65 69 74 68 65 72 20 ** is either
1f260 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 a pointer-map pa
1f270 67 65 20 6f 72 20 74 68 65 20 70 65 6e 64 69 6e ge or the pendin
1f280 67 2d 62 79 74 65 20 70 61 67 65 2e 20 49 66 20 g-byte page. If
1f290 6f 6e 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 one. ** is
1f2a0 65 6e 63 6f 75 6e 74 65 72 65 64 2c 20 74 68 69 encountered, thi
1f2b0 73 20 69 6e 64 69 63 61 74 65 73 20 63 6f 72 72 s indicates corr
1f2c0 75 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f uption.. */
1f2d0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
1f2e0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
1f2f0 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e 46 T;. }.. nF
1f300 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 ree = get4byte(&
1f310 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 pBt->pPage1->aDa
1f320 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 6e 46 69 ta[36]);. nFi
1f330 6e 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 n = finalDbSize(
1f340 70 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 pBt, nOrig, nFre
1f350 65 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 6e e);. if( nFin
1f360 3e 6e 4f 72 69 67 20 29 20 72 65 74 75 72 6e 20 >nOrig ) return
1f370 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1f380 4b 50 54 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 KPT;. if( nFi
1f390 6e 3c 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 n<nOrig ){.
1f3a0 20 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 rc = saveAllCur
1f3b0 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b sors(pBt, 0, 0);
1f3c0 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 . }. for(i
1f3d0 46 72 65 65 3d 6e 4f 72 69 67 3b 20 69 46 72 65 Free=nOrig; iFre
1f3e0 65 3e 6e 46 69 6e 20 26 26 20 72 63 3d 3d 53 51 e>nFin && rc==SQ
1f3f0 4c 49 54 45 5f 4f 4b 3b 20 69 46 72 65 65 2d 2d LITE_OK; iFree--
1f400 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 69 6e ){. rc = in
1f410 63 72 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 crVacuumStep(pBt
1f420 2c 20 6e 46 69 6e 2c 20 69 46 72 65 65 2c 20 31 , nFin, iFree, 1
1f430 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
1f440 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e (rc==SQLITE_DON
1f450 45 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f E || rc==SQLITE_
1f460 4f 4b 29 20 26 26 20 6e 46 72 65 65 3e 30 20 29 OK) && nFree>0 )
1f470 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
1f480 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
1f490 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 Bt->pPage1->pDbP
1f4a0 61 67 65 29 3b 0a 20 20 20 20 20 20 70 75 74 34 age);. put4
1f4b0 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 byte(&pBt->pPage
1f4c0 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 30 29 1->aData[32], 0)
1f4d0 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
1f4e0 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
1f4f0 44 61 74 61 5b 33 36 5d 2c 20 30 29 3b 0a 20 20 Data[36], 0);.
1f500 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 42 put4byte(&pB
1f510 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
1f520 5b 32 38 5d 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 [28], nFin);.
1f530 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 pBt->bDoTrunc
1f540 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 70 ate = 1;. p
1f550 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 46 69 6e Bt->nPage = nFin
1f560 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
1f570 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1f580 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
1f590 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 gerRollback(pPag
1f5a0 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a er);. }. }..
1f5b0 20 20 61 73 73 65 72 74 28 20 6e 52 65 66 3e 3d assert( nRef>=
1f5c0 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 sqlite3PagerRefc
1f5d0 6f 75 6e 74 28 70 50 61 67 65 72 29 20 29 3b 0a ount(pPager) );.
1f5e0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1f5f0 23 65 6c 73 65 20 2f 2a 20 69 66 6e 64 65 66 20 #else /* ifndef
1f600 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
1f610 56 41 43 55 55 4d 20 2a 2f 0a 23 20 64 65 66 69 VACUUM */.# defi
1f620 6e 65 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 ne setChildPtrma
1f630 70 73 28 78 29 20 53 51 4c 49 54 45 5f 4f 4b 0a ps(x) SQLITE_OK.
1f640 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
1f650 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 is routine does
1f660 74 68 65 20 66 69 72 73 74 20 70 68 61 73 65 20 the first phase
1f670 6f 66 20 61 20 74 77 6f 2d 70 68 61 73 65 20 63 of a two-phase c
1f680 6f 6d 6d 69 74 2e 20 20 54 68 69 73 20 72 6f 75 ommit. This rou
1f690 74 69 6e 65 0a 2a 2a 20 63 61 75 73 65 73 20 61 tine.** causes a
1f6a0 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
1f6b0 6c 20 74 6f 20 62 65 20 63 72 65 61 74 65 64 20 l to be created
1f6c0 28 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 (if it does not
1f6d0 61 6c 72 65 61 64 79 20 65 78 69 73 74 29 0a 2a already exist).*
1f6e0 2a 20 61 6e 64 20 70 6f 70 75 6c 61 74 65 64 20 * and populated
1f6f0 77 69 74 68 20 65 6e 6f 75 67 68 20 69 6e 66 6f with enough info
1f700 72 6d 61 74 69 6f 6e 20 73 6f 20 74 68 61 74 20 rmation so that
1f710 69 66 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 if a power loss
1f720 6f 63 63 75 72 73 0a 2a 2a 20 74 68 65 20 64 61 occurs.** the da
1f730 74 61 62 61 73 65 20 63 61 6e 20 62 65 20 72 65 tabase can be re
1f740 73 74 6f 72 65 64 20 74 6f 20 69 74 73 20 6f 72 stored to its or
1f750 69 67 69 6e 61 6c 20 73 74 61 74 65 20 62 79 20 iginal state by
1f760 70 6c 61 79 69 6e 67 20 62 61 63 6b 0a 2a 2a 20 playing back.**
1f770 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 the journal. Th
1f780 65 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 en the contents
1f790 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 of the journal a
1f7a0 72 65 20 66 6c 75 73 68 65 64 20 6f 75 74 20 74 re flushed out t
1f7b0 6f 0a 2a 2a 20 74 68 65 20 64 69 73 6b 2e 20 20 o.** the disk.
1f7c0 41 66 74 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 After the journa
1f7d0 6c 20 69 73 20 73 61 66 65 6c 79 20 6f 6e 20 6f l is safely on o
1f7e0 78 69 64 65 2c 20 74 68 65 20 63 68 61 6e 67 65 xide, the change
1f7f0 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 s to the.** data
1f800 62 61 73 65 20 61 72 65 20 77 72 69 74 74 65 6e base are written
1f810 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
1f820 73 65 20 66 69 6c 65 20 61 6e 64 20 66 6c 75 73 se file and flus
1f830 68 65 64 20 74 6f 20 6f 78 69 64 65 2e 0a 2a 2a hed to oxide..**
1f840 20 41 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 At the end of t
1f850 68 69 73 20 63 61 6c 6c 2c 20 74 68 65 20 72 6f his call, the ro
1f860 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 73 llback journal s
1f870 74 69 6c 6c 20 65 78 69 73 74 73 20 6f 6e 20 74 till exists on t
1f880 68 65 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 20 77 he.** disk and w
1f890 65 20 61 72 65 20 73 74 69 6c 6c 20 68 6f 6c 64 e are still hold
1f8a0 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b 73 2c 20 73 ing all locks, s
1f8b0 6f 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f o the transactio
1f8c0 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 63 6f 6d n has not.** com
1f8d0 6d 69 74 74 65 64 2e 20 20 53 65 65 20 73 71 6c mitted. See sql
1f8e0 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
1f8f0 68 61 73 65 54 77 6f 28 29 20 66 6f 72 20 74 68 haseTwo() for th
1f900 65 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 6f e second phase o
1f910 66 20 74 68 65 0a 2a 2a 20 63 6f 6d 6d 69 74 20 f the.** commit
1f920 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 process..**.** T
1f930 68 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f his call is a no
1f940 2d 6f 70 20 69 66 20 6e 6f 20 77 72 69 74 65 2d -op if no write-
1f950 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 transaction is c
1f960 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 20 urrently active
1f970 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 on pBt..**.** Ot
1f980 68 65 72 77 69 73 65 2c 20 73 79 6e 63 20 74 68 herwise, sync th
1f990 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
1f9a0 66 6f 72 20 74 68 65 20 62 74 72 65 65 20 70 42 for the btree pB
1f9b0 74 2e 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 t. zMaster point
1f9c0 73 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 61 6d 65 s to.** the name
1f9d0 20 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 of a master jou
1f9e0 72 6e 61 6c 20 66 69 6c 65 20 74 68 61 74 20 73 rnal file that s
1f9f0 68 6f 75 6c 64 20 62 65 20 77 72 69 74 74 65 6e hould be written
1fa00 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 69 6e 64 into the.** ind
1fa10 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 ividual journal
1fa20 66 69 6c 65 2c 20 6f 72 20 69 73 20 4e 55 4c 4c file, or is NULL
1fa30 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 , indicating no
1fa40 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
1fa50 69 6c 65 20 0a 2a 2a 20 28 73 69 6e 67 6c 65 20 ile .** (single
1fa60 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 database transac
1fa70 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 tion)..**.** Whe
1fa80 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 n this is called
1fa90 2c 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 , the master jou
1faa0 72 6e 61 6c 20 73 68 6f 75 6c 64 20 61 6c 72 65 rnal should alre
1fab0 61 64 79 20 68 61 76 65 20 62 65 65 6e 0a 2a 2a ady have been.**
1fac0 20 63 72 65 61 74 65 64 2c 20 70 6f 70 75 6c 61 created, popula
1fad0 74 65 64 20 77 69 74 68 20 74 68 69 73 20 6a 6f ted with this jo
1fae0 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 61 6e urnal pointer an
1faf0 64 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b d synced to disk
1fb00 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 69 ..**.** Once thi
1fb10 73 20 69 73 20 72 6f 75 74 69 6e 65 20 68 61 73 s is routine has
1fb20 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 20 6f returned, the o
1fb30 6e 6c 79 20 74 68 69 6e 67 20 72 65 71 75 69 72 nly thing requir
1fb40 65 64 20 74 6f 20 63 6f 6d 6d 69 74 0a 2a 2a 20 ed to commit.**
1fb50 74 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 the write-transa
1fb60 63 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 64 ction for this d
1fb70 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
1fb80 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f to delete the jo
1fb90 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 urnal..*/.int sq
1fba0 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1fbb0 50 68 61 73 65 4f 6e 65 28 42 74 72 65 65 20 2a PhaseOne(Btree *
1fbc0 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a p, const char *z
1fbd0 4d 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 Master){. int r
1fbe0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1fbf0 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d if( p->inTrans=
1fc00 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a =TRANS_WRITE ){.
1fc10 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
1fc20 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 t = p->pBt;.
1fc30 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1fc40 72 28 70 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 r(p);.#ifndef SQ
1fc50 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
1fc60 43 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 74 CUUM. if( pBt
1fc70 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a ->autoVacuum ){.
1fc80 20 20 20 20 20 20 72 63 20 3d 20 61 75 74 6f 56 rc = autoV
1fc90 61 63 75 75 6d 43 6f 6d 6d 69 74 28 70 42 74 29 acuumCommit(pBt)
1fca0 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
1fcb0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1fcc0 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
1fcd0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 20 eLeave(p);.
1fce0 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1fcf0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
1fd00 69 66 28 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e if( pBt->bDoTrun
1fd10 63 61 74 65 20 29 7b 0a 20 20 20 20 20 20 73 71 cate ){. sq
1fd20 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 lite3PagerTrunca
1fd30 74 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 50 61 teImage(pBt->pPa
1fd40 67 65 72 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 ger, pBt->nPage)
1fd50 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
1fd60 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1fd70 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f agerCommitPhaseO
1fd80 6e 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 ne(pBt->pPager,
1fd90 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 zMaster, 0);.
1fda0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1fdb0 76 65 28 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 ve(p);. }. ret
1fdc0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1fdd0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
1fde0 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 62 6f s called from bo
1fdf0 74 68 20 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 th BtreeCommitPh
1fe00 61 73 65 54 77 6f 28 29 20 61 6e 64 20 42 74 72 aseTwo() and Btr
1fe10 65 65 52 6f 6c 6c 62 61 63 6b 28 29 0a 2a 2a 20 eeRollback().**
1fe20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f at the conclusio
1fe30 6e 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 n of a transacti
1fe40 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f on..*/.static vo
1fe50 69 64 20 62 74 72 65 65 45 6e 64 54 72 61 6e 73 id btreeEndTrans
1fe60 61 63 74 69 6f 6e 28 42 74 72 65 65 20 2a 70 29 action(Btree *p)
1fe70 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
1fe80 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 t = p->pBt;. sq
1fe90 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 lite3 *db = p->d
1fea0 62 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c b;. assert( sql
1feb0 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 ite3BtreeHoldsMu
1fec0 74 65 78 28 70 29 20 29 3b 0a 0a 23 69 66 6e 64 tex(p) );..#ifnd
1fed0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
1fee0 55 54 4f 56 41 43 55 55 4d 0a 20 20 70 42 74 2d UTOVACUUM. pBt-
1fef0 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 30 >bDoTruncate = 0
1ff00 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 ;.#endif. if( p
1ff10 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f ->inTrans>TRANS_
1ff20 4e 4f 4e 45 20 26 26 20 64 62 2d 3e 6e 56 64 62 NONE && db->nVdb
1ff30 65 52 65 61 64 3e 31 20 29 7b 0a 20 20 20 20 2f eRead>1 ){. /
1ff40 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f * If there are o
1ff50 74 68 65 72 20 61 63 74 69 76 65 20 73 74 61 74 ther active stat
1ff60 65 6d 65 6e 74 73 20 74 68 61 74 20 62 65 6c 6f ements that belo
1ff70 6e 67 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 ng to this datab
1ff80 61 73 65 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c ase. ** handl
1ff90 65 2c 20 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 e, downgrade to
1ffa0 61 20 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e a read-only tran
1ffb0 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 6f 74 68 saction. The oth
1ffc0 65 72 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 er statements.
1ffd0 20 20 2a 2a 20 6d 61 79 20 73 74 69 6c 6c 20 62 ** may still b
1ffe0 65 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 e reading from t
1fff0 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 2a 2f he database. */
20000 0a 20 20 20 20 64 6f 77 6e 67 72 61 64 65 41 6c . downgradeAl
20010 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c lSharedCacheTabl
20020 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 70 eLocks(p);. p
20030 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e ->inTrans = TRAN
20040 53 5f 52 45 41 44 3b 0a 20 20 7d 65 6c 73 65 7b S_READ;. }else{
20050 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 68 . /* If the h
20060 61 6e 64 6c 65 20 68 61 64 20 61 6e 79 20 6b 69 andle had any ki
20070 6e 64 20 6f 66 20 74 72 61 6e 73 61 63 74 69 6f nd of transactio
20080 6e 20 6f 70 65 6e 2c 20 64 65 63 72 65 6d 65 6e n open, decremen
20090 74 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 74 72 t the . ** tr
200a0 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 ansaction count
200b0 6f 66 20 74 68 65 20 73 68 61 72 65 64 20 62 74 of the shared bt
200c0 72 65 65 2e 20 49 66 20 74 68 65 20 74 72 61 6e ree. If the tran
200d0 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 0a 20 saction count .
200e0 20 20 20 2a 2a 20 72 65 61 63 68 65 73 20 30 2c ** reaches 0,
200f0 20 73 65 74 20 74 68 65 20 73 68 61 72 65 64 20 set the shared
20100 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e state to TRANS_N
20110 4f 4e 45 2e 20 54 68 65 20 75 6e 6c 6f 63 6b 42 ONE. The unlockB
20120 74 72 65 65 49 66 55 6e 75 73 65 64 28 29 0a 20 treeIfUnused().
20130 20 20 20 2a 2a 20 63 61 6c 6c 20 62 65 6c 6f 77 ** call below
20140 20 77 69 6c 6c 20 75 6e 6c 6f 63 6b 20 74 68 65 will unlock the
20150 20 70 61 67 65 72 2e 20 20 2a 2f 0a 20 20 20 20 pager. */.
20160 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 21 3d if( p->inTrans!=
20170 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 TRANS_NONE ){.
20180 20 20 20 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 clearAllShar
20190 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
201a0 73 28 70 29 3b 0a 20 20 20 20 20 20 70 42 74 2d s(p);. pBt-
201b0 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 2d 2d 3b >nTransaction--;
201c0 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 70 42 . if( 0==pB
201d0 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 t->nTransaction
201e0 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e ){. pBt->
201f0 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 inTransaction =
20200 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 TRANS_NONE;.
20210 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f }. }.. /
20220 2a 20 53 65 74 20 74 68 65 20 63 75 72 72 65 6e * Set the curren
20230 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 t transaction st
20240 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e ate to TRANS_NON
20250 45 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 E and unlock the
20260 20 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 69 . ** pager i
20270 66 20 74 68 69 73 20 63 61 6c 6c 20 63 6c 6f 73 f this call clos
20280 65 64 20 74 68 65 20 6f 6e 6c 79 20 72 65 61 64 ed the only read
20290 20 6f 72 20 77 72 69 74 65 20 74 72 61 6e 73 61 or write transa
202a0 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 70 ction. */. p
202b0 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e ->inTrans = TRAN
202c0 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 75 6e 6c 6f S_NONE;. unlo
202d0 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 ckBtreeIfUnused(
202e0 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 pBt);. }.. btr
202f0 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a eeIntegrity(p);.
20300 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 }../*.** Commit
20310 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
20320 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 70 72 6f currently in pro
20330 67 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 gress..**.** Thi
20340 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d s routine implem
20350 65 6e 74 73 20 74 68 65 20 73 65 63 6f 6e 64 20 ents the second
20360 70 68 61 73 65 20 6f 66 20 61 20 32 2d 70 68 61 phase of a 2-pha
20370 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 65 0a se commit. The.
20380 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 ** sqlite3BtreeC
20390 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 20 ommitPhaseOne()
203a0 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 routine does the
203b0 20 66 69 72 73 74 20 70 68 61 73 65 20 61 6e 64 first phase and
203c0 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 65 20 69 6e should.** be in
203d0 76 6f 6b 65 64 20 70 72 69 6f 72 20 74 6f 20 63 voked prior to c
203e0 61 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 alling this rout
203f0 69 6e 65 2e 20 20 54 68 65 20 73 71 6c 69 74 65 ine. The sqlite
20400 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 3BtreeCommitPhas
20410 65 4f 6e 65 28 29 0a 2a 2a 20 72 6f 75 74 69 6e eOne().** routin
20420 65 20 64 69 64 20 61 6c 6c 20 74 68 65 20 77 6f e did all the wo
20430 72 6b 20 6f 66 20 77 72 69 74 69 6e 67 20 69 6e rk of writing in
20440 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 74 20 74 6f formation out to
20450 20 64 69 73 6b 20 61 6e 64 20 66 6c 75 73 68 69 disk and flushi
20460 6e 67 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e ng the.** conten
20470 74 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 ts so that they
20480 61 72 65 20 77 72 69 74 74 65 6e 20 6f 6e 74 6f are written onto
20490 20 74 68 65 20 64 69 73 6b 20 70 6c 61 74 74 65 the disk platte
204a0 72 2e 20 20 41 6c 6c 20 74 68 69 73 0a 2a 2a 20 r. All this.**
204b0 72 6f 75 74 69 6e 65 20 68 61 73 20 74 6f 20 64 routine has to d
204c0 6f 20 69 73 20 64 65 6c 65 74 65 20 6f 72 20 74 o is delete or t
204d0 72 75 6e 63 61 74 65 20 6f 72 20 7a 65 72 6f 20 runcate or zero
204e0 74 68 65 20 68 65 61 64 65 72 20 69 6e 20 74 68 the header in th
204f0 65 0a 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 61 63 e.** the rollbac
20500 6b 20 6a 6f 75 72 6e 61 6c 20 28 77 68 69 63 68 k journal (which
20510 20 63 61 75 73 65 73 20 74 68 65 20 74 72 61 6e causes the tran
20520 73 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d 69 saction to commi
20530 74 29 20 61 6e 64 0a 2a 2a 20 64 72 6f 70 20 6c t) and.** drop l
20540 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d ocks..**.** Norm
20550 61 6c 6c 79 2c 20 69 66 20 61 6e 20 65 72 72 6f ally, if an erro
20560 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 r occurs while t
20570 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 20 69 he pager layer i
20580 73 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 s attempting to
20590 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 .** finalize the
205a0 20 75 6e 64 65 72 6c 79 69 6e 67 20 6a 6f 75 72 underlying jour
205b0 6e 61 6c 20 66 69 6c 65 2c 20 74 68 69 73 20 66 nal file, this f
205c0 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
205d0 61 6e 20 65 72 72 6f 72 20 61 6e 64 0a 2a 2a 20 an error and.**
205e0 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 the upper layer
205f0 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 61 20 72 will attempt a r
20600 6f 6c 6c 62 61 63 6b 2e 20 48 6f 77 65 76 65 72 ollback. However
20610 2c 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 , if the second
20620 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 69 73 20 6e argument.** is n
20630 6f 6e 2d 7a 65 72 6f 20 74 68 65 6e 20 74 68 69 on-zero then thi
20640 73 20 62 2d 74 72 65 65 20 74 72 61 6e 73 61 63 s b-tree transac
20650 74 69 6f 6e 20 69 73 20 70 61 72 74 20 6f 66 20 tion is part of
20660 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 0a 2a 2a a multi-file .**
20670 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 6e transaction. In
20680 20 74 68 69 73 20 63 61 73 65 2c 20 74 68 65 20 this case, the
20690 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 transaction has
206a0 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 6f 6d already been com
206b0 6d 69 74 74 65 64 20 0a 2a 2a 20 28 62 79 20 64 mitted .** (by d
206c0 65 6c 65 74 69 6e 67 20 61 20 6d 61 73 74 65 72 eleting a master
206d0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 journal file) a
206e0 6e 64 20 74 68 65 20 63 61 6c 6c 65 72 20 77 69 nd the caller wi
206f0 6c 6c 20 69 67 6e 6f 72 65 20 74 68 69 73 20 0a ll ignore this .
20700 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 ** functions ret
20710 75 72 6e 20 63 6f 64 65 2e 20 53 6f 2c 20 65 76 urn code. So, ev
20720 65 6e 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f en if an error o
20730 63 63 75 72 73 20 69 6e 20 74 68 65 20 70 61 67 ccurs in the pag
20740 65 72 20 6c 61 79 65 72 2c 0a 2a 2a 20 72 65 73 er layer,.** res
20750 65 74 20 74 68 65 20 62 2d 74 72 65 65 20 6f 62 et the b-tree ob
20760 6a 65 63 74 73 20 69 6e 74 65 72 6e 61 6c 20 73 jects internal s
20770 74 61 74 65 20 74 6f 20 69 6e 64 69 63 61 74 65 tate to indicate
20780 20 74 68 61 74 20 74 68 65 20 77 72 69 74 65 0a that the write.
20790 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 ** transaction h
207a0 61 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 2e 20 as been closed.
207b0 54 68 69 73 20 69 73 20 71 75 69 74 65 20 73 61 This is quite sa
207c0 66 65 2c 20 61 73 20 74 68 65 20 70 61 67 65 72 fe, as the pager
207d0 20 77 69 6c 6c 20 68 61 76 65 0a 2a 2a 20 74 72 will have.** tr
207e0 61 6e 73 69 74 69 6f 6e 65 64 20 74 6f 20 74 68 ansitioned to th
207f0 65 20 65 72 72 6f 72 20 73 74 61 74 65 2e 0a 2a e error state..*
20800 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c 20 72 *.** This will r
20810 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 74 65 elease the write
20820 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
20830 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 abase file. If
20840 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 there.** are no
20850 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 2c 20 active cursors,
20860 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 65 73 it also releases
20870 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a the read lock..
20880 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
20890 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 reeCommitPhaseTw
208a0 6f 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 o(Btree *p, int
208b0 62 43 6c 65 61 6e 75 70 29 7b 0a 0a 20 20 69 66 bCleanup){.. if
208c0 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 ( p->inTrans==TR
208d0 41 4e 53 5f 4e 4f 4e 45 20 29 20 72 65 74 75 72 ANS_NONE ) retur
208e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 n SQLITE_OK;. s
208f0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
20900 28 70 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 (p);. btreeInte
20910 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 grity(p);.. /*
20920 49 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 61 If the handle ha
20930 73 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 s a write-transa
20940 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 63 6f 6d 6d ction open, comm
20950 69 74 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 it the shared-bt
20960 72 65 65 73 20 0a 20 20 2a 2a 20 74 72 61 6e 73 rees . ** trans
20970 61 63 74 69 6f 6e 20 61 6e 64 20 73 65 74 20 74 action and set t
20980 68 65 20 73 68 61 72 65 64 20 73 74 61 74 65 20 he shared state
20990 74 6f 20 54 52 41 4e 53 5f 52 45 41 44 2e 0a 20 to TRANS_READ..
209a0 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 */. if( p->inT
209b0 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 rans==TRANS_WRIT
209c0 45 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b E ){. int rc;
209d0 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 . BtShared *p
209e0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 Bt = p->pBt;.
209f0 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e assert( pBt->in
20a00 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 Transaction==TRA
20a10 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 20 20 NS_WRITE );.
20a20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 54 72 assert( pBt->nTr
20a30 61 6e 73 61 63 74 69 6f 6e 3e 30 20 29 3b 0a 20 ansaction>0 );.
20a40 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
20a50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 54 agerCommitPhaseT
20a60 77 6f 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b wo(pBt->pPager);
20a70 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
20a80 49 54 45 5f 4f 4b 20 26 26 20 62 43 6c 65 61 6e ITE_OK && bClean
20a90 75 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 up==0 ){. s
20aa0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
20ab0 28 70 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 (p);. retur
20ac0 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
20ad0 70 2d 3e 69 44 61 74 61 56 65 72 73 69 6f 6e 2d p->iDataVersion-
20ae0 2d 3b 20 20 2f 2a 20 43 6f 6d 70 65 6e 73 61 74 -; /* Compensat
20af0 65 20 66 6f 72 20 70 50 61 67 65 72 2d 3e 69 44 e for pPager->iD
20b00 61 74 61 56 65 72 73 69 6f 6e 2b 2b 3b 20 2a 2f ataVersion++; */
20b10 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e . pBt->inTran
20b20 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f saction = TRANS_
20b30 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 43 READ;. btreeC
20b40 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 70 learHasContent(p
20b50 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 Bt);. }.. btre
20b60 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 eEndTransaction(
20b70 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 p);. sqlite3Btr
20b80 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
20b90 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
20ba0 7d 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 6f 74 68 }../*.** Do both
20bb0 20 70 68 61 73 65 73 20 6f 66 20 61 20 63 6f 6d phases of a com
20bc0 6d 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 mit..*/.int sqli
20bd0 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 42 te3BtreeCommit(B
20be0 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 tree *p){. int
20bf0 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 rc;. sqlite3Btr
20c00 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 eeEnter(p);. rc
20c10 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 = sqlite3BtreeC
20c20 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 2c ommitPhaseOne(p,
20c30 20 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 0);. if( rc==S
20c40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
20c50 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
20c60 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 eCommitPhaseTwo(
20c70 70 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c p, 0);. }. sql
20c80 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
20c90 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
20ca0 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
20cb0 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 73 utine sets the s
20cc0 74 61 74 65 20 74 6f 20 43 55 52 53 4f 52 5f 46 tate to CURSOR_F
20cd0 41 55 4c 54 20 61 6e 64 20 74 68 65 20 65 72 72 AULT and the err
20ce0 6f 72 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 65 72 or.** code to er
20cf0 72 43 6f 64 65 20 66 6f 72 20 65 76 65 72 79 20 rCode for every
20d00 63 75 72 73 6f 72 20 6f 6e 20 61 6e 79 20 42 74 cursor on any Bt
20d10 53 68 61 72 65 64 20 74 68 61 74 20 70 42 74 72 Shared that pBtr
20d20 65 65 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 ee.** references
20d30 2e 20 20 4f 72 20 69 66 20 74 68 65 20 77 72 69 . Or if the wri
20d40 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 teOnly flag is s
20d50 65 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 6f 6e et to 1, then on
20d60 6c 79 0a 2a 2a 20 74 72 69 70 20 77 72 69 74 65 ly.** trip write
20d70 20 63 75 72 73 6f 72 73 20 61 6e 64 20 6c 65 61 cursors and lea
20d80 76 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 ve read cursors
20d90 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a unchanged..**.**
20da0 20 45 76 65 72 79 20 63 75 72 73 6f 72 20 69 73 Every cursor is
20db0 20 61 20 63 61 6e 64 69 64 61 74 65 20 74 6f 20 a candidate to
20dc0 62 65 20 74 72 69 70 70 65 64 2c 20 69 6e 63 6c be tripped, incl
20dd0 75 64 69 6e 67 20 63 75 72 73 6f 72 73 0a 2a 2a uding cursors.**
20de0 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 that belong to
20df0 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 63 other database c
20e00 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 68 61 74 20 onnections that
20e10 68 61 70 70 65 6e 20 74 6f 20 62 65 0a 2a 2a 20 happen to be.**
20e20 73 68 61 72 69 6e 67 20 74 68 65 20 63 61 63 68 sharing the cach
20e30 65 20 77 69 74 68 20 70 42 74 72 65 65 2e 0a 2a e with pBtree..*
20e40 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
20e50 65 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77 68 e gets called wh
20e60 65 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 en a rollback oc
20e70 63 75 72 73 2e 20 49 66 20 74 68 65 20 77 72 69 curs. If the wri
20e80 74 65 4f 6e 6c 79 0a 2a 2a 20 66 6c 61 67 20 69 teOnly.** flag i
20e90 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e 6c s true, then onl
20ea0 79 20 77 72 69 74 65 2d 63 75 72 73 6f 72 73 20 y write-cursors
20eb0 6e 65 65 64 20 62 65 20 74 72 69 70 70 65 64 20 need be tripped
20ec0 2d 20 72 65 61 64 2d 6f 6e 6c 79 0a 2a 2a 20 63 - read-only.** c
20ed0 75 72 73 6f 72 73 20 73 61 76 65 20 74 68 65 69 ursors save thei
20ee0 72 20 63 75 72 72 65 6e 74 20 70 6f 73 69 74 69 r current positi
20ef0 6f 6e 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 ons so that they
20f00 20 6d 61 79 20 63 6f 6e 74 69 6e 75 65 20 0a 2a may continue .*
20f10 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 * following the
20f20 72 6f 6c 6c 62 61 63 6b 2e 20 4f 72 2c 20 69 66 rollback. Or, if
20f30 20 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 66 61 writeOnly is fa
20f40 6c 73 65 2c 20 61 6c 6c 20 63 75 72 73 6f 72 73 lse, all cursors
20f50 20 61 72 65 20 0a 2a 2a 20 74 72 69 70 70 65 64 are .** tripped
20f60 2e 20 49 6e 20 67 65 6e 65 72 61 6c 2c 20 77 72 . In general, wr
20f70 69 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 iteOnly is false
20f80 20 69 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 if the transact
20f90 69 6f 6e 20 62 65 69 6e 67 0a 2a 2a 20 72 6f 6c ion being.** rol
20fa0 6c 65 64 20 62 61 63 6b 20 6d 6f 64 69 66 69 65 led back modifie
20fb0 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 d the database s
20fc0 63 68 65 6d 61 2e 20 49 6e 20 74 68 69 73 20 63 chema. In this c
20fd0 61 73 65 20 62 2d 74 72 65 65 20 72 6f 6f 74 0a ase b-tree root.
20fe0 2a 2a 20 70 61 67 65 73 20 6d 61 79 20 62 65 20 ** pages may be
20ff0 6d 6f 76 65 64 20 6f 72 20 64 65 6c 65 74 65 64 moved or deleted
21000 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 from the databa
21010 73 65 20 61 6c 74 6f 67 65 74 68 65 72 2c 20 6d se altogether, m
21020 61 6b 69 6e 67 0a 2a 2a 20 69 74 20 75 6e 73 61 aking.** it unsa
21030 66 65 20 66 6f 72 20 72 65 61 64 20 63 75 72 73 fe for read curs
21040 6f 72 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 2e ors to continue.
21050 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 77 72 .**.** If the wr
21060 69 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 iteOnly flag is
21070 74 72 75 65 20 61 6e 64 20 61 6e 20 65 72 72 6f true and an erro
21080 72 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 r is encountered
21090 20 77 68 69 6c 65 20 0a 2a 2a 20 73 61 76 69 6e while .** savin
210a0 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 6f g the current po
210b0 73 69 74 69 6f 6e 20 6f 66 20 61 20 72 65 61 64 sition of a read
210c0 2d 6f 6e 6c 79 20 63 75 72 73 6f 72 2c 20 61 6c -only cursor, al
210d0 6c 20 63 75 72 73 6f 72 73 2c 20 0a 2a 2a 20 69 l cursors, .** i
210e0 6e 63 6c 75 64 69 6e 67 20 61 6c 6c 20 72 65 61 ncluding all rea
210f0 64 2d 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 d-cursors are tr
21100 69 70 70 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c ipped..**.** SQL
21110 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
21120 65 64 20 69 66 20 73 75 63 63 65 73 73 66 75 6c ed if successful
21130 2c 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 , or if an error
21140 20 6f 63 63 75 72 73 20 77 68 69 6c 65 0a 2a 2a occurs while.**
21150 20 73 61 76 69 6e 67 20 61 20 63 75 72 73 6f 72 saving a cursor
21160 20 70 6f 73 69 74 69 6f 6e 2c 20 61 6e 20 53 51 position, an SQ
21170 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e Lite error code.
21180 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
21190 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f treeTripAllCurso
211a0 72 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 65 rs(Btree *pBtree
211b0 2c 20 69 6e 74 20 65 72 72 43 6f 64 65 2c 20 69 , int errCode, i
211c0 6e 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b 0a 20 nt writeOnly){.
211d0 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 BtCursor *p;.
211e0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
211f0 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 28 OK;.. assert( (
21200 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 writeOnly==0 ||
21210 77 72 69 74 65 4f 6e 6c 79 3d 3d 31 29 20 26 26 writeOnly==1) &&
21220 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 67 3d BTCF_WriteFlag=
21230 3d 31 20 29 3b 0a 20 20 69 66 28 20 70 42 74 72 =1 );. if( pBtr
21240 65 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ee ){. sqlite
21250 33 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 3BtreeEnter(pBtr
21260 65 65 29 3b 0a 20 20 20 20 66 6f 72 28 70 3d 70 ee);. for(p=p
21270 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 Btree->pBt->pCur
21280 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 sor; p; p=p->pNe
21290 78 74 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 xt){. int i
212a0 3b 0a 20 20 20 20 20 20 69 66 28 20 77 72 69 74 ;. if( writ
212b0 65 4f 6e 6c 79 20 26 26 20 28 70 2d 3e 63 75 72 eOnly && (p->cur
212c0 46 6c 61 67 73 20 26 20 42 54 43 46 5f 57 72 69 Flags & BTCF_Wri
212d0 74 65 46 6c 61 67 29 3d 3d 30 20 29 7b 0a 20 20 teFlag)==0 ){.
212e0 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 53 74 if( p->eSt
212f0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
21300 44 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d D || p->eState==
21310 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 CURSOR_SKIPNEXT
21320 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
21330 3d 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 = saveCursorPosi
21340 74 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 20 20 tion(p);.
21350 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
21360 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
21370 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 (void)sqlite
21380 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 3BtreeTripAllCur
21390 73 6f 72 73 28 70 42 74 72 65 65 2c 20 72 63 2c sors(pBtree, rc,
213a0 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 0);.
213b0 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
213c0 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
213d0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
213e0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
213f0 6c 65 61 72 43 75 72 73 6f 72 28 70 29 3b 0a 20 learCursor(p);.
21400 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 p->eState
21410 20 3d 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 3b = CURSOR_FAULT;
21420 0a 20 20 20 20 20 20 20 20 70 2d 3e 73 6b 69 70 . p->skip
21430 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b 0a Next = errCode;.
21440 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 6f }. fo
21450 72 28 69 3d 30 3b 20 69 3c 3d 70 2d 3e 69 50 61 r(i=0; i<=p->iPa
21460 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ge; i++){.
21470 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 2d releasePage(p-
21480 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 >apPage[i]);.
21490 20 20 20 20 20 70 2d 3e 61 70 50 61 67 65 5b 69 p->apPage[i
214a0 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 ] = 0;. }.
214b0 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
214c0 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 BtreeLeave(pBtre
214d0 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e e);. }. return
214e0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f rc;.}../*.** Ro
214f0 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 llback the trans
21500 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 action in progre
21510 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 72 69 ss..**.** If tri
21520 70 43 6f 64 65 20 69 73 20 6e 6f 74 20 53 51 4c pCode is not SQL
21530 49 54 45 5f 4f 4b 20 74 68 65 6e 20 63 75 72 73 ITE_OK then curs
21540 6f 72 73 20 77 69 6c 6c 20 62 65 20 69 6e 76 61 ors will be inva
21550 6c 69 64 61 74 65 64 20 28 74 72 69 70 70 65 64 lidated (tripped
21560 29 2e 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 65 )..** Only write
21570 20 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 69 cursors are tri
21580 70 70 65 64 20 69 66 20 77 72 69 74 65 4f 6e 6c pped if writeOnl
21590 79 20 69 73 20 74 72 75 65 20 62 75 74 20 61 6c y is true but al
215a0 6c 20 63 75 72 73 6f 72 73 20 61 72 65 0a 2a 2a l cursors are.**
215b0 20 74 72 69 70 70 65 64 20 69 66 20 77 72 69 74 tripped if writ
215c0 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 2e 20 eOnly is false.
215d0 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 Any attempt to
215e0 75 73 65 0a 2a 2a 20 61 20 74 72 69 70 70 65 64 use.** a tripped
215f0 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 72 65 73 cursor will res
21600 75 6c 74 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e ult in an error.
21610 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c .**.** This will
21620 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 release the wri
21630 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 te lock on the d
21640 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 atabase file. I
21650 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e f there.** are n
21660 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 o active cursors
21670 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 , it also releas
21680 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b es the read lock
21690 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
216a0 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 74 BtreeRollback(Bt
216b0 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 70 ree *p, int trip
216c0 43 6f 64 65 2c 20 69 6e 74 20 77 72 69 74 65 4f Code, int writeO
216d0 6e 6c 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a nly){. int rc;.
216e0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
216f0 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d 50 = p->pBt;. MemP
21700 61 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 20 age *pPage1;..
21710 61 73 73 65 72 74 28 20 77 72 69 74 65 4f 6e 6c assert( writeOnl
21720 79 3d 3d 31 20 7c 7c 20 77 72 69 74 65 4f 6e 6c y==1 || writeOnl
21730 79 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 y==0 );. assert
21740 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c 49 ( tripCode==SQLI
21750 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 TE_ABORT_ROLLBAC
21760 4b 20 7c 7c 20 74 72 69 70 43 6f 64 65 3d 3d 53 K || tripCode==S
21770 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 73 71 QLITE_OK );. sq
21780 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
21790 70 29 3b 0a 20 20 69 66 28 20 74 72 69 70 43 6f p);. if( tripCo
217a0 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b de==SQLITE_OK ){
217b0 0a 20 20 20 20 72 63 20 3d 20 74 72 69 70 43 6f . rc = tripCo
217c0 64 65 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 73 de = saveAllCurs
217d0 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a ors(pBt, 0, 0);.
217e0 20 20 20 20 69 66 28 20 72 63 20 29 20 77 72 69 if( rc ) wri
217f0 74 65 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d 65 teOnly = 0;. }e
21800 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 lse{. rc = SQ
21810 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 LITE_OK;. }. i
21820 66 28 20 74 72 69 70 43 6f 64 65 20 29 7b 0a 20 f( tripCode ){.
21830 20 20 20 69 6e 74 20 72 63 32 20 3d 20 73 71 6c int rc2 = sql
21840 69 74 65 33 42 74 72 65 65 54 72 69 70 41 6c 6c ite3BtreeTripAll
21850 43 75 72 73 6f 72 73 28 70 2c 20 74 72 69 70 43 Cursors(p, tripC
21860 6f 64 65 2c 20 77 72 69 74 65 4f 6e 6c 79 29 3b ode, writeOnly);
21870 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d . assert( rc=
21880 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 77 =SQLITE_OK || (w
21890 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 26 26 20 72 riteOnly==0 && r
218a0 63 32 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 29 c2==SQLITE_OK) )
218b0 3b 0a 20 20 20 20 69 66 28 20 72 63 32 21 3d 53 ;. if( rc2!=S
218c0 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d 20 QLITE_OK ) rc =
218d0 72 63 32 3b 0a 20 20 7d 0a 20 20 62 74 72 65 65 rc2;. }. btree
218e0 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 Integrity(p);..
218f0 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d if( p->inTrans=
21900 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a =TRANS_WRITE ){.
21910 20 20 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 20 int rc2;..
21920 20 20 61 73 73 65 72 74 28 20 54 52 41 4e 53 5f assert( TRANS_
21930 57 52 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 72 WRITE==pBt->inTr
21940 61 6e 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 20 ansaction );.
21950 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 50 61 rc2 = sqlite3Pa
21960 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 2d gerRollback(pBt-
21970 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 >pPager);. if
21980 28 20 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b ( rc2!=SQLITE_OK
21990 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 ){. rc = r
219a0 63 32 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f c2;. }.. /
219b0 2a 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6d * The rollback m
219c0 61 79 20 68 61 76 65 20 64 65 73 74 72 6f 79 65 ay have destroye
219d0 64 20 74 68 65 20 70 50 61 67 65 31 2d 3e 61 44 d the pPage1->aD
219e0 61 74 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a 20 ata value. So.
219f0 20 20 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 65 ** call btree
21a00 47 65 74 50 61 67 65 28 29 20 6f 6e 20 70 61 67 GetPage() on pag
21a10 65 20 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 6b e 1 again to mak
21a20 65 0a 20 20 20 20 2a 2a 20 73 75 72 65 20 70 50 e. ** sure pP
21a30 61 67 65 31 2d 3e 61 44 61 74 61 20 69 73 20 73 age1->aData is s
21a40 65 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a 2f et correctly. */
21a50 0a 20 20 20 20 69 66 28 20 62 74 72 65 65 47 65 . if( btreeGe
21a60 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 70 tPage(pBt, 1, &p
21a70 50 61 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 54 Page1, 0)==SQLIT
21a80 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 6e E_OK ){. in
21a90 74 20 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 t nPage = get4by
21aa0 74 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 65 te(28+(u8*)pPage
21ab0 31 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 20 1->aData);.
21ac0 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 67 65 testcase( nPage
21ad0 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 ==0 );. if(
21ae0 20 6e 50 61 67 65 3d 3d 30 20 29 20 73 71 6c 69 nPage==0 ) sqli
21af0 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e te3PagerPagecoun
21b00 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 t(pBt->pPager, &
21b10 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 74 65 nPage);. te
21b20 73 74 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 61 stcase( pBt->nPa
21b30 67 65 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 20 ge!=nPage );.
21b40 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 pBt->nPage =
21b50 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 72 65 6c nPage;. rel
21b60 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 easePage(pPage1)
21b70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
21b80 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 rt( countValidCu
21b90 72 73 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d 30 rsors(pBt, 1)==0
21ba0 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 );. pBt->inT
21bb0 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 ransaction = TRA
21bc0 4e 53 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 72 NS_READ;. btr
21bd0 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e eeClearHasConten
21be0 74 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 t(pBt);. }.. b
21bf0 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 treeEndTransacti
21c00 6f 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 on(p);. sqlite3
21c10 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
21c20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
21c30 2a 0a 2a 2a 20 53 74 61 72 74 20 61 20 73 74 61 *.** Start a sta
21c40 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 tement subtransa
21c50 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 ction. The subtr
21c60 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 65 ansaction can be
21c70 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 rolled.** back
21c80 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 independently of
21c90 20 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 the main transa
21ca0 63 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 ction. You must
21cb0 73 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 74 start a transact
21cc0 69 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 ion .** before s
21cd0 74 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 61 tarting a subtra
21ce0 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 nsaction. The su
21cf0 62 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 btransaction is
21d00 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 ended automatica
21d10 6c 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d lly .** if the m
21d20 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ain transaction
21d30 63 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 commits or rolls
21d40 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 back..**.** Sta
21d50 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 tement subtransa
21d60 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 ctions are used
21d70 61 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 61 around individua
21d80 6c 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 l SQL statements
21d90 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f 6e .** that are con
21da0 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 20 tained within a
21db0 42 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 BEGIN...COMMIT b
21dc0 6c 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 lock. If a cons
21dd0 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 traint.** error
21de0 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 occurs within th
21df0 65 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 e statement, the
21e00 20 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 20 effect of that
21e10 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a one statement.**
21e20 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 can be rolled b
21e30 61 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 69 ack without havi
21e40 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 ng to rollback t
21e50 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 he entire transa
21e60 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 ction..**.** A s
21e70 74 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 tatement sub-tra
21e80 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c nsaction is impl
21e90 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 6e emented as an an
21ea0 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e onymous savepoin
21eb0 74 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 t. The.** value
21ec0 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65 passed as the se
21ed0 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 cond parameter i
21ee0 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 s the total numb
21ef0 65 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 er of savepoints
21f00 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 ,.** including t
21f10 68 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 he new anonymous
21f20 20 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e savepoint, open
21f30 20 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e 20 on the B-Tree.
21f40 69 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a i.e. if there.**
21f50 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 73 are no active s
21f60 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f avepoints and no
21f70 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 other statement
21f80 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 -transactions op
21f90 65 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e en,.** iStatemen
21fa0 74 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e 6f t is 1. This ano
21fb0 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 nymous savepoint
21fc0 20 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 64 can be released
21fd0 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a or rolled back.
21fe0 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c ** using the sql
21ff0 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 ite3BtreeSavepoi
22000 6e 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a nt() function..*
22010 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
22020 65 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 65 eeBeginStmt(Btre
22030 65 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 65 e *p, int iState
22040 6d 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b ment){. int rc;
22050 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
22060 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c = p->pBt;. sql
22070 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
22080 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
22090 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 inTrans==TRANS_W
220a0 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 74 RITE );. assert
220b0 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 ( (pBt->btsFlags
220c0 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 & BTS_READ_ONLY
220d0 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 )==0 );. assert
220e0 28 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 ( iStatement>0 )
220f0 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 ;. assert( iSta
22100 74 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 tement>p->db->nS
22110 61 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 avepoint );. as
22120 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 sert( pBt->inTra
22130 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
22140 57 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 WRITE );. /* At
22150 20 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 6c the pager level
22160 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 , a statement tr
22170 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 73 ansaction is a s
22180 61 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 avepoint with.
22190 2a 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 61 ** an index grea
221a0 74 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 ter than all sav
221b0 65 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 20 epoints created
221c0 65 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 explicitly using
221d0 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d . ** SQL statem
221e0 65 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 ents. It is ille
221f0 67 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c gal to open, rel
22200 65 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b ease or rollback
22210 20 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 any. ** such s
22220 61 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 avepoints while
22230 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 72 the statement tr
22240 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f ansaction savepo
22250 69 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a 20 int is active..
22260 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 */. rc = sqlit
22270 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 70 e3PagerOpenSavep
22280 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 oint(pBt->pPager
22290 2c 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 , iStatement);.
222a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
222b0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
222c0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 rc;.}../*.** The
222d0 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
222e0 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f to this functio
222f0 6e 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 n, op, is always
22300 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 SAVEPOINT_ROLLB
22310 41 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f ACK.** or SAVEPO
22320 49 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 INT_RELEASE. Thi
22330 73 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 s function eithe
22340 72 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 6f r releases or ro
22350 6c 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 lls back the.**
22360 73 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 savepoint identi
22370 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 fied by paramete
22380 72 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 r iSavepoint, de
22390 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 pending on the v
223a0 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a alue .** of op..
223b0 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 **.** Normally,
223c0 69 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 72 iSavepoint is gr
223d0 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 eater than or eq
223e0 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 ual to zero. How
223f0 65 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a ever, if op is.*
22400 2a 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c * SAVEPOINT_ROLL
22410 42 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 BACK, then iSave
22420 70 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 point may also b
22430 65 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 61 e -1. In this ca
22440 73 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 se the .** conte
22450 6e 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 72 nts of the entir
22460 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 e transaction ar
22470 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 e rolled back. T
22480 68 69 73 20 69 73 20 64 69 66 66 65 72 65 6e 74 his is different
22490 0a 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 .** from a norma
224a0 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f l transaction ro
224b0 6c 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f llback, as no lo
224c0 63 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 cks are released
224d0 20 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e and the.** tran
224e0 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 saction remains
224f0 6f 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c open..*/.int sql
22500 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 ite3BtreeSavepoi
22510 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 nt(Btree *p, int
22520 20 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 6f op, int iSavepo
22530 69 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d int){. int rc =
22540 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
22550 28 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e ( p && p->inTran
22560 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 s==TRANS_WRITE )
22570 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a {. BtShared *
22580 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
22590 20 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 assert( op==SA
225a0 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 VEPOINT_RELEASE
225b0 7c 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 || op==SAVEPOINT
225c0 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 _ROLLBACK );.
225d0 20 61 73 73 65 72 74 28 20 69 53 61 76 65 70 6f assert( iSavepo
225e0 69 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 int>=0 || (iSave
225f0 70 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d point==-1 && op=
22600 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 =SAVEPOINT_ROLLB
22610 41 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 ACK) );. sqli
22620 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
22630 3b 0a 20 20 20 20 69 66 28 20 6f 70 3d 3d 53 41 ;. if( op==SA
22640 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b VEPOINT_ROLLBACK
22650 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
22660 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 aveAllCursors(pB
22670 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a t, 0, 0);. }.
22680 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
22690 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
226a0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
226b0 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 Savepoint(pBt->p
226c0 50 61 67 65 72 2c 20 6f 70 2c 20 69 53 61 76 65 Pager, op, iSave
226d0 70 6f 69 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 point);. }.
226e0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
226f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 _OK ){. if(
22700 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 iSavepoint<0 &&
22710 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
22720 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f & BTS_INITIALLY_
22730 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 EMPTY)!=0 ){.
22740 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 pBt->nPage
22750 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 = 0;. }.
22760 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 rc = newDatab
22770 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 ase(pBt);.
22780 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 pBt->nPage = get
22790 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 4byte(28 + pBt->
227a0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a pPage1->aData);.
227b0 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 . /* The da
227c0 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 20 tabase size was
227d0 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
227e0 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 74 68 offset 28 of th
227f0 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 20 2a e header. *
22800 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 * when the trans
22810 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 action started,
22820 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 so we know that
22830 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f 66 66 the value at off
22840 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 set. ** 28
22850 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 is nonzero. */.
22860 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 assert( pBt
22870 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 ->nPage>0 );.
22880 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 }. sqlite3Bt
22890 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d reeLeave(p);. }
228a0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
228b0 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 ./*.** Create a
228c0 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 20 74 new cursor for t
228d0 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 20 72 he BTree whose r
228e0 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 70 61 oot is on the pa
228f0 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 ge.** iTable. If
22900 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 a read-only cur
22910 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 sor is requested
22920 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 64 20 , it is assumed
22930 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c that.** the call
22940 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 er already has a
22950 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 2d 6f t least a read-o
22960 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 nly transaction
22970 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 open.** on the d
22980 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 79 2e atabase already.
22990 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 72 73 If a write-curs
229a0 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 2c or is requested,
229b0 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c then.** the cal
229c0 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 20 74 ler is assumed t
229d0 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 o have an open w
229e0 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
229f0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 42 ..**.** If the B
22a00 54 52 45 45 5f 57 52 43 53 52 20 62 69 74 20 6f TREE_WRCSR bit o
22a10 66 20 77 72 46 6c 61 67 20 69 73 20 63 6c 65 61 f wrFlag is clea
22a20 72 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 r, then the curs
22a30 6f 72 20 63 61 6e 20 6f 6e 6c 79 0a 2a 2a 20 62 or can only.** b
22a40 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 64 69 e used for readi
22a50 6e 67 2e 20 20 49 66 20 74 68 65 20 42 54 52 45 ng. If the BTRE
22a60 45 5f 57 52 43 53 52 20 62 69 74 20 69 73 20 73 E_WRCSR bit is s
22a70 65 74 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 et, then the cur
22a80 73 6f 72 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 sor.** can be us
22a90 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f ed for reading o
22aa0 72 20 66 6f 72 20 77 72 69 74 69 6e 67 20 69 66 r for writing if
22ab0 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e other condition
22ac0 73 20 66 6f 72 20 77 72 69 74 69 6e 67 0a 2a 2a s for writing.**
22ad0 20 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 are also met.
22ae0 54 68 65 73 65 20 61 72 65 20 74 68 65 20 63 6f These are the co
22af0 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 nditions that mu
22b00 73 74 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 st be met in ord
22b10 65 72 0a 2a 2a 20 66 6f 72 20 77 72 69 74 69 6e er.** for writin
22b20 67 20 74 6f 20 62 65 20 61 6c 6c 6f 77 65 64 3a g to be allowed:
22b30 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 .**.** 1: The c
22b40 75 72 73 6f 72 20 6d 75 73 74 20 68 61 76 65 20 ursor must have
22b50 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 been opened with
22b60 20 77 72 46 6c 61 67 20 63 6f 6e 74 61 69 6e 69 wrFlag containi
22b70 6e 67 20 42 54 52 45 45 5f 57 52 43 53 52 0a 2a ng BTREE_WRCSR.*
22b80 2a 0a 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 *.** 2: Other d
22b90 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
22ba0 6f 6e 73 20 74 68 61 74 20 73 68 61 72 65 20 74 ons that share t
22bb0 68 65 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 he same pager ca
22bc0 63 68 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 che.** but w
22bd0 68 69 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 hich are not in
22be0 74 68 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 the READ_UNCOMMI
22bf0 54 54 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e TTED state may n
22c00 6f 74 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 ot have.** c
22c10 75 72 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 ursors open with
22c20 20 77 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 wrFlag==0 on th
22c30 65 20 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f e same table. O
22c40 74 68 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 therwise.**
22c50 74 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 the changes made
22c60 20 62 79 20 74 68 69 73 20 77 72 69 74 65 20 63 by this write c
22c70 75 72 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 ursor would be v
22c80 69 73 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 isible to.**
22c90 20 74 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 the read cursor
22ca0 73 20 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 s in the other d
22cb0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
22cc0 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 on..**.** 3: Th
22cd0 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 e database must
22ce0 62 65 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 be writable (not
22cf0 20 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 on read-only me
22d00 64 69 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 dia).**.** 4: T
22d10 68 65 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 here must be an
22d20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 active transacti
22d30 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 54 on..**.** The BT
22d40 52 45 45 5f 46 4f 52 44 45 4c 45 54 45 20 62 69 REE_FORDELETE bi
22d50 74 20 6f 66 20 77 72 46 6c 61 67 20 6d 61 79 20 t of wrFlag may
22d60 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 73 65 optionally be se
22d70 74 20 69 66 20 42 54 52 45 45 5f 57 52 43 53 52 t if BTREE_WRCSR
22d80 0a 2a 2a 20 69 73 20 73 65 74 2e 20 20 49 66 20 .** is set. If
22d90 46 4f 52 44 45 4c 45 54 45 20 69 73 20 73 65 74 FORDELETE is set
22da0 2c 20 74 68 61 74 20 69 73 20 61 20 68 69 6e 74 , that is a hint
22db0 20 74 6f 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e to the implemen
22dc0 74 61 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 tation that.** t
22dd0 68 69 73 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 his cursor will
22de0 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 74 6f 20 only be used to
22df0 73 65 65 6b 20 74 6f 20 61 6e 64 20 64 65 6c 65 seek to and dele
22e00 74 65 20 65 6e 74 72 69 65 73 20 6f 66 20 61 6e te entries of an
22e10 20 69 6e 64 65 78 0a 2a 2a 20 61 73 20 70 61 72 index.** as par
22e20 74 20 6f 66 20 61 20 6c 61 72 67 65 72 20 44 45 t of a larger DE
22e30 4c 45 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 LETE statement.
22e40 20 54 68 65 20 46 4f 52 44 45 4c 45 54 45 20 68 The FORDELETE h
22e50 69 6e 74 20 69 73 20 6e 6f 74 20 75 73 65 64 20 int is not used
22e60 62 79 0a 2a 2a 20 74 68 69 73 20 69 6d 70 6c 65 by.** this imple
22e70 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 42 75 74 20 mentation. But
22e80 69 6e 20 61 20 68 79 70 6f 74 68 65 74 69 63 61 in a hypothetica
22e90 6c 20 61 6c 74 65 72 6e 61 74 69 76 65 20 73 74 l alternative st
22ea0 6f 72 61 67 65 20 65 6e 67 69 6e 65 20 0a 2a 2a orage engine .**
22eb0 20 69 6e 20 77 68 69 63 68 20 69 6e 64 65 78 20 in which index
22ec0 65 6e 74 72 69 65 73 20 61 72 65 20 61 75 74 6f entries are auto
22ed0 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 matically delete
22ee0 64 20 77 68 65 6e 20 63 6f 72 72 65 73 70 6f 6e d when correspon
22ef0 64 69 6e 67 20 74 61 62 6c 65 0a 2a 2a 20 72 6f ding table.** ro
22f00 77 73 20 61 72 65 20 64 65 6c 65 74 65 64 2c 20 ws are deleted,
22f10 74 68 65 20 46 4f 52 44 45 4c 45 54 45 20 66 6c the FORDELETE fl
22f20 61 67 20 69 73 20 61 20 68 69 6e 74 20 74 68 61 ag is a hint tha
22f30 74 20 61 6c 6c 20 53 45 45 4b 20 61 6e 64 20 44 t all SEEK and D
22f40 45 4c 45 54 45 0a 2a 2a 20 6f 70 65 72 61 74 69 ELETE.** operati
22f50 6f 6e 73 20 6f 6e 20 74 68 69 73 20 63 75 72 73 ons on this curs
22f60 6f 72 20 63 61 6e 20 62 65 20 6e 6f 2d 6f 70 73 or can be no-ops
22f70 20 61 6e 64 20 61 6c 6c 20 52 45 41 44 20 6f 70 and all READ op
22f80 65 72 61 74 69 6f 6e 73 20 63 61 6e 20 0a 2a 2a erations can .**
22f90 20 72 65 74 75 72 6e 20 61 20 6e 75 6c 6c 20 72 return a null r
22fa0 6f 77 20 28 32 2d 62 79 74 65 73 3a 20 30 78 30 ow (2-bytes: 0x0
22fb0 31 20 30 78 30 30 29 2e 0a 2a 2a 0a 2a 2a 20 4e 1 0x00)..**.** N
22fc0 6f 20 63 68 65 63 6b 69 6e 67 20 69 73 20 64 6f o checking is do
22fd0 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 ne to make sure
22fe0 74 68 61 74 20 70 61 67 65 20 69 54 61 62 6c 65 that page iTable
22ff0 20 72 65 61 6c 6c 79 20 69 73 20 74 68 65 0a 2a really is the.*
23000 2a 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 * root page of a
23010 20 62 2d 74 72 65 65 2e 20 20 49 66 20 69 74 20 b-tree. If it
23020 69 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 is not, then the
23030 20 63 75 72 73 6f 72 20 61 63 71 75 69 72 65 64 cursor acquired
23040 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 .** will not wor
23050 6b 20 63 6f 72 72 65 63 74 6c 79 2e 0a 2a 2a 0a k correctly..**.
23060 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 ** It is assumed
23070 20 74 68 61 74 20 74 68 65 20 73 71 6c 69 74 65 that the sqlite
23080 33 42 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 3BtreeCursorZero
23090 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c () has been call
230a0 65 64 0a 2a 2a 20 6f 6e 20 70 43 75 72 20 74 6f ed.** on pCur to
230b0 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 initialize the
230c0 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 70 72 69 memory space pri
230d0 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 or to invoking t
230e0 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a his routine..*/.
230f0 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 static int btree
23100 43 75 72 73 6f 72 28 0a 20 20 42 74 72 65 65 20 Cursor(. Btree
23110 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 *p,
23120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23130 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
23140 0a 20 20 69 6e 74 20 69 54 61 62 6c 65 2c 20 20 . int iTable,
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 2f 2a 20 52 6f 6f /* Roo
23170 74 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 t page of table
23180 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 to open */. int
23190 20 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 wrFlag,
231a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
231b0 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 /* 1 to writ
231c0 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a e. 0 read-only *
231d0 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 79 49 6e /. struct KeyIn
231e0 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 fo *pKeyInfo,
231f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
23200 72 73 74 20 61 72 67 20 74 6f 20 63 6f 6d 70 61 rst arg to compa
23210 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a rison function *
23220 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 /. BtCursor *pC
23230 75 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ur
23240 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 /* Sp
23250 61 63 65 20 66 6f 72 20 6e 65 77 20 63 75 72 73 ace for new curs
23260 6f 72 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 or */.){. BtSha
23270 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
23280 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
23290 20 20 2f 2a 20 53 68 61 72 65 64 20 62 2d 74 72 /* Shared b-tr
232a0 65 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 ee handle */. B
232b0 74 43 75 72 73 6f 72 20 2a 70 58 3b 20 20 20 20 tCursor *pX;
232c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
232d0 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 69 6e 67 /* Looping
232e0 20 6f 76 65 72 20 6f 74 68 65 72 20 61 6c 6c 20 over other all
232f0 63 75 72 73 6f 72 73 20 2a 2f 0a 0a 20 20 61 73 cursors */.. as
23300 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 sert( sqlite3Btr
23310 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 eeHoldsMutex(p)
23320 29 3b 0a 20 20 61 73 73 65 72 74 28 20 77 72 46 );. assert( wrF
23330 6c 61 67 3d 3d 30 20 0a 20 20 20 20 20 20 20 7c lag==0 . |
23340 7c 20 77 72 46 6c 61 67 3d 3d 42 54 52 45 45 5f | wrFlag==BTREE_
23350 57 52 43 53 52 20 0a 20 20 20 20 20 20 20 7c 7c WRCSR . ||
23360 20 77 72 46 6c 61 67 3d 3d 28 42 54 52 45 45 5f wrFlag==(BTREE_
23370 57 52 43 53 52 7c 42 54 52 45 45 5f 46 4f 52 44 WRCSR|BTREE_FORD
23380 45 4c 45 54 45 29 20 0a 20 20 29 3b 0a 0a 20 20 ELETE) . );..
23390 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
233a0 20 61 73 73 65 72 74 20 73 74 61 74 65 6d 65 6e assert statemen
233b0 74 73 20 76 65 72 69 66 79 20 74 68 61 74 20 69 ts verify that i
233c0 66 20 74 68 69 73 20 69 73 20 61 20 73 68 61 72 f this is a shar
233d0 61 62 6c 65 20 0a 20 20 2a 2a 20 62 2d 74 72 65 able . ** b-tre
233e0 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 e database, the
233f0 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f connection is ho
23400 6c 64 69 6e 67 20 74 68 65 20 72 65 71 75 69 72 lding the requir
23410 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 2c 20 ed table locks,
23420 0a 20 20 2a 2a 20 61 6e 64 20 74 68 61 74 20 6e . ** and that n
23430 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 o other connecti
23440 6f 6e 20 68 61 73 20 61 6e 79 20 6f 70 65 6e 20 on has any open
23450 63 75 72 73 6f 72 20 74 68 61 74 20 63 6f 6e 66 cursor that conf
23460 6c 69 63 74 73 20 77 69 74 68 20 0a 20 20 2a 2a licts with . **
23470 20 74 68 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f 0a this lock. */.
23480 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 61 assert( hasSha
23490 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
234a0 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 70 4b 65 k(p, iTable, pKe
234b0 79 49 6e 66 6f 21 3d 30 2c 20 28 77 72 46 6c 61 yInfo!=0, (wrFla
234c0 67 3f 32 3a 31 29 29 20 29 3b 0a 20 20 61 73 73 g?2:1)) );. ass
234d0 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
234e0 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 | !hasReadConfli
234f0 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 20 29 cts(p, iTable) )
23500 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 74 ;.. /* Assert t
23510 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68 hat the caller h
23520 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 72 65 as opened the re
23530 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 74 69 quired transacti
23540 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 on. */. assert(
23550 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e p->inTrans>TRAN
23560 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 S_NONE );. asse
23570 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c rt( wrFlag==0 ||
23580 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 p->inTrans==TRA
23590 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 73 NS_WRITE );. as
235a0 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 65 sert( pBt->pPage
235b0 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 1 && pBt->pPage1
235c0 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 61 73 73 ->aData );. ass
235d0 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
235e0 7c 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 | (pBt->btsFlags
235f0 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 & BTS_READ_ONLY
23600 29 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 77 )==0 );.. if( w
23610 72 46 6c 61 67 20 29 7b 0a 20 20 20 20 61 6c 6c rFlag ){. all
23620 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 70 ocateTempSpace(p
23630 42 74 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 Bt);. if( pBt
23640 2d 3e 70 54 6d 70 53 70 61 63 65 3d 3d 30 20 29 ->pTmpSpace==0 )
23650 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
23660 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 OMEM_BKPT;. }.
23670 20 69 66 28 20 69 54 61 62 6c 65 3d 3d 31 20 26 if( iTable==1 &
23680 26 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 & btreePagecount
23690 28 70 42 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 (pBt)==0 ){.
236a0 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d assert( wrFlag==
236b0 30 20 29 3b 0a 20 20 20 20 69 54 61 62 6c 65 20 0 );. iTable
236c0 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e = 0;. }.. /* N
236d0 6f 77 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 ow that no other
236e0 20 65 72 72 6f 72 73 20 63 61 6e 20 6f 63 63 75 errors can occu
236f0 72 2c 20 66 69 6e 69 73 68 20 66 69 6c 6c 69 6e r, finish fillin
23700 67 20 69 6e 20 74 68 65 20 42 74 43 75 72 73 6f g in the BtCurso
23710 72 0a 20 20 2a 2a 20 76 61 72 69 61 62 6c 65 73 r. ** variables
23720 20 61 6e 64 20 6c 69 6e 6b 20 74 68 65 20 63 75 and link the cu
23730 72 73 6f 72 20 69 6e 74 6f 20 74 68 65 20 42 74 rsor into the Bt
23740 53 68 61 72 65 64 20 6c 69 73 74 2e 20 20 2a 2f Shared list. */
23750 0a 20 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f . pCur->pgnoRoo
23760 74 20 3d 20 28 50 67 6e 6f 29 69 54 61 62 6c 65 t = (Pgno)iTable
23770 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 ;. pCur->iPage
23780 3d 20 2d 31 3b 0a 20 20 70 43 75 72 2d 3e 70 4b = -1;. pCur->pK
23790 65 79 49 6e 66 6f 20 3d 20 70 4b 65 79 49 6e 66 eyInfo = pKeyInf
237a0 6f 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 72 65 o;. pCur->pBtre
237b0 65 20 3d 20 70 3b 0a 20 20 70 43 75 72 2d 3e 70 e = p;. pCur->p
237c0 42 74 20 3d 20 70 42 74 3b 0a 20 20 70 43 75 72 Bt = pBt;. pCur
237d0 2d 3e 63 75 72 46 6c 61 67 73 20 3d 20 77 72 46 ->curFlags = wrF
237e0 6c 61 67 20 3f 20 42 54 43 46 5f 57 72 69 74 65 lag ? BTCF_Write
237f0 46 6c 61 67 20 3a 20 30 3b 0a 20 20 70 43 75 72 Flag : 0;. pCur
23800 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 73 20 ->curPagerFlags
23810 3d 20 77 72 46 6c 61 67 20 3f 20 30 20 3a 20 50 = wrFlag ? 0 : P
23820 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c AGER_GET_READONL
23830 59 3b 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 Y;. /* If there
23840 20 61 72 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 are two or more
23850 20 63 75 72 73 6f 72 73 20 6f 6e 20 74 68 65 20 cursors on the
23860 73 61 6d 65 20 62 74 72 65 65 2c 20 74 68 65 6e same btree, then
23870 20 61 6c 6c 20 73 75 63 68 0a 20 20 2a 2a 20 63 all such. ** c
23880 75 72 73 6f 72 73 20 2a 6d 75 73 74 2a 20 68 61 ursors *must* ha
23890 76 65 20 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 ve the BTCF_Mult
238a0 69 70 6c 65 20 66 6c 61 67 20 73 65 74 2e 20 2a iple flag set. *
238b0 2f 0a 20 20 66 6f 72 28 70 58 3d 70 42 74 2d 3e /. for(pX=pBt->
238c0 70 43 75 72 73 6f 72 3b 20 70 58 3b 20 70 58 3d pCursor; pX; pX=
238d0 70 58 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 pX->pNext){.
238e0 69 66 28 20 70 58 2d 3e 70 67 6e 6f 52 6f 6f 74 if( pX->pgnoRoot
238f0 3d 3d 28 50 67 6e 6f 29 69 54 61 62 6c 65 20 29 ==(Pgno)iTable )
23900 7b 0a 20 20 20 20 20 20 70 58 2d 3e 63 75 72 46 {. pX->curF
23910 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 4d 75 6c lags |= BTCF_Mul
23920 74 69 70 6c 65 3b 0a 20 20 20 20 20 20 70 43 75 tiple;. pCu
23930 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 r->curFlags |= B
23940 54 43 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a 20 20 TCF_Multiple;.
23950 20 20 7d 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e }. }. pCur->
23960 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 43 75 pNext = pBt->pCu
23970 72 73 6f 72 3b 0a 20 20 70 42 74 2d 3e 70 43 75 rsor;. pBt->pCu
23980 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 rsor = pCur;. p
23990 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
239a0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
239b0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
239c0 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 ;.}.int sqlite3B
239d0 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 42 74 treeCursor(. Bt
239e0 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 ree *p,
239f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23a00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
23a10 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 btree */. int
23a20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 iTable,
23a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23a40 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 /* Root
23a50 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f page of table to
23a60 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 open */. int w
23a70 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 rFlag,
23a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23a90 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 /* 1 to w
23aa0 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c rite. 0 read-onl
23ab0 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 y */. struct Ke
23ac0 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c yInfo *pKeyInfo,
23ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23ae0 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 /* First arg
23af0 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 20 2a 2f to xCompare() */
23b00 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
23b10 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
23b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23b30 2a 20 57 72 69 74 65 20 6e 65 77 20 63 75 72 73 * Write new curs
23b40 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 or here */.){.
23b50 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 69 54 int rc;. if( iT
23b60 61 62 6c 65 3c 31 20 29 7b 0a 20 20 20 20 72 63 able<1 ){. rc
23b70 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
23b80 54 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 7b T_BKPT;. }else{
23b90 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
23ba0 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 20 20 72 eEnter(p);. r
23bb0 63 20 3d 20 62 74 72 65 65 43 75 72 73 6f 72 28 c = btreeCursor(
23bc0 70 2c 20 69 54 61 62 6c 65 2c 20 77 72 46 6c 61 p, iTable, wrFla
23bd0 67 2c 20 70 4b 65 79 49 6e 66 6f 2c 20 70 43 75 g, pKeyInfo, pCu
23be0 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 r);. sqlite3B
23bf0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
23c00 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
23c10 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
23c20 68 65 20 73 69 7a 65 20 6f 66 20 61 20 42 74 43 he size of a BtC
23c30 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 ursor object in
23c40 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 bytes..**.** Thi
23c50 73 20 69 6e 74 65 72 66 61 63 65 73 20 69 73 20 s interfaces is
23c60 6e 65 65 64 65 64 20 73 6f 20 74 68 61 74 20 75 needed so that u
23c70 73 65 72 73 20 6f 66 20 63 75 72 73 6f 72 73 20 sers of cursors
23c80 63 61 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a can preallocate.
23c90 2a 2a 20 73 75 66 66 69 63 69 65 6e 74 20 73 74 ** sufficient st
23ca0 6f 72 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 orage to hold a
23cb0 63 75 72 73 6f 72 2e 20 20 54 68 65 20 42 74 43 cursor. The BtC
23cc0 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 ursor object is
23cd0 6f 70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 opaque.** to use
23ce0 72 73 20 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f rs so they canno
23cf0 74 20 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 t do the sizeof(
23d00 29 20 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 ) themselves - t
23d10 68 65 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a hey must call.**
23d20 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a this routine..*
23d30 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
23d40 65 65 43 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 eeCursorSize(voi
23d50 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 d){. return ROU
23d60 4e 44 38 28 73 69 7a 65 6f 66 28 42 74 43 75 72 ND8(sizeof(BtCur
23d70 73 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 sor));.}../*.**
23d80 49 6e 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 Initialize memor
23d90 79 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 63 y that will be c
23da0 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 onverted into a
23db0 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e BtCursor object.
23dc0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c .**.** The simpl
23dd0 65 20 61 70 70 72 6f 61 63 68 20 68 65 72 65 20 e approach here
23de0 77 6f 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 would be to mems
23df0 65 74 28 29 20 74 68 65 20 65 6e 74 69 72 65 20 et() the entire
23e00 6f 62 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 object.** to zer
23e10 6f 2e 20 20 42 75 74 20 69 74 20 74 75 72 6e 73 o. But it turns
23e20 20 6f 75 74 20 74 68 61 74 20 74 68 65 20 61 70 out that the ap
23e30 50 61 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 Page[] and aiIdx
23e40 5b 5d 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 [] arrays.** do
23e50 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 7a not need to be z
23e60 65 72 6f 65 64 20 61 6e 64 20 74 68 65 79 20 61 eroed and they a
23e70 72 65 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 re large, so we
23e80 63 61 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a can save a lot.*
23e90 2a 20 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 * of run-time by
23ea0 20 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 6e skipping the in
23eb0 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 itialization of
23ec0 74 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a those elements..
23ed0 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 */.void sqlite3B
23ee0 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 treeCursorZero(B
23ef0 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d tCursor *p){. m
23f00 65 6d 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 emset(p, 0, offs
23f10 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 69 etof(BtCursor, i
23f20 50 61 67 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Page));.}../*.**
23f30 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 2e Close a cursor.
23f40 20 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 The read lock
23f50 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
23f60 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 64 file is released
23f70 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 .** when the las
23f80 74 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 t cursor is clos
23f90 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
23fa0 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 e3BtreeCloseCurs
23fb0 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 or(BtCursor *pCu
23fc0 72 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 r){. Btree *pBt
23fd0 72 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 ree = pCur->pBtr
23fe0 65 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 ee;. if( pBtree
23ff0 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
24000 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 BtShared *pBt
24010 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 20 = pCur->pBt;.
24020 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
24030 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 ter(pBtree);.
24040 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 sqlite3BtreeCle
24050 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a arCursor(pCur);.
24060 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
24070 3e 70 43 75 72 73 6f 72 21 3d 30 20 29 3b 0a 20 >pCursor!=0 );.
24080 20 20 20 69 66 28 20 70 42 74 2d 3e 70 43 75 72 if( pBt->pCur
24090 73 6f 72 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 sor==pCur ){.
240a0 20 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 pBt->pCursor
240b0 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 = pCur->pNext;.
240c0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
240d0 42 74 43 75 72 73 6f 72 20 2a 70 50 72 65 76 20 BtCursor *pPrev
240e0 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
240f0 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 do{.
24100 20 20 69 66 28 20 70 50 72 65 76 2d 3e 70 4e 65 if( pPrev->pNe
24110 78 74 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 20 xt==pCur ){.
24120 20 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e 65 pPrev->pNe
24130 78 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 xt = pCur->pNext
24140 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 ;. brea
24150 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 k;. }.
24160 20 20 20 20 20 70 50 72 65 76 20 3d 20 70 50 72 pPrev = pPr
24170 65 76 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 ev->pNext;.
24180 20 7d 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 }while( ALWAYS(
24190 70 50 72 65 76 29 20 29 3b 0a 20 20 20 20 7d 0a pPrev) );. }.
241a0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d for(i=0; i<=
241b0 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b pCur->iPage; i++
241c0 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 ){. release
241d0 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 67 Page(pCur->apPag
241e0 65 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 e[i]);. }.
241f0 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e unlockBtreeIfUn
24200 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 20 73 used(pBt);. s
24210 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 qlite3_free(pCur
24220 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 20 ->aOverflow);.
24230 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 66 72 65 /* sqlite3_fre
24240 65 28 70 43 75 72 29 3b 20 2a 2f 0a 20 20 20 20 e(pCur); */.
24250 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
24260 65 28 70 42 74 72 65 65 29 3b 0a 20 20 7d 0a 20 e(pBtree);. }.
24270 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
24280 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 K;.}../*.** Make
24290 20 73 75 72 65 20 74 68 65 20 42 74 43 75 72 73 sure the BtCurs
242a0 6f 72 2a 20 67 69 76 65 6e 20 69 6e 20 74 68 65 or* given in the
242b0 20 61 72 67 75 6d 65 6e 74 20 68 61 73 20 61 20 argument has a
242c0 76 61 6c 69 64 0a 2a 2a 20 42 74 43 75 72 73 6f valid.** BtCurso
242d0 72 2e 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 r.info structure
242e0 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 . If it is not
242f0 61 6c 72 65 61 64 79 20 76 61 6c 69 64 2c 20 63 already valid, c
24300 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 all.** btreePars
24310 65 43 65 6c 6c 28 29 20 74 6f 20 66 69 6c 6c 20 eCell() to fill
24320 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 43 it in..**.** BtC
24330 75 72 73 6f 72 2e 69 6e 66 6f 20 69 73 20 61 20 ursor.info is a
24340 63 61 63 68 65 20 6f 66 20 74 68 65 20 69 6e 66 cache of the inf
24350 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 ormation in the
24360 63 75 72 72 65 6e 74 20 63 65 6c 6c 2e 0a 2a 2a current cell..**
24370 20 55 73 69 6e 67 20 74 68 69 73 20 63 61 63 68 Using this cach
24380 65 20 72 65 64 75 63 65 73 20 74 68 65 20 6e 75 e reduces the nu
24390 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 74 6f mber of calls to
243a0 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 btreeParseCell(
243b0 29 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 )..*/.#ifndef ND
243c0 45 42 55 47 0a 20 20 73 74 61 74 69 63 20 76 6f EBUG. static vo
243d0 69 64 20 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 id assertCellInf
243e0 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 o(BtCursor *pCur
243f0 29 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 ){. CellInfo
24400 69 6e 66 6f 3b 0a 20 20 20 20 69 6e 74 20 69 50 info;. int iP
24410 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 67 age = pCur->iPag
24420 65 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 69 e;. memset(&i
24430 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 6f 66 28 69 nfo, 0, sizeof(i
24440 6e 66 6f 29 29 3b 0a 20 20 20 20 62 74 72 65 65 nfo));. btree
24450 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e ParseCell(pCur->
24460 61 70 50 61 67 65 5b 69 50 61 67 65 5d 2c 20 70 apPage[iPage], p
24470 43 75 72 2d 3e 69 78 2c 20 26 69 6e 66 6f 29 3b Cur->ix, &info);
24480 0a 20 20 20 20 61 73 73 65 72 74 28 20 43 4f 52 . assert( COR
24490 52 55 50 54 5f 44 42 20 7c 7c 20 6d 65 6d 63 6d RUPT_DB || memcm
244a0 70 28 26 69 6e 66 6f 2c 20 26 70 43 75 72 2d 3e p(&info, &pCur->
244b0 69 6e 66 6f 2c 20 73 69 7a 65 6f 66 28 69 6e 66 info, sizeof(inf
244c0 6f 29 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 o))==0 );. }.#e
244d0 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 61 73 lse. #define as
244e0 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 78 29 0a sertCellInfo(x).
244f0 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 53 51 #endif.static SQ
24500 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f LITE_NOINLINE vo
24510 69 64 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 42 id getCellInfo(B
24520 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
24530 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f if( pCur->info
24540 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 .nSize==0 ){.
24550 20 69 6e 74 20 69 50 61 67 65 20 3d 20 70 43 75 int iPage = pCu
24560 72 2d 3e 69 50 61 67 65 3b 0a 20 20 20 20 70 43 r->iPage;. pC
24570 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 ur->curFlags |=
24580 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 3b 0a BTCF_ValidNKey;.
24590 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
245a0 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b ll(pCur->apPage[
245b0 69 50 61 67 65 5d 2c 70 43 75 72 2d 3e 69 78 2c iPage],pCur->ix,
245c0 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 &pCur->info);.
245d0 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 }else{. asser
245e0 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
245f0 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 . }.}..#ifndef
24600 4e 44 45 42 55 47 20 20 2f 2a 20 54 68 65 20 6e NDEBUG /* The n
24610 65 78 74 20 72 6f 75 74 69 6e 65 20 75 73 65 64 ext routine used
24620 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 73 only within ass
24630 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
24640 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e */./*.** Return
24650 20 74 72 75 65 20 69 66 20 74 68 65 20 67 69 76 true if the giv
24660 65 6e 20 42 74 43 75 72 73 6f 72 20 69 73 20 76 en BtCursor is v
24670 61 6c 69 64 2e 20 20 41 20 76 61 6c 69 64 20 63 alid. A valid c
24680 75 72 73 6f 72 20 69 73 20 6f 6e 65 0a 2a 2a 20 ursor is one.**
24690 74 68 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c that is currentl
246a0 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 y pointing to a
246b0 72 6f 77 20 69 6e 20 61 20 28 6e 6f 6e 2d 65 6d row in a (non-em
246c0 70 74 79 29 20 74 61 62 6c 65 2e 0a 2a 2a 20 54 pty) table..** T
246d0 68 69 73 20 69 73 20 61 20 76 65 72 69 66 69 63 his is a verific
246e0 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 20 69 73 ation routine is
246f0 20 75 73 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 used only withi
24700 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
24710 6d 65 6e 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ments..*/.int sq
24720 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 lite3BtreeCursor
24730 49 73 56 61 6c 69 64 28 42 74 43 75 72 73 6f 72 IsValid(BtCursor
24740 20 2a 70 43 75 72 29 7b 0a 20 20 72 65 74 75 72 *pCur){. retur
24750 6e 20 70 43 75 72 20 26 26 20 70 43 75 72 2d 3e n pCur && pCur->
24760 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
24770 41 4c 49 44 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f ALID;.}.#endif /
24780 2a 20 4e 44 45 42 55 47 20 2a 2f 0a 69 6e 74 20 * NDEBUG */.int
24790 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
247a0 6f 72 49 73 56 61 6c 69 64 4e 4e 28 42 74 43 75 orIsValidNN(BtCu
247b0 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 rsor *pCur){. a
247c0 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 29 ssert( pCur!=0 )
247d0 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d ;. return pCur-
247e0 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
247f0 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 VALID;.}../*.**
24800 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 Return the value
24810 20 6f 66 20 74 68 65 20 69 6e 74 65 67 65 72 20 of the integer
24820 6b 65 79 20 6f 72 20 22 72 6f 77 69 64 22 20 66 key or "rowid" f
24830 6f 72 20 61 20 74 61 62 6c 65 20 62 74 72 65 65 or a table btree
24840 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e ..** This routin
24850 65 20 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 e is only valid
24860 66 6f 72 20 61 20 63 75 72 73 6f 72 20 74 68 61 for a cursor tha
24870 74 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 69 6e t is pointing in
24880 74 6f 20 61 0a 2a 2a 20 6f 72 64 69 6e 61 72 79 to a.** ordinary
24890 20 74 61 62 6c 65 20 62 74 72 65 65 2e 20 20 49 table btree. I
248a0 66 20 74 68 65 20 63 75 72 73 6f 72 20 70 6f 69 f the cursor poi
248b0 6e 74 73 20 74 6f 20 61 6e 20 69 6e 64 65 78 20 nts to an index
248c0 62 74 72 65 65 20 6f 72 0a 2a 2a 20 69 73 20 69 btree or.** is i
248d0 6e 76 61 6c 69 64 2c 20 74 68 65 20 72 65 73 75 nvalid, the resu
248e0 6c 74 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 lt of this routi
248f0 6e 65 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e ne is undefined.
24900 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 74 65 33 42 .*/.i64 sqlite3B
24910 74 72 65 65 49 6e 74 65 67 65 72 4b 65 79 28 42 treeIntegerKey(B
24920 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
24930 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
24940 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
24950 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
24960 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
24970 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 OR_VALID );. as
24980 73 65 72 74 28 20 70 43 75 72 2d 3e 63 75 72 49 sert( pCur->curI
24990 6e 74 4b 65 79 20 29 3b 0a 20 20 67 65 74 43 65 ntKey );. getCe
249a0 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 llInfo(pCur);.
249b0 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 69 6e 66 return pCur->inf
249c0 6f 2e 6e 4b 65 79 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a o.nKey;.}../*.**
249d0 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 Return the numb
249e0 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 70 er of bytes of p
249f0 61 79 6c 6f 61 64 20 66 6f 72 20 74 68 65 20 65 ayload for the e
24a00 6e 74 72 79 20 74 68 61 74 20 70 43 75 72 20 69 ntry that pCur i
24a10 73 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 70 s.** currently p
24a20 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 20 46 6f 72 ointing to. For
24a30 20 74 61 62 6c 65 20 62 74 72 65 65 73 2c 20 74 table btrees, t
24a40 68 69 73 20 77 69 6c 6c 20 62 65 20 74 68 65 20 his will be the
24a50 61 6d 6f 75 6e 74 0a 2a 2a 20 6f 66 20 64 61 74 amount.** of dat
24a60 61 2e 20 20 46 6f 72 20 69 6e 64 65 78 20 62 74 a. For index bt
24a70 72 65 65 73 2c 20 74 68 69 73 20 77 69 6c 6c 20 rees, this will
24a80 62 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 be the size of t
24a90 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 he key..**.** Th
24aa0 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 67 75 e caller must gu
24ab0 61 72 61 6e 74 65 65 20 74 68 61 74 20 74 68 65 arantee that the
24ac0 20 63 75 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 cursor is point
24ad0 69 6e 67 20 74 6f 20 61 20 6e 6f 6e 2d 4e 55 4c ing to a non-NUL
24ae0 4c 0a 2a 2a 20 76 61 6c 69 64 20 65 6e 74 72 79 L.** valid entry
24af0 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 . In other word
24b00 73 2c 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 s, the calling p
24b10 72 6f 63 65 64 75 72 65 20 6d 75 73 74 20 67 75 rocedure must gu
24b20 61 72 61 6e 74 65 65 0a 2a 2a 20 74 68 61 74 20 arantee.** that
24b30 74 68 65 20 63 75 72 73 6f 72 20 68 61 73 20 43 the cursor has C
24b40 75 72 73 6f 72 2e 65 53 74 61 74 65 3d 3d 43 55 ursor.eState==CU
24b50 52 53 4f 52 5f 56 41 4c 49 44 2e 0a 2a 2f 0a 75 RSOR_VALID..*/.u
24b60 33 32 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 32 sqlite3BtreeP
24b70 61 79 6c 6f 61 64 53 69 7a 65 28 42 74 43 75 72 ayloadSize(BtCur
24b80 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 sor *pCur){. as
24b90 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
24ba0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
24bb0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
24bc0 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
24bd0 41 4c 49 44 20 29 3b 0a 20 20 67 65 74 43 65 6c ALID );. getCel
24be0 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 72 lInfo(pCur);. r
24bf0 65 74 75 72 6e 20 70 43 75 72 2d 3e 69 6e 66 6f eturn pCur->info
24c00 2e 6e 50 61 79 6c 6f 61 64 3b 0a 7d 0a 0a 2f 2a .nPayload;.}../*
24c10 0a 2a 2a 20 47 69 76 65 6e 20 74 68 65 20 70 61 .** Given the pa
24c20 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 6e 20 ge number of an
24c30 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e overflow page in
24c40 20 74 68 65 20 64 61 74 61 62 61 73 65 20 28 70 the database (p
24c50 61 72 61 6d 65 74 65 72 0a 2a 2a 20 6f 76 66 6c arameter.** ovfl
24c60 29 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ), this function
24c70 20 66 69 6e 64 73 20 74 68 65 20 70 61 67 65 20 finds the page
24c80 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 6e 65 number of the ne
24c90 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 0a xt page in the .
24ca0 2a 2a 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f ** linked list o
24cb0 66 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 f overflow pages
24cc0 2e 20 49 66 20 70 6f 73 73 69 62 6c 65 2c 20 69 . If possible, i
24cd0 74 20 75 73 65 73 20 74 68 65 20 61 75 74 6f 2d t uses the auto-
24ce0 76 61 63 75 75 6d 0a 2a 2a 20 70 6f 69 6e 74 65 vacuum.** pointe
24cf0 72 2d 6d 61 70 20 64 61 74 61 20 69 6e 73 74 65 r-map data inste
24d00 61 64 20 6f 66 20 72 65 61 64 69 6e 67 20 74 68 ad of reading th
24d10 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 70 61 67 e content of pag
24d20 65 20 6f 76 66 6c 20 74 6f 20 64 6f 20 73 6f 2e e ovfl to do so.
24d30 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 .**.** If an er
24d40 72 6f 72 20 6f 63 63 75 72 73 20 61 6e 20 53 51 ror occurs an SQ
24d50 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 Lite error code
24d60 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 is returned. Oth
24d70 65 72 77 69 73 65 3a 0a 2a 2a 0a 2a 2a 20 54 68 erwise:.**.** Th
24d80 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
24d90 20 74 68 65 20 6e 65 78 74 20 6f 76 65 72 66 6c the next overfl
24da0 6f 77 20 70 61 67 65 20 69 6e 20 74 68 65 20 6c ow page in the l
24db0 69 6e 6b 65 64 20 6c 69 73 74 20 69 73 20 0a 2a inked list is .*
24dc0 2a 20 77 72 69 74 74 65 6e 20 74 6f 20 2a 70 50 * written to *pP
24dd0 67 6e 6f 4e 65 78 74 2e 20 49 66 20 70 61 67 65 gnoNext. If page
24de0 20 6f 76 66 6c 20 69 73 20 74 68 65 20 6c 61 73 ovfl is the las
24df0 74 20 70 61 67 65 20 69 6e 20 69 74 73 20 6c 69 t page in its li
24e00 6e 6b 65 64 20 0a 2a 2a 20 6c 69 73 74 2c 20 2a nked .** list, *
24e10 70 50 67 6e 6f 4e 65 78 74 20 69 73 20 73 65 74 pPgnoNext is set
24e20 20 74 6f 20 7a 65 72 6f 2e 20 0a 2a 2a 0a 2a 2a to zero. .**.**
24e30 20 49 66 20 70 70 50 61 67 65 20 69 73 20 6e 6f If ppPage is no
24e40 74 20 4e 55 4c 4c 2c 20 61 6e 64 20 61 20 72 65 t NULL, and a re
24e50 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 4d ference to the M
24e60 65 6d 50 61 67 65 20 6f 62 6a 65 63 74 20 63 6f emPage object co
24e70 72 72 65 73 70 6f 6e 64 69 6e 67 0a 2a 2a 20 74 rresponding.** t
24e80 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 70 4f o page number pO
24e90 76 66 6c 20 77 61 73 20 6f 62 74 61 69 6e 65 64 vfl was obtained
24ea0 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 65 20 69 , then *ppPage i
24eb0 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 s set to point t
24ec0 6f 20 74 68 61 74 0a 2a 2a 20 72 65 66 65 72 65 o that.** refere
24ed0 6e 63 65 2e 20 49 74 20 69 73 20 74 68 65 20 72 nce. It is the r
24ee0 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 esponsibility of
24ef0 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 63 the caller to c
24f00 61 6c 6c 20 72 65 6c 65 61 73 65 50 61 67 65 28 all releasePage(
24f10 29 0a 2a 2a 20 6f 6e 20 2a 70 70 50 61 67 65 20 ).** on *ppPage
24f20 74 6f 20 66 72 65 65 20 74 68 65 20 72 65 66 65 to free the refe
24f30 72 65 6e 63 65 2e 20 49 6e 20 6e 6f 20 72 65 66 rence. In no ref
24f40 65 72 65 6e 63 65 20 77 61 73 20 6f 62 74 61 69 erence was obtai
24f50 6e 65 64 20 28 62 65 63 61 75 73 65 0a 2a 2a 20 ned (because.**
24f60 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 the pointer-map
24f70 77 61 73 20 75 73 65 64 20 74 6f 20 6f 62 74 61 was used to obta
24f80 69 6e 20 74 68 65 20 76 61 6c 75 65 20 66 6f 72 in the value for
24f90 20 2a 70 50 67 6e 6f 4e 65 78 74 29 2c 20 74 68 *pPgnoNext), th
24fa0 65 6e 0a 2a 2a 20 2a 70 70 50 61 67 65 20 69 73 en.** *ppPage is
24fb0 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 0a 2a 2f set to zero..*/
24fc0 0a 73 74 61 74 69 63 20 69 6e 74 20 67 65 74 4f .static int getO
24fd0 76 65 72 66 6c 6f 77 50 61 67 65 28 0a 20 20 42 verflowPage(. B
24fe0 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 tShared *pBt,
24ff0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
25000 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
25010 20 2a 2f 0a 20 20 50 67 6e 6f 20 6f 76 66 6c 2c */. Pgno ovfl,
25020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25030 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 6f 76 /* Current ov
25040 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 erflow page numb
25050 65 72 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 er */. MemPage
25060 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 20 **ppPage,
25070 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4d 65 6d /* OUT: Mem
25080 50 61 67 65 20 68 61 6e 64 6c 65 20 28 6d 61 79 Page handle (may
25090 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 50 be NULL) */. P
250a0 67 6e 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 20 20 gno *pPgnoNext
250b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
250c0 55 54 3a 20 4e 65 78 74 20 6f 76 65 72 66 6c 6f UT: Next overflo
250d0 77 20 70 61 67 65 20 6e 75 6d 62 65 72 20 2a 2f w page number */
250e0 0a 29 7b 0a 20 20 50 67 6e 6f 20 6e 65 78 74 20 .){. Pgno next
250f0 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a = 0;. MemPage *
25100 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 69 6e 74 pPage = 0;. int
25110 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
25120 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
25130 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
25140 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
25150 61 73 73 65 72 74 28 70 50 67 6e 6f 4e 65 78 74 assert(pPgnoNext
25160 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 );..#ifndef SQLI
25170 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
25180 55 4d 0a 20 20 2f 2a 20 54 72 79 20 74 6f 20 66 UM. /* Try to f
25190 69 6e 64 20 74 68 65 20 6e 65 78 74 20 70 61 67 ind the next pag
251a0 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f e in the overflo
251b0 77 20 6c 69 73 74 20 75 73 69 6e 67 20 74 68 65 w list using the
251c0 0a 20 20 2a 2a 20 61 75 74 6f 76 61 63 75 75 6d . ** autovacuum
251d0 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 pointer-map pag
251e0 65 73 2e 20 47 75 65 73 73 20 74 68 61 74 20 74 es. Guess that t
251f0 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
25200 0a 20 20 2a 2a 20 74 68 65 20 6f 76 65 72 66 6c . ** the overfl
25210 6f 77 20 6c 69 73 74 20 69 73 20 70 61 67 65 20 ow list is page
25220 6e 75 6d 62 65 72 20 28 6f 76 66 6c 2b 31 29 2e number (ovfl+1).
25230 20 49 66 20 74 68 61 74 20 67 75 65 73 73 20 74 If that guess t
25240 75 72 6e 73 20 0a 20 20 2a 2a 20 6f 75 74 20 74 urns . ** out t
25250 6f 20 62 65 20 77 72 6f 6e 67 2c 20 66 61 6c 6c o be wrong, fall
25260 20 62 61 63 6b 20 74 6f 20 6c 6f 61 64 69 6e 67 back to loading
25270 20 74 68 65 20 64 61 74 61 20 6f 66 20 70 61 67 the data of pag
25280 65 20 0a 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f e . ** number o
25290 76 66 6c 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 vfl to determine
252a0 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 20 6e the next page n
252b0 75 6d 62 65 72 2e 0a 20 20 2a 2f 0a 20 20 69 66 umber.. */. if
252c0 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ( pBt->autoVacuu
252d0 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 70 67 m ){. Pgno pg
252e0 6e 6f 3b 0a 20 20 20 20 50 67 6e 6f 20 69 47 75 no;. Pgno iGu
252f0 65 73 73 20 3d 20 6f 76 66 6c 2b 31 3b 0a 20 20 ess = ovfl+1;.
25300 20 20 75 38 20 65 54 79 70 65 3b 0a 0a 20 20 20 u8 eType;..
25310 20 77 68 69 6c 65 28 20 50 54 52 4d 41 50 5f 49 while( PTRMAP_I
25320 53 50 41 47 45 28 70 42 74 2c 20 69 47 75 65 73 SPAGE(pBt, iGues
25330 73 29 20 7c 7c 20 69 47 75 65 73 73 3d 3d 50 45 s) || iGuess==PE
25340 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
25350 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 69 47 pBt) ){. iG
25360 75 65 73 73 2b 2b 3b 0a 20 20 20 20 7d 0a 0a 20 uess++;. }..
25370 20 20 20 69 66 28 20 69 47 75 65 73 73 3c 3d 62 if( iGuess<=b
25380 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 treePagecount(pB
25390 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d t) ){. rc =
253a0 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 ptrmapGet(pBt,
253b0 69 47 75 65 73 73 2c 20 26 65 54 79 70 65 2c 20 iGuess, &eType,
253c0 26 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69 66 &pgno);. if
253d0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
253e0 26 26 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 && eType==PTRMAP
253f0 5f 4f 56 45 52 46 4c 4f 57 32 20 26 26 20 70 67 _OVERFLOW2 && pg
25400 6e 6f 3d 3d 6f 76 66 6c 20 29 7b 0a 20 20 20 20 no==ovfl ){.
25410 20 20 20 20 6e 65 78 74 20 3d 20 69 47 75 65 73 next = iGues
25420 73 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 s;. rc =
25430 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 SQLITE_DONE;.
25440 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 }. }. }.#
25450 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 endif.. assert(
25460 20 6e 65 78 74 3d 3d 30 20 7c 7c 20 72 63 3d 3d next==0 || rc==
25470 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 SQLITE_DONE );.
25480 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
25490 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 62 OK ){. rc = b
254a0 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c treeGetPage(pBt,
254b0 20 6f 76 66 6c 2c 20 26 70 50 61 67 65 2c 20 28 ovfl, &pPage, (
254c0 70 70 50 61 67 65 3d 3d 30 29 20 3f 20 50 41 47 ppPage==0) ? PAG
254d0 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 ER_GET_READONLY
254e0 3a 20 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 : 0);. assert
254f0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
25500 7c 7c 20 70 50 61 67 65 3d 3d 30 20 29 3b 0a 20 || pPage==0 );.
25510 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
25520 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 6e 65 E_OK ){. ne
25530 78 74 20 3d 20 67 65 74 34 62 79 74 65 28 70 50 xt = get4byte(pP
25540 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 age->aData);.
25550 20 7d 0a 20 20 7d 0a 0a 20 20 2a 70 50 67 6e 6f }. }.. *pPgno
25560 4e 65 78 74 20 3d 20 6e 65 78 74 3b 0a 20 20 69 Next = next;. i
25570 66 28 20 70 70 50 61 67 65 20 29 7b 0a 20 20 20 f( ppPage ){.
25580 20 2a 70 70 50 61 67 65 20 3d 20 70 50 61 67 65 *ppPage = pPage
25590 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 ;. }else{. r
255a0 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
255b0 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
255c0 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 (rc==SQLITE_DONE
255d0 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 72 ? SQLITE_OK : r
255e0 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 70 c);.}../*.** Cop
255f0 79 20 64 61 74 61 20 66 72 6f 6d 20 61 20 62 75 y data from a bu
25600 66 66 65 72 20 74 6f 20 61 20 70 61 67 65 2c 20 ffer to a page,
25610 6f 72 20 66 72 6f 6d 20 61 20 70 61 67 65 20 74 or from a page t
25620 6f 20 61 20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a o a buffer..**.*
25630 2a 20 70 50 61 79 6c 6f 61 64 20 69 73 20 61 20 * pPayload is a
25640 70 6f 69 6e 74 65 72 20 74 6f 20 64 61 74 61 20 pointer to data
25650 73 74 6f 72 65 64 20 6f 6e 20 64 61 74 61 62 61 stored on databa
25660 73 65 20 70 61 67 65 20 70 44 62 50 61 67 65 2e se page pDbPage.
25670 0a 2a 2a 20 49 66 20 61 72 67 75 6d 65 6e 74 20 .** If argument
25680 65 4f 70 20 69 73 20 66 61 6c 73 65 2c 20 74 68 eOp is false, th
25690 65 6e 20 6e 42 79 74 65 20 62 79 74 65 73 20 6f en nByte bytes o
256a0 66 20 64 61 74 61 20 61 72 65 20 63 6f 70 69 65 f data are copie
256b0 64 0a 2a 2a 20 66 72 6f 6d 20 70 50 61 79 6c 6f d.** from pPaylo
256c0 61 64 20 74 6f 20 74 68 65 20 62 75 66 66 65 72 ad to the buffer
256d0 20 70 6f 69 6e 74 65 64 20 61 74 20 62 79 20 70 pointed at by p
256e0 42 75 66 2e 20 49 66 20 65 4f 70 20 69 73 20 74 Buf. If eOp is t
256f0 72 75 65 2c 0a 2a 2a 20 74 68 65 6e 20 73 71 6c rue,.** then sql
25700 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 29 ite3PagerWrite()
25710 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 70 44 is called on pD
25720 62 50 61 67 65 20 61 6e 64 20 6e 42 79 74 65 20 bPage and nByte
25730 62 79 74 65 73 0a 2a 2a 20 6f 66 20 64 61 74 61 bytes.** of data
25740 20 61 72 65 20 63 6f 70 69 65 64 20 66 72 6f 6d are copied from
25750 20 74 68 65 20 62 75 66 66 65 72 20 70 42 75 66 the buffer pBuf
25760 20 74 6f 20 70 50 61 79 6c 6f 61 64 2e 0a 2a 2a to pPayload..**
25770 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 .** SQLITE_OK is
25780 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 returned on suc
25790 63 65 73 73 2c 20 6f 74 68 65 72 77 69 73 65 20 cess, otherwise
257a0 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a an error code..*
257b0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6f 70 /.static int cop
257c0 79 50 61 79 6c 6f 61 64 28 0a 20 20 76 6f 69 64 yPayload(. void
257d0 20 2a 70 50 61 79 6c 6f 61 64 2c 20 20 20 20 20 *pPayload,
257e0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
257f0 20 74 6f 20 70 61 67 65 20 64 61 74 61 20 2a 2f to page data */
25800 0a 20 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 20 . void *pBuf,
25810 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
25820 50 6f 69 6e 74 65 72 20 74 6f 20 62 75 66 66 65 Pointer to buffe
25830 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 r */. int nByte
25840 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
25850 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 /* Number of by
25860 74 65 73 20 74 6f 20 63 6f 70 79 20 2a 2f 0a 20 tes to copy */.
25870 20 69 6e 74 20 65 4f 70 2c 20 20 20 20 20 20 20 int eOp,
25880 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30 20 /* 0
25890 2d 3e 20 63 6f 70 79 20 66 72 6f 6d 20 70 61 67 -> copy from pag
258a0 65 2c 20 31 20 2d 3e 20 63 6f 70 79 20 74 6f 20 e, 1 -> copy to
258b0 70 61 67 65 20 2a 2f 0a 20 20 44 62 50 61 67 65 page */. DbPage
258c0 20 2a 70 44 62 50 61 67 65 20 20 20 20 20 20 20 *pDbPage
258d0 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 /* Page cont
258e0 61 69 6e 69 6e 67 20 70 50 61 79 6c 6f 61 64 20 aining pPayload
258f0 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 65 4f 70 20 */.){. if( eOp
25900 29 7b 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 64 ){. /* Copy d
25910 61 74 61 20 66 72 6f 6d 20 62 75 66 66 65 72 20 ata from buffer
25920 74 6f 20 70 61 67 65 20 28 61 20 77 72 69 74 65 to page (a write
25930 20 6f 70 65 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 operation) */.
25940 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 int rc = sqli
25950 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 44 te3PagerWrite(pD
25960 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 bPage);. if(
25970 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
25980 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
25990 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 63 ;. }. memc
259a0 70 79 28 70 50 61 79 6c 6f 61 64 2c 20 70 42 75 py(pPayload, pBu
259b0 66 2c 20 6e 42 79 74 65 29 3b 0a 20 20 7d 65 6c f, nByte);. }el
259c0 73 65 7b 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 se{. /* Copy
259d0 64 61 74 61 20 66 72 6f 6d 20 70 61 67 65 20 74 data from page t
259e0 6f 20 62 75 66 66 65 72 20 28 61 20 72 65 61 64 o buffer (a read
259f0 20 6f 70 65 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 operation) */.
25a00 20 20 20 6d 65 6d 63 70 79 28 70 42 75 66 2c 20 memcpy(pBuf,
25a10 70 50 61 79 6c 6f 61 64 2c 20 6e 42 79 74 65 29 pPayload, nByte)
25a20 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
25a30 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
25a40 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
25a50 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 is used to read
25a60 20 6f 72 20 6f 76 65 72 77 72 69 74 65 20 70 61 or overwrite pa
25a70 79 6c 6f 61 64 20 69 6e 66 6f 72 6d 61 74 69 6f yload informatio
25a80 6e 0a 2a 2a 20 66 6f 72 20 74 68 65 20 65 6e 74 n.** for the ent
25a90 72 79 20 74 68 61 74 20 74 68 65 20 70 43 75 72 ry that the pCur
25aa0 20 63 75 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 cursor is point
25ab0 69 6e 67 20 74 6f 2e 20 54 68 65 20 65 4f 70 0a ing to. The eOp.
25ac0 2a 2a 20 61 72 67 75 6d 65 6e 74 20 69 73 20 69 ** argument is i
25ad0 6e 74 65 72 70 72 65 74 65 64 20 61 73 20 66 6f nterpreted as fo
25ae0 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 30 llows:.**.** 0
25af0 3a 20 54 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 : The operation
25b00 69 73 20 61 20 72 65 61 64 2e 20 50 6f 70 75 6c is a read. Popul
25b10 61 74 65 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 ate the overflow
25b20 20 63 61 63 68 65 2e 0a 2a 2a 20 20 20 31 3a 20 cache..** 1:
25b30 54 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 The operation is
25b40 20 61 20 77 72 69 74 65 2e 20 50 6f 70 75 6c 61 a write. Popula
25b50 74 65 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 te the overflow
25b60 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 74 cache..**.** A t
25b70 6f 74 61 6c 20 6f 66 20 22 61 6d 74 22 20 62 79 otal of "amt" by
25b80 74 65 73 20 61 72 65 20 72 65 61 64 20 6f 72 20 tes are read or
25b90 77 72 69 74 74 65 6e 20 62 65 67 69 6e 6e 69 6e written beginnin
25ba0 67 20 61 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a g at "offset"..*
25bb0 2a 20 44 61 74 61 20 69 73 20 72 65 61 64 20 74 * Data is read t
25bc0 6f 20 6f 72 20 66 72 6f 6d 20 74 68 65 20 62 75 o or from the bu
25bd0 66 66 65 72 20 70 42 75 66 2e 0a 2a 2a 0a 2a 2a ffer pBuf..**.**
25be0 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 62 65 69 The content bei
25bf0 6e 67 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 ng read or writt
25c00 65 6e 20 6d 69 67 68 74 20 61 70 70 65 61 72 20 en might appear
25c10 6f 6e 20 74 68 65 20 6d 61 69 6e 20 70 61 67 65 on the main page
25c20 0a 2a 2a 20 6f 72 20 62 65 20 73 63 61 74 74 65 .** or be scatte
25c30 72 65 64 20 6f 75 74 20 6f 6e 20 6d 75 6c 74 69 red out on multi
25c40 70 6c 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ple overflow pag
25c50 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 es..**.** If the
25c60 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 20 current cursor
25c70 65 6e 74 72 79 20 75 73 65 73 20 6f 6e 65 20 6f entry uses one o
25c80 72 20 6d 6f 72 65 20 6f 76 65 72 66 6c 6f 77 20 r more overflow
25c90 70 61 67 65 73 0a 2a 2a 20 74 68 69 73 20 66 75 pages.** this fu
25ca0 6e 63 74 69 6f 6e 20 6d 61 79 20 61 6c 6c 6f 63 nction may alloc
25cb0 61 74 65 20 73 70 61 63 65 20 66 6f 72 20 61 6e ate space for an
25cc0 64 20 6c 61 7a 69 6c 79 20 70 6f 70 75 6c 61 74 d lazily populat
25cd0 65 0a 2a 2a 20 74 68 65 20 6f 76 65 72 66 6c 6f e.** the overflo
25ce0 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 w page-list cach
25cf0 65 20 61 72 72 61 79 20 28 42 74 43 75 72 73 6f e array (BtCurso
25d00 72 2e 61 4f 76 65 72 66 6c 6f 77 29 2e 20 0a 2a r.aOverflow). .*
25d10 2a 20 53 75 62 73 65 71 75 65 6e 74 20 63 61 6c * Subsequent cal
25d20 6c 73 20 75 73 65 20 74 68 69 73 20 63 61 63 68 ls use this cach
25d30 65 20 74 6f 20 6d 61 6b 65 20 73 65 65 6b 69 6e e to make seekin
25d40 67 20 74 6f 20 74 68 65 20 73 75 70 70 6c 69 65 g to the supplie
25d50 64 20 6f 66 66 73 65 74 20 0a 2a 2a 20 6d 6f 72 d offset .** mor
25d60 65 20 65 66 66 69 63 69 65 6e 74 2e 0a 2a 2a 0a e efficient..**.
25d70 2a 2a 20 4f 6e 63 65 20 61 6e 20 6f 76 65 72 66 ** Once an overf
25d80 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
25d90 63 68 65 20 68 61 73 20 62 65 65 6e 20 61 6c 6c che has been all
25da0 6f 63 61 74 65 64 2c 20 69 74 20 6d 75 73 74 20 ocated, it must
25db0 62 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 61 74 65 be.** invalidate
25dc0 64 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 d if some other
25dd0 63 75 72 73 6f 72 20 77 72 69 74 65 73 20 74 6f cursor writes to
25de0 20 74 68 65 20 73 61 6d 65 20 74 61 62 6c 65 2c the same table,
25df0 20 6f 72 20 69 66 0a 2a 2a 20 74 68 65 20 63 75 or if.** the cu
25e00 72 73 6f 72 20 69 73 20 6d 6f 76 65 64 20 74 6f rsor is moved to
25e10 20 61 20 64 69 66 66 65 72 65 6e 74 20 72 6f 77 a different row
25e20 2e 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 . Additionally,
25e30 69 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a in auto-vacuum.*
25e40 2a 20 6d 6f 64 65 2c 20 74 68 65 20 66 6f 6c 6c * mode, the foll
25e50 6f 77 69 6e 67 20 65 76 65 6e 74 73 20 6d 61 79 owing events may
25e60 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 20 6f invalidate an o
25e70 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 verflow page-lis
25e80 74 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 20 t cache..**.**
25e90 20 2a 20 41 6e 20 69 6e 63 72 65 6d 65 6e 74 61 * An incrementa
25ea0 6c 20 76 61 63 75 75 6d 2c 0a 2a 2a 20 20 20 2a l vacuum,.** *
25eb0 20 41 20 63 6f 6d 6d 69 74 20 69 6e 20 61 75 74 A commit in aut
25ec0 6f 5f 76 61 63 75 75 6d 3d 22 66 75 6c 6c 22 20 o_vacuum="full"
25ed0 6d 6f 64 65 2c 0a 2a 2a 20 20 20 2a 20 43 72 65 mode,.** * Cre
25ee0 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 28 6d ating a table (m
25ef0 61 79 20 72 65 71 75 69 72 65 20 6d 6f 76 69 6e ay require movin
25f00 67 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 g an overflow pa
25f10 67 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ge)..*/.static i
25f20 6e 74 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 nt accessPayload
25f30 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 (. BtCursor *pC
25f40 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 73 ur, /* Curs
25f50 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 or pointing to e
25f60 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 6f ntry to read fro
25f70 6d 20 2a 2f 0a 20 20 75 33 32 20 6f 66 66 73 65 m */. u32 offse
25f80 74 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 t, /* B
25f90 65 67 69 6e 20 72 65 61 64 69 6e 67 20 74 68 69 egin reading thi
25fa0 73 20 66 61 72 20 69 6e 74 6f 20 70 61 79 6c 6f s far into paylo
25fb0 61 64 20 2a 2f 0a 20 20 75 33 32 20 61 6d 74 2c ad */. u32 amt,
25fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
25fd0 52 65 61 64 20 74 68 69 73 20 6d 61 6e 79 20 62 Read this many b
25fe0 79 74 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e ytes */. unsign
25ff0 65 64 20 63 68 61 72 20 2a 70 42 75 66 2c 20 2f ed char *pBuf, /
26000 2a 20 57 72 69 74 65 20 74 68 65 20 62 79 74 65 * Write the byte
26010 73 20 69 6e 74 6f 20 74 68 69 73 20 62 75 66 66 s into this buff
26020 65 72 20 2a 2f 20 0a 20 20 69 6e 74 20 65 4f 70 er */ . int eOp
26030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
26040 20 7a 65 72 6f 20 74 6f 20 72 65 61 64 2e 20 6e zero to read. n
26050 6f 6e 2d 7a 65 72 6f 20 74 6f 20 77 72 69 74 65 on-zero to write
26060 2e 20 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 6e . */.){. unsign
26070 65 64 20 63 68 61 72 20 2a 61 50 61 79 6c 6f 61 ed char *aPayloa
26080 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 d;. int rc = SQ
26090 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 LITE_OK;. int i
260a0 49 64 78 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 Idx = 0;. MemPa
260b0 67 65 20 2a 70 50 61 67 65 20 3d 20 70 43 75 72 ge *pPage = pCur
260c0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
260d0 50 61 67 65 5d 3b 20 2f 2a 20 42 74 72 65 65 20 Page]; /* Btree
260e0 70 61 67 65 20 6f 66 20 63 75 72 72 65 6e 74 20 page of current
260f0 65 6e 74 72 79 20 2a 2f 0a 20 20 42 74 53 68 61 entry */. BtSha
26100 72 65 64 20 2a 70 42 74 20 3d 20 70 43 75 72 2d red *pBt = pCur-
26110 3e 70 42 74 3b 20 20 20 20 20 20 20 20 20 20 20 >pBt;
26120 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 /* Btree
26130 74 68 69 73 20 63 75 72 73 6f 72 20 62 65 6c 6f this cursor belo
26140 6e 67 73 20 74 6f 20 2a 2f 0a 23 69 66 64 65 66 ngs to */.#ifdef
26150 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f SQLITE_DIRECT_O
26160 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 75 VERFLOW_READ. u
26170 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 20 63 nsigned char * c
26180 6f 6e 73 74 20 70 42 75 66 53 74 61 72 74 20 3d onst pBufStart =
26190 20 70 42 75 66 3b 20 20 20 20 20 2f 2a 20 53 74 pBuf; /* St
261a0 61 72 74 20 6f 66 20 6f 72 69 67 69 6e 61 6c 20 art of original
261b0 6f 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 23 65 out buffer */.#e
261c0 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 ndif.. assert(
261d0 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 pPage );. asser
261e0 74 28 20 65 4f 70 3d 3d 30 20 7c 7c 20 65 4f 70 t( eOp==0 || eOp
261f0 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==1 );. assert(
26200 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
26210 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
26220 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
26230 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 x<pPage->nCell )
26240 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
26250 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
26260 72 29 20 29 3b 0a 0a 20 20 67 65 74 43 65 6c 6c r) );.. getCell
26270 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 61 50 Info(pCur);. aP
26280 61 79 6c 6f 61 64 20 3d 20 70 43 75 72 2d 3e 69 ayload = pCur->i
26290 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3b 0a 20 20 nfo.pPayload;.
262a0 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 2b 61 assert( offset+a
262b0 6d 74 20 3c 3d 20 70 43 75 72 2d 3e 69 6e 66 6f mt <= pCur->info
262c0 2e 6e 50 61 79 6c 6f 61 64 20 29 3b 0a 0a 20 20 .nPayload );..
262d0 61 73 73 65 72 74 28 20 61 50 61 79 6c 6f 61 64 assert( aPayload
262e0 20 3e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 > pPage->aData
262f0 29 3b 0a 20 20 69 66 28 20 28 75 70 74 72 29 28 );. if( (uptr)(
26300 61 50 61 79 6c 6f 61 64 20 2d 20 70 50 61 67 65 aPayload - pPage
26310 2d 3e 61 44 61 74 61 29 20 3e 20 28 70 42 74 2d ->aData) > (pBt-
26320 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 70 43 >usableSize - pC
26330 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 29 ur->info.nLocal)
26340 20 29 7b 0a 20 20 20 20 2f 2a 20 54 72 79 69 6e ){. /* Tryin
26350 67 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72 69 g to read or wri
26360 74 65 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 te past the end
26370 6f 66 20 74 68 65 20 64 61 74 61 20 69 73 20 61 of the data is a
26380 6e 20 65 72 72 6f 72 2e 20 20 54 68 65 0a 20 20 n error. The.
26390 20 20 2a 2a 20 63 6f 6e 64 69 74 69 6f 6e 61 6c ** conditional
263a0 20 61 62 6f 76 65 20 69 73 20 72 65 61 6c 6c 79 above is really
263b0 3a 0a 20 20 20 20 2a 2a 20 20 20 20 26 61 50 61 :. ** &aPa
263c0 79 6c 6f 61 64 5b 70 43 75 72 2d 3e 69 6e 66 6f yload[pCur->info
263d0 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 26 70 50 61 67 .nLocal] > &pPag
263e0 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 75 73 e->aData[pBt->us
263f0 61 62 6c 65 53 69 7a 65 5d 0a 20 20 20 20 2a 2a ableSize]. **
26400 20 62 75 74 20 69 73 20 72 65 63 61 73 74 20 69 but is recast i
26410 6e 74 6f 20 69 74 73 20 63 75 72 72 65 6e 74 20 nto its current
26420 66 6f 72 6d 20 74 6f 20 61 76 6f 69 64 20 69 6e form to avoid in
26430 74 65 67 65 72 20 6f 76 65 72 66 6c 6f 77 20 70 teger overflow p
26440 72 6f 62 6c 65 6d 73 0a 20 20 20 20 2a 2f 0a 20 roblems. */.
26450 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
26460 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
26470 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 }.. /* Check i
26480 66 20 64 61 74 61 20 6d 75 73 74 20 62 65 20 72 f data must be r
26490 65 61 64 2f 77 72 69 74 74 65 6e 20 74 6f 2f 66 ead/written to/f
264a0 72 6f 6d 20 74 68 65 20 62 74 72 65 65 20 70 61 rom the btree pa
264b0 67 65 20 69 74 73 65 6c 66 2e 20 2a 2f 0a 20 20 ge itself. */.
264c0 69 66 28 20 6f 66 66 73 65 74 3c 70 43 75 72 2d if( offset<pCur-
264d0 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 7b 0a >info.nLocal ){.
264e0 20 20 20 20 69 6e 74 20 61 20 3d 20 61 6d 74 3b int a = amt;
264f0 0a 20 20 20 20 69 66 28 20 61 2b 6f 66 66 73 65 . if( a+offse
26500 74 3e 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f t>pCur->info.nLo
26510 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 61 20 3d cal ){. a =
26520 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 pCur->info.nLoc
26530 61 6c 20 2d 20 6f 66 66 73 65 74 3b 0a 20 20 20 al - offset;.
26540 20 7d 0a 20 20 20 20 72 63 20 3d 20 63 6f 70 79 }. rc = copy
26550 50 61 79 6c 6f 61 64 28 26 61 50 61 79 6c 6f 61 Payload(&aPayloa
26560 64 5b 6f 66 66 73 65 74 5d 2c 20 70 42 75 66 2c d[offset], pBuf,
26570 20 61 2c 20 65 4f 70 2c 20 70 50 61 67 65 2d 3e a, eOp, pPage->
26580 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 6f 66 pDbPage);. of
26590 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 20 70 42 fset = 0;. pB
265a0 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 61 6d 74 uf += a;. amt
265b0 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 65 7b 0a -= a;. }else{.
265c0 20 20 20 20 6f 66 66 73 65 74 20 2d 3d 20 70 43 offset -= pC
265d0 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b ur->info.nLocal;
265e0 0a 20 20 7d 0a 0a 0a 20 20 69 66 28 20 72 63 3d . }... if( rc=
265f0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d =SQLITE_OK && am
26600 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 t>0 ){. const
26610 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 20 3d 20 u32 ovflSize =
26620 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
26630 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 73 20 63 - 4; /* Bytes c
26640 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 66 6c 20 ontent per ovfl
26650 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 67 6e 6f page */. Pgno
26660 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 20 20 nextPage;..
26670 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 62 nextPage = get4b
26680 79 74 65 28 26 61 50 61 79 6c 6f 61 64 5b 70 43 yte(&aPayload[pC
26690 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d ur->info.nLocal]
266a0 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 );.. /* If th
266b0 65 20 42 74 43 75 72 73 6f 72 2e 61 4f 76 65 72 e BtCursor.aOver
266c0 66 6c 6f 77 5b 5d 20 68 61 73 20 6e 6f 74 20 62 flow[] has not b
266d0 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 2c 20 61 een allocated, a
266e0 6c 6c 6f 63 61 74 65 20 69 74 20 6e 6f 77 2e 0a llocate it now..
266f0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 **. ** Th
26700 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 72 e aOverflow[] ar
26710 72 61 79 20 69 73 20 73 69 7a 65 64 20 61 74 20 ray is sized at
26720 6f 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 one entry for ea
26730 63 68 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 ch overflow page
26740 0a 20 20 20 20 2a 2a 20 69 6e 20 74 68 65 20 6f . ** in the o
26750 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e 20 54 verflow chain. T
26760 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
26770 66 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 72 f the first over
26780 66 6c 6f 77 20 70 61 67 65 20 69 73 0a 20 20 20 flow page is.
26790 20 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20 61 4f ** stored in aO
267a0 76 65 72 66 6c 6f 77 5b 30 5d 2c 20 65 74 63 2e verflow[0], etc.
267b0 20 41 20 76 61 6c 75 65 20 6f 66 20 30 20 69 6e A value of 0 in
267c0 20 74 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d the aOverflow[]
267d0 20 61 72 72 61 79 0a 20 20 20 20 2a 2a 20 6d 65 array. ** me
267e0 61 6e 73 20 22 6e 6f 74 20 79 65 74 20 6b 6e 6f ans "not yet kno
267f0 77 6e 22 20 28 74 68 65 20 63 61 63 68 65 20 69 wn" (the cache i
26800 73 20 6c 61 7a 69 6c 79 20 70 6f 70 75 6c 61 74 s lazily populat
26810 65 64 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ed).. */.
26820 69 66 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c if( (pCur->curFl
26830 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 ags & BTCF_Valid
26840 4f 76 66 6c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 Ovfl)==0 ){.
26850 20 20 69 6e 74 20 6e 4f 76 66 6c 20 3d 20 28 70 int nOvfl = (p
26860 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f Cur->info.nPaylo
26870 61 64 2d 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c ad-pCur->info.nL
26880 6f 63 61 6c 2b 6f 76 66 6c 53 69 7a 65 2d 31 29 ocal+ovflSize-1)
26890 2f 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 /ovflSize;.
268a0 20 69 66 28 20 6e 4f 76 66 6c 3e 70 43 75 72 2d if( nOvfl>pCur-
268b0 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 29 7b 0a 20 >nOvflAlloc ){.
268c0 20 20 20 20 20 20 20 50 67 6e 6f 20 2a 61 4e 65 Pgno *aNe
268d0 77 20 3d 20 28 50 67 6e 6f 2a 29 73 71 6c 69 74 w = (Pgno*)sqlit
268e0 65 33 52 65 61 6c 6c 6f 63 28 0a 20 20 20 20 20 e3Realloc(.
268f0 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 pCur->aOv
26900 65 72 66 6c 6f 77 2c 20 6e 4f 76 66 6c 2a 32 2a erflow, nOvfl*2*
26910 73 69 7a 65 6f 66 28 50 67 6e 6f 29 0a 20 20 20 sizeof(Pgno).
26920 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 );.
26930 69 66 28 20 61 4e 65 77 3d 3d 30 20 29 7b 0a 20 if( aNew==0 ){.
26940 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
26950 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
26960 54 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 T;. }else
26970 7b 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 72 {. pCur
26980 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 3d 20 6e ->nOvflAlloc = n
26990 4f 76 66 6c 2a 32 3b 0a 20 20 20 20 20 20 20 20 Ovfl*2;.
269a0 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f pCur->aOverflo
269b0 77 20 3d 20 61 4e 65 77 3b 0a 20 20 20 20 20 20 w = aNew;.
269c0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
269d0 20 20 6d 65 6d 73 65 74 28 70 43 75 72 2d 3e 61 memset(pCur->a
269e0 4f 76 65 72 66 6c 6f 77 2c 20 30 2c 20 6e 4f 76 Overflow, 0, nOv
269f0 66 6c 2a 73 69 7a 65 6f 66 28 50 67 6e 6f 29 29 fl*sizeof(Pgno))
26a00 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 ;. pCur->cu
26a10 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 rFlags |= BTCF_V
26a20 61 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 20 7d 65 alidOvfl;. }e
26a30 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 lse{. /* If
26a40 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
26a50 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 ge-list cache ha
26a60 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 s been allocated
26a70 20 61 6e 64 20 74 68 65 0a 20 20 20 20 20 20 2a and the. *
26a80 2a 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 * entry for the
26a90 66 69 72 73 74 20 72 65 71 75 69 72 65 64 20 6f first required o
26aa0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 verflow page is
26ab0 76 61 6c 69 64 2c 20 73 6b 69 70 0a 20 20 20 20 valid, skip.
26ac0 20 20 2a 2a 20 64 69 72 65 63 74 6c 79 20 74 6f ** directly to
26ad0 20 69 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 it.. */.
26ae0 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 61 4f if( pCur->aO
26af0 76 65 72 66 6c 6f 77 5b 6f 66 66 73 65 74 2f 6f verflow[offset/o
26b00 76 66 6c 53 69 7a 65 5d 20 29 7b 0a 20 20 20 20 vflSize] ){.
26b10 20 20 20 20 69 49 64 78 20 3d 20 28 6f 66 66 73 iIdx = (offs
26b20 65 74 2f 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 et/ovflSize);.
26b30 20 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d nextPage =
26b40 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 pCur->aOverflow
26b50 5b 69 49 64 78 5d 3b 0a 20 20 20 20 20 20 20 20 [iIdx];.
26b60 6f 66 66 73 65 74 20 3d 20 28 6f 66 66 73 65 74 offset = (offset
26b70 25 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 20 20 %ovflSize);.
26b80 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 }. }.. a
26b90 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
26ba0 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 3b E_OK && amt>0 );
26bb0 0a 20 20 20 20 77 68 69 6c 65 28 20 6e 65 78 74 . while( next
26bc0 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a Page ){. /*
26bd0 20 49 66 20 72 65 71 75 69 72 65 64 2c 20 70 6f If required, po
26be0 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 66 pulate the overf
26bf0 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
26c00 63 68 65 2e 20 2a 2f 0a 20 20 20 20 20 20 61 73 che. */. as
26c10 73 65 72 74 28 20 70 43 75 72 2d 3e 61 4f 76 65 sert( pCur->aOve
26c20 72 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d 30 0a 20 rflow[iIdx]==0.
26c30 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ||
26c40 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
26c50 69 49 64 78 5d 3d 3d 6e 65 78 74 50 61 67 65 0a iIdx]==nextPage.
26c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c ||
26c70 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 CORRUPT_DB );.
26c80 20 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 pCur->aOver
26c90 66 6c 6f 77 5b 69 49 64 78 5d 20 3d 20 6e 65 78 flow[iIdx] = nex
26ca0 74 50 61 67 65 3b 0a 0a 20 20 20 20 20 20 69 66 tPage;.. if
26cb0 28 20 6f 66 66 73 65 74 3e 3d 6f 76 66 6c 53 69 ( offset>=ovflSi
26cc0 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a ze ){. /*
26cd0 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 73 6f 6e The only reason
26ce0 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 61 to read this pa
26cf0 67 65 20 69 73 20 74 6f 20 6f 62 74 61 69 6e 20 ge is to obtain
26d00 74 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 the page.
26d10 20 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 ** number for t
26d20 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
26d30 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 the overflow cha
26d40 69 6e 2e 20 54 68 65 20 70 61 67 65 0a 20 20 20 in. The page.
26d50 20 20 20 20 20 2a 2a 20 64 61 74 61 20 69 73 20 ** data is
26d60 6e 6f 74 20 72 65 71 75 69 72 65 64 2e 20 53 6f not required. So
26d70 20 66 69 72 73 74 20 74 72 79 20 74 6f 20 6c 6f first try to lo
26d80 6f 6b 75 70 20 74 68 65 20 6f 76 65 72 66 6c 6f okup the overflo
26d90 77 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 w. ** pag
26da0 65 2d 6c 69 73 74 20 63 61 63 68 65 2c 20 69 66 e-list cache, if
26db0 20 61 6e 79 2c 20 74 68 65 6e 20 66 61 6c 6c 20 any, then fall
26dc0 62 61 63 6b 20 74 6f 20 74 68 65 20 67 65 74 4f back to the getO
26dd0 76 65 72 66 6c 6f 77 50 61 67 65 28 29 0a 20 20 verflowPage().
26de0 20 20 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f ** functio
26df0 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 n.. */.
26e00 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 assert( pC
26e10 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
26e20 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 20 29 3b TCF_ValidOvfl );
26e30 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
26e40 20 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 pCur->pBtree->d
26e50 62 3d 3d 70 42 74 2d 3e 64 62 20 29 3b 0a 20 20 b==pBt->db );.
26e60 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e if( pCur->
26e70 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 aOverflow[iIdx+1
26e80 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e ] ){. n
26e90 65 78 74 50 61 67 65 20 3d 20 70 43 75 72 2d 3e extPage = pCur->
26ea0 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 aOverflow[iIdx+1
26eb0 5d 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 ];. }else
26ec0 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d {. rc =
26ed0 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
26ee0 28 70 42 74 2c 20 6e 65 78 74 50 61 67 65 2c 20 (pBt, nextPage,
26ef0 30 2c 20 26 6e 65 78 74 50 61 67 65 29 3b 0a 20 0, &nextPage);.
26f00 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
26f10 20 6f 66 66 73 65 74 20 2d 3d 20 6f 76 66 6c 53 offset -= ovflS
26f20 69 7a 65 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 ize;. }else
26f30 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 65 {. /* Nee
26f40 64 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 d to read this p
26f50 61 67 65 20 70 72 6f 70 65 72 6c 79 2e 20 49 74 age properly. It
26f60 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 6f contains some o
26f70 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a f the. **
26f80 20 72 61 6e 67 65 20 6f 66 20 64 61 74 61 20 74 range of data t
26f90 68 61 74 20 69 73 20 62 65 69 6e 67 20 72 65 61 hat is being rea
26fa0 64 20 28 65 4f 70 3d 3d 30 29 20 6f 72 20 77 72 d (eOp==0) or wr
26fb0 69 74 74 65 6e 20 28 65 4f 70 21 3d 30 29 2e 0a itten (eOp!=0)..
26fc0 20 20 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 */.#ifde
26fd0 66 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f f SQLITE_DIRECT_
26fe0 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 OVERFLOW_READ.
26ff0 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 sqlite3_fi
27000 6c 65 20 2a 66 64 3b 20 20 20 20 20 20 2f 2a 20 le *fd; /*
27010 46 69 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 File from which
27020 74 6f 20 64 6f 20 64 69 72 65 63 74 20 6f 76 65 to do direct ove
27030 72 66 6c 6f 77 20 72 65 61 64 20 2a 2f 0a 23 65 rflow read */.#e
27040 6e 64 69 66 0a 20 20 20 20 20 20 20 20 69 6e 74 ndif. int
27050 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 20 20 a = amt;.
27060 20 20 69 66 28 20 61 20 2b 20 6f 66 66 73 65 74 if( a + offset
27070 20 3e 20 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 > ovflSize ){.
27080 20 20 20 20 20 20 20 20 20 61 20 3d 20 6f 76 66 a = ovf
27090 6c 53 69 7a 65 20 2d 20 6f 66 66 73 65 74 3b 0a lSize - offset;.
270a0 20 20 20 20 20 20 20 20 7d 0a 0a 23 69 66 64 65 }..#ifde
270b0 66 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f f SQLITE_DIRECT_
270c0 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 OVERFLOW_READ.
270d0 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6c 6c 20 /* If all
270e0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 the following ar
270f0 65 20 74 72 75 65 3a 0a 20 20 20 20 20 20 20 20 e true:.
27100 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 **. **
27110 31 29 20 74 68 69 73 20 69 73 20 61 20 72 65 61 1) this is a rea
27120 64 20 6f 70 65 72 61 74 69 6f 6e 2c 20 61 6e 64 d operation, and
27130 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 32 . ** 2
27140 29 20 64 61 74 61 20 69 73 20 72 65 71 75 69 72 ) data is requir
27150 65 64 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 ed from the star
27160 74 20 6f 66 20 74 68 69 73 20 6f 76 65 72 66 6c t of this overfl
27170 6f 77 20 70 61 67 65 2c 20 61 6e 64 0a 20 20 20 ow page, and.
27180 20 20 20 20 20 2a 2a 20 20 20 33 29 20 74 68 65 ** 3) the
27190 72 65 20 69 73 20 6e 6f 20 6f 70 65 6e 20 77 72 re is no open wr
271a0 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c ite-transaction,
271b0 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 and. **
271c0 20 20 34 29 20 74 68 65 20 64 61 74 61 62 61 73 4) the databas
271d0 65 20 69 73 20 66 69 6c 65 2d 62 61 63 6b 65 64 e is file-backed
271e0 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a , and. **
271f0 20 20 20 35 29 20 74 68 65 20 70 61 67 65 20 69 5) the page i
27200 73 20 6e 6f 74 20 69 6e 20 74 68 65 20 57 41 4c s not in the WAL
27210 20 66 69 6c 65 0a 20 20 20 20 20 20 20 20 2a 2a file. **
27220 20 20 20 36 29 20 61 74 20 6c 65 61 73 74 20 34 6) at least 4
27230 20 62 79 74 65 73 20 68 61 76 65 20 61 6c 72 65 bytes have alre
27240 61 64 79 20 62 65 65 6e 20 72 65 61 64 20 69 6e ady been read in
27250 74 6f 20 74 68 65 20 6f 75 74 70 75 74 20 62 75 to the output bu
27260 66 66 65 72 20 0a 20 20 20 20 20 20 20 20 2a 2a ffer . **
27270 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 6e . ** then
27280 20 64 61 74 61 20 63 61 6e 20 62 65 20 72 65 61 data can be rea
27290 64 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 d directly from
272a0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
272b0 65 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 e into the.
272c0 20 20 20 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 ** output buf
272d0 66 65 72 2c 20 62 79 70 61 73 73 69 6e 67 20 74 fer, bypassing t
272e0 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 61 6c he page-cache al
272f0 74 6f 67 65 74 68 65 72 2e 20 54 68 69 73 20 73 together. This s
27300 70 65 65 64 73 0a 20 20 20 20 20 20 20 20 2a 2a peeds. **
27310 20 75 70 20 6c 6f 61 64 69 6e 67 20 6c 61 72 67 up loading larg
27320 65 20 72 65 63 6f 72 64 73 20 74 68 61 74 20 73 e records that s
27330 70 61 6e 20 6d 61 6e 79 20 6f 76 65 72 66 6c 6f pan many overflo
27340 77 20 70 61 67 65 73 2e 0a 20 20 20 20 20 20 20 w pages..
27350 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 */. if(
27360 65 4f 70 3d 3d 30 20 20 20 20 20 20 20 20 20 20 eOp==0
27370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27390 20 20 20 2f 2a 20 28 31 29 20 2a 2f 0a 20 20 20 /* (1) */.
273a0 20 20 20 20 20 20 26 26 20 6f 66 66 73 65 74 3d && offset=
273b0 3d 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 =0
273c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
273d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 /* (
273e0 32 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 2) */. &
273f0 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 & pBt->inTransac
27400 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 52 45 41 44 tion==TRANS_READ
27410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27420 20 20 20 20 20 2f 2a 20 28 33 29 20 2a 2f 0a 20 /* (3) */.
27430 20 20 20 20 20 20 20 20 26 26 20 28 66 64 20 3d && (fd =
27440 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 6c sqlite3PagerFil
27450 65 28 70 42 74 2d 3e 70 50 61 67 65 72 29 29 2d e(pBt->pPager))-
27460 3e 70 4d 65 74 68 6f 64 73 20 20 20 20 20 2f 2a >pMethods /*
27470 20 28 34 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 (4) */.
27480 20 26 26 20 30 3d 3d 73 71 6c 69 74 65 33 50 61 && 0==sqlite3Pa
27490 67 65 72 55 73 65 57 61 6c 28 70 42 74 2d 3e 70 gerUseWal(pBt->p
274a0 50 61 67 65 72 2c 20 6e 65 78 74 50 61 67 65 29 Pager, nextPage)
274b0 20 20 20 20 20 20 20 2f 2a 20 28 35 29 20 2a 2f /* (5) */
274c0 0a 20 20 20 20 20 20 20 20 20 26 26 20 26 70 42 . && &pB
274d0 75 66 5b 2d 34 5d 3e 3d 70 42 75 66 53 74 61 72 uf[-4]>=pBufStar
274e0 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t
274f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27500 2f 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 20 /* (6) */.
27510 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 ){. u
27520 38 20 61 53 61 76 65 5b 34 5d 3b 0a 20 20 20 20 8 aSave[4];.
27530 20 20 20 20 20 20 75 38 20 2a 61 57 72 69 74 65 u8 *aWrite
27540 20 3d 20 26 70 42 75 66 5b 2d 34 5d 3b 0a 20 20 = &pBuf[-4];.
27550 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
27560 61 57 72 69 74 65 3e 3d 70 42 75 66 53 74 61 72 aWrite>=pBufStar
27570 74 20 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 t );
27580 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
27590 64 75 65 20 74 6f 20 28 36 29 20 2a 2f 0a 20 20 due to (6) */.
275a0 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 memcpy(a
275b0 53 61 76 65 2c 20 61 57 72 69 74 65 2c 20 34 29 Save, aWrite, 4)
275c0 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d ;. rc =
275d0 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 66 sqlite3OsRead(f
275e0 64 2c 20 61 57 72 69 74 65 2c 20 61 2b 34 2c 20 d, aWrite, a+4,
275f0 28 69 36 34 29 70 42 74 2d 3e 70 61 67 65 53 69 (i64)pBt->pageSi
27600 7a 65 2a 28 6e 65 78 74 50 61 67 65 2d 31 29 29 ze*(nextPage-1))
27610 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 ;. next
27620 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
27630 61 57 72 69 74 65 29 3b 0a 20 20 20 20 20 20 20 aWrite);.
27640 20 20 20 6d 65 6d 63 70 79 28 61 57 72 69 74 65 memcpy(aWrite
27650 2c 20 61 53 61 76 65 2c 20 34 29 3b 0a 20 20 20 , aSave, 4);.
27660 20 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 }else.#endi
27670 66 0a 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 f.. {.
27680 20 20 20 20 20 20 20 44 62 50 61 67 65 20 2a 70 DbPage *p
27690 44 62 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 DbPage;.
276a0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
276b0 67 65 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 gerGet(pBt->pPag
276c0 65 72 2c 20 6e 65 78 74 50 61 67 65 2c 20 26 70 er, nextPage, &p
276d0 44 62 50 61 67 65 2c 0a 20 20 20 20 20 20 20 20 DbPage,.
276e0 20 20 20 20 20 20 28 65 4f 70 3d 3d 30 20 3f 20 (eOp==0 ?
276f0 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e PAGER_GET_READON
27700 4c 59 20 3a 20 30 29 0a 20 20 20 20 20 20 20 20 LY : 0).
27710 20 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 );. i
27720 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
27730 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
27740 61 50 61 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 aPayload = sqlit
27750 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
27760 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
27770 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
27780 67 65 74 34 62 79 74 65 28 61 50 61 79 6c 6f 61 get4byte(aPayloa
27790 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 d);.
277a0 72 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 rc = copyPayload
277b0 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 (&aPayload[offse
277c0 74 2b 34 5d 2c 20 70 42 75 66 2c 20 61 2c 20 65 t+4], pBuf, a, e
277d0 4f 70 2c 20 70 44 62 50 61 67 65 29 3b 0a 20 20 Op, pDbPage);.
277e0 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
277f0 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 50 3PagerUnref(pDbP
27800 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
27810 20 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 offset = 0;.
27820 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
27830 20 20 7d 0a 20 20 20 20 20 20 20 20 61 6d 74 20 }. amt
27840 2d 3d 20 61 3b 0a 20 20 20 20 20 20 20 20 69 66 -= a;. if
27850 28 20 61 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 ( amt==0 ) retur
27860 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 70 42 n rc;. pB
27870 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 20 20 7d uf += a;. }
27880 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 . if( rc )
27890 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 69 49 64 break;. iId
278a0 78 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a x++;. }. }..
278b0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
278c0 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a _OK && amt>0 ){.
278d0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
278e0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 E_CORRUPT_BKPT;
278f0 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 63 68 61 69 /* Overflow chai
27900 6e 20 65 6e 64 73 20 70 72 65 6d 61 74 75 72 65 n ends premature
27910 6c 79 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 ly */. }. retu
27920 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
27930 52 65 61 64 20 70 61 72 74 20 6f 66 20 74 68 65 Read part of the
27940 20 70 61 79 6c 6f 61 64 20 66 6f 72 20 74 68 65 payload for the
27950 20 72 6f 77 20 61 74 20 77 68 69 63 68 20 74 68 row at which th
27960 61 74 20 63 75 72 73 6f 72 20 70 43 75 72 20 69 at cursor pCur i
27970 73 20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 70 s currently.** p
27980 6f 69 6e 74 69 6e 67 2e 20 20 22 61 6d 74 22 20 ointing. "amt"
27990 62 79 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 bytes will be tr
279a0 61 6e 73 66 65 72 72 65 64 20 69 6e 74 6f 20 70 ansferred into p
279b0 42 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e Buf[]. The tran
279c0 73 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 sfer.** begins a
279d0 74 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a t "offset"..**.*
279e0 2a 20 70 43 75 72 20 63 61 6e 20 62 65 20 70 6f * pCur can be po
279f0 69 6e 74 69 6e 67 20 74 6f 20 65 69 74 68 65 72 inting to either
27a00 20 61 20 74 61 62 6c 65 20 6f 72 20 61 6e 20 69 a table or an i
27a10 6e 64 65 78 20 62 2d 74 72 65 65 2e 0a 2a 2a 20 ndex b-tree..**
27a20 49 66 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 If pointing to a
27a30 20 74 61 62 6c 65 20 62 74 72 65 65 2c 20 74 68 table btree, th
27a40 65 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 73 en the content s
27a50 65 63 74 69 6f 6e 20 69 73 20 72 65 61 64 2e 20 ection is read.
27a60 20 49 66 0a 2a 2a 20 70 43 75 72 20 69 73 20 70 If.** pCur is p
27a70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 6e 20 69 6e ointing to an in
27a80 64 65 78 20 62 2d 74 72 65 65 20 74 68 65 6e 20 dex b-tree then
27a90 74 68 65 20 6b 65 79 20 73 65 63 74 69 6f 6e 20 the key section
27aa0 69 73 20 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 46 is read..**.** F
27ab0 6f 72 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 or sqlite3BtreeP
27ac0 61 79 6c 6f 61 64 28 29 2c 20 74 68 65 20 63 61 ayload(), the ca
27ad0 6c 6c 65 72 20 6d 75 73 74 20 65 6e 73 75 72 65 ller must ensure
27ae0 20 74 68 61 74 20 70 43 75 72 20 69 73 20 70 6f that pCur is po
27af0 69 6e 74 69 6e 67 0a 2a 2a 20 74 6f 20 61 20 76 inting.** to a v
27b00 61 6c 69 64 20 72 6f 77 20 69 6e 20 74 68 65 20 alid row in the
27b10 74 61 62 6c 65 2e 20 20 46 6f 72 20 73 71 6c 69 table. For sqli
27b20 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 43 te3BtreePayloadC
27b30 68 65 63 6b 65 64 28 29 2c 20 74 68 65 0a 2a 2a hecked(), the.**
27b40 20 63 75 72 73 6f 72 20 6d 69 67 68 74 20 62 65 cursor might be
27b50 20 69 6e 76 61 6c 69 64 20 6f 72 20 6d 69 67 68 invalid or migh
27b60 74 20 6e 65 65 64 20 74 6f 20 62 65 20 72 65 73 t need to be res
27b70 74 6f 72 65 64 20 62 65 66 6f 72 65 20 62 65 69 tored before bei
27b80 6e 67 20 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 52 ng read..**.** R
27b90 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
27ba0 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 61 6e on success or an
27bb0 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61 error code if a
27bc0 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 nything goes.**
27bd0 77 72 6f 6e 67 2e 20 20 41 6e 20 65 72 72 6f 72 wrong. An error
27be0 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
27bf0 22 6f 66 66 73 65 74 2b 61 6d 74 22 20 69 73 20 "offset+amt" is
27c00 6c 61 72 67 65 72 20 74 68 61 6e 0a 2a 2a 20 74 larger than.** t
27c10 68 65 20 61 76 61 69 6c 61 62 6c 65 20 70 61 79 he available pay
27c20 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c load..*/.int sql
27c30 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 ite3BtreePayload
27c40 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
27c50 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 u32 offset, u32
27c60 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 amt, void *pBuf
27c70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ){. assert( cur
27c80 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
27c90 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
27ca0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
27cb0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
27cc0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
27cd0 50 61 67 65 3e 3d 30 20 26 26 20 70 43 75 72 2d Page>=0 && pCur-
27ce0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
27cf0 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 72 74 age] );. assert
27d00 28 20 70 43 75 72 2d 3e 69 78 3c 70 43 75 72 2d ( pCur->ix<pCur-
27d10 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
27d20 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 age]->nCell );.
27d30 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 return accessPa
27d40 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 yload(pCur, offs
27d50 65 74 2c 20 61 6d 74 2c 20 28 75 6e 73 69 67 6e et, amt, (unsign
27d60 65 64 20 63 68 61 72 2a 29 70 42 75 66 2c 20 30 ed char*)pBuf, 0
27d70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 );.}../*.** This
27d80 20 76 61 72 69 61 6e 74 20 6f 66 20 73 71 6c 69 variant of sqli
27d90 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 te3BtreePayload(
27da0 29 20 77 6f 72 6b 73 20 65 76 65 6e 20 69 66 20 ) works even if
27db0 74 68 65 20 63 75 72 73 6f 72 20 68 61 73 20 6e the cursor has n
27dc0 6f 74 0a 2a 2a 20 69 6e 20 74 68 65 20 43 55 52 ot.** in the CUR
27dd0 53 4f 52 5f 56 41 4c 49 44 20 73 74 61 74 65 2e SOR_VALID state.
27de0 20 20 49 74 20 69 73 20 6f 6e 6c 79 20 75 73 65 It is only use
27df0 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 d by the sqlite3
27e00 5f 62 6c 6f 62 5f 72 65 61 64 28 29 0a 2a 2a 20 _blob_read().**
27e10 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2f 0a 23 69 interface..*/.#i
27e20 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
27e30 54 5f 49 4e 43 52 42 4c 4f 42 0a 73 74 61 74 69 T_INCRBLOB.stati
27e40 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
27e50 45 20 69 6e 74 20 61 63 63 65 73 73 50 61 79 6c E int accessPayl
27e60 6f 61 64 43 68 65 63 6b 65 64 28 0a 20 20 42 74 oadChecked(. Bt
27e70 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 0a 20 20 Cursor *pCur,.
27e80 75 33 32 20 6f 66 66 73 65 74 2c 0a 20 20 75 33 u32 offset,. u3
27e90 32 20 61 6d 74 2c 0a 20 20 76 6f 69 64 20 2a 70 2 amt,. void *p
27ea0 42 75 66 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b Buf.){. int rc;
27eb0 0a 20 20 69 66 20 28 20 70 43 75 72 2d 3e 65 53 . if ( pCur->eS
27ec0 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 tate==CURSOR_INV
27ed0 41 4c 49 44 20 29 7b 0a 20 20 20 20 72 65 74 75 ALID ){. retu
27ee0 72 6e 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 3b rn SQLITE_ABORT;
27ef0 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 63 . }. assert( c
27f00 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
27f10 64 28 70 43 75 72 29 20 29 3b 0a 20 20 72 63 20 d(pCur) );. rc
27f20 3d 20 62 74 72 65 65 52 65 73 74 6f 72 65 43 75 = btreeRestoreCu
27f30 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 rsorPosition(pCu
27f40 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 20 r);. return rc
27f50 3f 20 72 63 20 3a 20 61 63 63 65 73 73 50 61 79 ? rc : accessPay
27f60 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 65 load(pCur, offse
27f70 74 2c 20 61 6d 74 2c 20 70 42 75 66 2c 20 30 29 t, amt, pBuf, 0)
27f80 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 ;.}.int sqlite3B
27f90 74 72 65 65 50 61 79 6c 6f 61 64 43 68 65 63 6b treePayloadCheck
27fa0 65 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ed(BtCursor *pCu
27fb0 72 2c 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 r, u32 offset, u
27fc0 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 32 amt, void *pB
27fd0 75 66 29 7b 0a 20 20 69 66 28 20 70 43 75 72 2d uf){. if( pCur-
27fe0 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
27ff0 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 61 73 73 VALID ){. ass
28000 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 ert( cursorOwnsB
28010 74 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b tShared(pCur) );
28020 0a 20 20 20 20 72 65 74 75 72 6e 20 61 63 63 65 . return acce
28030 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 ssPayload(pCur,
28040 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 70 42 75 offset, amt, pBu
28050 66 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a f, 0);. }else{.
28060 20 20 20 20 72 65 74 75 72 6e 20 61 63 63 65 73 return acces
28070 73 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 sPayloadChecked(
28080 70 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d pCur, offset, am
28090 74 2c 20 70 42 75 66 29 3b 0a 20 20 7d 0a 7d 0a t, pBuf);. }.}.
280a0 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
280b0 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a _OMIT_INCRBLOB *
280c0 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 /../*.** Return
280d0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 70 61 79 a pointer to pay
280e0 6c 6f 61 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e load information
280f0 20 66 72 6f 6d 20 74 68 65 20 65 6e 74 72 79 20 from the entry
28100 74 68 61 74 20 74 68 65 20 0a 2a 2a 20 70 43 75 that the .** pCu
28110 72 20 63 75 72 73 6f 72 20 69 73 20 70 6f 69 6e r cursor is poin
28120 74 69 6e 67 20 74 6f 2e 20 20 54 68 65 20 70 6f ting to. The po
28130 69 6e 74 65 72 20 69 73 20 74 6f 20 74 68 65 20 inter is to the
28140 62 65 67 69 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 beginning of.**
28150 74 68 65 20 6b 65 79 20 69 66 20 69 6e 64 65 78 the key if index
28160 20 62 74 72 65 65 73 20 28 70 50 61 67 65 2d 3e btrees (pPage->
28170 69 6e 74 4b 65 79 3d 3d 30 29 20 61 6e 64 20 69 intKey==0) and i
28180 73 20 74 68 65 20 64 61 74 61 20 66 6f 72 0a 2a s the data for.*
28190 2a 20 74 61 62 6c 65 20 62 74 72 65 65 73 20 28 * table btrees (
281a0 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 31 pPage->intKey==1
281b0 29 2e 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 ). The number of
281c0 20 62 79 74 65 73 20 6f 66 20 61 76 61 69 6c 61 bytes of availa
281d0 62 6c 65 0a 2a 2a 20 6b 65 79 2f 64 61 74 61 20 ble.** key/data
281e0 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
281f0 2a 70 41 6d 74 2e 20 20 49 66 20 2a 70 41 6d 74 *pAmt. If *pAmt
28200 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 20 76 61 ==0, then the va
28210 6c 75 65 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 lue.** returned
28220 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 20 76 61 will not be a va
28230 6c 69 64 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a lid pointer..**.
28240 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
28250 69 73 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 is an optimizati
28260 6f 6e 2e 20 20 49 74 20 69 73 20 63 6f 6d 6d 6f on. It is commo
28270 6e 20 66 6f 72 20 74 68 65 20 65 6e 74 69 72 65 n for the entire
28280 20 6b 65 79 0a 2a 2a 20 61 6e 64 20 64 61 74 61 key.** and data
28290 20 74 6f 20 66 69 74 20 6f 6e 20 74 68 65 20 6c to fit on the l
282a0 6f 63 61 6c 20 70 61 67 65 20 61 6e 64 20 66 6f ocal page and fo
282b0 72 20 74 68 65 72 65 20 74 6f 20 62 65 20 6e 6f r there to be no
282c0 20 6f 76 65 72 66 6c 6f 77 0a 2a 2a 20 70 61 67 overflow.** pag
282d0 65 73 2e 20 20 57 68 65 6e 20 74 68 61 74 20 69 es. When that i
282e0 73 20 73 6f 2c 20 74 68 69 73 20 72 6f 75 74 69 s so, this routi
282f0 6e 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 ne can be used t
28300 6f 20 61 63 63 65 73 73 20 74 68 65 0a 2a 2a 20 o access the.**
28310 6b 65 79 20 61 6e 64 20 64 61 74 61 20 77 69 74 key and data wit
28320 68 6f 75 74 20 6d 61 6b 69 6e 67 20 61 20 63 6f hout making a co
28330 70 79 2e 20 20 49 66 20 74 68 65 20 6b 65 79 20 py. If the key
28340 61 6e 64 2f 6f 72 20 64 61 74 61 20 73 70 69 6c and/or data spil
28350 6c 73 0a 2a 2a 20 6f 6e 74 6f 20 6f 76 65 72 66 ls.** onto overf
28360 6c 6f 77 20 70 61 67 65 73 2c 20 74 68 65 6e 20 low pages, then
28370 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 accessPayload()
28380 6d 75 73 74 20 62 65 20 75 73 65 64 20 74 6f 20 must be used to
28390 72 65 61 73 73 65 6d 62 6c 65 0a 2a 2a 20 74 68 reassemble.** th
283a0 65 20 6b 65 79 2f 64 61 74 61 20 61 6e 64 20 63 e key/data and c
283b0 6f 70 79 20 69 74 20 69 6e 74 6f 20 61 20 70 72 opy it into a pr
283c0 65 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 eallocated buffe
283d0 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 r..**.** The poi
283e0 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 62 79 nter returned by
283f0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6c 6f this routine lo
28400 6f 6b 73 20 64 69 72 65 63 74 6c 79 20 69 6e 74 oks directly int
28410 6f 20 74 68 65 20 63 61 63 68 65 64 0a 2a 2a 20 o the cached.**
28420 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 page of the data
28430 62 61 73 65 2e 20 20 54 68 65 20 64 61 74 61 20 base. The data
28440 6d 69 67 68 74 20 63 68 61 6e 67 65 20 6f 72 20 might change or
28450 6d 6f 76 65 20 74 68 65 20 6e 65 78 74 20 74 69 move the next ti
28460 6d 65 0a 2a 2a 20 61 6e 79 20 62 74 72 65 65 20 me.** any btree
28470 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
28480 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e d..*/.static con
28490 73 74 20 76 6f 69 64 20 2a 66 65 74 63 68 50 61 st void *fetchPa
284a0 79 6c 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f yload(. BtCurso
284b0 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a r *pCur, /*
284c0 20 43 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 Cursor pointing
284d0 20 74 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 to entry to rea
284e0 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 d from */. u32
284f0 2a 70 41 6d 74 20 20 20 20 20 20 20 20 20 20 20 *pAmt
28500 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 /* Write the nu
28510 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c mber of availabl
28520 65 20 62 79 74 65 73 20 68 65 72 65 20 2a 2f 0a e bytes here */.
28530 29 7b 0a 20 20 75 33 32 20 61 6d 74 3b 0a 20 20 ){. u32 amt;.
28540 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 assert( pCur!=0
28550 26 26 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d && pCur->iPage>=
28560 30 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 0 && pCur->apPag
28570 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b e[pCur->iPage]);
28580 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
28590 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
285a0 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
285b0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
285c0 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 _held(pCur->pBtr
285d0 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ee->db->mutex) )
285e0 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
285f0 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
28600 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
28610 28 20 70 43 75 72 2d 3e 69 78 3c 70 43 75 72 2d ( pCur->ix<pCur-
28620 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
28630 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 age]->nCell );.
28640 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
28650 6e 66 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 nfo.nSize>0 );.
28660 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
28670 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3e 70 43 75 nfo.pPayload>pCu
28680 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
28690 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 20 7c 7c iPage]->aData ||
286a0 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 CORRUPT_DB );.
286b0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
286c0 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3c 70 43 75 nfo.pPayload<pCu
286d0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
286e0 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 45 6e 64 iPage]->aDataEnd
286f0 20 7c 7c 43 4f 52 52 55 50 54 5f 44 42 29 3b 0a ||CORRUPT_DB);.
28700 20 20 61 6d 74 20 3d 20 28 69 6e 74 29 28 70 43 amt = (int)(pC
28710 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
28720 3e 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 45 6e >iPage]->aDataEn
28730 64 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 d - pCur->info.p
28740 50 61 79 6c 6f 61 64 29 3b 0a 20 20 69 66 28 20 Payload);. if(
28750 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
28760 6c 3c 61 6d 74 20 29 20 61 6d 74 20 3d 20 70 43 l<amt ) amt = pC
28770 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b ur->info.nLocal;
28780 0a 20 20 2a 70 41 6d 74 20 3d 20 61 6d 74 3b 0a . *pAmt = amt;.
28790 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 return (void*)
287a0 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c pCur->info.pPayl
287b0 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 46 oad;.}.../*.** F
287c0 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 or the entry tha
287d0 74 20 63 75 72 73 6f 72 20 70 43 75 72 20 69 73 t cursor pCur is
287e0 20 70 6f 69 6e 74 20 74 6f 2c 20 72 65 74 75 72 point to, retur
287f0 6e 20 61 73 0a 2a 2a 20 6d 61 6e 79 20 62 79 74 n as.** many byt
28800 65 73 20 6f 66 20 74 68 65 20 6b 65 79 20 6f 72 es of the key or
28810 20 64 61 74 61 20 61 73 20 61 72 65 20 61 76 61 data as are ava
28820 69 6c 61 62 6c 65 20 6f 6e 20 74 68 65 20 6c 6f ilable on the lo
28830 63 61 6c 0a 2a 2a 20 62 2d 74 72 65 65 20 70 61 cal.** b-tree pa
28840 67 65 2e 20 20 57 72 69 74 65 20 74 68 65 20 6e ge. Write the n
28850 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 62 umber of availab
28860 6c 65 20 62 79 74 65 73 20 69 6e 74 6f 20 2a 70 le bytes into *p
28870 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 Amt..**.** The p
28880 6f 69 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 ointer returned
28890 69 73 20 65 70 68 65 6d 65 72 61 6c 2e 20 20 54 is ephemeral. T
288a0 68 65 20 6b 65 79 2f 64 61 74 61 20 6d 61 79 20 he key/data may
288b0 6d 6f 76 65 0a 2a 2a 20 6f 72 20 62 65 20 64 65 move.** or be de
288c0 73 74 72 6f 79 65 64 20 6f 6e 20 74 68 65 20 6e stroyed on the n
288d0 65 78 74 20 63 61 6c 6c 20 74 6f 20 61 6e 79 20 ext call to any
288e0 42 74 72 65 65 20 72 6f 75 74 69 6e 65 2c 0a 2a Btree routine,.*
288f0 2a 20 69 6e 63 6c 75 64 69 6e 67 20 63 61 6c 6c * including call
28900 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 74 68 72 s from other thr
28910 65 61 64 73 20 61 67 61 69 6e 73 74 20 74 68 65 eads against the
28920 20 73 61 6d 65 20 63 61 63 68 65 2e 0a 2a 2a 20 same cache..**
28930 48 65 6e 63 65 2c 20 61 20 6d 75 74 65 78 20 6f Hence, a mutex o
28940 6e 20 74 68 65 20 42 74 53 68 61 72 65 64 20 73 n the BtShared s
28950 68 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 70 72 hould be held pr
28960 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 0a 2a ior to calling.*
28970 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a * this routine..
28980 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f 75 74 **.** These rout
28990 69 6e 65 73 20 69 73 20 75 73 65 64 20 74 6f 20 ines is used to
289a0 67 65 74 20 71 75 69 63 6b 20 61 63 63 65 73 73 get quick access
289b0 20 74 6f 20 6b 65 79 20 61 6e 64 20 64 61 74 61 to key and data
289c0 0a 2a 2a 20 69 6e 20 74 68 65 20 63 6f 6d 6d 6f .** in the commo
289d0 6e 20 63 61 73 65 20 77 68 65 72 65 20 6e 6f 20 n case where no
289e0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
289f0 72 65 20 75 73 65 64 2e 0a 2a 2f 0a 63 6f 6e 73 re used..*/.cons
28a00 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 42 t void *sqlite3B
28a10 74 72 65 65 50 61 79 6c 6f 61 64 46 65 74 63 68 treePayloadFetch
28a20 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
28a30 20 75 33 32 20 2a 70 41 6d 74 29 7b 0a 20 20 72 u32 *pAmt){. r
28a40 65 74 75 72 6e 20 66 65 74 63 68 50 61 79 6c 6f eturn fetchPaylo
28a50 61 64 28 70 43 75 72 2c 20 70 41 6d 74 29 3b 0a ad(pCur, pAmt);.
28a60 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 }.../*.** Move t
28a70 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 he cursor down t
28a80 6f 20 61 20 6e 65 77 20 63 68 69 6c 64 20 70 61 o a new child pa
28a90 67 65 2e 20 20 54 68 65 20 6e 65 77 50 67 6e 6f ge. The newPgno
28aa0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 argument is the
28ab0 0a 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 72 20 .** page number
28ac0 6f 66 20 74 68 65 20 63 68 69 6c 64 20 70 61 67 of the child pag
28ad0 65 20 74 6f 20 6d 6f 76 65 20 74 6f 2e 0a 2a 2a e to move to..**
28ae0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
28af0 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 n returns SQLITE
28b00 5f 43 4f 52 52 55 50 54 20 69 66 20 74 68 65 20 _CORRUPT if the
28b10 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c 61 67 page-header flag
28b20 73 20 66 69 65 6c 64 20 6f 66 0a 2a 2a 20 74 68 s field of.** th
28b30 65 20 6e 65 77 20 63 68 69 6c 64 20 70 61 67 65 e new child page
28b40 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 does not match
28b50 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 the flags field
28b60 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 28 69 of the parent (i
28b70 2e 65 2e 0a 2a 2a 20 69 66 20 61 6e 20 69 6e 74 .e..** if an int
28b80 6b 65 79 20 70 61 67 65 20 61 70 70 65 61 72 73 key page appears
28b90 20 74 6f 20 62 65 20 74 68 65 20 70 61 72 65 6e to be the paren
28ba0 74 20 6f 66 20 61 20 6e 6f 6e 2d 69 6e 74 6b 65 t of a non-intke
28bb0 79 20 70 61 67 65 2c 20 6f 72 0a 2a 2a 20 76 69 y page, or.** vi
28bc0 63 65 2d 76 65 72 73 61 29 2e 0a 2a 2f 0a 73 74 ce-versa)..*/.st
28bd0 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 43 atic int moveToC
28be0 68 69 6c 64 28 42 74 43 75 72 73 6f 72 20 2a 70 hild(BtCursor *p
28bf0 43 75 72 2c 20 75 33 32 20 6e 65 77 50 67 6e 6f Cur, u32 newPgno
28c00 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
28c10 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a Bt = pCur->pBt;.
28c20 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
28c30 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
28c40 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
28c50 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
28c60 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
28c70 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
28c80 50 61 67 65 3c 42 54 43 55 52 53 4f 52 5f 4d 41 Page<BTCURSOR_MA
28c90 58 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 X_DEPTH );. ass
28ca0 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 ert( pCur->iPage
28cb0 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 43 75 >=0 );. if( pCu
28cc0 72 2d 3e 69 50 61 67 65 3e 3d 28 42 54 43 55 52 r->iPage>=(BTCUR
28cd0 53 4f 52 5f 4d 41 58 5f 44 45 50 54 48 2d 31 29 SOR_MAX_DEPTH-1)
28ce0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
28cf0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
28d00 50 54 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e PT;. }. pCur->
28d10 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
28d20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
28d30 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 &= ~(BTCF_Valid
28d40 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f NKey|BTCF_ValidO
28d50 76 66 6c 29 3b 0a 20 20 70 43 75 72 2d 3e 61 69 vfl);. pCur->ai
28d60 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 2b Idx[pCur->iPage+
28d70 2b 5d 20 3d 20 70 43 75 72 2d 3e 69 78 3b 0a 20 +] = pCur->ix;.
28d80 20 70 43 75 72 2d 3e 69 78 20 3d 20 30 3b 0a 20 pCur->ix = 0;.
28d90 20 72 65 74 75 72 6e 20 67 65 74 41 6e 64 49 6e return getAndIn
28da0 69 74 50 61 67 65 28 70 42 74 2c 20 6e 65 77 50 itPage(pBt, newP
28db0 67 6e 6f 2c 20 26 70 43 75 72 2d 3e 61 70 50 61 gno, &pCur->apPa
28dc0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2c ge[pCur->iPage],
28dd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
28de0 20 20 20 20 20 20 20 20 20 70 43 75 72 2c 20 70 pCur, p
28df0 43 75 72 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 Cur->curPagerFla
28e00 67 73 29 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 gs);.}..#ifdef S
28e10 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a QLITE_DEBUG./*.*
28e20 2a 20 50 61 67 65 20 70 50 61 72 65 6e 74 20 69 * Page pParent i
28e30 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 28 6e s an internal (n
28e40 6f 6e 2d 6c 65 61 66 29 20 74 72 65 65 20 70 61 on-leaf) tree pa
28e50 67 65 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f ge. This functio
28e60 6e 20 0a 2a 2a 20 61 73 73 65 72 74 73 20 74 68 n .** asserts th
28e70 61 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 at page number i
28e80 43 68 69 6c 64 20 69 73 20 74 68 65 20 6c 65 66 Child is the lef
28e90 74 2d 63 68 69 6c 64 20 69 66 20 74 68 65 20 69 t-child if the i
28ea0 49 64 78 27 74 68 0a 2a 2a 20 63 65 6c 6c 20 69 Idx'th.** cell i
28eb0 6e 20 70 61 67 65 20 70 50 61 72 65 6e 74 2e 20 n page pParent.
28ec0 4f 72 2c 20 69 66 20 69 49 64 78 20 69 73 20 65 Or, if iIdx is e
28ed0 71 75 61 6c 20 74 6f 20 74 68 65 20 74 6f 74 61 qual to the tota
28ee0 6c 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 l number of.** c
28ef0 65 6c 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 2c ells in pParent,
28f00 20 74 68 61 74 20 70 61 67 65 20 6e 75 6d 62 65 that page numbe
28f10 72 20 69 43 68 69 6c 64 20 69 73 20 74 68 65 20 r iChild is the
28f20 72 69 67 68 74 2d 63 68 69 6c 64 20 6f 66 0a 2a right-child of.*
28f30 2a 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 * the page..*/.s
28f40 74 61 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 tatic void asser
28f50 74 50 61 72 65 6e 74 49 6e 64 65 78 28 4d 65 6d tParentIndex(Mem
28f60 50 61 67 65 20 2a 70 50 61 72 65 6e 74 2c 20 69 Page *pParent, i
28f70 6e 74 20 69 49 64 78 2c 20 50 67 6e 6f 20 69 43 nt iIdx, Pgno iC
28f80 68 69 6c 64 29 7b 0a 20 20 69 66 28 20 43 4f 52 hild){. if( COR
28f90 52 55 50 54 5f 44 42 20 29 20 72 65 74 75 72 6e RUPT_DB ) return
28fa0 3b 20 20 2f 2a 20 54 68 65 20 63 6f 6e 64 69 74 ; /* The condit
28fb0 69 6f 6e 73 20 74 65 73 74 65 64 20 62 65 6c 6f ions tested belo
28fc0 77 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 74 w might not be t
28fd0 72 75 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 rue.
28fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28ff0 2a 2a 20 69 6e 20 61 20 63 6f 72 72 75 70 74 20 ** in a corrupt
29000 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 61 73 database */. as
29010 73 65 72 74 28 20 69 49 64 78 3c 3d 70 50 61 72 sert( iIdx<=pPar
29020 65 6e 74 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 ent->nCell );.
29030 69 66 28 20 69 49 64 78 3d 3d 70 50 61 72 65 6e if( iIdx==pParen
29040 74 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 t->nCell ){.
29050 61 73 73 65 72 74 28 20 67 65 74 34 62 79 74 65 assert( get4byte
29060 28 26 70 50 61 72 65 6e 74 2d 3e 61 44 61 74 61 (&pParent->aData
29070 5b 70 50 61 72 65 6e 74 2d 3e 68 64 72 4f 66 66 [pParent->hdrOff
29080 73 65 74 2b 38 5d 29 3d 3d 69 43 68 69 6c 64 20 set+8])==iChild
29090 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
290a0 61 73 73 65 72 74 28 20 67 65 74 34 62 79 74 65 assert( get4byte
290b0 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 72 65 6e (findCell(pParen
290c0 74 2c 20 69 49 64 78 29 29 3d 3d 69 43 68 69 6c t, iIdx))==iChil
290d0 64 20 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 d );. }.}.#else
290e0 0a 23 20 20 64 65 66 69 6e 65 20 61 73 73 65 72 .# define asser
290f0 74 50 61 72 65 6e 74 49 6e 64 65 78 28 78 2c 79 tParentIndex(x,y
29100 2c 7a 29 20 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ,z) .#endif../*.
29110 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
29120 6f 72 20 75 70 20 74 6f 20 74 68 65 20 70 61 72 or up to the par
29130 65 6e 74 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 ent page..**.**
29140 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 65 74 pCur->idx is set
29150 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 69 6e 64 to the cell ind
29160 65 78 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 ex that contains
29170 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 the pointer.**
29180 74 6f 20 74 68 65 20 70 61 67 65 20 77 65 20 61 to the page we a
29190 72 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 2e 20 re coming from.
291a0 20 49 66 20 77 65 20 61 72 65 20 63 6f 6d 69 6e If we are comin
291b0 67 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 72 69 g from the.** ri
291c0 67 68 74 2d 6d 6f 73 74 20 63 68 69 6c 64 20 70 ght-most child p
291d0 61 67 65 20 74 68 65 6e 20 70 43 75 72 2d 3e 69 age then pCur->i
291e0 64 78 20 69 73 20 73 65 74 20 74 6f 20 6f 6e 65 dx is set to one
291f0 20 6d 6f 72 65 20 74 68 61 6e 0a 2a 2a 20 74 68 more than.** th
29200 65 20 6c 61 72 67 65 73 74 20 63 65 6c 6c 20 69 e largest cell i
29210 6e 64 65 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ndex..*/.static
29220 76 6f 69 64 20 6d 6f 76 65 54 6f 50 61 72 65 6e void moveToParen
29230 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 t(BtCursor *pCur
29240 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ){. assert( cur
29250 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
29260 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
29270 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
29280 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
29290 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
292a0 3e 69 50 61 67 65 3e 30 20 29 3b 0a 20 20 61 73 >iPage>0 );. as
292b0 73 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 sert( pCur->apPa
292c0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 ge[pCur->iPage]
292d0 29 3b 0a 20 20 61 73 73 65 72 74 50 61 72 65 6e );. assertParen
292e0 74 49 6e 64 65 78 28 0a 20 20 20 20 70 43 75 72 tIndex(. pCur
292f0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
29300 50 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 Page-1], . pC
29310 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
29320 69 50 61 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 iPage-1], . p
29330 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
29340 2d 3e 69 50 61 67 65 5d 2d 3e 70 67 6e 6f 0a 20 ->iPage]->pgno.
29350 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 );. testcase(
29360 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
29370 2d 3e 69 50 61 67 65 2d 31 5d 20 3e 20 70 43 75 ->iPage-1] > pCu
29380 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
29390 69 50 61 67 65 2d 31 5d 2d 3e 6e 43 65 6c 6c 20 iPage-1]->nCell
293a0 29 3b 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e );. pCur->info.
293b0 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 nSize = 0;. pCu
293c0 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e r->curFlags &= ~
293d0 28 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c (BTCF_ValidNKey|
293e0 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b BTCF_ValidOvfl);
293f0 0a 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 70 43 . pCur->ix = pC
29400 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
29410 69 50 61 67 65 2d 31 5d 3b 0a 20 20 72 65 6c 65 iPage-1];. rele
29420 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 asePageNotNull(p
29430 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
29440 2d 3e 69 50 61 67 65 2d 2d 5d 29 3b 0a 7d 0a 0a ->iPage--]);.}..
29450 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 /*.** Move the c
29460 75 72 73 6f 72 20 74 6f 20 70 6f 69 6e 74 20 74 ursor to point t
29470 6f 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 o the root page
29480 6f 66 20 69 74 73 20 62 2d 74 72 65 65 20 73 74 of its b-tree st
29490 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 ructure..**.** I
294a0 66 20 74 68 65 20 74 61 62 6c 65 20 68 61 73 20 f the table has
294b0 61 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 a virtual root p
294c0 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 63 75 age, then the cu
294d0 72 73 6f 72 20 69 73 20 6d 6f 76 65 64 20 74 6f rsor is moved to
294e0 20 70 6f 69 6e 74 0a 2a 2a 20 74 6f 20 74 68 65 point.** to the
294f0 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 virtual root pa
29500 67 65 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 ge instead of th
29510 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 20 70 61 e actual root pa
29520 67 65 2e 20 41 20 74 61 62 6c 65 20 68 61 73 20 ge. A table has
29530 61 0a 2a 2a 20 76 69 72 74 75 61 6c 20 72 6f 6f a.** virtual roo
29540 74 20 70 61 67 65 20 77 68 65 6e 20 74 68 65 20 t page when the
29550 61 63 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 actual root page
29560 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 63 65 6c contains no cel
29570 6c 73 20 61 6e 64 20 61 20 0a 2a 2a 20 73 69 6e ls and a .** sin
29580 67 6c 65 20 63 68 69 6c 64 20 70 61 67 65 2e 20 gle child page.
29590 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 20 68 61 This can only ha
295a0 70 70 65 6e 20 77 69 74 68 20 74 68 65 20 74 61 ppen with the ta
295b0 62 6c 65 20 72 6f 6f 74 65 64 20 61 74 20 70 61 ble rooted at pa
295c0 67 65 20 31 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ge 1..**.** If t
295d0 68 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 he b-tree struct
295e0 75 72 65 20 69 73 20 65 6d 70 74 79 2c 20 74 68 ure is empty, th
295f0 65 20 63 75 72 73 6f 72 20 73 74 61 74 65 20 69 e cursor state i
29600 73 20 73 65 74 20 74 6f 20 0a 2a 2a 20 43 55 52 s set to .** CUR
29610 53 4f 52 5f 49 4e 56 41 4c 49 44 2e 20 4f 74 68 SOR_INVALID. Oth
29620 65 72 77 69 73 65 2c 20 74 68 65 20 63 75 72 73 erwise, the curs
29630 6f 72 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 or is set to poi
29640 6e 74 20 74 6f 20 74 68 65 20 66 69 72 73 74 0a nt to the first.
29650 2a 2a 20 63 65 6c 6c 20 6c 6f 63 61 74 65 64 20 ** cell located
29660 6f 6e 20 74 68 65 20 72 6f 6f 74 20 28 6f 72 20 on the root (or
29670 76 69 72 74 75 61 6c 20 72 6f 6f 74 29 20 70 61 virtual root) pa
29680 67 65 20 61 6e 64 20 74 68 65 20 63 75 72 73 6f ge and the curso
29690 72 20 73 74 61 74 65 0a 2a 2a 20 69 73 20 73 65 r state.** is se
296a0 74 20 74 6f 20 43 55 52 53 4f 52 5f 56 41 4c 49 t to CURSOR_VALI
296b0 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 D..**.** If this
296c0 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
296d0 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 s successfully,
296e0 69 74 20 6d 61 79 20 62 65 20 61 73 73 75 6d 65 it may be assume
296f0 64 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 70 61 d that the.** pa
29700 67 65 2d 68 65 61 64 65 72 20 66 6c 61 67 73 20 ge-header flags
29710 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 68 indicate that th
29720 65 20 5b 76 69 72 74 75 61 6c 5d 20 72 6f 6f 74 e [virtual] root
29730 2d 70 61 67 65 20 69 73 20 74 68 65 20 65 78 70 -page is the exp
29740 65 63 74 65 64 20 0a 2a 2a 20 6b 69 6e 64 20 6f ected .** kind o
29750 66 20 62 2d 74 72 65 65 20 70 61 67 65 20 28 69 f b-tree page (i
29760 2e 65 2e 20 69 66 20 77 68 65 6e 20 6f 70 65 6e .e. if when open
29770 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 20 74 ing the cursor t
29780 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 6e 6f he caller did no
29790 74 0a 2a 2a 20 73 70 65 63 69 66 79 20 61 20 4b t.** specify a K
297a0 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 eyInfo structure
297b0 20 74 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 the flags byte
297c0 69 73 20 73 65 74 20 74 6f 20 30 78 30 35 20 6f is set to 0x05 o
297d0 72 20 30 78 30 44 2c 0a 2a 2a 20 69 6e 64 69 63 r 0x0D,.** indic
297e0 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 62 2d ating a table b-
297f0 74 72 65 65 2c 20 6f 72 20 69 66 20 74 68 65 20 tree, or if the
29800 63 61 6c 6c 65 72 20 64 69 64 20 73 70 65 63 69 caller did speci
29810 66 79 20 61 20 4b 65 79 49 6e 66 6f 20 0a 2a 2a fy a KeyInfo .**
29820 20 73 74 72 75 63 74 75 72 65 20 74 68 65 20 66 structure the f
29830 6c 61 67 73 20 62 79 74 65 20 69 73 20 73 65 74 lags byte is set
29840 20 74 6f 20 30 78 30 32 20 6f 72 20 30 78 30 41 to 0x02 or 0x0A
29850 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 61 6e 20 , indicating an
29860 69 6e 64 65 78 0a 2a 2a 20 62 2d 74 72 65 65 29 index.** b-tree)
29870 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
29880 6d 6f 76 65 54 6f 52 6f 6f 74 28 42 74 43 75 72 moveToRoot(BtCur
29890 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 4d 65 sor *pCur){. Me
298a0 6d 50 61 67 65 20 2a 70 52 6f 6f 74 3b 0a 20 20 mPage *pRoot;.
298b0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
298c0 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 OK;.. assert( c
298d0 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
298e0 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 d(pCur) );. ass
298f0 65 72 74 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 ert( CURSOR_INVA
29900 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f 52 45 51 LID < CURSOR_REQ
29910 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 73 UIRESEEK );. as
29920 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 41 4c sert( CURSOR_VAL
29930 49 44 20 20 20 3c 20 43 55 52 53 4f 52 5f 52 45 ID < CURSOR_RE
29940 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 QUIRESEEK );. a
29950 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 46 41 ssert( CURSOR_FA
29960 55 4c 54 20 20 20 3e 20 43 55 52 53 4f 52 5f 52 ULT > CURSOR_R
29970 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
29980 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
29990 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 >=CURSOR_REQUIRE
299a0 53 45 45 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 SEEK ){. if(
299b0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
299c0 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a 20 20 RSOR_FAULT ){.
299d0 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
299e0 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 51 4c 49 ->skipNext!=SQLI
299f0 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 72 TE_OK );. r
29a00 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 eturn pCur->skip
29a10 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Next;. }.
29a20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 sqlite3BtreeClea
29a30 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a 20 rCursor(pCur);.
29a40 20 7d 0a 0a 20 20 69 66 28 20 70 43 75 72 2d 3e }.. if( pCur->
29a50 69 50 61 67 65 3e 3d 30 20 29 7b 0a 20 20 20 20 iPage>=0 ){.
29a60 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 20 if( pCur->iPage
29a70 29 7b 0a 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 ){. do{.
29a80 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
29a90 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
29aa0 69 50 61 67 65 5d 21 3d 30 20 29 3b 0a 20 20 20 iPage]!=0 );.
29ab0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
29ac0 4e 6f 74 4e 75 6c 6c 28 70 43 75 72 2d 3e 61 70 NotNull(pCur->ap
29ad0 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
29ae0 2d 2d 5d 29 3b 0a 20 20 20 20 20 20 7d 77 68 69 --]);. }whi
29af0 6c 65 28 20 70 43 75 72 2d 3e 69 50 61 67 65 29 le( pCur->iPage)
29b00 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 73 6b 69 ;. goto ski
29b10 70 5f 69 6e 69 74 3b 0a 20 20 20 20 7d 0a 20 20 p_init;. }.
29b20 7d 65 6c 73 65 20 69 66 28 20 70 43 75 72 2d 3e }else if( pCur->
29b30 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 29 7b 0a 20 pgnoRoot==0 ){.
29b40 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
29b50 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
29b60 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
29b70 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b ITE_OK;. }else{
29b80 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
29b90 72 2d 3e 69 50 61 67 65 3d 3d 28 2d 31 29 20 29 r->iPage==(-1) )
29ba0 3b 0a 20 20 20 20 72 63 20 3d 20 67 65 74 41 6e ;. rc = getAn
29bb0 64 49 6e 69 74 50 61 67 65 28 70 43 75 72 2d 3e dInitPage(pCur->
29bc0 70 42 74 72 65 65 2d 3e 70 42 74 2c 20 70 43 75 pBtree->pBt, pCu
29bd0 72 2d 3e 70 67 6e 6f 52 6f 6f 74 2c 20 26 70 43 r->pgnoRoot, &pC
29be0 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2c 0a 20 ur->apPage[0],.
29bf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29c00 20 20 20 20 20 20 20 30 2c 20 70 43 75 72 2d 3e 0, pCur->
29c10 63 75 72 50 61 67 65 72 46 6c 61 67 73 29 3b 0a curPagerFlags);.
29c20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
29c30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 TE_OK ){. p
29c40 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
29c50 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
29c60 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
29c70 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e }. pCur->
29c80 69 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 70 iPage = 0;. p
29c90 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 20 3d Cur->curIntKey =
29ca0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d pCur->apPage[0]
29cb0 2d 3e 69 6e 74 4b 65 79 3b 0a 20 20 7d 0a 20 20 ->intKey;. }.
29cc0 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d 3e 61 70 pRoot = pCur->ap
29cd0 50 61 67 65 5b 30 5d 3b 0a 20 20 61 73 73 65 72 Page[0];. asser
29ce0 74 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 3d 3d t( pRoot->pgno==
29cf0 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 29 pCur->pgnoRoot )
29d00 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 43 75 72 2d ;.. /* If pCur-
29d10 3e 70 4b 65 79 49 6e 66 6f 20 69 73 20 6e 6f 74 >pKeyInfo is not
29d20 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20 NULL, then the
29d30 63 61 6c 6c 65 72 20 74 68 61 74 20 6f 70 65 6e caller that open
29d40 65 64 20 74 68 69 73 20 63 75 72 73 6f 72 0a 20 ed this cursor.
29d50 20 2a 2a 20 65 78 70 65 63 74 65 64 20 74 6f 20 ** expected to
29d60 6f 70 65 6e 20 69 74 20 6f 6e 20 61 6e 20 69 6e open it on an in
29d70 64 65 78 20 62 2d 74 72 65 65 2e 20 4f 74 68 65 dex b-tree. Othe
29d80 72 77 69 73 65 2c 20 69 66 20 70 4b 65 79 49 6e rwise, if pKeyIn
29d90 66 6f 20 69 73 0a 20 20 2a 2a 20 4e 55 4c 4c 2c fo is. ** NULL,
29da0 20 74 68 65 20 63 61 6c 6c 65 72 20 65 78 70 65 the caller expe
29db0 63 74 73 20 61 20 74 61 62 6c 65 20 62 2d 74 72 cts a table b-tr
29dc0 65 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 6e ee. If this is n
29dd0 6f 74 20 74 68 65 20 63 61 73 65 2c 0a 20 20 2a ot the case,. *
29de0 2a 20 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 49 * return an SQLI
29df0 54 45 5f 43 4f 52 52 55 50 54 20 65 72 72 6f 72 TE_CORRUPT error
29e00 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 72 . . **. ** Ear
29e10 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 lier versions of
29e20 20 53 51 4c 69 74 65 20 61 73 73 75 6d 65 64 20 SQLite assumed
29e30 74 68 61 74 20 74 68 69 73 20 74 65 73 74 20 63 that this test c
29e40 6f 75 6c 64 20 6e 6f 74 20 66 61 69 6c 0a 20 20 ould not fail.
29e50 2a 2a 20 69 66 20 74 68 65 20 72 6f 6f 74 20 70 ** if the root p
29e60 61 67 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 age was already
29e70 6c 6f 61 64 65 64 20 77 68 65 6e 20 74 68 69 73 loaded when this
29e80 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 61 function was ca
29e90 6c 6c 65 64 20 28 69 2e 65 2e 0a 20 20 2a 2a 20 lled (i.e.. **
29ea0 69 66 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d if pCur->iPage>=
29eb0 30 29 2e 20 42 75 74 20 74 68 69 73 20 69 73 20 0). But this is
29ec0 6e 6f 74 20 73 6f 20 69 66 20 74 68 65 20 64 61 not so if the da
29ed0 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 75 70 tabase is corrup
29ee0 74 65 64 20 0a 20 20 2a 2a 20 69 6e 20 73 75 63 ted . ** in suc
29ef0 68 20 61 20 77 61 79 20 74 68 61 74 20 70 61 67 h a way that pag
29f00 65 20 70 52 6f 6f 74 20 69 73 20 6c 69 6e 6b 65 e pRoot is linke
29f10 64 20 69 6e 74 6f 20 61 20 73 65 63 6f 6e 64 20 d into a second
29f20 62 2d 74 72 65 65 20 74 61 62 6c 65 20 0a 20 20 b-tree table .
29f30 2a 2a 20 28 6f 72 20 74 68 65 20 66 72 65 65 6c ** (or the freel
29f40 69 73 74 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 ist). */. asse
29f50 72 74 28 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b 65 rt( pRoot->intKe
29f60 79 3d 3d 31 20 7c 7c 20 70 52 6f 6f 74 2d 3e 69 y==1 || pRoot->i
29f70 6e 74 4b 65 79 3d 3d 30 20 29 3b 0a 20 20 69 66 ntKey==0 );. if
29f80 28 20 70 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 3d ( pRoot->isInit=
29f90 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e 70 4b 65 =0 || (pCur->pKe
29fa0 79 49 6e 66 6f 3d 3d 30 29 21 3d 70 52 6f 6f 74 yInfo==0)!=pRoot
29fb0 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 ->intKey ){.
29fc0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
29fd0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a RRUPT_BKPT;. }.
29fe0 0a 73 6b 69 70 5f 69 6e 69 74 3a 20 20 0a 20 20 .skip_init: .
29ff0 70 43 75 72 2d 3e 69 78 20 3d 20 30 3b 0a 20 20 pCur->ix = 0;.
2a000 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
2a010 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 = 0;. pCur->cu
2a020 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 rFlags &= ~(BTCF
2a030 5f 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 6c _AtLast|BTCF_Val
2a040 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 idNKey|BTCF_Vali
2a050 64 4f 76 66 6c 29 3b 0a 0a 20 20 70 52 6f 6f 74 dOvfl);.. pRoot
2a060 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2a070 30 5d 3b 0a 20 20 69 66 28 20 70 52 6f 6f 74 2d 0];. if( pRoot-
2a080 3e 6e 43 65 6c 6c 3e 30 20 29 7b 0a 20 20 20 20 >nCell>0 ){.
2a090 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
2a0a0 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 7d URSOR_VALID;. }
2a0b0 65 6c 73 65 20 69 66 28 20 21 70 52 6f 6f 74 2d else if( !pRoot-
2a0c0 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 6e >leaf ){. Pgn
2a0d0 6f 20 73 75 62 70 61 67 65 3b 0a 20 20 20 20 69 o subpage;. i
2a0e0 66 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 21 3d f( pRoot->pgno!=
2a0f0 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 1 ) return SQLIT
2a100 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
2a110 20 20 20 20 73 75 62 70 61 67 65 20 3d 20 67 65 subpage = ge
2a120 74 34 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e 61 t4byte(&pRoot->a
2a130 44 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 4f Data[pRoot->hdrO
2a140 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 ffset+8]);. p
2a150 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
2a160 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 RSOR_VALID;.
2a170 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 rc = moveToChild
2a180 28 70 43 75 72 2c 20 73 75 62 70 61 67 65 29 3b (pCur, subpage);
2a190 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 . }else{. pC
2a1a0 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
2a1b0 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 7d SOR_INVALID;. }
2a1c0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
2a1d0 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
2a1e0 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 cursor down to t
2a1f0 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 61 he left-most lea
2a200 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 f entry beneath
2a210 74 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f 20 the.** entry to
2a220 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 which it is curr
2a230 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 0a ently pointing..
2a240 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d 6d **.** The left-m
2a250 6f 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 20 ost leaf is the
2a260 6f 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d 61 one with the sma
2a270 6c 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 20 llest key - the
2a280 66 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 65 first.** in asce
2a290 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a nding order..*/.
2a2a0 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 static int moveT
2a2b0 6f 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 73 oLeftmost(BtCurs
2a2c0 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e or *pCur){. Pgn
2a2d0 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 o pgno;. int rc
2a2e0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
2a2f0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a MemPage *pPage;.
2a300 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
2a310 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
2a320 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
2a330 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
2a340 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
2a350 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 while( rc==SQLI
2a360 54 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 TE_OK && !(pPage
2a370 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2a380 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c pCur->iPage])->l
2a390 65 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 eaf ){. asser
2a3a0 74 28 20 70 43 75 72 2d 3e 69 78 3c 70 50 61 67 t( pCur->ix<pPag
2a3b0 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 e->nCell );.
2a3c0 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 pgno = get4byte(
2a3d0 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
2a3e0 70 43 75 72 2d 3e 69 78 29 29 3b 0a 20 20 20 20 pCur->ix));.
2a3f0 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 rc = moveToChild
2a400 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 (pCur, pgno);.
2a410 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
2a420 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
2a430 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 cursor down to
2a440 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c the right-most l
2a450 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 eaf entry beneat
2a460 68 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f h the.** page to
2a470 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 which it is cur
2a480 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e rently pointing.
2a490 20 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 66 Notice the dif
2a4a0 66 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 ference.** betwe
2a4b0 65 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 en moveToLeftmos
2a4c0 74 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 t() and moveToRi
2a4d0 67 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 ghtmost(). move
2a4e0 54 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 ToLeftmost().**
2a4f0 66 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d 6d finds the left-m
2a500 6f 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 ost entry beneat
2a510 68 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 h the *entry* wh
2a520 65 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 ereas moveToRigh
2a530 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 tmost().** finds
2a540 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 the right-most
2a550 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 entry beneath th
2a560 65 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 e *page*..**.**
2a570 54 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 The right-most e
2a580 6e 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 20 ntry is the one
2a590 77 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 74 with the largest
2a5a0 20 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 0a key - the last.
2a5b0 2a 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 ** key in ascend
2a5c0 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 ing order..*/.st
2a5d0 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 atic int moveToR
2a5e0 69 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 6f ightmost(BtCurso
2a5f0 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f r *pCur){. Pgno
2a600 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 pgno;. int rc
2a610 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d = SQLITE_OK;. M
2a620 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 emPage *pPage =
2a630 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 0;.. assert( cu
2a640 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 rsorOwnsBtShared
2a650 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
2a660 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
2a670 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
2a680 3b 0a 20 20 77 68 69 6c 65 28 20 21 28 70 50 61 ;. while( !(pPa
2a690 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
2a6a0 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d e[pCur->iPage])-
2a6b0 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 70 67 6e >leaf ){. pgn
2a6c0 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 o = get4byte(&pP
2a6d0 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 age->aData[pPage
2a6e0 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b ->hdrOffset+8]);
2a6f0 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 . pCur->ix =
2a700 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
2a710 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
2a720 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a ld(pCur, pgno);.
2a730 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
2a740 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 43 urn rc;. }. pC
2a750 75 72 2d 3e 69 78 20 3d 20 70 50 61 67 65 2d 3e ur->ix = pPage->
2a760 6e 43 65 6c 6c 2d 31 3b 0a 20 20 61 73 73 65 72 nCell-1;. asser
2a770 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 t( pCur->info.nS
2a780 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 ize==0 );. asse
2a790 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c rt( (pCur->curFl
2a7a0 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 ags & BTCF_Valid
2a7b0 4e 4b 65 79 29 3d 3d 30 20 29 3b 0a 20 20 72 65 NKey)==0 );. re
2a7c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2a7d0 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 }../* Move the c
2a7e0 75 72 73 6f 72 20 74 6f 20 74 68 65 20 66 69 72 ursor to the fir
2a7f0 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 st entry in the
2a800 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 table. Return S
2a810 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 QLITE_OK.** on s
2a820 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 52 uccess. Set *pR
2a830 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 63 es to 0 if the c
2a840 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 70 ursor actually p
2a850 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 oints to somethi
2a860 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 52 ng.** or set *pR
2a870 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 74 es to 1 if the t
2a880 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a able is empty..*
2a890 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
2a8a0 65 65 46 69 72 73 74 28 42 74 43 75 72 73 6f 72 eeFirst(BtCursor
2a8b0 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 *pCur, int *pRe
2a8c0 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 s){. int rc;..
2a8d0 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f assert( cursorO
2a8e0 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 wnsBtShared(pCur
2a8f0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2a900 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2a910 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e d(pCur->pBtree->
2a920 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
2a930 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 rc = moveToRoot(
2a940 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 3d pCur);. if( rc=
2a950 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2a960 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
2a970 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c te==CURSOR_INVAL
2a980 49 44 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 ID ){. asse
2a990 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f rt( pCur->pgnoRo
2a9a0 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 ot==0 || pCur->a
2a9b0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2a9c0 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a e]->nCell==0 );.
2a9d0 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b *pRes = 1;
2a9e0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
2a9f0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2aa00 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
2aa10 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a ge]->nCell>0 );.
2aa20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b *pRes = 0;
2aa30 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 . rc = move
2aa40 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 ToLeftmost(pCur)
2aa50 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
2aa60 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d turn rc;.}../* M
2aa70 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 ove the cursor t
2aa80 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 79 o the last entry
2aa90 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 20 in the table.
2aaa0 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b Return SQLITE_OK
2aab0 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 .** on success.
2aac0 20 53 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 Set *pRes to 0
2aad0 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 61 63 if the cursor ac
2aae0 74 75 61 6c 6c 79 20 70 6f 69 6e 74 73 20 74 6f tually points to
2aaf0 20 73 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 6f 72 something.** or
2ab00 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 31 20 set *pRes to 1
2ab10 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 73 20 if the table is
2ab20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 empty..*/.int sq
2ab30 6c 69 74 65 33 42 74 72 65 65 4c 61 73 74 28 42 lite3BtreeLast(B
2ab40 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 tCursor *pCur, i
2ab50 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e 74 nt *pRes){. int
2ab60 20 72 63 3b 0a 20 0a 20 20 61 73 73 65 72 74 28 rc;. . assert(
2ab70 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2ab80 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2ab90 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
2aba0 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e utex_held(pCur->
2abb0 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 pBtree->db->mute
2abc0 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 x) );.. /* If t
2abd0 68 65 20 63 75 72 73 6f 72 20 61 6c 72 65 61 64 he cursor alread
2abe0 79 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 y points to the
2abf0 6c 61 73 74 20 65 6e 74 72 79 2c 20 74 68 69 73 last entry, this
2ac00 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 2a 2f 0a is a no-op. */.
2ac10 20 20 69 66 28 20 43 55 52 53 4f 52 5f 56 41 4c if( CURSOR_VAL
2ac20 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 ID==pCur->eState
2ac30 20 26 26 20 28 70 43 75 72 2d 3e 63 75 72 46 6c && (pCur->curFl
2ac40 61 67 73 20 26 20 42 54 43 46 5f 41 74 4c 61 73 ags & BTCF_AtLas
2ac50 74 29 21 3d 30 20 29 7b 0a 23 69 66 64 65 66 20 t)!=0 ){.#ifdef
2ac60 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 SQLITE_DEBUG.
2ac70 20 2f 2a 20 54 68 69 73 20 62 6c 6f 63 6b 20 73 /* This block s
2ac80 65 72 76 65 73 20 74 6f 20 61 73 73 65 72 74 28 erves to assert(
2ac90 29 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f ) that the curso
2aca0 72 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 70 6f r really does po
2acb0 69 6e 74 20 0a 20 20 20 20 2a 2a 20 74 6f 20 74 int . ** to t
2acc0 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e he last entry in
2acd0 20 74 68 65 20 62 2d 74 72 65 65 2e 20 2a 2f 0a the b-tree. */.
2ace0 20 20 20 20 69 6e 74 20 69 69 3b 0a 20 20 20 20 int ii;.
2acf0 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 43 75 for(ii=0; ii<pCu
2ad00 72 2d 3e 69 50 61 67 65 3b 20 69 69 2b 2b 29 7b r->iPage; ii++){
2ad10 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
2ad20 43 75 72 2d 3e 61 69 49 64 78 5b 69 69 5d 3d 3d Cur->aiIdx[ii]==
2ad30 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 69 5d pCur->apPage[ii]
2ad40 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 7d ->nCell );. }
2ad50 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
2ad60 72 2d 3e 69 78 3d 3d 70 43 75 72 2d 3e 61 70 50 r->ix==pCur->apP
2ad70 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
2ad80 2d 3e 6e 43 65 6c 6c 2d 31 20 29 3b 0a 20 20 20 ->nCell-1 );.
2ad90 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
2ada0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2adb0 65 5d 2d 3e 6c 65 61 66 20 29 3b 0a 23 65 6e 64 e]->leaf );.#end
2adc0 69 66 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 if. return SQ
2add0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 LITE_OK;. }..
2ade0 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 rc = moveToRoot(
2adf0 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 3d pCur);. if( rc=
2ae00 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2ae10 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 4e 56 if( CURSOR_INV
2ae20 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 ALID==pCur->eSta
2ae30 74 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 te ){. asse
2ae40 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f rt( pCur->pgnoRo
2ae50 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 ot==0 || pCur->a
2ae60 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2ae70 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a e]->nCell==0 );.
2ae80 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b *pRes = 1;
2ae90 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
2aea0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2aeb0 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
2aec0 41 4c 49 44 20 29 3b 0a 20 20 20 20 20 20 2a 70 ALID );. *p
2aed0 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 Res = 0;. r
2aee0 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d c = moveToRightm
2aef0 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 20 ost(pCur);.
2af00 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2af10 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 OK ){. pC
2af20 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 ur->curFlags |=
2af30 42 54 43 46 5f 41 74 4c 61 73 74 3b 0a 20 20 20 BTCF_AtLast;.
2af40 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2af50 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
2af60 20 26 3d 20 7e 42 54 43 46 5f 41 74 4c 61 73 74 &= ~BTCF_AtLast
2af70 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 0a 20 20 ;. }. .
2af80 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
2af90 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 rc;.}../* Move
2afa0 74 68 65 20 63 75 72 73 6f 72 20 73 6f 20 74 68 the cursor so th
2afb0 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 at it points to
2afc0 61 6e 20 65 6e 74 72 79 20 6e 65 61 72 20 74 68 an entry near th
2afd0 65 20 6b 65 79 20 0a 2a 2a 20 73 70 65 63 69 66 e key .** specif
2afe0 69 65 64 20 62 79 20 70 49 64 78 4b 65 79 20 6f ied by pIdxKey o
2aff0 72 20 69 6e 74 4b 65 79 2e 20 20 20 52 65 74 75 r intKey. Retu
2b000 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 6f 64 rn a success cod
2b010 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 49 4e 54 e..**.** For INT
2b020 4b 45 59 20 74 61 62 6c 65 73 2c 20 74 68 65 20 KEY tables, the
2b030 69 6e 74 4b 65 79 20 70 61 72 61 6d 65 74 65 72 intKey parameter
2b040 20 69 73 20 75 73 65 64 2e 20 20 70 49 64 78 4b is used. pIdxK
2b050 65 79 20 0a 2a 2a 20 6d 75 73 74 20 62 65 20 4e ey .** must be N
2b060 55 4c 4c 2e 20 20 46 6f 72 20 69 6e 64 65 78 20 ULL. For index
2b070 74 61 62 6c 65 73 2c 20 70 49 64 78 4b 65 79 20 tables, pIdxKey
2b080 69 73 20 75 73 65 64 20 61 6e 64 20 69 6e 74 4b is used and intK
2b090 65 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64 ey.** is ignored
2b0a0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 78 ..**.** If an ex
2b0b0 61 63 74 20 6d 61 74 63 68 20 69 73 20 6e 6f 74 act match is not
2b0c0 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 74 68 65 found, then the
2b0d0 20 63 75 72 73 6f 72 20 69 73 20 61 6c 77 61 79 cursor is alway
2b0e0 73 0a 2a 2a 20 6c 65 66 74 20 70 6f 69 6e 74 69 s.** left pointi
2b0f0 6e 67 20 61 74 20 61 20 6c 65 61 66 20 70 61 67 ng at a leaf pag
2b100 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 68 6f e which would ho
2b110 6c 64 20 74 68 65 20 65 6e 74 72 79 20 69 66 20 ld the entry if
2b120 69 74 0a 2a 2a 20 77 65 72 65 20 70 72 65 73 65 it.** were prese
2b130 6e 74 2e 20 20 54 68 65 20 63 75 72 73 6f 72 20 nt. The cursor
2b140 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 61 might point to a
2b150 6e 20 65 6e 74 72 79 20 74 68 61 74 20 63 6f 6d n entry that com
2b160 65 73 0a 2a 2a 20 62 65 66 6f 72 65 20 6f 72 20 es.** before or
2b170 61 66 74 65 72 20 74 68 65 20 6b 65 79 2e 0a 2a after the key..*
2b180 2a 0a 2a 2a 20 41 6e 20 69 6e 74 65 67 65 72 20 *.** An integer
2b190 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
2b1a0 2a 70 52 65 73 20 77 68 69 63 68 20 69 73 20 74 *pRes which is t
2b1b0 68 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a 2a 20 he result of.**
2b1c0 63 6f 6d 70 61 72 69 6e 67 20 74 68 65 20 6b 65 comparing the ke
2b1d0 79 20 77 69 74 68 20 74 68 65 20 65 6e 74 72 79 y with the entry
2b1e0 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 63 75 to which the cu
2b1f0 72 73 6f 72 20 69 73 20 0a 2a 2a 20 70 6f 69 6e rsor is .** poin
2b200 74 69 6e 67 2e 20 20 54 68 65 20 6d 65 61 6e 69 ting. The meani
2b210 6e 67 20 6f 66 20 74 68 65 20 69 6e 74 65 67 65 ng of the intege
2b220 72 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 0a 2a r written into.*
2b230 2a 20 2a 70 52 65 73 20 69 73 20 61 73 20 66 6f * *pRes is as fo
2b240 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 llows:.**.**
2b250 20 2a 70 52 65 73 3c 30 20 20 20 20 20 20 54 68 *pRes<0 Th
2b260 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
2b270 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 pointing at an
2b280 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 entry that.**
2b290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
2b2a0 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 69 s smaller than i
2b2b0 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 20 6f 72 ntKey/pIdxKey or
2b2c0 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 73 if the table is
2b2d0 20 65 6d 70 74 79 0a 2a 2a 20 20 20 20 20 20 20 empty.**
2b2e0 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 74 and t
2b2f0 68 65 20 63 75 72 73 6f 72 20 69 73 20 74 68 65 he cursor is the
2b300 72 65 66 6f 72 65 20 6c 65 66 74 20 70 6f 69 6e refore left poin
2b310 74 20 74 6f 20 6e 6f 74 68 69 6e 67 2e 0a 2a 2a t to nothing..**
2b320 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3d 3d 30 .** *pRes==0
2b330 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 20 The cursor
2b340 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e 67 is left pointing
2b350 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 61 at an entry tha
2b360 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 t.**
2b370 20 20 20 20 20 20 65 78 61 63 74 6c 79 20 6d 61 exactly ma
2b380 74 63 68 65 73 20 69 6e 74 4b 65 79 2f 70 49 64 tches intKey/pId
2b390 78 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 xKey..**.**
2b3a0 2a 70 52 65 73 3e 30 20 20 20 20 20 20 54 68 65 *pRes>0 The
2b3b0 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 20 cursor is left
2b3c0 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 pointing at an e
2b3d0 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 20 ntry that.**
2b3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 73 is
2b3f0 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 6e 74 larger than int
2b400 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a 2a 0a Key/pIdxKey..**.
2b410 2a 2a 20 46 6f 72 20 69 6e 64 65 78 20 74 61 62 ** For index tab
2b420 6c 65 73 2c 20 74 68 65 20 70 49 64 78 4b 65 79 les, the pIdxKey
2b430 2d 3e 65 71 53 65 65 6e 20 66 69 65 6c 64 20 69 ->eqSeen field i
2b440 73 20 73 65 74 20 74 6f 20 31 20 69 66 20 74 68 s set to 1 if th
2b450 65 72 65 0a 2a 2a 20 65 78 69 73 74 73 20 61 6e ere.** exists an
2b460 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 entry in the ta
2b470 62 6c 65 20 74 68 61 74 20 65 78 61 63 74 6c 79 ble that exactly
2b480 20 6d 61 74 63 68 65 73 20 70 49 64 78 4b 65 79 matches pIdxKey
2b490 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 . .*/.int sqlit
2b4a0 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 e3BtreeMovetoUnp
2b4b0 61 63 6b 65 64 28 0a 20 20 42 74 43 75 72 73 6f acked(. BtCurso
2b4c0 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 20 20 r *pCur,
2b4d0 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20 /* The cursor
2b4e0 74 6f 20 62 65 20 6d 6f 76 65 64 20 2a 2f 0a 20 to be moved */.
2b4f0 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 UnpackedRecord
2b500 2a 70 49 64 78 4b 65 79 2c 20 2f 2a 20 55 6e 70 *pIdxKey, /* Unp
2b510 61 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 79 20 acked index key
2b520 2a 2f 0a 20 20 69 36 34 20 69 6e 74 4b 65 79 2c */. i64 intKey,
2b530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2b540 20 54 68 65 20 74 61 62 6c 65 20 6b 65 79 20 2a The table key *
2b550 2f 0a 20 20 69 6e 74 20 62 69 61 73 52 69 67 68 /. int biasRigh
2b560 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t, /*
2b570 49 66 20 74 72 75 65 2c 20 62 69 61 73 20 74 68 If true, bias th
2b580 65 20 73 65 61 72 63 68 20 74 6f 20 74 68 65 20 e search to the
2b590 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 6e high end */. in
2b5a0 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20 20 t *pRes
2b5b0 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 /* Write
2b5c0 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 20 68 search results h
2b5d0 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ere */.){. int
2b5e0 72 63 3b 0a 20 20 52 65 63 6f 72 64 43 6f 6d 70 rc;. RecordComp
2b5f0 61 72 65 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 are xRecordCompa
2b600 72 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 re;.. assert( c
2b610 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
2b620 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 d(pCur) );. ass
2b630 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
2b640 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 ex_held(pCur->pB
2b650 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 tree->db->mutex)
2b660 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 52 );. assert( pR
2b670 65 73 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 es );. assert(
2b680 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 70 (pIdxKey==0)==(p
2b690 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d 3d 30 Cur->pKeyInfo==0
2b6a0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
2b6b0 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2b6c0 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 28 70 49 SOR_VALID || (pI
2b6d0 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 70 43 75 72 dxKey==0)==(pCur
2b6e0 2d 3e 63 75 72 49 6e 74 4b 65 79 21 3d 30 29 20 ->curIntKey!=0)
2b6f0 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 );.. /* If the
2b700 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 61 64 cursor is alread
2b710 79 20 70 6f 73 69 74 69 6f 6e 65 64 20 61 74 20 y positioned at
2b720 74 68 65 20 70 6f 69 6e 74 20 77 65 20 61 72 65 the point we are
2b730 20 74 72 79 69 6e 67 0a 20 20 2a 2a 20 74 6f 20 trying. ** to
2b740 6d 6f 76 65 20 74 6f 2c 20 74 68 65 6e 20 6a 75 move to, then ju
2b750 73 74 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 st return withou
2b760 74 20 64 6f 69 6e 67 20 61 6e 79 20 77 6f 72 6b t doing any work
2b770 20 2a 2f 0a 20 20 69 66 28 20 70 49 64 78 4b 65 */. if( pIdxKe
2b780 79 3d 3d 30 0a 20 20 20 26 26 20 70 43 75 72 2d y==0. && pCur-
2b790 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
2b7a0 56 41 4c 49 44 20 26 26 20 28 70 43 75 72 2d 3e VALID && (pCur->
2b7b0 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
2b7c0 56 61 6c 69 64 4e 4b 65 79 29 21 3d 30 0a 20 20 ValidNKey)!=0.
2b7d0 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d ){. if( pCur-
2b7e0 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e 74 4b >info.nKey==intK
2b7f0 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 ey ){. *pRe
2b800 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 s = 0;. ret
2b810 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2b820 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 75 }. if( pCu
2b830 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3c 69 6e 74 r->info.nKey<int
2b840 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 69 66 28 Key ){. if(
2b850 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
2b860 20 26 20 42 54 43 46 5f 41 74 4c 61 73 74 29 21 & BTCF_AtLast)!
2b870 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 =0 ){. *p
2b880 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 Res = -1;.
2b890 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2b8a0 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 OK;. }.
2b8b0 20 20 2f 2a 20 49 66 20 74 68 65 20 72 65 71 75 /* If the requ
2b8c0 65 73 74 65 64 20 6b 65 79 20 69 73 20 6f 6e 65 ested key is one
2b8d0 20 6d 6f 72 65 20 74 68 61 6e 20 74 68 65 20 70 more than the p
2b8e0 72 65 76 69 6f 75 73 20 6b 65 79 2c 20 74 68 65 revious key, the
2b8f0 6e 0a 20 20 20 20 20 20 2a 2a 20 74 72 79 20 74 n. ** try t
2b900 6f 20 67 65 74 20 74 68 65 72 65 20 75 73 69 6e o get there usin
2b910 67 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 g sqlite3BtreeNe
2b920 78 74 28 29 20 72 61 74 68 65 72 20 74 68 61 6e xt() rather than
2b930 20 61 20 66 75 6c 6c 0a 20 20 20 20 20 20 2a 2a a full. **
2b940 20 62 69 6e 61 72 79 20 73 65 61 72 63 68 2e 20 binary search.
2b950 20 54 68 69 73 20 69 73 20 61 6e 20 6f 70 74 69 This is an opti
2b960 6d 69 7a 61 74 69 6f 6e 20 6f 6e 6c 79 2e 20 20 mization only.
2b970 54 68 65 20 63 6f 72 72 65 63 74 20 61 6e 73 77 The correct answ
2b980 65 72 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 73 er. ** is s
2b990 74 69 6c 6c 20 6f 62 74 61 69 6e 65 64 20 77 69 till obtained wi
2b9a0 74 68 6f 75 74 20 74 68 69 73 20 61 73 65 2c 20 thout this ase,
2b9b0 6f 6e 6c 79 20 61 20 6c 69 74 74 6c 65 20 6d 6f only a little mo
2b9c0 72 65 20 73 6c 6f 77 65 6c 79 20 2a 2f 0a 20 20 re slowely */.
2b9d0 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e if( pCur->in
2b9e0 66 6f 2e 6e 4b 65 79 2b 31 3d 3d 69 6e 74 4b 65 fo.nKey+1==intKe
2b9f0 79 20 26 26 20 21 70 43 75 72 2d 3e 73 6b 69 70 y && !pCur->skip
2ba00 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 20 20 Next ){.
2ba10 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 *pRes = 0;.
2ba20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
2ba30 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 treeNext(pCur, p
2ba40 52 65 73 29 3b 0a 20 20 20 20 20 20 20 20 69 66 Res);. if
2ba50 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
2ba60 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a 70 ;. if( *p
2ba70 52 65 73 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 Res==0 ){.
2ba80 20 20 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 getCellInfo(
2ba90 70 43 75 72 29 3b 0a 20 20 20 20 20 20 20 20 20 pCur);.
2baa0 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e if( pCur->info.
2bab0 6e 4b 65 79 3d 3d 69 6e 74 4b 65 79 20 29 7b 0a nKey==intKey ){.
2bac0 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2bad0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2bae0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2baf0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
2bb00 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 49 64 }. }.. if( pId
2bb10 78 4b 65 79 20 29 7b 0a 20 20 20 20 78 52 65 63 xKey ){. xRec
2bb20 6f 72 64 43 6f 6d 70 61 72 65 20 3d 20 73 71 6c ordCompare = sql
2bb30 69 74 65 33 56 64 62 65 46 69 6e 64 43 6f 6d 70 ite3VdbeFindComp
2bb40 61 72 65 28 70 49 64 78 4b 65 79 29 3b 0a 20 20 are(pIdxKey);.
2bb50 20 20 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f pIdxKey->errCo
2bb60 64 65 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 65 de = 0;. asse
2bb70 72 74 28 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 rt( pIdxKey->def
2bb80 61 75 6c 74 5f 72 63 3d 3d 31 20 0a 20 20 20 20 ault_rc==1 .
2bb90 20 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d || pIdxKey-
2bba0 3e 64 65 66 61 75 6c 74 5f 72 63 3d 3d 30 20 0a >default_rc==0 .
2bbb0 20 20 20 20 20 20 20 20 20 7c 7c 20 70 49 64 78 || pIdx
2bbc0 4b 65 79 2d 3e 64 65 66 61 75 6c 74 5f 72 63 3d Key->default_rc=
2bbd0 3d 2d 31 0a 20 20 20 20 29 3b 0a 20 20 7d 65 6c =-1. );. }el
2bbe0 73 65 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 se{. xRecordC
2bbf0 6f 6d 70 61 72 65 20 3d 20 30 3b 20 2f 2a 20 41 ompare = 0; /* A
2bc00 6c 6c 20 6b 65 79 73 20 61 72 65 20 69 6e 74 65 ll keys are inte
2bc10 67 65 72 73 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 gers */. }.. r
2bc20 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 c = moveToRoot(p
2bc30 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 20 29 Cur);. if( rc )
2bc40 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b {. return rc;
2bc50 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
2bc60 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 Cur->pgnoRoot==0
2bc70 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 || pCur->apPage
2bc80 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b [pCur->iPage] );
2bc90 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2bca0 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 >pgnoRoot==0 ||
2bcb0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
2bcc0 72 2d 3e 69 50 61 67 65 5d 2d 3e 69 73 49 6e 69 r->iPage]->isIni
2bcd0 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 t );. assert( p
2bce0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
2bcf0 53 4f 52 5f 49 4e 56 41 4c 49 44 20 7c 7c 20 70 SOR_INVALID || p
2bd00 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
2bd10 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e ->iPage]->nCell>
2bd20 30 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 0 );. if( pCur-
2bd30 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
2bd40 49 4e 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a INVALID ){. *
2bd50 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 61 pRes = -1;. a
2bd60 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e ssert( pCur->pgn
2bd70 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 oRoot==0 || pCur
2bd80 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
2bd90 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 Page]->nCell==0
2bda0 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 );. return SQ
2bdb0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 LITE_OK;. }. a
2bdc0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 ssert( pCur->apP
2bdd0 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 3d 3d age[0]->intKey==
2bde0 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 20 pCur->curIntKey
2bdf0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2be00 72 2d 3e 63 75 72 49 6e 74 4b 65 79 20 7c 7c 20 r->curIntKey ||
2be10 70 49 64 78 4b 65 79 20 29 3b 0a 20 20 66 6f 72 pIdxKey );. for
2be20 28 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 20 6c 77 (;;){. int lw
2be30 72 2c 20 75 70 72 2c 20 69 64 78 2c 20 63 3b 0a r, upr, idx, c;.
2be40 20 20 20 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b Pgno chldPg;
2be50 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 . MemPage *pP
2be60 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
2be70 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
2be80 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 3b 20 . u8 *pCell;
2be90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bea0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
2beb0 74 65 72 20 74 6f 20 63 75 72 72 65 6e 74 20 63 ter to current c
2bec0 65 6c 6c 20 69 6e 20 70 50 61 67 65 20 2a 2f 0a ell in pPage */.
2bed0 0a 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e 6e . /* pPage->n
2bee0 43 65 6c 6c 20 6d 75 73 74 20 62 65 20 67 72 65 Cell must be gre
2bef0 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e 20 ater than zero.
2bf00 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 72 If this is the r
2bf10 6f 6f 74 2d 70 61 67 65 0a 20 20 20 20 2a 2a 20 oot-page. **
2bf20 74 68 65 20 63 75 72 73 6f 72 20 77 6f 75 6c 64 the cursor would
2bf30 20 68 61 76 65 20 62 65 65 6e 20 49 4e 56 41 4c have been INVAL
2bf40 49 44 20 61 62 6f 76 65 20 61 6e 64 20 74 68 69 ID above and thi
2bf50 73 20 66 6f 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 s for(;;) loop.
2bf60 20 20 20 2a 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 ** not run. I
2bf70 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 f this is not th
2bf80 65 20 72 6f 6f 74 2d 70 61 67 65 2c 20 74 68 65 e root-page, the
2bf90 6e 20 74 68 65 20 6d 6f 76 65 54 6f 43 68 69 6c n the moveToChil
2bfa0 64 28 29 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 d() routine.
2bfb0 2a 2a 20 77 6f 75 6c 64 20 68 61 76 65 20 61 6c ** would have al
2bfc0 72 65 61 64 79 20 64 65 74 65 63 74 65 64 20 64 ready detected d
2bfd0 62 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 53 69 b corruption. Si
2bfe0 6d 69 6c 61 72 6c 79 2c 20 70 50 61 67 65 20 6d milarly, pPage m
2bff0 75 73 74 0a 20 20 20 20 2a 2a 20 62 65 20 74 68 ust. ** be th
2c000 65 20 72 69 67 68 74 20 6b 69 6e 64 20 28 69 6e e right kind (in
2c010 64 65 78 20 6f 72 20 74 61 62 6c 65 29 20 6f 66 dex or table) of
2c020 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 4f 74 b-tree page. Ot
2c030 68 65 72 77 69 73 65 0a 20 20 20 20 2a 2a 20 61 herwise. ** a
2c040 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 6f moveToChild() o
2c050 72 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 29 20 63 r moveToRoot() c
2c060 61 6c 6c 20 77 6f 75 6c 64 20 68 61 76 65 20 64 all would have d
2c070 65 74 65 63 74 65 64 20 63 6f 72 72 75 70 74 69 etected corrupti
2c080 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 on. */. asse
2c090 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c rt( pPage->nCell
2c0a0 3e 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 >0 );. assert
2c0b0 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d ( pPage->intKey=
2c0c0 3d 28 70 49 64 78 4b 65 79 3d 3d 30 29 20 29 3b =(pIdxKey==0) );
2c0d0 0a 20 20 20 20 6c 77 72 20 3d 20 30 3b 0a 20 20 . lwr = 0;.
2c0e0 20 20 75 70 72 20 3d 20 70 50 61 67 65 2d 3e 6e upr = pPage->n
2c0f0 43 65 6c 6c 2d 31 3b 0a 20 20 20 20 61 73 73 65 Cell-1;. asse
2c100 72 74 28 20 62 69 61 73 52 69 67 68 74 3d 3d 30 rt( biasRight==0
2c110 20 7c 7c 20 62 69 61 73 52 69 67 68 74 3d 3d 31 || biasRight==1
2c120 20 29 3b 0a 20 20 20 20 69 64 78 20 3d 20 75 70 );. idx = up
2c130 72 3e 3e 28 31 2d 62 69 61 73 52 69 67 68 74 29 r>>(1-biasRight)
2c140 3b 20 2f 2a 20 69 64 78 20 3d 20 62 69 61 73 52 ; /* idx = biasR
2c150 69 67 68 74 20 3f 20 75 70 72 20 3a 20 28 6c 77 ight ? upr : (lw
2c160 72 2b 75 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 r+upr)/2; */.
2c170 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 pCur->ix = (u16
2c180 29 69 64 78 3b 0a 20 20 20 20 69 66 28 20 78 52 )idx;. if( xR
2c190 65 63 6f 72 64 43 6f 6d 70 61 72 65 3d 3d 30 20 ecordCompare==0
2c1a0 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 3b 3b 29 ){. for(;;)
2c1b0 7b 0a 20 20 20 20 20 20 20 20 69 36 34 20 6e 43 {. i64 nC
2c1c0 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 ellKey;.
2c1d0 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c pCell = findCell
2c1e0 50 61 73 74 50 74 72 28 70 50 61 67 65 2c 20 69 PastPtr(pPage, i
2c1f0 64 78 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 dx);. if(
2c200 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 pPage->intKeyLe
2c210 61 66 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 af ){.
2c220 77 68 69 6c 65 28 20 30 78 38 30 20 3c 3d 20 2a while( 0x80 <= *
2c230 28 70 43 65 6c 6c 2b 2b 29 20 29 7b 0a 20 20 20 (pCell++) ){.
2c240 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 65 if( pCe
2c250 6c 6c 3e 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 ll>=pPage->aData
2c260 45 6e 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c End ) return SQL
2c270 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
2c280 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
2c290 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2c2a0 67 65 74 56 61 72 69 6e 74 28 70 43 65 6c 6c 2c getVarint(pCell,
2c2b0 20 28 75 36 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 (u64*)&nCellKey
2c2c0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e );. if( n
2c2d0 43 65 6c 6c 4b 65 79 3c 69 6e 74 4b 65 79 20 29 CellKey<intKey )
2c2e0 7b 0a 20 20 20 20 20 20 20 20 20 20 6c 77 72 20 {. lwr
2c2f0 3d 20 69 64 78 2b 31 3b 0a 20 20 20 20 20 20 20 = idx+1;.
2c300 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 if( lwr>upr )
2c310 7b 20 63 20 3d 20 2d 31 3b 20 62 72 65 61 6b 3b { c = -1; break;
2c320 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
2c330 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3e 69 6e if( nCellKey>in
2c340 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 tKey ){.
2c350 20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b 0a 20 upr = idx-1;.
2c360 20 20 20 20 20 20 20 20 20 69 66 28 20 6c 77 72 if( lwr
2c370 3e 75 70 72 20 29 7b 20 63 20 3d 20 2b 31 3b 20 >upr ){ c = +1;
2c380 62 72 65 61 6b 3b 20 7d 0a 20 20 20 20 20 20 20 break; }.
2c390 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
2c3a0 20 20 61 73 73 65 72 74 28 20 6e 43 65 6c 6c 4b assert( nCellK
2c3b0 65 79 3d 3d 69 6e 74 4b 65 79 20 29 3b 0a 20 20 ey==intKey );.
2c3c0 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 69 78 pCur->ix
2c3d0 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 = (u16)idx;.
2c3e0 20 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 if( !pPag
2c3f0 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
2c400 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 lwr = idx
2c410 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f ;. go
2c420 74 6f 20 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c to moveto_next_l
2c430 61 79 65 72 3b 0a 20 20 20 20 20 20 20 20 20 20 ayer;.
2c440 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
2c450 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 pCur->curFlag
2c460 73 20 7c 3d 20 42 54 43 46 5f 56 61 6c 69 64 4e s |= BTCF_ValidN
2c470 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 Key;.
2c480 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 pCur->info.nKey
2c490 20 3d 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 = nCellKey;.
2c4a0 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 69 pCur->i
2c4b0 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 nfo.nSize = 0;.
2c4c0 20 20 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 *pRes
2c4d0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
2c4e0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2c4f0 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a OK;. }.
2c500 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2c510 20 20 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 assert( lwr+up
2c520 72 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 r>=0 );.
2c530 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e idx = (lwr+upr)>
2c540 3e 31 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c >1; /* idx = (l
2c550 77 72 2b 75 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 wr+upr)/2; */.
2c560 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b }. }else{
2c570 0a 20 20 20 20 20 20 66 6f 72 28 3b 3b 29 7b 0a . for(;;){.
2c580 20 20 20 20 20 20 20 20 69 6e 74 20 6e 43 65 6c int nCel
2c590 6c 3b 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 l; /* Size of t
2c5a0 68 65 20 70 43 65 6c 6c 20 63 65 6c 6c 20 69 6e he pCell cell in
2c5b0 20 62 79 74 65 73 20 2a 2f 0a 20 20 20 20 20 20 bytes */.
2c5c0 20 20 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 pCell = findCe
2c5d0 6c 6c 50 61 73 74 50 74 72 28 70 50 61 67 65 2c llPastPtr(pPage,
2c5e0 20 69 64 78 29 3b 0a 0a 20 20 20 20 20 20 20 20 idx);..
2c5f0 2f 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 73 /* The maximum s
2c600 75 70 70 6f 72 74 65 64 20 70 61 67 65 2d 73 69 upported page-si
2c610 7a 65 20 69 73 20 36 35 35 33 36 20 62 79 74 65 ze is 65536 byte
2c620 73 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 s. This means th
2c630 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 at. ** th
2c640 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 e maximum number
2c650 20 6f 66 20 72 65 63 6f 72 64 20 62 79 74 65 73 of record bytes
2c660 20 73 74 6f 72 65 64 20 6f 6e 20 61 6e 20 69 6e stored on an in
2c670 64 65 78 20 42 2d 54 72 65 65 0a 20 20 20 20 20 dex B-Tree.
2c680 20 20 20 2a 2a 20 70 61 67 65 20 69 73 20 6c 65 ** page is le
2c690 73 73 20 74 68 61 6e 20 31 36 33 38 34 20 62 79 ss than 16384 by
2c6a0 74 65 73 20 61 6e 64 20 6d 61 79 20 62 65 20 73 tes and may be s
2c6b0 74 6f 72 65 64 20 61 73 20 61 20 32 2d 62 79 74 tored as a 2-byt
2c6c0 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 76 61 72 e. ** var
2c6d0 69 6e 74 2e 20 54 68 69 73 20 69 6e 66 6f 72 6d int. This inform
2c6e0 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ation is used to
2c6f0 20 61 74 74 65 6d 70 74 20 74 6f 20 61 76 6f 69 attempt to avoi
2c700 64 20 70 61 72 73 69 6e 67 20 0a 20 20 20 20 20 d parsing .
2c710 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 ** the entire
2c720 20 63 65 6c 6c 20 62 79 20 63 68 65 63 6b 69 6e cell by checkin
2c730 67 20 66 6f 72 20 74 68 65 20 63 61 73 65 73 20 g for the cases
2c740 77 68 65 72 65 20 74 68 65 20 72 65 63 6f 72 64 where the record
2c750 20 69 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 is . **
2c760 73 74 6f 72 65 64 20 65 6e 74 69 72 65 6c 79 20 stored entirely
2c770 77 69 74 68 69 6e 20 74 68 65 20 62 2d 74 72 65 within the b-tre
2c780 65 20 70 61 67 65 20 62 79 20 69 6e 73 70 65 63 e page by inspec
2c790 74 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 0a ting the first .
2c7a0 20 20 20 20 20 20 20 20 2a 2a 20 32 20 62 79 74 ** 2 byt
2c7b0 65 73 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a es of the cell..
2c7c0 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
2c7d0 20 20 20 6e 43 65 6c 6c 20 3d 20 70 43 65 6c 6c nCell = pCell
2c7e0 5b 30 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 [0];. if(
2c7f0 20 6e 43 65 6c 6c 3c 3d 70 50 61 67 65 2d 3e 6d nCell<=pPage->m
2c800 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 20 29 ax1bytePayload )
2c810 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 {. /* T
2c820 68 69 73 20 62 72 61 6e 63 68 20 72 75 6e 73 20 his branch runs
2c830 69 66 20 74 68 65 20 72 65 63 6f 72 64 2d 73 69 if the record-si
2c840 7a 65 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 ze field of the
2c850 63 65 6c 6c 20 69 73 20 61 0a 20 20 20 20 20 20 cell is a.
2c860 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 62 79 ** single by
2c870 74 65 20 76 61 72 69 6e 74 20 61 6e 64 20 74 68 te varint and th
2c880 65 20 72 65 63 6f 72 64 20 66 69 74 73 20 65 6e e record fits en
2c890 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 tirely on the ma
2c8a0 69 6e 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 in. **
2c8b0 62 2d 74 72 65 65 20 70 61 67 65 2e 20 20 2a 2f b-tree page. */
2c8c0 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 . testc
2c8d0 61 73 65 28 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c ase( pCell+nCell
2c8e0 2b 31 3d 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 +1==pPage->aData
2c8f0 45 6e 64 20 29 3b 0a 20 20 20 20 20 20 20 20 20 End );.
2c900 20 63 20 3d 20 78 52 65 63 6f 72 64 43 6f 6d 70 c = xRecordComp
2c910 61 72 65 28 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 are(nCell, (void
2c920 2a 29 26 70 43 65 6c 6c 5b 31 5d 2c 20 70 49 64 *)&pCell[1], pId
2c930 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20 7d xKey);. }
2c940 65 6c 73 65 20 69 66 28 20 21 28 70 43 65 6c 6c else if( !(pCell
2c950 5b 31 5d 20 26 20 30 78 38 30 29 20 0a 20 20 20 [1] & 0x80) .
2c960 20 20 20 20 20 20 20 26 26 20 28 6e 43 65 6c 6c && (nCell
2c970 20 3d 20 28 28 6e 43 65 6c 6c 26 30 78 37 66 29 = ((nCell&0x7f)
2c980 3c 3c 37 29 20 2b 20 70 43 65 6c 6c 5b 31 5d 29 <<7) + pCell[1])
2c990 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 <=pPage->maxLoca
2c9a0 6c 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 l. ){.
2c9b0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 /* The re
2c9c0 63 6f 72 64 2d 73 69 7a 65 20 66 69 65 6c 64 20 cord-size field
2c9d0 69 73 20 61 20 32 20 62 79 74 65 20 76 61 72 69 is a 2 byte vari
2c9e0 6e 74 20 61 6e 64 20 74 68 65 20 72 65 63 6f 72 nt and the recor
2c9f0 64 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 d . **
2ca00 66 69 74 73 20 65 6e 74 69 72 65 6c 79 20 6f 6e fits entirely on
2ca10 20 74 68 65 20 6d 61 69 6e 20 62 2d 74 72 65 65 the main b-tree
2ca20 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 page. */.
2ca30 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 testcase( p
2ca40 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 32 3d 3d 70 50 Cell+nCell+2==pP
2ca50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b age->aDataEnd );
2ca60 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 . c = x
2ca70 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 RecordCompare(nC
2ca80 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 ell, (void*)&pCe
2ca90 6c 6c 5b 32 5d 2c 20 70 49 64 78 4b 65 79 29 3b ll[2], pIdxKey);
2caa0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
2cab0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
2cac0 20 72 65 63 6f 72 64 20 66 6c 6f 77 73 20 6f 76 record flows ov
2cad0 65 72 20 6f 6e 74 6f 20 6f 6e 65 20 6f 72 20 6d er onto one or m
2cae0 6f 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ore overflow pag
2caf0 65 73 2e 20 49 6e 0a 20 20 20 20 20 20 20 20 20 es. In.
2cb00 20 2a 2a 20 74 68 69 73 20 63 61 73 65 20 74 68 ** this case th
2cb10 65 20 77 68 6f 6c 65 20 63 65 6c 6c 20 6e 65 65 e whole cell nee
2cb20 64 73 20 74 6f 20 62 65 20 70 61 72 73 65 64 2c ds to be parsed,
2cb30 20 61 20 62 75 66 66 65 72 20 61 6c 6c 6f 63 61 a buffer alloca
2cb40 74 65 64 0a 20 20 20 20 20 20 20 20 20 20 2a 2a ted. **
2cb50 20 61 6e 64 20 61 63 63 65 73 73 50 61 79 6c 6f and accessPaylo
2cb60 61 64 28 29 20 75 73 65 64 20 74 6f 20 72 65 74 ad() used to ret
2cb70 72 69 65 76 65 20 74 68 65 20 72 65 63 6f 72 64 rieve the record
2cb80 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 into the.
2cb90 20 20 20 20 2a 2a 20 62 75 66 66 65 72 20 62 65 ** buffer be
2cba0 66 6f 72 65 20 56 64 62 65 52 65 63 6f 72 64 43 fore VdbeRecordC
2cbb0 6f 6d 70 61 72 65 28 29 20 63 61 6e 20 62 65 20 ompare() can be
2cbc0 63 61 6c 6c 65 64 2e 20 0a 20 20 20 20 20 20 20 called. .
2cbd0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 20 20 **.
2cbe0 2a 2a 20 49 66 20 74 68 65 20 72 65 63 6f 72 64 ** If the record
2cbf0 20 69 73 20 63 6f 72 72 75 70 74 2c 20 74 68 65 is corrupt, the
2cc00 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 20 xRecordCompare
2cc10 72 6f 75 74 69 6e 65 20 6d 61 79 20 72 65 61 64 routine may read
2cc20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 75 70 . ** up
2cc30 20 74 6f 20 74 77 6f 20 76 61 72 69 6e 74 73 20 to two varints
2cc40 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 past the end of
2cc50 74 68 65 20 62 75 66 66 65 72 2e 20 41 6e 20 65 the buffer. An e
2cc60 78 74 72 61 20 31 38 20 0a 20 20 20 20 20 20 20 xtra 18 .
2cc70 20 20 20 2a 2a 20 62 79 74 65 73 20 6f 66 20 70 ** bytes of p
2cc80 61 64 64 69 6e 67 20 69 73 20 61 6c 6c 6f 63 61 adding is alloca
2cc90 74 65 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f ted at the end o
2cca0 66 20 74 68 65 20 62 75 66 66 65 72 20 69 6e 0a f the buffer in.
2ccb0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 63 61 73 ** cas
2ccc0 65 20 74 68 69 73 20 68 61 70 70 65 6e 73 2e 20 e this happens.
2ccd0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 76 6f */. vo
2cce0 69 64 20 2a 70 43 65 6c 6c 4b 65 79 3b 0a 20 20 id *pCellKey;.
2ccf0 20 20 20 20 20 20 20 20 75 38 20 2a 20 63 6f 6e u8 * con
2cd00 73 74 20 70 43 65 6c 6c 42 6f 64 79 20 3d 20 70 st pCellBody = p
2cd10 43 65 6c 6c 20 2d 20 70 50 61 67 65 2d 3e 63 68 Cell - pPage->ch
2cd20 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 20 20 ildPtrSize;.
2cd30 20 20 20 20 20 20 70 50 61 67 65 2d 3e 78 50 61 pPage->xPa
2cd40 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 rseCell(pPage, p
2cd50 43 65 6c 6c 42 6f 64 79 2c 20 26 70 43 75 72 2d CellBody, &pCur-
2cd60 3e 69 6e 66 6f 29 3b 0a 20 20 20 20 20 20 20 20 >info);.
2cd70 20 20 6e 43 65 6c 6c 20 3d 20 28 69 6e 74 29 70 nCell = (int)p
2cd80 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3b 0a Cur->info.nKey;.
2cd90 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 testca
2cda0 73 65 28 20 6e 43 65 6c 6c 3c 30 20 29 3b 20 20 se( nCell<0 );
2cdb0 20 2f 2a 20 54 72 75 65 20 69 66 20 6b 65 79 20 /* True if key
2cdc0 73 69 7a 65 20 69 73 20 32 5e 33 32 20 6f 72 20 size is 2^32 or
2cdd0 6d 6f 72 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 more */.
2cde0 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 65 6c testcase( nCel
2cdf0 6c 3d 3d 30 20 29 3b 20 20 2f 2a 20 49 6e 76 61 l==0 ); /* Inva
2ce00 6c 69 64 20 6b 65 79 20 73 69 7a 65 3a 20 20 30 lid key size: 0
2ce10 78 38 30 20 30 78 38 30 20 30 78 30 30 20 2a 2f x80 0x80 0x00 */
2ce20 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 . testc
2ce30 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 31 20 29 3b ase( nCell==1 );
2ce40 20 20 2f 2a 20 49 6e 76 61 6c 69 64 20 6b 65 79 /* Invalid key
2ce50 20 73 69 7a 65 3a 20 20 30 78 38 30 20 30 78 38 size: 0x80 0x8
2ce60 30 20 30 78 30 31 20 2a 2f 0a 20 20 20 20 20 20 0 0x01 */.
2ce70 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 testcase( nC
2ce80 65 6c 6c 3d 3d 32 20 29 3b 20 20 2f 2a 20 4d 69 ell==2 ); /* Mi
2ce90 6e 69 6d 75 6d 20 6c 65 67 61 6c 20 69 6e 64 65 nimum legal inde
2cea0 78 20 6b 65 79 20 73 69 7a 65 20 2a 2f 0a 20 20 x key size */.
2ceb0 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c if( nCel
2cec0 6c 3c 32 20 29 7b 0a 20 20 20 20 20 20 20 20 20 l<2 ){.
2ced0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
2cee0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
2cef0 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f goto mo
2cf00 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 veto_finish;.
2cf10 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
2cf20 20 20 20 70 43 65 6c 6c 4b 65 79 20 3d 20 73 71 pCellKey = sq
2cf30 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 lite3Malloc( nCe
2cf40 6c 6c 2b 31 38 20 29 3b 0a 20 20 20 20 20 20 20 ll+18 );.
2cf50 20 20 20 69 66 28 20 70 43 65 6c 6c 4b 65 79 3d if( pCellKey=
2cf60 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
2cf70 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
2cf80 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 MEM_BKPT;.
2cf90 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
2cfa0 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 o_finish;.
2cfb0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
2cfc0 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 29 pCur->ix = (u16)
2cfd0 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 20 72 idx;. r
2cfe0 63 20 3d 20 61 63 63 65 73 73 50 61 79 6c 6f 61 c = accessPayloa
2cff0 64 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c d(pCur, 0, nCell
2d000 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 , (unsigned char
2d010 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 30 29 3b 0a *)pCellKey, 0);.
2d020 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
2d030 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 curFlags &= ~BTC
2d040 46 5f 56 61 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 F_ValidOvfl;.
2d050 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b if( rc ){
2d060 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
2d070 69 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b ite3_free(pCellK
2d080 65 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ey);.
2d090 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e goto moveto_fin
2d0a0 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d ish;. }
2d0b0 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 . c = x
2d0c0 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 RecordCompare(nC
2d0d0 65 6c 6c 2c 20 70 43 65 6c 6c 4b 65 79 2c 20 70 ell, pCellKey, p
2d0e0 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 IdxKey);.
2d0f0 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
2d100 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 20 pCellKey);.
2d110 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 }. ass
2d120 65 72 74 28 20 0a 20 20 20 20 20 20 20 20 20 20 ert( .
2d130 20 20 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 (pIdxKey->errC
2d140 6f 64 65 21 3d 53 51 4c 49 54 45 5f 43 4f 52 52 ode!=SQLITE_CORR
2d150 55 50 54 20 7c 7c 20 63 3d 3d 30 29 0a 20 20 20 UPT || c==0).
2d160 20 20 20 20 20 20 26 26 20 28 70 49 64 78 4b 65 && (pIdxKe
2d170 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 y->errCode!=SQLI
2d180 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 70 43 75 72 TE_NOMEM || pCur
2d190 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 61 ->pBtree->db->ma
2d1a0 6c 6c 6f 63 46 61 69 6c 65 64 29 0a 20 20 20 20 llocFailed).
2d1b0 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 );. i
2d1c0 66 28 20 63 3c 30 20 29 7b 0a 20 20 20 20 20 20 f( c<0 ){.
2d1d0 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 3b lwr = idx+1;
2d1e0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
2d1f0 66 28 20 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 f( c>0 ){.
2d200 20 20 20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b upr = idx-1;
2d210 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
2d220 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 assert
2d230 28 20 63 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ( c==0 );.
2d240 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
2d250 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
2d260 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
2d270 20 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 pCur->ix = (u
2d280 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 16)idx;.
2d290 20 20 69 66 28 20 70 49 64 78 4b 65 79 2d 3e 65 if( pIdxKey->e
2d2a0 72 72 43 6f 64 65 20 29 20 72 63 20 3d 20 53 51 rrCode ) rc = SQ
2d2b0 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20 20 LITE_CORRUPT;.
2d2c0 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
2d2d0 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 eto_finish;.
2d2e0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 }. if
2d2f0 28 20 6c 77 72 3e 75 70 72 20 29 20 62 72 65 61 ( lwr>upr ) brea
2d300 6b 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 k;. asser
2d310 74 28 20 6c 77 72 2b 75 70 72 3e 3d 30 20 29 3b t( lwr+upr>=0 );
2d320 0a 20 20 20 20 20 20 20 20 69 64 78 20 3d 20 28 . idx = (
2d330 6c 77 72 2b 75 70 72 29 3e 3e 31 3b 20 20 2f 2a lwr+upr)>>1; /*
2d340 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 idx = (lwr+upr)
2d350 2f 32 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 /2 */. }.
2d360 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 }. assert(
2d370 6c 77 72 3d 3d 75 70 72 2b 31 20 7c 7c 20 28 70 lwr==upr+1 || (p
2d380 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 20 Page->intKey &&
2d390 21 70 50 61 67 65 2d 3e 6c 65 61 66 29 20 29 3b !pPage->leaf) );
2d3a0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
2d3b0 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 20 20 ge->isInit );.
2d3c0 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 61 if( pPage->lea
2d3d0 66 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 f ){. asser
2d3e0 74 28 20 70 43 75 72 2d 3e 69 78 3c 70 43 75 72 t( pCur->ix<pCur
2d3f0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
2d400 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a Page]->nCell );.
2d410 20 20 20 20 20 20 70 43 75 72 2d 3e 69 78 20 3d pCur->ix =
2d420 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 (u16)idx;.
2d430 20 2a 70 52 65 73 20 3d 20 63 3b 0a 20 20 20 20 *pRes = c;.
2d440 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
2d450 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 ;. goto mov
2d460 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 eto_finish;.
2d470 7d 0a 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c 61 }.moveto_next_la
2d480 79 65 72 3a 0a 20 20 20 20 69 66 28 20 6c 77 72 yer:. if( lwr
2d490 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 >=pPage->nCell )
2d4a0 7b 0a 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d {. chldPg =
2d4b0 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
2d4c0 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 ->aData[pPage->h
2d4d0 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 drOffset+8]);.
2d4e0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 63 }else{. c
2d4f0 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 hldPg = get4byte
2d500 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c (findCell(pPage,
2d510 20 6c 77 72 29 29 3b 0a 20 20 20 20 7d 0a 20 20 lwr));. }.
2d520 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 pCur->ix = (u1
2d530 36 29 6c 77 72 3b 0a 20 20 20 20 72 63 20 3d 20 6)lwr;. rc =
2d540 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 72 moveToChild(pCur
2d550 2c 20 63 68 6c 64 50 67 29 3b 0a 20 20 20 20 69 , chldPg);. i
2d560 66 28 20 72 63 20 29 20 62 72 65 61 6b 3b 0a 20 f( rc ) break;.
2d570 20 7d 0a 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 }.moveto_finish
2d580 3a 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e :. pCur->info.n
2d590 53 69 7a 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 Size = 0;. asse
2d5a0 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c rt( (pCur->curFl
2d5b0 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 ags & BTCF_Valid
2d5c0 4f 76 66 6c 29 3d 3d 30 20 29 3b 0a 20 20 72 65 Ovfl)==0 );. re
2d5d0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a turn rc;.}.../*.
2d5e0 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 ** Return TRUE i
2d5f0 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 f the cursor is
2d600 6e 6f 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 not pointing at
2d610 61 6e 20 65 6e 74 72 79 20 6f 66 20 74 68 65 20 an entry of the
2d620 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 52 55 table..**.** TRU
2d630 45 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e E will be return
2d640 65 64 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20 ed after a call
2d650 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e to sqlite3BtreeN
2d660 65 78 74 28 29 20 6d 6f 76 65 73 0a 2a 2a 20 70 ext() moves.** p
2d670 61 73 74 20 74 68 65 20 6c 61 73 74 20 65 6e 74 ast the last ent
2d680 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 ry in the table
2d690 6f 72 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 or sqlite3BtreeP
2d6a0 72 65 76 28 29 20 6d 6f 76 65 73 20 70 61 73 74 rev() moves past
2d6b0 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 65 6e .** the first en
2d6c0 74 72 79 2e 20 20 54 52 55 45 20 69 73 20 61 6c try. TRUE is al
2d6d0 73 6f 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 so returned if t
2d6e0 68 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 he table is empt
2d6f0 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 y..*/.int sqlite
2d700 33 42 74 72 65 65 45 6f 66 28 42 74 43 75 72 73 3BtreeEof(BtCurs
2d710 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 2f 2a 20 or *pCur){. /*
2d720 54 4f 44 4f 3a 20 57 68 61 74 20 69 66 20 74 68 TODO: What if th
2d730 65 20 63 75 72 73 6f 72 20 69 73 20 69 6e 20 43 e cursor is in C
2d740 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 URSOR_REQUIRESEE
2d750 4b 20 62 75 74 20 61 6c 6c 20 74 61 62 6c 65 20 K but all table
2d760 65 6e 74 72 69 65 73 0a 20 20 2a 2a 20 68 61 76 entries. ** hav
2d770 65 20 62 65 65 6e 20 64 65 6c 65 74 65 64 3f 20 e been deleted?
2d780 54 68 69 73 20 41 50 49 20 77 69 6c 6c 20 6e 65 This API will ne
2d790 65 64 20 74 6f 20 63 68 61 6e 67 65 20 74 6f 20 ed to change to
2d7a0 72 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 return an error
2d7b0 63 6f 64 65 0a 20 20 2a 2a 20 61 73 20 77 65 6c code. ** as wel
2d7c0 6c 20 61 73 20 74 68 65 20 62 6f 6f 6c 65 61 6e l as the boolean
2d7d0 20 72 65 73 75 6c 74 20 76 61 6c 75 65 2e 0a 20 result value..
2d7e0 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 28 43 55 */. return (CU
2d7f0 52 53 4f 52 5f 56 41 4c 49 44 21 3d 70 43 75 72 RSOR_VALID!=pCur
2d800 2d 3e 65 53 74 61 74 65 29 3b 0a 7d 0a 0a 2f 2a ->eState);.}../*
2d810 0a 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20 65 73 .** Return an es
2d820 74 69 6d 61 74 65 20 66 6f 72 20 74 68 65 20 6e timate for the n
2d830 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e umber of rows in
2d840 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 the table that
2d850 70 43 75 72 20 69 73 0a 2a 2a 20 70 6f 69 6e 74 pCur is.** point
2d860 69 6e 67 20 74 6f 2e 20 20 52 65 74 75 72 6e 20 ing to. Return
2d870 61 20 6e 65 67 61 74 69 76 65 20 6e 75 6d 62 65 a negative numbe
2d880 72 20 69 66 20 6e 6f 20 65 73 74 69 6d 61 74 65 r if no estimate
2d890 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 0a 2a is currently .*
2d8a0 2a 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a 2f 0a * available..*/.
2d8b0 69 36 34 20 73 71 6c 69 74 65 33 42 74 72 65 65 i64 sqlite3Btree
2d8c0 52 6f 77 43 6f 75 6e 74 45 73 74 28 42 74 43 75 RowCountEst(BtCu
2d8d0 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 rsor *pCur){. i
2d8e0 36 34 20 6e 3b 0a 20 20 75 38 20 69 3b 0a 0a 20 64 n;. u8 i;..
2d8f0 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f assert( cursorO
2d900 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 wnsBtShared(pCur
2d910 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2d920 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2d930 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e d(pCur->pBtree->
2d940 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 db->mutex) );..
2d950 20 2f 2a 20 43 75 72 72 65 6e 74 6c 79 20 74 68 /* Currently th
2d960 69 73 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 is interface is
2d970 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 62 79 20 74 only called by t
2d980 68 65 20 4f 50 5f 49 66 53 6d 61 6c 6c 65 72 0a he OP_IfSmaller.
2d990 20 20 2a 2a 20 6f 70 63 6f 64 65 2c 20 61 6e 64 ** opcode, and
2d9a0 20 69 74 20 74 68 61 74 20 63 61 73 65 20 74 68 it that case th
2d9b0 65 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 61 6c e cursor will al
2d9c0 77 61 79 73 20 62 65 20 76 61 6c 69 64 20 61 6e ways be valid an
2d9d0 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 61 6c 77 61 d. ** will alwa
2d9e0 79 73 20 70 6f 69 6e 74 20 74 6f 20 61 20 6c 65 ys point to a le
2d9f0 61 66 20 6e 6f 64 65 2e 20 2a 2f 0a 20 20 69 66 af node. */. if
2da00 28 20 4e 45 56 45 52 28 70 43 75 72 2d 3e 65 53 ( NEVER(pCur->eS
2da10 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
2da20 49 44 29 20 29 20 72 65 74 75 72 6e 20 2d 31 3b ID) ) return -1;
2da30 0a 20 20 69 66 28 20 4e 45 56 45 52 28 70 43 75 . if( NEVER(pCu
2da40 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
2da50 69 50 61 67 65 5d 2d 3e 6c 65 61 66 3d 3d 30 29 iPage]->leaf==0)
2da60 20 29 20 72 65 74 75 72 6e 20 2d 31 3b 0a 0a 20 ) return -1;..
2da70 20 66 6f 72 28 6e 3d 31 2c 20 69 3d 30 3b 20 69 for(n=1, i=0; i
2da80 3c 3d 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 <=pCur->iPage; i
2da90 2b 2b 29 7b 0a 20 20 20 20 6e 20 2a 3d 20 70 43 ++){. n *= pC
2daa0 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 6e ur->apPage[i]->n
2dab0 43 65 6c 6c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 Cell;. }. retu
2dac0 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 rn n;.}../*.** A
2dad0 64 76 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f dvance the curso
2dae0 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e r to the next en
2daf0 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 try in the datab
2db00 61 73 65 2e 20 20 49 66 0a 2a 2a 20 73 75 63 63 ase. If.** succ
2db10 65 73 73 66 75 6c 20 74 68 65 6e 20 73 65 74 20 essful then set
2db20 2a 70 52 65 73 3d 30 2e 20 20 49 66 20 74 68 65 *pRes=0. If the
2db30 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 73 20 61 cursor.** was a
2db40 6c 72 65 61 64 79 20 70 6f 69 6e 74 69 6e 67 20 lready pointing
2db50 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 to the last entr
2db60 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
2db70 65 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 e before.** this
2db80 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c routine was cal
2db90 6c 65 64 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 led, then set *p
2dba0 52 65 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 Res=1..**.** The
2dbb0 20 6d 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e main entry poin
2dbc0 74 20 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 t is sqlite3Btre
2dbd0 65 4e 65 78 74 28 29 2e 20 20 54 68 61 74 20 72 eNext(). That r
2dbe0 6f 75 74 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 outine is optimi
2dbf0 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 zed.** for the c
2dc00 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 ommon case of me
2dc10 72 65 6c 79 20 69 6e 63 72 65 6d 65 6e 74 69 6e rely incrementin
2dc20 67 20 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 g the cell count
2dc30 65 72 20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 er BtCursor.aiId
2dc40 78 0a 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 x.** to the next
2dc50 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 cell on the cur
2dc60 72 65 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 rent page. The
2dc70 28 73 6c 6f 77 65 72 29 20 62 74 72 65 65 4e 65 (slower) btreeNe
2dc80 78 74 28 29 20 68 65 6c 70 65 72 0a 2a 2a 20 72 xt() helper.** r
2dc90 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
2dca0 20 77 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 when it is nece
2dcb0 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f ssary to move to
2dcc0 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 a different pag
2dcd0 65 20 6f 72 0a 2a 2a 20 74 6f 20 72 65 73 74 6f e or.** to resto
2dce0 72 65 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a re the cursor..*
2dcf0 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 *.** The calling
2dd00 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 function will s
2dd10 65 74 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 et *pRes to 0 or
2dd20 20 31 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 1. The initial
2dd30 20 2a 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 *pRes value.**
2dd40 77 69 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 will be 1 if the
2dd50 20 63 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 cursor being st
2dd60 65 70 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 epped correspond
2dd70 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 s to an SQL inde
2dd80 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 x and.** if this
2dd90 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 routine could h
2dda0 61 76 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 ave been skipped
2ddb0 20 69 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 if that SQL ind
2ddc0 65 78 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 ex had been.** a
2ddd0 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 unique index.
2dde0 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 63 61 Otherwise the ca
2ddf0 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 ller will have s
2de00 65 74 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f et *pRes to zero
2de10 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 ..** Zero is the
2de20 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 common case. Th
2de30 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e e btree implemen
2de40 74 61 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 tation is free t
2de50 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 o use the.** ini
2de60 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 tial *pRes value
2de70 20 61 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d as a hint to im
2de80 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 prove performanc
2de90 65 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 65 e, but the curre
2dea0 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 nt.** SQLite btr
2deb0 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ee implementatio
2dec0 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 n does not. (Not
2ded0 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 e that the comdb
2dee0 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 2 btree.** imple
2def0 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 mentation does u
2df00 73 65 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f se this hint, ho
2df10 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 wever.).*/.stati
2df20 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
2df30 45 20 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 E int btreeNext(
2df40 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
2df50 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e int *pRes){. in
2df60 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 64 78 3b t rc;. int idx;
2df70 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
2df80 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 e;.. assert( cu
2df90 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 rsorOwnsBtShared
2dfa0 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
2dfb0 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 rt( pCur->skipNe
2dfc0 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 xt==0 || pCur->e
2dfd0 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 State!=CURSOR_VA
2dfe0 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
2dff0 20 2a 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 69 *pRes==0 );. i
2e000 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 f( pCur->eState!
2e010 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b =CURSOR_VALID ){
2e020 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 43 . assert( (pC
2e030 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
2e040 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d TCF_ValidOvfl)==
2e050 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 0 );. rc = re
2e060 73 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 storeCursorPosit
2e070 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 ion(pCur);. i
2e080 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
2e090 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
2e0a0 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 rc;. }. i
2e0b0 66 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 f( CURSOR_INVALI
2e0c0 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 D==pCur->eState
2e0d0 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d ){. *pRes =
2e0e0 20 31 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 1;. return
2e0f0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
2e100 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e }. if( pCur->
2e110 73 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 skipNext ){.
2e120 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2e130 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
2e140 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 ALID || pCur->eS
2e150 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 tate==CURSOR_SKI
2e160 50 4e 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 PNEXT );. p
2e170 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
2e180 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 RSOR_VALID;.
2e190 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 if( pCur->skip
2e1a0 4e 65 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 Next>0 ){.
2e1b0 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 pCur->skipNext
2e1c0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 = 0;. re
2e1d0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2e1e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 }. pC
2e1f0 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 ur->skipNext = 0
2e200 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 ;. }. }.. p
2e210 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 Page = pCur->apP
2e220 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
2e230 3b 0a 20 20 69 64 78 20 3d 20 2b 2b 70 43 75 72 ;. idx = ++pCur
2e240 2d 3e 69 78 3b 0a 20 20 61 73 73 65 72 74 28 20 ->ix;. assert(
2e250 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b pPage->isInit );
2e260 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 .. /* If the da
2e270 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 tabase file is c
2e280 6f 72 72 75 70 74 2c 20 69 74 20 69 73 20 70 6f orrupt, it is po
2e290 73 73 69 62 6c 65 20 66 6f 72 20 74 68 65 20 76 ssible for the v
2e2a0 61 6c 75 65 20 6f 66 20 69 64 78 20 0a 20 20 2a alue of idx . *
2e2b0 2a 20 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 20 * to be invalid
2e2c0 68 65 72 65 2e 20 54 68 69 73 20 63 61 6e 20 6f here. This can o
2e2d0 6e 6c 79 20 6f 63 63 75 72 20 69 66 20 61 20 73 nly occur if a s
2e2e0 65 63 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f 64 econd cursor mod
2e2f0 69 66 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 70 ifies. ** the p
2e300 61 67 65 20 77 68 69 6c 65 20 63 75 72 73 6f 72 age while cursor
2e310 20 70 43 75 72 20 69 73 20 68 6f 6c 64 69 6e 67 pCur is holding
2e320 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
2e330 69 74 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 20 it. Which can.
2e340 2a 2a 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 ** only happen i
2e350 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 f the database i
2e360 73 20 63 6f 72 72 75 70 74 20 69 6e 20 73 75 63 s corrupt in suc
2e370 68 20 61 20 77 61 79 20 61 73 20 74 6f 20 6c 69 h a way as to li
2e380 6e 6b 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 nk the. ** page
2e390 20 69 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 into more than
2e3a0 6f 6e 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 one b-tree struc
2e3b0 74 75 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 63 ture. */. testc
2e3c0 61 73 65 28 20 69 64 78 3e 70 50 61 67 65 2d 3e ase( idx>pPage->
2e3d0 6e 43 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 20 nCell );.. if(
2e3e0 69 64 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c idx>=pPage->nCel
2e3f0 6c 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50 l ){. if( !pP
2e400 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 age->leaf ){.
2e410 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 rc = moveToCh
2e420 69 6c 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 ild(pCur, get4by
2e430 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
2e440 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
2e450 74 2b 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 66 t+8]));. if
2e460 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
2e470 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d ;. return m
2e480 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 oveToLeftmost(pC
2e490 75 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 ur);. }. d
2e4a0 6f 7b 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 o{. if( pCu
2e4b0 72 2d 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 r->iPage==0 ){.
2e4c0 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 *pRes = 1
2e4d0 3b 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e ;. pCur->
2e4e0 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f eState = CURSOR_
2e4f0 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 INVALID;.
2e500 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2e510 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 K;. }.
2e520 20 6d 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 moveToParent(pC
2e530 75 72 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 ur);. pPage
2e540 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2e550 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
2e560 20 20 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e }while( pCur->
2e570 69 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c ix>=pPage->nCell
2e580 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 );. if( pPag
2e590 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 e->intKey ){.
2e5a0 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
2e5b0 33 42 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 3BtreeNext(pCur,
2e5c0 20 70 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 pRes);. }els
2e5d0 65 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 e{. return
2e5e0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
2e5f0 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 . }. if( pPage
2e600 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 ->leaf ){. re
2e610 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2e620 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 }else{. ret
2e630 75 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f urn moveToLeftmo
2e640 73 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a st(pCur);. }.}.
2e650 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
2e660 4e 65 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 Next(BtCursor *p
2e670 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b Cur, int *pRes){
2e680 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
2e690 65 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 e;. assert( cur
2e6a0 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
2e6b0 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
2e6c0 74 28 20 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 t( pRes!=0 );.
2e6d0 61 73 73 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 assert( *pRes==0
2e6e0 20 7c 7c 20 2a 70 52 65 73 3d 3d 31 20 29 3b 0a || *pRes==1 );.
2e6f0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2e700 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 skipNext==0 || p
2e710 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2e720 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 70 SOR_VALID );. p
2e730 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
2e740 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 = 0;. pCur->cur
2e750 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f Flags &= ~(BTCF_
2e760 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 ValidNKey|BTCF_V
2e770 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 2a 70 52 alidOvfl);. *pR
2e780 65 73 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 43 es = 0;. if( pC
2e790 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
2e7a0 4f 52 5f 56 41 4c 49 44 20 29 20 72 65 74 75 72 OR_VALID ) retur
2e7b0 6e 20 62 74 72 65 65 4e 65 78 74 28 70 43 75 72 n btreeNext(pCur
2e7c0 2c 20 70 52 65 73 29 3b 0a 20 20 70 50 61 67 65 , pRes);. pPage
2e7d0 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2e7e0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
2e7f0 69 66 28 20 28 2b 2b 70 43 75 72 2d 3e 69 78 29 if( (++pCur->ix)
2e800 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 >=pPage->nCell )
2e810 7b 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 2d 2d {. pCur->ix--
2e820 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 ;. return btr
2e830 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 52 65 eeNext(pCur, pRe
2e840 73 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 s);. }. if( pP
2e850 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 age->leaf ){.
2e860 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2e870 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 K;. }else{.
2e880 72 65 74 75 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 return moveToLef
2e890 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 7d tmost(pCur);. }
2e8a0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 .}../*.** Step t
2e8b0 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 he cursor to the
2e8c0 20 62 61 63 6b 20 74 6f 20 74 68 65 20 70 72 65 back to the pre
2e8d0 76 69 6f 75 73 20 65 6e 74 72 79 20 69 6e 20 74 vious entry in t
2e8e0 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 66 he database. If
2e8f0 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 20 74 .** successful t
2e900 68 65 6e 20 73 65 74 20 2a 70 52 65 73 3d 30 2e hen set *pRes=0.
2e910 20 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 0a If the cursor.
2e920 2a 2a 20 77 61 73 20 61 6c 72 65 61 64 79 20 70 ** was already p
2e930 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 66 ointing to the f
2e940 69 72 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 irst entry in th
2e950 65 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 e database befor
2e960 65 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e e.** this routin
2e970 65 20 77 61 73 20 63 61 6c 6c 65 64 2c 20 74 68 e was called, th
2e980 65 6e 20 73 65 74 20 2a 70 52 65 73 3d 31 2e 0a en set *pRes=1..
2e990 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 65 **.** The main e
2e9a0 6e 74 72 79 20 70 6f 69 6e 74 20 69 73 20 73 71 ntry point is sq
2e9b0 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 69 6f lite3BtreePrevio
2e9c0 75 73 28 29 2e 20 20 54 68 61 74 20 72 6f 75 74 us(). That rout
2e9d0 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 7a 65 64 ine is optimized
2e9e0 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d .** for the comm
2e9f0 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 72 65 6c on case of merel
2ea00 79 20 64 65 63 72 65 6d 65 6e 74 69 6e 67 20 74 y decrementing t
2ea10 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 65 72 20 he cell counter
2ea20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 78 0a 2a BtCursor.aiIdx.*
2ea30 2a 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 * to the previou
2ea40 73 20 63 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 s cell on the cu
2ea50 72 72 65 6e 74 20 70 61 67 65 2e 20 20 54 68 65 rrent page. The
2ea60 20 28 73 6c 6f 77 65 72 29 20 62 74 72 65 65 50 (slower) btreeP
2ea70 72 65 76 69 6f 75 73 28 29 0a 2a 2a 20 68 65 6c revious().** hel
2ea80 70 65 72 20 72 6f 75 74 69 6e 65 20 69 73 20 63 per routine is c
2ea90 61 6c 6c 65 64 20 77 68 65 6e 20 69 74 20 69 73 alled when it is
2eaa0 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f necessary to mo
2eab0 76 65 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e ve to a differen
2eac0 74 20 70 61 67 65 0a 2a 2a 20 6f 72 20 74 6f 20 t page.** or to
2ead0 72 65 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 restore the curs
2eae0 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 or..**.** The ca
2eaf0 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 77 lling function w
2eb00 69 6c 6c 20 73 65 74 20 2a 70 52 65 73 20 74 6f ill set *pRes to
2eb10 20 30 20 6f 72 20 31 2e 20 20 54 68 65 20 69 6e 0 or 1. The in
2eb20 69 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 itial *pRes valu
2eb30 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 20 31 20 69 e.** will be 1 i
2eb40 66 20 74 68 65 20 63 75 72 73 6f 72 20 62 65 69 f the cursor bei
2eb50 6e 67 20 73 74 65 70 70 65 64 20 63 6f 72 72 65 ng stepped corre
2eb60 73 70 6f 6e 64 73 20 74 6f 20 61 6e 20 53 51 4c sponds to an SQL
2eb70 20 69 6e 64 65 78 20 61 6e 64 0a 2a 2a 20 69 66 index and.** if
2eb80 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 63 6f this routine co
2eb90 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 73 6b uld have been sk
2eba0 69 70 70 65 64 20 69 66 20 74 68 61 74 20 53 51 ipped if that SQ
2ebb0 4c 20 69 6e 64 65 78 20 68 61 64 20 62 65 65 6e L index had been
2ebc0 0a 2a 2a 20 61 20 75 6e 69 71 75 65 20 69 6e 64 .** a unique ind
2ebd0 65 78 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 ex. Otherwise t
2ebe0 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 68 he caller will h
2ebf0 61 76 65 20 73 65 74 20 2a 70 52 65 73 20 74 6f ave set *pRes to
2ec00 20 7a 65 72 6f 2e 0a 2a 2a 20 5a 65 72 6f 20 69 zero..** Zero i
2ec10 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 s the common cas
2ec20 65 2e 20 54 68 65 20 62 74 72 65 65 20 69 6d 70 e. The btree imp
2ec30 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 66 lementation is f
2ec40 72 65 65 20 74 6f 20 75 73 65 20 74 68 65 0a 2a ree to use the.*
2ec50 2a 20 69 6e 69 74 69 61 6c 20 2a 70 52 65 73 20 * initial *pRes
2ec60 76 61 6c 75 65 20 61 73 20 61 20 68 69 6e 74 20 value as a hint
2ec70 74 6f 20 69 6d 70 72 6f 76 65 20 70 65 72 66 6f to improve perfo
2ec80 72 6d 61 6e 63 65 2c 20 62 75 74 20 74 68 65 20 rmance, but the
2ec90 63 75 72 72 65 6e 74 0a 2a 2a 20 53 51 4c 69 74 current.** SQLit
2eca0 65 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e e btree implemen
2ecb0 74 61 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e tation does not.
2ecc0 20 28 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 (Note that the
2ecd0 63 6f 6d 64 62 32 20 62 74 72 65 65 0a 2a 2a 20 comdb2 btree.**
2ece0 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 implementation d
2ecf0 6f 65 73 20 75 73 65 20 74 68 69 73 20 68 69 6e oes use this hin
2ed00 74 2c 20 68 6f 77 65 76 65 72 2e 29 0a 2a 2f 0a t, however.).*/.
2ed10 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f static SQLITE_NO
2ed20 49 4e 4c 49 4e 45 20 69 6e 74 20 62 74 72 65 65 INLINE int btree
2ed30 50 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 6f Previous(BtCurso
2ed40 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
2ed50 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 es){. int rc;.
2ed60 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
2ed70 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
2ed80 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
2ed90 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
2eda0 28 20 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 ( pRes!=0 );. a
2edb0 73 73 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 ssert( *pRes==0
2edc0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2edd0 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c r->skipNext==0 |
2ede0 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d | pCur->eState!=
2edf0 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
2ee00 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 2d assert( (pCur-
2ee10 3e 63 75 72 46 6c 61 67 73 20 26 20 28 42 54 43 >curFlags & (BTC
2ee20 46 5f 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 F_AtLast|BTCF_Va
2ee30 6c 69 64 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c lidOvfl|BTCF_Val
2ee40 69 64 4e 4b 65 79 29 29 3d 3d 30 20 29 3b 0a 20 idNKey))==0 );.
2ee50 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
2ee60 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a nfo.nSize==0 );.
2ee70 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
2ee80 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
2ee90 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 ){. rc = res
2eea0 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
2eeb0 6f 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 on(pCur);. if
2eec0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
2eed0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
2eee0 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 rc;. }. if
2eef0 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ( CURSOR_INVALID
2ef00 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 ==pCur->eState )
2ef10 7b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 {. *pRes =
2ef20 31 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 1;. return
2ef30 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
2ef40 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 . if( pCur->s
2ef50 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 kipNext ){.
2ef60 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
2ef70 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
2ef80 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 LID || pCur->eSt
2ef90 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 ate==CURSOR_SKIP
2efa0 4e 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 NEXT );. pC
2efb0 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
2efc0 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 SOR_VALID;.
2efd0 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e if( pCur->skipN
2efe0 65 78 74 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 ext<0 ){.
2eff0 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
2f000 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 = 0;. ret
2f010 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2f020 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 }. pCu
2f030 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b r->skipNext = 0;
2f040 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 . }. }.. pP
2f050 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
2f060 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
2f070 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
2f080 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 20 20 69 66 ->isInit );. if
2f090 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 ( !pPage->leaf )
2f0a0 7b 0a 20 20 20 20 69 6e 74 20 69 64 78 20 3d 20 {. int idx =
2f0b0 70 43 75 72 2d 3e 69 78 3b 0a 20 20 20 20 72 63 pCur->ix;. rc
2f0c0 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 = moveToChild(p
2f0d0 43 75 72 2c 20 67 65 74 34 62 79 74 65 28 66 69 Cur, get4byte(fi
2f0e0 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 64 ndCell(pPage, id
2f0f0 78 29 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 x)));. if( rc
2f100 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
2f110 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 rc = moveToRig
2f120 68 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 htmost(pCur);.
2f130 7d 65 6c 73 65 7b 0a 20 20 20 20 77 68 69 6c 65 }else{. while
2f140 28 20 70 43 75 72 2d 3e 69 78 3d 3d 30 20 29 7b ( pCur->ix==0 ){
2f150 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
2f160 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 >iPage==0 ){.
2f170 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 pCur->eStat
2f180 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c e = CURSOR_INVAL
2f190 49 44 3b 0a 20 20 20 20 20 20 20 20 2a 70 52 65 ID;. *pRe
2f1a0 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 s = 1;. r
2f1b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2f1c0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d . }. m
2f1d0 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 oveToParent(pCur
2f1e0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 );. }. ass
2f1f0 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ert( pCur->info.
2f200 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 nSize==0 );.
2f210 61 73 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 assert( (pCur->c
2f220 75 72 46 6c 61 67 73 20 26 20 28 42 54 43 46 5f urFlags & (BTCF_
2f230 56 61 6c 69 64 4f 76 66 6c 29 29 3d 3d 30 20 29 ValidOvfl))==0 )
2f240 3b 0a 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 2d ;.. pCur->ix-
2f250 2d 3b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 -;. pPage = p
2f260 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
2f270 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 69 66 ->iPage];. if
2f280 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 ( pPage->intKey
2f290 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 && !pPage->leaf
2f2a0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
2f2b0 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 69 6f lite3BtreePrevio
2f2c0 75 73 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a us(pCur, pRes);.
2f2d0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
2f2e0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
2f2f0 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
2f300 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 urn rc;.}.int sq
2f310 6c 69 74 65 33 42 74 72 65 65 50 72 65 76 69 6f lite3BtreePrevio
2f320 75 73 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 us(BtCursor *pCu
2f330 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
2f340 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f assert( cursorO
2f350 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 wnsBtShared(pCur
2f360 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
2f370 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 Res!=0 );. asse
2f380 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 rt( *pRes==0 ||
2f390 2a 70 52 65 73 3d 3d 31 20 29 3b 0a 20 20 61 73 *pRes==1 );. as
2f3a0 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 sert( pCur->skip
2f3b0 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Next==0 || pCur-
2f3c0 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
2f3d0 56 41 4c 49 44 20 29 3b 0a 20 20 2a 70 52 65 73 VALID );. *pRes
2f3e0 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 = 0;. pCur->cu
2f3f0 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 rFlags &= ~(BTCF
2f400 5f 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 6c _AtLast|BTCF_Val
2f410 69 64 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c 69 idOvfl|BTCF_Vali
2f420 64 4e 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e dNKey);. pCur->
2f430 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
2f440 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
2f450 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
2f460 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e 69 78 3d . || pCur->ix=
2f470 3d 30 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e 61 =0. || pCur->a
2f480 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2f490 65 5d 2d 3e 6c 65 61 66 3d 3d 30 0a 20 20 29 7b e]->leaf==0. ){
2f4a0 0a 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 . return btre
2f4b0 65 50 72 65 76 69 6f 75 73 28 70 43 75 72 2c 20 ePrevious(pCur,
2f4c0 70 52 65 73 29 3b 0a 20 20 7d 0a 20 20 70 43 75 pRes);. }. pCu
2f4d0 72 2d 3e 69 78 2d 2d 3b 0a 20 20 72 65 74 75 72 r->ix--;. retur
2f4e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
2f4f0 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 /*.** Allocate a
2f500 20 6e 65 77 20 70 61 67 65 20 66 72 6f 6d 20 74 new page from t
2f510 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
2f520 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 65 77 20 ..**.** The new
2f530 70 61 67 65 20 69 73 20 6d 61 72 6b 65 64 20 61 page is marked a
2f540 73 20 64 69 72 74 79 2e 20 20 28 49 6e 20 6f 74 s dirty. (In ot
2f550 68 65 72 20 77 6f 72 64 73 2c 20 73 71 6c 69 74 her words, sqlit
2f560 65 33 50 61 67 65 72 57 72 69 74 65 28 29 0a 2a e3PagerWrite().*
2f570 2a 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 * has already be
2f580 65 6e 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 en called on the
2f590 20 6e 65 77 20 70 61 67 65 2e 29 20 20 54 68 65 new page.) The
2f5a0 20 6e 65 77 20 70 61 67 65 20 68 61 73 20 61 6c new page has al
2f5b0 73 6f 0a 2a 2a 20 62 65 65 6e 20 72 65 66 65 72 so.** been refer
2f5c0 65 6e 63 65 64 20 61 6e 64 20 74 68 65 20 63 61 enced and the ca
2f5d0 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 lling routine is
2f5e0 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 responsible for
2f5f0 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 73 71 6c 69 calling.** sqli
2f600 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 20 te3PagerUnref()
2f610 6f 6e 20 74 68 65 20 6e 65 77 20 70 61 67 65 20 on the new page
2f620 77 68 65 6e 20 69 74 20 69 73 20 64 6f 6e 65 2e when it is done.
2f630 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
2f640 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 is returned on
2f650 73 75 63 63 65 73 73 2e 20 20 41 6e 79 20 6f 74 success. Any ot
2f660 68 65 72 20 72 65 74 75 72 6e 20 76 61 6c 75 65 her return value
2f670 20 69 6e 64 69 63 61 74 65 73 0a 2a 2a 20 61 6e indicates.** an
2f680 20 65 72 72 6f 72 2e 20 20 2a 70 70 50 61 67 65 error. *ppPage
2f690 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 is set to NULL
2f6a0 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 in the event of
2f6b0 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 an error..**.**
2f6c0 49 66 20 74 68 65 20 22 6e 65 61 72 62 79 22 20 If the "nearby"
2f6d0 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 parameter is not
2f6e0 20 30 2c 20 74 68 65 6e 20 61 6e 20 65 66 66 6f 0, then an effo
2f6f0 72 74 20 69 73 20 6d 61 64 65 20 74 6f 20 0a 2a rt is made to .*
2f700 2a 20 6c 6f 63 61 74 65 20 61 20 70 61 67 65 20 * locate a page
2f710 63 6c 6f 73 65 20 74 6f 20 74 68 65 20 70 61 67 close to the pag
2f720 65 20 6e 75 6d 62 65 72 20 22 6e 65 61 72 62 79 e number "nearby
2f730 22 2e 20 20 54 68 69 73 20 63 61 6e 20 62 65 20 ". This can be
2f740 75 73 65 64 20 69 6e 20 61 6e 0a 2a 2a 20 61 74 used in an.** at
2f750 74 65 6d 70 74 20 74 6f 20 6b 65 65 70 20 72 65 tempt to keep re
2f760 6c 61 74 65 64 20 70 61 67 65 73 20 63 6c 6f 73 lated pages clos
2f770 65 20 74 6f 20 65 61 63 68 20 6f 74 68 65 72 20 e to each other
2f780 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
2f790 66 69 6c 65 2c 0a 2a 2a 20 77 68 69 63 68 20 69 file,.** which i
2f7a0 6e 20 74 75 72 6e 20 63 61 6e 20 6d 61 6b 65 20 n turn can make
2f7b0 64 61 74 61 62 61 73 65 20 61 63 63 65 73 73 20 database access
2f7c0 66 61 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 faster..**.** If
2f7d0 20 74 68 65 20 65 4d 6f 64 65 20 70 61 72 61 6d the eMode param
2f7e0 65 74 65 72 20 69 73 20 42 54 41 4c 4c 4f 43 5f eter is BTALLOC_
2f7f0 45 58 41 43 54 20 61 6e 64 20 74 68 65 20 6e 65 EXACT and the ne
2f800 61 72 62 79 20 70 61 67 65 20 65 78 69 73 74 73 arby page exists
2f810 0a 2a 2a 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 .** anywhere on
2f820 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 the free-list, t
2f830 68 65 6e 20 69 74 20 69 73 20 67 75 61 72 61 6e hen it is guaran
2f840 74 65 65 64 20 74 6f 20 62 65 20 72 65 74 75 72 teed to be retur
2f850 6e 65 64 2e 20 20 49 66 0a 2a 2a 20 65 4d 6f 64 ned. If.** eMod
2f860 65 20 69 73 20 42 54 41 4c 4c 4f 43 5f 4c 54 20 e is BTALLOC_LT
2f870 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 72 65 then the page re
2f880 74 75 72 6e 65 64 20 77 69 6c 6c 20 62 65 20 6c turned will be l
2f890 65 73 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 ess than or equa
2f8a0 6c 0a 2a 2a 20 74 6f 20 6e 65 61 72 62 79 20 69 l.** to nearby i
2f8b0 66 20 61 6e 79 20 73 75 63 68 20 70 61 67 65 20 f any such page
2f8c0 65 78 69 73 74 73 2e 20 20 49 66 20 65 4d 6f 64 exists. If eMod
2f8d0 65 20 69 73 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 e is BTALLOC_ANY
2f8e0 20 74 68 65 6e 20 74 68 65 72 65 0a 2a 2a 20 61 then there.** a
2f8f0 72 65 20 6e 6f 20 72 65 73 74 72 69 63 74 69 6f re no restrictio
2f900 6e 73 20 6f 6e 20 77 68 69 63 68 20 70 61 67 65 ns on which page
2f910 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
2f920 0a 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f .static int allo
2f930 63 61 74 65 42 74 72 65 65 50 61 67 65 28 0a 20 cateBtreePage(.
2f940 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 BtShared *pBt,
2f950 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 /* The b
2f960 74 72 65 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 tree */. MemPag
2f970 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 e **ppPage,
2f980 20 2f 2a 20 53 74 6f 72 65 20 70 6f 69 6e 74 65 /* Store pointe
2f990 72 20 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 r to the allocat
2f9a0 65 64 20 70 61 67 65 20 68 65 72 65 20 2a 2f 0a ed page here */.
2f9b0 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 2c 20 20 Pgno *pPgno,
2f9c0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 /* Stor
2f9d0 65 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 e the page numbe
2f9e0 72 20 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f r here */. Pgno
2f9f0 20 6e 65 61 72 62 79 2c 20 20 20 20 20 20 20 20 nearby,
2fa00 20 20 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 /* Search for
2fa10 20 61 20 70 61 67 65 20 6e 65 61 72 20 74 68 69 a page near thi
2fa20 73 20 6f 6e 65 20 2a 2f 0a 20 20 75 38 20 65 4d s one */. u8 eM
2fa30 6f 64 65 20 20 20 20 20 20 20 20 20 20 20 20 20 ode
2fa40 20 20 2f 2a 20 42 54 41 4c 4c 4f 43 5f 45 58 41 /* BTALLOC_EXA
2fa50 43 54 2c 20 42 54 41 4c 4c 4f 43 5f 4c 54 2c 20 CT, BTALLOC_LT,
2fa60 6f 72 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 2a or BTALLOC_ANY *
2fa70 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a /.){. MemPage *
2fa80 70 50 61 67 65 31 3b 0a 20 20 69 6e 74 20 72 63 pPage1;. int rc
2fa90 3b 0a 20 20 75 33 32 20 6e 3b 20 20 20 20 20 2f ;. u32 n; /
2faa0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
2fab0 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 s on the freelis
2fac0 74 20 2a 2f 0a 20 20 75 33 32 20 6b 3b 20 20 20 t */. u32 k;
2fad0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c /* Number of l
2fae0 65 61 76 65 73 20 6f 6e 20 74 68 65 20 74 72 75 eaves on the tru
2faf0 6e 6b 20 6f 66 20 74 68 65 20 66 72 65 65 6c 69 nk of the freeli
2fb00 73 74 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 st */. MemPage
2fb10 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 4d *pTrunk = 0;. M
2fb20 65 6d 50 61 67 65 20 2a 70 50 72 65 76 54 72 75 emPage *pPrevTru
2fb30 6e 6b 20 3d 20 30 3b 0a 20 20 50 67 6e 6f 20 6d nk = 0;. Pgno m
2fb40 78 50 61 67 65 3b 20 20 20 20 20 2f 2a 20 54 6f xPage; /* To
2fb50 74 61 6c 20 73 69 7a 65 20 6f 66 20 74 68 65 20 tal size of the
2fb60 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f database file */
2fb70 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
2fb80 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
2fb90 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
2fba0 61 73 73 65 72 74 28 20 65 4d 6f 64 65 3d 3d 42 assert( eMode==B
2fbb0 54 41 4c 4c 4f 43 5f 41 4e 59 20 7c 7c 20 28 6e TALLOC_ANY || (n
2fbc0 65 61 72 62 79 3e 30 20 26 26 20 49 66 4e 6f 74 earby>0 && IfNot
2fbd0 4f 6d 69 74 41 56 28 70 42 74 2d 3e 61 75 74 6f OmitAV(pBt->auto
2fbe0 56 61 63 75 75 6d 29 29 20 29 3b 0a 20 20 70 50 Vacuum)) );. pP
2fbf0 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 age1 = pBt->pPag
2fc00 65 31 3b 0a 20 20 6d 78 50 61 67 65 20 3d 20 62 e1;. mxPage = b
2fc10 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 treePagecount(pB
2fc20 74 29 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 t);. /* EVIDENC
2fc30 45 2d 4f 46 3a 20 52 2d 30 35 31 31 39 2d 30 32 E-OF: R-05119-02
2fc40 36 33 37 20 54 68 65 20 34 2d 62 79 74 65 20 62 637 The 4-byte b
2fc50 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 ig-endian intege
2fc60 72 20 61 74 20 6f 66 66 73 65 74 20 33 36 0a 20 r at offset 36.
2fc70 20 2a 2a 20 73 74 6f 72 65 73 20 73 74 6f 72 65 ** stores store
2fc80 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 s the total numb
2fc90 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 er of pages on t
2fca0 68 65 20 66 72 65 65 6c 69 73 74 2e 20 2a 2f 0a he freelist. */.
2fcb0 20 20 6e 20 3d 20 67 65 74 34 62 79 74 65 28 26 n = get4byte(&
2fcc0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
2fcd0 5d 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 ]);. testcase(
2fce0 6e 3d 3d 6d 78 50 61 67 65 2d 31 20 29 3b 0a 20 n==mxPage-1 );.
2fcf0 20 69 66 28 20 6e 3e 3d 6d 78 50 61 67 65 20 29 if( n>=mxPage )
2fd00 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
2fd10 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
2fd20 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 3e 30 20 ;. }. if( n>0
2fd30 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 ){. /* There
2fd40 61 72 65 20 70 61 67 65 73 20 6f 6e 20 74 68 65 are pages on the
2fd50 20 66 72 65 65 6c 69 73 74 2e 20 20 52 65 75 73 freelist. Reus
2fd60 65 20 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 70 e one of those p
2fd70 61 67 65 73 2e 20 2a 2f 0a 20 20 20 20 50 67 6e ages. */. Pgn
2fd80 6f 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 75 38 o iTrunk;. u8
2fd90 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b searchList = 0;
2fda0 20 2f 2a 20 49 66 20 74 68 65 20 66 72 65 65 2d /* If the free-
2fdb0 6c 69 73 74 20 6d 75 73 74 20 62 65 20 73 65 61 list must be sea
2fdc0 72 63 68 65 64 20 66 6f 72 20 27 6e 65 61 72 62 rched for 'nearb
2fdd0 79 27 20 2a 2f 0a 20 20 20 20 75 33 32 20 6e 53 y' */. u32 nS
2fde0 65 61 72 63 68 20 3d 20 30 3b 20 20 20 2f 2a 20 earch = 0; /*
2fdf0 43 6f 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d Count of the num
2fe00 62 65 72 20 6f 66 20 73 65 61 72 63 68 20 61 74 ber of search at
2fe10 74 65 6d 70 74 73 20 2a 2f 0a 20 20 20 20 0a 20 tempts */. .
2fe20 20 20 20 2f 2a 20 49 66 20 65 4d 6f 64 65 3d 3d /* If eMode==
2fe30 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 61 6e BTALLOC_EXACT an
2fe40 64 20 61 20 71 75 65 72 79 20 6f 66 20 74 68 65 d a query of the
2fe50 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 pointer-map.
2fe60 20 2a 2a 20 73 68 6f 77 73 20 74 68 61 74 20 74 ** shows that t
2fe70 68 65 20 70 61 67 65 20 27 6e 65 61 72 62 79 27 he page 'nearby'
2fe80 20 69 73 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e is somewhere on
2fe90 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 the free-list,
2fea0 74 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 then. ** the
2feb0 65 6e 74 69 72 65 2d 6c 69 73 74 20 77 69 6c 6c entire-list will
2fec0 20 62 65 20 73 65 61 72 63 68 65 64 20 66 6f 72 be searched for
2fed0 20 74 68 61 74 20 70 61 67 65 2e 0a 20 20 20 20 that page..
2fee0 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
2fef0 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
2ff00 4d 0a 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d M. if( eMode=
2ff10 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 29 =BTALLOC_EXACT )
2ff20 7b 0a 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 {. if( near
2ff30 62 79 3c 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 by<=mxPage ){.
2ff40 20 20 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a u8 eType;.
2ff50 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
2ff60 6e 65 61 72 62 79 3e 30 20 29 3b 0a 20 20 20 20 nearby>0 );.
2ff70 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
2ff80 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 >autoVacuum );.
2ff90 20 20 20 20 20 20 20 72 63 20 3d 20 70 74 72 6d rc = ptrm
2ffa0 61 70 47 65 74 28 70 42 74 2c 20 6e 65 61 72 62 apGet(pBt, nearb
2ffb0 79 2c 20 26 65 54 79 70 65 2c 20 30 29 3b 0a 20 y, &eType, 0);.
2ffc0 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 if( rc )
2ffd0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
2ffe0 20 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 if( eType==PT
2fff0 52 4d 41 50 5f 46 52 45 45 50 41 47 45 20 29 7b RMAP_FREEPAGE ){
30000 0a 20 20 20 20 20 20 20 20 20 20 73 65 61 72 63 . searc
30010 68 4c 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 20 hList = 1;.
30020 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
30030 20 7d 65 6c 73 65 20 69 66 28 20 65 4d 6f 64 65 }else if( eMode
30040 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a ==BTALLOC_LE ){.
30050 20 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 searchList
30060 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 = 1;. }.#end
30070 69 66 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 if.. /* Decre
30080 6d 65 6e 74 20 74 68 65 20 66 72 65 65 2d 6c 69 ment the free-li
30090 73 74 20 63 6f 75 6e 74 20 62 79 20 31 2e 20 53 st count by 1. S
300a0 65 74 20 69 54 72 75 6e 6b 20 74 6f 20 74 68 65 et iTrunk to the
300b0 20 69 6e 64 65 78 20 6f 66 20 74 68 65 0a 20 20 index of the.
300c0 20 20 2a 2a 20 66 69 72 73 74 20 66 72 65 65 2d ** first free-
300d0 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e list trunk page.
300e0 20 69 50 72 65 76 54 72 75 6e 6b 20 69 73 20 69 iPrevTrunk is i
300f0 6e 69 74 69 61 6c 6c 79 20 31 2e 0a 20 20 20 20 nitially 1..
30100 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
30110 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
30120 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a age1->pDbPage);.
30130 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
30140 75 72 6e 20 72 63 3b 0a 20 20 20 20 70 75 74 34 urn rc;. put4
30150 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 byte(&pPage1->aD
30160 61 74 61 5b 33 36 5d 2c 20 6e 2d 31 29 3b 0a 0a ata[36], n-1);..
30170 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 64 65 20 /* The code
30180 77 69 74 68 69 6e 20 74 68 69 73 20 6c 6f 6f 70 within this loop
30190 20 69 73 20 72 75 6e 20 6f 6e 6c 79 20 6f 6e 63 is run only onc
301a0 65 20 69 66 20 74 68 65 20 27 73 65 61 72 63 68 e if the 'search
301b0 4c 69 73 74 27 20 76 61 72 69 61 62 6c 65 0a 20 List' variable.
301c0 20 20 20 2a 2a 20 69 73 20 6e 6f 74 20 74 72 75 ** is not tru
301d0 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 e. Otherwise, it
301e0 20 72 75 6e 73 20 6f 6e 63 65 20 66 6f 72 20 65 runs once for e
301f0 61 63 68 20 74 72 75 6e 6b 2d 70 61 67 65 20 6f ach trunk-page o
30200 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 66 72 65 n the. ** fre
30210 65 2d 6c 69 73 74 20 75 6e 74 69 6c 20 74 68 65 e-list until the
30220 20 70 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 page 'nearby' i
30230 73 20 6c 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 s located (eMode
30240 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 ==BTALLOC_EXACT)
30250 0a 20 20 20 20 2a 2a 20 6f 72 20 75 6e 74 69 6c . ** or until
30260 20 61 20 70 61 67 65 20 6c 65 73 73 20 74 68 61 a page less tha
30270 6e 20 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f n 'nearby' is lo
30280 63 61 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 cated (eMode==BT
30290 41 4c 4c 4f 43 5f 4c 54 29 0a 20 20 20 20 2a 2f ALLOC_LT). */
302a0 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 . do {.
302b0 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 70 54 72 pPrevTrunk = pTr
302c0 75 6e 6b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 unk;. if( p
302d0 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 PrevTrunk ){.
302e0 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
302f0 2d 4f 46 3a 20 52 2d 30 31 35 30 36 2d 31 31 30 -OF: R-01506-110
30300 35 33 20 54 68 65 20 66 69 72 73 74 20 69 6e 74 53 The first int
30310 65 67 65 72 20 6f 6e 20 61 20 66 72 65 65 6c 69 eger on a freeli
30320 73 74 20 74 72 75 6e 6b 20 70 61 67 65 0a 20 20 st trunk page.
30330 20 20 20 20 20 20 2a 2a 20 69 73 20 74 68 65 20 ** is the
30340 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 page number of t
30350 68 65 20 6e 65 78 74 20 66 72 65 65 6c 69 73 74 he next freelist
30360 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 trunk page in t
30370 68 65 20 6c 69 73 74 20 6f 72 0a 20 20 20 20 20 he list or.
30380 20 20 20 2a 2a 20 7a 65 72 6f 20 69 66 20 74 68 ** zero if th
30390 69 73 20 69 73 20 74 68 65 20 6c 61 73 74 20 66 is is the last f
303a0 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 reelist trunk pa
303b0 67 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 ge. */. i
303c0 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 Trunk = get4byte
303d0 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 (&pPrevTrunk->aD
303e0 61 74 61 5b 30 5d 29 3b 0a 20 20 20 20 20 20 7d ata[0]);. }
303f0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a else{. /*
30400 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
30410 35 39 38 34 31 2d 31 33 37 39 38 20 54 68 65 20 59841-13798 The
30420 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 4-byte big-endia
30430 6e 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 n integer at off
30440 73 65 74 20 33 32 0a 20 20 20 20 20 20 20 20 2a set 32. *
30450 2a 20 73 74 6f 72 65 73 20 74 68 65 20 70 61 67 * stores the pag
30460 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
30470 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 first page of th
30480 65 20 66 72 65 65 6c 69 73 74 2c 20 6f 72 20 7a e freelist, or z
30490 65 72 6f 20 69 66 0a 20 20 20 20 20 20 20 20 2a ero if. *
304a0 2a 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 * the freelist i
304b0 73 20 65 6d 70 74 79 2e 20 2a 2f 0a 20 20 20 20 s empty. */.
304c0 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 iTrunk = get
304d0 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
304e0 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 20 Data[32]);.
304f0 20 7d 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 }. testcas
30500 65 28 20 69 54 72 75 6e 6b 3d 3d 6d 78 50 61 67 e( iTrunk==mxPag
30510 65 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 e );. if( i
30520 54 72 75 6e 6b 3e 6d 78 50 61 67 65 20 7c 7c 20 Trunk>mxPage ||
30530 6e 53 65 61 72 63 68 2b 2b 20 3e 20 6e 20 29 7b nSearch++ > n ){
30540 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
30550 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
30560 54 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a T;. }else{.
30570 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 rc = btr
30580 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 eeGetUnusedPage(
30590 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 pBt, iTrunk, &pT
305a0 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 runk, 0);.
305b0 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 }. if( rc )
305c0 7b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b {. pTrunk
305d0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 67 6f = 0;. go
305e0 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f to end_allocate_
305f0 70 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 page;. }.
30600 20 20 20 20 61 73 73 65 72 74 28 20 70 54 72 75 assert( pTru
30610 6e 6b 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 nk!=0 );. a
30620 73 73 65 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 ssert( pTrunk->a
30630 44 61 74 61 21 3d 30 20 29 3b 0a 20 20 20 20 20 Data!=0 );.
30640 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
30650 20 52 2d 31 33 35 32 33 2d 30 34 33 39 34 20 54 R-13523-04394 T
30660 68 65 20 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 he second intege
30670 72 20 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 20 r on a freelist
30680 74 72 75 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 trunk page.
30690 20 2a 2a 20 69 73 20 74 68 65 20 6e 75 6d 62 65 ** is the numbe
306a0 72 20 6f 66 20 6c 65 61 66 20 70 61 67 65 20 70 r of leaf page p
306b0 6f 69 6e 74 65 72 73 20 74 6f 20 66 6f 6c 6c 6f ointers to follo
306c0 77 2e 20 2a 2f 0a 20 20 20 20 20 20 6b 20 3d 20 w. */. k =
306d0 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b get4byte(&pTrunk
306e0 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 ->aData[4]);.
306f0 20 20 20 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 if( k==0 && !
30700 73 65 61 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 searchList ){.
30710 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 /* The tru
30720 6e 6b 20 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 nk has no leaves
30730 20 61 6e 64 20 74 68 65 20 6c 69 73 74 20 69 73 and the list is
30740 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 61 72 63 not being searc
30750 68 65 64 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a hed. . **
30760 20 53 6f 20 65 78 74 72 61 63 74 20 74 68 65 20 So extract the
30770 74 72 75 6e 6b 20 70 61 67 65 20 69 74 73 65 6c trunk page itsel
30780 66 20 61 6e 64 20 75 73 65 20 69 74 20 61 73 20 f and use it as
30790 74 68 65 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 the newly .
307a0 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 ** allocated
307b0 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 page */.
307c0 61 73 73 65 72 74 28 20 70 50 72 65 76 54 72 75 assert( pPrevTru
307d0 6e 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 nk==0 );.
307e0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
307f0 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e erWrite(pTrunk->
30800 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
30810 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
30820 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
30830 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
30840 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
30850 2a 70 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b *pPgno = iTrunk;
30860 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
30870 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
30880 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 2], &pTrunk->aDa
30890 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[0], 4);.
308a0 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 *ppPage = pTr
308b0 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 70 54 72 unk;. pTr
308c0 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 unk = 0;.
308d0 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 TRACE(("ALLOCAT
308e0 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 E: %d trunk - %d
308f0 20 66 72 65 65 20 70 61 67 65 73 20 6c 65 66 74 free pages left
30900 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 \n", *pPgno, n-1
30910 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 ));. }else
30920 69 66 28 20 6b 3e 28 75 33 32 29 28 70 42 74 2d if( k>(u32)(pBt-
30930 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 >usableSize/4 -
30940 32 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 2) ){. /*
30950 20 56 61 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f Value of k is o
30960 75 74 20 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 ut of range. Da
30970 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
30980 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20 n */. rc
30990 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
309a0 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 67 _BKPT;. g
309b0 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
309c0 5f 70 61 67 65 3b 0a 23 69 66 6e 64 65 66 20 53 _page;.#ifndef S
309d0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
309e0 41 43 55 55 4d 0a 20 20 20 20 20 20 7d 65 6c 73 ACUUM. }els
309f0 65 20 69 66 28 20 73 65 61 72 63 68 4c 69 73 74 e if( searchList
30a00 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 26 26 . &&
30a10 20 28 6e 65 61 72 62 79 3d 3d 69 54 72 75 6e 6b (nearby==iTrunk
30a20 20 7c 7c 20 28 69 54 72 75 6e 6b 3c 6e 65 61 72 || (iTrunk<near
30a30 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 by && eMode==BTA
30a40 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 LLOC_LE)) .
30a50 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 ){. /* T
30a60 68 65 20 6c 69 73 74 20 69 73 20 62 65 69 6e 67 he list is being
30a70 20 73 65 61 72 63 68 65 64 20 61 6e 64 20 74 68 searched and th
30a80 69 73 20 74 72 75 6e 6b 20 70 61 67 65 20 69 73 is trunk page is
30a90 20 74 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 the page.
30aa0 20 20 2a 2a 20 74 6f 20 61 6c 6c 6f 63 61 74 65 ** to allocate
30ab0 2c 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 , regardless of
30ac0 77 68 65 74 68 65 72 20 69 74 20 68 61 73 20 6c whether it has l
30ad0 65 61 76 65 73 2e 0a 20 20 20 20 20 20 20 20 2a eaves.. *
30ae0 2f 0a 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f /. *pPgno
30af0 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 20 = iTrunk;.
30b00 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 *ppPage = pTr
30b10 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 73 65 61 unk;. sea
30b20 72 63 68 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 rchList = 0;.
30b30 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
30b40 33 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 3PagerWrite(pTru
30b50 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 nk->pDbPage);.
30b60 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
30b70 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
30b80 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
30b90 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
30ba0 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 29 7b 0a if( k==0 ){.
30bb0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 70 if( !p
30bc0 50 72 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 PrevTrunk ){.
30bd0 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 memcpy(
30be0 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
30bf0 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 2], &pTrunk->aDa
30c00 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[0], 4);.
30c10 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
30c20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
30c30 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
30c40 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 PrevTrunk->pDbPa
30c50 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ge);.
30c60 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
30c70 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
30c80 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
30c90 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
30ca0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
30cb0 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 memcpy(&pP
30cc0 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b revTrunk->aData[
30cd0 30 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 0], &pTrunk->aDa
30ce0 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[0], 4);.
30cf0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
30d00 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
30d10 2f 2a 20 54 68 65 20 74 72 75 6e 6b 20 70 61 67 /* The trunk pag
30d20 65 20 69 73 20 72 65 71 75 69 72 65 64 20 62 79 e is required by
30d30 20 74 68 65 20 63 61 6c 6c 65 72 20 62 75 74 20 the caller but
30d40 69 74 20 63 6f 6e 74 61 69 6e 73 20 0a 20 20 20 it contains .
30d50 20 20 20 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 ** pointe
30d60 72 73 20 74 6f 20 66 72 65 65 2d 6c 69 73 74 20 rs to free-list
30d70 6c 65 61 76 65 73 2e 20 54 68 65 20 66 69 72 73 leaves. The firs
30d80 74 20 6c 65 61 66 20 62 65 63 6f 6d 65 73 20 61 t leaf becomes a
30d90 20 74 72 75 6e 6b 0a 20 20 20 20 20 20 20 20 20 trunk.
30da0 20 2a 2a 20 70 61 67 65 20 69 6e 20 74 68 69 73 ** page in this
30db0 20 63 61 73 65 2e 0a 20 20 20 20 20 20 20 20 20 case..
30dc0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 4d 65 */. Me
30dd0 6d 50 61 67 65 20 2a 70 4e 65 77 54 72 75 6e 6b mPage *pNewTrunk
30de0 3b 0a 20 20 20 20 20 20 20 20 20 20 50 67 6e 6f ;. Pgno
30df0 20 69 4e 65 77 54 72 75 6e 6b 20 3d 20 67 65 74 iNewTrunk = get
30e00 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
30e10 44 61 74 61 5b 38 5d 29 3b 0a 20 20 20 20 20 20 Data[8]);.
30e20 20 20 20 20 69 66 28 20 69 4e 65 77 54 72 75 6e if( iNewTrun
30e30 6b 3e 6d 78 50 61 67 65 20 29 7b 20 0a 20 20 20 k>mxPage ){ .
30e40 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
30e50 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
30e60 54 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 T;. g
30e70 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
30e80 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
30e90 20 7d 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 }. tes
30ea0 74 63 61 73 65 28 20 69 4e 65 77 54 72 75 6e 6b tcase( iNewTrunk
30eb0 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 ==mxPage );.
30ec0 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 rc = btree
30ed0 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 GetUnusedPage(pB
30ee0 74 2c 20 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 t, iNewTrunk, &p
30ef0 4e 65 77 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 NewTrunk, 0);.
30f00 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
30f10 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
30f20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
30f30 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
30f40 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
30f50 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
30f60 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 4e te3PagerWrite(pN
30f70 65 77 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 ewTrunk->pDbPage
30f80 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
30f90 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
30fa0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 {. re
30fb0 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 54 72 leasePage(pNewTr
30fc0 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 unk);.
30fd0 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
30fe0 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
30ff0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
31000 6d 65 6d 63 70 79 28 26 70 4e 65 77 54 72 75 6e memcpy(&pNewTrun
31010 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 k->aData[0], &pT
31020 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 runk->aData[0],
31030 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 75 4);. pu
31040 74 34 62 79 74 65 28 26 70 4e 65 77 54 72 75 6e t4byte(&pNewTrun
31050 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 k->aData[4], k-1
31060 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d );. mem
31070 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e cpy(&pNewTrunk->
31080 61 44 61 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e aData[8], &pTrun
31090 6b 2d 3e 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b k->aData[12], (k
310a0 2d 31 29 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 -1)*4);.
310b0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e releasePage(pN
310c0 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
310d0 20 20 20 20 69 66 28 20 21 70 50 72 65 76 54 72 if( !pPrevTr
310e0 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 unk ){.
310f0 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
31100 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
31110 6c 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 le(pPage1->pDbPa
31120 67 65 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 ge) );.
31130 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
31140 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 ge1->aData[32],
31150 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 iNewTrunk);.
31160 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
31170 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
31180 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
31190 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 pPrevTrunk->pDbP
311a0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
311b0 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
311c0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
311d0 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
311e0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a ;. }.
311f0 20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 put4
31200 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b byte(&pPrevTrunk
31210 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 ->aData[0], iNew
31220 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 Trunk);.
31230 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
31240 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 pTrunk = 0
31250 3b 0a 20 20 20 20 20 20 20 20 54 52 41 43 45 28 ;. TRACE(
31260 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 ("ALLOCATE: %d t
31270 72 75 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 runk - %d free p
31280 61 67 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 ages left\n", *p
31290 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e Pgno, n-1));.#en
312a0 64 69 66 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 dif. }else
312b0 69 66 28 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 if( k>0 ){.
312c0 20 20 20 2f 2a 20 45 78 74 72 61 63 74 20 61 20 /* Extract a
312d0 6c 65 61 66 20 66 72 6f 6d 20 74 68 65 20 74 72 leaf from the tr
312e0 75 6e 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 unk */. u
312f0 33 32 20 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 32 closest;.
31300 20 20 20 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a Pgno iPage;.
31310 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 unsigned
31320 20 63 68 61 72 20 2a 61 44 61 74 61 20 3d 20 70 char *aData = p
31330 54 72 75 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 Trunk->aData;.
31340 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 if( nearby
31350 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 >0 ){.
31360 75 33 32 20 69 3b 0a 20 20 20 20 20 20 20 20 20 u32 i;.
31370 20 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 closest = 0;.
31380 20 20 20 20 20 20 20 20 69 66 28 20 65 4d 6f 64 if( eMod
31390 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b e==BTALLOC_LE ){
313a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 . for
313b0 28 69 3d 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b (i=0; i<k; i++){
313c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 . i
313d0 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
313e0 26 61 44 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a &aData[8+i*4]);.
313f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 if
31400 28 20 69 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 ( iPage<=nearby
31410 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
31420 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a closest = i;.
31430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31440 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 break;.
31450 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
31460 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d }. }
31470 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
31480 20 20 69 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 int dist;.
31490 20 20 20 20 20 20 20 20 64 69 73 74 20 3d 20 73 dist = s
314a0 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 67 qlite3AbsInt32(g
314b0 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 et4byte(&aData[8
314c0 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 ]) - nearby);.
314d0 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
314e0 31 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 1; i<k; i++){.
314f0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
31500 64 32 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 d2 = sqlite3AbsI
31510 6e 74 33 32 28 67 65 74 34 62 79 74 65 28 26 61 nt32(get4byte(&a
31520 44 61 74 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e Data[8+i*4]) - n
31530 65 61 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 earby);.
31540 20 20 20 20 20 20 69 66 28 20 64 32 3c 64 69 73 if( d2<dis
31550 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
31560 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 closest = i
31570 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;.
31580 20 20 64 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 dist = d2;.
31590 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
315a0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
315b0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
315c0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
315d0 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 closest = 0;.
315e0 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 }..
315f0 69 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 iPage = get4byte
31600 28 26 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 (&aData[8+closes
31610 74 2a 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 t*4]);. t
31620 65 73 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d estcase( iPage==
31630 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
31640 20 20 69 66 28 20 69 50 61 67 65 3e 6d 78 50 61 if( iPage>mxPa
31650 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ge ){.
31660 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
31670 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
31680 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
31690 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
316a0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 74 65 }. te
316b0 73 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d stcase( iPage==m
316c0 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 xPage );.
316d0 20 69 66 28 20 21 73 65 61 72 63 68 4c 69 73 74 if( !searchList
316e0 20 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 28 69 . || (i
316f0 50 61 67 65 3d 3d 6e 65 61 72 62 79 20 7c 7c 20 Page==nearby ||
31700 28 69 50 61 67 65 3c 6e 65 61 72 62 79 20 26 26 (iPage<nearby &&
31710 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f eMode==BTALLOC_
31720 4c 45 29 29 20 0a 20 20 20 20 20 20 20 20 29 7b LE)) . ){
31730 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6e . int n
31740 6f 43 6f 6e 74 65 6e 74 3b 0a 20 20 20 20 20 20 oContent;.
31750 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 69 50 61 *pPgno = iPa
31760 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 54 52 ge;. TR
31770 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 ACE(("ALLOCATE:
31780 25 64 20 77 61 73 20 6c 65 61 66 20 25 64 20 6f %d was leaf %d o
31790 66 20 25 64 20 6f 6e 20 74 72 75 6e 6b 20 25 64 f %d on trunk %d
317a0 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ".
317b0 20 20 20 22 3a 20 25 64 20 6d 6f 72 65 20 66 72 ": %d more fr
317c0 65 65 20 70 61 67 65 73 5c 6e 22 2c 0a 20 20 20 ee pages\n",.
317d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 *p
317e0 50 67 6e 6f 2c 20 63 6c 6f 73 65 73 74 2b 31 2c Pgno, closest+1,
317f0 20 6b 2c 20 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f k, pTrunk->pgno
31800 2c 20 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 , n-1));.
31810 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
31820 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b agerWrite(pTrunk
31830 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
31840 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 if( rc ) g
31850 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
31860 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
31870 20 69 66 28 20 63 6c 6f 73 65 73 74 3c 6b 2d 31 if( closest<k-1
31880 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
31890 6d 65 6d 63 70 79 28 26 61 44 61 74 61 5b 38 2b memcpy(&aData[8+
318a0 63 6c 6f 73 65 73 74 2a 34 5d 2c 20 26 61 44 61 closest*4], &aDa
318b0 74 61 5b 34 2b 6b 2a 34 5d 2c 20 34 29 3b 0a 20 ta[4+k*4], 4);.
318c0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
318d0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 61 put4byte(&a
318e0 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 Data[4], k-1);.
318f0 20 20 20 20 20 20 20 20 20 6e 6f 43 6f 6e 74 65 noConte
31900 6e 74 20 3d 20 21 62 74 72 65 65 47 65 74 48 61 nt = !btreeGetHa
31910 73 43 6f 6e 74 65 6e 74 28 70 42 74 2c 20 2a 70 sContent(pBt, *p
31920 50 67 6e 6f 29 3f 20 50 41 47 45 52 5f 47 45 54 Pgno)? PAGER_GET
31930 5f 4e 4f 43 4f 4e 54 45 4e 54 20 3a 20 30 3b 0a _NOCONTENT : 0;.
31940 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 rc = b
31950 74 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 treeGetUnusedPag
31960 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 e(pBt, *pPgno, p
31970 70 50 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e 74 pPage, noContent
31980 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
31990 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
319a0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 {. rc
319b0 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
319c0 72 69 74 65 28 28 2a 70 70 50 61 67 65 29 2d 3e rite((*ppPage)->
319d0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
319e0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
319f0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
31a00 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 release
31a10 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 Page(*ppPage);.
31a20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 70 *pp
31a30 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 Page = 0;.
31a40 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
31a50 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 73 65 }. se
31a60 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 0a 20 20 archList = 0;.
31a70 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
31a80 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
31a90 65 28 70 50 72 65 76 54 72 75 6e 6b 29 3b 0a 20 e(pPrevTrunk);.
31aa0 20 20 20 20 20 70 50 72 65 76 54 72 75 6e 6b 20 pPrevTrunk
31ab0 3d 20 30 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 = 0;. }while(
31ac0 20 73 65 61 72 63 68 4c 69 73 74 20 29 3b 0a 20 searchList );.
31ad0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 }else{. /* T
31ae0 68 65 72 65 20 61 72 65 20 6e 6f 20 70 61 67 65 here are no page
31af0 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 s on the freelis
31b00 74 2c 20 73 6f 20 61 70 70 65 6e 64 20 61 20 6e t, so append a n
31b10 65 77 20 70 61 67 65 20 74 6f 20 74 68 65 0a 20 ew page to the.
31b20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 ** database i
31b30 6d 61 67 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 mage.. **.
31b40 20 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 65 ** Normally, ne
31b50 77 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 w pages allocate
31b60 64 20 62 79 20 74 68 69 73 20 62 6c 6f 63 6b 20 d by this block
31b70 63 61 6e 20 62 65 20 72 65 71 75 65 73 74 65 64 can be requested
31b80 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 2a 2a from the. **
31b90 20 70 61 67 65 72 20 6c 61 79 65 72 20 77 69 74 pager layer wit
31ba0 68 20 74 68 65 20 27 6e 6f 2d 63 6f 6e 74 65 6e h the 'no-conten
31bb0 74 27 20 66 6c 61 67 20 73 65 74 2e 20 54 68 69 t' flag set. Thi
31bc0 73 20 70 72 65 76 65 6e 74 73 20 74 68 65 20 70 s prevents the p
31bd0 61 67 65 72 0a 20 20 20 20 2a 2a 20 66 72 6f 6d ager. ** from
31be0 20 74 72 79 69 6e 67 20 74 6f 20 72 65 61 64 20 trying to read
31bf0 74 68 65 20 70 61 67 65 73 20 63 6f 6e 74 65 6e the pages conten
31c00 74 20 66 72 6f 6d 20 64 69 73 6b 2e 20 48 6f 77 t from disk. How
31c10 65 76 65 72 2c 20 69 66 20 74 68 65 0a 20 20 20 ever, if the.
31c20 20 2a 2a 20 63 75 72 72 65 6e 74 20 74 72 61 6e ** current tran
31c30 73 61 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 saction has alre
31c40 61 64 79 20 72 75 6e 20 6f 6e 65 20 6f 72 20 6d ady run one or m
31c50 6f 72 65 20 69 6e 63 72 65 6d 65 6e 74 61 6c 2d ore incremental-
31c60 76 61 63 75 75 6d 0a 20 20 20 20 2a 2a 20 73 74 vacuum. ** st
31c70 65 70 73 2c 20 74 68 65 6e 20 74 68 65 20 70 61 eps, then the pa
31c80 67 65 20 77 65 20 61 72 65 20 61 62 6f 75 74 20 ge we are about
31c90 74 6f 20 61 6c 6c 6f 63 61 74 65 20 6d 61 79 20 to allocate may
31ca0 63 6f 6e 74 61 69 6e 20 63 6f 6e 74 65 6e 74 0a contain content.
31cb0 20 20 20 20 2a 2a 20 74 68 61 74 20 69 73 20 72 ** that is r
31cc0 65 71 75 69 72 65 64 20 69 6e 20 74 68 65 20 65 equired in the e
31cd0 76 65 6e 74 20 6f 66 20 61 20 72 6f 6c 6c 62 61 vent of a rollba
31ce0 63 6b 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ck. In this case
31cf0 2c 20 64 6f 0a 20 20 20 20 2a 2a 20 6e 6f 74 20 , do. ** not
31d00 73 65 74 20 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 set the no-conte
31d10 6e 74 20 66 6c 61 67 2e 20 54 68 69 73 20 63 61 nt flag. This ca
31d20 75 73 65 73 20 74 68 65 20 70 61 67 65 72 20 74 uses the pager t
31d30 6f 20 6c 6f 61 64 20 61 6e 64 20 6a 6f 75 72 6e o load and journ
31d40 61 6c 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 75 al. ** the cu
31d50 72 72 65 6e 74 20 70 61 67 65 20 63 6f 6e 74 65 rrent page conte
31d60 6e 74 20 62 65 66 6f 72 65 20 6f 76 65 72 77 72 nt before overwr
31d70 69 74 69 6e 67 20 69 74 2e 0a 20 20 20 20 2a 2a iting it.. **
31d80 0a 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 . ** Note tha
31d90 74 20 74 68 65 20 70 61 67 65 72 20 77 69 6c 6c t the pager will
31da0 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 61 74 not actually at
31db0 74 65 6d 70 74 20 74 6f 20 6c 6f 61 64 20 6f 72 tempt to load or
31dc0 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 20 20 2a 2a journal . **
31dd0 20 63 6f 6e 74 65 6e 74 20 66 6f 72 20 61 6e 79 content for any
31de0 20 70 61 67 65 20 74 68 61 74 20 72 65 61 6c 6c page that reall
31df0 79 20 64 6f 65 73 20 6c 69 65 20 70 61 73 74 20 y does lie past
31e00 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 the end of the d
31e10 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 atabase. ** f
31e20 69 6c 65 20 6f 6e 20 64 69 73 6b 2e 20 53 6f 20 ile on disk. So
31e30 74 68 65 20 65 66 66 65 63 74 73 20 6f 66 20 64 the effects of d
31e40 69 73 61 62 6c 69 6e 67 20 74 68 65 20 6e 6f 2d isabling the no-
31e50 63 6f 6e 74 65 6e 74 20 6f 70 74 69 6d 69 7a 61 content optimiza
31e60 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 68 65 72 65 tion. ** here
31e70 20 61 72 65 20 63 6f 6e 66 69 6e 65 64 20 74 6f are confined to
31e80 20 74 68 6f 73 65 20 70 61 67 65 73 20 74 68 61 those pages tha
31e90 74 20 6c 69 65 20 62 65 74 77 65 65 6e 20 74 68 t lie between th
31ea0 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 e end of the.
31eb0 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 ** database ima
31ec0 67 65 20 61 6e 64 20 74 68 65 20 65 6e 64 20 6f ge and the end o
31ed0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
31ee0 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ile.. */.
31ef0 69 6e 74 20 62 4e 6f 43 6f 6e 74 65 6e 74 20 3d int bNoContent =
31f00 20 28 30 3d 3d 49 66 4e 6f 74 4f 6d 69 74 41 56 (0==IfNotOmitAV
31f10 28 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 (pBt->bDoTruncat
31f20 65 29 29 3f 20 50 41 47 45 52 5f 47 45 54 5f 4e e))? PAGER_GET_N
31f30 4f 43 4f 4e 54 45 4e 54 3a 30 3b 0a 0a 20 20 20 OCONTENT:0;..
31f40 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
31f50 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 erWrite(pBt->pPa
31f60 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
31f70 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
31f80 72 6e 20 72 63 3b 0a 20 20 20 20 70 42 74 2d 3e rn rc;. pBt->
31f90 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 69 66 28 nPage++;. if(
31fa0 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e pBt->nPage==PEN
31fb0 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 DING_BYTE_PAGE(p
31fc0 42 74 29 20 29 20 70 42 74 2d 3e 6e 50 61 67 65 Bt) ) pBt->nPage
31fd0 2b 2b 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ++;..#ifndef SQL
31fe0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
31ff0 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 74 2d UUM. if( pBt-
32000 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 26 20 50 >autoVacuum && P
32010 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
32020 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 20 29 7b , pBt->nPage) ){
32030 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 2a 70 50 . /* If *pP
32040 67 6e 6f 20 72 65 66 65 72 73 20 74 6f 20 61 20 gno refers to a
32050 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 pointer-map page
32060 2c 20 61 6c 6c 6f 63 61 74 65 20 74 77 6f 20 6e , allocate two n
32070 65 77 20 70 61 67 65 73 0a 20 20 20 20 20 20 2a ew pages. *
32080 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 * at the end of
32090 74 68 65 20 66 69 6c 65 20 69 6e 73 74 65 61 64 the file instead
320a0 20 6f 66 20 6f 6e 65 2e 20 54 68 65 20 66 69 72 of one. The fir
320b0 73 74 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 st allocated pag
320c0 65 0a 20 20 20 20 20 20 2a 2a 20 62 65 63 6f 6d e. ** becom
320d0 65 73 20 61 20 6e 65 77 20 70 6f 69 6e 74 65 72 es a new pointer
320e0 2d 6d 61 70 20 70 61 67 65 2c 20 74 68 65 20 73 -map page, the s
320f0 65 63 6f 6e 64 20 69 73 20 75 73 65 64 20 62 79 econd is used by
32100 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 20 20 20 the caller..
32110 20 20 20 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 */. MemP
32120 61 67 65 20 2a 70 50 67 20 3d 20 30 3b 0a 20 20 age *pPg = 0;.
32130 20 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f TRACE(("ALLO
32140 43 41 54 45 3a 20 25 64 20 66 72 6f 6d 20 65 6e CATE: %d from en
32150 64 20 6f 66 20 66 69 6c 65 20 28 70 6f 69 6e 74 d of file (point
32160 65 72 2d 6d 61 70 20 70 61 67 65 29 5c 6e 22 2c er-map page)\n",
32170 20 70 42 74 2d 3e 6e 50 61 67 65 29 29 3b 0a 20 pBt->nPage));.
32180 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 assert( pBt
32190 2d 3e 6e 50 61 67 65 21 3d 50 45 4e 44 49 4e 47 ->nPage!=PENDING
321a0 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
321b0 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 );. rc = bt
321c0 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 reeGetUnusedPage
321d0 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 65 (pBt, pBt->nPage
321e0 2c 20 26 70 50 67 2c 20 62 4e 6f 43 6f 6e 74 65 , &pPg, bNoConte
321f0 6e 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 nt);. if( r
32200 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
32210 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
32220 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
32230 50 67 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 Pg->pDbPage);.
32240 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
32250 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a e(pPg);. }.
32260 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 if( rc ) r
32270 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
32280 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 pBt->nPage++;.
32290 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 if( pBt->nPa
322a0 67 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 ge==PENDING_BYTE
322b0 5f 50 41 47 45 28 70 42 74 29 20 29 7b 20 70 42 _PAGE(pBt) ){ pB
322c0 74 2d 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 20 t->nPage++; }.
322d0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 }.#endif. p
322e0 75 74 34 62 79 74 65 28 32 38 20 2b 20 28 75 38 ut4byte(28 + (u8
322f0 2a 29 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 *)pBt->pPage1->a
32300 44 61 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 65 Data, pBt->nPage
32310 29 3b 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 );. *pPgno =
32320 70 42 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 20 pBt->nPage;..
32330 20 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 assert( *pPgno!
32340 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 =PENDING_BYTE_PA
32350 47 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 72 GE(pBt) );. r
32360 63 20 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 c = btreeGetUnus
32370 65 64 50 61 67 65 28 70 42 74 2c 20 2a 70 50 67 edPage(pBt, *pPg
32380 6e 6f 2c 20 70 70 50 61 67 65 2c 20 62 4e 6f 43 no, ppPage, bNoC
32390 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 69 66 28 ontent);. if(
323a0 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
323b0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
323c0 33 50 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 3PagerWrite((*pp
323d0 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b Page)->pDbPage);
323e0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
323f0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
32400 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
32410 61 67 65 29 3b 0a 20 20 20 20 20 20 2a 70 70 50 age);. *ppP
32420 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 age = 0;. }.
32430 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 TRACE(("ALLOC
32440 41 54 45 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 ATE: %d from end
32450 20 6f 66 20 66 69 6c 65 5c 6e 22 2c 20 2a 70 50 of file\n", *pP
32460 67 6e 6f 29 29 3b 0a 20 20 7d 0a 0a 20 20 61 73 gno));. }.. as
32470 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 3d 50 45 sert( *pPgno!=PE
32480 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
32490 70 42 74 29 20 29 3b 0a 0a 65 6e 64 5f 61 6c 6c pBt) );..end_all
324a0 6f 63 61 74 65 5f 70 61 67 65 3a 0a 20 20 72 65 ocate_page:. re
324b0 6c 65 61 73 65 50 61 67 65 28 70 54 72 75 6e 6b leasePage(pTrunk
324c0 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 );. releasePage
324d0 28 70 50 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 (pPrevTrunk);.
324e0 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
324f0 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 74 65 33 TE_OK || sqlite3
32500 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e PagerPageRefcoun
32510 74 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 t((*ppPage)->pDb
32520 50 61 67 65 29 3c 3d 31 20 29 3b 0a 20 20 61 73 Page)<=1 );. as
32530 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
32540 5f 4f 4b 20 7c 7c 20 28 2a 70 70 50 61 67 65 29 _OK || (*ppPage)
32550 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 ->isInit==0 );.
32560 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
32570 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
32580 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 on is used to ad
32590 64 20 70 61 67 65 20 69 50 61 67 65 20 74 6f 20 d page iPage to
325a0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
325b0 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 0a 2a 2a e free-list. .**
325c0 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 It is assumed t
325d0 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 hat the page is
325e0 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 70 61 not already a pa
325f0 72 74 20 6f 66 20 74 68 65 20 66 72 65 65 2d 6c rt of the free-l
32600 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 ist..**.** The v
32610 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 20 74 alue passed as t
32620 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
32630 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 nt to this funct
32640 69 6f 6e 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e ion is optional.
32650 0a 2a 2a 20 49 66 20 74 68 65 20 63 61 6c 6c 65 .** If the calle
32660 72 20 68 61 70 70 65 6e 73 20 74 6f 20 68 61 76 r happens to hav
32670 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 e a pointer to t
32680 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 63 he MemPage objec
32690 74 20 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 t .** correspond
326a0 69 6e 67 20 74 6f 20 70 61 67 65 20 69 50 61 67 ing to page iPag
326b0 65 20 68 61 6e 64 79 2c 20 69 74 20 6d 61 79 20 e handy, it may
326c0 70 61 73 73 20 69 74 20 61 73 20 74 68 65 20 73 pass it as the s
326d0 65 63 6f 6e 64 20 76 61 6c 75 65 2e 20 0a 2a 2a econd value. .**
326e0 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 6d Otherwise, it m
326f0 61 79 20 70 61 73 73 20 4e 55 4c 4c 2e 0a 2a 2a ay pass NULL..**
32700 0a 2a 2a 20 49 66 20 61 20 70 6f 69 6e 74 65 72 .** If a pointer
32710 20 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 6f 62 to a MemPage ob
32720 6a 65 63 74 20 69 73 20 70 61 73 73 65 64 20 61 ject is passed a
32730 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 s the second arg
32740 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 73 20 72 65 ument,.** its re
32750 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 69 73 ference count is
32760 20 6e 6f 74 20 61 6c 74 65 72 65 64 20 62 79 20 not altered by
32770 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a this function..*
32780 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 /.static int fre
32790 65 50 61 67 65 32 28 42 74 53 68 61 72 65 64 20 ePage2(BtShared
327a0 2a 70 42 74 2c 20 4d 65 6d 50 61 67 65 20 2a 70 *pBt, MemPage *p
327b0 4d 65 6d 50 61 67 65 2c 20 50 67 6e 6f 20 69 50 MemPage, Pgno iP
327c0 61 67 65 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 age){. MemPage
327d0 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 *pTrunk = 0;
327e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
327f0 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
32800 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 54 age */. Pgno iT
32810 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 runk = 0;
32820 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
32830 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 Page number of f
32840 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
32850 61 67 65 20 2a 2f 20 0a 20 20 4d 65 6d 50 61 67 age */ . MemPag
32860 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 2d e *pPage1 = pBt-
32870 3e 70 50 61 67 65 31 3b 20 20 20 20 20 20 2f 2a >pPage1; /*
32880 20 4c 6f 63 61 6c 20 72 65 66 65 72 65 6e 63 65 Local reference
32890 20 74 6f 20 70 61 67 65 20 31 20 2a 2f 0a 20 20 to page 1 */.
328a0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 20 MemPage *pPage;
328b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
328c0 20 20 20 20 2f 2a 20 50 61 67 65 20 62 65 69 6e /* Page bein
328d0 67 20 66 72 65 65 64 2e 20 4d 61 79 20 62 65 20 g freed. May be
328e0 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 6e 74 20 72 NULL. */. int r
328f0 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
32900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
32910 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f * Return Code */
32920 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b 20 20 20 . int nFree;
32930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32940 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 /* Initia
32950 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 l number of page
32960 73 20 6f 6e 20 66 72 65 65 2d 6c 69 73 74 20 2a s on free-list *
32970 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c /.. assert( sql
32980 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
32990 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
329a0 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 assert( CORRUPT
329b0 5f 44 42 20 7c 7c 20 69 50 61 67 65 3e 31 20 29 _DB || iPage>1 )
329c0 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 4d 65 ;. assert( !pMe
329d0 6d 50 61 67 65 20 7c 7c 20 70 4d 65 6d 50 61 67 mPage || pMemPag
329e0 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 67 65 20 29 e->pgno==iPage )
329f0 3b 0a 0a 20 20 69 66 28 20 69 50 61 67 65 3c 32 ;.. if( iPage<2
32a00 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
32a10 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
32a20 20 69 66 28 20 70 4d 65 6d 50 61 67 65 20 29 7b if( pMemPage ){
32a30 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 4d 65 . pPage = pMe
32a40 6d 50 61 67 65 3b 0a 20 20 20 20 73 71 6c 69 74 mPage;. sqlit
32a50 65 33 50 61 67 65 72 52 65 66 28 70 50 61 67 65 e3PagerRef(pPage
32a60 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 7d 65 ->pDbPage);. }e
32a70 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 65 20 3d lse{. pPage =
32a80 20 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 btreePageLookup
32a90 28 70 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 (pBt, iPage);.
32aa0 7d 0a 0a 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e }.. /* Incremen
32ab0 74 20 74 68 65 20 66 72 65 65 20 70 61 67 65 20 t the free page
32ac0 63 6f 75 6e 74 20 6f 6e 20 70 50 61 67 65 31 20 count on pPage1
32ad0 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
32ae0 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 3PagerWrite(pPag
32af0 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e1->pDbPage);.
32b00 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 66 72 if( rc ) goto fr
32b10 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 6e 46 eepage_out;. nF
32b20 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 ree = get4byte(&
32b30 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
32b40 5d 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 ]);. put4byte(&
32b50 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
32b60 5d 2c 20 6e 46 72 65 65 2b 31 29 3b 0a 0a 20 20 ], nFree+1);..
32b70 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 if( pBt->btsFlag
32b80 73 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 s & BTS_SECURE_D
32b90 45 4c 45 54 45 20 29 7b 0a 20 20 20 20 2f 2a 20 ELETE ){. /*
32ba0 49 66 20 74 68 65 20 73 65 63 75 72 65 5f 64 65 If the secure_de
32bb0 6c 65 74 65 20 6f 70 74 69 6f 6e 20 69 73 20 65 lete option is e
32bc0 6e 61 62 6c 65 64 2c 20 74 68 65 6e 0a 20 20 20 nabled, then.
32bd0 20 2a 2a 20 61 6c 77 61 79 73 20 66 75 6c 6c 79 ** always fully
32be0 20 6f 76 65 72 77 72 69 74 65 20 64 65 6c 65 74 overwrite delet
32bf0 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 ed information w
32c00 69 74 68 20 7a 65 72 6f 73 2e 0a 20 20 20 20 2a ith zeros.. *
32c10 2f 0a 20 20 20 20 69 66 28 20 28 21 70 50 61 67 /. if( (!pPag
32c20 65 20 26 26 20 28 28 72 63 20 3d 20 62 74 72 65 e && ((rc = btre
32c30 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 50 eGetPage(pBt, iP
32c40 61 67 65 2c 20 26 70 50 61 67 65 2c 20 30 29 29 age, &pPage, 0))
32c50 21 3d 30 29 20 29 0a 20 20 20 20 20 7c 7c 20 20 !=0) ). ||
32c60 20 20 20 20 20 20 20 20 20 20 28 28 72 63 20 3d ((rc =
32c70 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
32c80 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 te(pPage->pDbPag
32c90 65 29 29 21 3d 30 29 0a 20 20 20 20 29 7b 0a 20 e))!=0). ){.
32ca0 20 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 goto freepa
32cb0 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 ge_out;. }.
32cc0 20 20 6d 65 6d 73 65 74 28 70 50 61 67 65 2d 3e memset(pPage->
32cd0 61 44 61 74 61 2c 20 30 2c 20 70 50 61 67 65 2d aData, 0, pPage-
32ce0 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b >pBt->pageSize);
32cf0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 . }.. /* If th
32d00 65 20 64 61 74 61 62 61 73 65 20 73 75 70 70 6f e database suppo
32d10 72 74 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c rts auto-vacuum,
32d20 20 77 72 69 74 65 20 61 6e 20 65 6e 74 72 79 20 write an entry
32d30 69 6e 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d in the pointer-m
32d40 61 70 0a 20 20 2a 2a 20 74 6f 20 69 6e 64 69 63 ap. ** to indic
32d50 61 74 65 20 74 68 61 74 20 74 68 65 20 70 61 67 ate that the pag
32d60 65 20 69 73 20 66 72 65 65 2e 0a 20 20 2a 2f 0a e is free.. */.
32d70 20 20 69 66 28 20 49 53 41 55 54 4f 56 41 43 55 if( ISAUTOVACU
32d80 55 4d 20 29 7b 0a 20 20 20 20 70 74 72 6d 61 70 UM ){. ptrmap
32d90 50 75 74 28 70 42 74 2c 20 69 50 61 67 65 2c 20 Put(pBt, iPage,
32da0 50 54 52 4d 41 50 5f 46 52 45 45 50 41 47 45 2c PTRMAP_FREEPAGE,
32db0 20 30 2c 20 26 72 63 29 3b 0a 20 20 20 20 69 66 0, &rc);. if
32dc0 28 20 72 63 20 29 20 67 6f 74 6f 20 66 72 65 65 ( rc ) goto free
32dd0 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 page_out;. }..
32de0 20 2f 2a 20 4e 6f 77 20 6d 61 6e 69 70 75 6c 61 /* Now manipula
32df0 74 65 20 74 68 65 20 61 63 74 75 61 6c 20 64 61 te the actual da
32e00 74 61 62 61 73 65 20 66 72 65 65 2d 6c 69 73 74 tabase free-list
32e10 20 73 74 72 75 63 74 75 72 65 2e 20 54 68 65 72 structure. Ther
32e20 65 20 61 72 65 20 74 77 6f 0a 20 20 2a 2a 20 70 e are two. ** p
32e30 6f 73 73 69 62 69 6c 69 74 69 65 73 2e 20 49 66 ossibilities. If
32e40 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 the free-list i
32e50 73 20 63 75 72 72 65 6e 74 6c 79 20 65 6d 70 74 s currently empt
32e60 79 2c 20 6f 72 20 69 66 20 74 68 65 20 66 69 72 y, or if the fir
32e70 73 74 0a 20 20 2a 2a 20 74 72 75 6e 6b 20 70 61 st. ** trunk pa
32e80 67 65 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c ge in the free-l
32e90 69 73 74 20 69 73 20 66 75 6c 6c 2c 20 74 68 65 ist is full, the
32ea0 6e 20 74 68 69 73 20 70 61 67 65 20 77 69 6c 6c n this page will
32eb0 20 62 65 63 6f 6d 65 20 61 0a 20 20 2a 2a 20 6e become a. ** n
32ec0 65 77 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 ew free-list tru
32ed0 6e 6b 20 70 61 67 65 2e 20 4f 74 68 65 72 77 69 nk page. Otherwi
32ee0 73 65 2c 20 69 74 20 77 69 6c 6c 20 62 65 63 6f se, it will beco
32ef0 6d 65 20 61 20 6c 65 61 66 20 6f 66 20 74 68 65 me a leaf of the
32f00 0a 20 20 2a 2a 20 66 69 72 73 74 20 74 72 75 6e . ** first trun
32f10 6b 20 70 61 67 65 20 69 6e 20 74 68 65 20 63 75 k page in the cu
32f20 72 72 65 6e 74 20 66 72 65 65 2d 6c 69 73 74 2e rrent free-list.
32f30 20 54 68 69 73 20 62 6c 6f 63 6b 20 74 65 73 74 This block test
32f40 73 20 69 66 20 69 74 0a 20 20 2a 2a 20 69 73 20 s if it. ** is
32f50 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 possible to add
32f60 74 68 65 20 70 61 67 65 20 61 73 20 61 20 6e 65 the page as a ne
32f70 77 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 w free-list leaf
32f80 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e 46 72 .. */. if( nFr
32f90 65 65 21 3d 30 20 29 7b 0a 20 20 20 20 75 33 32 ee!=0 ){. u32
32fa0 20 6e 4c 65 61 66 3b 20 20 20 20 20 20 20 20 20 nLeaf;
32fb0 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 /* Initia
32fc0 6c 20 6e 75 6d 62 65 72 20 6f 66 20 6c 65 61 66 l number of leaf
32fd0 20 63 65 6c 6c 73 20 6f 6e 20 74 72 75 6e 6b 20 cells on trunk
32fe0 70 61 67 65 20 2a 2f 0a 0a 20 20 20 20 69 54 72 page */.. iTr
32ff0 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 unk = get4byte(&
33000 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 pPage1->aData[32
33010 5d 29 3b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 ]);. rc = btr
33020 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 eeGetPage(pBt, i
33030 54 72 75 6e 6b 2c 20 26 70 54 72 75 6e 6b 2c 20 Trunk, &pTrunk,
33040 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 0);. if( rc!=
33050 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
33060 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 goto freepage
33070 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 _out;. }..
33080 20 6e 4c 65 61 66 20 3d 20 67 65 74 34 62 79 74 nLeaf = get4byt
33090 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 e(&pTrunk->aData
330a0 5b 34 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 [4]);. assert
330b0 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ( pBt->usableSiz
330c0 65 3e 33 32 20 29 3b 0a 20 20 20 20 69 66 28 20 e>32 );. if(
330d0 6e 4c 65 61 66 20 3e 20 28 75 33 32 29 70 42 74 nLeaf > (u32)pBt
330e0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d ->usableSize/4 -
330f0 20 32 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 2 ){. rc =
33100 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
33110 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f BKPT;. goto
33120 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 freepage_out;.
33130 20 20 20 7d 0a 20 20 20 20 69 66 28 20 6e 4c 65 }. if( nLe
33140 61 66 20 3c 20 28 75 33 32 29 70 42 74 2d 3e 75 af < (u32)pBt->u
33150 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 sableSize/4 - 8
33160 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 20 74 ){. /* In t
33170 68 69 73 20 63 61 73 65 20 74 68 65 72 65 20 69 his case there i
33180 73 20 72 6f 6f 6d 20 6f 6e 20 74 68 65 20 74 72 s room on the tr
33190 75 6e 6b 20 70 61 67 65 20 74 6f 20 69 6e 73 65 unk page to inse
331a0 72 74 20 74 68 65 20 70 61 67 65 0a 20 20 20 20 rt the page.
331b0 20 20 2a 2a 20 62 65 69 6e 67 20 66 72 65 65 64 ** being freed
331c0 20 61 73 20 61 20 6e 65 77 20 6c 65 61 66 2e 0a as a new leaf..
331d0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
331e0 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 * Note that the
331f0 74 72 75 6e 6b 20 70 61 67 65 20 69 73 20 6e 6f trunk page is no
33200 74 20 72 65 61 6c 6c 79 20 66 75 6c 6c 20 75 6e t really full un
33210 74 69 6c 20 69 74 20 63 6f 6e 74 61 69 6e 73 0a til it contains.
33220 20 20 20 20 20 20 2a 2a 20 75 73 61 62 6c 65 53 ** usableS
33230 69 7a 65 2f 34 20 2d 20 32 20 65 6e 74 72 69 65 ize/4 - 2 entrie
33240 73 2c 20 6e 6f 74 20 75 73 61 62 6c 65 53 69 7a s, not usableSiz
33250 65 2f 34 20 2d 20 38 20 65 6e 74 72 69 65 73 20 e/4 - 8 entries
33260 61 73 20 77 65 20 68 61 76 65 0a 20 20 20 20 20 as we have.
33270 20 2a 2a 20 63 6f 64 65 64 2e 20 20 42 75 74 20 ** coded. But
33280 64 75 65 20 74 6f 20 61 20 63 6f 64 69 6e 67 20 due to a coding
33290 65 72 72 6f 72 20 69 6e 20 76 65 72 73 69 6f 6e error in version
332a0 73 20 6f 66 20 53 51 4c 69 74 65 20 70 72 69 6f s of SQLite prio
332b0 72 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 33 2e r to. ** 3.
332c0 36 2e 30 2c 20 64 61 74 61 62 61 73 65 73 20 77 6.0, databases w
332d0 69 74 68 20 66 72 65 65 6c 69 73 74 20 74 72 75 ith freelist tru
332e0 6e 6b 20 70 61 67 65 73 20 68 6f 6c 64 69 6e 67 nk pages holding
332f0 20 6d 6f 72 65 20 74 68 61 6e 0a 20 20 20 20 20 more than.
33300 20 2a 2a 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 ** usableSize/4
33310 20 2d 20 38 20 65 6e 74 72 69 65 73 20 77 69 6c - 8 entries wil
33320 6c 20 62 65 20 72 65 70 6f 72 74 65 64 20 61 73 l be reported as
33330 20 63 6f 72 72 75 70 74 2e 20 20 49 6e 20 6f 72 corrupt. In or
33340 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 der. ** to
33350 6d 61 69 6e 74 61 69 6e 20 62 61 63 6b 77 61 72 maintain backwar
33360 64 73 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 ds compatibility
33370 20 77 69 74 68 20 6f 6c 64 65 72 20 76 65 72 73 with older vers
33380 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2c 0a ions of SQLite,.
33390 20 20 20 20 20 20 2a 2a 20 77 65 20 77 69 6c 6c ** we will
333a0 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 72 65 73 continue to res
333b0 74 72 69 63 74 20 74 68 65 20 6e 75 6d 62 65 72 trict the number
333c0 20 6f 66 20 65 6e 74 72 69 65 73 20 74 6f 20 75 of entries to u
333d0 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 0a sableSize/4 - 8.
333e0 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 6e 6f 77 ** for now
333f0 2e 20 20 41 74 20 73 6f 6d 65 20 70 6f 69 6e 74 . At some point
33400 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 20 28 in the future (
33410 6f 6e 63 65 20 65 76 65 72 79 6f 6e 65 20 68 61 once everyone ha
33420 73 20 75 70 67 72 61 64 65 64 0a 20 20 20 20 20 s upgraded.
33430 20 2a 2a 20 74 6f 20 33 2e 36 2e 30 20 6f 72 20 ** to 3.6.0 or
33440 6c 61 74 65 72 29 20 77 65 20 73 68 6f 75 6c 64 later) we should
33450 20 63 6f 6e 73 69 64 65 72 20 66 69 78 69 6e 67 consider fixing
33460 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 61 6c the conditional
33470 20 61 62 6f 76 65 0a 20 20 20 20 20 20 2a 2a 20 above. **
33480 74 6f 20 72 65 61 64 20 22 75 73 61 62 6c 65 53 to read "usableS
33490 69 7a 65 2f 34 2d 32 22 20 69 6e 73 74 65 61 64 ize/4-2" instead
334a0 20 6f 66 20 22 75 73 61 62 6c 65 53 69 7a 65 2f of "usableSize/
334b0 34 2d 38 22 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 4-8".. **.
334c0 20 20 20 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 ** EVIDENCE
334d0 2d 4f 46 3a 20 52 2d 31 39 39 32 30 2d 31 31 35 -OF: R-19920-115
334e0 37 36 20 48 6f 77 65 76 65 72 2c 20 6e 65 77 65 76 However, newe
334f0 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 r versions of SQ
33500 4c 69 74 65 20 73 74 69 6c 6c 0a 20 20 20 20 20 Lite still.
33510 20 2a 2a 20 61 76 6f 69 64 20 75 73 69 6e 67 20 ** avoid using
33520 74 68 65 20 6c 61 73 74 20 73 69 78 20 65 6e 74 the last six ent
33530 72 69 65 73 20 69 6e 20 74 68 65 20 66 72 65 65 ries in the free
33540 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 list trunk page
33550 61 72 72 61 79 20 69 6e 0a 20 20 20 20 20 20 2a array in. *
33560 2a 20 6f 72 64 65 72 20 74 68 61 74 20 64 61 74 * order that dat
33570 61 62 61 73 65 20 66 69 6c 65 73 20 63 72 65 61 abase files crea
33580 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 65 72 ted by newer ver
33590 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 sions of SQLite
335a0 63 61 6e 20 62 65 0a 20 20 20 20 20 20 2a 2a 20 can be. **
335b0 72 65 61 64 20 62 79 20 6f 6c 64 65 72 20 76 65 read by older ve
335c0 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 rsions of SQLite
335d0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
335e0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
335f0 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e erWrite(pTrunk->
33600 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
33610 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
33620 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 75 74 K ){. put
33630 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
33640 44 61 74 61 5b 34 5d 2c 20 6e 4c 65 61 66 2b 31 Data[4], nLeaf+1
33650 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 );. put4b
33660 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
33670 74 61 5b 38 2b 6e 4c 65 61 66 2a 34 5d 2c 20 69 ta[8+nLeaf*4], i
33680 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 Page);. i
33690 66 28 20 70 50 61 67 65 20 26 26 20 28 70 42 74 f( pPage && (pBt
336a0 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
336b0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 3d _SECURE_DELETE)=
336c0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
336d0 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 sqlite3PagerDont
336e0 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 Write(pPage->pDb
336f0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d Page);. }
33700 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 . rc = bt
33710 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 6e 74 reeSetHasContent
33720 28 70 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 (pBt, iPage);.
33730 20 20 20 20 7d 0a 20 20 20 20 20 20 54 52 41 43 }. TRAC
33740 45 28 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 E(("FREE-PAGE: %
33750 64 20 6c 65 61 66 20 6f 6e 20 74 72 75 6e 6b 20 d leaf on trunk
33760 70 61 67 65 20 25 64 5c 6e 22 2c 70 50 61 67 65 page %d\n",pPage
33770 2d 3e 70 67 6e 6f 2c 70 54 72 75 6e 6b 2d 3e 70 ->pgno,pTrunk->p
33780 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 67 6f 74 gno));. got
33790 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
337a0 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
337b0 49 66 20 63 6f 6e 74 72 6f 6c 20 66 6c 6f 77 73 If control flows
337c0 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 to this point,
337d0 74 68 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 20 then it was not
337e0 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 possible to add
337f0 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 the. ** the pag
33800 65 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 e being freed as
33810 20 61 20 6c 65 61 66 20 70 61 67 65 20 6f 66 20 a leaf page of
33820 74 68 65 20 66 69 72 73 74 20 74 72 75 6e 6b 20 the first trunk
33830 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 in the free-list
33840 2e 0a 20 20 2a 2a 20 50 6f 73 73 69 62 6c 79 20 .. ** Possibly
33850 62 65 63 61 75 73 65 20 74 68 65 20 66 72 65 65 because the free
33860 2d 6c 69 73 74 20 69 73 20 65 6d 70 74 79 2c 20 -list is empty,
33870 6f 72 20 70 6f 73 73 69 62 6c 79 20 62 65 63 61 or possibly beca
33880 75 73 65 20 74 68 65 20 0a 20 20 2a 2a 20 66 69 use the . ** fi
33890 72 73 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 rst trunk in the
338a0 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 75 free-list is fu
338b0 6c 6c 2e 20 45 69 74 68 65 72 20 77 61 79 2c 20 ll. Either way,
338c0 74 68 65 20 70 61 67 65 20 62 65 69 6e 67 20 66 the page being f
338d0 72 65 65 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 reed. ** will b
338e0 65 63 6f 6d 65 20 74 68 65 20 6e 65 77 20 66 69 ecome the new fi
338f0 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 rst trunk page i
33900 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e n the free-list.
33910 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 . */. if( pPag
33920 65 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f e==0 && SQLITE_O
33930 4b 21 3d 28 72 63 20 3d 20 62 74 72 65 65 47 65 K!=(rc = btreeGe
33940 74 50 61 67 65 28 70 42 74 2c 20 69 50 61 67 65 tPage(pBt, iPage
33950 2c 20 26 70 50 61 67 65 2c 20 30 29 29 20 29 7b , &pPage, 0)) ){
33960 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 . goto freepa
33970 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 72 63 ge_out;. }. rc
33980 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
33990 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 rite(pPage->pDbP
339a0 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d age);. if( rc!=
339b0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
339c0 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
339d0 75 74 3b 0a 20 20 7d 0a 20 20 70 75 74 34 62 79 ut;. }. put4by
339e0 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c te(pPage->aData,
339f0 20 69 54 72 75 6e 6b 29 3b 0a 20 20 70 75 74 34 iTrunk);. put4
33a00 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 byte(&pPage->aDa
33a10 74 61 5b 34 5d 2c 20 30 29 3b 0a 20 20 70 75 74 ta[4], 0);. put
33a20 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
33a30 44 61 74 61 5b 33 32 5d 2c 20 69 50 61 67 65 29 Data[32], iPage)
33a40 3b 0a 20 20 54 52 41 43 45 28 28 22 46 52 45 45 ;. TRACE(("FREE
33a50 2d 50 41 47 45 3a 20 25 64 20 6e 65 77 20 74 72 -PAGE: %d new tr
33a60 75 6e 6b 20 70 61 67 65 20 72 65 70 6c 61 63 69 unk page replaci
33a70 6e 67 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 2d ng %d\n", pPage-
33a80 3e 70 67 6e 6f 2c 20 69 54 72 75 6e 6b 29 29 3b >pgno, iTrunk));
33a90 0a 0a 66 72 65 65 70 61 67 65 5f 6f 75 74 3a 0a ..freepage_out:.
33aa0 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20 if( pPage ){.
33ab0 20 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 pPage->isInit
33ac0 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 = 0;. }. rele
33ad0 61 73 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a asePage(pPage);.
33ae0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 releasePage(pT
33af0 72 75 6e 6b 29 3b 0a 20 20 72 65 74 75 72 6e 20 runk);. return
33b00 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 rc;.}.static voi
33b10 64 20 66 72 65 65 50 61 67 65 28 4d 65 6d 50 61 d freePage(MemPa
33b20 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 2a ge *pPage, int *
33b30 70 52 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 pRC){. if( (*pR
33b40 43 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b C)==SQLITE_OK ){
33b50 0a 20 20 20 20 2a 70 52 43 20 3d 20 66 72 65 65 . *pRC = free
33b60 50 61 67 65 32 28 70 50 61 67 65 2d 3e 70 42 74 Page2(pPage->pBt
33b70 2c 20 70 50 61 67 65 2c 20 70 50 61 67 65 2d 3e , pPage, pPage->
33b80 70 67 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a pgno);. }.}../*
33b90 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 6f 76 65 .** Free any ove
33ba0 72 66 6c 6f 77 20 70 61 67 65 73 20 61 73 73 6f rflow pages asso
33bb0 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 ciated with the
33bc0 67 69 76 65 6e 20 43 65 6c 6c 2e 20 20 57 72 69 given Cell. Wri
33bd0 74 65 20 74 68 65 0a 2a 2a 20 6c 6f 63 61 6c 20 te the.** local
33be0 43 65 6c 6c 20 73 69 7a 65 20 28 74 68 65 20 6e Cell size (the n
33bf0 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f umber of bytes o
33c00 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 n the original p
33c10 61 67 65 2c 20 6f 6d 69 74 74 69 6e 67 0a 2a 2a age, omitting.**
33c20 20 6f 76 65 72 66 6c 6f 77 29 20 69 6e 74 6f 20 overflow) into
33c30 2a 70 6e 53 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 *pnSize..*/.stat
33c40 69 63 20 69 6e 74 20 63 6c 65 61 72 43 65 6c 6c ic int clearCell
33c50 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
33c60 67 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ge, /*
33c70 54 68 65 20 70 61 67 65 20 74 68 61 74 20 63 6f The page that co
33c80 6e 74 61 69 6e 73 20 74 68 65 20 43 65 6c 6c 20 ntains the Cell
33c90 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 */. unsigned ch
33ca0 61 72 20 2a 70 43 65 6c 6c 2c 20 20 20 20 2f 2a ar *pCell, /*
33cb0 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 First byte of t
33cc0 68 65 20 43 65 6c 6c 20 2a 2f 0a 20 20 43 65 6c he Cell */. Cel
33cd0 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 lInfo *pInfo
33ce0 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 69 6e /* Size in
33cf0 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
33d00 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 29 7b 0a 20 the cell */.){.
33d10 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
33d20 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 50 pPage->pBt;. P
33d30 67 6e 6f 20 6f 76 66 6c 50 67 6e 6f 3b 0a 20 20 gno ovflPgno;.
33d40 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 6e 4f int rc;. int nO
33d50 76 66 6c 3b 0a 20 20 75 33 32 20 6f 76 66 6c 50 vfl;. u32 ovflP
33d60 61 67 65 53 69 7a 65 3b 0a 0a 20 20 61 73 73 65 ageSize;.. asse
33d70 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
33d80 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
33d90 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 t->mutex) );. p
33da0 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c Page->xParseCell
33db0 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 (pPage, pCell, p
33dc0 49 6e 66 6f 29 3b 0a 20 20 69 66 28 20 70 49 6e Info);. if( pIn
33dd0 66 6f 2d 3e 6e 4c 6f 63 61 6c 3d 3d 70 49 6e 66 fo->nLocal==pInf
33de0 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 o->nPayload ){.
33df0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
33e00 5f 4f 4b 3b 20 20 2f 2a 20 4e 6f 20 6f 76 65 72 _OK; /* No over
33e10 66 6c 6f 77 20 70 61 67 65 73 2e 20 52 65 74 75 flow pages. Retu
33e20 72 6e 20 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 rn without doing
33e30 20 61 6e 79 74 68 69 6e 67 20 2a 2f 0a 20 20 7d anything */. }
33e40 0a 20 20 69 66 28 20 70 43 65 6c 6c 2b 70 49 6e . if( pCell+pIn
33e50 66 6f 2d 3e 6e 53 69 7a 65 2d 31 20 3e 20 70 50 fo->nSize-1 > pP
33e60 61 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 age->aData+pPage
33e70 2d 3e 6d 61 73 6b 50 61 67 65 20 29 7b 0a 20 20 ->maskPage ){.
33e80 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
33e90 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 20 2f CORRUPT_BKPT; /
33ea0 2a 20 43 65 6c 6c 20 65 78 74 65 6e 64 73 20 70 * Cell extends p
33eb0 61 73 74 20 65 6e 64 20 6f 66 20 70 61 67 65 20 ast end of page
33ec0 2a 2f 0a 20 20 7d 0a 20 20 6f 76 66 6c 50 67 6e */. }. ovflPgn
33ed0 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 43 65 o = get4byte(pCe
33ee0 6c 6c 20 2b 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a ll + pInfo->nSiz
33ef0 65 20 2d 20 34 29 3b 0a 20 20 61 73 73 65 72 74 e - 4);. assert
33f00 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ( pBt->usableSiz
33f10 65 20 3e 20 34 20 29 3b 0a 20 20 6f 76 66 6c 50 e > 4 );. ovflP
33f20 61 67 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 ageSize = pBt->u
33f30 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 sableSize - 4;.
33f40 20 6e 4f 76 66 6c 20 3d 20 28 70 49 6e 66 6f 2d nOvfl = (pInfo-
33f50 3e 6e 50 61 79 6c 6f 61 64 20 2d 20 70 49 6e 66 >nPayload - pInf
33f60 6f 2d 3e 6e 4c 6f 63 61 6c 20 2b 20 6f 76 66 6c o->nLocal + ovfl
33f70 50 61 67 65 53 69 7a 65 20 2d 20 31 29 2f 6f 76 PageSize - 1)/ov
33f80 66 6c 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 flPageSize;. as
33f90 73 65 72 74 28 20 6e 4f 76 66 6c 3e 30 20 7c 7c sert( nOvfl>0 ||
33fa0 20 0a 20 20 20 20 28 43 4f 52 52 55 50 54 5f 44 . (CORRUPT_D
33fb0 42 20 26 26 20 28 70 49 6e 66 6f 2d 3e 6e 50 61 B && (pInfo->nPa
33fc0 79 6c 6f 61 64 20 2b 20 6f 76 66 6c 50 61 67 65 yload + ovflPage
33fd0 53 69 7a 65 29 3c 6f 76 66 6c 50 61 67 65 53 69 Size)<ovflPageSi
33fe0 7a 65 29 0a 20 20 29 3b 0a 20 20 77 68 69 6c 65 ze). );. while
33ff0 28 20 6e 4f 76 66 6c 2d 2d 20 29 7b 0a 20 20 20 ( nOvfl-- ){.
34000 20 50 67 6e 6f 20 69 4e 65 78 74 20 3d 20 30 3b Pgno iNext = 0;
34010 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f . MemPage *pO
34020 76 66 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 vfl = 0;. if(
34030 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 7c 7c 20 6f ovflPgno<2 || o
34040 76 66 6c 50 67 6e 6f 3e 62 74 72 65 65 50 61 67 vflPgno>btreePag
34050 65 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 ecount(pBt) ){.
34060 20 20 20 20 20 2f 2a 20 30 20 69 73 20 6e 6f 74 /* 0 is not
34070 20 61 20 6c 65 67 61 6c 20 70 61 67 65 20 6e 75 a legal page nu
34080 6d 62 65 72 20 61 6e 64 20 70 61 67 65 20 31 20 mber and page 1
34090 63 61 6e 6e 6f 74 20 62 65 20 61 6e 20 0a 20 20 cannot be an .
340a0 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 ** overflow
340b0 70 61 67 65 2e 20 54 68 65 72 65 66 6f 72 65 20 page. Therefore
340c0 69 66 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 6f 72 if ovflPgno<2 or
340d0 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
340e0 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 the . ** f
340f0 69 6c 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ile the database
34100 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 74 must be corrupt
34110 2e 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 . */. retur
34120 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
34130 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 _BKPT;. }.
34140 20 69 66 28 20 6e 4f 76 66 6c 20 29 7b 0a 20 20 if( nOvfl ){.
34150 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 rc = getOver
34160 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6f 76 flowPage(pBt, ov
34170 66 6c 50 67 6e 6f 2c 20 26 70 4f 76 66 6c 2c 20 flPgno, &pOvfl,
34180 26 69 4e 65 78 74 29 3b 0a 20 20 20 20 20 20 69 &iNext);. i
34190 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
341a0 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 c;. }.. if
341b0 28 20 28 20 70 4f 76 66 6c 20 7c 7c 20 28 28 70 ( ( pOvfl || ((p
341c0 4f 76 66 6c 20 3d 20 62 74 72 65 65 50 61 67 65 Ovfl = btreePage
341d0 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 6f 76 66 6c Lookup(pBt, ovfl
341e0 50 67 6e 6f 29 29 21 3d 30 29 20 29 0a 20 20 20 Pgno))!=0) ).
341f0 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 && sqlite3Page
34200 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 4f rPageRefcount(pO
34210 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 21 3d 31 vfl->pDbPage)!=1
34220 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
34230 20 54 68 65 72 65 20 69 73 20 6e 6f 20 72 65 61 There is no rea
34240 73 6f 6e 20 61 6e 79 20 63 75 72 73 6f 72 20 73 son any cursor s
34250 68 6f 75 6c 64 20 68 61 76 65 20 61 6e 20 6f 75 hould have an ou
34260 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 tstanding refere
34270 6e 63 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f nce . ** to
34280 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
34290 65 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 61 e belonging to a
342a0 20 63 65 6c 6c 20 74 68 61 74 20 69 73 20 62 65 cell that is be
342b0 69 6e 67 20 64 65 6c 65 74 65 64 2f 75 70 64 61 ing deleted/upda
342c0 74 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 53 6f ted.. ** So
342d0 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 if there exists
342e0 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 more than one r
342f0 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 69 73 eference to this
34300 20 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 0a page, then it .
34310 20 20 20 20 20 20 2a 2a 20 6d 75 73 74 20 6e 6f ** must no
34320 74 20 72 65 61 6c 6c 79 20 62 65 20 61 6e 20 6f t really be an o
34330 76 65 72 66 6c 6f 77 20 70 61 67 65 20 61 6e 64 verflow page and
34340 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 the database mu
34350 73 74 20 62 65 20 63 6f 72 72 75 70 74 2e 20 0a st be corrupt. .
34360 20 20 20 20 20 20 2a 2a 20 49 74 20 69 73 20 68 ** It is h
34370 65 6c 70 66 75 6c 20 74 6f 20 64 65 74 65 63 74 elpful to detect
34380 20 74 68 69 73 20 62 65 66 6f 72 65 20 63 61 6c this before cal
34390 6c 69 6e 67 20 66 72 65 65 50 61 67 65 32 28 29 ling freePage2()
343a0 2c 20 61 73 20 0a 20 20 20 20 20 20 2a 2a 20 66 , as . ** f
343b0 72 65 65 50 61 67 65 32 28 29 20 6d 61 79 20 7a reePage2() may z
343c0 65 72 6f 20 74 68 65 20 70 61 67 65 20 63 6f 6e ero the page con
343d0 74 65 6e 74 73 20 69 66 20 73 65 63 75 72 65 2d tents if secure-
343e0 64 65 6c 65 74 65 20 6d 6f 64 65 20 69 73 0a 20 delete mode is.
343f0 20 20 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e ** enabled.
34400 20 49 66 20 74 68 69 73 20 27 6f 76 65 72 66 6c If this 'overfl
34410 6f 77 27 20 70 61 67 65 20 68 61 70 70 65 6e 73 ow' page happens
34420 20 74 6f 20 62 65 20 61 20 70 61 67 65 20 74 68 to be a page th
34430 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 at the. **
34440 63 61 6c 6c 65 72 20 69 73 20 69 74 65 72 61 74 caller is iterat
34450 69 6e 67 20 74 68 72 6f 75 67 68 20 6f 72 20 75 ing through or u
34460 73 69 6e 67 20 69 6e 20 73 6f 6d 65 20 6f 74 68 sing in some oth
34470 65 72 20 77 61 79 2c 20 74 68 69 73 0a 20 20 20 er way, this.
34480 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 70 72 6f ** can be pro
34490 62 6c 65 6d 61 74 69 63 2e 0a 20 20 20 20 20 20 blematic..
344a0 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 */. rc = SQ
344b0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
344c0 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 T;. }else{.
344d0 20 20 20 20 72 63 20 3d 20 66 72 65 65 50 61 67 rc = freePag
344e0 65 32 28 70 42 74 2c 20 70 4f 76 66 6c 2c 20 6f e2(pBt, pOvfl, o
344f0 76 66 6c 50 67 6e 6f 29 3b 0a 20 20 20 20 7d 0a vflPgno);. }.
34500 0a 20 20 20 20 69 66 28 20 70 4f 76 66 6c 20 29 . if( pOvfl )
34510 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
34520 61 67 65 72 55 6e 72 65 66 28 70 4f 76 66 6c 2d agerUnref(pOvfl-
34530 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 7d >pDbPage);. }
34540 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
34550 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 6f 76 66 turn rc;. ovf
34560 6c 50 67 6e 6f 20 3d 20 69 4e 65 78 74 3b 0a 20 lPgno = iNext;.
34570 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
34580 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
34590 43 72 65 61 74 65 20 74 68 65 20 62 79 74 65 20 Create the byte
345a0 73 65 71 75 65 6e 63 65 20 75 73 65 64 20 74 6f sequence used to
345b0 20 72 65 70 72 65 73 65 6e 74 20 61 20 63 65 6c represent a cel
345c0 6c 20 6f 6e 20 70 61 67 65 20 70 50 61 67 65 0a l on page pPage.
345d0 2a 2a 20 61 6e 64 20 77 72 69 74 65 20 74 68 61 ** and write tha
345e0 74 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 t byte sequence
345f0 69 6e 74 6f 20 70 43 65 6c 6c 5b 5d 2e 20 20 4f into pCell[]. O
34600 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 verflow pages ar
34610 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 e.** allocated a
34620 6e 64 20 66 69 6c 6c 65 64 20 69 6e 20 61 73 20 nd filled in as
34630 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 65 20 necessary. The
34640 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 calling procedur
34650 65 0a 2a 2a 20 69 73 20 72 65 73 70 6f 6e 73 69 e.** is responsi
34660 62 6c 65 20 66 6f 72 20 6d 61 6b 69 6e 67 20 73 ble for making s
34670 75 72 65 20 73 75 66 66 69 63 69 65 6e 74 20 73 ure sufficient s
34680 70 61 63 65 20 68 61 73 20 62 65 65 6e 20 61 6c pace has been al
34690 6c 6f 63 61 74 65 64 0a 2a 2a 20 66 6f 72 20 70 located.** for p
346a0 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 4e 6f Cell[]..**.** No
346b0 74 65 20 74 68 61 74 20 70 43 65 6c 6c 20 64 6f te that pCell do
346c0 65 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 es not necessary
346d0 20 6e 65 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 need to point t
346e0 6f 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 61 o the pPage->aDa
346f0 74 61 0a 2a 2a 20 61 72 65 61 2e 20 20 70 43 65 ta.** area. pCe
34700 6c 6c 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 ll might point t
34710 6f 20 73 6f 6d 65 20 74 65 6d 70 6f 72 61 72 79 o some temporary
34720 20 73 74 6f 72 61 67 65 2e 20 20 54 68 65 20 63 storage. The c
34730 65 6c 6c 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 63 ell will.** be c
34740 6f 6e 73 74 72 75 63 74 65 64 20 69 6e 20 74 68 onstructed in th
34750 69 73 20 74 65 6d 70 6f 72 61 72 79 20 61 72 65 is temporary are
34760 61 20 74 68 65 6e 20 63 6f 70 69 65 64 20 69 6e a then copied in
34770 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 0a to pPage->aData.
34780 2a 2a 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 61 ** later..*/.sta
34790 74 69 63 20 69 6e 74 20 66 69 6c 6c 49 6e 43 65 tic int fillInCe
347a0 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 ll(. MemPage *p
347b0 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 Page,
347c0 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 /* The page
347d0 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
347e0 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 he cell */. uns
347f0 69 67 6e 65 64 20 63 68 61 72 20 2a 70 43 65 6c igned char *pCel
34800 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 l, /* C
34810 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 omplete text of
34820 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 63 6f the cell */. co
34830 6e 73 74 20 42 74 72 65 65 50 61 79 6c 6f 61 64 nst BtreePayload
34840 20 2a 70 58 2c 20 20 20 20 20 20 20 20 2f 2a 20 *pX, /*
34850 50 61 79 6c 6f 61 64 20 77 69 74 68 20 77 68 69 Payload with whi
34860 63 68 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 ch to construct
34870 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e the cell */. in
34880 74 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 t *pnSize
34890 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
348a0 57 72 69 74 65 20 63 65 6c 6c 20 73 69 7a 65 20 Write cell size
348b0 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
348c0 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 63 6f 6e nPayload;. con
348d0 73 74 20 75 38 20 2a 70 53 72 63 3b 0a 20 20 69 st u8 *pSrc;. i
348e0 6e 74 20 6e 53 72 63 2c 20 6e 2c 20 72 63 3b 0a nt nSrc, n, rc;.
348f0 20 20 69 6e 74 20 73 70 61 63 65 4c 65 66 74 3b int spaceLeft;
34900 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 . MemPage *pOvf
34910 6c 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 l = 0;. MemPage
34920 20 2a 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 30 *pToRelease = 0
34930 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 ;. unsigned cha
34940 72 20 2a 70 50 72 69 6f 72 3b 0a 20 20 75 6e 73 r *pPrior;. uns
34950 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 61 79 igned char *pPay
34960 6c 6f 61 64 3b 0a 20 20 42 74 53 68 61 72 65 64 load;. BtShared
34970 20 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 *pBt = pPage->p
34980 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4f Bt;. Pgno pgnoO
34990 76 66 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e vfl = 0;. int n
349a0 48 65 61 64 65 72 3b 0a 0a 20 20 61 73 73 65 72 Header;.. asser
349b0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
349c0 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
349d0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f ->mutex) );.. /
349e0 2a 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 6e * pPage is not n
349f0 65 63 65 73 73 61 72 69 6c 79 20 77 72 69 74 65 ecessarily write
34a00 61 62 6c 65 20 73 69 6e 63 65 20 70 43 65 6c 6c able since pCell
34a10 20 6d 69 67 68 74 20 62 65 20 61 75 78 69 6c 69 might be auxili
34a20 61 72 79 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 ary. ** buffer
34a30 73 70 61 63 65 20 74 68 61 74 20 69 73 20 73 65 space that is se
34a40 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68 65 20 parate from the
34a50 70 50 61 67 65 20 62 75 66 66 65 72 20 61 72 65 pPage buffer are
34a60 61 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 a */. assert( p
34a70 43 65 6c 6c 3c 70 50 61 67 65 2d 3e 61 44 61 74 Cell<pPage->aDat
34a80 61 20 7c 7c 20 70 43 65 6c 6c 3e 3d 26 70 50 61 a || pCell>=&pPa
34a90 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 ge->aData[pBt->p
34aa0 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 ageSize].
34ab0 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 || sqlite3P
34ac0 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
34ad0 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
34ae0 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e );.. /* Fill in
34af0 20 74 68 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a the header. */.
34b00 20 20 6e 48 65 61 64 65 72 20 3d 20 70 50 61 67 nHeader = pPag
34b10 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
34b20 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e . if( pPage->in
34b30 74 4b 65 79 20 29 7b 0a 20 20 20 20 6e 50 61 79 tKey ){. nPay
34b40 6c 6f 61 64 20 3d 20 70 58 2d 3e 6e 44 61 74 61 load = pX->nData
34b50 20 2b 20 70 58 2d 3e 6e 5a 65 72 6f 3b 0a 20 20 + pX->nZero;.
34b60 20 20 70 53 72 63 20 3d 20 70 58 2d 3e 70 44 61 pSrc = pX->pDa
34b70 74 61 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 70 ta;. nSrc = p
34b80 58 2d 3e 6e 44 61 74 61 3b 0a 20 20 20 20 61 73 X->nData;. as
34b90 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 6e 74 sert( pPage->int
34ba0 4b 65 79 4c 65 61 66 20 29 3b 20 2f 2a 20 66 69 KeyLeaf ); /* fi
34bb0 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 20 llInCell() only
34bc0 63 61 6c 6c 65 64 20 66 6f 72 20 6c 65 61 76 65 called for leave
34bd0 73 20 2a 2f 0a 20 20 20 20 6e 48 65 61 64 65 72 s */. nHeader
34be0 20 2b 3d 20 70 75 74 56 61 72 69 6e 74 33 32 28 += putVarint32(
34bf0 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c &pCell[nHeader],
34c00 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 20 nPayload);.
34c10 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 74 56 61 nHeader += putVa
34c20 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e 48 65 61 rint(&pCell[nHea
34c30 64 65 72 5d 2c 20 2a 28 75 36 34 2a 29 26 70 58 der], *(u64*)&pX
34c40 2d 3e 6e 4b 65 79 29 3b 0a 20 20 7d 65 6c 73 65 ->nKey);. }else
34c50 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 58 {. assert( pX
34c60 2d 3e 6e 4b 65 79 3c 3d 30 78 37 66 66 66 66 66 ->nKey<=0x7fffff
34c70 66 66 20 26 26 20 70 58 2d 3e 70 4b 65 79 21 3d ff && pX->pKey!=
34c80 30 20 29 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 0 );. nSrc =
34c90 6e 50 61 79 6c 6f 61 64 20 3d 20 28 69 6e 74 29 nPayload = (int)
34ca0 70 58 2d 3e 6e 4b 65 79 3b 0a 20 20 20 20 70 53 pX->nKey;. pS
34cb0 72 63 20 3d 20 70 58 2d 3e 70 4b 65 79 3b 0a 20 rc = pX->pKey;.
34cc0 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 nHeader += pu
34cd0 74 56 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c tVarint32(&pCell
34ce0 5b 6e 48 65 61 64 65 72 5d 2c 20 6e 50 61 79 6c [nHeader], nPayl
34cf0 6f 61 64 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f oad);. }. . /
34d00 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 20 70 61 * Fill in the pa
34d10 79 6c 6f 61 64 20 2a 2f 0a 20 20 69 66 28 20 6e yload */. if( n
34d20 50 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e Payload<=pPage->
34d30 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 maxLocal ){.
34d40 6e 20 3d 20 6e 48 65 61 64 65 72 20 2b 20 6e 50 n = nHeader + nP
34d50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 74 65 73 74 ayload;. test
34d60 63 61 73 65 28 20 6e 3d 3d 33 20 29 3b 0a 20 20 case( n==3 );.
34d70 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 34 testcase( n==4
34d80 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 3c 34 20 );. if( n<4
34d90 29 20 6e 20 3d 20 34 3b 0a 20 20 20 20 2a 70 6e ) n = 4;. *pn
34da0 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 20 20 73 70 Size = n;. sp
34db0 61 63 65 4c 65 66 74 20 3d 20 6e 50 61 79 6c 6f aceLeft = nPaylo
34dc0 61 64 3b 0a 20 20 20 20 70 50 72 69 6f 72 20 3d ad;. pPrior =
34dd0 20 70 43 65 6c 6c 3b 0a 20 20 7d 65 6c 73 65 7b pCell;. }else{
34de0 0a 20 20 20 20 69 6e 74 20 6d 6e 20 3d 20 70 50 . int mn = pP
34df0 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 age->minLocal;.
34e00 20 20 20 6e 20 3d 20 6d 6e 20 2b 20 28 6e 50 61 n = mn + (nPa
34e10 79 6c 6f 61 64 20 2d 20 6d 6e 29 20 25 20 28 70 yload - mn) % (p
34e20 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
34e30 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 eSize - 4);.
34e40 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 61 testcase( n==pPa
34e50 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a ge->maxLocal );.
34e60 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d testcase( n=
34e70 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
34e80 2b 31 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 20 +1 );. if( n
34e90 3e 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 > pPage->maxLoca
34ea0 6c 20 29 20 6e 20 3d 20 6d 6e 3b 0a 20 20 20 20 l ) n = mn;.
34eb0 73 70 61 63 65 4c 65 66 74 20 3d 20 6e 3b 0a 20 spaceLeft = n;.
34ec0 20 20 20 2a 70 6e 53 69 7a 65 20 3d 20 6e 20 2b *pnSize = n +
34ed0 20 6e 48 65 61 64 65 72 20 2b 20 34 3b 0a 20 20 nHeader + 4;.
34ee0 20 20 70 50 72 69 6f 72 20 3d 20 26 70 43 65 6c pPrior = &pCel
34ef0 6c 5b 6e 48 65 61 64 65 72 2b 6e 5d 3b 0a 20 20 l[nHeader+n];.
34f00 7d 0a 20 20 70 50 61 79 6c 6f 61 64 20 3d 20 26 }. pPayload = &
34f10 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 3b 0a pCell[nHeader];.
34f20 0a 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f . /* At this po
34f30 69 6e 74 20 76 61 72 69 61 62 6c 65 73 20 73 68 int variables sh
34f40 6f 75 6c 64 20 62 65 20 73 65 74 20 61 73 20 66 ould be set as f
34f50 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a ollows:. **. *
34f60 2a 20 20 20 6e 50 61 79 6c 6f 61 64 20 20 20 20 * nPayload
34f70 20 20 20 20 20 20 20 54 6f 74 61 6c 20 70 61 79 Total pay
34f80 6c 6f 61 64 20 73 69 7a 65 20 69 6e 20 62 79 74 load size in byt
34f90 65 73 0a 20 20 2a 2a 20 20 20 70 50 61 79 6c 6f es. ** pPaylo
34fa0 61 64 20 20 20 20 20 20 20 20 20 20 20 42 65 67 ad Beg
34fb0 69 6e 20 77 72 69 74 69 6e 67 20 70 61 79 6c 6f in writing paylo
34fc0 61 64 20 68 65 72 65 0a 20 20 2a 2a 20 20 20 73 ad here. ** s
34fd0 70 61 63 65 4c 65 66 74 20 20 20 20 20 20 20 20 paceLeft
34fe0 20 20 53 70 61 63 65 20 61 76 61 69 6c 61 62 6c Space availabl
34ff0 65 20 61 74 20 70 50 61 79 6c 6f 61 64 2e 20 20 e at pPayload.
35000 49 66 20 6e 50 61 79 6c 6f 61 64 3e 73 70 61 63 If nPayload>spac
35010 65 4c 65 66 74 2c 0a 20 20 2a 2a 20 20 20 20 20 eLeft,. **
35020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35030 20 74 68 61 74 20 6d 65 61 6e 73 20 63 6f 6e 74 that means cont
35040 65 6e 74 20 6d 75 73 74 20 73 70 69 6c 6c 20 69 ent must spill i
35050 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 nto overflow pag
35060 65 73 2e 0a 20 20 2a 2a 20 20 20 2a 70 6e 53 69 es.. ** *pnSi
35070 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 53 69 ze Si
35080 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 ze of the local
35090 63 65 6c 6c 20 28 6e 6f 74 20 63 6f 75 6e 74 69 cell (not counti
350a0 6e 67 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 ng overflow page
350b0 73 29 0a 20 20 2a 2a 20 20 20 70 50 72 69 6f 72 s). ** pPrior
350c0 20 20 20 20 20 20 20 20 20 20 20 20 20 57 68 65 Whe
350d0 72 65 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 re to write the
350e0 70 67 6e 6f 20 6f 66 20 74 68 65 20 66 69 72 73 pgno of the firs
350f0 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a t overflow page.
35100 20 20 2a 2a 0a 20 20 2a 2a 20 55 73 65 20 61 20 **. ** Use a
35110 63 61 6c 6c 20 74 6f 20 62 74 72 65 65 50 61 72 call to btreePar
35120 73 65 43 65 6c 6c 50 74 72 28 29 20 74 6f 20 76 seCellPtr() to v
35130 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 76 erify that the v
35140 61 6c 75 65 73 20 61 62 6f 76 65 0a 20 20 2a 2a alues above. **
35150 20 77 65 72 65 20 63 6f 6d 70 75 74 65 64 20 63 were computed c
35160 6f 72 72 65 63 74 6c 79 2e 0a 20 20 2a 2f 0a 23 orrectly.. */.#
35170 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
35180 55 47 0a 20 20 7b 0a 20 20 20 20 43 65 6c 6c 49 UG. {. CellI
35190 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 70 50 nfo info;. pP
351a0 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 age->xParseCell(
351b0 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 pPage, pCell, &i
351c0 6e 66 6f 29 3b 0a 20 20 20 20 61 73 73 65 72 74 nfo);. assert
351d0 28 20 6e 48 65 61 64 65 72 3d 3d 28 69 6e 74 29 ( nHeader==(int)
351e0 28 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 20 2d (info.pPayload -
351f0 20 70 43 65 6c 6c 29 20 29 3b 0a 20 20 20 20 61 pCell) );. a
35200 73 73 65 72 74 28 20 69 6e 66 6f 2e 6e 4b 65 79 ssert( info.nKey
35210 3d 3d 70 58 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 ==pX->nKey );.
35220 20 20 61 73 73 65 72 74 28 20 2a 70 6e 53 69 7a assert( *pnSiz
35230 65 20 3d 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 20 e == info.nSize
35240 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
35250 70 61 63 65 4c 65 66 74 20 3d 3d 20 69 6e 66 6f paceLeft == info
35260 2e 6e 4c 6f 63 61 6c 20 29 3b 0a 20 20 7d 0a 23 .nLocal );. }.#
35270 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 57 72 69 74 endif.. /* Writ
35280 65 20 74 68 65 20 70 61 79 6c 6f 61 64 20 69 6e e the payload in
35290 74 6f 20 74 68 65 20 6c 6f 63 61 6c 20 43 65 6c to the local Cel
352a0 6c 20 61 6e 64 20 61 6e 79 20 65 78 74 72 61 20 l and any extra
352b0 69 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 into overflow pa
352c0 67 65 73 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 ges */. while(
352d0 6e 50 61 79 6c 6f 61 64 3e 30 20 29 7b 0a 20 20 nPayload>0 ){.
352e0 20 20 69 66 28 20 73 70 61 63 65 4c 65 66 74 3d if( spaceLeft=
352f0 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 =0 ){.#ifndef SQ
35300 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
35310 43 55 55 4d 0a 20 20 20 20 20 20 50 67 6e 6f 20 CUUM. Pgno
35320 70 67 6e 6f 50 74 72 6d 61 70 20 3d 20 70 67 6e pgnoPtrmap = pgn
35330 6f 4f 76 66 6c 3b 20 2f 2a 20 4f 76 65 72 66 6c oOvfl; /* Overfl
35340 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 2d ow page pointer-
35350 6d 61 70 20 65 6e 74 72 79 20 70 61 67 65 20 2a map entry page *
35360 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 2d /. if( pBt-
35370 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 >autoVacuum ){.
35380 20 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 do{.
35390 20 20 20 20 20 70 67 6e 6f 4f 76 66 6c 2b 2b 3b pgnoOvfl++;
353a0 0a 20 20 20 20 20 20 20 20 7d 20 77 68 69 6c 65 . } while
353b0 28 20 0a 20 20 20 20 20 20 20 20 20 20 50 54 52 ( . PTR
353c0 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
353d0 70 67 6e 6f 4f 76 66 6c 29 20 7c 7c 20 70 67 6e pgnoOvfl) || pgn
353e0 6f 4f 76 66 6c 3d 3d 50 45 4e 44 49 4e 47 5f 42 oOvfl==PENDING_B
353f0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 0a 20 YTE_PAGE(pBt) .
35400 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 );.
35410 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 }.#endif. r
35420 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 c = allocateBtre
35430 65 50 61 67 65 28 70 42 74 2c 20 26 70 4f 76 66 ePage(pBt, &pOvf
35440 6c 2c 20 26 70 67 6e 6f 4f 76 66 6c 2c 20 70 67 l, &pgnoOvfl, pg
35450 6e 6f 4f 76 66 6c 2c 20 30 29 3b 0a 23 69 66 6e noOvfl, 0);.#ifn
35460 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
35470 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 AUTOVACUUM.
35480 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 /* If the datab
35490 61 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 ase supports aut
354a0 6f 2d 76 61 63 75 75 6d 2c 20 61 6e 64 20 74 68 o-vacuum, and th
354b0 65 20 73 65 63 6f 6e 64 20 6f 72 20 73 75 62 73 e second or subs
354c0 65 71 75 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 equent. **
354d0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 overflow page is
354e0 20 62 65 69 6e 67 20 61 6c 6c 6f 63 61 74 65 64 being allocated
354f0 2c 20 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 , add an entry t
35500 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 o the pointer-ma
35510 70 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 p. ** for t
35520 68 61 74 20 70 61 67 65 20 6e 6f 77 2e 20 0a 20 hat page now. .
35530 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a **. **
35540 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
35550 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
35560 61 67 65 2c 20 74 68 65 6e 20 77 72 69 74 65 20 age, then write
35570 61 20 70 61 72 74 69 61 6c 20 65 6e 74 72 79 20 a partial entry
35580 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 . ** to the
35590 20 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 20 49 66 pointer-map. If
355a0 20 77 65 20 77 72 69 74 65 20 6e 6f 74 68 69 6e we write nothin
355b0 67 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 65 g to this pointe
355c0 72 2d 6d 61 70 20 73 6c 6f 74 2c 0a 20 20 20 20 r-map slot,.
355d0 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 6f 70 ** then the op
355e0 74 69 6d 69 73 74 69 63 20 6f 76 65 72 66 6c 6f timistic overflo
355f0 77 20 63 68 61 69 6e 20 70 72 6f 63 65 73 73 69 w chain processi
35600 6e 67 20 69 6e 20 63 6c 65 61 72 43 65 6c 6c 28 ng in clearCell(
35610 29 0a 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 6d ). ** may m
35620 69 73 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 isinterpret the
35630 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 76 61 uninitialized va
35640 6c 75 65 73 20 61 6e 64 20 64 65 6c 65 74 65 20 lues and delete
35650 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 77 72 6f the. ** wro
35660 6e 67 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 ng pages from th
35670 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 e database..
35680 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 */. if( p
35690 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 Bt->autoVacuum &
356a0 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
356b0 29 7b 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 ){. u8 eT
356c0 79 70 65 20 3d 20 28 70 67 6e 6f 50 74 72 6d 61 ype = (pgnoPtrma
356d0 70 3f 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f p?PTRMAP_OVERFLO
356e0 57 32 3a 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c W2:PTRMAP_OVERFL
356f0 4f 57 31 29 3b 0a 20 20 20 20 20 20 20 20 70 74 OW1);. pt
35700 72 6d 61 70 50 75 74 28 70 42 74 2c 20 70 67 6e rmapPut(pBt, pgn
35710 6f 4f 76 66 6c 2c 20 65 54 79 70 65 2c 20 70 67 oOvfl, eType, pg
35720 6e 6f 50 74 72 6d 61 70 2c 20 26 72 63 29 3b 0a noPtrmap, &rc);.
35730 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 if( rc )
35740 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 {. rele
35750 61 73 65 50 61 67 65 28 70 4f 76 66 6c 29 3b 0a asePage(pOvfl);.
35760 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
35770 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 69 }.#endif. i
35780 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
35790 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f releasePage(pTo
357a0 52 65 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 Release);.
357b0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
357c0 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 }.. /* I
357d0 66 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 f pToRelease is
357e0 6e 6f 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 not zero than pP
357f0 72 69 6f 72 20 70 6f 69 6e 74 73 20 69 6e 74 6f rior points into
35800 20 74 68 65 20 64 61 74 61 20 61 72 65 61 0a 20 the data area.
35810 20 20 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 ** of pToRe
35820 6c 65 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 lease. Make sur
35830 65 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 e pToRelease is
35840 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e still writeable.
35850 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 */. assert
35860 28 20 70 54 6f 52 65 6c 65 61 73 65 3d 3d 30 20 ( pToRelease==0
35870 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 || sqlite3PagerI
35880 73 77 72 69 74 65 61 62 6c 65 28 70 54 6f 52 65 swriteable(pToRe
35890 6c 65 61 73 65 2d 3e 70 44 62 50 61 67 65 29 20 lease->pDbPage)
358a0 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 );.. /* If
358b0 70 50 72 69 6f 72 20 69 73 20 70 61 72 74 20 6f pPrior is part o
358c0 66 20 74 68 65 20 64 61 74 61 20 61 72 65 61 20 f the data area
358d0 6f 66 20 70 50 61 67 65 2c 20 74 68 65 6e 20 6d of pPage, then m
358e0 61 6b 65 20 73 75 72 65 20 70 50 61 67 65 0a 20 ake sure pPage.
358f0 20 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c ** is still
35900 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 writeable */.
35910 20 20 20 20 61 73 73 65 72 74 28 20 70 50 72 69 assert( pPri
35920 6f 72 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 or<pPage->aData
35930 7c 7c 20 70 50 72 69 6f 72 3e 3d 26 70 50 61 67 || pPrior>=&pPag
35940 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 e->aData[pBt->pa
35950 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 geSize].
35960 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 || sqlite3Pa
35970 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
35980 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
35990 3b 0a 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 ;.. put4byt
359a0 65 28 70 50 72 69 6f 72 2c 20 70 67 6e 6f 4f 76 e(pPrior, pgnoOv
359b0 66 6c 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 fl);. relea
359c0 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 sePage(pToReleas
359d0 65 29 3b 0a 20 20 20 20 20 20 70 54 6f 52 65 6c e);. pToRel
359e0 65 61 73 65 20 3d 20 70 4f 76 66 6c 3b 0a 20 20 ease = pOvfl;.
359f0 20 20 20 20 70 50 72 69 6f 72 20 3d 20 70 4f 76 pPrior = pOv
35a00 66 6c 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 fl->aData;.
35a10 20 70 75 74 34 62 79 74 65 28 70 50 72 69 6f 72 put4byte(pPrior
35a20 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 50 61 79 , 0);. pPay
35a30 6c 6f 61 64 20 3d 20 26 70 4f 76 66 6c 2d 3e 61 load = &pOvfl->a
35a40 44 61 74 61 5b 34 5d 3b 0a 20 20 20 20 20 20 73 Data[4];. s
35a50 70 61 63 65 4c 65 66 74 20 3d 20 70 42 74 2d 3e paceLeft = pBt->
35a60 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a usableSize - 4;.
35a70 20 20 20 20 7d 0a 20 20 20 20 6e 20 3d 20 6e 50 }. n = nP
35a80 61 79 6c 6f 61 64 3b 0a 20 20 20 20 69 66 28 20 ayload;. if(
35a90 6e 3e 73 70 61 63 65 4c 65 66 74 20 29 20 6e 20 n>spaceLeft ) n
35aa0 3d 20 73 70 61 63 65 4c 65 66 74 3b 0a 0a 20 20 = spaceLeft;..
35ab0 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 /* If pToRelea
35ac0 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 se is not zero t
35ad0 68 61 6e 20 70 50 61 79 6c 6f 61 64 20 70 6f 69 han pPayload poi
35ae0 6e 74 73 20 69 6e 74 6f 20 74 68 65 20 64 61 74 nts into the dat
35af0 61 20 61 72 65 61 0a 20 20 20 20 2a 2a 20 6f 66 a area. ** of
35b00 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 pToRelease. Ma
35b10 6b 65 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 ke sure pToRelea
35b20 73 65 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 se is still writ
35b30 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 61 73 eable. */. as
35b40 73 65 72 74 28 20 70 54 6f 52 65 6c 65 61 73 65 sert( pToRelease
35b50 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 ==0 || sqlite3Pa
35b60 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
35b70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 ToRelease->pDbPa
35b80 67 65 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 ge) );.. /* I
35b90 66 20 70 50 61 79 6c 6f 61 64 20 69 73 20 70 61 f pPayload is pa
35ba0 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 rt of the data a
35bb0 72 65 61 20 6f 66 20 70 50 61 67 65 2c 20 74 68 rea of pPage, th
35bc0 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 70 50 61 en make sure pPa
35bd0 67 65 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 69 ge. ** is sti
35be0 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a ll writeable */.
35bf0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 79 assert( pPay
35c00 6c 6f 61 64 3c 70 50 61 67 65 2d 3e 61 44 61 74 load<pPage->aDat
35c10 61 20 7c 7c 20 70 50 61 79 6c 6f 61 64 3e 3d 26 a || pPayload>=&
35c20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 pPage->aData[pBt
35c30 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 ->pageSize].
35c40 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 || sqlit
35c50 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
35c60 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
35c70 65 29 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e e) );.. if( n
35c80 53 72 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 Src>0 ){. i
35c90 66 28 20 6e 3e 6e 53 72 63 20 29 20 6e 20 3d 20 f( n>nSrc ) n =
35ca0 6e 53 72 63 3b 0a 20 20 20 20 20 20 61 73 73 65 nSrc;. asse
35cb0 72 74 28 20 70 53 72 63 20 29 3b 0a 20 20 20 20 rt( pSrc );.
35cc0 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 memcpy(pPayloa
35cd0 64 2c 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 20 d, pSrc, n);.
35ce0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 }else{. me
35cf0 6d 73 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 30 mset(pPayload, 0
35d00 2c 20 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 , n);. }.
35d10 6e 50 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a 20 nPayload -= n;.
35d20 20 20 20 70 50 61 79 6c 6f 61 64 20 2b 3d 20 6e pPayload += n
35d30 3b 0a 20 20 20 20 70 53 72 63 20 2b 3d 20 6e 3b ;. pSrc += n;
35d40 0a 20 20 20 20 6e 53 72 63 20 2d 3d 20 6e 3b 0a . nSrc -= n;.
35d50 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 2d 3d spaceLeft -=
35d60 20 6e 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 n;. }. releas
35d70 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 ePage(pToRelease
35d80 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
35d90 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
35da0 52 65 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 20 Remove the i-th
35db0 63 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e cell from pPage.
35dc0 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 This routine e
35dd0 66 66 65 63 74 73 20 70 50 61 67 65 20 6f 6e 6c ffects pPage onl
35de0 79 2e 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 63 y..** The cell c
35df0 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 72 ontent is not fr
35e00 65 65 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 74 eed or deallocat
35e10 65 64 2e 20 20 49 74 20 69 73 20 61 73 73 75 6d ed. It is assum
35e20 65 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 ed that.** the c
35e30 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 ell content has
35e40 62 65 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d 65 been copied some
35e50 70 6c 61 63 65 20 65 6c 73 65 2e 20 20 54 68 69 place else. Thi
35e60 73 20 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a 2a s routine just.*
35e70 2a 20 72 65 6d 6f 76 65 73 20 74 68 65 20 72 65 * removes the re
35e80 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 63 ference to the c
35e90 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 0a ell from pPage..
35ea0 2a 2a 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 20 **.** "sz" must
35eb0 62 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 be the number of
35ec0 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 63 65 bytes in the ce
35ed0 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ll..*/.static vo
35ee0 69 64 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d 50 id dropCell(MemP
35ef0 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 age *pPage, int
35f00 69 64 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 idx, int sz, int
35f10 20 2a 70 52 43 29 7b 0a 20 20 75 33 32 20 70 63 *pRC){. u32 pc
35f20 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 ; /* Off
35f30 73 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 set to cell cont
35f40 65 6e 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 6e ent of cell bein
35f50 67 20 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 75 g deleted */. u
35f60 38 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 8 *data; /
35f70 2a 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a * pPage->aData *
35f80 2f 0a 20 20 75 38 20 2a 70 74 72 3b 20 20 20 20 /. u8 *ptr;
35f90 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 6d /* Used to m
35fa0 6f 76 65 20 62 79 74 65 73 20 61 72 6f 75 6e 64 ove bytes around
35fb0 20 77 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 2a within data[] *
35fc0 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 /. int rc;
35fd0 20 20 20 20 2f 2a 20 54 68 65 20 72 65 74 75 72 /* The retur
35fe0 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 n code */. int
35ff0 68 64 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 42 hdr; /* B
36000 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 eginning of the
36010 68 65 61 64 65 72 2e 20 20 30 20 6d 6f 73 74 20 header. 0 most
36020 70 61 67 65 73 2e 20 20 31 30 30 20 70 61 67 65 pages. 100 page
36030 20 31 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 1 */.. if( *pR
36040 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 C ) return;. as
36050 73 65 72 74 28 20 69 64 78 3e 3d 30 20 26 26 20 sert( idx>=0 &&
36060 69 64 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c idx<pPage->nCell
36070 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 43 4f );. assert( CO
36080 52 52 55 50 54 5f 44 42 20 7c 7c 20 73 7a 3d 3d RRUPT_DB || sz==
36090 63 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 cellSize(pPage,
360a0 69 64 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 idx) );. assert
360b0 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
360c0 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
360d0 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
360e0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
360f0 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
36100 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
36110 20 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e data = pPage->
36120 61 44 61 74 61 3b 0a 20 20 70 74 72 20 3d 20 26 aData;. ptr = &
36130 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b pPage->aCellIdx[
36140 32 2a 69 64 78 5d 3b 0a 20 20 70 63 20 3d 20 67 2*idx];. pc = g
36150 65 74 32 62 79 74 65 28 70 74 72 29 3b 0a 20 20 et2byte(ptr);.
36160 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 hdr = pPage->hdr
36170 4f 66 66 73 65 74 3b 0a 20 20 74 65 73 74 63 61 Offset;. testca
36180 73 65 28 20 70 63 3d 3d 67 65 74 32 62 79 74 65 se( pc==get2byte
36190 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 (&data[hdr+5]) )
361a0 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 63 ;. testcase( pc
361b0 2b 73 7a 3d 3d 70 50 61 67 65 2d 3e 70 42 74 2d +sz==pPage->pBt-
361c0 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 >usableSize );.
361d0 20 69 66 28 20 70 63 20 3c 20 28 75 33 32 29 67 if( pc < (u32)g
361e0 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
361f0 72 2b 35 5d 29 20 7c 7c 20 70 63 2b 73 7a 20 3e r+5]) || pc+sz >
36200 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 pPage->pBt->usa
36210 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 2a bleSize ){. *
36220 70 52 43 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 pRC = SQLITE_COR
36230 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 RUPT_BKPT;. r
36240 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 72 63 20 eturn;. }. rc
36250 3d 20 66 72 65 65 53 70 61 63 65 28 70 50 61 67 = freeSpace(pPag
36260 65 2c 20 70 63 2c 20 73 7a 29 3b 0a 20 20 69 66 e, pc, sz);. if
36270 28 20 72 63 20 29 7b 0a 20 20 20 20 2a 70 52 43 ( rc ){. *pRC
36280 20 3d 20 72 63 3b 0a 20 20 20 20 72 65 74 75 72 = rc;. retur
36290 6e 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e n;. }. pPage->
362a0 6e 43 65 6c 6c 2d 2d 3b 0a 20 20 69 66 28 20 70 nCell--;. if( p
362b0 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 Page->nCell==0 )
362c0 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 64 61 {. memset(&da
362d0 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 ta[hdr+1], 0, 4)
362e0 3b 0a 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 ;. data[hdr+7
362f0 5d 20 3d 20 30 3b 0a 20 20 20 20 70 75 74 32 62 ] = 0;. put2b
36300 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
36310 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 , pPage->pBt->us
36320 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 20 20 70 ableSize);. p
36330 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 70 50 Page->nFree = pP
36340 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
36350 53 69 7a 65 20 2d 20 70 50 61 67 65 2d 3e 68 64 Size - pPage->hd
36360 72 4f 66 66 73 65 74 0a 20 20 20 20 20 20 20 20 rOffset.
36370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d -
36380 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
36390 53 69 7a 65 20 2d 20 38 3b 0a 20 20 7d 65 6c 73 Size - 8;. }els
363a0 65 7b 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 e{. memmove(p
363b0 74 72 2c 20 70 74 72 2b 32 2c 20 32 2a 28 70 50 tr, ptr+2, 2*(pP
363c0 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 64 78 age->nCell - idx
363d0 29 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 ));. put2byte
363e0 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 2c 20 70 (&data[hdr+3], p
363f0 50 61 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 Page->nCell);.
36400 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b pPage->nFree +
36410 3d 20 32 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a = 2;. }.}../*.*
36420 2a 20 49 6e 73 65 72 74 20 61 20 6e 65 77 20 63 * Insert a new c
36430 65 6c 6c 20 6f 6e 20 70 50 61 67 65 20 61 74 20 ell on pPage at
36440 63 65 6c 6c 20 69 6e 64 65 78 20 22 69 22 2e 20 cell index "i".
36450 20 70 43 65 6c 6c 20 70 6f 69 6e 74 73 20 74 6f pCell points to
36460 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 the.** content
36470 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2a 0a of the cell..**.
36480 2a 2a 20 49 66 20 74 68 65 20 63 65 6c 6c 20 63 ** If the cell c
36490 6f 6e 74 65 6e 74 20 77 69 6c 6c 20 66 69 74 20 ontent will fit
364a0 6f 6e 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 on the page, the
364b0 6e 20 70 75 74 20 69 74 20 74 68 65 72 65 2e 20 n put it there.
364c0 20 49 66 20 69 74 0a 2a 2a 20 77 69 6c 6c 20 6e If it.** will n
364d0 6f 74 20 66 69 74 2c 20 74 68 65 6e 20 6d 61 6b ot fit, then mak
364e0 65 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 e a copy of the
364f0 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 74 cell content int
36500 6f 20 70 54 65 6d 70 20 69 66 0a 2a 2a 20 70 54 o pTemp if.** pT
36510 65 6d 70 20 69 73 20 6e 6f 74 20 6e 75 6c 6c 2e emp is not null.
36520 20 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 Regardless of
36530 70 54 65 6d 70 2c 20 61 6c 6c 6f 63 61 74 65 20 pTemp, allocate
36540 61 20 6e 65 77 20 65 6e 74 72 79 0a 2a 2a 20 69 a new entry.** i
36550 6e 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b n pPage->apOvfl[
36560 5d 20 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f ] and make it po
36570 69 6e 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 int to the cell
36580 63 6f 6e 74 65 6e 74 20 28 65 69 74 68 65 72 0a content (either.
36590 2a 2a 20 69 6e 20 70 54 65 6d 70 20 6f 72 20 74 ** in pTemp or t
365a0 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 43 65 6c he original pCel
365b0 6c 29 20 61 6e 64 20 61 6c 73 6f 20 72 65 63 6f l) and also reco
365c0 72 64 20 69 74 73 20 69 6e 64 65 78 2e 20 0a 2a rd its index. .*
365d0 2a 20 41 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e * Allocating a n
365e0 65 77 20 65 6e 74 72 79 20 69 6e 20 70 50 61 67 ew entry in pPag
365f0 65 2d 3e 61 43 65 6c 6c 5b 5d 20 69 6d 70 6c 69 e->aCell[] impli
36600 65 73 20 74 68 61 74 20 0a 2a 2a 20 70 50 61 67 es that .** pPag
36610 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 69 73 20 e->nOverflow is
36620 69 6e 63 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a incremented..**.
36630 2a 2a 20 2a 70 52 43 20 6d 75 73 74 20 62 65 20 ** *pRC must be
36640 53 51 4c 49 54 45 5f 4f 4b 20 77 68 65 6e 20 74 SQLITE_OK when t
36650 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
36660 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 alled..*/.static
36670 20 76 6f 69 64 20 69 6e 73 65 72 74 43 65 6c 6c void insertCell
36680 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
36690 67 65 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 6e ge, /* Page in
366a0 74 6f 20 77 68 69 63 68 20 77 65 20 61 72 65 20 to which we are
366b0 63 6f 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 copying */. int
366c0 20 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f i, /
366d0 2a 20 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f 6d * New cell becom
366e0 65 73 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c es the i-th cell
366f0 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a of the page */.
36700 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 u8 *pCell,
36710 20 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 6f /* Content o
36720 66 20 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 2a f the new cell *
36730 2f 0a 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 20 /. int sz,
36740 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f /* Bytes o
36750 66 20 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 65 f content in pCe
36760 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 6d ll */. u8 *pTem
36770 70 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d p, /* Tem
36780 70 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 p storage space
36790 66 6f 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e 65 for pCell, if ne
367a0 65 64 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 eded */. Pgno i
367b0 43 68 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 49 Child, /* I
367c0 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 6c f non-zero, repl
367d0 61 63 65 20 66 69 72 73 74 20 34 20 62 79 74 65 ace first 4 byte
367e0 73 20 77 69 74 68 20 74 68 69 73 20 76 61 6c 75 s with this valu
367f0 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 20 e */. int *pRC
36800 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 /* Read
36810 20 61 6e 64 20 77 72 69 74 65 20 72 65 74 75 72 and write retur
36820 6e 20 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 65 n code from here
36830 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 78 */.){. int idx
36840 20 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 68 = 0; /* Wh
36850 65 72 65 20 74 6f 20 77 72 69 74 65 20 6e 65 77 ere to write new
36860 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e cell content in
36870 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 data[] */. int
36880 20 6a 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f j; /
36890 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
368a0 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 /. u8 *data;
368b0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e /* The con
368c0 74 65 6e 74 20 6f 66 20 74 68 65 20 77 68 6f 6c tent of the whol
368d0 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a e page */. u8 *
368e0 70 49 6e 73 3b 20 20 20 20 20 20 20 20 20 2f 2a pIns; /*
368f0 20 54 68 65 20 70 6f 69 6e 74 20 69 6e 20 70 50 The point in pP
36900 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 5d 20 age->aCellIdx[]
36910 77 68 65 72 65 20 6e 6f 20 63 65 6c 6c 20 69 6e where no cell in
36920 73 65 72 74 65 64 20 2a 2f 0a 0a 20 20 61 73 73 serted */.. ass
36930 65 72 74 28 20 2a 70 52 43 3d 3d 53 51 4c 49 54 ert( *pRC==SQLIT
36940 45 5f 4f 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 E_OK );. assert
36950 28 20 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 61 ( i>=0 && i<=pPa
36960 67 65 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 2d ge->nCell+pPage-
36970 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 20 >nOverflow );.
36980 61 73 73 65 72 74 28 20 4d 58 5f 43 45 4c 4c 28 assert( MX_CELL(
36990 70 50 61 67 65 2d 3e 70 42 74 29 3c 3d 31 30 39 pPage->pBt)<=109
369a0 32 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 );. assert(
369b0 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d 58 pPage->nCell<=MX
369c0 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 _CELL(pPage->pBt
369d0 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 ) || CORRUPT_DB
369e0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
369f0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3c 3d 41 ge->nOverflow<=A
36a00 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e rraySize(pPage->
36a10 61 70 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 apOvfl) );. ass
36a20 65 72 74 28 20 41 72 72 61 79 53 69 7a 65 28 70 ert( ArraySize(p
36a30 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 3d 3d 41 Page->apOvfl)==A
36a40 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e rraySize(pPage->
36a50 61 69 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 aiOvfl) );. ass
36a60 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
36a70 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
36a80 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
36a90 2f 2a 20 54 68 65 20 63 65 6c 6c 20 73 68 6f 75 /* The cell shou
36aa0 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 73 ld normally be s
36ab0 69 7a 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 ized correctly.
36ac0 20 48 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 6d However, when m
36ad0 6f 76 69 6e 67 20 61 0a 20 20 2a 2a 20 6d 61 6c oving a. ** mal
36ae0 66 6f 72 6d 65 64 20 63 65 6c 6c 20 66 72 6f 6d formed cell from
36af0 20 61 20 6c 65 61 66 20 70 61 67 65 20 74 6f 20 a leaf page to
36b00 61 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 65 an interior page
36b10 2c 20 69 66 20 74 68 65 20 63 65 6c 6c 20 73 69 , if the cell si
36b20 7a 65 0a 20 20 2a 2a 20 77 61 6e 74 65 64 20 74 ze. ** wanted t
36b30 6f 20 62 65 20 6c 65 73 73 20 74 68 61 6e 20 34 o be less than 4
36b40 20 62 75 74 20 67 6f 74 20 72 6f 75 6e 64 65 64 but got rounded
36b50 20 75 70 20 74 6f 20 34 20 6f 6e 20 74 68 65 20 up to 4 on the
36b60 6c 65 61 66 2c 20 74 68 65 6e 20 73 69 7a 65 0a leaf, then size.
36b70 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 6c 65 ** might be le
36b80 73 73 20 74 68 61 6e 20 38 20 28 6c 65 61 66 2d ss than 8 (leaf-
36b90 73 69 7a 65 20 2b 20 70 6f 69 6e 74 65 72 29 20 size + pointer)
36ba0 6f 6e 20 74 68 65 20 69 6e 74 65 72 69 6f 72 20 on the interior
36bb0 6e 6f 64 65 2e 20 20 48 65 6e 63 65 0a 20 20 2a node. Hence. *
36bc0 2a 20 74 68 65 20 74 65 72 6d 20 61 66 74 65 72 * the term after
36bd0 20 74 68 65 20 7c 7c 20 69 6e 20 74 68 65 20 66 the || in the f
36be0 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 28 ollowing assert(
36bf0 29 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 ). */. assert(
36c00 73 7a 3d 3d 70 50 61 67 65 2d 3e 78 43 65 6c 6c sz==pPage->xCell
36c10 53 69 7a 65 28 70 50 61 67 65 2c 20 70 43 65 6c Size(pPage, pCel
36c20 6c 29 20 7c 7c 20 28 73 7a 3d 3d 38 20 26 26 20 l) || (sz==8 &&
36c30 69 43 68 69 6c 64 3e 30 29 20 29 3b 0a 20 20 69 iChild>0) );. i
36c40 66 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 f( pPage->nOverf
36c50 6c 6f 77 20 7c 7c 20 73 7a 2b 32 3e 70 50 61 67 low || sz+2>pPag
36c60 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 20 e->nFree ){.
36c70 69 66 28 20 70 54 65 6d 70 20 29 7b 0a 20 20 20 if( pTemp ){.
36c80 20 20 20 6d 65 6d 63 70 79 28 70 54 65 6d 70 2c memcpy(pTemp,
36c90 20 70 43 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 pCell, sz);.
36ca0 20 20 20 70 43 65 6c 6c 20 3d 20 70 54 65 6d 70 pCell = pTemp
36cb0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
36cc0 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 20 20 20 iChild ){.
36cd0 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c 2c 20 put4byte(pCell,
36ce0 69 43 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 iChild);. }.
36cf0 20 20 20 6a 20 3d 20 70 50 61 67 65 2d 3e 6e 4f j = pPage->nO
36d00 76 65 72 66 6c 6f 77 2b 2b 3b 0a 20 20 20 20 2f verflow++;. /
36d10 2a 20 43 6f 6d 70 61 72 69 73 6f 6e 20 61 67 61 * Comparison aga
36d20 69 6e 73 74 20 41 72 72 61 79 53 69 7a 65 2d 31 inst ArraySize-1
36d30 20 73 69 6e 63 65 20 77 65 20 68 6f 6c 64 20 62 since we hold b
36d40 61 63 6b 20 6f 6e 65 20 65 78 74 72 61 20 73 6c ack one extra sl
36d50 6f 74 0a 20 20 20 20 2a 2a 20 61 73 20 61 20 63 ot. ** as a c
36d60 6f 6e 74 69 6e 67 65 6e 63 79 2e 20 20 49 6e 20 ontingency. In
36d70 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 6e 65 76 other words, nev
36d80 65 72 20 6e 65 65 64 20 6d 6f 72 65 20 74 68 61 er need more tha
36d90 6e 20 33 20 6f 76 65 72 66 6c 6f 77 0a 20 20 20 n 3 overflow.
36da0 20 2a 2a 20 73 6c 6f 74 73 20 62 75 74 20 34 20 ** slots but 4
36db0 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 2c 20 6a are allocated, j
36dc0 75 73 74 20 74 6f 20 62 65 20 73 61 66 65 2e 20 ust to be safe.
36dd0 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a */. assert( j
36de0 20 3c 20 41 72 72 61 79 53 69 7a 65 28 70 50 61 < ArraySize(pPa
36df0 67 65 2d 3e 61 70 4f 76 66 6c 29 2d 31 20 29 3b ge->apOvfl)-1 );
36e00 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 70 4f 76 . pPage->apOv
36e10 66 6c 5b 6a 5d 20 3d 20 70 43 65 6c 6c 3b 0a 20 fl[j] = pCell;.
36e20 20 20 20 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c pPage->aiOvfl
36e30 5b 6a 5d 20 3d 20 28 75 31 36 29 69 3b 0a 0a 20 [j] = (u16)i;..
36e40 20 20 20 2f 2a 20 57 68 65 6e 20 6d 75 6c 74 69 /* When multi
36e50 70 6c 65 20 6f 76 65 72 66 6c 6f 77 73 20 6f 63 ple overflows oc
36e60 63 75 72 2c 20 74 68 65 79 20 61 72 65 20 61 6c cur, they are al
36e70 77 61 79 73 20 73 65 71 75 65 6e 74 69 61 6c 20 ways sequential
36e80 61 6e 64 20 69 6e 0a 20 20 20 20 2a 2a 20 73 6f and in. ** so
36e90 72 74 65 64 20 6f 72 64 65 72 2e 20 20 54 68 69 rted order. Thi
36ea0 73 20 69 6e 76 61 72 69 61 6e 74 73 20 61 72 69 s invariants ari
36eb0 73 65 20 62 65 63 61 75 73 65 20 6d 75 6c 74 69 se because multi
36ec0 70 6c 65 20 6f 76 65 72 66 6c 6f 77 73 20 63 61 ple overflows ca
36ed0 6e 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 6f 63 n. ** only oc
36ee0 63 75 72 20 77 68 65 6e 20 69 6e 73 65 72 74 69 cur when inserti
36ef0 6e 67 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 ng divider cells
36f00 20 69 6e 74 6f 20 74 68 65 20 70 61 72 65 6e 74 into the parent
36f10 20 70 61 67 65 20 64 75 72 69 6e 67 0a 20 20 20 page during.
36f20 20 2a 2a 20 62 61 6c 61 6e 63 69 6e 67 2c 20 61 ** balancing, a
36f30 6e 64 20 74 68 65 20 64 69 76 69 64 65 72 73 20 nd the dividers
36f40 61 72 65 20 61 64 6a 61 63 65 6e 74 20 61 6e 64 are adjacent and
36f50 20 73 6f 72 74 65 64 2e 0a 20 20 20 20 2a 2f 0a sorted.. */.
36f60 20 20 20 20 61 73 73 65 72 74 28 20 6a 3d 3d 30 assert( j==0
36f70 20 7c 7c 20 70 50 61 67 65 2d 3e 61 69 4f 76 66 || pPage->aiOvf
36f80 6c 5b 6a 2d 31 5d 3c 28 75 31 36 29 69 20 29 3b l[j-1]<(u16)i );
36f90 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 73 20 69 6e /* Overflows in
36fa0 20 73 6f 72 74 65 64 20 6f 72 64 65 72 20 2a 2f sorted order */
36fb0 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a 3d 3d . assert( j==
36fc0 30 20 7c 7c 20 69 3d 3d 70 50 61 67 65 2d 3e 61 0 || i==pPage->a
36fd0 69 4f 76 66 6c 5b 6a 2d 31 5d 2b 31 20 29 3b 20 iOvfl[j-1]+1 );
36fe0 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 73 20 61 /* Overflows a
36ff0 72 65 20 73 65 71 75 65 6e 74 69 61 6c 20 2a 2f re sequential */
37000 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e . }else{. in
37010 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 t rc = sqlite3Pa
37020 67 65 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e gerWrite(pPage->
37030 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 pDbPage);. if
37040 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
37050 29 7b 0a 20 20 20 20 20 20 2a 70 52 43 20 3d 20 ){. *pRC =
37060 72 63 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e rc;. return
37070 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
37080 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
37090 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
370a0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
370b0 20 20 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d data = pPage-
370c0 3e 61 44 61 74 61 3b 0a 20 20 20 20 61 73 73 65 >aData;. asse
370d0 72 74 28 20 26 64 61 74 61 5b 70 50 61 67 65 2d rt( &data[pPage-
370e0 3e 63 65 6c 6c 4f 66 66 73 65 74 5d 3d 3d 70 50 >cellOffset]==pP
370f0 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 20 29 3b age->aCellIdx );
37100 0a 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 . rc = alloca
37110 74 65 53 70 61 63 65 28 70 50 61 67 65 2c 20 73 teSpace(pPage, s
37120 7a 2c 20 26 69 64 78 29 3b 0a 20 20 20 20 69 66 z, &idx);. if
37130 28 20 72 63 20 29 7b 20 2a 70 52 43 20 3d 20 72 ( rc ){ *pRC = r
37140 63 3b 20 72 65 74 75 72 6e 3b 20 7d 0a 20 20 20 c; return; }.
37150 20 2f 2a 20 54 68 65 20 61 6c 6c 6f 63 61 74 65 /* The allocate
37160 53 70 61 63 65 28 29 20 72 6f 75 74 69 6e 65 20 Space() routine
37170 67 75 61 72 61 6e 74 65 65 73 20 74 68 65 20 66 guarantees the f
37180 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 70 65 72 74 ollowing propert
37190 69 65 73 0a 20 20 20 20 2a 2a 20 69 66 20 69 74 ies. ** if it
371a0 20 72 65 74 75 72 6e 73 20 73 75 63 63 65 73 73 returns success
371b0 66 75 6c 6c 79 20 2a 2f 0a 20 20 20 20 61 73 73 fully */. ass
371c0 65 72 74 28 20 69 64 78 20 3e 3d 20 30 20 29 3b ert( idx >= 0 );
371d0 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 64 78 . assert( idx
371e0 20 3e 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f >= pPage->cellO
371f0 66 66 73 65 74 2b 32 2a 70 50 61 67 65 2d 3e 6e ffset+2*pPage->n
37200 43 65 6c 6c 2b 32 20 7c 7c 20 43 4f 52 52 55 50 Cell+2 || CORRUP
37210 54 5f 44 42 20 29 3b 0a 20 20 20 20 61 73 73 65 T_DB );. asse
37220 72 74 28 20 69 64 78 2b 73 7a 20 3c 3d 20 28 69 rt( idx+sz <= (i
37230 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 nt)pPage->pBt->u
37240 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 sableSize );.
37250 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2d 3d pPage->nFree -=
37260 20 28 75 31 36 29 28 32 20 2b 20 73 7a 29 3b 0a (u16)(2 + sz);.
37270 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 memcpy(&data
37280 5b 69 64 78 5d 2c 20 70 43 65 6c 6c 2c 20 73 7a [idx], pCell, sz
37290 29 3b 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c );. if( iChil
372a0 64 20 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 d ){. put4b
372b0 79 74 65 28 26 64 61 74 61 5b 69 64 78 5d 2c 20 yte(&data[idx],
372c0 69 43 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 iChild);. }.
372d0 20 20 20 70 49 6e 73 20 3d 20 70 50 61 67 65 2d pIns = pPage-
372e0 3e 61 43 65 6c 6c 49 64 78 20 2b 20 69 2a 32 3b >aCellIdx + i*2;
372f0 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 49 6e . memmove(pIn
37300 73 2b 32 2c 20 70 49 6e 73 2c 20 32 2a 28 70 50 s+2, pIns, 2*(pP
37310 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 29 29 age->nCell - i))
37320 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 70 ;. put2byte(p
37330 49 6e 73 2c 20 69 64 78 29 3b 0a 20 20 20 20 70 Ins, idx);. p
37340 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 2b 3b 0a 20 Page->nCell++;.
37350 20 20 20 2f 2a 20 69 6e 63 72 65 6d 65 6e 74 20 /* increment
37360 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 20 2a the cell count *
37370 2f 0a 20 20 20 20 69 66 28 20 28 2b 2b 64 61 74 /. if( (++dat
37380 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
37390 65 74 2b 34 5d 29 3d 3d 30 20 29 20 64 61 74 61 et+4])==0 ) data
373a0 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
373b0 74 2b 33 5d 2b 2b 3b 0a 20 20 20 20 61 73 73 65 t+3]++;. asse
373c0 72 74 28 20 67 65 74 32 62 79 74 65 28 26 64 61 rt( get2byte(&da
373d0 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 ta[pPage->hdrOff
373e0 73 65 74 2b 33 5d 29 3d 3d 70 50 61 67 65 2d 3e set+3])==pPage->
373f0 6e 43 65 6c 6c 20 29 3b 0a 23 69 66 6e 64 65 66 nCell );.#ifndef
37400 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
37410 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 OVACUUM. if(
37420 70 50 61 67 65 2d 3e 70 42 74 2d 3e 61 75 74 6f pPage->pBt->auto
37430 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 20 Vacuum ){.
37440 2f 2a 20 54 68 65 20 63 65 6c 6c 20 6d 61 79 20 /* The cell may
37450 63 6f 6e 74 61 69 6e 20 61 20 70 6f 69 6e 74 65 contain a pointe
37460 72 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 r to an overflow
37470 20 70 61 67 65 2e 20 49 66 20 73 6f 2c 20 77 72 page. If so, wr
37480 69 74 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 ite. ** the
37490 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 6f entry for the o
374a0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 74 verflow page int
374b0 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 o the pointer ma
374c0 70 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 p.. */.
374d0 20 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 ptrmapPutOvflP
374e0 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c tr(pPage, pCell,
374f0 20 70 52 43 29 3b 0a 20 20 20 20 7d 0a 23 65 6e pRC);. }.#en
37500 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a dif. }.}../*.**
37510 20 41 20 43 65 6c 6c 41 72 72 61 79 20 6f 62 6a A CellArray obj
37520 65 63 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 ect contains a c
37530 61 63 68 65 20 6f 66 20 70 6f 69 6e 74 65 72 73 ache of pointers
37540 20 61 6e 64 20 73 69 7a 65 73 20 66 6f 72 20 61 and sizes for a
37550 0a 2a 2a 20 63 6f 6e 73 65 63 75 74 69 76 65 20 .** consecutive
37560 73 65 71 75 65 6e 63 65 20 6f 66 20 63 65 6c 6c sequence of cell
37570 73 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 20 s that might be
37580 68 65 6c 64 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 held on multiple
37590 20 70 61 67 65 73 2e 0a 2a 2f 0a 74 79 70 65 64 pages..*/.typed
375a0 65 66 20 73 74 72 75 63 74 20 43 65 6c 6c 41 72 ef struct CellAr
375b0 72 61 79 20 43 65 6c 6c 41 72 72 61 79 3b 0a 73 ray CellArray;.s
375c0 74 72 75 63 74 20 43 65 6c 6c 41 72 72 61 79 20 truct CellArray
375d0 7b 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 {. int nCell;
375e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
375f0 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 umber of cells i
37600 6e 20 61 70 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 20 n apCell[] */.
37610 4d 65 6d 50 61 67 65 20 2a 70 52 65 66 3b 20 20 MemPage *pRef;
37620 20 20 20 20 20 20 20 20 2f 2a 20 52 65 66 65 72 /* Refer
37630 65 6e 63 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 ence page */. u
37640 38 20 2a 2a 61 70 43 65 6c 6c 3b 20 20 20 20 20 8 **apCell;
37650 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 63 65 /* All ce
37660 6c 6c 73 20 62 65 67 69 6e 20 62 61 6c 61 6e 63 lls begin balanc
37670 65 64 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 ed */. u16 *szC
37680 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
37690 2f 2a 20 4c 6f 63 61 6c 20 73 69 7a 65 20 6f 66 /* Local size of
376a0 20 61 6c 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 all cells in ap
376b0 43 65 6c 6c 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a Cell[] */.};../*
376c0 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 .** Make sure th
376d0 65 20 63 65 6c 6c 20 73 69 7a 65 73 20 61 74 20 e cell sizes at
376e0 69 64 78 2c 20 69 64 78 2b 31 2c 20 2e 2e 2e 2c idx, idx+1, ...,
376f0 20 69 64 78 2b 4e 2d 31 20 68 61 76 65 20 62 65 idx+N-1 have be
37700 65 6e 0a 2a 2a 20 63 6f 6d 70 75 74 65 64 2e 0a en.** computed..
37710 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
37720 6f 70 75 6c 61 74 65 43 65 6c 6c 43 61 63 68 65 opulateCellCache
37730 28 43 65 6c 6c 41 72 72 61 79 20 2a 70 2c 20 69 (CellArray *p, i
37740 6e 74 20 69 64 78 2c 20 69 6e 74 20 4e 29 7b 0a nt idx, int N){.
37750 20 20 61 73 73 65 72 74 28 20 69 64 78 3e 3d 30 assert( idx>=0
37760 20 26 26 20 69 64 78 2b 4e 3c 3d 70 2d 3e 6e 43 && idx+N<=p->nC
37770 65 6c 6c 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 ell );. while(
37780 4e 3e 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 N>0 ){. asser
37790 74 28 20 70 2d 3e 61 70 43 65 6c 6c 5b 69 64 78 t( p->apCell[idx
377a0 5d 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 ]!=0 );. if(
377b0 70 2d 3e 73 7a 43 65 6c 6c 5b 69 64 78 5d 3d 3d p->szCell[idx]==
377c0 30 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 73 7a 0 ){. p->sz
377d0 43 65 6c 6c 5b 69 64 78 5d 20 3d 20 70 2d 3e 70 Cell[idx] = p->p
377e0 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 Ref->xCellSize(p
377f0 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c ->pRef, p->apCel
37800 6c 5b 69 64 78 5d 29 3b 0a 20 20 20 20 7d 65 6c l[idx]);. }el
37810 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 se{. assert
37820 28 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 0a ( CORRUPT_DB ||.
37830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 2d p-
37840 3e 73 7a 43 65 6c 6c 5b 69 64 78 5d 3d 3d 70 2d >szCell[idx]==p-
37850 3e 70 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 >pRef->xCellSize
37860 28 70 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 (p->pRef, p->apC
37870 65 6c 6c 5b 69 64 78 5d 29 20 29 3b 0a 20 20 20 ell[idx]) );.
37880 20 7d 0a 20 20 20 20 69 64 78 2b 2b 3b 0a 20 20 }. idx++;.
37890 20 20 4e 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a N--;. }.}../*
378a0 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 .** Return the s
378b0 69 7a 65 20 6f 66 20 74 68 65 20 4e 74 68 20 65 ize of the Nth e
378c0 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 63 65 lement of the ce
378d0 6c 6c 20 61 72 72 61 79 0a 2a 2f 0a 73 74 61 74 ll array.*/.stat
378e0 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 ic SQLITE_NOINLI
378f0 4e 45 20 75 31 36 20 63 6f 6d 70 75 74 65 43 65 NE u16 computeCe
37900 6c 6c 53 69 7a 65 28 43 65 6c 6c 41 72 72 61 79 llSize(CellArray
37910 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 61 *p, int N){. a
37920 73 73 65 72 74 28 20 4e 3e 3d 30 20 26 26 20 4e ssert( N>=0 && N
37930 3c 70 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 <p->nCell );. a
37940 73 73 65 72 74 28 20 70 2d 3e 73 7a 43 65 6c 6c ssert( p->szCell
37950 5b 4e 5d 3d 3d 30 20 29 3b 0a 20 20 70 2d 3e 73 [N]==0 );. p->s
37960 7a 43 65 6c 6c 5b 4e 5d 20 3d 20 70 2d 3e 70 52 zCell[N] = p->pR
37970 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 2d ef->xCellSize(p-
37980 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c 6c >pRef, p->apCell
37990 5b 4e 5d 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 [N]);. return p
379a0 2d 3e 73 7a 43 65 6c 6c 5b 4e 5d 3b 0a 7d 0a 73 ->szCell[N];.}.s
379b0 74 61 74 69 63 20 75 31 36 20 63 61 63 68 65 64 tatic u16 cached
379c0 43 65 6c 6c 53 69 7a 65 28 43 65 6c 6c 41 72 72 CellSize(CellArr
379d0 61 79 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 ay *p, int N){.
379e0 20 61 73 73 65 72 74 28 20 4e 3e 3d 30 20 26 26 assert( N>=0 &&
379f0 20 4e 3c 70 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 N<p->nCell );.
37a00 20 69 66 28 20 70 2d 3e 73 7a 43 65 6c 6c 5b 4e if( p->szCell[N
37a10 5d 20 29 20 72 65 74 75 72 6e 20 70 2d 3e 73 7a ] ) return p->sz
37a20 43 65 6c 6c 5b 4e 5d 3b 0a 20 20 72 65 74 75 72 Cell[N];. retur
37a30 6e 20 63 6f 6d 70 75 74 65 43 65 6c 6c 53 69 7a n computeCellSiz
37a40 65 28 70 2c 20 4e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a e(p, N);.}../*.*
37a50 2a 20 41 72 72 61 79 20 61 70 43 65 6c 6c 5b 5d * Array apCell[]
37a60 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 contains pointe
37a70 72 73 20 74 6f 20 6e 43 65 6c 6c 20 62 2d 74 72 rs to nCell b-tr
37a80 65 65 20 70 61 67 65 20 63 65 6c 6c 73 2e 20 54 ee page cells. T
37a90 68 65 20 0a 2a 2a 20 73 7a 43 65 6c 6c 5b 5d 20 he .** szCell[]
37aa0 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 73 20 74 array contains t
37ab0 68 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 he size in bytes
37ac0 20 6f 66 20 65 61 63 68 20 63 65 6c 6c 2e 20 54 of each cell. T
37ad0 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 his function.**
37ae0 72 65 70 6c 61 63 65 73 20 74 68 65 20 63 75 72 replaces the cur
37af0 72 65 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f 66 rent contents of
37b00 20 70 61 67 65 20 70 50 67 20 77 69 74 68 20 74 page pPg with t
37b10 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 he contents of t
37b20 68 65 20 63 65 6c 6c 0a 2a 2a 20 61 72 72 61 79 he cell.** array
37b30 2e 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 6f 66 20 ..**.** Some of
37b40 74 68 65 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 the cells in apC
37b50 65 6c 6c 5b 5d 20 6d 61 79 20 63 75 72 72 65 6e ell[] may curren
37b60 74 6c 79 20 62 65 20 73 74 6f 72 65 64 20 69 6e tly be stored in
37b70 20 70 50 67 2e 20 54 68 69 73 0a 2a 2a 20 66 75 pPg. This.** fu
37b80 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 61 72 6f nction works aro
37b90 75 6e 64 20 70 72 6f 62 6c 65 6d 73 20 63 61 75 und problems cau
37ba0 73 65 64 20 62 79 20 74 68 69 73 20 62 79 20 6d sed by this by m
37bb0 61 6b 69 6e 67 20 61 20 63 6f 70 79 20 6f 66 20 aking a copy of
37bc0 61 6e 79 20 0a 2a 2a 20 73 75 63 68 20 63 65 6c any .** such cel
37bd0 6c 73 20 62 65 66 6f 72 65 20 6f 76 65 72 77 72 ls before overwr
37be0 69 74 69 6e 67 20 74 68 65 20 70 61 67 65 20 64 iting the page d
37bf0 61 74 61 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4d ata..**.** The M
37c00 65 6d 50 61 67 65 2e 6e 46 72 65 65 20 66 69 65 emPage.nFree fie
37c10 6c 64 20 69 73 20 69 6e 76 61 6c 69 64 61 74 65 ld is invalidate
37c20 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
37c30 6f 6e 2e 20 49 74 20 69 73 20 74 68 65 20 0a 2a on. It is the .*
37c40 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 * responsibility
37c50 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 of the caller t
37c60 6f 20 73 65 74 20 69 74 20 63 6f 72 72 65 63 74 o set it correct
37c70 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ly..*/.static in
37c80 74 20 72 65 62 75 69 6c 64 50 61 67 65 28 0a 20 t rebuildPage(.
37c90 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 MemPage *pPg,
37ca0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37cb0 20 2f 2a 20 45 64 69 74 20 74 68 69 73 20 70 61 /* Edit this pa
37cc0 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c ge */. int nCel
37cd0 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
37ce0 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6e 61 6c /* Final
37cf0 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 number of cells
37d00 20 6f 6e 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 on page */. u8
37d10 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 **apCell,
37d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
37d30 20 41 72 72 61 79 20 6f 66 20 63 65 6c 6c 73 20 Array of cells
37d40 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c 6c */. u16 *szCell
37d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37d60 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 /* Array of
37d70 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a 2f 0a 29 cell sizes */.)
37d80 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 64 {. const int hd
37d90 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 73 r = pPg->hdrOffs
37da0 65 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 et; /*
37db0 4f 66 66 73 65 74 20 6f 66 20 68 65 61 64 65 72 Offset of header
37dc0 20 6f 6e 20 70 50 67 20 2a 2f 0a 20 20 75 38 20 on pPg */. u8
37dd0 2a 20 63 6f 6e 73 74 20 61 44 61 74 61 20 3d 20 * const aData =
37de0 70 50 67 2d 3e 61 44 61 74 61 3b 20 20 20 20 20 pPg->aData;
37df0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
37e00 20 74 6f 20 64 61 74 61 20 66 6f 72 20 70 50 67 to data for pPg
37e10 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 */. const int
37e20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 67 usableSize = pPg
37e30 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
37e40 65 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 e;. u8 * const
37e50 70 45 6e 64 20 3d 20 26 61 44 61 74 61 5b 75 73 pEnd = &aData[us
37e60 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 69 6e 74 ableSize];. int
37e70 20 69 3b 0a 20 20 75 38 20 2a 70 43 65 6c 6c 70 i;. u8 *pCellp
37e80 74 72 20 3d 20 70 50 67 2d 3e 61 43 65 6c 6c 49 tr = pPg->aCellI
37e90 64 78 3b 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d dx;. u8 *pTmp =
37ea0 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 65 6d sqlite3PagerTem
37eb0 70 53 70 61 63 65 28 70 50 67 2d 3e 70 42 74 2d pSpace(pPg->pBt-
37ec0 3e 70 50 61 67 65 72 29 3b 0a 20 20 75 38 20 2a >pPager);. u8 *
37ed0 70 44 61 74 61 3b 0a 0a 20 20 69 20 3d 20 67 65 pData;.. i = ge
37ee0 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 68 64 t2byte(&aData[hd
37ef0 72 2b 35 5d 29 3b 0a 20 20 6d 65 6d 63 70 79 28 r+5]);. memcpy(
37f00 26 70 54 6d 70 5b 69 5d 2c 20 26 61 44 61 74 61 &pTmp[i], &aData
37f10 5b 69 5d 2c 20 75 73 61 62 6c 65 53 69 7a 65 20 [i], usableSize
37f20 2d 20 69 29 3b 0a 0a 20 20 70 44 61 74 61 20 3d - i);.. pData =
37f30 20 70 45 6e 64 3b 0a 20 20 66 6f 72 28 69 3d 30 pEnd;. for(i=0
37f40 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b ; i<nCell; i++){
37f50 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d . u8 *pCell =
37f60 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 apCell[i];.
37f70 69 66 28 20 53 51 4c 49 54 45 5f 57 49 54 48 49 if( SQLITE_WITHI
37f80 4e 28 70 43 65 6c 6c 2c 61 44 61 74 61 2c 70 45 N(pCell,aData,pE
37f90 6e 64 29 20 29 7b 0a 20 20 20 20 20 20 70 43 65 nd) ){. pCe
37fa0 6c 6c 20 3d 20 26 70 54 6d 70 5b 70 43 65 6c 6c ll = &pTmp[pCell
37fb0 20 2d 20 61 44 61 74 61 5d 3b 0a 20 20 20 20 7d - aData];. }
37fc0 0a 20 20 20 20 70 44 61 74 61 20 2d 3d 20 73 7a . pData -= sz
37fd0 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 70 75 74 Cell[i];. put
37fe0 32 62 79 74 65 28 70 43 65 6c 6c 70 74 72 2c 20 2byte(pCellptr,
37ff0 28 70 44 61 74 61 20 2d 20 61 44 61 74 61 29 29 (pData - aData))
38000 3b 0a 20 20 20 20 70 43 65 6c 6c 70 74 72 20 2b ;. pCellptr +
38010 3d 20 32 3b 0a 20 20 20 20 69 66 28 20 70 44 61 = 2;. if( pDa
38020 74 61 20 3c 20 70 43 65 6c 6c 70 74 72 20 29 20 ta < pCellptr )
38030 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
38040 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
38050 6d 65 6d 63 70 79 28 70 44 61 74 61 2c 20 70 43 memcpy(pData, pC
38060 65 6c 6c 2c 20 73 7a 43 65 6c 6c 5b 69 5d 29 3b ell, szCell[i]);
38070 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 7a 43 . assert( szC
38080 65 6c 6c 5b 69 5d 3d 3d 70 50 67 2d 3e 78 43 65 ell[i]==pPg->xCe
38090 6c 6c 53 69 7a 65 28 70 50 67 2c 20 70 43 65 6c llSize(pPg, pCel
380a0 6c 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 l) || CORRUPT_DB
380b0 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 );. testcase
380c0 28 20 73 7a 43 65 6c 6c 5b 69 5d 21 3d 70 50 67 ( szCell[i]!=pPg
380d0 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 67 2c ->xCellSize(pPg,
380e0 70 43 65 6c 6c 29 20 29 3b 0a 20 20 7d 0a 0a 20 pCell) );. }..
380f0 20 2f 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 72 /* The pPg->nFr
38100 65 65 20 66 69 65 6c 64 20 69 73 20 6e 6f 77 20 ee field is now
38110 73 65 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 2e set incorrectly.
38120 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c The caller will
38130 20 66 69 78 20 69 74 2e 20 2a 2f 0a 20 20 70 50 fix it. */. pP
38140 67 2d 3e 6e 43 65 6c 6c 20 3d 20 6e 43 65 6c 6c g->nCell = nCell
38150 3b 0a 20 20 70 50 67 2d 3e 6e 4f 76 65 72 66 6c ;. pPg->nOverfl
38160 6f 77 20 3d 20 30 3b 0a 0a 20 20 70 75 74 32 62 ow = 0;.. put2b
38170 79 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b 31 yte(&aData[hdr+1
38180 5d 2c 20 30 29 3b 0a 20 20 70 75 74 32 62 79 74 ], 0);. put2byt
38190 65 28 26 61 44 61 74 61 5b 68 64 72 2b 33 5d 2c e(&aData[hdr+3],
381a0 20 70 50 67 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 pPg->nCell);.
381b0 70 75 74 32 62 79 74 65 28 26 61 44 61 74 61 5b put2byte(&aData[
381c0 68 64 72 2b 35 5d 2c 20 70 44 61 74 61 20 2d 20 hdr+5], pData -
381d0 61 44 61 74 61 29 3b 0a 20 20 61 44 61 74 61 5b aData);. aData[
381e0 68 64 72 2b 37 5d 20 3d 20 30 78 30 30 3b 0a 20 hdr+7] = 0x00;.
381f0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
38200 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 61 K;.}../*.** Arra
38210 79 20 61 70 43 65 6c 6c 5b 5d 20 63 6f 6e 74 61 y apCell[] conta
38220 69 6e 73 20 6e 43 65 6c 6c 20 70 6f 69 6e 74 65 ins nCell pointe
38230 72 73 20 74 6f 20 62 2d 74 72 65 65 20 63 65 6c rs to b-tree cel
38240 6c 73 2e 20 41 72 72 61 79 20 73 7a 43 65 6c 6c ls. Array szCell
38250 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 .** contains the
38260 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f size in bytes o
38270 66 20 65 61 63 68 20 73 75 63 68 20 63 65 6c 6c f each such cell
38280 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
38290 61 74 74 65 6d 70 74 73 20 74 6f 20 0a 2a 2a 20 attempts to .**
382a0 61 64 64 20 74 68 65 20 63 65 6c 6c 73 20 73 74 add the cells st
382b0 6f 72 65 64 20 69 6e 20 74 68 65 20 61 72 72 61 ored in the arra
382c0 79 20 74 6f 20 70 61 67 65 20 70 50 67 2e 20 49 y to page pPg. I
382d0 66 20 69 74 20 63 61 6e 6e 6f 74 20 28 62 65 63 f it cannot (bec
382e0 61 75 73 65 20 0a 2a 2a 20 74 68 65 20 70 61 67 ause .** the pag
382f0 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 64 65 e needs to be de
38300 66 72 61 67 6d 65 6e 74 65 64 20 62 65 66 6f 72 fragmented befor
38310 65 20 74 68 65 20 63 65 6c 6c 73 20 77 69 6c 6c e the cells will
38320 20 66 69 74 29 2c 20 6e 6f 6e 2d 7a 65 72 6f 0a fit), non-zero.
38330 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 ** is returned.
38340 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 Otherwise, if th
38350 65 20 63 65 6c 6c 73 20 61 72 65 20 61 64 64 65 e cells are adde
38360 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 d successfully,
38370 7a 65 72 6f 20 69 73 0a 2a 2a 20 72 65 74 75 72 zero is.** retur
38380 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d ned..**.** Argum
38390 65 6e 74 20 70 43 65 6c 6c 70 74 72 20 70 6f 69 ent pCellptr poi
383a0 6e 74 73 20 74 6f 20 74 68 65 20 66 69 72 73 74 nts to the first
383b0 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 63 65 entry in the ce
383c0 6c 6c 2d 70 6f 69 6e 74 65 72 20 61 72 72 61 79 ll-pointer array
383d0 0a 2a 2a 20 28 70 61 72 74 20 6f 66 20 70 61 67 .** (part of pag
383e0 65 20 70 50 67 29 20 74 6f 20 70 6f 70 75 6c 61 e pPg) to popula
383f0 74 65 2e 20 41 66 74 65 72 20 63 65 6c 6c 20 61 te. After cell a
38400 70 43 65 6c 6c 5b 30 5d 20 69 73 20 77 72 69 74 pCell[0] is writ
38410 74 65 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 70 61 ten to the.** pa
38420 67 65 20 62 6f 64 79 2c 20 61 20 31 36 2d 62 69 ge body, a 16-bi
38430 74 20 6f 66 66 73 65 74 20 69 73 20 77 72 69 74 t offset is writ
38440 74 65 6e 20 74 6f 20 70 43 65 6c 6c 70 74 72 2e ten to pCellptr.
38450 20 41 6e 64 20 73 6f 20 6f 6e 2c 20 66 6f 72 20 And so on, for
38460 65 61 63 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 each.** cell in
38470 74 68 65 20 61 72 72 61 79 2e 20 49 74 20 69 73 the array. It is
38480 20 74 68 65 20 72 65 7