0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 41 70 72 69 6c /*.** 2004 April
0010: 20 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 6.**.** The aut
0020: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f hor disclaims co
0030: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 pyright to this
0040: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e source code. In
0050: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c place of.** a l
0060: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 egal notice, her
0070: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a e is a blessing:
0080: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f .**.** May yo
0090: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f u do good and no
00a0: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 t evil..** Ma
00b0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 y you find forgi
00c0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 veness for yours
00d0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 elf and forgive
00e0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 others..** Ma
00f0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 y you share free
0100: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 ly, never taking
0110: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 more than you g
0120: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a ive..**.********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 69 *.** This file i
0180: 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 65 78 74 mplements an ext
0190: 65 72 6e 61 6c 20 28 64 69 73 6b 2d 62 61 73 65 ernal (disk-base
01a0: 64 29 20 64 61 74 61 62 61 73 65 20 75 73 69 6e d) database usin
01b0: 67 20 42 54 72 65 65 73 2e 0a 2a 2a 20 53 65 65 g BTrees..** See
01c0: 20 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d 6d the header comm
01d0: 65 6e 74 20 6f 6e 20 22 62 74 72 65 65 49 6e 74 ent on "btreeInt
01e0: 2e 68 22 20 66 6f 72 20 61 64 64 69 74 69 6f 6e .h" for addition
01f0: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a al information..
0200: 2a 2a 20 49 6e 63 6c 75 64 69 6e 67 20 61 20 64 ** Including a d
0210: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 66 69 escription of fi
0220: 6c 65 20 66 6f 72 6d 61 74 20 61 6e 64 20 61 6e le format and an
0230: 20 6f 76 65 72 76 69 65 77 20 6f 66 20 6f 70 65 overview of ope
0240: 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 6e 63 6c ration..*/.#incl
0250: 75 64 65 20 22 62 74 72 65 65 49 6e 74 2e 68 22 ude "btreeInt.h"
0260: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 ../*.** The head
0270: 65 72 20 73 74 72 69 6e 67 20 74 68 61 74 20 61 er string that a
0280: 70 70 65 61 72 73 20 61 74 20 74 68 65 20 62 65 ppears at the be
0290: 67 69 6e 6e 69 6e 67 20 6f 66 20 65 76 65 72 79 ginning of every
02a0: 0a 2a 2a 20 53 51 4c 69 74 65 20 64 61 74 61 62 .** SQLite datab
02b0: 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 ase..*/.static c
02c0: 6f 6e 73 74 20 63 68 61 72 20 7a 4d 61 67 69 63 onst char zMagic
02d0: 48 65 61 64 65 72 5b 5d 20 3d 20 53 51 4c 49 54 Header[] = SQLIT
02e0: 45 5f 46 49 4c 45 5f 48 45 41 44 45 52 3b 0a 0a E_FILE_HEADER;..
02f0: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 69 73 20 67 /*.** Set this g
0300: 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 74 lobal variable t
0310: 6f 20 31 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 o 1 to enable tr
0320: 61 63 69 6e 67 20 75 73 69 6e 67 20 74 68 65 20 acing using the
0330: 54 52 41 43 45 0a 2a 2a 20 6d 61 63 72 6f 2e 0a TRACE.** macro..
0340: 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 71 6c */.#if 0.int sql
0350: 69 74 65 33 42 74 72 65 65 54 72 61 63 65 3d 31 ite3BtreeTrace=1
0360: 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e ; /* True to en
0370: 61 62 6c 65 20 74 72 61 63 69 6e 67 20 2a 2f 0a able tracing */.
0380: 23 20 64 65 66 69 6e 65 20 54 52 41 43 45 28 58 # define TRACE(X
0390: 29 20 20 69 66 28 73 71 6c 69 74 65 33 42 74 72 ) if(sqlite3Btr
03a0: 65 65 54 72 61 63 65 29 7b 70 72 69 6e 74 66 20 eeTrace){printf
03b0: 58 3b 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 X;fflush(stdout)
03c0: 3b 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e ;}.#else.# defin
03d0: 65 20 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 e TRACE(X).#endi
03e0: 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 f../*.** Extract
03f0: 20 61 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e a 2-byte big-en
0400: 64 69 61 6e 20 69 6e 74 65 67 65 72 20 66 72 6f dian integer fro
0410: 6d 20 61 6e 20 61 72 72 61 79 20 6f 66 20 75 6e m an array of un
0420: 73 69 67 6e 65 64 20 62 79 74 65 73 2e 0a 2a 2a signed bytes..**
0430: 20 42 75 74 20 69 66 20 74 68 65 20 76 61 6c 75 But if the valu
0440: 65 20 69 73 20 7a 65 72 6f 2c 20 6d 61 6b 65 20 e is zero, make
0450: 69 74 20 36 35 35 33 36 2e 0a 2a 2a 0a 2a 2a 20 it 65536..**.**
0460: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
0470: 75 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 used to extract
0480: 74 68 65 20 22 6f 66 66 73 65 74 20 74 6f 20 63 the "offset to c
0490: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
04a0: 22 20 76 61 6c 75 65 0a 2a 2a 20 66 72 6f 6d 20 " value.** from
04b0: 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 the header of a
04c0: 62 74 72 65 65 20 70 61 67 65 2e 20 20 49 66 20 btree page. If
04d0: 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 the page size is
04e0: 20 36 35 35 33 36 20 61 6e 64 20 74 68 65 20 70 65536 and the p
04f0: 61 67 65 0a 2a 2a 20 69 73 20 65 6d 70 74 79 2c age.** is empty,
0500: 20 74 68 65 20 6f 66 66 73 65 74 20 73 68 6f 75 the offset shou
0510: 6c 64 20 62 65 20 36 35 35 33 36 2c 20 62 75 74 ld be 65536, but
0520: 20 74 68 65 20 32 2d 62 79 74 65 20 76 61 6c 75 the 2-byte valu
0530: 65 20 73 74 6f 72 65 73 20 7a 65 72 6f 2e 0a 2a e stores zero..*
0540: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d * This routine m
0550: 61 6b 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 akes the necessa
0560: 72 79 20 61 64 6a 75 73 74 6d 65 6e 74 20 74 6f ry adjustment to
0570: 20 36 35 35 33 36 2e 0a 2a 2f 0a 23 64 65 66 69 65536..*/.#defi
0580: 6e 65 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 ne get2byteNotZe
0590: 72 6f 28 58 29 20 20 28 28 28 28 28 69 6e 74 29 ro(X) (((((int)
05a0: 67 65 74 32 62 79 74 65 28 58 29 29 2d 31 29 26 get2byte(X))-1)&
05b0: 30 78 66 66 66 66 29 2b 31 29 0a 0a 2f 2a 0a 2a 0xffff)+1)../*.*
05c0: 2a 20 56 61 6c 75 65 73 20 70 61 73 73 65 64 20 * Values passed
05d0: 61 73 20 74 68 65 20 35 74 68 20 61 72 67 75 6d as the 5th argum
05e0: 65 6e 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 42 ent to allocateB
05f0: 74 72 65 65 50 61 67 65 28 29 0a 2a 2f 0a 23 64 treePage().*/.#d
0600: 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f 41 4e efine BTALLOC_AN
0610: 59 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 Y 0
0620: 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 79 20 /* Allocate any
0630: 70 61 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 page */.#define
0640: 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 31 20 BTALLOC_EXACT 1
0650: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c /* All
0660: 6f 63 61 74 65 20 65 78 61 63 74 20 70 61 67 65 ocate exact page
0670: 20 69 66 20 70 6f 73 73 69 62 6c 65 20 2a 2f 0a if possible */.
0680: 23 64 65 66 69 6e 65 20 42 54 41 4c 4c 4f 43 5f #define BTALLOC_
0690: 4c 45 20 20 20 20 32 20 20 20 20 20 20 20 20 20 LE 2
06a0: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e /* Allocate an
06b0: 79 20 70 61 67 65 20 3c 3d 20 74 68 65 20 70 61 y page <= the pa
06c0: 72 61 6d 65 74 65 72 20 2a 2f 0a 0a 2f 2a 0a 2a rameter */../*.*
06d0: 2a 20 4d 61 63 72 6f 20 49 66 4e 6f 74 4f 6d 69 * Macro IfNotOmi
06e0: 74 41 56 28 78 29 20 72 65 74 75 72 6e 73 20 28 tAV(x) returns (
06f0: 78 29 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 x) if SQLITE_OMI
0700: 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 T_AUTOVACUUM is
0710: 6e 6f 74 20 0a 2a 2a 20 64 65 66 69 6e 65 64 2c not .** defined,
0720: 20 6f 72 20 30 20 69 66 20 69 74 20 69 73 2e 20 or 0 if it is.
0730: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a For example:.**.
0740: 2a 2a 20 20 20 62 49 6e 63 72 56 61 63 75 75 6d ** bIncrVacuum
0750: 20 3d 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 = IfNotOmitAV(p
0760: 42 74 53 68 61 72 65 64 2d 3e 69 6e 63 72 56 61 BtShared->incrVa
0770: 63 75 75 6d 29 3b 0a 2a 2f 0a 23 69 66 6e 64 65 cuum);.*/.#ifnde
0780: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
0790: 54 4f 56 41 43 55 55 4d 0a 23 64 65 66 69 6e 65 TOVACUUM.#define
07a0: 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 65 78 70 IfNotOmitAV(exp
07b0: 72 29 20 28 65 78 70 72 29 0a 23 65 6c 73 65 0a r) (expr).#else.
07c0: 23 64 65 66 69 6e 65 20 49 66 4e 6f 74 4f 6d 69 #define IfNotOmi
07d0: 74 41 56 28 65 78 70 72 29 20 30 0a 23 65 6e 64 tAV(expr) 0.#end
07e0: 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 if..#ifndef SQLI
07f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0800: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 ACHE./*.** A lis
0810: 74 20 6f 66 20 42 74 53 68 61 72 65 64 20 6f 62 t of BtShared ob
0820: 6a 65 63 74 73 20 74 68 61 74 20 61 72 65 20 65 jects that are e
0830: 6c 69 67 69 62 6c 65 20 66 6f 72 20 70 61 72 74 ligible for part
0840: 69 63 69 70 61 74 69 6f 6e 0a 2a 2a 20 69 6e 20 icipation.** in
0850: 73 68 61 72 65 64 20 63 61 63 68 65 2e 20 20 54 shared cache. T
0860: 68 69 73 20 76 61 72 69 61 62 6c 65 20 68 61 73 his variable has
0870: 20 66 69 6c 65 20 73 63 6f 70 65 20 64 75 72 69 file scope duri
0880: 6e 67 20 6e 6f 72 6d 61 6c 20 62 75 69 6c 64 73 ng normal builds
0890: 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 65 73 ,.** but the tes
08a0: 74 20 68 61 72 6e 65 73 73 20 6e 65 65 64 73 20 t harness needs
08b0: 74 6f 20 61 63 63 65 73 73 20 69 74 20 73 6f 20 to access it so
08c0: 77 65 20 6d 61 6b 65 20 69 74 20 67 6c 6f 62 61 we make it globa
08d0: 6c 20 66 6f 72 20 0a 2a 2a 20 74 65 73 74 20 62 l for .** test b
08e0: 75 69 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 41 63 63 uilds..**.** Acc
08f0: 65 73 73 20 74 6f 20 74 68 69 73 20 76 61 72 69 ess to this vari
0900: 61 62 6c 65 20 69 73 20 70 72 6f 74 65 63 74 65 able is protecte
0910: 64 20 62 79 20 53 51 4c 49 54 45 5f 4d 55 54 45 d by SQLITE_MUTE
0920: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 2e X_STATIC_MASTER.
0930: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
0940: 45 5f 54 45 53 54 0a 42 74 53 68 61 72 65 64 20 E_TEST.BtShared
0950: 2a 53 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 *SQLITE_WSD sqli
0960: 74 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 te3SharedCacheLi
0970: 73 74 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 73 74 st = 0;.#else.st
0980: 61 74 69 63 20 42 74 53 68 61 72 65 64 20 2a 53 atic BtShared *S
0990: 51 4c 49 54 45 5f 57 53 44 20 73 71 6c 69 74 65 QLITE_WSD sqlite
09a0: 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 3SharedCacheList
09b0: 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 23 65 6e = 0;.#endif.#en
09c0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
09d0: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 IT_SHARED_CACHE
09e0: 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */..#ifndef SQLI
09f0: 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
0a00: 41 43 48 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c ACHE./*.** Enabl
0a10: 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 65 e or disable the
0a20: 20 73 68 61 72 65 64 20 70 61 67 65 72 20 61 6e shared pager an
0a30: 64 20 73 63 68 65 6d 61 20 66 65 61 74 75 72 65 d schema feature
0a40: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f s..**.** This ro
0a50: 75 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 utine has no eff
0a60: 65 63 74 20 6f 6e 20 65 78 69 73 74 69 6e 67 20 ect on existing
0a70: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
0a80: 69 6f 6e 73 2e 0a 2a 2a 20 54 68 65 20 73 68 61 ions..** The sha
0a90: 72 65 64 20 63 61 63 68 65 20 73 65 74 74 69 6e red cache settin
0aa0: 67 20 65 66 66 65 63 74 73 20 6f 6e 6c 79 20 66 g effects only f
0ab0: 75 74 75 72 65 20 63 61 6c 6c 73 20 74 6f 0a 2a uture calls to.*
0ac0: 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 * sqlite3_open()
0ad0: 2c 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 , sqlite3_open16
0ae0: 28 29 2c 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f (), or sqlite3_o
0af0: 70 65 6e 5f 76 32 28 29 2e 0a 2a 2f 0a 69 6e 74 pen_v2()..*/.int
0b00: 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f sqlite3_enable_
0b10: 73 68 61 72 65 64 5f 63 61 63 68 65 28 69 6e 74 shared_cache(int
0b20: 20 65 6e 61 62 6c 65 29 7b 0a 20 20 73 71 6c 69 enable){. sqli
0b30: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
0b40: 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c sharedCacheEnabl
0b50: 65 64 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 72 ed = enable;. r
0b60: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
0b70: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 0a 23 69 66 .}.#endif....#if
0b80: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
0b90: 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 2f SHARED_CACHE. /
0ba0: 2a 0a 20 20 2a 2a 20 54 68 65 20 66 75 6e 63 74 *. ** The funct
0bb0: 69 6f 6e 73 20 71 75 65 72 79 53 68 61 72 65 64 ions queryShared
0bc0: 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 CacheTableLock()
0bd0: 2c 20 73 65 74 53 68 61 72 65 64 43 61 63 68 65 , setSharedCache
0be0: 54 61 62 6c 65 4c 6f 63 6b 28 29 2c 0a 20 20 2a TableLock(),. *
0bf0: 2a 20 61 6e 64 20 63 6c 65 61 72 41 6c 6c 53 68 * and clearAllSh
0c00: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0c10: 63 6b 73 28 29 0a 20 20 2a 2a 20 6d 61 6e 69 70 cks(). ** manip
0c20: 75 6c 61 74 65 20 65 6e 74 72 69 65 73 20 69 6e ulate entries in
0c30: 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 4c the BtShared.pL
0c40: 6f 63 6b 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 ock linked list
0c50: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 20 20 used to store.
0c60: 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 ** shared-cache
0c70: 74 61 62 6c 65 20 6c 65 76 65 6c 20 6c 6f 63 6b table level lock
0c80: 73 2e 20 49 66 20 74 68 65 20 6c 69 62 72 61 72 s. If the librar
0c90: 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 y is compiled wi
0ca0: 74 68 20 74 68 65 0a 20 20 2a 2a 20 73 68 61 72 th the. ** shar
0cb0: 65 64 2d 63 61 63 68 65 20 66 65 61 74 75 72 65 ed-cache feature
0cc0: 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 disabled, then
0cd0: 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 65 76 there is only ev
0ce0: 65 72 20 6f 6e 65 20 75 73 65 72 0a 20 20 2a 2a er one user. **
0cf0: 20 6f 66 20 65 61 63 68 20 42 74 53 68 61 72 65 of each BtShare
0d00: 64 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 d structure and
0d10: 73 6f 20 74 68 69 73 20 6c 6f 63 6b 69 6e 67 20 so this locking
0d20: 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 is not necessary
0d30: 2e 20 0a 20 20 2a 2a 20 53 6f 20 64 65 66 69 6e . . ** So defin
0d40: 65 20 74 68 65 20 6c 6f 63 6b 20 72 65 6c 61 74 e the lock relat
0d50: 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 ed functions as
0d60: 6e 6f 2d 6f 70 73 2e 0a 20 20 2a 2f 0a 20 20 23 no-ops.. */. #
0d70: 64 65 66 69 6e 65 20 71 75 65 72 79 53 68 61 72 define queryShar
0d80: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
0d90: 28 61 2c 62 2c 63 29 20 53 51 4c 49 54 45 5f 4f (a,b,c) SQLITE_O
0da0: 4b 0a 20 20 23 64 65 66 69 6e 65 20 73 65 74 53 K. #define setS
0db0: 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
0dc0: 6f 63 6b 28 61 2c 62 2c 63 29 20 53 51 4c 49 54 ock(a,b,c) SQLIT
0dd0: 45 5f 4f 4b 0a 20 20 23 64 65 66 69 6e 65 20 63 E_OK. #define c
0de0: 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 learAllSharedCac
0df0: 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a heTableLocks(a).
0e00: 20 20 23 64 65 66 69 6e 65 20 64 6f 77 6e 67 72 #define downgr
0e10: 61 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 adeAllSharedCach
0e20: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 61 29 0a 20 eTableLocks(a).
0e30: 20 23 64 65 66 69 6e 65 20 68 61 73 53 68 61 72 #define hasShar
0e40: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
0e50: 28 61 2c 62 2c 63 2c 64 29 20 31 0a 20 20 23 64 (a,b,c,d) 1. #d
0e60: 65 66 69 6e 65 20 68 61 73 52 65 61 64 43 6f 6e efine hasReadCon
0e70: 66 6c 69 63 74 73 28 61 2c 20 62 29 20 30 0a 23 flicts(a, b) 0.#
0e80: 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
0e90: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
0ea0: 44 5f 43 41 43 48 45 0a 0a 23 69 66 64 65 66 20 D_CACHE..#ifdef
0eb0: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a SQLITE_DEBUG./*.
0ec0: 2a 2a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 **** This functi
0ed0: 6f 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 on is only used
0ee0: 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 61 73 as part of an as
0ef0: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
0f00: 2e 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 43 68 65 63 . ***.**.** Chec
0f10: 6b 20 74 6f 20 73 65 65 20 69 66 20 70 42 74 72 k to see if pBtr
0f20: 65 65 20 68 6f 6c 64 73 20 74 68 65 20 72 65 71 ee holds the req
0f30: 75 69 72 65 64 20 6c 6f 63 6b 73 20 74 6f 20 72 uired locks to r
0f40: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 6f 20 ead or write to
0f50: 74 68 65 20 0a 2a 2a 20 74 61 62 6c 65 20 77 69 the .** table wi
0f60: 74 68 20 72 6f 6f 74 20 70 61 67 65 20 69 52 6f th root page iRo
0f70: 6f 74 2e 20 20 20 52 65 74 75 72 6e 20 31 20 69 ot. Return 1 i
0f80: 66 20 69 74 20 64 6f 65 73 20 61 6e 64 20 30 20 f it does and 0
0f90: 69 66 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f if not..**.** Fo
0fa0: 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 r example, when
0fb0: 77 72 69 74 69 6e 67 20 74 6f 20 61 20 74 61 62 writing to a tab
0fc0: 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 le with root-pag
0fd0: 65 20 69 52 6f 6f 74 20 76 69 61 20 0a 2a 2a 20 e iRoot via .**
0fe0: 42 74 72 65 65 20 63 6f 6e 6e 65 63 74 69 6f 6e Btree connection
0ff0: 20 70 42 74 72 65 65 3a 0a 2a 2a 0a 2a 2a 20 20 pBtree:.**.**
1000: 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 61 assert( hasSha
1010: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
1020: 6b 28 70 42 74 72 65 65 2c 20 69 52 6f 6f 74 2c k(pBtree, iRoot,
1030: 20 30 2c 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 0, WRITE_LOCK)
1040: 29 3b 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 77 72 );.**.** When wr
1050: 69 74 69 6e 67 20 74 6f 20 61 6e 20 69 6e 64 65 iting to an inde
1060: 78 20 74 68 61 74 20 72 65 73 69 64 65 73 20 69 x that resides i
1070: 6e 20 61 20 73 68 61 72 61 62 6c 65 20 64 61 74 n a sharable dat
1080: 61 62 61 73 65 2c 20 74 68 65 20 0a 2a 2a 20 63 abase, the .** c
1090: 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20 68 61 76 aller should hav
10a0: 65 20 66 69 72 73 74 20 6f 62 74 61 69 6e 65 64 e first obtained
10b0: 20 61 20 6c 6f 63 6b 20 73 70 65 63 69 66 79 69 a lock specifyi
10c0: 6e 67 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 ng the root page
10d0: 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 of.** the corre
10e0: 73 70 6f 6e 64 69 6e 67 20 74 61 62 6c 65 2e 20 sponding table.
10f0: 54 68 69 73 20 6d 61 6b 65 73 20 74 68 69 6e 67 This makes thing
1100: 73 20 61 20 62 69 74 20 6d 6f 72 65 20 63 6f 6d s a bit more com
1110: 70 6c 69 63 61 74 65 64 2c 0a 2a 2a 20 61 73 20 plicated,.** as
1120: 74 68 69 73 20 6d 6f 64 75 6c 65 20 74 72 65 61 this module trea
1130: 74 73 20 65 61 63 68 20 74 61 62 6c 65 20 61 73 ts each table as
1140: 20 61 20 73 65 70 61 72 61 74 65 20 73 74 72 75 a separate stru
1150: 63 74 75 72 65 2e 20 54 6f 20 64 65 74 65 72 6d cture. To determ
1160: 69 6e 65 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 ine.** the table
1170: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
1180: 6f 20 74 68 65 20 69 6e 64 65 78 20 62 65 69 6e o the index bein
1190: 67 20 77 72 69 74 74 65 6e 2c 20 74 68 69 73 0a g written, this.
11a0: 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 ** function has
11b0: 74 6f 20 73 65 61 72 63 68 20 74 68 72 6f 75 67 to search throug
11c0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 h the database s
11d0: 63 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 49 6e 73 chema..**.** Ins
11e0: 74 65 61 64 20 6f 66 20 61 20 6c 6f 63 6b 20 6f tead of a lock o
11f0: 6e 20 74 68 65 20 74 61 62 6c 65 2f 69 6e 64 65 n the table/inde
1200: 78 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 x rooted at page
1210: 20 69 52 6f 6f 74 2c 20 74 68 65 20 63 61 6c 6c iRoot, the call
1220: 65 72 20 6d 61 79 0a 2a 2a 20 68 6f 6c 64 20 61 er may.** hold a
1230: 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 write-lock on t
1240: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 20 he schema table
1250: 28 72 6f 6f 74 20 70 61 67 65 20 31 29 2e 20 54 (root page 1). T
1260: 68 69 73 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 61 his is also.** a
1270: 63 63 65 70 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 cceptable..*/.st
1280: 61 74 69 63 20 69 6e 74 20 68 61 73 53 68 61 72 atic int hasShar
1290: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
12a0: 28 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 (. Btree *pBtre
12b0: 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 e, /* Ha
12c0: 6e 64 6c 65 20 74 68 61 74 20 6d 75 73 74 20 68 ndle that must h
12d0: 6f 6c 64 20 6c 6f 63 6b 20 2a 2f 0a 20 20 50 67 old lock */. Pg
12e0: 6e 6f 20 69 52 6f 6f 74 2c 20 20 20 20 20 20 20 no iRoot,
12f0: 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 /* Root pag
1300: 65 20 6f 66 20 62 2d 74 72 65 65 20 2a 2f 0a 20 e of b-tree */.
1310: 20 69 6e 74 20 69 73 49 6e 64 65 78 2c 20 20 20 int isIndex,
1320: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
1330: 69 66 20 69 52 6f 6f 74 20 69 73 20 74 68 65 20 if iRoot is the
1340: 72 6f 6f 74 20 6f 66 20 61 6e 20 69 6e 64 65 78 root of an index
1350: 20 62 2d 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 b-tree */. int
1360: 20 65 4c 6f 63 6b 54 79 70 65 20 20 20 20 20 20 eLockType
1370: 20 20 20 20 2f 2a 20 52 65 71 75 69 72 65 64 20 /* Required
1380: 6c 6f 63 6b 20 74 79 70 65 20 28 52 45 41 44 5f lock type (READ_
1390: 4c 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f 4c 4f LOCK or WRITE_LO
13a0: 43 4b 29 20 2a 2f 0a 29 7b 0a 20 20 53 63 68 65 CK) */.){. Sche
13b0: 6d 61 20 2a 70 53 63 68 65 6d 61 20 3d 20 28 53 ma *pSchema = (S
13c0: 63 68 65 6d 61 20 2a 29 70 42 74 72 65 65 2d 3e chema *)pBtree->
13d0: 70 42 74 2d 3e 70 53 63 68 65 6d 61 3b 0a 20 20 pBt->pSchema;.
13e0: 50 67 6e 6f 20 69 54 61 62 20 3d 20 30 3b 0a 20 Pgno iTab = 0;.
13f0: 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a BtLock *pLock;.
1400: 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 64 61 . /* If this da
1410: 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 73 68 tabase is not sh
1420: 61 72 65 61 62 6c 65 2c 20 6f 72 20 69 66 20 74 areable, or if t
1430: 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 he client is rea
1440: 64 69 6e 67 0a 20 20 2a 2a 20 61 6e 64 20 68 61 ding. ** and ha
1450: 73 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d s the read-uncom
1460: 6d 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 2c mitted flag set,
1470: 20 74 68 65 6e 20 6e 6f 20 6c 6f 63 6b 20 69 73 then no lock is
1480: 20 72 65 71 75 69 72 65 64 2e 20 0a 20 20 2a 2a required. . **
1490: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 6d 6d Return true imm
14a0: 65 64 69 61 74 65 6c 79 2e 0a 20 20 2a 2f 0a 20 ediately.. */.
14b0: 20 69 66 28 20 28 70 42 74 72 65 65 2d 3e 73 68 if( (pBtree->sh
14c0: 61 72 61 62 6c 65 3d 3d 30 29 0a 20 20 20 7c 7c arable==0). ||
14d0: 20 28 65 4c 6f 63 6b 54 79 70 65 3d 3d 52 45 41 (eLockType==REA
14e0: 44 5f 4c 4f 43 4b 20 26 26 20 28 70 42 74 72 65 D_LOCK && (pBtre
14f0: 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 e->db->flags & S
1500: 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d QLITE_ReadUncomm
1510: 69 74 74 65 64 29 29 0a 20 20 29 7b 0a 20 20 20 itted)). ){.
1520: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a return 1;. }..
1530: 20 20 2f 2a 20 49 66 20 74 68 65 20 63 6c 69 65 /* If the clie
1540: 6e 74 20 69 73 20 72 65 61 64 69 6e 67 20 20 6f nt is reading o
1550: 72 20 77 72 69 74 69 6e 67 20 61 6e 20 69 6e 64 r writing an ind
1560: 65 78 20 61 6e 64 20 74 68 65 20 73 63 68 65 6d ex and the schem
1570: 61 20 69 73 0a 20 20 2a 2a 20 6e 6f 74 20 6c 6f a is. ** not lo
1580: 61 64 65 64 2c 20 74 68 65 6e 20 69 74 20 69 73 aded, then it is
1590: 20 74 6f 6f 20 64 69 66 66 69 63 75 6c 74 20 74 too difficult t
15a0: 6f 20 61 63 74 75 61 6c 6c 79 20 63 68 65 63 6b o actually check
15b0: 20 74 6f 20 73 65 65 20 69 66 0a 20 20 2a 2a 20 to see if. **
15c0: 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 6b the correct lock
15d0: 73 20 61 72 65 20 68 65 6c 64 2e 20 20 53 6f 20 s are held. So
15e0: 64 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 2d 20 do not bother -
15f0: 6a 75 73 74 20 72 65 74 75 72 6e 20 74 72 75 65 just return true
1600: 2e 0a 20 20 2a 2a 20 54 68 69 73 20 63 61 73 65 .. ** This case
1610: 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6d 65 20 75 does not come u
1620: 70 20 76 65 72 79 20 6f 66 74 65 6e 20 61 6e 79 p very often any
1630: 68 6f 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 how.. */. if(
1640: 69 73 49 6e 64 65 78 20 26 26 20 28 21 70 53 63 isIndex && (!pSc
1650: 68 65 6d 61 20 7c 7c 20 28 70 53 63 68 65 6d 61 hema || (pSchema
1660: 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 44 42 ->schemaFlags&DB
1670: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3d 3d _SchemaLoaded)==
1680: 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 0) ){. return
1690: 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 1;. }.. /* Fi
16a0: 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 6f 6f gure out the roo
16b0: 74 2d 70 61 67 65 20 74 68 61 74 20 74 68 65 20 t-page that the
16c0: 6c 6f 63 6b 20 73 68 6f 75 6c 64 20 62 65 20 68 lock should be h
16d0: 65 6c 64 20 6f 6e 2e 20 46 6f 72 20 74 61 62 6c eld on. For tabl
16e0: 65 0a 20 20 2a 2a 20 62 2d 74 72 65 65 73 2c 20 e. ** b-trees,
16f0: 74 68 69 73 20 69 73 20 6a 75 73 74 20 74 68 65 this is just the
1700: 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 68 root page of th
1710: 65 20 62 2d 74 72 65 65 20 62 65 69 6e 67 20 72 e b-tree being r
1720: 65 61 64 20 6f 72 0a 20 20 2a 2a 20 77 72 69 74 ead or. ** writ
1730: 74 65 6e 2e 20 46 6f 72 20 69 6e 64 65 78 20 62 ten. For index b
1740: 2d 74 72 65 65 73 2c 20 69 74 20 69 73 20 74 68 -trees, it is th
1750: 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 e root page of t
1760: 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 he associated.
1770: 2a 2a 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20 20 ** table. */.
1780: 69 66 28 20 69 73 49 6e 64 65 78 20 29 7b 0a 20 if( isIndex ){.
1790: 20 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a HashElem *p;.
17a0: 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 for(p=sqlite
17b0: 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 65 HashFirst(&pSche
17c0: 6d 61 2d 3e 69 64 78 48 61 73 68 29 3b 20 70 3b ma->idxHash); p;
17d0: 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 p=sqliteHashNex
17e0: 74 28 70 29 29 7b 0a 20 20 20 20 20 20 49 6e 64 t(p)){. Ind
17f0: 65 78 20 2a 70 49 64 78 20 3d 20 28 49 6e 64 65 ex *pIdx = (Inde
1800: 78 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 x *)sqliteHashDa
1810: 74 61 28 70 29 3b 0a 20 20 20 20 20 20 69 66 28 ta(p);. if(
1820: 20 70 49 64 78 2d 3e 74 6e 75 6d 3d 3d 28 69 6e pIdx->tnum==(in
1830: 74 29 69 52 6f 6f 74 20 29 7b 0a 20 20 20 20 20 t)iRoot ){.
1840: 20 20 20 69 66 28 20 69 54 61 62 20 29 7b 0a 20 if( iTab ){.
1850: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 77 6f 20 /* Two
1860: 6f 72 20 6d 6f 72 65 20 69 6e 64 65 78 65 73 20 or more indexes
1870: 73 68 61 72 65 20 74 68 65 20 73 61 6d 65 20 72 share the same r
1880: 6f 6f 74 20 70 61 67 65 2e 20 20 54 68 65 72 65 oot page. There
1890: 20 6d 75 73 74 0a 20 20 20 20 20 20 20 20 20 20 must.
18a0: 2a 2a 20 62 65 20 69 6d 70 6f 73 74 65 72 20 74 ** be imposter t
18b0: 61 62 6c 65 73 2e 20 20 53 6f 20 6a 75 73 74 20 ables. So just
18c0: 72 65 74 75 72 6e 20 74 72 75 65 2e 20 20 54 68 return true. Th
18d0: 65 20 61 73 73 65 72 74 20 69 73 20 6e 6f 74 0a e assert is not.
18e0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 75 73 65 ** use
18f0: 66 75 6c 20 69 6e 20 74 68 61 74 20 63 61 73 65 ful in that case
1900: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 72 . */. r
1910: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 20 20 eturn 1;.
1920: 20 7d 0a 20 20 20 20 20 20 20 20 69 54 61 62 20 }. iTab
1930: 3d 20 70 49 64 78 2d 3e 70 54 61 62 6c 65 2d 3e = pIdx->pTable->
1940: 74 6e 75 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 tnum;. }.
1950: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
1960: 20 69 54 61 62 20 3d 20 69 52 6f 6f 74 3b 0a 20 iTab = iRoot;.
1970: 20 7d 0a 0a 20 20 2f 2a 20 53 65 61 72 63 68 20 }.. /* Search
1980: 66 6f 72 20 74 68 65 20 72 65 71 75 69 72 65 64 for the required
1990: 20 6c 6f 63 6b 2e 20 45 69 74 68 65 72 20 61 20 lock. Either a
19a0: 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 72 6f write-lock on ro
19b0: 6f 74 2d 70 61 67 65 20 69 54 61 62 2c 20 61 20 ot-page iTab, a
19c0: 0a 20 20 2a 2a 20 77 72 69 74 65 2d 6c 6f 63 6b . ** write-lock
19d0: 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 20 74 on the schema t
19e0: 61 62 6c 65 2c 20 6f 72 20 28 69 66 20 74 68 65 able, or (if the
19f0: 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 64 69 client is readi
1a00: 6e 67 29 20 61 0a 20 20 2a 2a 20 72 65 61 64 2d ng) a. ** read-
1a10: 6c 6f 63 6b 20 6f 6e 20 69 54 61 62 20 77 69 6c lock on iTab wil
1a20: 6c 20 73 75 66 66 69 63 65 2e 20 52 65 74 75 72 l suffice. Retur
1a30: 6e 20 31 20 69 66 20 61 6e 79 20 6f 66 20 74 68 n 1 if any of th
1a40: 65 73 65 20 61 72 65 20 66 6f 75 6e 64 2e 20 20 ese are found.
1a50: 2a 2f 0a 20 20 66 6f 72 28 70 4c 6f 63 6b 3d 70 */. for(pLock=p
1a60: 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 4c 6f 63 Btree->pBt->pLoc
1a70: 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d k; pLock; pLock=
1a80: 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 pLock->pNext){.
1a90: 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 70 42 if( pLock->pB
1aa0: 74 72 65 65 3d 3d 70 42 74 72 65 65 20 0a 20 20 tree==pBtree .
1ab0: 20 20 20 26 26 20 28 70 4c 6f 63 6b 2d 3e 69 54 && (pLock->iT
1ac0: 61 62 6c 65 3d 3d 69 54 61 62 20 7c 7c 20 28 70 able==iTab || (p
1ad0: 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 49 Lock->eLock==WRI
1ae0: 54 45 5f 4c 4f 43 4b 20 26 26 20 70 4c 6f 63 6b TE_LOCK && pLock
1af0: 2d 3e 69 54 61 62 6c 65 3d 3d 31 29 29 0a 20 20 ->iTable==1)).
1b00: 20 20 20 26 26 20 70 4c 6f 63 6b 2d 3e 65 4c 6f && pLock->eLo
1b10: 63 6b 3e 3d 65 4c 6f 63 6b 54 79 70 65 20 0a 20 ck>=eLockType .
1b20: 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ){. retu
1b30: 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a rn 1;. }. }.
1b40: 0a 20 20 2f 2a 20 46 61 69 6c 65 64 20 74 6f 20 . /* Failed to
1b50: 66 69 6e 64 20 74 68 65 20 72 65 71 75 69 72 65 find the require
1b60: 64 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 72 65 74 d lock. */. ret
1b70: 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 urn 0;.}.#endif
1b80: 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 /* SQLITE_DEBUG
1b90: 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
1ba0: 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a 20 E_DEBUG./*.****
1bb0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 This function ma
1bc0: 79 20 62 65 20 75 73 65 64 20 61 73 20 70 61 72 y be used as par
1bd0: 74 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 t of assert() st
1be0: 61 74 65 6d 65 6e 74 73 20 6f 6e 6c 79 2e 20 2a atements only. *
1bf0: 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e ***.**.** Return
1c00: 20 74 72 75 65 20 69 66 20 69 74 20 77 6f 75 6c true if it woul
1c10: 64 20 62 65 20 69 6c 6c 65 67 61 6c 20 66 6f 72 d be illegal for
1c20: 20 70 42 74 72 65 65 20 74 6f 20 77 72 69 74 65 pBtree to write
1c30: 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 74 61 62 into the.** tab
1c40: 6c 65 20 6f 72 20 69 6e 64 65 78 20 72 6f 6f 74 le or index root
1c50: 65 64 20 61 74 20 69 52 6f 6f 74 20 62 65 63 61 ed at iRoot beca
1c60: 75 73 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 use other shared
1c70: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 72 65 connections are
1c80: 0a 2a 2a 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 .** simultaneous
1c90: 6c 79 20 72 65 61 64 69 6e 67 20 74 68 61 74 20 ly reading that
1ca0: 73 61 6d 65 20 74 61 62 6c 65 20 6f 72 20 69 6e same table or in
1cb0: 64 65 78 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 dex..**.** It is
1cc0: 20 69 6c 6c 65 67 61 6c 20 66 6f 72 20 70 42 74 illegal for pBt
1cd0: 72 65 65 20 74 6f 20 77 72 69 74 65 20 69 66 20 ree to write if
1ce0: 73 6f 6d 65 20 6f 74 68 65 72 20 42 74 72 65 65 some other Btree
1cf0: 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a 2a 20 object that.**
1d00: 73 68 61 72 65 73 20 74 68 65 20 73 61 6d 65 20 shares the same
1d10: 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 20 BtShared object
1d20: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 72 65 61 is currently rea
1d30: 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 0a ding or writing.
1d40: 2a 2a 20 74 68 65 20 69 52 6f 6f 74 20 74 61 62 ** the iRoot tab
1d50: 6c 65 2e 20 20 45 78 63 65 70 74 2c 20 69 66 20 le. Except, if
1d60: 74 68 65 20 6f 74 68 65 72 20 42 74 72 65 65 20 the other Btree
1d70: 6f 62 6a 65 63 74 20 68 61 73 20 74 68 65 0a 2a object has the.*
1d80: 2a 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 74 * read-uncommitt
1d90: 65 64 20 66 6c 61 67 20 73 65 74 2c 20 74 68 65 ed flag set, the
1da0: 6e 20 69 74 20 69 73 20 4f 4b 20 66 6f 72 20 74 n it is OK for t
1db0: 68 65 20 6f 74 68 65 72 20 6f 62 6a 65 63 74 20 he other object
1dc0: 74 6f 0a 2a 2a 20 68 61 76 65 20 61 20 72 65 61 to.** have a rea
1dd0: 64 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 d cursor..**.**
1de0: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 62 65 66 For example, bef
1df0: 6f 72 65 20 77 72 69 74 69 6e 67 20 74 6f 20 61 ore writing to a
1e00: 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 74 ny part of the t
1e10: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a 2a 2a able or index.**
1e20: 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 rooted at page
1e30: 69 52 6f 6f 74 2c 20 6f 6e 65 20 73 68 6f 75 6c iRoot, one shoul
1e40: 64 20 63 61 6c 6c 3a 0a 2a 2a 0a 2a 2a 20 20 20 d call:.**.**
1e50: 20 61 73 73 65 72 74 28 20 21 68 61 73 52 65 61 assert( !hasRea
1e60: 64 43 6f 6e 66 6c 69 63 74 73 28 70 42 74 72 65 dConflicts(pBtre
1e70: 65 2c 20 69 52 6f 6f 74 29 20 29 3b 0a 2a 2f 0a e, iRoot) );.*/.
1e80: 73 74 61 74 69 63 20 69 6e 74 20 68 61 73 52 65 static int hasRe
1e90: 61 64 43 6f 6e 66 6c 69 63 74 73 28 42 74 72 65 adConflicts(Btre
1ea0: 65 20 2a 70 42 74 72 65 65 2c 20 50 67 6e 6f 20 e *pBtree, Pgno
1eb0: 69 52 6f 6f 74 29 7b 0a 20 20 42 74 43 75 72 73 iRoot){. BtCurs
1ec0: 6f 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70 or *p;. for(p=p
1ed0: 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 Btree->pBt->pCur
1ee0: 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 sor; p; p=p->pNe
1ef0: 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e xt){. if( p->
1f00: 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 20 pgnoRoot==iRoot
1f10: 0a 20 20 20 20 20 26 26 20 70 2d 3e 70 42 74 72 . && p->pBtr
1f20: 65 65 21 3d 70 42 74 72 65 65 0a 20 20 20 20 20 ee!=pBtree.
1f30: 26 26 20 30 3d 3d 28 70 2d 3e 70 42 74 72 65 65 && 0==(p->pBtree
1f40: 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 ->db->flags & SQ
1f50: 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 LITE_ReadUncommi
1f60: 74 74 65 64 29 0a 20 20 20 20 29 7b 0a 20 20 20 tted). ){.
1f70: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 return 1;.
1f80: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
1f90: 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 20 20 20 2f 0;.}.#endif /
1fa0: 2a 20 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f * #ifdef SQLITE_
1fb0: 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 DEBUG */../*.**
1fc0: 51 75 65 72 79 20 74 6f 20 73 65 65 20 69 66 20 Query to see if
1fd0: 42 74 72 65 65 20 68 61 6e 64 6c 65 20 70 20 6d Btree handle p m
1fe0: 61 79 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b ay obtain a lock
1ff0: 20 6f 66 20 74 79 70 65 20 65 4c 6f 63 6b 20 0a of type eLock .
2000: 2a 2a 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 ** (READ_LOCK or
2010: 20 57 52 49 54 45 5f 4c 4f 43 4b 29 20 6f 6e 20 WRITE_LOCK) on
2020: 74 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 the table with r
2030: 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 2e 20 52 oot-page iTab. R
2040: 65 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f eturn.** SQLITE_
2050: 4f 4b 20 69 66 20 74 68 65 20 6c 6f 63 6b 20 6d OK if the lock m
2060: 61 79 20 62 65 20 6f 62 74 61 69 6e 65 64 20 28 ay be obtained (
2070: 62 79 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 73 65 by calling.** se
2080: 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c tSharedCacheTabl
2090: 65 4c 6f 63 6b 28 29 29 2c 20 6f 72 20 53 51 4c eLock()), or SQL
20a0: 49 54 45 5f 4c 4f 43 4b 45 44 20 69 66 20 6e 6f ITE_LOCKED if no
20b0: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
20c0: 20 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 querySharedCach
20d0: 65 54 61 62 6c 65 4c 6f 63 6b 28 42 74 72 65 65 eTableLock(Btree
20e0: 20 2a 70 2c 20 50 67 6e 6f 20 69 54 61 62 2c 20 *p, Pgno iTab,
20f0: 75 38 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 u8 eLock){. BtS
2100: 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
2110: 70 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 pBt;. BtLock *p
2120: 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 Iter;.. assert(
2130: 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
2140: 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 dsMutex(p) );.
2150: 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 assert( eLock==R
2160: 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 EAD_LOCK || eLoc
2170: 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 3b k==WRITE_LOCK );
2180: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64 62 . assert( p->db
2190: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
21a0: 20 21 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 !(p->db->flags&
21b0: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d SQLITE_ReadUncom
21c0: 6d 69 74 74 65 64 29 7c 7c 65 4c 6f 63 6b 3d 3d mitted)||eLock==
21d0: 57 52 49 54 45 5f 4c 4f 43 4b 7c 7c 69 54 61 62 WRITE_LOCK||iTab
21e0: 3d 3d 31 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 ==1 );. . /* I
21f0: 66 20 72 65 71 75 65 73 74 69 6e 67 20 61 20 77 f requesting a w
2200: 72 69 74 65 2d 6c 6f 63 6b 2c 20 74 68 65 6e 20 rite-lock, then
2210: 74 68 65 20 42 74 72 65 65 20 6d 75 73 74 20 68 the Btree must h
2220: 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 74 ave an open writ
2230: 65 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 e. ** transacti
2240: 6f 6e 20 6f 6e 20 74 68 69 73 20 66 69 6c 65 2e on on this file.
2250: 20 41 6e 64 2c 20 6f 62 76 69 6f 75 73 6c 79 2c And, obviously,
2260: 20 66 6f 72 20 74 68 69 73 20 74 6f 20 62 65 20 for this to be
2270: 73 6f 20 74 68 65 72 65 20 0a 20 20 2a 2a 20 6d so there . ** m
2280: 75 73 74 20 62 65 20 61 6e 20 6f 70 65 6e 20 77 ust be an open w
2290: 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
22a0: 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 74 73 on the file its
22b0: 65 6c 66 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 elf.. */. asse
22c0: 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f rt( eLock==READ_
22d0: 4c 4f 43 4b 20 7c 7c 20 28 70 3d 3d 70 42 74 2d LOCK || (p==pBt-
22e0: 3e 70 57 72 69 74 65 72 20 26 26 20 70 2d 3e 69 >pWriter && p->i
22f0: 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 nTrans==TRANS_WR
2300: 49 54 45 29 20 29 3b 0a 20 20 61 73 73 65 72 74 ITE) );. assert
2310: 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f ( eLock==READ_LO
2320: 43 4b 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 61 CK || pBt->inTra
2330: 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
2340: 57 52 49 54 45 20 29 3b 0a 20 20 0a 20 20 2f 2a WRITE );. . /*
2350: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
2360: 20 61 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 a no-op if the
2370: 73 68 61 72 65 64 2d 63 61 63 68 65 20 69 73 20 shared-cache is
2380: 6e 6f 74 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 not enabled */.
2390: 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 6c if( !p->sharabl
23a0: 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 e ){. return
23b0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a SQLITE_OK;. }..
23c0: 20 20 2f 2a 20 49 66 20 73 6f 6d 65 20 6f 74 68 /* If some oth
23d0: 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 er connection is
23e0: 20 68 6f 6c 64 69 6e 67 20 61 6e 20 65 78 63 6c holding an excl
23f0: 75 73 69 76 65 20 6c 6f 63 6b 2c 20 74 68 65 0a usive lock, the.
2400: 20 20 2a 2a 20 72 65 71 75 65 73 74 65 64 20 6c ** requested l
2410: 6f 63 6b 20 6d 61 79 20 6e 6f 74 20 62 65 20 6f ock may not be o
2420: 62 74 61 69 6e 65 64 2e 0a 20 20 2a 2f 0a 20 20 btained.. */.
2430: 69 66 28 20 70 42 74 2d 3e 70 57 72 69 74 65 72 if( pBt->pWriter
2440: 21 3d 70 20 26 26 20 28 70 42 74 2d 3e 62 74 73 !=p && (pBt->bts
2450: 46 6c 61 67 73 20 26 20 42 54 53 5f 45 58 43 4c Flags & BTS_EXCL
2460: 55 53 49 56 45 29 21 3d 30 20 29 7b 0a 20 20 20 USIVE)!=0 ){.
2470: 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
2480: 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 2c onBlocked(p->db,
2490: 20 70 42 74 2d 3e 70 57 72 69 74 65 72 2d 3e 64 pBt->pWriter->d
24a0: 62 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 b);. return S
24b0: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 QLITE_LOCKED_SHA
24c0: 52 45 44 43 41 43 48 45 3b 0a 20 20 7d 0a 0a 20 REDCACHE;. }..
24d0: 20 66 6f 72 28 70 49 74 65 72 3d 70 42 74 2d 3e for(pIter=pBt->
24e0: 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b 20 70 49 pLock; pIter; pI
24f0: 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e 65 78 74 ter=pIter->pNext
2500: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 6f ){. /* The co
2510: 6e 64 69 74 69 6f 6e 20 28 70 49 74 65 72 2d 3e ndition (pIter->
2520: 65 4c 6f 63 6b 21 3d 65 4c 6f 63 6b 29 20 69 6e eLock!=eLock) in
2530: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 the following i
2540: 66 28 2e 2e 2e 29 20 0a 20 20 20 20 2a 2a 20 73 f(...) . ** s
2550: 74 61 74 65 6d 65 6e 74 20 69 73 20 61 20 73 69 tatement is a si
2560: 6d 70 6c 69 66 69 63 61 74 69 6f 6e 20 6f 66 3a mplification of:
2570: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 . **. **
2580: 20 28 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c (eLock==WRITE_L
2590: 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 65 4c OCK || pIter->eL
25a0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 29 ock==WRITE_LOCK)
25b0: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 73 . **. ** s
25c0: 69 6e 63 65 20 77 65 20 6b 6e 6f 77 20 74 68 61 ince we know tha
25d0: 74 20 69 66 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 t if eLock==WRIT
25e0: 45 5f 4c 4f 43 4b 2c 20 74 68 65 6e 20 6e 6f 20 E_LOCK, then no
25f0: 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
2600: 0a 20 20 20 20 2a 2a 20 6d 61 79 20 68 6f 6c 64 . ** may hold
2610: 20 61 20 57 52 49 54 45 5f 4c 4f 43 4b 20 6f 6e a WRITE_LOCK on
2620: 20 61 6e 79 20 74 61 62 6c 65 20 69 6e 20 74 68 any table in th
2630: 69 73 20 66 69 6c 65 20 28 73 69 6e 63 65 20 74 is file (since t
2640: 68 65 72 65 20 63 61 6e 0a 20 20 20 20 2a 2a 20 here can. **
2650: 6f 6e 6c 79 20 62 65 20 61 20 73 69 6e 67 6c 65 only be a single
2660: 20 77 72 69 74 65 72 29 2e 0a 20 20 20 20 2a 2f writer).. */
2670: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 74 . assert( pIt
2680: 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f er->eLock==READ_
2690: 4c 4f 43 4b 20 7c 7c 20 70 49 74 65 72 2d 3e 65 LOCK || pIter->e
26a0: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
26b0: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
26c0: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
26d0: 20 7c 7c 20 70 49 74 65 72 2d 3e 70 42 74 72 65 || pIter->pBtre
26e0: 65 3d 3d 70 20 7c 7c 20 70 49 74 65 72 2d 3e 65 e==p || pIter->e
26f0: 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 29 Lock==READ_LOCK)
2700: 3b 0a 20 20 20 20 69 66 28 20 70 49 74 65 72 2d ;. if( pIter-
2710: 3e 70 42 74 72 65 65 21 3d 70 20 26 26 20 70 49 >pBtree!=p && pI
2720: 74 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 ter->iTable==iTa
2730: 62 20 26 26 20 70 49 74 65 72 2d 3e 65 4c 6f 63 b && pIter->eLoc
2740: 6b 21 3d 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 k!=eLock ){.
2750: 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 sqlite3Connect
2760: 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 ionBlocked(p->db
2770: 2c 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 2d , pIter->pBtree-
2780: 3e 64 62 29 3b 0a 20 20 20 20 20 20 69 66 28 20 >db);. if(
2790: 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 eLock==WRITE_LOC
27a0: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 K ){. ass
27b0: 65 72 74 28 20 70 3d 3d 70 42 74 2d 3e 70 57 72 ert( p==pBt->pWr
27c0: 69 74 65 72 20 29 3b 0a 20 20 20 20 20 20 20 20 iter );.
27d0: 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
27e0: 20 42 54 53 5f 50 45 4e 44 49 4e 47 3b 0a 20 20 BTS_PENDING;.
27f0: 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 }. retu
2800: 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 rn SQLITE_LOCKED
2810: 5f 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 _SHAREDCACHE;.
2820: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
2830: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
2840: 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 5f ndif /* !SQLITE_
2850: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
2860: 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 E */..#ifndef SQ
2870: 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
2880: 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a 20 41 64 64 _CACHE./*.** Add
2890: 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 74 a lock on the t
28a0: 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 able with root-p
28b0: 61 67 65 20 69 54 61 62 6c 65 20 74 6f 20 74 68 age iTable to th
28c0: 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 75 e shared-btree u
28d0: 73 65 64 0a 2a 2a 20 62 79 20 42 74 72 65 65 20 sed.** by Btree
28e0: 68 61 6e 64 6c 65 20 70 2e 20 50 61 72 61 6d 65 handle p. Parame
28f0: 74 65 72 20 65 4c 6f 63 6b 20 6d 75 73 74 20 62 ter eLock must b
2900: 65 20 65 69 74 68 65 72 20 52 45 41 44 5f 4c 4f e either READ_LO
2910: 43 4b 20 6f 72 20 0a 2a 2a 20 57 52 49 54 45 5f CK or .** WRITE_
2920: 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 LOCK..**.** This
2930: 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 function assume
2940: 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a s the following:
2950: 0a 2a 2a 0a 2a 2a 20 20 20 28 61 29 20 54 68 65 .**.** (a) The
2960: 20 73 70 65 63 69 66 69 65 64 20 42 74 72 65 65 specified Btree
2970: 20 6f 62 6a 65 63 74 20 70 20 69 73 20 63 6f 6e object p is con
2980: 6e 65 63 74 65 64 20 74 6f 20 61 20 73 68 61 72 nected to a shar
2990: 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 64 61 able.** da
29a0: 74 61 62 61 73 65 20 28 6f 6e 65 20 77 69 74 68 tabase (one with
29b0: 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 73 68 the BtShared.sh
29c0: 61 72 61 62 6c 65 20 66 6c 61 67 20 73 65 74 29 arable flag set)
29d0: 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 28 62 , and.**.** (b
29e0: 29 20 4e 6f 20 6f 74 68 65 72 20 42 74 72 65 65 ) No other Btree
29f0: 20 6f 62 6a 65 63 74 73 20 68 6f 6c 64 20 61 20 objects hold a
2a00: 6c 6f 63 6b 20 74 68 61 74 20 63 6f 6e 66 6c 69 lock that confli
2a10: 63 74 73 0a 2a 2a 20 20 20 20 20 20 20 77 69 74 cts.** wit
2a20: 68 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 h the requested
2a30: 6c 6f 63 6b 20 28 69 2e 65 2e 20 71 75 65 72 79 lock (i.e. query
2a40: 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
2a50: 4c 6f 63 6b 28 29 20 68 61 73 0a 2a 2a 20 20 20 Lock() has.**
2a60: 20 20 20 20 61 6c 72 65 61 64 79 20 62 65 65 6e already been
2a70: 20 63 61 6c 6c 65 64 20 61 6e 64 20 72 65 74 75 called and retu
2a80: 72 6e 65 64 20 53 51 4c 49 54 45 5f 4f 4b 29 2e rned SQLITE_OK).
2a90: 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
2aa0: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
2ab0: 74 68 65 20 6c 6f 63 6b 20 69 73 20 61 64 64 65 the lock is adde
2ac0: 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e 20 d successfully.
2ad0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 0a 2a 2a SQLITE_NOMEM .**
2ae0: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
2af0: 61 20 6d 61 6c 6c 6f 63 20 61 74 74 65 6d 70 74 a malloc attempt
2b00: 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 fails..*/.stati
2b10: 63 20 69 6e 74 20 73 65 74 53 68 61 72 65 64 43 c int setSharedC
2b20: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 42 74 acheTableLock(Bt
2b30: 72 65 65 20 2a 70 2c 20 50 67 6e 6f 20 69 54 61 ree *p, Pgno iTa
2b40: 62 6c 65 2c 20 75 38 20 65 4c 6f 63 6b 29 7b 0a ble, u8 eLock){.
2b50: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
2b60: 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 4c 6f = p->pBt;. BtLo
2b70: 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 30 3b 0a 20 ck *pLock = 0;.
2b80: 20 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a BtLock *pIter;.
2b90: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
2ba0: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
2bb0: 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
2bc0: 28 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f ( eLock==READ_LO
2bd0: 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 CK || eLock==WRI
2be0: 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 TE_LOCK );. ass
2bf0: 65 72 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b ert( p->db!=0 );
2c00: 0a 0a 20 20 2f 2a 20 41 20 63 6f 6e 6e 65 63 74 .. /* A connect
2c10: 69 6f 6e 20 77 69 74 68 20 74 68 65 20 72 65 61 ion with the rea
2c20: 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c d-uncommitted fl
2c30: 61 67 20 73 65 74 20 77 69 6c 6c 20 6e 65 76 65 ag set will neve
2c40: 72 20 74 72 79 20 74 6f 0a 20 20 2a 2a 20 6f 62 r try to. ** ob
2c50: 74 61 69 6e 20 61 20 72 65 61 64 2d 6c 6f 63 6b tain a read-lock
2c60: 20 75 73 69 6e 67 20 74 68 69 73 20 66 75 6e 63 using this func
2c70: 74 69 6f 6e 2e 20 54 68 65 20 6f 6e 6c 79 20 72 tion. The only r
2c80: 65 61 64 2d 6c 6f 63 6b 20 6f 62 74 61 69 6e 65 ead-lock obtaine
2c90: 64 0a 20 20 2a 2a 20 62 79 20 61 20 63 6f 6e 6e d. ** by a conn
2ca0: 65 63 74 69 6f 6e 20 69 6e 20 72 65 61 64 2d 75 ection in read-u
2cb0: 6e 63 6f 6d 6d 69 74 74 65 64 20 6d 6f 64 65 20 ncommitted mode
2cc0: 69 73 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 is on the sqlite
2cd0: 5f 6d 61 73 74 65 72 20 0a 20 20 2a 2a 20 74 61 _master . ** ta
2ce0: 62 6c 65 2c 20 61 6e 64 20 74 68 61 74 20 6c 6f ble, and that lo
2cf0: 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 69 ck is obtained i
2d00: 6e 20 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e n BtreeBeginTran
2d10: 73 28 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 s(). */. asser
2d20: 74 28 20 30 3d 3d 28 70 2d 3e 64 62 2d 3e 66 6c t( 0==(p->db->fl
2d30: 61 67 73 26 53 51 4c 49 54 45 5f 52 65 61 64 55 ags&SQLITE_ReadU
2d40: 6e 63 6f 6d 6d 69 74 74 65 64 29 20 7c 7c 20 65 ncommitted) || e
2d50: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
2d60: 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 66 );.. /* This f
2d70: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6f unction should o
2d80: 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e nly be called on
2d90: 20 61 20 73 68 61 72 61 62 6c 65 20 62 2d 74 72 a sharable b-tr
2da0: 65 65 20 61 66 74 65 72 20 69 74 20 0a 20 20 2a ee after it . *
2db0: 2a 20 68 61 73 20 62 65 65 6e 20 64 65 74 65 72 * has been deter
2dc0: 6d 69 6e 65 64 20 74 68 61 74 20 6e 6f 20 6f 74 mined that no ot
2dd0: 68 65 72 20 62 2d 74 72 65 65 20 68 6f 6c 64 73 her b-tree holds
2de0: 20 61 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 6c a conflicting l
2df0: 6f 63 6b 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 ock. */. asser
2e00: 74 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 t( p->sharable )
2e10: 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 ;. assert( SQLI
2e20: 54 45 5f 4f 4b 3d 3d 71 75 65 72 79 53 68 61 72 TE_OK==queryShar
2e30: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
2e40: 28 70 2c 20 69 54 61 62 6c 65 2c 20 65 4c 6f 63 (p, iTable, eLoc
2e50: 6b 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 72 73 k) );.. /* Firs
2e60: 74 20 73 65 61 72 63 68 20 74 68 65 20 6c 69 73 t search the lis
2e70: 74 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e t for an existin
2e80: 67 20 6c 6f 63 6b 20 6f 6e 20 74 68 69 73 20 74 g lock on this t
2e90: 61 62 6c 65 2e 20 2a 2f 0a 20 20 66 6f 72 28 70 able. */. for(p
2ea0: 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b Iter=pBt->pLock;
2eb0: 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 pIter; pIter=pI
2ec0: 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 ter->pNext){.
2ed0: 20 69 66 28 20 70 49 74 65 72 2d 3e 69 54 61 62 if( pIter->iTab
2ee0: 6c 65 3d 3d 69 54 61 62 6c 65 20 26 26 20 70 49 le==iTable && pI
2ef0: 74 65 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 ter->pBtree==p )
2f00: 7b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 20 3d 20 {. pLock =
2f10: 70 49 74 65 72 3b 0a 20 20 20 20 20 20 62 72 65 pIter;. bre
2f20: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 ak;. }. }..
2f30: 20 2f 2a 20 49 66 20 74 68 65 20 61 62 6f 76 65 /* If the above
2f40: 20 73 65 61 72 63 68 20 64 69 64 20 6e 6f 74 20 search did not
2f50: 66 69 6e 64 20 61 20 42 74 4c 6f 63 6b 20 73 74 find a BtLock st
2f60: 72 75 63 74 20 61 73 73 6f 63 69 61 74 69 6e 67 ruct associating
2f70: 20 42 74 72 65 65 20 70 0a 20 20 2a 2a 20 77 69 Btree p. ** wi
2f80: 74 68 20 74 61 62 6c 65 20 69 54 61 62 6c 65 2c th table iTable,
2f90: 20 61 6c 6c 6f 63 61 74 65 20 6f 6e 65 20 61 6e allocate one an
2fa0: 64 20 6c 69 6e 6b 20 69 74 20 69 6e 74 6f 20 74 d link it into t
2fb0: 68 65 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 he list.. */.
2fc0: 69 66 28 20 21 70 4c 6f 63 6b 20 29 7b 0a 20 20 if( !pLock ){.
2fd0: 20 20 70 4c 6f 63 6b 20 3d 20 28 42 74 4c 6f 63 pLock = (BtLoc
2fe0: 6b 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f k *)sqlite3Mallo
2ff0: 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 42 74 4c cZero(sizeof(BtL
3000: 6f 63 6b 29 29 3b 0a 20 20 20 20 69 66 28 20 21 ock));. if( !
3010: 70 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 72 pLock ){. r
3020: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
3030: 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 EM_BKPT;. }.
3040: 20 20 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 pLock->iTable
3050: 20 3d 20 69 54 61 62 6c 65 3b 0a 20 20 20 20 70 = iTable;. p
3060: 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 20 3d 20 70 Lock->pBtree = p
3070: 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 70 4e 65 ;. pLock->pNe
3080: 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 6b 3b xt = pBt->pLock;
3090: 0a 20 20 20 20 70 42 74 2d 3e 70 4c 6f 63 6b 20 . pBt->pLock
30a0: 3d 20 70 4c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 = pLock;. }..
30b0: 2f 2a 20 53 65 74 20 74 68 65 20 42 74 4c 6f 63 /* Set the BtLoc
30c0: 6b 2e 65 4c 6f 63 6b 20 76 61 72 69 61 62 6c 65 k.eLock variable
30d0: 20 74 6f 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 to the maximum
30e0: 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c of the current l
30f0: 6f 63 6b 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 ock. ** and the
3100: 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 2e requested lock.
3110: 20 54 68 69 73 20 6d 65 61 6e 73 20 69 66 20 61 This means if a
3120: 20 77 72 69 74 65 2d 6c 6f 63 6b 20 77 61 73 20 write-lock was
3130: 61 6c 72 65 61 64 79 20 68 65 6c 64 0a 20 20 2a already held. *
3140: 2a 20 61 6e 64 20 61 20 72 65 61 64 2d 6c 6f 63 * and a read-loc
3150: 6b 20 72 65 71 75 65 73 74 65 64 2c 20 77 65 20 k requested, we
3160: 64 6f 6e 27 74 20 69 6e 63 6f 72 72 65 63 74 6c don't incorrectl
3170: 79 20 64 6f 77 6e 67 72 61 64 65 20 74 68 65 20 y downgrade the
3180: 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 lock.. */. ass
3190: 65 72 74 28 20 57 52 49 54 45 5f 4c 4f 43 4b 3e ert( WRITE_LOCK>
31a0: 52 45 41 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 READ_LOCK );. i
31b0: 66 28 20 65 4c 6f 63 6b 3e 70 4c 6f 63 6b 2d 3e f( eLock>pLock->
31c0: 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 70 4c 6f eLock ){. pLo
31d0: 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 65 4c 6f 63 ck->eLock = eLoc
31e0: 6b 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e k;. }.. return
31f0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
3200: 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 5f ndif /* !SQLITE_
3210: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
3220: 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 E */..#ifndef SQ
3230: 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
3240: 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a 20 52 65 6c _CACHE./*.** Rel
3250: 65 61 73 65 20 61 6c 6c 20 74 68 65 20 74 61 62 ease all the tab
3260: 6c 65 20 6c 6f 63 6b 73 20 28 6c 6f 63 6b 73 20 le locks (locks
3270: 6f 62 74 61 69 6e 65 64 20 76 69 61 20 63 61 6c obtained via cal
3280: 6c 73 20 74 6f 0a 2a 2a 20 74 68 65 20 73 65 74 ls to.** the set
3290: 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
32a0: 4c 6f 63 6b 28 29 20 70 72 6f 63 65 64 75 72 65 Lock() procedure
32b0: 29 20 68 65 6c 64 20 62 79 20 42 74 72 65 65 20 ) held by Btree
32c0: 6f 62 6a 65 63 74 20 70 2e 0a 2a 2a 0a 2a 2a 20 object p..**.**
32d0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 This function as
32e0: 73 75 6d 65 73 20 74 68 61 74 20 42 74 72 65 65 sumes that Btree
32f0: 20 70 20 68 61 73 20 61 6e 20 6f 70 65 6e 20 72 p has an open r
3300: 65 61 64 20 6f 72 20 77 72 69 74 65 20 0a 2a 2a ead or write .**
3310: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 66 transaction. If
3320: 20 69 74 20 64 6f 65 73 20 6e 6f 74 2c 20 74 68 it does not, th
3330: 65 6e 20 74 68 65 20 42 54 53 5f 50 45 4e 44 49 en the BTS_PENDI
3340: 4e 47 20 66 6c 61 67 0a 2a 2a 20 6d 61 79 20 62 NG flag.** may b
3350: 65 20 69 6e 63 6f 72 72 65 63 74 6c 79 20 63 6c e incorrectly cl
3360: 65 61 72 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 eared..*/.static
3370: 20 76 6f 69 64 20 63 6c 65 61 72 41 6c 6c 53 68 void clearAllSh
3380: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
3390: 63 6b 73 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 cks(Btree *p){.
33a0: 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
33b0: 20 70 2d 3e 70 42 74 3b 0a 20 20 42 74 4c 6f 63 p->pBt;. BtLoc
33c0: 6b 20 2a 2a 70 70 49 74 65 72 20 3d 20 26 70 42 k **ppIter = &pB
33d0: 74 2d 3e 70 4c 6f 63 6b 3b 0a 0a 20 20 61 73 73 t->pLock;.. ass
33e0: 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 ert( sqlite3Btre
33f0: 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 eHoldsMutex(p) )
3400: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 73 ;. assert( p->s
3410: 68 61 72 61 62 6c 65 20 7c 7c 20 30 3d 3d 2a 70 harable || 0==*p
3420: 70 49 74 65 72 20 29 3b 0a 20 20 61 73 73 65 72 pIter );. asser
3430: 74 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 30 20 t( p->inTrans>0
3440: 29 3b 0a 0a 20 20 77 68 69 6c 65 28 20 2a 70 70 );.. while( *pp
3450: 49 74 65 72 20 29 7b 0a 20 20 20 20 42 74 4c 6f Iter ){. BtLo
3460: 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 2a 70 70 49 ck *pLock = *ppI
3470: 74 65 72 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ter;. assert(
3480: 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
3490: 26 20 42 54 53 5f 45 58 43 4c 55 53 49 56 45 29 & BTS_EXCLUSIVE)
34a0: 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 57 72 69 ==0 || pBt->pWri
34b0: 74 65 72 3d 3d 70 4c 6f 63 6b 2d 3e 70 42 74 72 ter==pLock->pBtr
34c0: 65 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 ee );. assert
34d0: 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 2d ( pLock->pBtree-
34e0: 3e 69 6e 54 72 61 6e 73 3e 3d 70 4c 6f 63 6b 2d >inTrans>=pLock-
34f0: 3e 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 69 66 >eLock );. if
3500: 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d ( pLock->pBtree=
3510: 3d 70 20 29 7b 0a 20 20 20 20 20 20 2a 70 70 49 =p ){. *ppI
3520: 74 65 72 20 3d 20 70 4c 6f 63 6b 2d 3e 70 4e 65 ter = pLock->pNe
3530: 78 74 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 xt;. assert
3540: 28 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 21 ( pLock->iTable!
3550: 3d 31 20 7c 7c 20 70 4c 6f 63 6b 3d 3d 26 70 2d =1 || pLock==&p-
3560: 3e 6c 6f 63 6b 20 29 3b 0a 20 20 20 20 20 20 69 >lock );. i
3570: 66 28 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 f( pLock->iTable
3580: 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 73 !=1 ){. s
3590: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 4c 6f 63 qlite3_free(pLoc
35a0: 6b 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 k);. }.
35b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 70 49 }else{. ppI
35c0: 74 65 72 20 3d 20 26 70 4c 6f 63 6b 2d 3e 70 4e ter = &pLock->pN
35d0: 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a ext;. }. }..
35e0: 20 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e assert( (pBt->
35f0: 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 btsFlags & BTS_P
3600: 45 4e 44 49 4e 47 29 3d 3d 30 20 7c 7c 20 70 42 ENDING)==0 || pB
3610: 74 2d 3e 70 57 72 69 74 65 72 20 29 3b 0a 20 20 t->pWriter );.
3620: 69 66 28 20 70 42 74 2d 3e 70 57 72 69 74 65 72 if( pBt->pWriter
3630: 3d 3d 70 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e ==p ){. pBt->
3640: 70 57 72 69 74 65 72 20 3d 20 30 3b 0a 20 20 20 pWriter = 0;.
3650: 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
3660: 3d 20 7e 28 42 54 53 5f 45 58 43 4c 55 53 49 56 = ~(BTS_EXCLUSIV
3670: 45 7c 42 54 53 5f 50 45 4e 44 49 4e 47 29 3b 0a E|BTS_PENDING);.
3680: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 42 74 2d }else if( pBt-
3690: 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 32 >nTransaction==2
36a0: 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 ){. /* This
36b0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
36c0: 65 64 20 77 68 65 6e 20 42 74 72 65 65 20 70 20 ed when Btree p
36d0: 69 73 20 63 6f 6e 63 6c 75 64 69 6e 67 20 69 74 is concluding it
36e0: 73 20 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 s . ** transa
36f0: 63 74 69 6f 6e 2e 20 49 66 20 74 68 65 72 65 20 ction. If there
3700: 63 75 72 72 65 6e 74 6c 79 20 65 78 69 73 74 73 currently exists
3710: 20 61 20 77 72 69 74 65 72 2c 20 61 6e 64 20 70 a writer, and p
3720: 20 69 73 20 6e 6f 74 0a 20 20 20 20 2a 2a 20 74 is not. ** t
3730: 68 61 74 20 77 72 69 74 65 72 2c 20 74 68 65 6e hat writer, then
3740: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6c the number of l
3750: 6f 63 6b 73 20 68 65 6c 64 20 62 79 20 63 6f 6e ocks held by con
3760: 6e 65 63 74 69 6f 6e 73 20 6f 74 68 65 72 0a 20 nections other.
3770: 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 65 20 77 ** than the w
3780: 72 69 74 65 72 20 6d 75 73 74 20 62 65 20 61 62 riter must be ab
3790: 6f 75 74 20 74 6f 20 64 72 6f 70 20 74 6f 20 7a out to drop to z
37a0: 65 72 6f 2e 20 49 6e 20 74 68 69 73 20 63 61 73 ero. In this cas
37b0: 65 0a 20 20 20 20 2a 2a 20 73 65 74 20 74 68 65 e. ** set the
37c0: 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 66 6c 61 BTS_PENDING fla
37d0: 67 20 74 6f 20 30 2e 0a 20 20 20 20 2a 2a 0a 20 g to 0.. **.
37e0: 20 20 20 2a 2a 20 49 66 20 74 68 65 72 65 20 69 ** If there i
37f0: 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 s not currently
3800: 61 20 77 72 69 74 65 72 2c 20 74 68 65 6e 20 42 a writer, then B
3810: 54 53 5f 50 45 4e 44 49 4e 47 20 6d 75 73 74 0a TS_PENDING must.
3820: 20 20 20 20 2a 2a 20 62 65 20 7a 65 72 6f 20 61 ** be zero a
3830: 6c 72 65 61 64 79 2e 20 53 6f 20 74 68 69 73 20 lready. So this
3840: 6e 65 78 74 20 6c 69 6e 65 20 69 73 20 68 61 72 next line is har
3850: 6d 6c 65 73 73 20 69 6e 20 74 68 61 74 20 63 61 mless in that ca
3860: 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 se.. */. p
3870: 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 Bt->btsFlags &=
3880: 7e 42 54 53 5f 50 45 4e 44 49 4e 47 3b 0a 20 20 ~BTS_PENDING;.
3890: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 }.}../*.** This
38a0: 66 75 6e 63 74 69 6f 6e 20 63 68 61 6e 67 65 73 function changes
38b0: 20 61 6c 6c 20 77 72 69 74 65 2d 6c 6f 63 6b 73 all write-locks
38c0: 20 68 65 6c 64 20 62 79 20 42 74 72 65 65 20 70 held by Btree p
38d0: 20 69 6e 74 6f 20 72 65 61 64 2d 6c 6f 63 6b 73 into read-locks
38e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
38f0: 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 61 downgradeAllSha
3900: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
3910: 6b 73 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ks(Btree *p){.
3920: 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
3930: 70 2d 3e 70 42 74 3b 0a 20 20 69 66 28 20 70 42 p->pBt;. if( pB
3940: 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 20 29 7b t->pWriter==p ){
3950: 0a 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f . BtLock *pLo
3960: 63 6b 3b 0a 20 20 20 20 70 42 74 2d 3e 70 57 72 ck;. pBt->pWr
3970: 69 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 iter = 0;. pB
3980: 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e t->btsFlags &= ~
3990: 28 42 54 53 5f 45 58 43 4c 55 53 49 56 45 7c 42 (BTS_EXCLUSIVE|B
39a0: 54 53 5f 50 45 4e 44 49 4e 47 29 3b 0a 20 20 20 TS_PENDING);.
39b0: 20 66 6f 72 28 70 4c 6f 63 6b 3d 70 42 74 2d 3e for(pLock=pBt->
39c0: 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c pLock; pLock; pL
39d0: 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 ock=pLock->pNext
39e0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
39f0: 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 52 pLock->eLock==R
3a00: 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 4c 6f 63 EAD_LOCK || pLoc
3a10: 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 3b 0a k->pBtree==p );.
3a20: 20 20 20 20 20 20 70 4c 6f 63 6b 2d 3e 65 4c 6f pLock->eLo
3a30: 63 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a ck = READ_LOCK;.
3a40: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6e }. }.}..#en
3a50: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
3a60: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 IT_SHARED_CACHE
3a70: 2a 2f 0a 0a 73 74 61 74 69 63 20 76 6f 69 64 20 */..static void
3a80: 72 65 6c 65 61 73 65 50 61 67 65 28 4d 65 6d 50 releasePage(MemP
3a90: 61 67 65 20 2a 70 50 61 67 65 29 3b 20 20 2f 2a age *pPage); /*
3aa0: 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 6e Forward referen
3ab0: 63 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 2a 2a 2a 20 ce */../*.*****
3ac0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
3ad0: 75 73 65 64 20 69 6e 73 69 64 65 20 6f 66 20 61 used inside of a
3ae0: 73 73 65 72 74 28 29 20 6f 6e 6c 79 20 2a 2a 2a ssert() only ***
3af0: 2a 0a 2a 2a 0a 2a 2a 20 56 65 72 69 66 79 20 74 *.**.** Verify t
3b00: 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 68 hat the cursor h
3b10: 6f 6c 64 73 20 74 68 65 20 6d 75 74 65 78 20 6f olds the mutex o
3b20: 6e 20 69 74 73 20 42 74 53 68 61 72 65 64 0a 2a n its BtShared.*
3b30: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
3b40: 44 45 42 55 47 0a 73 74 61 74 69 63 20 69 6e 74 DEBUG.static int
3b50: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
3b60: 78 28 42 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a x(BtCursor *p){.
3b70: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
3b80: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 _mutex_held(p->p
3b90: 42 74 2d 3e 6d 75 74 65 78 29 3b 0a 7d 0a 0a 2f Bt->mutex);.}../
3ba0: 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 74 68 * Verify that th
3bb0: 65 20 63 75 72 73 6f 72 20 61 6e 64 20 74 68 65 e cursor and the
3bc0: 20 42 74 53 68 61 72 65 64 20 61 67 72 65 65 20 BtShared agree
3bd0: 61 62 6f 75 74 20 77 68 61 74 20 69 73 20 74 68 about what is th
3be0: 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 64 61 74 e current.** dat
3bf0: 61 62 61 73 65 20 63 6f 6e 6e 65 74 69 6f 6e 2e abase connetion.
3c00: 20 54 68 69 73 20 69 73 20 69 6d 70 6f 72 74 61 This is importa
3c10: 6e 74 20 69 6e 20 73 68 61 72 65 64 2d 63 61 63 nt in shared-cac
3c20: 68 65 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 he mode. If the
3c30: 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 63 6f 6e database .** con
3c40: 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 73 nection pointers
3c50: 20 67 65 74 20 6f 75 74 2d 6f 66 2d 73 79 6e 63 get out-of-sync
3c60: 2c 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 , it is possible
3c70: 20 66 6f 72 20 72 6f 75 74 69 6e 65 73 20 6c 69 for routines li
3c80: 6b 65 0a 2a 2a 20 62 74 72 65 65 49 6e 69 74 50 ke.** btreeInitP
3c90: 61 67 65 28 29 20 74 6f 20 72 65 66 65 72 65 6e age() to referen
3ca0: 63 65 20 61 6e 20 73 74 61 6c 65 20 63 6f 6e 6e ce an stale conn
3cb0: 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 74 ection pointer t
3cc0: 68 61 74 20 72 65 66 65 72 65 6e 63 65 73 20 61 hat references a
3cd0: 0a 2a 2a 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e .** a connection
3ce0: 20 74 68 61 74 20 68 61 73 20 61 6c 72 65 61 64 that has alread
3cf0: 79 20 63 6c 6f 73 65 64 2e 20 20 54 68 69 73 20 y closed. This
3d00: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 routine is used
3d10: 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 29 0a inside assert().
3d20: 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 6e ** statements on
3d30: 6c 79 20 61 6e 64 20 66 6f 72 20 74 68 65 20 70 ly and for the p
3d40: 75 72 70 6f 73 65 20 6f 66 20 64 6f 75 62 6c 65 urpose of double
3d50: 2d 63 68 65 63 6b 69 6e 67 20 74 68 61 74 20 74 -checking that t
3d60: 68 65 20 62 74 72 65 65 20 63 6f 64 65 0a 2a 2a he btree code.**
3d70: 20 64 6f 65 73 20 6b 65 65 70 20 74 68 65 20 64 does keep the d
3d80: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
3d90: 6f 6e 20 70 6f 69 6e 74 65 72 73 20 75 70 2d 74 on pointers up-t
3da0: 6f 2d 64 61 74 65 2e 0a 2a 2f 0a 73 74 61 74 69 o-date..*/.stati
3db0: 63 20 69 6e 74 20 63 75 72 73 6f 72 4f 77 6e 73 c int cursorOwns
3dc0: 42 74 53 68 61 72 65 64 28 42 74 43 75 72 73 6f BtShared(BtCurso
3dd0: 72 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 r *p){. assert(
3de0: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
3df0: 78 28 70 29 20 29 3b 0a 20 20 72 65 74 75 72 6e x(p) );. return
3e00: 20 28 70 2d 3e 70 42 74 72 65 65 2d 3e 64 62 3d (p->pBtree->db=
3e10: 3d 70 2d 3e 70 42 74 2d 3e 64 62 29 3b 0a 7d 0a =p->pBt->db);.}.
3e20: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e #endif../*.** In
3e30: 76 61 6c 69 64 61 74 65 20 74 68 65 20 6f 76 65 validate the ove
3e40: 72 66 6c 6f 77 20 63 61 63 68 65 20 6f 66 20 74 rflow cache of t
3e50: 68 65 20 63 75 72 73 6f 72 20 70 61 73 73 65 64 he cursor passed
3e60: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72 as the first ar
3e70: 67 75 6d 65 6e 74 2e 0a 2a 2a 20 6f 6e 20 74 68 gument..** on th
3e80: 65 20 73 68 61 72 65 64 20 62 74 72 65 65 20 73 e shared btree s
3e90: 74 72 75 63 74 75 72 65 20 70 42 74 2e 0a 2a 2f tructure pBt..*/
3ea0: 0a 23 64 65 66 69 6e 65 20 69 6e 76 61 6c 69 64 .#define invalid
3eb0: 61 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 ateOverflowCache
3ec0: 28 70 43 75 72 29 20 28 70 43 75 72 2d 3e 63 75 (pCur) (pCur->cu
3ed0: 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 46 5f rFlags &= ~BTCF_
3ee0: 56 61 6c 69 64 4f 76 66 6c 29 0a 0a 2f 2a 0a 2a ValidOvfl)../*.*
3ef0: 2a 20 49 6e 76 61 6c 69 64 61 74 65 20 74 68 65 * Invalidate the
3f00: 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c overflow page-l
3f10: 69 73 74 20 63 61 63 68 65 20 66 6f 72 20 61 6c ist cache for al
3f20: 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 64 l cursors opened
3f30: 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 72 65 .** on the share
3f40: 64 20 62 74 72 65 65 20 73 74 72 75 63 74 75 72 d btree structur
3f50: 65 20 70 42 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 e pBt..*/.static
3f60: 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 74 65 void invalidate
3f70: 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 AllOverflowCache
3f80: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
3f90: 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a . BtCursor *p;.
3fa0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
3fb0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
3fc0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f ->mutex) );. fo
3fd0: 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 r(p=pBt->pCursor
3fe0: 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 ; p; p=p->pNext)
3ff0: 7b 0a 20 20 20 20 69 6e 76 61 6c 69 64 61 74 65 {. invalidate
4000: 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 29 OverflowCache(p)
4010: 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 ;. }.}..#ifndef
4020: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 SQLITE_OMIT_INC
4030: 52 42 4c 4f 42 0a 2f 2a 0a 2a 2a 20 54 68 69 73 RBLOB./*.** This
4040: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
4050: 6c 65 64 20 62 65 66 6f 72 65 20 6d 6f 64 69 66 led before modif
4060: 79 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 ying the content
4070: 73 20 6f 66 20 61 20 74 61 62 6c 65 0a 2a 2a 20 s of a table.**
4080: 74 6f 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e to invalidate an
4090: 79 20 69 6e 63 72 62 6c 6f 62 20 63 75 72 73 6f y incrblob curso
40a0: 72 73 20 74 68 61 74 20 61 72 65 20 6f 70 65 6e rs that are open
40b0: 20 6f 6e 20 74 68 65 0a 2a 2a 20 72 6f 77 20 6f on the.** row o
40c0: 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 6f 77 r one of the row
40d0: 73 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 s being modified
40e0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 72 67 75 6d ..**.** If argum
40f0: 65 6e 74 20 69 73 43 6c 65 61 72 54 61 62 6c 65 ent isClearTable
4100: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 is true, then t
4110: 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e he entire conten
4120: 74 73 20 6f 66 20 74 68 65 0a 2a 2a 20 74 61 62 ts of the.** tab
4130: 6c 65 20 69 73 20 61 62 6f 75 74 20 74 6f 20 62 le is about to b
4140: 65 20 64 65 6c 65 74 65 64 2e 20 49 6e 20 74 68 e deleted. In th
4150: 69 73 20 63 61 73 65 20 69 6e 76 61 6c 69 64 61 is case invalida
4160: 74 65 20 61 6c 6c 20 69 6e 63 72 62 6c 6f 62 0a te all incrblob.
4170: 2a 2a 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 20 ** cursors open
4180: 6f 6e 20 61 6e 79 20 72 6f 77 20 77 69 74 68 69 on any row withi
4190: 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 68 n the table with
41a0: 20 72 6f 6f 74 2d 70 61 67 65 20 70 67 6e 6f 52 root-page pgnoR
41b0: 6f 6f 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 oot..**.** Other
41c0: 77 69 73 65 2c 20 69 66 20 61 72 67 75 6d 65 6e wise, if argumen
41d0: 74 20 69 73 43 6c 65 61 72 54 61 62 6c 65 20 69 t isClearTable i
41e0: 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 74 68 s false, then th
41f0: 65 20 72 6f 77 20 77 69 74 68 0a 2a 2a 20 72 6f e row with.** ro
4200: 77 69 64 20 69 52 6f 77 20 69 73 20 62 65 69 6e wid iRow is bein
4210: 67 20 72 65 70 6c 61 63 65 64 20 6f 72 20 64 65 g replaced or de
4220: 6c 65 74 65 64 2e 20 49 6e 20 74 68 69 73 20 63 leted. In this c
4230: 61 73 65 20 69 6e 76 61 6c 69 64 61 74 65 0a 2a ase invalidate.*
4240: 2a 20 6f 6e 6c 79 20 74 68 6f 73 65 20 69 6e 63 * only those inc
4250: 72 62 6c 6f 62 20 63 75 72 73 6f 72 73 20 6f 70 rblob cursors op
4260: 65 6e 20 6f 6e 20 74 68 61 74 20 73 70 65 63 69 en on that speci
4270: 66 69 63 20 72 6f 77 2e 0a 2a 2f 0a 73 74 61 74 fic row..*/.stat
4280: 69 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 ic void invalida
4290: 74 65 49 6e 63 72 62 6c 6f 62 43 75 72 73 6f 72 teIncrblobCursor
42a0: 73 28 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 s(. Btree *pBtr
42b0: 65 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ee, /*
42c0: 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c The database fil
42d0: 65 20 74 6f 20 63 68 65 63 6b 20 2a 2f 0a 20 20 e to check */.
42e0: 69 36 34 20 69 52 6f 77 2c 20 20 20 20 20 20 20 i64 iRow,
42f0: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 /* The r
4300: 6f 77 69 64 20 74 68 61 74 20 6d 69 67 68 74 20 owid that might
4310: 62 65 20 63 68 61 6e 67 69 6e 67 20 2a 2f 0a 20 be changing */.
4320: 20 69 6e 74 20 69 73 43 6c 65 61 72 54 61 62 6c int isClearTabl
4330: 65 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 e /* True
4340: 20 69 66 20 61 6c 6c 20 72 6f 77 73 20 61 72 65 if all rows are
4350: 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 2a being deleted *
4360: 2f 0a 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 /.){. BtCursor
4370: 2a 70 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 *p;. if( pBtree
4380: 2d 3e 68 61 73 49 6e 63 72 62 6c 6f 62 43 75 72 ->hasIncrblobCur
4390: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 ==0 ) return;.
43a0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 assert( sqlite3B
43b0: 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 treeHoldsMutex(p
43c0: 42 74 72 65 65 29 20 29 3b 0a 20 20 70 42 74 72 Btree) );. pBtr
43d0: 65 65 2d 3e 68 61 73 49 6e 63 72 62 6c 6f 62 43 ee->hasIncrblobC
43e0: 75 72 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 3d ur = 0;. for(p=
43f0: 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 pBtree->pBt->pCu
4400: 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e rsor; p; p=p->pN
4410: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 28 70 ext){. if( (p
4420: 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
4430: 46 5f 49 6e 63 72 62 6c 6f 62 29 21 3d 30 20 29 F_Incrblob)!=0 )
4440: 7b 0a 20 20 20 20 20 20 70 42 74 72 65 65 2d 3e {. pBtree->
4450: 68 61 73 49 6e 63 72 62 6c 6f 62 43 75 72 20 3d hasIncrblobCur =
4460: 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 69 73 1;. if( is
4470: 43 6c 65 61 72 54 61 62 6c 65 20 7c 7c 20 70 2d ClearTable || p-
4480: 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 52 6f 77 >info.nKey==iRow
4490: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 ){. p->e
44a0: 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 State = CURSOR_I
44b0: 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 7d 0a NVALID;. }.
44c0: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6c }. }.}..#el
44d0: 73 65 0a 20 20 2f 2a 20 53 74 75 62 20 66 75 6e se. /* Stub fun
44e0: 63 74 69 6f 6e 20 77 68 65 6e 20 49 4e 43 52 42 ction when INCRB
44f0: 4c 4f 42 20 69 73 20 6f 6d 69 74 74 65 64 20 2a LOB is omitted *
4500: 2f 0a 20 20 23 64 65 66 69 6e 65 20 69 6e 76 61 /. #define inva
4510: 6c 69 64 61 74 65 49 6e 63 72 62 6c 6f 62 43 75 lidateIncrblobCu
4520: 72 73 6f 72 73 28 78 2c 79 2c 7a 29 0a 23 65 6e rsors(x,y,z).#en
4530: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
4540: 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a 0a IT_INCRBLOB */..
4550: 2f 2a 0a 2a 2a 20 53 65 74 20 62 69 74 20 70 67 /*.** Set bit pg
4560: 6e 6f 20 6f 66 20 74 68 65 20 42 74 53 68 61 72 no of the BtShar
4570: 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 ed.pHasContent b
4580: 69 74 76 65 63 2e 20 54 68 69 73 20 69 73 20 63 itvec. This is c
4590: 61 6c 6c 65 64 20 0a 2a 2a 20 77 68 65 6e 20 61 alled .** when a
45a0: 20 70 61 67 65 20 74 68 61 74 20 70 72 65 76 69 page that previ
45b0: 6f 75 73 6c 79 20 63 6f 6e 74 61 69 6e 65 64 20 ously contained
45c0: 64 61 74 61 20 62 65 63 6f 6d 65 73 20 61 20 66 data becomes a f
45d0: 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 0a 2a ree-list leaf .*
45e0: 2a 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 * page..**.** Th
45f0: 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 e BtShared.pHasC
4600: 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 20 65 78 ontent bitvec ex
4610: 69 73 74 73 20 74 6f 20 77 6f 72 6b 20 61 72 6f ists to work aro
4620: 75 6e 64 20 61 6e 20 6f 62 73 63 75 72 65 0a 2a und an obscure.*
4630: 2a 20 62 75 67 20 63 61 75 73 65 64 20 62 79 20 * bug caused by
4640: 74 68 65 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 the interaction
4650: 6f 66 20 74 77 6f 20 75 73 65 66 75 6c 20 49 4f of two useful IO
4660: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 73 optimizations s
4670: 75 72 72 6f 75 6e 64 69 6e 67 0a 2a 2a 20 66 72 urrounding.** fr
4680: 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 ee-list leaf pag
4690: 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 57 es:.**.** 1) W
46a0: 68 65 6e 20 61 6c 6c 20 64 61 74 61 20 69 73 20 hen all data is
46b0: 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 61 20 70 deleted from a p
46c0: 61 67 65 20 61 6e 64 20 74 68 65 20 70 61 67 65 age and the page
46d0: 20 62 65 63 6f 6d 65 73 0a 2a 2a 20 20 20 20 20 becomes.**
46e0: 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 a free-list lea
46f0: 66 20 70 61 67 65 2c 20 74 68 65 20 70 61 67 65 f page, the page
4700: 20 69 73 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 is not written
4710: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 0a to the database.
4720: 2a 2a 20 20 20 20 20 20 28 61 73 20 66 72 65 65 ** (as free
4730: 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 73 -list leaf pages
4740: 20 63 6f 6e 74 61 69 6e 20 6e 6f 20 6d 65 61 6e contain no mean
4750: 69 6e 67 66 75 6c 20 64 61 74 61 29 2e 20 53 6f ingful data). So
4760: 6d 65 74 69 6d 65 73 0a 2a 2a 20 20 20 20 20 20 metimes.**
4770: 73 75 63 68 20 61 20 70 61 67 65 20 69 73 20 6e such a page is n
4780: 6f 74 20 65 76 65 6e 20 6a 6f 75 72 6e 61 6c 6c ot even journall
4790: 65 64 20 28 61 73 20 69 74 20 77 69 6c 6c 20 6e ed (as it will n
47a0: 6f 74 20 62 65 20 6d 6f 64 69 66 69 65 64 2c 0a ot be modified,.
47b0: 2a 2a 20 20 20 20 20 20 77 68 79 20 62 6f 74 68 ** why both
47c0: 65 72 20 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 69 er journalling i
47d0: 74 3f 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 29 20 t?)..**.** 2)
47e0: 57 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 74 When a free-list
47f0: 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 65 leaf page is re
4800: 75 73 65 64 2c 20 69 74 73 20 63 6f 6e 74 65 6e used, its conten
4810: 74 20 69 73 20 6e 6f 74 20 72 65 61 64 0a 2a 2a t is not read.**
4820: 20 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 64 from the d
4830: 61 74 61 62 61 73 65 20 6f 72 20 77 72 69 74 74 atabase or writt
4840: 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 en to the journa
4850: 6c 20 66 69 6c 65 20 28 77 68 79 20 73 68 6f 75 l file (why shou
4860: 6c 64 20 69 74 0a 2a 2a 20 20 20 20 20 20 62 65 ld it.** be
4870: 2c 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 , if it is not a
4880: 74 20 61 6c 6c 20 6d 65 61 6e 69 6e 67 66 75 6c t all meaningful
4890: 3f 29 2e 0a 2a 2a 0a 2a 2a 20 42 79 20 74 68 65 ?)..**.** By the
48a0: 6d 73 65 6c 76 65 73 2c 20 74 68 65 73 65 20 6f mselves, these o
48b0: 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 77 6f 72 ptimizations wor
48c0: 6b 20 66 69 6e 65 20 61 6e 64 20 70 72 6f 76 69 k fine and provi
48d0: 64 65 20 61 20 68 61 6e 64 79 0a 2a 2a 20 70 65 de a handy.** pe
48e0: 72 66 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74 20 rformance boost
48f0: 74 6f 20 62 75 6c 6b 20 64 65 6c 65 74 65 20 6f to bulk delete o
4900: 72 20 69 6e 73 65 72 74 20 6f 70 65 72 61 74 69 r insert operati
4910: 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 ons. However, if
4920: 0a 2a 2a 20 61 20 70 61 67 65 20 69 73 20 6d 6f .** a page is mo
4930: 76 65 64 20 74 6f 20 74 68 65 20 66 72 65 65 2d ved to the free-
4940: 6c 69 73 74 20 61 6e 64 20 74 68 65 6e 20 72 65 list and then re
4950: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 used within the
4960: 73 61 6d 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 same.** transact
4970: 69 6f 6e 2c 20 61 20 70 72 6f 62 6c 65 6d 20 63 ion, a problem c
4980: 6f 6d 65 73 20 75 70 2e 20 49 66 20 74 68 65 20 omes up. If the
4990: 70 61 67 65 20 69 73 20 6e 6f 74 20 6a 6f 75 72 page is not jour
49a0: 6e 61 6c 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 69 nalled when.** i
49b0: 74 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 74 68 t is moved to th
49c0: 65 20 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 e free-list and
49d0: 69 74 20 69 73 20 61 6c 73 6f 20 6e 6f 74 20 6a it is also not j
49e0: 6f 75 72 6e 61 6c 6c 65 64 20 77 68 65 6e 20 69 ournalled when i
49f0: 74 0a 2a 2a 20 69 73 20 65 78 74 72 61 63 74 65 t.** is extracte
4a00: 64 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d d from the free-
4a10: 6c 69 73 74 20 61 6e 64 20 72 65 75 73 65 64 2c list and reused,
4a20: 20 74 68 65 6e 20 74 68 65 20 6f 72 69 67 69 6e then the origin
4a30: 61 6c 20 64 61 74 61 0a 2a 2a 20 6d 61 79 20 62 al data.** may b
4a40: 65 20 6c 6f 73 74 2e 20 49 6e 20 74 68 65 20 65 e lost. In the e
4a50: 76 65 6e 74 20 6f 66 20 61 20 72 6f 6c 6c 62 61 vent of a rollba
4a60: 63 6b 2c 20 69 74 20 6d 61 79 20 6e 6f 74 20 62 ck, it may not b
4a70: 65 20 70 6f 73 73 69 62 6c 65 0a 2a 2a 20 74 6f e possible.** to
4a80: 20 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 restore the dat
4a90: 61 62 61 73 65 20 74 6f 20 69 74 73 20 6f 72 69 abase to its ori
4aa0: 67 69 6e 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 ginal configurat
4ab0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 ion..**.** The s
4ac0: 6f 6c 75 74 69 6f 6e 20 69 73 20 74 68 65 20 42 olution is the B
4ad0: 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 tShared.pHasCont
4ae0: 65 6e 74 20 62 69 74 76 65 63 2e 20 57 68 65 6e ent bitvec. When
4af0: 65 76 65 72 20 61 20 70 61 67 65 20 69 73 20 0a ever a page is .
4b00: 2a 2a 20 6d 6f 76 65 64 20 74 6f 20 62 65 63 6f ** moved to beco
4b10: 6d 65 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c me a free-list l
4b20: 65 61 66 20 70 61 67 65 2c 20 74 68 65 20 63 6f eaf page, the co
4b30: 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 rresponding bit
4b40: 69 73 0a 2a 2a 20 73 65 74 20 69 6e 20 74 68 65 is.** set in the
4b50: 20 62 69 74 76 65 63 2e 20 57 68 65 6e 65 76 65 bitvec. Wheneve
4b60: 72 20 61 20 6c 65 61 66 20 70 61 67 65 20 69 73 r a leaf page is
4b70: 20 65 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 extracted from
4b80: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 0a 2a the free-list,.*
4b90: 2a 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 32 * optimization 2
4ba0: 20 61 62 6f 76 65 20 69 73 20 6f 6d 69 74 74 65 above is omitte
4bb0: 64 20 69 66 20 74 68 65 20 63 6f 72 72 65 73 70 d if the corresp
4bc0: 6f 6e 64 69 6e 67 20 62 69 74 20 69 73 20 61 6c onding bit is al
4bd0: 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 69 6e 20 ready.** set in
4be0: 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e BtShared.pHasCon
4bf0: 74 65 6e 74 2e 20 54 68 65 20 63 6f 6e 74 65 6e tent. The conten
4c00: 74 73 20 6f 66 20 74 68 65 20 62 69 74 76 65 63 ts of the bitvec
4c10: 20 61 72 65 20 63 6c 65 61 72 65 64 0a 2a 2a 20 are cleared.**
4c20: 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 at the end of ev
4c30: 65 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ery transaction.
4c40: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 .*/.static int b
4c50: 74 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 6e treeSetHasConten
4c60: 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c t(BtShared *pBt,
4c70: 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 Pgno pgno){. i
4c80: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
4c90: 4b 3b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 70 K;. if( !pBt->p
4ca0: 48 61 73 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 HasContent ){.
4cb0: 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f 3c 3d assert( pgno<=
4cc0: 70 42 74 2d 3e 6e 50 61 67 65 20 29 3b 0a 20 20 pBt->nPage );.
4cd0: 20 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 pBt->pHasConte
4ce0: 6e 74 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 nt = sqlite3Bitv
4cf0: 65 63 43 72 65 61 74 65 28 70 42 74 2d 3e 6e 50 ecCreate(pBt->nP
4d00: 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 21 70 age);. if( !p
4d10: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 Bt->pHasContent
4d20: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
4d30: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
4d40: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 . }. }. if(
4d50: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
4d60: 26 20 70 67 6e 6f 3c 3d 73 71 6c 69 74 65 33 42 & pgno<=sqlite3B
4d70: 69 74 76 65 63 53 69 7a 65 28 70 42 74 2d 3e 70 itvecSize(pBt->p
4d80: 48 61 73 43 6f 6e 74 65 6e 74 29 20 29 7b 0a 20 HasContent) ){.
4d90: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
4da0: 69 74 76 65 63 53 65 74 28 70 42 74 2d 3e 70 48 itvecSet(pBt->pH
4db0: 61 73 43 6f 6e 74 65 6e 74 2c 20 70 67 6e 6f 29 asContent, pgno)
4dc0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
4dd0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 c;.}../*.** Quer
4de0: 79 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 y the BtShared.p
4df0: 48 61 73 43 6f 6e 74 65 6e 74 20 76 65 63 74 6f HasContent vecto
4e00: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 r..**.** This fu
4e10: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
4e20: 20 77 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 when a free-lis
4e30: 74 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 t leaf page is r
4e40: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 0a emoved from the.
4e50: 2a 2a 20 66 72 65 65 2d 6c 69 73 74 20 66 6f 72 ** free-list for
4e60: 20 72 65 75 73 65 2e 20 49 74 20 72 65 74 75 72 reuse. It retur
4e70: 6e 73 20 66 61 6c 73 65 20 69 66 20 69 74 20 69 ns false if it i
4e80: 73 20 73 61 66 65 20 74 6f 20 72 65 74 72 69 65 s safe to retrie
4e90: 76 65 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 66 ve the.** page f
4ea0: 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 6c 61 rom the pager la
4eb0: 79 65 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f yer with the 'no
4ec0: 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 -content' flag s
4ed0: 65 74 2e 20 54 72 75 65 20 6f 74 68 65 72 77 69 et. True otherwi
4ee0: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e se..*/.static in
4ef0: 74 20 62 74 72 65 65 47 65 74 48 61 73 43 6f 6e t btreeGetHasCon
4f00: 74 65 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 tent(BtShared *p
4f10: 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a Bt, Pgno pgno){.
4f20: 20 20 42 69 74 76 65 63 20 2a 70 20 3d 20 70 42 Bitvec *p = pB
4f30: 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 3b 0a t->pHasContent;.
4f40: 20 20 72 65 74 75 72 6e 20 28 70 20 26 26 20 28 return (p && (
4f50: 70 67 6e 6f 3e 73 71 6c 69 74 65 33 42 69 74 76 pgno>sqlite3Bitv
4f60: 65 63 53 69 7a 65 28 70 29 20 7c 7c 20 73 71 6c ecSize(p) || sql
4f70: 69 74 65 33 42 69 74 76 65 63 54 65 73 74 28 70 ite3BitvecTest(p
4f80: 2c 20 70 67 6e 6f 29 29 29 3b 0a 7d 0a 0a 2f 2a , pgno)));.}../*
4f90: 0a 2a 2a 20 43 6c 65 61 72 20 28 64 65 73 74 72 .** Clear (destr
4fa0: 6f 79 29 20 74 68 65 20 42 74 53 68 61 72 65 64 oy) the BtShared
4fb0: 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 .pHasContent bit
4fc0: 76 65 63 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 vec. This should
4fd0: 20 62 65 0a 2a 2a 20 69 6e 76 6f 6b 65 64 20 61 be.** invoked a
4fe0: 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
4ff0: 20 6f 66 20 65 61 63 68 20 77 72 69 74 65 2d 74 of each write-t
5000: 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 ransaction..*/.s
5010: 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
5020: 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
5030: 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
5040: 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 sqlite3BitvecD
5050: 65 73 74 72 6f 79 28 70 42 74 2d 3e 70 48 61 73 estroy(pBt->pHas
5060: 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 70 42 74 2d Content);. pBt-
5070: 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 3d 20 30 >pHasContent = 0
5080: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 ;.}../*.** Relea
5090: 73 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 70 se all of the ap
50a0: 50 61 67 65 5b 5d 20 70 61 67 65 73 20 66 6f 72 Page[] pages for
50b0: 20 61 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 73 74 a cursor..*/.st
50c0: 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 52 atic void btreeR
50d0: 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 eleaseAllCursorP
50e0: 61 67 65 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ages(BtCursor *p
50f0: 43 75 72 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 Cur){. int i;.
5100: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d 70 43 75 for(i=0; i<=pCu
5110: 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 7b 0a r->iPage; i++){.
5120: 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
5130: 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d 29 pCur->apPage[i])
5140: 3b 0a 20 20 20 20 70 43 75 72 2d 3e 61 70 50 61 ;. pCur->apPa
5150: 67 65 5b 69 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 ge[i] = 0;. }.
5160: 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d pCur->iPage = -
5170: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 1;.}../*.** The
5180: 63 75 72 73 6f 72 20 70 61 73 73 65 64 20 61 73 cursor passed as
5190: 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 the only argume
51a0: 6e 74 20 6d 75 73 74 20 70 6f 69 6e 74 20 74 6f nt must point to
51b0: 20 61 20 76 61 6c 69 64 20 65 6e 74 72 79 0a 2a a valid entry.*
51c0: 2a 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 * when this func
51d0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 28 tion is called (
51e0: 69 2e 65 2e 20 68 61 76 65 20 65 53 74 61 74 65 i.e. have eState
51f0: 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 29 2e ==CURSOR_VALID).
5200: 20 54 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f This.** functio
5210: 6e 20 73 61 76 65 73 20 74 68 65 20 63 75 72 72 n saves the curr
5220: 65 6e 74 20 63 75 72 73 6f 72 20 6b 65 79 20 69 ent cursor key i
5230: 6e 20 76 61 72 69 61 62 6c 65 73 20 70 43 75 72 n variables pCur
5240: 2d 3e 6e 4b 65 79 20 61 6e 64 0a 2a 2a 20 70 43 ->nKey and.** pC
5250: 75 72 2d 3e 70 4b 65 79 2e 20 53 51 4c 49 54 45 ur->pKey. SQLITE
5260: 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 _OK is returned
5270: 69 66 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72 if successful or
5280: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
5290: 20 0a 2a 2a 20 63 6f 64 65 20 6f 74 68 65 72 77 .** code otherw
52a0: 69 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ise..**.** If th
52b0: 65 20 63 75 72 73 6f 72 20 69 73 20 6f 70 65 6e e cursor is open
52c0: 20 6f 6e 20 61 6e 20 69 6e 74 6b 65 79 20 74 61 on an intkey ta
52d0: 62 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 69 6e ble, then the in
52e0: 74 65 67 65 72 20 6b 65 79 0a 2a 2a 20 28 74 68 teger key.** (th
52f0: 65 20 72 6f 77 69 64 29 20 69 73 20 73 74 6f 72 e rowid) is stor
5300: 65 64 20 69 6e 20 70 43 75 72 2d 3e 6e 4b 65 79 ed in pCur->nKey
5310: 20 61 6e 64 20 70 43 75 72 2d 3e 70 4b 65 79 20 and pCur->pKey
5320: 69 73 20 6c 65 66 74 20 73 65 74 20 74 6f 0a 2a is left set to.*
5330: 2a 20 4e 55 4c 4c 2e 20 49 66 20 74 68 65 20 63 * NULL. If the c
5340: 75 72 73 6f 72 20 69 73 20 6f 70 65 6e 20 6f 6e ursor is open on
5350: 20 61 20 6e 6f 6e 2d 69 6e 74 6b 65 79 20 74 61 a non-intkey ta
5360: 62 6c 65 2c 20 74 68 65 6e 20 70 43 75 72 2d 3e ble, then pCur->
5370: 70 4b 65 79 20 69 73 20 0a 2a 2a 20 73 65 74 20 pKey is .** set
5380: 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20 6d 61 to point to a ma
5390: 6c 6c 6f 63 65 64 20 62 75 66 66 65 72 20 70 43 lloced buffer pC
53a0: 75 72 2d 3e 6e 4b 65 79 20 62 79 74 65 73 20 69 ur->nKey bytes i
53b0: 6e 20 73 69 7a 65 20 63 6f 6e 74 61 69 6e 69 6e n size containin
53c0: 67 20 0a 2a 2a 20 74 68 65 20 6b 65 79 2e 0a 2a g .** the key..*
53d0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 76 /.static int sav
53e0: 65 43 75 72 73 6f 72 4b 65 79 28 42 74 43 75 72 eCursorKey(BtCur
53f0: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 6e sor *pCur){. in
5400: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
5410: 3b 0a 20 20 61 73 73 65 72 74 28 20 43 55 52 53 ;. assert( CURS
5420: 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e OR_VALID==pCur->
5430: 65 53 74 61 74 65 20 29 3b 0a 20 20 61 73 73 65 eState );. asse
5440: 72 74 28 20 30 3d 3d 70 43 75 72 2d 3e 70 4b 65 rt( 0==pCur->pKe
5450: 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 y );. assert( c
5460: 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
5470: 70 43 75 72 29 20 29 3b 0a 0a 20 20 69 66 28 20 pCur) );.. if(
5480: 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 20 pCur->curIntKey
5490: 29 7b 0a 20 20 20 20 2f 2a 20 4f 6e 6c 79 20 74 ){. /* Only t
54a0: 68 65 20 72 6f 77 69 64 20 69 73 20 72 65 71 75 he rowid is requ
54b0: 69 72 65 64 20 66 6f 72 20 61 20 74 61 62 6c 65 ired for a table
54c0: 20 62 74 72 65 65 20 2a 2f 0a 20 20 20 20 70 43 btree */. pC
54d0: 75 72 2d 3e 6e 4b 65 79 20 3d 20 73 71 6c 69 74 ur->nKey = sqlit
54e0: 65 33 42 74 72 65 65 49 6e 74 65 67 65 72 4b 65 e3BtreeIntegerKe
54f0: 79 28 70 43 75 72 29 3b 0a 20 20 7d 65 6c 73 65 y(pCur);. }else
5500: 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 6e 20 {. /* For an
5510: 69 6e 64 65 78 20 62 74 72 65 65 2c 20 73 61 76 index btree, sav
5520: 65 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 6b e the complete k
5530: 65 79 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 ey content */.
5540: 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b 0a 20 20 void *pKey;.
5550: 20 20 70 43 75 72 2d 3e 6e 4b 65 79 20 3d 20 73 pCur->nKey = s
5560: 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f qlite3BtreePaylo
5570: 61 64 53 69 7a 65 28 70 43 75 72 29 3b 0a 20 20 adSize(pCur);.
5580: 20 20 70 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 pKey = sqlite3
5590: 4d 61 6c 6c 6f 63 28 20 70 43 75 72 2d 3e 6e 4b Malloc( pCur->nK
55a0: 65 79 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4b ey );. if( pK
55b0: 65 79 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d ey ){. rc =
55c0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 sqlite3BtreePay
55d0: 6c 6f 61 64 28 70 43 75 72 2c 20 30 2c 20 28 69 load(pCur, 0, (i
55e0: 6e 74 29 70 43 75 72 2d 3e 6e 4b 65 79 2c 20 70 nt)pCur->nKey, p
55f0: 4b 65 79 29 3b 0a 20 20 20 20 20 20 69 66 28 20 Key);. if(
5600: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
5610: 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 70 . pCur->p
5620: 4b 65 79 20 3d 20 70 4b 65 79 3b 0a 20 20 20 20 Key = pKey;.
5630: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
5640: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 4b sqlite3_free(pK
5650: 65 79 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ey);. }.
5660: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 }else{. rc
5670: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f = SQLITE_NOMEM_
5680: 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a BKPT;. }. }.
5690: 20 20 61 73 73 65 72 74 28 20 21 70 43 75 72 2d assert( !pCur-
56a0: 3e 63 75 72 49 6e 74 4b 65 79 20 7c 7c 20 21 70 >curIntKey || !p
56b0: 43 75 72 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 72 Cur->pKey );. r
56c0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
56d0: 2a 2a 20 53 61 76 65 20 74 68 65 20 63 75 72 72 ** Save the curr
56e0: 65 6e 74 20 63 75 72 73 6f 72 20 70 6f 73 69 74 ent cursor posit
56f0: 69 6f 6e 20 69 6e 20 74 68 65 20 76 61 72 69 61 ion in the varia
5700: 62 6c 65 73 20 42 74 43 75 72 73 6f 72 2e 6e 4b bles BtCursor.nK
5710: 65 79 20 0a 2a 2a 20 61 6e 64 20 42 74 43 75 72 ey .** and BtCur
5720: 73 6f 72 2e 70 4b 65 79 2e 20 54 68 65 20 63 75 sor.pKey. The cu
5730: 72 73 6f 72 27 73 20 73 74 61 74 65 20 69 73 20 rsor's state is
5740: 73 65 74 20 74 6f 20 43 55 52 53 4f 52 5f 52 45 set to CURSOR_RE
5750: 51 55 49 52 45 53 45 45 4b 2e 0a 2a 2a 0a 2a 2a QUIRESEEK..**.**
5760: 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 The caller must
5770: 20 65 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 ensure that the
5780: 20 63 75 72 73 6f 72 20 69 73 20 76 61 6c 69 64 cursor is valid
5790: 20 28 68 61 73 20 65 53 74 61 74 65 3d 3d 43 55 (has eState==CU
57a0: 52 53 4f 52 5f 56 41 4c 49 44 29 0a 2a 2a 20 70 RSOR_VALID).** p
57b0: 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 20 rior to calling
57c0: 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 0a this routine. .
57d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 */.static int sa
57e0: 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e veCursorPosition
57f0: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
5800: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 {. int rc;.. a
5810: 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 41 ssert( CURSOR_VA
5820: 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 LID==pCur->eStat
5830: 65 20 7c 7c 20 43 55 52 53 4f 52 5f 53 4b 49 50 e || CURSOR_SKIP
5840: 4e 45 58 54 3d 3d 70 43 75 72 2d 3e 65 53 74 61 NEXT==pCur->eSta
5850: 74 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 te );. assert(
5860: 30 3d 3d 70 43 75 72 2d 3e 70 4b 65 79 20 29 3b 0==pCur->pKey );
5870: 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
5880: 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
5890: 29 20 29 3b 0a 0a 20 20 69 66 28 20 70 43 75 72 ) );.. if( pCur
58a0: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
58b0: 5f 53 4b 49 50 4e 45 58 54 20 29 7b 0a 20 20 20 _SKIPNEXT ){.
58c0: 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
58d0: 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 CURSOR_VALID;.
58e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 75 72 2d }else{. pCur-
58f0: 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 >skipNext = 0;.
5900: 20 7d 0a 0a 20 20 72 63 20 3d 20 73 61 76 65 43 }.. rc = saveC
5910: 75 72 73 6f 72 4b 65 79 28 70 43 75 72 29 3b 0a ursorKey(pCur);.
5920: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
5930: 5f 4f 4b 20 29 7b 0a 20 20 20 20 62 74 72 65 65 _OK ){. btree
5940: 52 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 ReleaseAllCursor
5950: 50 61 67 65 73 28 70 43 75 72 29 3b 0a 20 20 20 Pages(pCur);.
5960: 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
5970: 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 CURSOR_REQUIRESE
5980: 45 4b 3b 0a 20 20 7d 0a 0a 20 20 70 43 75 72 2d EK;. }.. pCur-
5990: 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 >curFlags &= ~(B
59a0: 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 TCF_ValidNKey|BT
59b0: 43 46 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 43 CF_ValidOvfl|BTC
59c0: 46 5f 41 74 4c 61 73 74 29 3b 0a 20 20 72 65 74 F_AtLast);. ret
59d0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 46 6f urn rc;.}../* Fo
59e0: 72 77 61 72 64 20 72 65 66 65 72 65 6e 63 65 20 rward reference
59f0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 */.static int SQ
5a00: 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 73 61 LITE_NOINLINE sa
5a10: 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 28 veCursorsOnList(
5a20: 42 74 43 75 72 73 6f 72 2a 2c 50 67 6e 6f 2c 42 BtCursor*,Pgno,B
5a30: 74 43 75 72 73 6f 72 2a 29 3b 0a 0a 2f 2a 0a 2a tCursor*);../*.*
5a40: 2a 20 53 61 76 65 20 74 68 65 20 70 6f 73 69 74 * Save the posit
5a50: 69 6f 6e 73 20 6f 66 20 61 6c 6c 20 63 75 72 73 ions of all curs
5a60: 6f 72 73 20 28 65 78 63 65 70 74 20 70 45 78 63 ors (except pExc
5a70: 65 70 74 29 20 74 68 61 74 20 61 72 65 20 6f 70 ept) that are op
5a80: 65 6e 20 6f 6e 0a 2a 2a 20 74 68 65 20 74 61 62 en on.** the tab
5a90: 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 le with root-pag
5aa0: 65 20 69 52 6f 6f 74 2e 20 20 22 53 61 76 69 6e e iRoot. "Savin
5ab0: 67 20 74 68 65 20 63 75 72 73 6f 72 20 70 6f 73 g the cursor pos
5ac0: 69 74 69 6f 6e 22 20 6d 65 61 6e 73 20 74 68 61 ition" means tha
5ad0: 74 0a 2a 2a 20 74 68 65 20 6c 6f 63 61 74 69 6f t.** the locatio
5ae0: 6e 20 69 6e 20 74 68 65 20 62 74 72 65 65 20 69 n in the btree i
5af0: 73 20 72 65 6d 65 6d 62 65 72 65 64 20 69 6e 20 s remembered in
5b00: 73 75 63 68 20 61 20 77 61 79 20 74 68 61 74 20 such a way that
5b10: 69 74 20 63 61 6e 20 62 65 0a 2a 2a 20 6d 6f 76 it can be.** mov
5b20: 65 64 20 62 61 63 6b 20 74 6f 20 74 68 65 20 73 ed back to the s
5b30: 61 6d 65 20 73 70 6f 74 20 61 66 74 65 72 20 74 ame spot after t
5b40: 68 65 20 62 74 72 65 65 20 68 61 73 20 62 65 65 he btree has bee
5b50: 6e 20 6d 6f 64 69 66 69 65 64 2e 20 20 54 68 69 n modified. Thi
5b60: 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 s.** routine is
5b70: 63 61 6c 6c 65 64 20 6a 75 73 74 20 62 65 66 6f called just befo
5b80: 72 65 20 63 75 72 73 6f 72 20 70 45 78 63 65 70 re cursor pExcep
5b90: 74 20 69 73 20 75 73 65 64 20 74 6f 20 6d 6f 64 t is used to mod
5ba0: 69 66 79 20 74 68 65 0a 2a 2a 20 74 61 62 6c 65 ify the.** table
5bb0: 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 69 6e , for example in
5bc0: 20 42 74 72 65 65 44 65 6c 65 74 65 28 29 20 6f BtreeDelete() o
5bd0: 72 20 42 74 72 65 65 49 6e 73 65 72 74 28 29 2e r BtreeInsert().
5be0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 .**.** If there
5bf0: 61 72 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 are two or more
5c00: 63 75 72 73 6f 72 73 20 6f 6e 20 74 68 65 20 73 cursors on the s
5c10: 61 6d 65 20 62 74 72 65 65 2c 20 74 68 65 6e 20 ame btree, then
5c20: 61 6c 6c 20 73 75 63 68 20 0a 2a 2a 20 63 75 72 all such .** cur
5c30: 73 6f 72 73 20 73 68 6f 75 6c 64 20 68 61 76 65 sors should have
5c40: 20 74 68 65 69 72 20 42 54 43 46 5f 4d 75 6c 74 their BTCF_Mult
5c50: 69 70 6c 65 20 66 6c 61 67 20 73 65 74 2e 20 20 iple flag set.
5c60: 54 68 65 20 62 74 72 65 65 43 75 72 73 6f 72 28 The btreeCursor(
5c70: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 65 6e 66 ).** routine enf
5c80: 6f 72 63 65 73 20 74 68 61 74 20 72 75 6c 65 2e orces that rule.
5c90: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6f This routine o
5ca0: 6e 6c 79 20 6e 65 65 64 73 20 74 6f 20 62 65 20 nly needs to be
5cb0: 63 61 6c 6c 65 64 20 69 6e 0a 2a 2a 20 74 68 65 called in.** the
5cc0: 20 75 6e 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 uncommon case w
5cd0: 68 65 6e 20 70 45 78 70 65 63 74 20 68 61 73 20 hen pExpect has
5ce0: 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 69 70 6c the BTCF_Multipl
5cf0: 65 20 66 6c 61 67 20 73 65 74 2e 0a 2a 2a 0a 2a e flag set..**.*
5d00: 2a 20 49 66 20 70 45 78 70 65 63 74 21 3d 4e 55 * If pExpect!=NU
5d10: 4c 4c 20 61 6e 64 20 69 66 20 6e 6f 20 6f 74 68 LL and if no oth
5d20: 65 72 20 63 75 72 73 6f 72 73 20 61 72 65 20 66 er cursors are f
5d30: 6f 75 6e 64 20 6f 6e 20 74 68 65 20 73 61 6d 65 ound on the same
5d40: 20 72 6f 6f 74 2d 70 61 67 65 2c 0a 2a 2a 20 74 root-page,.** t
5d50: 68 65 6e 20 74 68 65 20 42 54 43 46 5f 4d 75 6c hen the BTCF_Mul
5d60: 74 69 70 6c 65 20 66 6c 61 67 20 6f 6e 20 70 45 tiple flag on pE
5d70: 78 70 65 63 74 20 69 73 20 63 6c 65 61 72 65 64 xpect is cleared
5d80: 2c 20 74 6f 20 61 76 6f 69 64 20 61 6e 6f 74 68 , to avoid anoth
5d90: 65 72 0a 2a 2a 20 70 6f 69 6e 74 6c 65 73 73 20 er.** pointless
5da0: 63 61 6c 6c 20 74 6f 20 74 68 69 73 20 72 6f 75 call to this rou
5db0: 74 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 49 6d 70 6c tine..**.** Impl
5dc0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6e 6f 74 65 3a ementation note:
5dd0: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d This routine m
5de0: 65 72 65 6c 79 20 63 68 65 63 6b 73 20 74 6f 20 erely checks to
5df0: 73 65 65 20 69 66 20 61 6e 79 20 63 75 72 73 6f see if any curso
5e00: 72 73 0a 2a 2a 20 6e 65 65 64 20 74 6f 20 62 65 rs.** need to be
5e10: 20 73 61 76 65 64 2e 20 20 49 74 20 63 61 6c 6c saved. It call
5e20: 73 20 6f 75 74 20 74 6f 20 73 61 76 65 43 75 72 s out to saveCur
5e30: 73 6f 72 73 4f 6e 4c 69 73 74 28 29 20 69 6e 20 sorsOnList() in
5e40: 74 68 65 20 28 75 6e 75 73 75 61 6c 29 0a 2a 2a the (unusual).**
5e50: 20 65 76 65 6e 74 20 74 68 61 74 20 63 75 72 73 event that curs
5e60: 6f 72 73 20 61 72 65 20 69 6e 20 6e 65 65 64 20 ors are in need
5e70: 74 6f 20 62 65 69 6e 67 20 73 61 76 65 64 2e 0a to being saved..
5e80: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 */.static int sa
5e90: 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 53 veAllCursors(BtS
5ea0: 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f hared *pBt, Pgno
5eb0: 20 69 52 6f 6f 74 2c 20 42 74 43 75 72 73 6f 72 iRoot, BtCursor
5ec0: 20 2a 70 45 78 63 65 70 74 29 7b 0a 20 20 42 74 *pExcept){. Bt
5ed0: 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 61 73 73 Cursor *p;. ass
5ee0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
5ef0: 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
5f00: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
5f10: 20 70 45 78 63 65 70 74 3d 3d 30 20 7c 7c 20 70 pExcept==0 || p
5f20: 45 78 63 65 70 74 2d 3e 70 42 74 3d 3d 70 42 74 Except->pBt==pBt
5f30: 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 74 2d );. for(p=pBt-
5f40: 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 >pCursor; p; p=p
5f50: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 ->pNext){. if
5f60: 28 20 70 21 3d 70 45 78 63 65 70 74 20 26 26 20 ( p!=pExcept &&
5f70: 28 30 3d 3d 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e (0==iRoot || p->
5f80: 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 pgnoRoot==iRoot)
5f90: 20 29 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 ) break;. }.
5fa0: 69 66 28 20 70 20 29 20 72 65 74 75 72 6e 20 73 if( p ) return s
5fb0: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
5fc0: 28 70 2c 20 69 52 6f 6f 74 2c 20 70 45 78 63 65 (p, iRoot, pExce
5fd0: 70 74 29 3b 0a 20 20 69 66 28 20 70 45 78 63 65 pt);. if( pExce
5fe0: 70 74 20 29 20 70 45 78 63 65 70 74 2d 3e 63 75 pt ) pExcept->cu
5ff0: 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 46 5f rFlags &= ~BTCF_
6000: 4d 75 6c 74 69 70 6c 65 3b 0a 20 20 72 65 74 75 Multiple;. retu
6010: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
6020: 0a 2f 2a 20 54 68 69 73 20 68 65 6c 70 65 72 20 ./* This helper
6030: 72 6f 75 74 69 6e 65 20 74 6f 20 73 61 76 65 41 routine to saveA
6040: 6c 6c 43 75 72 73 6f 72 73 20 64 6f 65 73 20 74 llCursors does t
6050: 68 65 20 61 63 74 75 61 6c 20 77 6f 72 6b 20 6f he actual work o
6060: 66 20 73 61 76 69 6e 67 0a 2a 2a 20 74 68 65 20 f saving.** the
6070: 63 75 72 73 6f 72 73 20 69 66 20 61 6e 64 20 77 cursors if and w
6080: 68 65 6e 20 61 20 63 75 72 73 6f 72 20 69 73 20 hen a cursor is
6090: 66 6f 75 6e 64 20 74 68 61 74 20 61 63 74 75 61 found that actua
60a0: 6c 6c 79 20 72 65 71 75 69 72 65 73 20 73 61 76 lly requires sav
60b0: 69 6e 67 2e 0a 2a 2a 20 54 68 65 20 63 6f 6d 6d ing..** The comm
60c0: 6f 6e 20 63 61 73 65 20 69 73 20 74 68 61 74 20 on case is that
60d0: 6e 6f 20 63 75 72 73 6f 72 73 20 6e 65 65 64 20 no cursors need
60e0: 74 6f 20 62 65 20 73 61 76 65 64 2c 20 73 6f 20 to be saved, so
60f0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 0a this routine is.
6100: 2a 2a 20 62 72 6f 6b 65 6e 20 6f 75 74 20 66 72 ** broken out fr
6110: 6f 6d 20 69 74 73 20 63 61 6c 6c 65 72 20 74 6f om its caller to
6120: 20 61 76 6f 69 64 20 75 6e 6e 65 63 65 73 73 61 avoid unnecessa
6130: 72 79 20 73 74 61 63 6b 20 70 6f 69 6e 74 65 72 ry stack pointer
6140: 20 6d 6f 76 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 movement..*/.st
6150: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f atic int SQLITE_
6160: 4e 4f 49 4e 4c 49 4e 45 20 73 61 76 65 43 75 72 NOINLINE saveCur
6170: 73 6f 72 73 4f 6e 4c 69 73 74 28 0a 20 20 42 74 sorsOnList(. Bt
6180: 43 75 72 73 6f 72 20 2a 70 2c 20 20 20 20 20 20 Cursor *p,
6190: 20 20 20 2f 2a 20 54 68 65 20 66 69 72 73 74 20 /* The first
61a0: 63 75 72 73 6f 72 20 74 68 61 74 20 6e 65 65 64 cursor that need
61b0: 73 20 73 61 76 69 6e 67 20 2a 2f 0a 20 20 50 67 s saving */. Pg
61c0: 6e 6f 20 69 52 6f 6f 74 2c 20 20 20 20 20 20 20 no iRoot,
61d0: 20 20 20 2f 2a 20 4f 6e 6c 79 20 73 61 76 65 20 /* Only save
61e0: 63 75 72 73 6f 72 20 77 69 74 68 20 74 68 69 73 cursor with this
61f0: 20 69 52 6f 6f 74 2e 20 53 61 76 65 20 61 6c 6c iRoot. Save all
6200: 20 69 66 20 7a 65 72 6f 20 2a 2f 0a 20 20 42 74 if zero */. Bt
6210: 43 75 72 73 6f 72 20 2a 70 45 78 63 65 70 74 20 Cursor *pExcept
6220: 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 73 61 76 /* Do not sav
6230: 65 20 74 68 69 73 20 63 75 72 73 6f 72 20 2a 2f e this cursor */
6240: 0a 29 7b 0a 20 20 64 6f 7b 0a 20 20 20 20 69 66 .){. do{. if
6250: 28 20 70 21 3d 70 45 78 63 65 70 74 20 26 26 20 ( p!=pExcept &&
6260: 28 30 3d 3d 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e (0==iRoot || p->
6270: 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 pgnoRoot==iRoot)
6280: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 2d ){. if( p-
6290: 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
62a0: 56 41 4c 49 44 20 7c 7c 20 70 2d 3e 65 53 74 61 VALID || p->eSta
62b0: 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e te==CURSOR_SKIPN
62c0: 45 58 54 20 29 7b 0a 20 20 20 20 20 20 20 20 69 EXT ){. i
62d0: 6e 74 20 72 63 20 3d 20 73 61 76 65 43 75 72 73 nt rc = saveCurs
62e0: 6f 72 50 6f 73 69 74 69 6f 6e 28 70 29 3b 0a 20 orPosition(p);.
62f0: 20 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 if( SQLIT
6300: 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 E_OK!=rc ){.
6310: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
6320: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
6330: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
6340: 74 65 73 74 63 61 73 65 28 20 70 2d 3e 69 50 61 testcase( p->iPa
6350: 67 65 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 ge>0 );.
6360: 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c 43 btreeReleaseAllC
6370: 75 72 73 6f 72 50 61 67 65 73 28 70 29 3b 0a 20 ursorPages(p);.
6380: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
6390: 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 p = p->pNext;.
63a0: 20 7d 77 68 69 6c 65 28 20 70 20 29 3b 0a 20 20 }while( p );.
63b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
63c0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 ;.}../*.** Clear
63d0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 72 the current cur
63e0: 73 6f 72 20 70 6f 73 69 74 69 6f 6e 2e 0a 2a 2f sor position..*/
63f0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 .void sqlite3Btr
6400: 65 65 43 6c 65 61 72 43 75 72 73 6f 72 28 42 74 eeClearCursor(Bt
6410: 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
6420: 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
6430: 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
6440: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 );. sqlite3_fre
6450: 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 e(pCur->pKey);.
6460: 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 30 3b pCur->pKey = 0;
6470: 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 . pCur->eState
6480: 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
6490: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 20 74 68 ;.}../*.** In th
64a0: 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 42 74 is version of Bt
64b0: 72 65 65 4d 6f 76 65 74 6f 2c 20 70 4b 65 79 20 reeMoveto, pKey
64c0: 69 73 20 61 20 70 61 63 6b 65 64 20 69 6e 64 65 is a packed inde
64d0: 78 20 72 65 63 6f 72 64 0a 2a 2a 20 73 75 63 68 x record.** such
64e0: 20 61 73 20 69 73 20 67 65 6e 65 72 61 74 65 64 as is generated
64f0: 20 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 by the OP_MakeR
6500: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 20 20 55 ecord opcode. U
6510: 6e 70 61 63 6b 20 74 68 65 0a 2a 2a 20 72 65 63 npack the.** rec
6520: 6f 72 64 20 61 6e 64 20 74 68 65 6e 20 63 61 6c ord and then cal
6530: 6c 20 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 l BtreeMovetoUnp
6540: 61 63 6b 65 64 28 29 20 74 6f 20 64 6f 20 74 68 acked() to do th
6550: 65 20 77 6f 72 6b 2e 0a 2a 2f 0a 73 74 61 74 69 e work..*/.stati
6560: 63 20 69 6e 74 20 62 74 72 65 65 4d 6f 76 65 74 c int btreeMovet
6570: 6f 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 o(. BtCursor *p
6580: 43 75 72 2c 20 20 20 20 20 2f 2a 20 43 75 72 73 Cur, /* Curs
6590: 6f 72 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 62 or open on the b
65a0: 74 72 65 65 20 74 6f 20 62 65 20 73 65 61 72 63 tree to be searc
65b0: 68 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 hed */. const v
65c0: 6f 69 64 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 oid *pKey, /*
65d0: 50 61 63 6b 65 64 20 6b 65 79 20 69 66 20 74 68 Packed key if th
65e0: 65 20 62 74 72 65 65 20 69 73 20 61 6e 20 69 6e e btree is an in
65f0: 64 65 78 20 2a 2f 0a 20 20 69 36 34 20 6e 4b 65 dex */. i64 nKe
6600: 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 y, /*
6610: 49 6e 74 65 67 65 72 20 6b 65 79 20 66 6f 72 20 Integer key for
6620: 74 61 62 6c 65 73 2e 20 20 53 69 7a 65 20 6f 66 tables. Size of
6630: 20 70 4b 65 79 20 66 6f 72 20 69 6e 64 69 63 65 pKey for indice
6640: 73 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 2c s */. int bias,
6650: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 69 /* Bi
6660: 61 73 20 73 65 61 72 63 68 20 74 6f 20 74 68 65 as search to the
6670: 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 high end */. i
6680: 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20 nt *pRes
6690: 20 20 20 2f 2a 20 57 72 69 74 65 20 73 65 61 72 /* Write sear
66a0: 63 68 20 72 65 73 75 6c 74 73 20 68 65 72 65 20 ch results here
66b0: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 */.){. int rc;
66c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
66d0: 20 20 20 2f 2a 20 53 74 61 74 75 73 20 63 6f 64 /* Status cod
66e0: 65 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 e */. UnpackedR
66f0: 65 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 3b 20 ecord *pIdxKey;
6700: 20 20 2f 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e /* Unpacked in
6710: 64 65 78 20 6b 65 79 20 2a 2f 0a 0a 20 20 69 66 dex key */.. if
6720: 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 61 73 ( pKey ){. as
6730: 73 65 72 74 28 20 6e 4b 65 79 3d 3d 28 69 36 34 sert( nKey==(i64
6740: 29 28 69 6e 74 29 6e 4b 65 79 20 29 3b 0a 20 20 )(int)nKey );.
6750: 20 20 70 49 64 78 4b 65 79 20 3d 20 73 71 6c 69 pIdxKey = sqli
6760: 74 65 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 61 te3VdbeAllocUnpa
6770: 63 6b 65 64 52 65 63 6f 72 64 28 70 43 75 72 2d ckedRecord(pCur-
6780: 3e 70 4b 65 79 49 6e 66 6f 29 3b 0a 20 20 20 20 >pKeyInfo);.
6790: 69 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 20 29 if( pIdxKey==0 )
67a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
67b0: 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 73 OMEM_BKPT;. s
67c0: 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 qlite3VdbeRecord
67d0: 55 6e 70 61 63 6b 28 70 43 75 72 2d 3e 70 4b 65 Unpack(pCur->pKe
67e0: 79 49 6e 66 6f 2c 20 28 69 6e 74 29 6e 4b 65 79 yInfo, (int)nKey
67f0: 2c 20 70 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 , pKey, pIdxKey)
6800: 3b 0a 20 20 20 20 69 66 28 20 70 49 64 78 4b 65 ;. if( pIdxKe
6810: 79 2d 3e 6e 46 69 65 6c 64 3d 3d 30 20 29 7b 0a y->nField==0 ){.
6820: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
6830: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
6840: 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
6850: 6f 5f 64 6f 6e 65 3b 0a 20 20 20 20 7d 0a 20 20 o_done;. }.
6860: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 64 78 4b }else{. pIdxK
6870: 65 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 63 ey = 0;. }. rc
6880: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d = sqlite3BtreeM
6890: 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 70 43 ovetoUnpacked(pC
68a0: 75 72 2c 20 70 49 64 78 4b 65 79 2c 20 6e 4b 65 ur, pIdxKey, nKe
68b0: 79 2c 20 62 69 61 73 2c 20 70 52 65 73 29 3b 0a y, bias, pRes);.
68c0: 6d 6f 76 65 74 6f 5f 64 6f 6e 65 3a 0a 20 20 69 moveto_done:. i
68d0: 66 28 20 70 49 64 78 4b 65 79 20 29 7b 0a 20 20 f( pIdxKey ){.
68e0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
68f0: 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2d 3e pCur->pKeyInfo->
6900: 64 62 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 db, pIdxKey);.
6910: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
6920: 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 74 6f 72 65 20 ../*.** Restore
6930: 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 the cursor to th
6940: 65 20 70 6f 73 69 74 69 6f 6e 20 69 74 20 77 61 e position it wa
6950: 73 20 69 6e 20 28 6f 72 20 61 73 20 63 6c 6f 73 s in (or as clos
6960: 65 20 74 6f 20 61 73 20 70 6f 73 73 69 62 6c 65 e to as possible
6970: 29 0a 2a 2a 20 77 68 65 6e 20 73 61 76 65 43 75 ).** when saveCu
6980: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 20 77 rsorPosition() w
6990: 61 73 20 63 61 6c 6c 65 64 2e 20 4e 6f 74 65 20 as called. Note
69a0: 74 68 61 74 20 74 68 69 73 20 63 61 6c 6c 20 64 that this call d
69b0: 65 6c 65 74 65 73 20 74 68 65 20 0a 2a 2a 20 73 eletes the .** s
69c0: 61 76 65 64 20 70 6f 73 69 74 69 6f 6e 20 69 6e aved position in
69d0: 66 6f 20 73 74 6f 72 65 64 20 62 79 20 73 61 76 fo stored by sav
69e0: 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
69f0: 29 2c 20 73 6f 20 74 68 65 72 65 20 63 61 6e 20 ), so there can
6a00: 62 65 0a 2a 2a 20 61 74 20 6d 6f 73 74 20 6f 6e be.** at most on
6a10: 65 20 65 66 66 65 63 74 69 76 65 20 72 65 73 74 e effective rest
6a20: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
6a30: 6e 28 29 20 63 61 6c 6c 20 61 66 74 65 72 20 65 n() call after e
6a40: 61 63 68 20 0a 2a 2a 20 73 61 76 65 43 75 72 73 ach .** saveCurs
6a50: 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2e 0a 2a 2f orPosition()..*/
6a60: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
6a70: 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f eRestoreCursorPo
6a80: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
6a90: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
6aa0: 3b 0a 20 20 69 6e 74 20 73 6b 69 70 4e 65 78 74 ;. int skipNext
6ab0: 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
6ac0: 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
6ad0: 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
6ae0: 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d ( pCur->eState>=
6af0: 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 CURSOR_REQUIRESE
6b00: 45 4b 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 EK );. if( pCur
6b10: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
6b20: 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 20 72 65 _FAULT ){. re
6b30: 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 4e turn pCur->skipN
6b40: 65 78 74 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d ext;. }. pCur-
6b50: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
6b60: 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 72 63 20 3d _INVALID;. rc =
6b70: 20 62 74 72 65 65 4d 6f 76 65 74 6f 28 70 43 75 btreeMoveto(pCu
6b80: 72 2c 20 70 43 75 72 2d 3e 70 4b 65 79 2c 20 70 r, pCur->pKey, p
6b90: 43 75 72 2d 3e 6e 4b 65 79 2c 20 30 2c 20 26 73 Cur->nKey, 0, &s
6ba0: 6b 69 70 4e 65 78 74 29 3b 0a 20 20 69 66 28 20 kipNext);. if(
6bb0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
6bc0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
6bd0: 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 e(pCur->pKey);.
6be0: 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 pCur->pKey =
6bf0: 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 0;. assert( p
6c00: 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
6c10: 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 SOR_VALID || pCu
6c20: 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
6c30: 52 5f 49 4e 56 41 4c 49 44 20 29 3b 0a 20 20 20 R_INVALID );.
6c40: 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
6c50: 7c 3d 20 73 6b 69 70 4e 65 78 74 3b 0a 20 20 20 |= skipNext;.
6c60: 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e if( pCur->skipN
6c70: 65 78 74 20 26 26 20 70 43 75 72 2d 3e 65 53 74 ext && pCur->eSt
6c80: 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
6c90: 44 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d D ){. pCur-
6ca0: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
6cb0: 5f 53 4b 49 50 4e 45 58 54 3b 0a 20 20 20 20 7d _SKIPNEXT;. }
6cc0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
6cd0: 3b 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 72 65 73 ;.}..#define res
6ce0: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
6cf0: 6f 6e 28 70 29 20 5c 0a 20 20 28 70 2d 3e 65 53 on(p) \. (p->eS
6d00: 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
6d10: 55 49 52 45 53 45 45 4b 20 3f 20 5c 0a 20 20 20 UIRESEEK ? \.
6d20: 20 20 20 20 20 20 62 74 72 65 65 52 65 73 74 6f btreeResto
6d30: 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e reCursorPosition
6d40: 28 70 29 20 3a 20 5c 0a 20 20 20 20 20 20 20 20 (p) : \.
6d50: 20 53 51 4c 49 54 45 5f 4f 4b 29 0a 0a 2f 2a 0a SQLITE_OK)../*.
6d60: 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 ** Determine whe
6d70: 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 63 75 ther or not a cu
6d80: 72 73 6f 72 20 68 61 73 20 6d 6f 76 65 64 20 66 rsor has moved f
6d90: 72 6f 6d 20 74 68 65 20 70 6f 73 69 74 69 6f 6e rom the position
6da0: 20 77 68 65 72 65 0a 2a 2a 20 69 74 20 77 61 73 where.** it was
6db0: 20 6c 61 73 74 20 70 6c 61 63 65 64 2c 20 6f 72 last placed, or
6dc0: 20 68 61 73 20 62 65 65 6e 20 69 6e 76 61 6c 69 has been invali
6dd0: 64 61 74 65 64 20 66 6f 72 20 61 6e 79 20 6f 74 dated for any ot
6de0: 68 65 72 20 72 65 61 73 6f 6e 2e 0a 2a 2a 20 43 her reason..** C
6df0: 75 72 73 6f 72 73 20 63 61 6e 20 6d 6f 76 65 20 ursors can move
6e00: 77 68 65 6e 20 74 68 65 20 72 6f 77 20 74 68 65 when the row the
6e10: 79 20 61 72 65 20 70 6f 69 6e 74 69 6e 67 20 61 y are pointing a
6e20: 74 20 69 73 20 64 65 6c 65 74 65 64 20 6f 75 74 t is deleted out
6e30: 0a 2a 2a 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 .** from under t
6e40: 68 65 6d 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 hem, for example
6e50: 2e 20 20 43 75 72 73 6f 72 20 6d 69 67 68 74 20 . Cursor might
6e60: 61 6c 73 6f 20 6d 6f 76 65 20 69 66 20 61 20 62 also move if a b
6e70: 74 72 65 65 0a 2a 2a 20 69 73 20 72 65 62 61 6c tree.** is rebal
6e80: 61 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c anced..**.** Cal
6e90: 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e ling this routin
6ea0: 65 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 63 75 e with a NULL cu
6eb0: 72 73 6f 72 20 70 6f 69 6e 74 65 72 20 72 65 74 rsor pointer ret
6ec0: 75 72 6e 73 20 66 61 6c 73 65 2e 0a 2a 2a 0a 2a urns false..**.*
6ed0: 2a 20 55 73 65 20 74 68 65 20 73 65 70 61 72 61 * Use the separa
6ee0: 74 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 te sqlite3BtreeC
6ef0: 75 72 73 6f 72 52 65 73 74 6f 72 65 28 29 20 72 ursorRestore() r
6f00: 6f 75 74 69 6e 65 20 74 6f 20 72 65 73 74 6f 72 outine to restor
6f10: 65 20 61 20 63 75 72 73 6f 72 0a 2a 2a 20 62 61 e a cursor.** ba
6f20: 63 6b 20 74 6f 20 77 68 65 72 65 20 69 74 20 6f ck to where it o
6f30: 75 67 68 74 20 74 6f 20 62 65 20 69 66 20 74 68 ught to be if th
6f40: 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 is routine retur
6f50: 6e 73 20 74 72 75 65 2e 0a 2a 2f 0a 69 6e 74 20 ns true..*/.int
6f60: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
6f70: 6f 72 48 61 73 4d 6f 76 65 64 28 42 74 43 75 72 orHasMoved(BtCur
6f80: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 65 sor *pCur){. re
6f90: 74 75 72 6e 20 70 43 75 72 2d 3e 65 53 74 61 74 turn pCur->eStat
6fa0: 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b e!=CURSOR_VALID;
6fb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 .}../*.** This r
6fc0: 6f 75 74 69 6e 65 20 72 65 73 74 6f 72 65 73 20 outine restores
6fd0: 61 20 63 75 72 73 6f 72 20 62 61 63 6b 20 74 6f a cursor back to
6fe0: 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 70 6f its original po
6ff0: 73 69 74 69 6f 6e 20 61 66 74 65 72 20 69 74 0a sition after it.
7000: 2a 2a 20 68 61 73 20 62 65 65 6e 20 6d 6f 76 65 ** has been move
7010: 64 20 62 79 20 73 6f 6d 65 20 6f 75 74 73 69 64 d by some outsid
7020: 65 20 61 63 74 69 76 69 74 79 20 28 73 75 63 68 e activity (such
7030: 20 61 73 20 61 20 62 74 72 65 65 20 72 65 62 61 as a btree reba
7040: 6c 61 6e 63 65 20 6f 72 0a 2a 2a 20 61 20 72 6f lance or.** a ro
7050: 77 20 68 61 76 69 6e 67 20 62 65 65 6e 20 64 65 w having been de
7060: 6c 65 74 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 leted out from u
7070: 6e 64 65 72 20 74 68 65 20 63 75 72 73 6f 72 29 nder the cursor)
7080: 2e 20 20 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 . .**.** On suc
7090: 63 65 73 73 2c 20 74 68 65 20 2a 70 44 69 66 66 cess, the *pDiff
70a0: 65 72 65 6e 74 52 6f 77 20 70 61 72 61 6d 65 74 erentRow paramet
70b0: 65 72 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 er is false if t
70c0: 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 he cursor is lef
70d0: 74 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 20 61 74 t.** pointing at
70e0: 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d exactly the sam
70f0: 65 20 72 6f 77 2e 20 20 2a 70 44 69 66 66 65 72 e row. *pDiffer
7100: 6e 74 52 6f 77 20 69 73 20 74 68 65 20 72 6f 77 ntRow is the row
7110: 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 the cursor.** w
7120: 61 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 68 as pointing to h
7130: 61 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2c as been deleted,
7140: 20 66 6f 72 63 69 6e 67 20 74 68 65 20 63 75 72 forcing the cur
7150: 73 6f 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 sor to point to
7160: 73 6f 6d 65 0a 2a 2a 20 6e 65 61 72 62 79 20 72 some.** nearby r
7170: 6f 77 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ow..**.** This r
7180: 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e outine should on
7190: 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 66 6f 72 ly be called for
71a0: 20 61 20 63 75 72 73 6f 72 20 74 68 61 74 20 6a a cursor that j
71b0: 75 73 74 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20 ust returned.**
71c0: 54 52 55 45 20 66 72 6f 6d 20 73 71 6c 69 74 65 TRUE from sqlite
71d0: 33 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 3BtreeCursorHasM
71e0: 6f 76 65 64 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 oved()..*/.int s
71f0: 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f qlite3BtreeCurso
7200: 72 52 65 73 74 6f 72 65 28 42 74 43 75 72 73 6f rRestore(BtCurso
7210: 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 44 r *pCur, int *pD
7220: 69 66 66 65 72 65 6e 74 52 6f 77 29 7b 0a 20 20 ifferentRow){.
7230: 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
7240: 74 28 20 70 43 75 72 21 3d 30 20 29 3b 0a 20 20 t( pCur!=0 );.
7250: 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
7260: 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
7270: 49 44 20 29 3b 0a 20 20 72 63 20 3d 20 72 65 73 ID );. rc = res
7280: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
7290: 6f 6e 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 on(pCur);. if(
72a0: 72 63 20 29 7b 0a 20 20 20 20 2a 70 44 69 66 66 rc ){. *pDiff
72b0: 65 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a 20 20 erentRow = 1;.
72c0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
72d0: 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
72e0: 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
72f0: 44 20 29 7b 0a 20 20 20 20 2a 70 44 69 66 66 65 D ){. *pDiffe
7300: 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a 20 20 7d rentRow = 1;. }
7310: 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 else{. assert
7320: 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
7330: 3d 3d 30 20 29 3b 0a 20 20 20 20 2a 70 44 69 66 ==0 );. *pDif
7340: 66 65 72 65 6e 74 52 6f 77 20 3d 20 30 3b 0a 20 ferentRow = 0;.
7350: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
7360: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66 TE_OK;.}..#ifdef
7370: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 SQLITE_ENABLE_C
7380: 55 52 53 4f 52 5f 48 49 4e 54 53 0a 2f 2a 0a 2a URSOR_HINTS./*.*
7390: 2a 20 50 72 6f 76 69 64 65 20 68 69 6e 74 73 20 * Provide hints
73a0: 74 6f 20 74 68 65 20 63 75 72 73 6f 72 2e 20 20 to the cursor.
73b0: 54 68 65 20 70 61 72 74 69 63 75 6c 61 72 20 68 The particular h
73c0: 69 6e 74 20 67 69 76 65 6e 20 28 61 6e 64 20 74 int given (and t
73d0: 68 65 20 74 79 70 65 0a 2a 2a 20 61 6e 64 20 6e he type.** and n
73e0: 75 6d 62 65 72 20 6f 66 20 74 68 65 20 76 61 72 umber of the var
73f0: 61 72 67 73 20 70 61 72 61 6d 65 74 65 72 73 29 args parameters)
7400: 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 62 is determined b
7410: 79 20 74 68 65 20 65 48 69 6e 74 54 79 70 65 0a y the eHintType.
7420: 2a 2a 20 70 61 72 61 6d 65 74 65 72 2e 20 20 53 ** parameter. S
7430: 65 65 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f ee the definitio
7440: 6e 73 20 6f 66 20 74 68 65 20 42 54 52 45 45 5f ns of the BTREE_
7450: 48 49 4e 54 5f 2a 20 6d 61 63 72 6f 73 20 66 6f HINT_* macros fo
7460: 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 76 6f r details..*/.vo
7470: 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 id sqlite3BtreeC
7480: 75 72 73 6f 72 48 69 6e 74 28 42 74 43 75 72 73 ursorHint(BtCurs
7490: 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 65 48 or *pCur, int eH
74a0: 69 6e 74 54 79 70 65 2c 20 2e 2e 2e 29 7b 0a 20 intType, ...){.
74b0: 20 2f 2a 20 55 73 65 64 20 6f 6e 6c 79 20 62 79 /* Used only by
74c0: 20 73 79 73 74 65 6d 20 74 68 61 74 20 73 75 62 system that sub
74d0: 73 74 69 74 75 74 65 20 74 68 65 69 72 20 6f 77 stitute their ow
74e0: 6e 20 73 74 6f 72 61 67 65 20 65 6e 67 69 6e 65 n storage engine
74f0: 20 2a 2f 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a */.}.#endif../*
7500: 0a 2a 2a 20 50 72 6f 76 69 64 65 20 66 6c 61 67 .** Provide flag
7510: 20 68 69 6e 74 73 20 74 6f 20 74 68 65 20 63 75 hints to the cu
7520: 72 73 6f 72 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 rsor..*/.void sq
7530: 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 lite3BtreeCursor
7540: 48 69 6e 74 46 6c 61 67 73 28 42 74 43 75 72 73 HintFlags(BtCurs
7550: 6f 72 20 2a 70 43 75 72 2c 20 75 6e 73 69 67 6e or *pCur, unsign
7560: 65 64 20 78 29 7b 0a 20 20 61 73 73 65 72 74 28 ed x){. assert(
7570: 20 78 3d 3d 42 54 52 45 45 5f 53 45 45 4b 5f 45 x==BTREE_SEEK_E
7580: 51 20 7c 7c 20 78 3d 3d 42 54 52 45 45 5f 42 55 Q || x==BTREE_BU
7590: 4c 4b 4c 4f 41 44 20 7c 7c 20 78 3d 3d 30 20 29 LKLOAD || x==0 )
75a0: 3b 0a 20 20 70 43 75 72 2d 3e 68 69 6e 74 73 20 ;. pCur->hints
75b0: 3d 20 78 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 = x;.}...#ifndef
75c0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
75d0: 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 47 69 OVACUUM./*.** Gi
75e0: 76 65 6e 20 61 20 70 61 67 65 20 6e 75 6d 62 65 ven a page numbe
75f0: 72 20 6f 66 20 61 20 72 65 67 75 6c 61 72 20 64 r of a regular d
7600: 61 74 61 62 61 73 65 20 70 61 67 65 2c 20 72 65 atabase page, re
7610: 74 75 72 6e 20 74 68 65 20 70 61 67 65 0a 2a 2a turn the page.**
7620: 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 65 20 number for the
7630: 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 pointer-map page
7640: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
7650: 68 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 he entry for the
7660: 0a 2a 2a 20 69 6e 70 75 74 20 70 61 67 65 20 6e .** input page n
7670: 75 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 umber..**.** Ret
7680: 75 72 6e 20 30 20 28 6e 6f 74 20 61 20 76 61 6c urn 0 (not a val
7690: 69 64 20 70 61 67 65 29 20 66 6f 72 20 70 67 6e id page) for pgn
76a0: 6f 3d 3d 31 20 73 69 6e 63 65 20 74 68 65 72 65 o==1 since there
76b0: 20 69 73 0a 2a 2a 20 6e 6f 20 70 6f 69 6e 74 65 is.** no pointe
76c0: 72 20 6d 61 70 20 61 73 73 6f 63 69 61 74 65 64 r map associated
76d0: 20 77 69 74 68 20 70 61 67 65 20 31 2e 20 20 54 with page 1. T
76e0: 68 65 20 69 6e 74 65 67 72 69 74 79 5f 63 68 65 he integrity_che
76f0: 63 6b 20 6c 6f 67 69 63 0a 2a 2a 20 72 65 71 75 ck logic.** requ
7700: 69 72 65 73 20 74 68 61 74 20 70 74 72 6d 61 70 ires that ptrmap
7710: 50 61 67 65 6e 6f 28 2a 2c 31 29 21 3d 31 2e 0a Pageno(*,1)!=1..
7720: 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f 20 70 */.static Pgno p
7730: 74 72 6d 61 70 50 61 67 65 6e 6f 28 42 74 53 68 trmapPageno(BtSh
7740: 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 ared *pBt, Pgno
7750: 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 6e 50 61 pgno){. int nPa
7760: 67 65 73 50 65 72 4d 61 70 50 61 67 65 3b 0a 20 gesPerMapPage;.
7770: 20 50 67 6e 6f 20 69 50 74 72 4d 61 70 2c 20 72 Pgno iPtrMap, r
7780: 65 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 et;. assert( sq
7790: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
77a0: 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
77b0: 20 20 69 66 28 20 70 67 6e 6f 3c 32 20 29 20 72 if( pgno<2 ) r
77c0: 65 74 75 72 6e 20 30 3b 0a 20 20 6e 50 61 67 65 eturn 0;. nPage
77d0: 73 50 65 72 4d 61 70 50 61 67 65 20 3d 20 28 70 sPerMapPage = (p
77e0: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 35 Bt->usableSize/5
77f0: 29 2b 31 3b 0a 20 20 69 50 74 72 4d 61 70 20 3d )+1;. iPtrMap =
7800: 20 28 70 67 6e 6f 2d 32 29 2f 6e 50 61 67 65 73 (pgno-2)/nPages
7810: 50 65 72 4d 61 70 50 61 67 65 3b 0a 20 20 72 65 PerMapPage;. re
7820: 74 20 3d 20 28 69 50 74 72 4d 61 70 2a 6e 50 61 t = (iPtrMap*nPa
7830: 67 65 73 50 65 72 4d 61 70 50 61 67 65 29 20 2b gesPerMapPage) +
7840: 20 32 3b 20 0a 20 20 69 66 28 20 72 65 74 3d 3d 2; . if( ret==
7850: 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
7860: 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 72 65 E(pBt) ){. re
7870: 74 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 t++;. }. retur
7880: 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n ret;.}../*.**
7890: 57 72 69 74 65 20 61 6e 20 65 6e 74 72 79 20 69 Write an entry i
78a0: 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 20 nto the pointer
78b0: 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 map..**.** This
78c0: 72 6f 75 74 69 6e 65 20 75 70 64 61 74 65 73 20 routine updates
78d0: 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 the pointer map
78e0: 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 6e entry for page n
78f0: 75 6d 62 65 72 20 27 6b 65 79 27 0a 2a 2a 20 73 umber 'key'.** s
7900: 6f 20 74 68 61 74 20 69 74 20 6d 61 70 73 20 74 o that it maps t
7910: 6f 20 74 79 70 65 20 27 65 54 79 70 65 27 20 61 o type 'eType' a
7920: 6e 64 20 70 61 72 65 6e 74 20 70 61 67 65 20 6e nd parent page n
7930: 75 6d 62 65 72 20 27 70 67 6e 6f 27 2e 0a 2a 2a umber 'pgno'..**
7940: 0a 2a 2a 20 49 66 20 2a 70 52 43 20 69 73 20 69 .** If *pRC is i
7950: 6e 69 74 69 61 6c 6c 79 20 6e 6f 6e 2d 7a 65 72 nitially non-zer
7960: 6f 20 28 6e 6f 6e 2d 53 51 4c 49 54 45 5f 4f 4b o (non-SQLITE_OK
7970: 29 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 ) then this rout
7980: 69 6e 65 20 69 73 0a 2a 2a 20 61 20 6e 6f 2d 6f ine is.** a no-o
7990: 70 2e 20 20 49 66 20 61 6e 20 65 72 72 6f 72 20 p. If an error
79a0: 6f 63 63 75 72 73 2c 20 74 68 65 20 61 70 70 72 occurs, the appr
79b0: 6f 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f opriate error co
79c0: 64 65 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a de is written.**
79d0: 20 69 6e 74 6f 20 2a 70 52 43 2e 0a 2a 2f 0a 73 into *pRC..*/.s
79e0: 74 61 74 69 63 20 76 6f 69 64 20 70 74 72 6d 61 tatic void ptrma
79f0: 70 50 75 74 28 42 74 53 68 61 72 65 64 20 2a 70 pPut(BtShared *p
7a00: 42 74 2c 20 50 67 6e 6f 20 6b 65 79 2c 20 75 38 Bt, Pgno key, u8
7a10: 20 65 54 79 70 65 2c 20 50 67 6e 6f 20 70 61 72 eType, Pgno par
7a20: 65 6e 74 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a ent, int *pRC){.
7a30: 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 DbPage *pDbPag
7a40: 65 3b 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 e; /* The point
7a50: 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 er map page */.
7a60: 20 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 u8 *pPtrmap;
7a70: 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 /* The pointe
7a80: 72 20 6d 61 70 20 64 61 74 61 20 2a 2f 0a 20 20 r map data */.
7a90: 50 67 6e 6f 20 69 50 74 72 6d 61 70 3b 20 20 20 Pgno iPtrmap;
7aa0: 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 /* The pointer
7ab0: 20 6d 61 70 20 70 61 67 65 20 6e 75 6d 62 65 72 map page number
7ac0: 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 73 65 74 */. int offset
7ad0: 3b 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 ; /* Offse
7ae0: 74 20 69 6e 20 70 6f 69 6e 74 65 72 20 6d 61 70 t in pointer map
7af0: 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 72 page */. int r
7b00: 63 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 c; /*
7b10: 52 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d Return code from
7b20: 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f subfunctions */
7b30: 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 .. if( *pRC ) r
7b40: 65 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 eturn;.. assert
7b50: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
7b60: 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
7b70: 20 29 3b 0a 20 20 2f 2a 20 54 68 65 20 6d 61 73 );. /* The mas
7b80: 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 61 67 65 ter-journal page
7b90: 20 6e 75 6d 62 65 72 20 6d 75 73 74 20 6e 65 76 number must nev
7ba0: 65 72 20 62 65 20 75 73 65 64 20 61 73 20 61 20 er be used as a
7bb0: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
7bc0: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 30 3d */. assert( 0=
7bd0: 3d 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 =PTRMAP_ISPAGE(p
7be0: 42 74 2c 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 Bt, PENDING_BYTE
7bf0: 5f 50 41 47 45 28 70 42 74 29 29 20 29 3b 0a 0a _PAGE(pBt)) );..
7c00: 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 assert( pBt->a
7c10: 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 69 utoVacuum );. i
7c20: 66 28 20 6b 65 79 3d 3d 30 20 29 7b 0a 20 20 20 f( key==0 ){.
7c30: 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 45 5f 43 *pRC = SQLITE_C
7c40: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
7c50: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 return;. }. i
7c60: 50 74 72 6d 61 70 20 3d 20 50 54 52 4d 41 50 5f Ptrmap = PTRMAP_
7c70: 50 41 47 45 4e 4f 28 70 42 74 2c 20 6b 65 79 29 PAGENO(pBt, key)
7c80: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
7c90: 50 61 67 65 72 47 65 74 28 70 42 74 2d 3e 70 50 PagerGet(pBt->pP
7ca0: 61 67 65 72 2c 20 69 50 74 72 6d 61 70 2c 20 26 ager, iPtrmap, &
7cb0: 70 44 62 50 61 67 65 2c 20 30 29 3b 0a 20 20 69 pDbPage, 0);. i
7cc0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
7cd0: 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 72 ){. *pRC = r
7ce0: 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 c;. return;.
7cf0: 20 7d 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 }. offset = PT
7d00: 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 RMAP_PTROFFSET(i
7d10: 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 Ptrmap, key);.
7d20: 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a if( offset<0 ){.
7d30: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
7d40: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
7d50: 20 20 20 20 67 6f 74 6f 20 70 74 72 6d 61 70 5f goto ptrmap_
7d60: 65 78 69 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 exit;. }. asse
7d70: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
7d80: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
7d90: 7a 65 2d 35 20 29 3b 0a 20 20 70 50 74 72 6d 61 ze-5 );. pPtrma
7da0: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
7db0: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
7dc0: 62 50 61 67 65 29 3b 0a 0a 20 20 69 66 28 20 65 bPage);.. if( e
7dd0: 54 79 70 65 21 3d 70 50 74 72 6d 61 70 5b 6f 66 Type!=pPtrmap[of
7de0: 66 73 65 74 5d 20 7c 7c 20 67 65 74 34 62 79 74 fset] || get4byt
7df0: 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 e(&pPtrmap[offse
7e00: 74 2b 31 5d 29 21 3d 70 61 72 65 6e 74 20 29 7b t+1])!=parent ){
7e10: 0a 20 20 20 20 54 52 41 43 45 28 28 22 50 54 52 . TRACE(("PTR
7e20: 4d 41 50 5f 55 50 44 41 54 45 3a 20 25 64 2d 3e MAP_UPDATE: %d->
7e30: 28 25 64 2c 25 64 29 5c 6e 22 2c 20 6b 65 79 2c (%d,%d)\n", key,
7e40: 20 65 54 79 70 65 2c 20 70 61 72 65 6e 74 29 29 eType, parent))
7e50: 3b 0a 20 20 20 20 2a 70 52 43 3d 20 72 63 20 3d ;. *pRC= rc =
7e60: 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
7e70: 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
7e80: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
7e90: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 74 72 OK ){. pPtr
7ea0: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 3d 20 65 54 map[offset] = eT
7eb0: 79 70 65 3b 0a 20 20 20 20 20 20 70 75 74 34 62 ype;. put4b
7ec0: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
7ed0: 73 65 74 2b 31 5d 2c 20 70 61 72 65 6e 74 29 3b set+1], parent);
7ee0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 70 74 72 6d . }. }..ptrm
7ef0: 61 70 5f 65 78 69 74 3a 0a 20 20 73 71 6c 69 74 ap_exit:. sqlit
7f00: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
7f10: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
7f20: 52 65 61 64 20 61 6e 20 65 6e 74 72 79 20 66 72 Read an entry fr
7f30: 6f 6d 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d om the pointer m
7f40: 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ap..**.** This r
7f50: 6f 75 74 69 6e 65 20 72 65 74 72 69 65 76 65 73 outine retrieves
7f60: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
7f70: 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 entry for page
7f80: 27 6b 65 79 27 2c 20 77 72 69 74 69 6e 67 0a 2a 'key', writing.*
7f90: 2a 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 70 * the type and p
7fa0: 61 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 arent page numbe
7fb0: 72 20 74 6f 20 2a 70 45 54 79 70 65 20 61 6e 64 r to *pEType and
7fc0: 20 2a 70 50 67 6e 6f 20 72 65 73 70 65 63 74 69 *pPgno respecti
7fd0: 76 65 6c 79 2e 0a 2a 2a 20 41 6e 20 65 72 72 6f vely..** An erro
7fe0: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
7ff0: 65 64 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 ed if something
8000: 67 6f 65 73 20 77 72 6f 6e 67 2c 20 6f 74 68 65 goes wrong, othe
8010: 72 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b 2e rwise SQLITE_OK.
8020: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
8030: 74 72 6d 61 70 47 65 74 28 42 74 53 68 61 72 65 trmapGet(BtShare
8040: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 d *pBt, Pgno key
8050: 2c 20 75 38 20 2a 70 45 54 79 70 65 2c 20 50 67 , u8 *pEType, Pg
8060: 6e 6f 20 2a 70 50 67 6e 6f 29 7b 0a 20 20 44 62 no *pPgno){. Db
8070: 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 Page *pDbPage;
8080: 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
8090: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
80a0: 74 20 69 50 74 72 6d 61 70 3b 20 20 20 20 20 20 t iPtrmap;
80b0: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
80c0: 70 61 67 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 page index */.
80d0: 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 20 u8 *pPtrmap;
80e0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 /* Pointer ma
80f0: 70 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 p page data */.
8100: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
8110: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
8120: 20 65 6e 74 72 79 20 69 6e 20 70 6f 69 6e 74 65 entry in pointe
8130: 72 20 6d 61 70 20 2a 2f 0a 20 20 69 6e 74 20 72 r map */. int r
8140: 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 c;.. assert( sq
8150: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
8160: 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
8170: 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 . iPtrmap = PTR
8180: 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
8190: 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c key);. rc = sql
81a0: 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 ite3PagerGet(pBt
81b0: 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 ->pPager, iPtrma
81c0: 70 2c 20 26 70 44 62 50 61 67 65 2c 20 30 29 3b p, &pDbPage, 0);
81d0: 0a 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a . if( rc!=0 ){.
81e0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
81f0: 20 7d 0a 20 20 70 50 74 72 6d 61 70 20 3d 20 28 }. pPtrmap = (
8200: 75 38 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 u8 *)sqlite3Page
8210: 72 47 65 74 44 61 74 61 28 70 44 62 50 61 67 65 rGetData(pDbPage
8220: 29 3b 0a 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 );.. offset = P
8230: 54 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 TRMAP_PTROFFSET(
8240: 69 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 iPtrmap, key);.
8250: 20 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b if( offset<0 ){
8260: 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 . sqlite3Page
8270: 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b rUnref(pDbPage);
8280: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
8290: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
82a0: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6f . }. assert( o
82b0: 66 66 73 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 ffset <= (int)pB
82c0: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 t->usableSize-5
82d0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 45 54 );. assert( pET
82e0: 79 70 65 21 3d 30 20 29 3b 0a 20 20 2a 70 45 54 ype!=0 );. *pET
82f0: 79 70 65 20 3d 20 70 50 74 72 6d 61 70 5b 6f 66 ype = pPtrmap[of
8300: 66 73 65 74 5d 3b 0a 20 20 69 66 28 20 70 50 67 fset];. if( pPg
8310: 6e 6f 20 29 20 2a 70 50 67 6e 6f 20 3d 20 67 65 no ) *pPgno = ge
8320: 74 34 62 79 74 65 28 26 70 50 74 72 6d 61 70 5b t4byte(&pPtrmap[
8330: 6f 66 66 73 65 74 2b 31 5d 29 3b 0a 0a 20 20 73 offset+1]);.. s
8340: 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
8350: 28 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 (pDbPage);. if(
8360: 20 2a 70 45 54 79 70 65 3c 31 20 7c 7c 20 2a 70 *pEType<1 || *p
8370: 45 54 79 70 65 3e 35 20 29 20 72 65 74 75 72 6e EType>5 ) return
8380: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
8390: 42 4b 50 54 3b 0a 20 20 72 65 74 75 72 6e 20 53 BKPT;. return S
83a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6c QLITE_OK;.}..#el
83b0: 73 65 20 2f 2a 20 69 66 20 64 65 66 69 6e 65 64 se /* if defined
83c0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
83d0: 4f 56 41 43 55 55 4d 20 2a 2f 0a 20 20 23 64 65 OVACUUM */. #de
83e0: 66 69 6e 65 20 70 74 72 6d 61 70 50 75 74 28 77 fine ptrmapPut(w
83f0: 2c 78 2c 79 2c 7a 2c 72 63 29 0a 20 20 23 64 65 ,x,y,z,rc). #de
8400: 66 69 6e 65 20 70 74 72 6d 61 70 47 65 74 28 77 fine ptrmapGet(w
8410: 2c 78 2c 79 2c 7a 29 20 53 51 4c 49 54 45 5f 4f ,x,y,z) SQLITE_O
8420: 4b 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d K. #define ptrm
8430: 61 70 50 75 74 4f 76 66 6c 50 74 72 28 78 2c 20 apPutOvflPtr(x,
8440: 79 2c 20 72 63 29 0a 23 65 6e 64 69 66 0a 0a 2f y, rc).#endif../
8450: 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20 62 74 72 *.** Given a btr
8460: 65 65 20 70 61 67 65 20 61 6e 64 20 61 20 63 65 ee page and a ce
8470: 6c 6c 20 69 6e 64 65 78 20 28 30 20 6d 65 61 6e ll index (0 mean
8480: 73 20 74 68 65 20 66 69 72 73 74 20 63 65 6c 6c s the first cell
8490: 20 6f 6e 0a 2a 2a 20 74 68 65 20 70 61 67 65 2c on.** the page,
84a0: 20 31 20 6d 65 61 6e 73 20 74 68 65 20 73 65 63 1 means the sec
84b0: 6f 6e 64 20 63 65 6c 6c 2c 20 61 6e 64 20 73 6f ond cell, and so
84c0: 20 66 6f 72 74 68 29 20 72 65 74 75 72 6e 20 61 forth) return a
84d0: 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 pointer.** to t
84e0: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e he cell content.
84f0: 0a 2a 2a 0a 2a 2a 20 66 69 6e 64 43 65 6c 6c 50 .**.** findCellP
8500: 61 73 74 50 74 72 28 29 20 64 6f 65 73 20 74 68 astPtr() does th
8510: 65 20 73 61 6d 65 20 65 78 63 65 70 74 20 69 74 e same except it
8520: 20 73 6b 69 70 73 20 70 61 73 74 20 74 68 65 20 skips past the
8530: 69 6e 69 74 69 61 6c 0a 2a 2a 20 34 2d 62 79 74 initial.** 4-byt
8540: 65 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 20 e child pointer
8550: 66 6f 75 6e 64 20 6f 6e 20 69 6e 74 65 72 69 6f found on interio
8560: 72 20 70 61 67 65 73 2c 20 69 66 20 74 68 65 72 r pages, if ther
8570: 65 20 69 73 20 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 e is one..**.**
8580: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 6f 72 This routine wor
8590: 6b 73 20 6f 6e 6c 79 20 66 6f 72 20 70 61 67 65 ks only for page
85a0: 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 63 6f s that do not co
85b0: 6e 74 61 69 6e 20 6f 76 65 72 66 6c 6f 77 20 63 ntain overflow c
85c0: 65 6c 6c 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ells..*/.#define
85d0: 20 66 69 6e 64 43 65 6c 6c 28 50 2c 49 29 20 5c findCell(P,I) \
85e0: 0a 20 20 28 28 50 29 2d 3e 61 44 61 74 61 20 2b . ((P)->aData +
85f0: 20 28 28 50 29 2d 3e 6d 61 73 6b 50 61 67 65 20 ((P)->maskPage
8600: 26 20 67 65 74 32 62 79 74 65 41 6c 69 67 6e 65 & get2byteAligne
8610: 64 28 26 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 d(&(P)->aCellIdx
8620: 5b 32 2a 28 49 29 5d 29 29 29 0a 23 64 65 66 69 [2*(I)]))).#defi
8630: 6e 65 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 50 ne findCellPastP
8640: 74 72 28 50 2c 49 29 20 5c 0a 20 20 28 28 50 29 tr(P,I) \. ((P)
8650: 2d 3e 61 44 61 74 61 4f 66 73 74 20 2b 20 28 28 ->aDataOfst + ((
8660: 50 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 20 67 P)->maskPage & g
8670: 65 74 32 62 79 74 65 41 6c 69 67 6e 65 64 28 26 et2byteAligned(&
8680: 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a (P)->aCellIdx[2*
8690: 28 49 29 5d 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 (I)]))).../*.**
86a0: 54 68 69 73 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 This is common t
86b0: 61 69 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 66 ail processing f
86c0: 6f 72 20 62 74 72 65 65 50 61 72 73 65 43 65 6c or btreeParseCel
86d0: 6c 50 74 72 28 29 20 61 6e 64 0a 2a 2a 20 62 74 lPtr() and.** bt
86e0: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 49 reeParseCellPtrI
86f0: 6e 64 65 78 28 29 20 66 6f 72 20 74 68 65 20 63 ndex() for the c
8700: 61 73 65 20 77 68 65 6e 20 74 68 65 20 63 65 6c ase when the cel
8710: 6c 20 64 6f 65 73 20 6e 6f 74 20 66 69 74 20 65 l does not fit e
8720: 6e 74 69 72 65 6c 79 0a 2a 2a 20 6f 6e 20 61 20 ntirely.** on a
8730: 73 69 6e 67 6c 65 20 42 2d 74 72 65 65 20 70 61 single B-tree pa
8740: 67 65 2e 20 20 4d 61 6b 65 20 6e 65 63 65 73 73 ge. Make necess
8750: 61 72 79 20 61 64 6a 75 73 74 6d 65 6e 74 73 20 ary adjustments
8760: 74 6f 20 74 68 65 20 43 65 6c 6c 49 6e 66 6f 0a to the CellInfo.
8770: 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f ** structure..*/
8780: 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e .static SQLITE_N
8790: 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 20 62 74 72 OINLINE void btr
87a0: 65 65 50 61 72 73 65 43 65 6c 6c 41 64 6a 75 73 eeParseCellAdjus
87b0: 74 53 69 7a 65 46 6f 72 4f 76 65 72 66 6c 6f 77 tSizeForOverflow
87c0: 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
87d0: 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 ge, /* P
87e0: 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 age containing t
87f0: 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 he cell */. u8
8800: 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 *pCell,
8810: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
8820: 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 to the cell text
8830: 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 . */. CellInfo
8840: 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f *pInfo /
8850: 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 * Fill in this s
8860: 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 tructure */.){.
8870: 20 2f 2a 20 49 66 20 74 68 65 20 70 61 79 6c 6f /* If the paylo
8880: 61 64 20 77 69 6c 6c 20 6e 6f 74 20 66 69 74 20 ad will not fit
8890: 63 6f 6d 70 6c 65 74 65 6c 79 20 6f 6e 20 74 68 completely on th
88a0: 65 20 6c 6f 63 61 6c 20 70 61 67 65 2c 20 77 65 e local page, we
88b0: 20 68 61 76 65 0a 20 20 2a 2a 20 74 6f 20 64 65 have. ** to de
88c0: 63 69 64 65 20 68 6f 77 20 6d 75 63 68 20 74 6f cide how much to
88d0: 20 73 74 6f 72 65 20 6c 6f 63 61 6c 6c 79 20 61 store locally a
88e0: 6e 64 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 nd how much to s
88f0: 70 69 6c 6c 20 6f 6e 74 6f 0a 20 20 2a 2a 20 6f pill onto. ** o
8900: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 verflow pages.
8910: 54 68 65 20 73 74 72 61 74 65 67 79 20 69 73 20 The strategy is
8920: 74 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 20 to minimize the
8930: 61 6d 6f 75 6e 74 20 6f 66 20 75 6e 75 73 65 64 amount of unused
8940: 0a 20 20 2a 2a 20 73 70 61 63 65 20 6f 6e 20 6f . ** space on o
8950: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 77 68 verflow pages wh
8960: 69 6c 65 20 6b 65 65 70 69 6e 67 20 74 68 65 20 ile keeping the
8970: 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 63 61 6c 20 amount of local
8980: 73 74 6f 72 61 67 65 0a 20 20 2a 2a 20 69 6e 20 storage. ** in
8990: 62 65 74 77 65 65 6e 20 6d 69 6e 4c 6f 63 61 6c between minLocal
89a0: 20 61 6e 64 20 6d 61 78 4c 6f 63 61 6c 2e 0a 20 and maxLocal..
89b0: 20 2a 2a 0a 20 20 2a 2a 20 57 61 72 6e 69 6e 67 **. ** Warning
89c0: 3a 20 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 : changing the
89d0: 77 61 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 79 way overflow pay
89e0: 6c 6f 61 64 20 69 73 20 64 69 73 74 72 69 62 75 load is distribu
89f0: 74 65 64 20 69 6e 20 61 6e 79 0a 20 20 2a 2a 20 ted in any. **
8a00: 77 61 79 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 way will result
8a10: 69 6e 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 in an incompatib
8a20: 6c 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 0a le file format..
8a30: 20 20 2a 2f 0a 20 20 69 6e 74 20 6d 69 6e 4c 6f */. int minLo
8a40: 63 61 6c 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d cal; /* Minimum
8a50: 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f amount of paylo
8a60: 61 64 20 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 ad held locally
8a70: 2a 2f 0a 20 20 69 6e 74 20 6d 61 78 4c 6f 63 61 */. int maxLoca
8a80: 6c 3b 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 l; /* Maximum a
8a90: 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 mount of payload
8aa0: 20 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f held locally */
8ab0: 0a 20 20 69 6e 74 20 73 75 72 70 6c 75 73 3b 20 . int surplus;
8ac0: 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 61 /* Overflow pa
8ad0: 79 6c 6f 61 64 20 61 76 61 69 6c 61 62 6c 65 20 yload available
8ae0: 66 6f 72 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 for local storag
8af0: 65 20 2a 2f 0a 0a 20 20 6d 69 6e 4c 6f 63 61 6c e */.. minLocal
8b00: 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 = pPage->minLoc
8b10: 61 6c 3b 0a 20 20 6d 61 78 4c 6f 63 61 6c 20 3d al;. maxLocal =
8b20: 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c pPage->maxLocal
8b30: 3b 0a 20 20 73 75 72 70 6c 75 73 20 3d 20 6d 69 ;. surplus = mi
8b40: 6e 4c 6f 63 61 6c 20 2b 20 28 70 49 6e 66 6f 2d nLocal + (pInfo-
8b50: 3e 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c >nPayload - minL
8b60: 6f 63 61 6c 29 25 28 70 50 61 67 65 2d 3e 70 42 ocal)%(pPage->pB
8b70: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 29 t->usableSize-4)
8b80: 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 75 ;. testcase( su
8b90: 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 20 rplus==maxLocal
8ba0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 );. testcase( s
8bb0: 75 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c urplus==maxLocal
8bc0: 2b 31 20 29 3b 0a 20 20 69 66 28 20 73 75 72 70 +1 );. if( surp
8bd0: 6c 75 73 20 3c 3d 20 6d 61 78 4c 6f 63 61 6c 20 lus <= maxLocal
8be0: 29 7b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c ){. pInfo->nL
8bf0: 6f 63 61 6c 20 3d 20 28 75 31 36 29 73 75 72 70 ocal = (u16)surp
8c00: 6c 75 73 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 lus;. }else{.
8c10: 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 pInfo->nLocal
8c20: 3d 20 28 75 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b = (u16)minLocal;
8c30: 0a 20 20 7d 0a 20 20 70 49 6e 66 6f 2d 3e 6e 53 . }. pInfo->nS
8c40: 69 7a 65 20 3d 20 28 75 31 36 29 28 26 70 49 6e ize = (u16)(&pIn
8c50: 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 5b 70 49 6e fo->pPayload[pIn
8c60: 66 6f 2d 3e 6e 4c 6f 63 61 6c 5d 20 2d 20 70 43 fo->nLocal] - pC
8c70: 65 6c 6c 29 20 2b 20 34 3b 0a 7d 0a 0a 2f 2a 0a ell) + 4;.}../*.
8c80: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
8c90: 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 69 6d routines are im
8ca0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 66 plementations of
8cb0: 20 74 68 65 20 4d 65 6d 50 61 67 65 2e 78 50 61 the MemPage.xPa
8cc0: 72 73 65 43 65 6c 6c 28 29 0a 2a 2a 20 6d 65 74 rseCell().** met
8cd0: 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 73 65 hod..**.** Parse
8ce0: 20 61 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 a cell content
8cf0: 62 6c 6f 63 6b 20 61 6e 64 20 66 69 6c 6c 20 69 block and fill i
8d00: 6e 20 74 68 65 20 43 65 6c 6c 49 6e 66 6f 20 73 n the CellInfo s
8d10: 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 tructure..**.**
8d20: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 btreeParseCellPt
8d30: 72 28 29 20 20 20 20 20 20 20 20 3d 3e 20 20 20 r() =>
8d40: 74 61 62 6c 65 20 62 74 72 65 65 20 6c 65 61 66 table btree leaf
8d50: 20 6e 6f 64 65 73 0a 2a 2a 20 62 74 72 65 65 50 nodes.** btreeP
8d60: 61 72 73 65 43 65 6c 6c 4e 6f 50 61 79 6c 6f 61 arseCellNoPayloa
8d70: 64 28 29 20 20 3d 3e 20 20 20 74 61 62 6c 65 20 d() => table
8d80: 62 74 72 65 65 20 69 6e 74 65 72 6e 61 6c 20 6e btree internal n
8d90: 6f 64 65 73 0a 2a 2a 20 62 74 72 65 65 50 61 72 odes.** btreePar
8da0: 73 65 43 65 6c 6c 50 74 72 49 6e 64 65 78 28 29 seCellPtrIndex()
8db0: 20 20 20 3d 3e 20 20 20 69 6e 64 65 78 20 62 74 => index bt
8dc0: 72 65 65 20 6e 6f 64 65 73 0a 2a 2a 0a 2a 2a 20 ree nodes.**.**
8dd0: 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 61 20 There is also a
8de0: 77 72 61 70 70 65 72 20 66 75 6e 63 74 69 6f 6e wrapper function
8df0: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 btreeParseCell(
8e00: 29 20 74 68 61 74 20 77 6f 72 6b 73 20 66 6f 72 ) that works for
8e10: 0a 2a 2a 20 61 6c 6c 20 4d 65 6d 50 61 67 65 20 .** all MemPage
8e20: 74 79 70 65 73 20 61 6e 64 20 74 68 61 74 20 72 types and that r
8e30: 65 66 65 72 65 6e 63 65 73 20 74 68 65 20 63 65 eferences the ce
8e40: 6c 6c 20 62 79 20 69 6e 64 65 78 20 72 61 74 68 ll by index rath
8e50: 65 72 20 74 68 61 6e 0a 2a 2a 20 62 79 20 70 6f er than.** by po
8e60: 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 inter..*/.static
8e70: 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 void btreeParse
8e80: 43 65 6c 6c 50 74 72 4e 6f 50 61 79 6c 6f 61 64 CellPtrNoPayload
8e90: 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
8ea0: 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 ge, /* P
8eb0: 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 age containing t
8ec0: 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 he cell */. u8
8ed0: 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 *pCell,
8ee0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
8ef0: 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 to the cell text
8f00: 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 . */. CellInfo
8f10: 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f *pInfo /
8f20: 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 * Fill in this s
8f30: 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 tructure */.){.
8f40: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
8f50: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
8f60: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
8f70: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
8f80: 65 2d 3e 6c 65 61 66 3d 3d 30 20 29 3b 0a 20 20 e->leaf==0 );.
8f90: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 assert( pPage->c
8fa0: 68 69 6c 64 50 74 72 53 69 7a 65 3d 3d 34 20 29 hildPtrSize==4 )
8fb0: 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
8fc0: 5f 44 45 42 55 47 0a 20 20 55 4e 55 53 45 44 5f _DEBUG. UNUSED_
8fd0: 50 41 52 41 4d 45 54 45 52 28 70 50 61 67 65 29 PARAMETER(pPage)
8fe0: 3b 0a 23 65 6e 64 69 66 0a 20 20 70 49 6e 66 6f ;.#endif. pInfo
8ff0: 2d 3e 6e 53 69 7a 65 20 3d 20 34 20 2b 20 67 65 ->nSize = 4 + ge
9000: 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 34 tVarint(&pCell[4
9010: 5d 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d ], (u64*)&pInfo-
9020: 3e 6e 4b 65 79 29 3b 0a 20 20 70 49 6e 66 6f 2d >nKey);. pInfo-
9030: 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 >nPayload = 0;.
9040: 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d pInfo->nLocal =
9050: 20 30 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 0;. pInfo->pPa
9060: 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 72 65 74 yload = 0;. ret
9070: 75 72 6e 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f urn;.}.static vo
9080: 69 64 20 62 74 72 65 65 50 61 72 73 65 43 65 6c id btreeParseCel
9090: 6c 50 74 72 28 0a 20 20 4d 65 6d 50 61 67 65 20 lPtr(. MemPage
90a0: 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 *pPage,
90b0: 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 /* Page containi
90c0: 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 ng the cell */.
90d0: 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 u8 *pCell,
90e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
90f0: 74 65 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 ter to the cell
9100: 74 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 text. */. CellI
9110: 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 nfo *pInfo
9120: 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 /* Fill in th
9130: 69 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a is structure */.
9140: 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 3b 20 ){. u8 *pIter;
9150: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
9160: 46 6f 72 20 73 63 61 6e 6e 69 6e 67 20 74 68 72 For scanning thr
9170: 6f 75 67 68 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 ough pCell */.
9180: 75 33 32 20 6e 50 61 79 6c 6f 61 64 3b 20 20 20 u32 nPayload;
9190: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
91a0: 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 63 65 r of bytes of ce
91b0: 6c 6c 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 ll payload */.
91c0: 75 36 34 20 69 4b 65 79 3b 20 20 20 20 20 20 20 u64 iKey;
91d0: 20 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 /* Extra
91e0: 63 74 65 64 20 4b 65 79 20 76 61 6c 75 65 20 2a cted Key value *
91f0: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c /.. assert( sql
9200: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
9210: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
9220: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
9230: 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 20 7c pPage->leaf==0 |
9240: 7c 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 31 | pPage->leaf==1
9250: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
9260: 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 age->intKeyLeaf
9270: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
9280: 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 ge->childPtrSize
9290: 3d 3d 30 20 29 3b 0a 20 20 70 49 74 65 72 20 3d ==0 );. pIter =
92a0: 20 70 43 65 6c 6c 3b 0a 0a 20 20 2f 2a 20 54 68 pCell;.. /* Th
92b0: 65 20 6e 65 78 74 20 62 6c 6f 63 6b 20 6f 66 20 e next block of
92c0: 63 6f 64 65 20 69 73 20 65 71 75 69 76 61 6c 65 code is equivale
92d0: 6e 74 20 74 6f 3a 0a 20 20 2a 2a 0a 20 20 2a 2a nt to:. **. **
92e0: 20 20 20 20 20 70 49 74 65 72 20 2b 3d 20 67 65 pIter += ge
92f0: 74 56 61 72 69 6e 74 33 32 28 70 49 74 65 72 2c tVarint32(pIter,
9300: 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 2a 2a nPayload);. **
9310: 0a 20 20 2a 2a 20 54 68 65 20 63 6f 64 65 20 69 . ** The code i
9320: 73 20 69 6e 6c 69 6e 65 64 20 74 6f 20 61 76 6f s inlined to avo
9330: 69 64 20 61 20 66 75 6e 63 74 69 6f 6e 20 63 61 id a function ca
9340: 6c 6c 2e 0a 20 20 2a 2f 0a 20 20 6e 50 61 79 6c ll.. */. nPayl
9350: 6f 61 64 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 oad = *pIter;.
9360: 69 66 28 20 6e 50 61 79 6c 6f 61 64 3e 3d 30 78 if( nPayload>=0x
9370: 38 30 20 29 7b 0a 20 20 20 20 75 38 20 2a 70 45 80 ){. u8 *pE
9380: 6e 64 20 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a nd = &pIter[8];.
9390: 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 26 3d 20 nPayload &=
93a0: 30 78 37 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 0x7f;. do{.
93b0: 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 nPayload = (
93c0: 6e 50 61 79 6c 6f 61 64 3c 3c 37 29 20 7c 20 28 nPayload<<7) | (
93d0: 2a 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 *++pIter & 0x7f)
93e0: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 28 2a ;. }while( (*
93f0: 70 49 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 pIter)>=0x80 &&
9400: 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 pIter<pEnd );.
9410: 7d 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 0a 20 20 }. pIter++;..
9420: 2f 2a 20 54 68 65 20 6e 65 78 74 20 62 6c 6f 63 /* The next bloc
9430: 6b 20 6f 66 20 63 6f 64 65 20 69 73 20 65 71 75 k of code is equ
9440: 69 76 61 6c 65 6e 74 20 74 6f 3a 0a 20 20 2a 2a ivalent to:. **
9450: 0a 20 20 2a 2a 20 20 20 20 20 70 49 74 65 72 20 . ** pIter
9460: 2b 3d 20 67 65 74 56 61 72 69 6e 74 28 70 49 74 += getVarint(pIt
9470: 65 72 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f er, (u64*)&pInfo
9480: 2d 3e 6e 4b 65 79 29 3b 0a 20 20 2a 2a 0a 20 20 ->nKey);. **.
9490: 2a 2a 20 54 68 65 20 63 6f 64 65 20 69 73 20 69 ** The code is i
94a0: 6e 6c 69 6e 65 64 20 74 6f 20 61 76 6f 69 64 20 nlined to avoid
94b0: 61 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 2e a function call.
94c0: 0a 20 20 2a 2f 0a 20 20 69 4b 65 79 20 3d 20 2a . */. iKey = *
94d0: 70 49 74 65 72 3b 0a 20 20 69 66 28 20 69 4b 65 pIter;. if( iKe
94e0: 79 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 75 y>=0x80 ){. u
94f0: 38 20 2a 70 45 6e 64 20 3d 20 26 70 49 74 65 72 8 *pEnd = &pIter
9500: 5b 37 5d 3b 0a 20 20 20 20 69 4b 65 79 20 26 3d [7];. iKey &=
9510: 20 30 78 37 66 3b 0a 20 20 20 20 77 68 69 6c 65 0x7f;. while
9520: 28 31 29 7b 0a 20 20 20 20 20 20 69 4b 65 79 20 (1){. iKey
9530: 3d 20 28 69 4b 65 79 3c 3c 37 29 20 7c 20 28 2a = (iKey<<7) | (*
9540: 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b ++pIter & 0x7f);
9550: 0a 20 20 20 20 20 20 69 66 28 20 28 2a 70 49 74 . if( (*pIt
9560: 65 72 29 3c 30 78 38 30 20 29 20 62 72 65 61 6b er)<0x80 ) break
9570: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 49 74 65 ;. if( pIte
9580: 72 3e 3d 70 45 6e 64 20 29 7b 0a 20 20 20 20 20 r>=pEnd ){.
9590: 20 20 20 69 4b 65 79 20 3d 20 28 69 4b 65 79 3c iKey = (iKey<
95a0: 3c 38 29 20 7c 20 2a 2b 2b 70 49 74 65 72 3b 0a <8) | *++pIter;.
95b0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
95c0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
95d0: 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 0a 20 20 70 . pIter++;.. p
95e0: 49 6e 66 6f 2d 3e 6e 4b 65 79 20 3d 20 2a 28 69 Info->nKey = *(i
95f0: 36 34 2a 29 26 69 4b 65 79 3b 0a 20 20 70 49 6e 64*)&iKey;. pIn
9600: 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 6e fo->nPayload = n
9610: 50 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 6f Payload;. pInfo
9620: 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 70 49 74 ->pPayload = pIt
9630: 65 72 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 er;. testcase(
9640: 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d nPayload==pPage-
9650: 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 >maxLocal );. t
9660: 65 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 estcase( nPayloa
9670: 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 d==pPage->maxLoc
9680: 61 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 50 al+1 );. if( nP
9690: 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d ayload<=pPage->m
96a0: 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 2f axLocal ){. /
96b0: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 28 65 * This is the (e
96c0: 61 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 asy) common case
96d0: 20 77 68 65 72 65 20 74 68 65 20 65 6e 74 69 72 where the entir
96e0: 65 20 70 61 79 6c 6f 61 64 20 66 69 74 73 0a 20 e payload fits.
96f0: 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 ** on the loc
9700: 61 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f 76 65 al page. No ove
9710: 72 66 6c 6f 77 20 69 73 20 72 65 71 75 69 72 65 rflow is require
9720: 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 49 d.. */. pI
9730: 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 6e 50 61 nfo->nSize = nPa
9740: 79 6c 6f 61 64 20 2b 20 28 75 31 36 29 28 70 49 yload + (u16)(pI
9750: 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 ter - pCell);.
9760: 20 20 69 66 28 20 70 49 6e 66 6f 2d 3e 6e 53 69 if( pInfo->nSi
9770: 7a 65 3c 34 20 29 20 70 49 6e 66 6f 2d 3e 6e 53 ze<4 ) pInfo->nS
9780: 69 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 49 6e ize = 4;. pIn
9790: 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 fo->nLocal = (u1
97a0: 36 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 7d 65 6)nPayload;. }e
97b0: 6c 73 65 7b 0a 20 20 20 20 62 74 72 65 65 50 61 lse{. btreePa
97c0: 72 73 65 43 65 6c 6c 41 64 6a 75 73 74 53 69 7a rseCellAdjustSiz
97d0: 65 46 6f 72 4f 76 65 72 66 6c 6f 77 28 70 50 61 eForOverflow(pPa
97e0: 67 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e 66 6f ge, pCell, pInfo
97f0: 29 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 );. }.}.static
9800: 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 void btreeParseC
9810: 65 6c 6c 50 74 72 49 6e 64 65 78 28 0a 20 20 4d ellPtrIndex(. M
9820: 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 emPage *pPage,
9830: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 /* Page c
9840: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 65 ontaining the ce
9850: 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c ll */. u8 *pCel
9860: 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
9870: 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 /* Pointer to th
9880: 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a e cell text. */.
9890: 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 CellInfo *pInf
98a0: 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c o /* Fil
98b0: 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 l in this struct
98c0: 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a ure */.){. u8 *
98d0: 70 49 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 pIter;
98e0: 20 20 20 20 2f 2a 20 46 6f 72 20 73 63 61 6e 6e /* For scann
98f0: 69 6e 67 20 74 68 72 6f 75 67 68 20 70 43 65 6c ing through pCel
9900: 6c 20 2a 2f 0a 20 20 75 33 32 20 6e 50 61 79 6c l */. u32 nPayl
9910: 6f 61 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f oad; /
9920: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 * Number of byte
9930: 73 20 6f 66 20 63 65 6c 6c 20 70 61 79 6c 6f 61 s of cell payloa
9940: 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 d */.. assert(
9950: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
9960: 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d ld(pPage->pBt->m
9970: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
9980: 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d t( pPage->leaf==
9990: 30 20 7c 7c 20 70 50 61 67 65 2d 3e 6c 65 61 66 0 || pPage->leaf
99a0: 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==1 );. assert(
99b0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 pPage->intKeyLe
99c0: 61 66 3d 3d 30 20 29 3b 0a 20 20 70 49 74 65 72 af==0 );. pIter
99d0: 20 3d 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 = pCell + pPage
99e0: 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a ->childPtrSize;.
99f0: 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 2a 70 49 nPayload = *pI
9a00: 74 65 72 3b 0a 20 20 69 66 28 20 6e 50 61 79 6c ter;. if( nPayl
9a10: 6f 61 64 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 oad>=0x80 ){.
9a20: 20 75 38 20 2a 70 45 6e 64 20 3d 20 26 70 49 74 u8 *pEnd = &pIt
9a30: 65 72 5b 38 5d 3b 0a 20 20 20 20 6e 50 61 79 6c er[8];. nPayl
9a40: 6f 61 64 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 oad &= 0x7f;.
9a50: 20 64 6f 7b 0a 20 20 20 20 20 20 6e 50 61 79 6c do{. nPayl
9a60: 6f 61 64 20 3d 20 28 6e 50 61 79 6c 6f 61 64 3c oad = (nPayload<
9a70: 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 <7) | (*++pIter
9a80: 26 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 & 0x7f);. }wh
9a90: 69 6c 65 28 20 2a 28 70 49 74 65 72 29 3e 3d 30 ile( *(pIter)>=0
9aa0: 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e x80 && pIter<pEn
9ab0: 64 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 d );. }. pIter
9ac0: 2b 2b 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 4b 65 ++;. pInfo->nKe
9ad0: 79 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 y = nPayload;.
9ae0: 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 pInfo->nPayload
9af0: 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 70 49 = nPayload;. pI
9b00: 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 nfo->pPayload =
9b10: 70 49 74 65 72 3b 0a 20 20 74 65 73 74 63 61 73 pIter;. testcas
9b20: 65 28 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 e( nPayload==pPa
9b30: 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a ge->maxLocal );.
9b40: 20 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 79 testcase( nPay
9b50: 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 load==pPage->max
9b60: 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 69 66 28 Local+1 );. if(
9b70: 20 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 nPayload<=pPage
9b80: 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 ->maxLocal ){.
9b90: 20 20 2f 2a 20 54 68 69 73 20 69 73 20 74 68 65 /* This is the
9ba0: 20 28 65 61 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 (easy) common c
9bb0: 61 73 65 20 77 68 65 72 65 20 74 68 65 20 65 6e ase where the en
9bc0: 74 69 72 65 20 70 61 79 6c 6f 61 64 20 66 69 74 tire payload fit
9bd0: 73 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 s. ** on the
9be0: 6c 6f 63 61 6c 20 70 61 67 65 2e 20 20 4e 6f 20 local page. No
9bf0: 6f 76 65 72 66 6c 6f 77 20 69 73 20 72 65 71 75 overflow is requ
9c00: 69 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ired.. */.
9c10: 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 pInfo->nSize =
9c20: 6e 50 61 79 6c 6f 61 64 20 2b 20 28 75 31 36 29 nPayload + (u16)
9c30: 28 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b (pIter - pCell);
9c40: 0a 20 20 20 20 69 66 28 20 70 49 6e 66 6f 2d 3e . if( pInfo->
9c50: 6e 53 69 7a 65 3c 34 20 29 20 70 49 6e 66 6f 2d nSize<4 ) pInfo-
9c60: 3e 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 20 20 20 >nSize = 4;.
9c70: 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 pInfo->nLocal =
9c80: 28 75 31 36 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 (u16)nPayload;.
9c90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 62 74 72 65 }else{. btre
9ca0: 65 50 61 72 73 65 43 65 6c 6c 41 64 6a 75 73 74 eParseCellAdjust
9cb0: 53 69 7a 65 46 6f 72 4f 76 65 72 66 6c 6f 77 28 SizeForOverflow(
9cc0: 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 49 pPage, pCell, pI
9cd0: 6e 66 6f 29 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 nfo);. }.}.stat
9ce0: 69 63 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 ic void btreePar
9cf0: 73 65 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 seCell(. MemPag
9d00: 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 e *pPage,
9d10: 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 /* Page contai
9d20: 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f ning the cell */
9d30: 0a 20 20 69 6e 74 20 69 43 65 6c 6c 2c 20 20 20 . int iCell,
9d40: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
9d50: 65 20 63 65 6c 6c 20 69 6e 64 65 78 2e 20 20 46 e cell index. F
9d60: 69 72 73 74 20 63 65 6c 6c 20 69 73 20 30 20 2a irst cell is 0 *
9d70: 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 /. CellInfo *pI
9d80: 6e 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 nfo /* F
9d90: 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 ill in this stru
9da0: 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 70 50 cture */.){. pP
9db0: 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 age->xParseCell(
9dc0: 70 50 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 pPage, findCell(
9dd0: 70 50 61 67 65 2c 20 69 43 65 6c 6c 29 2c 20 70 pPage, iCell), p
9de0: 49 6e 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Info);.}../*.**
9df0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f The following ro
9e00: 75 74 69 6e 65 73 20 61 72 65 20 69 6d 70 6c 65 utines are imple
9e10: 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 mentations of th
9e20: 65 20 4d 65 6d 50 61 67 65 2e 78 43 65 6c 6c 53 e MemPage.xCellS
9e30: 69 7a 65 0a 2a 2a 20 6d 65 74 68 6f 64 2e 0a 2a ize.** method..*
9e40: 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 *.** Compute the
9e50: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
9e60: 20 62 79 74 65 73 20 74 68 61 74 20 61 20 43 65 bytes that a Ce
9e70: 6c 6c 20 6e 65 65 64 73 20 69 6e 20 74 68 65 20 ll needs in the
9e80: 63 65 6c 6c 0a 2a 2a 20 64 61 74 61 20 61 72 65 cell.** data are
9e90: 61 20 6f 66 20 74 68 65 20 62 74 72 65 65 2d 70 a of the btree-p
9ea0: 61 67 65 2e 20 20 54 68 65 20 72 65 74 75 72 6e age. The return
9eb0: 20 6e 75 6d 62 65 72 20 69 6e 63 6c 75 64 65 73 number includes
9ec0: 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 74 the cell.** dat
9ed0: 61 20 68 65 61 64 65 72 20 61 6e 64 20 74 68 65 a header and the
9ee0: 20 6c 6f 63 61 6c 20 70 61 79 6c 6f 61 64 2c 20 local payload,
9ef0: 62 75 74 20 6e 6f 74 20 61 6e 79 20 6f 76 65 72 but not any over
9f00: 66 6c 6f 77 20 70 61 67 65 20 6f 72 0a 2a 2a 20 flow page or.**
9f10: 74 68 65 20 73 70 61 63 65 20 75 73 65 64 20 62 the space used b
9f20: 79 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 y the cell point
9f30: 65 72 2e 0a 2a 2a 0a 2a 2a 20 63 65 6c 6c 53 69 er..**.** cellSi
9f40: 7a 65 50 74 72 4e 6f 50 61 79 6c 6f 61 64 28 29 zePtrNoPayload()
9f50: 20 20 20 20 3d 3e 20 20 20 74 61 62 6c 65 20 69 => table i
9f60: 6e 74 65 72 6e 61 6c 20 6e 6f 64 65 73 0a 2a 2a nternal nodes.**
9f70: 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 29 20 20 cellSizePtr()
9f80: 20 20 20 20 20 20 20 20 20 20 20 3d 3e 20 20 20 =>
9f90: 61 6c 6c 20 69 6e 64 65 78 20 6e 6f 64 65 73 20 all index nodes
9fa0: 26 20 74 61 62 6c 65 20 6c 65 61 66 20 6e 6f 64 & table leaf nod
9fb0: 65 73 0a 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 es.*/.static u16
9fc0: 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 4d 65 6d cellSizePtr(Mem
9fd0: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 20 Page *pPage, u8
9fe0: 2a 70 43 65 6c 6c 29 7b 0a 20 20 75 38 20 2a 70 *pCell){. u8 *p
9ff0: 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b 20 70 Iter = pCell + p
a000: 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 Page->childPtrSi
a010: 7a 65 3b 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 ze; /* For loopi
a020: 6e 67 20 6f 76 65 72 20 62 79 74 65 73 20 6f 66 ng over bytes of
a030: 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a pCell */. u8 *
a040: 70 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 pEnd;
a050: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a060: 20 20 20 20 20 2f 2a 20 45 6e 64 20 6d 61 72 6b /* End mark
a070: 20 66 6f 72 20 61 20 76 61 72 69 6e 74 20 2a 2f for a varint */
a080: 0a 20 20 75 33 32 20 6e 53 69 7a 65 3b 20 20 20 . u32 nSize;
a090: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a0a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
a0b0: 69 7a 65 20 76 61 6c 75 65 20 74 6f 20 72 65 74 ize value to ret
a0c0: 75 72 6e 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 urn */..#ifdef S
a0d0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f 2a QLITE_DEBUG. /*
a0e0: 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 The value retur
a0f0: 6e 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 ned by this func
a100: 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c 77 61 tion should alwa
a110: 79 73 20 62 65 20 74 68 65 20 73 61 6d 65 20 61 ys be the same a
a120: 73 0a 20 20 2a 2a 20 74 68 65 20 28 43 65 6c 6c s. ** the (Cell
a130: 49 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 61 6c 75 Info.nSize) valu
a140: 65 20 66 6f 75 6e 64 20 62 79 20 64 6f 69 6e 67 e found by doing
a150: 20 61 20 66 75 6c 6c 20 70 61 72 73 65 20 6f 66 a full parse of
a160: 20 74 68 65 0a 20 20 2a 2a 20 63 65 6c 6c 2e 20 the. ** cell.
a170: 49 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 If SQLITE_DEBUG
a180: 69 73 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 61 is defined, an a
a190: 73 73 65 72 74 28 29 20 61 74 20 74 68 65 20 62 ssert() at the b
a1a0: 6f 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a 20 74 68 ottom of. ** th
a1b0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 76 65 72 69 is function veri
a1c0: 66 69 65 73 20 74 68 61 74 20 74 68 69 73 20 69 fies that this i
a1d0: 6e 76 61 72 69 61 6e 74 20 69 73 20 6e 6f 74 20 nvariant is not
a1e0: 76 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a 20 20 43 violated. */. C
a1f0: 65 6c 6c 49 6e 66 6f 20 64 65 62 75 67 69 6e 66 ellInfo debuginf
a200: 6f 3b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 72 o;. pPage->xPar
a210: 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 seCell(pPage, pC
a220: 65 6c 6c 2c 20 26 64 65 62 75 67 69 6e 66 6f 29 ell, &debuginfo)
a230: 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 6e 53 69 7a ;.#endif.. nSiz
a240: 65 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 66 e = *pIter;. if
a250: 28 20 6e 53 69 7a 65 3e 3d 30 78 38 30 20 29 7b ( nSize>=0x80 ){
a260: 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 74 . pEnd = &pIt
a270: 65 72 5b 38 5d 3b 0a 20 20 20 20 6e 53 69 7a 65 er[8];. nSize
a280: 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 64 6f &= 0x7f;. do
a290: 7b 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 {. nSize =
a2a0: 28 6e 53 69 7a 65 3c 3c 37 29 20 7c 20 28 2a 2b (nSize<<7) | (*+
a2b0: 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b 0a +pIter & 0x7f);.
a2c0: 20 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 49 }while( *(pI
a2d0: 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 49 ter)>=0x80 && pI
a2e0: 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a ter<pEnd );. }.
a2f0: 20 20 70 49 74 65 72 2b 2b 3b 0a 20 20 69 66 28 pIter++;. if(
a300: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 pPage->intKey )
a310: 7b 0a 20 20 20 20 2f 2a 20 70 49 74 65 72 20 6e {. /* pIter n
a320: 6f 77 20 70 6f 69 6e 74 73 20 61 74 20 74 68 65 ow points at the
a330: 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 20 64-bit integer
a340: 6b 65 79 20 76 61 6c 75 65 2c 20 61 20 76 61 72 key value, a var
a350: 69 61 62 6c 65 20 6c 65 6e 67 74 68 20 0a 20 20 iable length .
a360: 20 20 2a 2a 20 69 6e 74 65 67 65 72 2e 20 54 68 ** integer. Th
a370: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 e following bloc
a380: 6b 20 6d 6f 76 65 73 20 70 49 74 65 72 20 74 6f k moves pIter to
a390: 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 66 69 point at the fi
a3a0: 72 73 74 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 rst byte. **
a3b0: 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 past the end of
a3c0: 74 68 65 20 6b 65 79 20 76 61 6c 75 65 2e 20 2a the key value. *
a3d0: 2f 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 /. pEnd = &pI
a3e0: 74 65 72 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c ter[9];. whil
a3f0: 65 28 20 28 2a 70 49 74 65 72 2b 2b 29 26 30 78 e( (*pIter++)&0x
a400: 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 80 && pIter<pEnd
a410: 20 29 3b 0a 20 20 7d 0a 20 20 74 65 73 74 63 61 );. }. testca
a420: 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 se( nSize==pPage
a430: 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 ->maxLocal );.
a440: 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d testcase( nSize=
a450: 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
a460: 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 53 69 7a +1 );. if( nSiz
a470: 65 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 e<=pPage->maxLoc
a480: 61 6c 20 29 7b 0a 20 20 20 20 6e 53 69 7a 65 20 al ){. nSize
a490: 2b 3d 20 28 75 33 32 29 28 70 49 74 65 72 20 2d += (u32)(pIter -
a4a0: 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 pCell);. if(
a4b0: 20 6e 53 69 7a 65 3c 34 20 29 20 6e 53 69 7a 65 nSize<4 ) nSize
a4c0: 20 3d 20 34 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 4;. }else{.
a4d0: 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 20 int minLocal
a4e0: 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 = pPage->minLoca
a4f0: 6c 3b 0a 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d l;. nSize = m
a500: 69 6e 4c 6f 63 61 6c 20 2b 20 28 6e 53 69 7a 65 inLocal + (nSize
a510: 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 20 25 20 28 - minLocal) % (
a520: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
a530: 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 leSize - 4);.
a540: 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 testcase( nSize
a550: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
a560: 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 l );. testcas
a570: 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d e( nSize==pPage-
a580: 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 >maxLocal+1 );.
a590: 20 20 20 69 66 28 20 6e 53 69 7a 65 3e 70 50 61 if( nSize>pPa
a5a0: 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a ge->maxLocal ){.
a5b0: 20 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 nSize = mi
a5c0: 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 nLocal;. }.
a5d0: 20 20 6e 53 69 7a 65 20 2b 3d 20 34 20 2b 20 28 nSize += 4 + (
a5e0: 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 65 u16)(pIter - pCe
a5f0: 6c 6c 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 ll);. }. asser
a600: 74 28 20 6e 53 69 7a 65 3d 3d 64 65 62 75 67 69 t( nSize==debugi
a610: 6e 66 6f 2e 6e 53 69 7a 65 20 7c 7c 20 43 4f 52 nfo.nSize || COR
a620: 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 72 65 74 RUPT_DB );. ret
a630: 75 72 6e 20 28 75 31 36 29 6e 53 69 7a 65 3b 0a urn (u16)nSize;.
a640: 7d 0a 73 74 61 74 69 63 20 75 31 36 20 63 65 6c }.static u16 cel
a650: 6c 53 69 7a 65 50 74 72 4e 6f 50 61 79 6c 6f 61 lSizePtrNoPayloa
a660: 64 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 d(MemPage *pPage
a670: 2c 20 75 38 20 2a 70 43 65 6c 6c 29 7b 0a 20 20 , u8 *pCell){.
a680: 75 38 20 2a 70 49 74 65 72 20 3d 20 70 43 65 6c u8 *pIter = pCel
a690: 6c 20 2b 20 34 3b 20 2f 2a 20 46 6f 72 20 6c 6f l + 4; /* For lo
a6a0: 6f 70 69 6e 67 20 6f 76 65 72 20 62 79 74 65 73 oping over bytes
a6b0: 20 6f 66 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 of pCell */. u
a6c0: 38 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 20 20 8 *pEnd;
a6d0: 20 20 20 20 20 20 2f 2a 20 45 6e 64 20 6d 61 72 /* End mar
a6e0: 6b 20 66 6f 72 20 61 20 76 61 72 69 6e 74 20 2a k for a varint *
a6f0: 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 /..#ifdef SQLITE
a700: 5f 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 _DEBUG. /* The
a710: 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 value returned b
a720: 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 y this function
a730: 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 should always be
a740: 20 74 68 65 20 73 61 6d 65 20 61 73 0a 20 20 2a the same as. *
a750: 2a 20 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e * the (CellInfo.
a760: 6e 53 69 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 nSize) value fou
a770: 6e 64 20 62 79 20 64 6f 69 6e 67 20 61 20 66 75 nd by doing a fu
a780: 6c 6c 20 70 61 72 73 65 20 6f 66 20 74 68 65 0a ll parse of the.
a790: 20 20 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 ** cell. If SQ
a7a0: 4c 49 54 45 5f 44 45 42 55 47 20 69 73 20 64 65 LITE_DEBUG is de
a7b0: 66 69 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 fined, an assert
a7c0: 28 29 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d () at the bottom
a7d0: 20 6f 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 of. ** this fu
a7e0: 6e 63 74 69 6f 6e 20 76 65 72 69 66 69 65 73 20 nction verifies
a7f0: 74 68 61 74 20 74 68 69 73 20 69 6e 76 61 72 69 that this invari
a800: 61 6e 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 ant is not viola
a810: 74 65 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e ted. */. CellIn
a820: 66 6f 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 fo debuginfo;.
a830: 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c pPage->xParseCel
a840: 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 l(pPage, pCell,
a850: 26 64 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6c &debuginfo);.#el
a860: 73 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 se. UNUSED_PARA
a870: 4d 45 54 45 52 28 70 50 61 67 65 29 3b 0a 23 65 METER(pPage);.#e
a880: 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 ndif.. assert(
a890: 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
a8a0: 69 7a 65 3d 3d 34 20 29 3b 0a 20 20 70 45 6e 64 ize==4 );. pEnd
a8b0: 20 3d 20 70 49 74 65 72 20 2b 20 39 3b 0a 20 20 = pIter + 9;.
a8c0: 77 68 69 6c 65 28 20 28 2a 70 49 74 65 72 2b 2b while( (*pIter++
a8d0: 29 26 30 78 38 30 20 26 26 20 70 49 74 65 72 3c )&0x80 && pIter<
a8e0: 70 45 6e 64 20 29 3b 0a 20 20 61 73 73 65 72 74 pEnd );. assert
a8f0: 28 20 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 7a ( debuginfo.nSiz
a900: 65 3d 3d 28 75 31 36 29 28 70 49 74 65 72 20 2d e==(u16)(pIter -
a910: 20 70 43 65 6c 6c 29 20 7c 7c 20 43 4f 52 52 55 pCell) || CORRU
a920: 50 54 5f 44 42 20 29 3b 0a 20 20 72 65 74 75 72 PT_DB );. retur
a930: 6e 20 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 n (u16)(pIter -
a940: 70 43 65 6c 6c 29 3b 0a 7d 0a 0a 0a 23 69 66 64 pCell);.}...#ifd
a950: 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
a960: 2f 2a 20 54 68 69 73 20 76 61 72 69 61 74 69 6f /* This variatio
a970: 6e 20 6f 6e 20 63 65 6c 6c 53 69 7a 65 50 74 72 n on cellSizePtr
a980: 28 29 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 () is used insid
a990: 65 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 e of assert() st
a9a0: 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 atements.** only
a9b0: 2e 20 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 . */.static u16
a9c0: 63 65 6c 6c 53 69 7a 65 28 4d 65 6d 50 61 67 65 cellSize(MemPage
a9d0: 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 43 65 *pPage, int iCe
a9e0: 6c 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 50 ll){. return pP
a9f0: 61 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 age->xCellSize(p
aa00: 50 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 Page, findCell(p
aa10: 50 61 67 65 2c 20 69 43 65 6c 6c 29 29 3b 0a 7d Page, iCell));.}
aa20: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 .#endif..#ifndef
aa30: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
aa40: 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 49 66 OVACUUM./*.** If
aa50: 20 74 68 65 20 63 65 6c 6c 20 70 43 65 6c 6c 2c the cell pCell,
aa60: 20 70 61 72 74 20 6f 66 20 70 61 67 65 20 70 50 part of page pP
aa70: 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 age contains a p
aa80: 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 61 6e 20 ointer.** to an
aa90: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 69 overflow page, i
aaa0: 6e 73 65 72 74 20 61 6e 20 65 6e 74 72 79 20 69 nsert an entry i
aab0: 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d nto the pointer-
aac0: 6d 61 70 0a 2a 2a 20 66 6f 72 20 74 68 65 20 6f map.** for the o
aad0: 76 65 72 66 6c 6f 77 20 70 61 67 65 2e 0a 2a 2f verflow page..*/
aae0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 74 72 .static void ptr
aaf0: 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 28 4d 65 mapPutOvflPtr(Me
ab00: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 mPage *pPage, u8
ab10: 20 2a 70 43 65 6c 6c 2c 20 69 6e 74 20 2a 70 52 *pCell, int *pR
ab20: 43 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 69 C){. CellInfo i
ab30: 6e 66 6f 3b 0a 20 20 69 66 28 20 2a 70 52 43 20 nfo;. if( *pRC
ab40: 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 ) return;. asse
ab50: 72 74 28 20 70 43 65 6c 6c 21 3d 30 20 29 3b 0a rt( pCell!=0 );.
ab60: 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 pPage->xParseC
ab70: 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c ell(pPage, pCell
ab80: 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 69 66 28 20 , &info);. if(
ab90: 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 6e 66 6f info.nLocal<info
aba0: 2e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 .nPayload ){.
abb0: 20 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 Pgno ovfl = get
abc0: 34 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 4byte(&pCell[inf
abd0: 6f 2e 6e 53 69 7a 65 2d 34 5d 29 3b 0a 20 20 20 o.nSize-4]);.
abe0: 20 70 74 72 6d 61 70 50 75 74 28 70 50 61 67 65 ptrmapPut(pPage
abf0: 2d 3e 70 42 74 2c 20 6f 76 66 6c 2c 20 50 54 52 ->pBt, ovfl, PTR
ac00: 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 2c 20 70 MAP_OVERFLOW1, p
ac10: 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 70 52 43 29 Page->pgno, pRC)
ac20: 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a ;. }.}.#endif..
ac30: 0a 2f 2a 0a 2a 2a 20 44 65 66 72 61 67 6d 65 6e ./*.** Defragmen
ac40: 74 20 74 68 65 20 70 61 67 65 20 67 69 76 65 6e t the page given
ac50: 2e 20 20 41 6c 6c 20 43 65 6c 6c 73 20 61 72 65 . All Cells are
ac60: 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 0a 2a 2a moved to the.**
ac70: 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 end of the page
ac80: 20 61 6e 64 20 61 6c 6c 20 66 72 65 65 20 73 70 and all free sp
ac90: 61 63 65 20 69 73 20 63 6f 6c 6c 65 63 74 65 64 ace is collected
aca0: 20 69 6e 74 6f 20 6f 6e 65 0a 2a 2a 20 62 69 67 into one.** big
acb0: 20 46 72 65 65 42 6c 6b 20 74 68 61 74 20 6f 63 FreeBlk that oc
acc0: 63 75 72 73 20 69 6e 20 62 65 74 77 65 65 6e 20 curs in between
acd0: 74 68 65 20 68 65 61 64 65 72 20 61 6e 64 20 63 the header and c
ace0: 65 6c 6c 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 61 ell.** pointer a
acf0: 72 72 61 79 20 61 6e 64 20 74 68 65 20 63 65 6c rray and the cel
ad00: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 0a l content area..
ad10: 2a 2a 0a 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f **.** EVIDENCE-O
ad20: 46 3a 20 52 2d 34 34 35 38 32 2d 36 30 31 33 38 F: R-44582-60138
ad30: 20 53 51 4c 69 74 65 20 6d 61 79 20 66 72 6f 6d SQLite may from
ad40: 20 74 69 6d 65 20 74 6f 20 74 69 6d 65 20 72 65 time to time re
ad50: 6f 72 67 61 6e 69 7a 65 20 61 0a 2a 2a 20 62 2d organize a.** b-
ad60: 74 72 65 65 20 70 61 67 65 20 73 6f 20 74 68 61 tree page so tha
ad70: 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 66 t there are no f
ad80: 72 65 65 62 6c 6f 63 6b 73 20 6f 72 20 66 72 61 reeblocks or fra
ad90: 67 6d 65 6e 74 20 62 79 74 65 73 2c 20 61 6c 6c gment bytes, all
ada0: 0a 2a 2a 20 75 6e 75 73 65 64 20 62 79 74 65 73 .** unused bytes
adb0: 20 61 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 are contained i
adc0: 6e 20 74 68 65 20 75 6e 61 6c 6c 6f 63 61 74 65 n the unallocate
add0: 64 20 73 70 61 63 65 20 72 65 67 69 6f 6e 2c 20 d space region,
ade0: 61 6e 64 20 61 6c 6c 0a 2a 2a 20 63 65 6c 6c 73 and all.** cells
adf0: 20 61 72 65 20 70 61 63 6b 65 64 20 74 69 67 68 are packed tigh
ae00: 74 6c 79 20 61 74 20 74 68 65 20 65 6e 64 20 6f tly at the end o
ae10: 66 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 f the page..*/.s
ae20: 74 61 74 69 63 20 69 6e 74 20 64 65 66 72 61 67 tatic int defrag
ae30: 6d 65 6e 74 50 61 67 65 28 4d 65 6d 50 61 67 65 mentPage(MemPage
ae40: 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 *pPage){. int
ae50: 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
ae60: 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 /* Loop c
ae70: 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 ounter */. int
ae80: 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 pc;
ae90: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 /* Addres
aea0: 73 20 6f 66 20 74 68 65 20 69 2d 74 68 20 63 65 s of the i-th ce
aeb0: 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b ll */. int hdr;
aec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
aed0: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 /* Offset to
aee0: 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 20 the page header
aef0: 2a 2f 0a 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 */. int size;
af00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
af10: 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 63 65 6c /* Size of a cel
af20: 6c 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 62 6c l */. int usabl
af30: 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 eSize;
af40: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
af50: 73 61 62 6c 65 20 62 79 74 65 73 20 6f 6e 20 61 sable bytes on a
af60: 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 63 page */. int c
af70: 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 20 20 ellOffset;
af80: 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 /* Offset
af90: 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e to the cell poin
afa0: 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 69 ter array */. i
afb0: 6e 74 20 63 62 72 6b 3b 20 20 20 20 20 20 20 20 nt cbrk;
afc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 /* Off
afd0: 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 set to the cell
afe0: 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a content area */.
aff0: 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 int nCell;
b000: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b010: 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 Number of cells
b020: 6f 6e 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 on the page */.
b030: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
b040: 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 54 data; /* T
b050: 68 65 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a he page data */.
b060: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
b070: 2a 74 65 6d 70 3b 20 20 20 20 20 20 20 2f 2a 20 *temp; /*
b080: 54 65 6d 70 20 61 72 65 61 20 66 6f 72 20 63 65 Temp area for ce
b090: 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 ll content */.
b0a0: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 73 unsigned char *s
b0b0: 72 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 6f rc; /* So
b0c0: 75 72 63 65 20 6f 66 20 63 6f 6e 74 65 6e 74 20 urce of content
b0d0: 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c 46 69 */. int iCellFi
b0e0: 72 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 rst;
b0f0: 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f 77 61 62 /* First allowab
b100: 6c 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f le cell index */
b110: 0a 20 20 69 6e 74 20 69 43 65 6c 6c 4c 61 73 74 . int iCellLast
b120: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
b130: 20 4c 61 73 74 20 70 6f 73 73 69 62 6c 65 20 63 Last possible c
b140: 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 0a 0a 20 ell index */...
b150: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
b160: 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
b170: 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
b180: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
b190: 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a 20 age->pBt!=0 );.
b1a0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
b1b0: 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
b1c0: 3c 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 <= SQLITE_MAX_PA
b1d0: 47 45 5f 53 49 5a 45 20 29 3b 0a 20 20 61 73 73 GE_SIZE );. ass
b1e0: 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 ert( pPage->nOve
b1f0: 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 61 73 rflow==0 );. as
b200: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
b210: 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
b220: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
b230: 20 74 65 6d 70 20 3d 20 30 3b 0a 20 20 73 72 63 temp = 0;. src
b240: 20 3d 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d = data = pPage-
b250: 3e 61 44 61 74 61 3b 0a 20 20 68 64 72 20 3d 20 >aData;. hdr =
b260: 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
b270: 3b 0a 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d ;. cellOffset =
b280: 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
b290: 65 74 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 et;. nCell = pP
b2a0: 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 61 73 age->nCell;. as
b2b0: 73 65 72 74 28 20 6e 43 65 6c 6c 3d 3d 67 65 74 sert( nCell==get
b2c0: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
b2d0: 33 5d 29 20 29 3b 0a 20 20 75 73 61 62 6c 65 53 3]) );. usableS
b2e0: 69 7a 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 ize = pPage->pBt
b2f0: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 ->usableSize;.
b300: 63 62 72 6b 20 3d 20 75 73 61 62 6c 65 53 69 7a cbrk = usableSiz
b310: 65 3b 0a 20 20 69 43 65 6c 6c 46 69 72 73 74 20 e;. iCellFirst
b320: 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 = cellOffset + 2
b330: 2a 6e 43 65 6c 6c 3b 0a 20 20 69 43 65 6c 6c 4c *nCell;. iCellL
b340: 61 73 74 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 ast = usableSize
b350: 20 2d 20 34 3b 0a 20 20 66 6f 72 28 69 3d 30 3b - 4;. for(i=0;
b360: 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a i<nCell; i++){.
b370: 20 20 20 20 75 38 20 2a 70 41 64 64 72 3b 20 20 u8 *pAddr;
b380: 20 20 20 2f 2a 20 54 68 65 20 69 2d 74 68 20 63 /* The i-th c
b390: 65 6c 6c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 ell pointer */.
b3a0: 20 20 20 70 41 64 64 72 20 3d 20 26 64 61 74 61 pAddr = &data
b3b0: 5b 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 69 2a [cellOffset + i*
b3c0: 32 5d 3b 0a 20 20 20 20 70 63 20 3d 20 67 65 74 2];. pc = get
b3d0: 32 62 79 74 65 28 70 41 64 64 72 29 3b 0a 20 20 2byte(pAddr);.
b3e0: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
b3f0: 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
b400: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
b410: 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 20 iCellLast );.
b420: 20 2f 2a 20 54 68 65 73 65 20 63 6f 6e 64 69 74 /* These condit
b430: 69 6f 6e 73 20 68 61 76 65 20 61 6c 72 65 61 64 ions have alread
b440: 79 20 62 65 65 6e 20 76 65 72 69 66 69 65 64 20 y been verified
b450: 69 6e 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 in btreeInitPage
b460: 28 29 0a 20 20 20 20 2a 2a 20 69 66 20 50 52 41 (). ** if PRA
b470: 47 4d 41 20 63 65 6c 6c 5f 73 69 7a 65 5f 63 68 GMA cell_size_ch
b480: 65 63 6b 3d 4f 4e 2e 0a 20 20 20 20 2a 2f 0a 20 eck=ON.. */.
b490: 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 if( pc<iCellF
b4a0: 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c irst || pc>iCell
b4b0: 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 72 65 Last ){. re
b4c0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
b4d0: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a UPT_BKPT;. }.
b4e0: 20 20 20 20 61 73 73 65 72 74 28 20 70 63 3e 3d assert( pc>=
b4f0: 69 43 65 6c 6c 46 69 72 73 74 20 26 26 20 70 63 iCellFirst && pc
b500: 3c 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 <=iCellLast );.
b510: 20 20 20 73 69 7a 65 20 3d 20 70 50 61 67 65 2d size = pPage-
b520: 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 >xCellSize(pPage
b530: 2c 20 26 73 72 63 5b 70 63 5d 29 3b 0a 20 20 20 , &src[pc]);.
b540: 20 63 62 72 6b 20 2d 3d 20 73 69 7a 65 3b 0a 20 cbrk -= size;.
b550: 20 20 20 69 66 28 20 63 62 72 6b 3c 69 43 65 6c if( cbrk<iCel
b560: 6c 46 69 72 73 74 20 7c 7c 20 70 63 2b 73 69 7a lFirst || pc+siz
b570: 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a e>usableSize ){.
b580: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
b590: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
b5a0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
b5b0: 72 74 28 20 63 62 72 6b 2b 73 69 7a 65 3c 3d 75 rt( cbrk+size<=u
b5c0: 73 61 62 6c 65 53 69 7a 65 20 26 26 20 63 62 72 sableSize && cbr
b5d0: 6b 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b k>=iCellFirst );
b5e0: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 63 . testcase( c
b5f0: 62 72 6b 2b 73 69 7a 65 3d 3d 75 73 61 62 6c 65 brk+size==usable
b600: 53 69 7a 65 20 29 3b 0a 20 20 20 20 74 65 73 74 Size );. test
b610: 63 61 73 65 28 20 70 63 2b 73 69 7a 65 3d 3d 75 case( pc+size==u
b620: 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 sableSize );.
b630: 20 70 75 74 32 62 79 74 65 28 70 41 64 64 72 2c put2byte(pAddr,
b640: 20 63 62 72 6b 29 3b 0a 20 20 20 20 69 66 28 20 cbrk);. if(
b650: 74 65 6d 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 temp==0 ){.
b660: 20 69 6e 74 20 78 3b 0a 20 20 20 20 20 20 69 66 int x;. if
b670: 28 20 63 62 72 6b 3d 3d 70 63 20 29 20 63 6f 6e ( cbrk==pc ) con
b680: 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 74 65 6d tinue;. tem
b690: 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 p = sqlite3Pager
b6a0: 54 65 6d 70 53 70 61 63 65 28 70 50 61 67 65 2d TempSpace(pPage-
b6b0: 3e 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 >pBt->pPager);.
b6c0: 20 20 20 20 20 78 20 3d 20 67 65 74 32 62 79 74 x = get2byt
b6d0: 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b e(&data[hdr+5]);
b6e0: 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 74 . memcpy(&t
b6f0: 65 6d 70 5b 78 5d 2c 20 26 64 61 74 61 5b 78 5d emp[x], &data[x]
b700: 2c 20 28 63 62 72 6b 2b 73 69 7a 65 29 20 2d 20 , (cbrk+size) -
b710: 78 29 3b 0a 20 20 20 20 20 20 73 72 63 20 3d 20 x);. src =
b720: 74 65 6d 70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 temp;. }.
b730: 6d 65 6d 63 70 79 28 26 64 61 74 61 5b 63 62 72 memcpy(&data[cbr
b740: 6b 5d 2c 20 26 73 72 63 5b 70 63 5d 2c 20 73 69 k], &src[pc], si
b750: 7a 65 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 ze);. }. asser
b760: 74 28 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 t( cbrk>=iCellFi
b770: 72 73 74 20 29 3b 0a 20 20 70 75 74 32 62 79 74 rst );. put2byt
b780: 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 e(&data[hdr+5],
b790: 63 62 72 6b 29 3b 0a 20 20 64 61 74 61 5b 68 64 cbrk);. data[hd
b7a0: 72 2b 31 5d 20 3d 20 30 3b 0a 20 20 64 61 74 61 r+1] = 0;. data
b7b0: 5b 68 64 72 2b 32 5d 20 3d 20 30 3b 0a 20 20 64 [hdr+2] = 0;. d
b7c0: 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b 0a ata[hdr+7] = 0;.
b7d0: 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 69 memset(&data[i
b7e0: 43 65 6c 6c 46 69 72 73 74 5d 2c 20 30 2c 20 63 CellFirst], 0, c
b7f0: 62 72 6b 2d 69 43 65 6c 6c 46 69 72 73 74 29 3b brk-iCellFirst);
b800: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
b810: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
b820: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
b830: 65 29 20 29 3b 0a 20 20 69 66 28 20 63 62 72 6b e) );. if( cbrk
b840: 2d 69 43 65 6c 6c 46 69 72 73 74 21 3d 70 50 61 -iCellFirst!=pPa
b850: 67 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 ge->nFree ){.
b860: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
b870: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d ORRUPT_BKPT;. }
b880: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
b890: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 _OK;.}../*.** Se
b8a0: 61 72 63 68 20 74 68 65 20 66 72 65 65 2d 6c 69 arch the free-li
b8b0: 73 74 20 6f 6e 20 70 61 67 65 20 70 50 67 20 66 st on page pPg f
b8c0: 6f 72 20 73 70 61 63 65 20 74 6f 20 73 74 6f 72 or space to stor
b8d0: 65 20 61 20 63 65 6c 6c 20 6e 42 79 74 65 20 62 e a cell nByte b
b8e0: 79 74 65 73 20 69 6e 0a 2a 2a 20 73 69 7a 65 2e ytes in.** size.
b8f0: 20 49 66 20 6f 6e 65 20 63 61 6e 20 62 65 20 66 If one can be f
b900: 6f 75 6e 64 2c 20 72 65 74 75 72 6e 20 61 20 70 ound, return a p
b910: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 70 ointer to the sp
b920: 61 63 65 20 61 6e 64 20 72 65 6d 6f 76 65 20 69 ace and remove i
b930: 74 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 66 72 t.** from the fr
b940: 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 49 ee-list..**.** I
b950: 66 20 6e 6f 20 73 75 69 74 61 62 6c 65 20 73 70 f no suitable sp
b960: 61 63 65 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 ace can be found
b970: 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 on the free-lis
b980: 74 2c 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a t, return NULL..
b990: 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 **.** This funct
b9a0: 69 6f 6e 20 6d 61 79 20 64 65 74 65 63 74 20 63 ion may detect c
b9b0: 6f 72 72 75 70 74 69 6f 6e 20 77 69 74 68 69 6e orruption within
b9c0: 20 70 50 67 2e 20 20 49 66 20 63 6f 72 72 75 70 pPg. If corrup
b9d0: 74 69 6f 6e 20 69 73 0a 2a 2a 20 64 65 74 65 63 tion is.** detec
b9e0: 74 65 64 20 74 68 65 6e 20 2a 70 52 63 20 69 73 ted then *pRc is
b9f0: 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 43 set to SQLITE_C
ba00: 4f 52 52 55 50 54 20 61 6e 64 20 4e 55 4c 4c 20 ORRUPT and NULL
ba10: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a is returned..**.
ba20: 2a 2a 20 53 6c 6f 74 73 20 6f 6e 20 74 68 65 20 ** Slots on the
ba30: 66 72 65 65 20 6c 69 73 74 20 74 68 61 74 20 61 free list that a
ba40: 72 65 20 62 65 74 77 65 65 6e 20 31 20 61 6e 64 re between 1 and
ba50: 20 33 20 62 79 74 65 73 20 6c 61 72 67 65 72 20 3 bytes larger
ba60: 74 68 61 6e 20 6e 42 79 74 65 0a 2a 2a 20 77 69 than nByte.** wi
ba70: 6c 6c 20 62 65 20 69 67 6e 6f 72 65 64 20 69 66 ll be ignored if
ba80: 20 61 64 64 69 6e 67 20 74 68 65 20 65 78 74 72 adding the extr
ba90: 61 20 73 70 61 63 65 20 74 6f 20 74 68 65 20 66 a space to the f
baa0: 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 63 6f 75 ragmentation cou
bab0: 6e 74 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 65 nt.** causes the
bac0: 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 63 fragmentation c
bad0: 6f 75 6e 74 20 74 6f 20 65 78 63 65 65 64 20 36 ount to exceed 6
bae0: 30 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 38 20 0..*/.static u8
baf0: 2a 70 61 67 65 46 69 6e 64 53 6c 6f 74 28 4d 65 *pageFindSlot(Me
bb00: 6d 50 61 67 65 20 2a 70 50 67 2c 20 69 6e 74 20 mPage *pPg, int
bb10: 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 52 63 29 nByte, int *pRc)
bb20: 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 64 {. const int hd
bb30: 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 73 r = pPg->hdrOffs
bb40: 65 74 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 et;. u8 * const
bb50: 20 61 44 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 aData = pPg->aD
bb60: 61 74 61 3b 0a 20 20 69 6e 74 20 69 41 64 64 72 ata;. int iAddr
bb70: 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 6e = hdr + 1;. in
bb80: 74 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 t pc = get2byte(
bb90: 26 61 44 61 74 61 5b 69 41 64 64 72 5d 29 3b 0a &aData[iAddr]);.
bba0: 20 20 69 6e 74 20 78 3b 0a 20 20 69 6e 74 20 75 int x;. int u
bbb0: 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 67 2d sableSize = pPg-
bbc0: 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
bbd0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 63 3e ;.. assert( pc>
bbe0: 30 20 29 3b 0a 20 20 64 6f 7b 0a 20 20 20 20 69 0 );. do{. i
bbf0: 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 nt size;
bc00: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
bc10: 68 65 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a he free slot */.
bc20: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
bc30: 4f 46 3a 20 52 2d 30 36 38 36 36 2d 33 39 31 32 OF: R-06866-3912
bc40: 35 20 46 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 5 Freeblocks are
bc50: 20 61 6c 77 61 79 73 20 63 6f 6e 6e 65 63 74 65 always connecte
bc60: 64 20 69 6e 20 6f 72 64 65 72 20 6f 66 0a 20 20 d in order of.
bc70: 20 20 2a 2a 20 69 6e 63 72 65 61 73 69 6e 67 20 ** increasing
bc80: 6f 66 66 73 65 74 2e 20 2a 2f 0a 20 20 20 20 69 offset. */. i
bc90: 66 28 20 70 63 3e 75 73 61 62 6c 65 53 69 7a 65 f( pc>usableSize
bca0: 2d 34 20 7c 7c 20 70 63 3c 69 41 64 64 72 2b 34 -4 || pc<iAddr+4
bcb0: 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 63 20 3d ){. *pRc =
bcc0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
bcd0: 42 4b 50 54 3b 0a 20 20 20 20 20 20 72 65 74 75 BKPT;. retu
bce0: 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 rn 0;. }.
bcf0: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
bd00: 52 2d 32 32 37 31 30 2d 35 33 33 32 38 20 54 68 R-22710-53328 Th
bd10: 65 20 74 68 69 72 64 20 61 6e 64 20 66 6f 75 72 e third and four
bd20: 74 68 20 62 79 74 65 73 20 6f 66 20 65 61 63 68 th bytes of each
bd30: 0a 20 20 20 20 2a 2a 20 66 72 65 65 62 6c 6f 63 . ** freebloc
bd40: 6b 20 66 6f 72 6d 20 61 20 62 69 67 2d 65 6e 64 k form a big-end
bd50: 69 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 ian integer whic
bd60: 68 20 69 73 20 74 68 65 20 73 69 7a 65 20 6f 66 h is the size of
bd70: 20 74 68 65 20 66 72 65 65 62 6c 6f 63 6b 0a 20 the freeblock.
bd80: 20 20 20 2a 2a 20 69 6e 20 62 79 74 65 73 2c 20 ** in bytes,
bd90: 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 34 2d including the 4-
bda0: 62 79 74 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a byte header. */.
bdb0: 20 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 size = get2b
bdc0: 79 74 65 28 26 61 44 61 74 61 5b 70 63 2b 32 5d yte(&aData[pc+2]
bdd0: 29 3b 0a 20 20 20 20 69 66 28 20 28 78 20 3d 20 );. if( (x =
bde0: 73 69 7a 65 20 2d 20 6e 42 79 74 65 29 3e 3d 30 size - nByte)>=0
bdf0: 20 29 7b 0a 20 20 20 20 20 20 74 65 73 74 63 61 ){. testca
be00: 73 65 28 20 78 3d 3d 34 20 29 3b 0a 20 20 20 20 se( x==4 );.
be10: 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d 33 testcase( x==3
be20: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 63 );. if( pc
be30: 20 3c 20 70 50 67 2d 3e 63 65 6c 6c 4f 66 66 73 < pPg->cellOffs
be40: 65 74 2b 32 2a 70 50 67 2d 3e 6e 43 65 6c 6c 20 et+2*pPg->nCell
be50: 7c 7c 20 73 69 7a 65 2b 70 63 20 3e 20 75 73 61 || size+pc > usa
be60: 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 bleSize ){.
be70: 20 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 *pRc = SQLITE
be80: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
be90: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b return 0;
bea0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
beb0: 20 78 3c 34 20 29 7b 0a 20 20 20 20 20 20 20 20 x<4 ){.
bec0: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
bed0: 52 2d 31 31 34 39 38 2d 35 38 30 32 32 20 49 6e R-11498-58022 In
bee0: 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 62 a well-formed b
bef0: 2d 74 72 65 65 20 70 61 67 65 2c 20 74 68 65 20 -tree page, the
bf00: 74 6f 74 61 6c 0a 20 20 20 20 20 20 20 20 2a 2a total. **
bf10: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
bf20: 20 69 6e 20 66 72 61 67 6d 65 6e 74 73 20 6d 61 in fragments ma
bf30: 79 20 6e 6f 74 20 65 78 63 65 65 64 20 36 30 2e y not exceed 60.
bf40: 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 */. if(
bf50: 61 44 61 74 61 5b 68 64 72 2b 37 5d 3e 35 37 20 aData[hdr+7]>57
bf60: 29 20 72 65 74 75 72 6e 20 30 3b 0a 0a 20 20 20 ) return 0;..
bf70: 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 /* Remove t
bf80: 68 65 20 73 6c 6f 74 20 66 72 6f 6d 20 74 68 65 he slot from the
bf90: 20 66 72 65 65 2d 6c 69 73 74 2e 20 55 70 64 61 free-list. Upda
bfa0: 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 te the number of
bfb0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 72 61 67 . ** frag
bfc0: 6d 65 6e 74 65 64 20 62 79 74 65 73 20 77 69 74 mented bytes wit
bfd0: 68 69 6e 20 74 68 65 20 70 61 67 65 2e 20 2a 2f hin the page. */
bfe0: 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
bff0: 26 61 44 61 74 61 5b 69 41 64 64 72 5d 2c 20 26 &aData[iAddr], &
c000: 61 44 61 74 61 5b 70 63 5d 2c 20 32 29 3b 0a 20 aData[pc], 2);.
c010: 20 20 20 20 20 20 20 61 44 61 74 61 5b 68 64 72 aData[hdr
c020: 2b 37 5d 20 2b 3d 20 28 75 38 29 78 3b 0a 20 20 +7] += (u8)x;.
c030: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
c040: 20 20 20 2f 2a 20 54 68 65 20 73 6c 6f 74 20 72 /* The slot r
c050: 65 6d 61 69 6e 73 20 6f 6e 20 74 68 65 20 66 72 emains on the fr
c060: 65 65 2d 6c 69 73 74 2e 20 52 65 64 75 63 65 20 ee-list. Reduce
c070: 69 74 73 20 73 69 7a 65 20 74 6f 20 61 63 63 6f its size to acco
c080: 75 6e 74 0a 20 20 20 20 20 20 20 20 20 2a 2a 20 unt. **
c090: 66 6f 72 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 for the portion
c0a0: 75 73 65 64 20 62 79 20 74 68 65 20 6e 65 77 20 used by the new
c0b0: 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 2a 2f 0a 20 allocation. */.
c0c0: 20 20 20 20 20 20 20 70 75 74 32 62 79 74 65 28 put2byte(
c0d0: 26 61 44 61 74 61 5b 70 63 2b 32 5d 2c 20 78 29 &aData[pc+2], x)
c0e0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
c0f0: 72 65 74 75 72 6e 20 26 61 44 61 74 61 5b 70 63 return &aData[pc
c100: 20 2b 20 78 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 + x];. }.
c110: 20 69 41 64 64 72 20 3d 20 70 63 3b 0a 20 20 20 iAddr = pc;.
c120: 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 26 pc = get2byte(&
c130: 61 44 61 74 61 5b 70 63 5d 29 3b 0a 20 20 7d 77 aData[pc]);. }w
c140: 68 69 6c 65 28 20 70 63 20 29 3b 0a 0a 20 20 72 hile( pc );.. r
c150: 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn 0;.}../*.*
c160: 2a 20 41 6c 6c 6f 63 61 74 65 20 6e 42 79 74 65 * Allocate nByte
c170: 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 bytes of space
c180: 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20 from within the
c190: 42 2d 54 72 65 65 20 70 61 67 65 20 70 61 73 73 B-Tree page pass
c1a0: 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69 72 ed.** as the fir
c1b0: 73 74 20 61 72 67 75 6d 65 6e 74 2e 20 57 72 69 st argument. Wri
c1c0: 74 65 20 69 6e 74 6f 20 2a 70 49 64 78 20 74 68 te into *pIdx th
c1d0: 65 20 69 6e 64 65 78 20 69 6e 74 6f 20 70 50 61 e index into pPa
c1e0: 67 65 2d 3e 61 44 61 74 61 5b 5d 0a 2a 2a 20 6f ge->aData[].** o
c1f0: 66 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 f the first byte
c200: 20 6f 66 20 61 6c 6c 6f 63 61 74 65 64 20 73 70 of allocated sp
c210: 61 63 65 2e 20 52 65 74 75 72 6e 20 65 69 74 68 ace. Return eith
c220: 65 72 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 0a er SQLITE_OK or.
c230: 2a 2a 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ** an error code
c240: 20 28 75 73 75 61 6c 6c 79 20 53 51 4c 49 54 45 (usually SQLITE
c250: 5f 43 4f 52 52 55 50 54 29 2e 0a 2a 2a 0a 2a 2a _CORRUPT)..**.**
c260: 20 54 68 65 20 63 61 6c 6c 65 72 20 67 75 61 72 The caller guar
c270: 61 6e 74 65 65 73 20 74 68 61 74 20 74 68 65 72 antees that ther
c280: 65 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 e is sufficient
c290: 73 70 61 63 65 20 74 6f 20 6d 61 6b 65 20 74 68 space to make th
c2a0: 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e e.** allocation.
c2b0: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d This routine m
c2c0: 69 67 68 74 20 6e 65 65 64 20 74 6f 20 64 65 66 ight need to def
c2d0: 72 61 67 6d 65 6e 74 20 69 6e 20 6f 72 64 65 72 ragment in order
c2e0: 20 74 6f 20 62 72 69 6e 67 0a 2a 2a 20 61 6c 6c to bring.** all
c2f0: 20 74 68 65 20 73 70 61 63 65 20 74 6f 67 65 74 the space toget
c300: 68 65 72 2c 20 68 6f 77 65 76 65 72 2e 20 20 54 her, however. T
c310: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c his routine will
c320: 20 61 76 6f 69 64 20 75 73 69 6e 67 0a 2a 2a 20 avoid using.**
c330: 74 68 65 20 66 69 72 73 74 20 74 77 6f 20 62 79 the first two by
c340: 74 65 73 20 70 61 73 74 20 74 68 65 20 63 65 6c tes past the cel
c350: 6c 20 70 6f 69 6e 74 65 72 20 61 72 65 61 20 73 l pointer area s
c360: 69 6e 63 65 20 70 72 65 73 75 6d 61 62 6c 79 20 ince presumably
c370: 74 68 69 73 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 this.** allocati
c380: 6f 6e 20 69 73 20 62 65 69 6e 67 20 6d 61 64 65 on is being made
c390: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e 73 in order to ins
c3a0: 65 72 74 20 61 20 6e 65 77 20 63 65 6c 6c 2c 20 ert a new cell,
c3b0: 73 6f 20 77 65 20 77 69 6c 6c 0a 2a 2a 20 61 6c so we will.** al
c3c0: 73 6f 20 65 6e 64 20 75 70 20 6e 65 65 64 69 6e so end up needin
c3d0: 67 20 61 20 6e 65 77 20 63 65 6c 6c 20 70 6f 69 g a new cell poi
c3e0: 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 nter..*/.static
c3f0: 69 6e 74 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 int allocateSpac
c400: 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 e(MemPage *pPage
c410: 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 69 6e 74 , int nByte, int
c420: 20 2a 70 49 64 78 29 7b 0a 20 20 63 6f 6e 73 74 *pIdx){. const
c430: 20 69 6e 74 20 68 64 72 20 3d 20 70 50 61 67 65 int hdr = pPage
c440: 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 20 20 20 ->hdrOffset;
c450: 2f 2a 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f /* Local cache o
c460: 66 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 f pPage->hdrOffs
c470: 65 74 20 2a 2f 0a 20 20 75 38 20 2a 20 63 6f 6e et */. u8 * con
c480: 73 74 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d st data = pPage-
c490: 3e 61 44 61 74 61 3b 20 20 20 20 20 20 2f 2a 20 >aData; /*
c4a0: 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 Local cache of p
c4b0: 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 Page->aData */.
c4c0: 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 20 int top;
c4d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c4e0: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 /* First b
c4f0: 79 74 65 20 6f 66 20 63 65 6c 6c 20 63 6f 6e 74 yte of cell cont
c500: 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e ent area */. in
c510: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
c520: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
c530: 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 72 65 /* Integer re
c540: 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
c550: 6e 74 20 67 61 70 3b 20 20 20 20 20 20 20 20 2f nt gap; /
c560: 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 * First byte of
c570: 67 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c gap between cell
c580: 20 70 6f 69 6e 74 65 72 73 20 61 6e 64 20 63 65 pointers and ce
c590: 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 ll content */.
c5a0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
c5b0: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
c5c0: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
c5d0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
c5e0: 70 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 20 pPage->pBt );.
c5f0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
c600: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
c610: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
c620: 0a 20 20 61 73 73 65 72 74 28 20 6e 42 79 74 65 . assert( nByte
c630: 3e 3d 30 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d >=0 ); /* Minim
c640: 75 6d 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 um cell size is
c650: 34 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 4 */. assert( p
c660: 50 61 67 65 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 Page->nFree>=nBy
c670: 74 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 te );. assert(
c680: 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
c690: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
c6a0: 20 6e 42 79 74 65 20 3c 20 28 69 6e 74 29 28 70 nByte < (int)(p
c6b0: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
c6c0: 65 53 69 7a 65 2d 38 29 20 29 3b 0a 0a 20 20 61 eSize-8) );.. a
c6d0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 65 ssert( pPage->ce
c6e0: 6c 6c 4f 66 66 73 65 74 20 3d 3d 20 68 64 72 20 llOffset == hdr
c6f0: 2b 20 31 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e + 12 - 4*pPage->
c700: 6c 65 61 66 20 29 3b 0a 20 20 67 61 70 20 3d 20 leaf );. gap =
c710: 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 pPage->cellOffse
c720: 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e 43 65 t + 2*pPage->nCe
c730: 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 67 61 ll;. assert( ga
c740: 70 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 2f 2a p<=65536 );. /*
c750: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
c760: 32 39 33 35 36 2d 30 32 33 39 31 20 49 66 20 74 29356-02391 If t
c770: 68 65 20 64 61 74 61 62 61 73 65 20 75 73 65 73 he database uses
c780: 20 61 20 36 35 35 33 36 2d 62 79 74 65 20 70 61 a 65536-byte pa
c790: 67 65 20 73 69 7a 65 0a 20 20 2a 2a 20 61 6e 64 ge size. ** and
c7a0: 20 74 68 65 20 72 65 73 65 72 76 65 64 20 73 70 the reserved sp
c7b0: 61 63 65 20 69 73 20 7a 65 72 6f 20 28 74 68 65 ace is zero (the
c7c0: 20 75 73 75 61 6c 20 76 61 6c 75 65 20 66 6f 72 usual value for
c7d0: 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 29 reserved space)
c7e0: 0a 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 63 . ** then the c
c7f0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 6f 66 66 73 ell content offs
c800: 65 74 20 6f 66 20 61 6e 20 65 6d 70 74 79 20 70 et of an empty p
c810: 61 67 65 20 77 61 6e 74 73 20 74 6f 20 62 65 20 age wants to be
c820: 36 35 35 33 36 2e 0a 20 20 2a 2a 20 48 6f 77 65 65536.. ** Howe
c830: 76 65 72 2c 20 74 68 61 74 20 69 6e 74 65 67 65 ver, that intege
c840: 72 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 20 74 r is too large t
c850: 6f 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 61 o be stored in a
c860: 20 32 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 64 2-byte unsigned
c870: 0a 20 20 2a 2a 20 69 6e 74 65 67 65 72 2c 20 73 . ** integer, s
c880: 6f 20 61 20 76 61 6c 75 65 20 6f 66 20 30 20 69 o a value of 0 i
c890: 73 20 75 73 65 64 20 69 6e 20 69 74 73 20 70 6c s used in its pl
c8a0: 61 63 65 2e 20 2a 2f 0a 20 20 74 6f 70 20 3d 20 ace. */. top =
c8b0: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 get2byte(&data[h
c8c0: 64 72 2b 35 5d 29 3b 0a 20 20 61 73 73 65 72 74 dr+5]);. assert
c8d0: 28 20 74 6f 70 3c 3d 28 69 6e 74 29 70 50 61 67 ( top<=(int)pPag
c8e0: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
c8f0: 7a 65 20 29 3b 20 2f 2a 20 50 72 65 76 65 6e 74 ze ); /* Prevent
c900: 20 62 79 20 67 65 74 41 6e 64 49 6e 69 74 50 61 by getAndInitPa
c910: 67 65 28 29 20 2a 2f 0a 20 20 69 66 28 20 67 61 ge() */. if( ga
c920: 70 3e 74 6f 70 20 29 7b 0a 20 20 20 20 69 66 28 p>top ){. if(
c930: 20 74 6f 70 3d 3d 30 20 26 26 20 70 50 61 67 65 top==0 && pPage
c940: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
c950: 65 3d 3d 36 35 35 33 36 20 29 7b 0a 20 20 20 20 e==65536 ){.
c960: 20 20 74 6f 70 20 3d 20 36 35 35 33 36 3b 0a 20 top = 65536;.
c970: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
c980: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
c990: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
c9a0: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 }. }.. /* If t
c9b0: 68 65 72 65 20 69 73 20 65 6e 6f 75 67 68 20 73 here is enough s
c9c0: 70 61 63 65 20 62 65 74 77 65 65 6e 20 67 61 70 pace between gap
c9d0: 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 6f 6e 65 and top for one
c9e0: 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f 69 6e 74 more cell point
c9f0: 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 20 65 6e er. ** array en
ca00: 74 72 79 20 6f 66 66 73 65 74 2c 20 61 6e 64 20 try offset, and
ca10: 69 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 if the freelist
ca20: 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c 20 74 68 is not empty, th
ca30: 65 6e 20 73 65 61 72 63 68 20 74 68 65 0a 20 20 en search the.
ca40: 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c 6f 6f 6b ** freelist look
ca50: 69 6e 67 20 66 6f 72 20 61 20 66 72 65 65 20 73 ing for a free s
ca60: 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 68 20 74 lot big enough t
ca70: 6f 20 73 61 74 69 73 66 79 20 74 68 65 20 72 65 o satisfy the re
ca80: 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 20 74 65 quest.. */. te
ca90: 73 74 63 61 73 65 28 20 67 61 70 2b 32 3d 3d 74 stcase( gap+2==t
caa0: 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 op );. testcase
cab0: 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 29 3b 0a ( gap+1==top );.
cac0: 20 20 74 65 73 74 63 61 73 65 28 20 67 61 70 3d testcase( gap=
cad0: 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 28 64 =top );. if( (d
cae0: 61 74 61 5b 68 64 72 2b 32 5d 20 7c 7c 20 64 61 ata[hdr+2] || da
caf0: 74 61 5b 68 64 72 2b 31 5d 29 20 26 26 20 67 61 ta[hdr+1]) && ga
cb00: 70 2b 32 3c 3d 74 6f 70 20 29 7b 0a 20 20 20 20 p+2<=top ){.
cb10: 75 38 20 2a 70 53 70 61 63 65 20 3d 20 70 61 67 u8 *pSpace = pag
cb20: 65 46 69 6e 64 53 6c 6f 74 28 70 50 61 67 65 2c eFindSlot(pPage,
cb30: 20 6e 42 79 74 65 2c 20 26 72 63 29 3b 0a 20 20 nByte, &rc);.
cb40: 20 20 69 66 28 20 70 53 70 61 63 65 20 29 7b 0a if( pSpace ){.
cb50: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 53 assert( pS
cb60: 70 61 63 65 3e 3d 64 61 74 61 20 26 26 20 28 70 pace>=data && (p
cb70: 53 70 61 63 65 20 2d 20 64 61 74 61 29 3c 36 35 Space - data)<65
cb80: 35 33 36 20 29 3b 0a 20 20 20 20 20 20 2a 70 49 536 );. *pI
cb90: 64 78 20 3d 20 28 69 6e 74 29 28 70 53 70 61 63 dx = (int)(pSpac
cba0: 65 20 2d 20 64 61 74 61 29 3b 0a 20 20 20 20 20 e - data);.
cbb0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
cbc0: 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 K;. }else if(
cbd0: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 rc ){. ret
cbe0: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
cbf0: 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 72 65 71 75 }.. /* The requ
cc00: 65 73 74 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 est could not be
cc10: 20 66 75 6c 66 69 6c 6c 65 64 20 75 73 69 6e 67 fulfilled using
cc20: 20 61 20 66 72 65 65 6c 69 73 74 20 73 6c 6f 74 a freelist slot
cc30: 2e 20 20 43 68 65 63 6b 0a 20 20 2a 2a 20 74 6f . Check. ** to
cc40: 20 73 65 65 20 69 66 20 64 65 66 72 61 67 6d 65 see if defragme
cc50: 6e 74 61 74 69 6f 6e 20 69 73 20 6e 65 63 65 73 ntation is neces
cc60: 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 74 65 73 sary.. */. tes
cc70: 74 63 61 73 65 28 20 67 61 70 2b 32 2b 6e 42 79 tcase( gap+2+nBy
cc80: 74 65 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 te==top );. if(
cc90: 20 67 61 70 2b 32 2b 6e 42 79 74 65 3e 74 6f 70 gap+2+nByte>top
cca0: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
ccb0: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 7c pPage->nCell>0 |
ccc0: 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a | CORRUPT_DB );.
ccd0: 20 20 20 20 72 63 20 3d 20 64 65 66 72 61 67 6d rc = defragm
cce0: 65 6e 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a entPage(pPage);.
ccf0: 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
cd00: 75 72 6e 20 72 63 3b 0a 20 20 20 20 74 6f 70 20 urn rc;. top
cd10: 3d 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 = get2byteNotZer
cd20: 6f 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b o(&data[hdr+5]);
cd30: 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 61 70 . assert( gap
cd40: 2b 6e 42 79 74 65 3c 3d 74 6f 70 20 29 3b 0a 20 +nByte<=top );.
cd50: 20 7d 0a 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 }... /* Alloca
cd60: 74 65 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 74 te memory from t
cd70: 68 65 20 67 61 70 20 69 6e 20 62 65 74 77 65 65 he gap in betwee
cd80: 6e 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 n the cell point
cd90: 65 72 20 61 72 72 61 79 0a 20 20 2a 2a 20 61 6e er array. ** an
cda0: 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 d the cell conte
cdb0: 6e 74 20 61 72 65 61 2e 20 20 54 68 65 20 62 74 nt area. The bt
cdc0: 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 63 61 reeInitPage() ca
cdd0: 6c 6c 20 68 61 73 20 61 6c 72 65 61 64 79 0a 20 ll has already.
cde0: 20 2a 2a 20 76 61 6c 69 64 61 74 65 64 20 74 68 ** validated th
cdf0: 65 20 66 72 65 65 6c 69 73 74 2e 20 20 47 69 76 e freelist. Giv
ce00: 65 6e 20 74 68 61 74 20 74 68 65 20 66 72 65 65 en that the free
ce10: 6c 69 73 74 20 69 73 20 76 61 6c 69 64 2c 20 74 list is valid, t
ce20: 68 65 72 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 here. ** is no
ce30: 77 61 79 20 74 68 61 74 20 74 68 65 20 61 6c 6c way that the all
ce40: 6f 63 61 74 69 6f 6e 20 63 61 6e 20 65 78 74 65 ocation can exte
ce50: 6e 64 20 6f 66 66 20 74 68 65 20 65 6e 64 20 6f nd off the end o
ce60: 66 20 74 68 65 20 70 61 67 65 2e 0a 20 20 2a 2a f the page.. **
ce70: 20 54 68 65 20 61 73 73 65 72 74 28 29 20 62 65 The assert() be
ce80: 6c 6f 77 20 76 65 72 69 66 69 65 73 20 74 68 65 low verifies the
ce90: 20 70 72 65 76 69 6f 75 73 20 73 65 6e 74 65 6e previous senten
cea0: 63 65 2e 0a 20 20 2a 2f 0a 20 20 74 6f 70 20 2d ce.. */. top -
ceb0: 3d 20 6e 42 79 74 65 3b 0a 20 20 70 75 74 32 62 = nByte;. put2b
cec0: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d yte(&data[hdr+5]
ced0: 2c 20 74 6f 70 29 3b 0a 20 20 61 73 73 65 72 74 , top);. assert
cee0: 28 20 74 6f 70 2b 6e 42 79 74 65 20 3c 3d 20 28 ( top+nByte <= (
cef0: 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e int)pPage->pBt->
cf00: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
cf10: 2a 70 49 64 78 20 3d 20 74 6f 70 3b 0a 20 20 72 *pIdx = top;. r
cf20: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
cf30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
cf40: 20 61 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 a section of th
cf50: 65 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 74 e pPage->aData t
cf60: 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e 0a o the freelist..
cf70: 2a 2a 20 54 68 65 20 66 69 72 73 74 20 62 79 74 ** The first byt
cf80: 65 20 6f 66 20 74 68 65 20 6e 65 77 20 66 72 65 e of the new fre
cf90: 65 20 62 6c 6f 63 6b 20 69 73 20 70 50 61 67 65 e block is pPage
cfa0: 2d 3e 61 44 61 74 61 5b 69 53 74 61 72 74 5d 0a ->aData[iStart].
cfb0: 2a 2a 20 61 6e 64 20 74 68 65 20 73 69 7a 65 20 ** and the size
cfc0: 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 69 73 20 of the block is
cfd0: 69 53 69 7a 65 20 62 79 74 65 73 2e 0a 2a 2a 0a iSize bytes..**.
cfe0: 2a 2a 20 41 64 6a 61 63 65 6e 74 20 66 72 65 65 ** Adjacent free
cff0: 62 6c 6f 63 6b 73 20 61 72 65 20 63 6f 61 6c 65 blocks are coale
d000: 73 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 sced..**.** Note
d010: 20 74 68 61 74 20 65 76 65 6e 20 74 68 6f 75 67 that even thoug
d020: 68 20 74 68 65 20 66 72 65 65 62 6c 6f 63 6b 20 h the freeblock
d030: 6c 69 73 74 20 77 61 73 20 63 68 65 63 6b 65 64 list was checked
d040: 20 62 79 20 62 74 72 65 65 49 6e 69 74 50 61 67 by btreeInitPag
d050: 65 28 29 2c 0a 2a 2a 20 74 68 61 74 20 72 6f 75 e(),.** that rou
d060: 74 69 6e 65 20 77 69 6c 6c 20 6e 6f 74 20 64 65 tine will not de
d070: 74 65 63 74 20 6f 76 65 72 6c 61 70 20 62 65 74 tect overlap bet
d080: 77 65 65 6e 20 63 65 6c 6c 73 20 6f 72 20 66 72 ween cells or fr
d090: 65 65 62 6c 6f 63 6b 73 2e 20 20 4e 6f 72 0a 2a eeblocks. Nor.*
d0a0: 2a 20 64 6f 65 73 20 69 74 20 64 65 74 65 63 74 * does it detect
d0b0: 20 63 65 6c 6c 73 20 6f 72 20 66 72 65 65 62 6c cells or freebl
d0c0: 6f 63 6b 73 20 74 68 61 74 20 65 6e 63 72 6f 75 ocks that encrou
d0d0: 63 68 20 69 6e 74 6f 20 74 68 65 20 72 65 73 65 ch into the rese
d0e0: 72 76 65 64 20 62 79 74 65 73 0a 2a 2a 20 61 74 rved bytes.** at
d0f0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
d100: 70 61 67 65 2e 20 20 53 6f 20 64 6f 20 61 64 64 page. So do add
d110: 69 74 69 6f 6e 61 6c 20 63 6f 72 72 75 70 74 69 itional corrupti
d120: 6f 6e 20 63 68 65 63 6b 73 20 69 6e 73 69 64 65 on checks inside
d130: 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 this.** routine
d140: 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c 49 and return SQLI
d150: 54 45 5f 43 4f 52 52 55 50 54 20 69 66 20 61 6e TE_CORRUPT if an
d160: 79 20 70 72 6f 62 6c 65 6d 73 20 61 72 65 20 66 y problems are f
d170: 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ound..*/.static
d180: 69 6e 74 20 66 72 65 65 53 70 61 63 65 28 4d 65 int freeSpace(Me
d190: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 31 mPage *pPage, u1
d1a0: 36 20 69 53 74 61 72 74 2c 20 75 31 36 20 69 53 6 iStart, u16 iS
d1b0: 69 7a 65 29 7b 0a 20 20 75 31 36 20 69 50 74 72 ize){. u16 iPtr
d1c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
d1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
d1e0: 20 41 64 64 72 65 73 73 20 6f 66 20 70 74 72 20 Address of ptr
d1f0: 74 6f 20 6e 65 78 74 20 66 72 65 65 62 6c 6f 63 to next freebloc
d200: 6b 20 2a 2f 0a 20 20 75 31 36 20 69 46 72 65 65 k */. u16 iFree
d210: 42 6c 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 Blk;
d220: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
d230: 41 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e Address of the n
d240: 65 78 74 20 66 72 65 65 62 6c 6f 63 6b 20 2a 2f ext freeblock */
d250: 0a 20 20 75 38 20 68 64 72 3b 20 20 20 20 20 20 . u8 hdr;
d260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d270: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
d280: 20 68 65 61 64 65 72 20 73 69 7a 65 2e 20 20 30 header size. 0
d290: 20 6f 72 20 31 30 30 20 2a 2f 0a 20 20 75 38 20 or 100 */. u8
d2a0: 6e 46 72 61 67 20 3d 20 30 3b 20 20 20 20 20 20 nFrag = 0;
d2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d2c0: 20 20 20 2f 2a 20 52 65 64 75 63 74 69 6f 6e 20 /* Reduction
d2d0: 69 6e 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e in fragmentation
d2e0: 20 2a 2f 0a 20 20 75 31 36 20 69 4f 72 69 67 53 */. u16 iOrigS
d2f0: 69 7a 65 20 3d 20 69 53 69 7a 65 3b 20 20 20 20 ize = iSize;
d300: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
d310: 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 riginal value of
d320: 20 69 53 69 7a 65 20 2a 2f 0a 20 20 75 33 32 20 iSize */. u32
d330: 69 4c 61 73 74 20 3d 20 70 50 61 67 65 2d 3e 70 iLast = pPage->p
d340: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 Bt->usableSize-4
d350: 3b 20 2f 2a 20 4c 61 72 67 65 73 74 20 70 6f 73 ; /* Largest pos
d360: 73 69 62 6c 65 20 66 72 65 65 62 6c 6f 63 6b 20 sible freeblock
d370: 6f 66 66 73 65 74 20 2a 2f 0a 20 20 75 33 32 20 offset */. u32
d380: 69 45 6e 64 20 3d 20 69 53 74 61 72 74 20 2b 20 iEnd = iStart +
d390: 69 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 iSize;
d3a0: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
d3b0: 70 61 73 74 20 74 68 65 20 69 53 74 61 72 74 20 past the iStart
d3c0: 62 75 66 66 65 72 20 2a 2f 0a 20 20 75 6e 73 69 buffer */. unsi
d3d0: 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 20 gned char *data
d3e0: 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 = pPage->aData;
d3f0: 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 65 6e /* Page conten
d400: 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 t */.. assert(
d410: 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b pPage->pBt!=0 );
d420: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
d430: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
d440: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
d450: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
d460: 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 69 53 CORRUPT_DB || iS
d470: 74 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 72 tart>=pPage->hdr
d480: 4f 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d 3e Offset+6+pPage->
d490: 63 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b 0a childPtrSize );.
d4a0: 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 assert( CORRUP
d4b0: 54 5f 44 42 20 7c 7c 20 69 45 6e 64 20 3c 3d 20 T_DB || iEnd <=
d4c0: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
d4d0: 6c 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 leSize );. asse
d4e0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
d4f0: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
d500: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
d510: 73 73 65 72 74 28 20 69 53 69 7a 65 3e 3d 34 20 ssert( iSize>=4
d520: 29 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 ); /* Minimum
d530: 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a cell size is 4 *
d540: 2f 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 /. assert( iSta
d550: 72 74 3c 3d 69 4c 61 73 74 20 29 3b 0a 0a 20 20 rt<=iLast );..
d560: 2f 2a 20 4f 76 65 72 77 72 69 74 65 20 64 65 6c /* Overwrite del
d570: 65 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e eted information
d580: 20 77 69 74 68 20 7a 65 72 6f 73 20 77 68 65 6e with zeros when
d590: 20 74 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 the secure_dele
d5a0: 74 65 0a 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 te. ** option i
d5b0: 73 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 69 s enabled */. i
d5c0: 66 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 62 f( pPage->pBt->b
d5d0: 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 tsFlags & BTS_SE
d5e0: 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 CURE_DELETE ){.
d5f0: 20 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b memset(&data[
d600: 69 53 74 61 72 74 5d 2c 20 30 2c 20 69 53 69 7a iStart], 0, iSiz
d610: 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 e);. }.. /* Th
d620: 65 20 6c 69 73 74 20 6f 66 20 66 72 65 65 62 6c e list of freebl
d630: 6f 63 6b 73 20 6d 75 73 74 20 62 65 20 69 6e 20 ocks must be in
d640: 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e ascending order.
d650: 20 20 46 69 6e 64 20 74 68 65 20 0a 20 20 2a 2a Find the . **
d660: 20 73 70 6f 74 20 6f 6e 20 74 68 65 20 6c 69 73 spot on the lis
d670: 74 20 77 68 65 72 65 20 69 53 74 61 72 74 20 73 t where iStart s
d680: 68 6f 75 6c 64 20 62 65 20 69 6e 73 65 72 74 65 hould be inserte
d690: 64 2e 0a 20 20 2a 2f 0a 20 20 68 64 72 20 3d 20 d.. */. hdr =
d6a0: 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
d6b0: 3b 0a 20 20 69 50 74 72 20 3d 20 68 64 72 20 2b ;. iPtr = hdr +
d6c0: 20 31 3b 0a 20 20 69 66 28 20 64 61 74 61 5b 69 1;. if( data[i
d6d0: 50 74 72 2b 31 5d 3d 3d 30 20 26 26 20 64 61 74 Ptr+1]==0 && dat
d6e0: 61 5b 69 50 74 72 5d 3d 3d 30 20 29 7b 0a 20 20 a[iPtr]==0 ){.
d6f0: 20 20 69 46 72 65 65 42 6c 6b 20 3d 20 30 3b 20 iFreeBlk = 0;
d700: 20 2f 2a 20 53 68 6f 72 74 63 75 74 20 66 6f 72 /* Shortcut for
d710: 20 74 68 65 20 63 61 73 65 20 77 68 65 6e 20 74 the case when t
d720: 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 65 he freelist is e
d730: 6d 70 74 79 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b mpty */. }else{
d740: 0a 20 20 20 20 77 68 69 6c 65 28 20 28 69 46 72 . while( (iFr
d750: 65 65 42 6c 6b 20 3d 20 67 65 74 32 62 79 74 65 eeBlk = get2byte
d760: 28 26 64 61 74 61 5b 69 50 74 72 5d 29 29 3c 69 (&data[iPtr]))<i
d770: 53 74 61 72 74 20 29 7b 0a 20 20 20 20 20 20 69 Start ){. i
d780: 66 28 20 69 46 72 65 65 42 6c 6b 3c 69 50 74 72 f( iFreeBlk<iPtr
d790: 2b 34 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 +4 ){. if
d7a0: 28 20 69 46 72 65 65 42 6c 6b 3d 3d 30 20 29 20 ( iFreeBlk==0 )
d7b0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 72 break;. r
d7c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
d7d0: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 RUPT_BKPT;.
d7e0: 20 7d 0a 20 20 20 20 20 20 69 50 74 72 20 3d 20 }. iPtr =
d7f0: 69 46 72 65 65 42 6c 6b 3b 0a 20 20 20 20 7d 0a iFreeBlk;. }.
d800: 20 20 20 20 69 66 28 20 69 46 72 65 65 42 6c 6b if( iFreeBlk
d810: 3e 69 4c 61 73 74 20 29 20 72 65 74 75 72 6e 20 >iLast ) return
d820: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
d830: 4b 50 54 3b 0a 20 20 20 20 61 73 73 65 72 74 28 KPT;. assert(
d840: 20 69 46 72 65 65 42 6c 6b 3e 69 50 74 72 20 7c iFreeBlk>iPtr |
d850: 7c 20 69 46 72 65 65 42 6c 6b 3d 3d 30 20 29 3b | iFreeBlk==0 );
d860: 0a 20 20 0a 20 20 20 20 2f 2a 20 41 74 20 74 68 . . /* At th
d870: 69 73 20 70 6f 69 6e 74 3a 0a 20 20 20 20 2a 2a is point:. **
d880: 20 20 20 20 69 46 72 65 65 42 6c 6b 3a 20 20 20 iFreeBlk:
d890: 46 69 72 73 74 20 66 72 65 65 62 6c 6f 63 6b 20 First freeblock
d8a0: 61 66 74 65 72 20 69 53 74 61 72 74 2c 20 6f 72 after iStart, or
d8b0: 20 7a 65 72 6f 20 69 66 20 6e 6f 6e 65 0a 20 20 zero if none.
d8c0: 20 20 2a 2a 20 20 20 20 69 50 74 72 3a 20 20 20 ** iPtr:
d8d0: 20 20 20 20 54 68 65 20 61 64 64 72 65 73 73 20 The address
d8e0: 6f 66 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 of a pointer to
d8f0: 69 46 72 65 65 42 6c 6b 0a 20 20 20 20 2a 2a 0a iFreeBlk. **.
d900: 20 20 20 20 2a 2a 20 43 68 65 63 6b 20 74 6f 20 ** Check to
d910: 73 65 65 20 69 66 20 69 46 72 65 65 42 6c 6b 20 see if iFreeBlk
d920: 73 68 6f 75 6c 64 20 62 65 20 63 6f 61 6c 65 73 should be coales
d930: 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 ced onto the end
d940: 20 6f 66 20 69 53 74 61 72 74 2e 0a 20 20 20 20 of iStart..
d950: 2a 2f 0a 20 20 20 20 69 66 28 20 69 46 72 65 65 */. if( iFree
d960: 42 6c 6b 20 26 26 20 69 45 6e 64 2b 33 3e 3d 69 Blk && iEnd+3>=i
d970: 46 72 65 65 42 6c 6b 20 29 7b 0a 20 20 20 20 20 FreeBlk ){.
d980: 20 6e 46 72 61 67 20 3d 20 69 46 72 65 65 42 6c nFrag = iFreeBl
d990: 6b 20 2d 20 69 45 6e 64 3b 0a 20 20 20 20 20 20 k - iEnd;.
d9a0: 69 66 28 20 69 45 6e 64 3e 69 46 72 65 65 42 6c if( iEnd>iFreeBl
d9b0: 6b 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 k ) return SQLIT
d9c0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
d9d0: 20 20 20 20 20 20 69 45 6e 64 20 3d 20 69 46 72 iEnd = iFr
d9e0: 65 65 42 6c 6b 20 2b 20 67 65 74 32 62 79 74 65 eeBlk + get2byte
d9f0: 28 26 64 61 74 61 5b 69 46 72 65 65 42 6c 6b 2b (&data[iFreeBlk+
da00: 32 5d 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 2]);. if( i
da10: 45 6e 64 20 3e 20 70 50 61 67 65 2d 3e 70 42 74 End > pPage->pBt
da20: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 20 72 ->usableSize ) r
da30: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
da40: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 RUPT_BKPT;.
da50: 20 69 53 69 7a 65 20 3d 20 69 45 6e 64 20 2d 20 iSize = iEnd -
da60: 69 53 74 61 72 74 3b 0a 20 20 20 20 20 20 69 46 iStart;. iF
da70: 72 65 65 42 6c 6b 20 3d 20 67 65 74 32 62 79 74 reeBlk = get2byt
da80: 65 28 26 64 61 74 61 5b 69 46 72 65 65 42 6c 6b e(&data[iFreeBlk
da90: 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 ]);. }. .
daa0: 20 2f 2a 20 49 66 20 69 50 74 72 20 69 73 20 61 /* If iPtr is a
dab0: 6e 6f 74 68 65 72 20 66 72 65 65 62 6c 6f 63 6b nother freeblock
dac0: 20 28 74 68 61 74 20 69 73 2c 20 69 66 20 69 50 (that is, if iP
dad0: 74 72 20 69 73 20 6e 6f 74 20 74 68 65 20 66 72 tr is not the fr
dae0: 65 65 6c 69 73 74 0a 20 20 20 20 2a 2a 20 70 6f eelist. ** po
daf0: 69 6e 74 65 72 20 69 6e 20 74 68 65 20 70 61 67 inter in the pag
db00: 65 20 68 65 61 64 65 72 29 20 74 68 65 6e 20 63 e header) then c
db10: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 69 heck to see if i
db20: 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 65 0a Start should be.
db30: 20 20 20 20 2a 2a 20 63 6f 61 6c 65 73 63 65 64 ** coalesced
db40: 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 onto the end of
db50: 20 69 50 74 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 iPtr.. */.
db60: 20 20 69 66 28 20 69 50 74 72 3e 68 64 72 2b 31 if( iPtr>hdr+1
db70: 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 50 ){. int iP
db80: 74 72 45 6e 64 20 3d 20 69 50 74 72 20 2b 20 67 trEnd = iPtr + g
db90: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 50 et2byte(&data[iP
dba0: 74 72 2b 32 5d 29 3b 0a 20 20 20 20 20 20 69 66 tr+2]);. if
dbb0: 28 20 69 50 74 72 45 6e 64 2b 33 3e 3d 69 53 74 ( iPtrEnd+3>=iSt
dbc0: 61 72 74 20 29 7b 0a 20 20 20 20 20 20 20 20 69 art ){. i
dbd0: 66 28 20 69 50 74 72 45 6e 64 3e 69 53 74 61 72 f( iPtrEnd>iStar
dbe0: 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 t ) return SQLIT
dbf0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
dc00: 20 20 20 20 20 20 20 20 6e 46 72 61 67 20 2b 3d nFrag +=
dc10: 20 69 53 74 61 72 74 20 2d 20 69 50 74 72 45 6e iStart - iPtrEn
dc20: 64 3b 0a 20 20 20 20 20 20 20 20 69 53 69 7a 65 d;. iSize
dc30: 20 3d 20 69 45 6e 64 20 2d 20 69 50 74 72 3b 0a = iEnd - iPtr;.
dc40: 20 20 20 20 20 20 20 20 69 53 74 61 72 74 20 3d iStart =
dc50: 20 69 50 74 72 3b 0a 20 20 20 20 20 20 7d 0a 20 iPtr;. }.
dc60: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 6e 46 72 }. if( nFr
dc70: 61 67 3e 64 61 74 61 5b 68 64 72 2b 37 5d 20 29 ag>data[hdr+7] )
dc80: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
dc90: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
dca0: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2d 3d 20 data[hdr+7] -=
dcb0: 6e 46 72 61 67 3b 0a 20 20 7d 0a 20 20 69 66 28 nFrag;. }. if(
dcc0: 20 69 53 74 61 72 74 3d 3d 67 65 74 32 62 79 74 iStart==get2byt
dcd0: 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 e(&data[hdr+5])
dce0: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 ){. /* The ne
dcf0: 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 73 20 61 w freeblock is a
dd00: 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 t the beginning
dd10: 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 of the cell cont
dd20: 65 6e 74 20 61 72 65 61 2c 0a 20 20 20 20 2a 2a ent area,. **
dd30: 20 73 6f 20 6a 75 73 74 20 65 78 74 65 6e 64 20 so just extend
dd40: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
dd50: 20 61 72 65 61 20 72 61 74 68 65 72 20 74 68 61 area rather tha
dd60: 6e 20 63 72 65 61 74 65 20 61 6e 6f 74 68 65 72 n create another
dd70: 0a 20 20 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 . ** freelist
dd80: 20 65 6e 74 72 79 20 2a 2f 0a 20 20 20 20 69 66 entry */. if
dd90: 28 20 69 50 74 72 21 3d 68 64 72 2b 31 20 29 20 ( iPtr!=hdr+1 )
dda0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
ddb0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
ddc0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
ddd0: 64 72 2b 31 5d 2c 20 69 46 72 65 65 42 6c 6b 29 dr+1], iFreeBlk)
dde0: 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 ;. put2byte(&
ddf0: 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 69 45 6e data[hdr+5], iEn
de00: 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 d);. }else{.
de10: 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 65 20 6e /* Insert the n
de20: 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 6e 74 ew freeblock int
de30: 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a o the freelist *
de40: 2f 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 /. put2byte(&
de50: 64 61 74 61 5b 69 50 74 72 5d 2c 20 69 53 74 61 data[iPtr], iSta
de60: 72 74 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 rt);. put2byt
de70: 65 28 26 64 61 74 61 5b 69 53 74 61 72 74 5d 2c e(&data[iStart],
de80: 20 69 46 72 65 65 42 6c 6b 29 3b 0a 20 20 20 20 iFreeBlk);.
de90: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 put2byte(&data[i
dea0: 53 74 61 72 74 2b 32 5d 2c 20 69 53 69 7a 65 29 Start+2], iSize)
deb0: 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6e ;. }. pPage->n
dec0: 46 72 65 65 20 2b 3d 20 69 4f 72 69 67 53 69 7a Free += iOrigSiz
ded0: 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 e;. return SQLI
dee0: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
def0: 44 65 63 6f 64 65 20 74 68 65 20 66 6c 61 67 73 Decode the flags
df00: 20 62 79 74 65 20 28 74 68 65 20 66 69 72 73 74 byte (the first
df10: 20 62 79 74 65 20 6f 66 20 74 68 65 20 68 65 61 byte of the hea
df20: 64 65 72 29 20 66 6f 72 20 61 20 70 61 67 65 0a der) for a page.
df30: 2a 2a 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a ** and initializ
df40: 65 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 e fields of the
df50: 4d 65 6d 50 61 67 65 20 73 74 72 75 63 74 75 72 MemPage structur
df60: 65 20 61 63 63 6f 72 64 69 6e 67 6c 79 2e 0a 2a e accordingly..*
df70: 2a 0a 2a 2a 20 4f 6e 6c 79 20 74 68 65 20 66 6f *.** Only the fo
df80: 6c 6c 6f 77 69 6e 67 20 63 6f 6d 62 69 6e 61 74 llowing combinat
df90: 69 6f 6e 73 20 61 72 65 20 73 75 70 70 6f 72 74 ions are support
dfa0: 65 64 2e 20 20 41 6e 79 74 68 69 6e 67 20 64 69 ed. Anything di
dfb0: 66 66 65 72 65 6e 74 0a 2a 2a 20 69 6e 64 69 63 fferent.** indic
dfc0: 61 74 65 73 20 61 20 63 6f 72 72 75 70 74 20 64 ates a corrupt d
dfd0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 3a 0a 2a atabase files:.*
dfe0: 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 *.** PTF
dff0: 5f 5a 45 52 4f 44 41 54 41 0a 2a 2a 20 20 20 20 _ZERODATA.**
e000: 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 PTF_ZERODAT
e010: 41 20 7c 20 50 54 46 5f 4c 45 41 46 0a 2a 2a 20 A | PTF_LEAF.**
e020: 20 20 20 20 20 20 20 20 50 54 46 5f 4c 45 41 46 PTF_LEAF
e030: 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 DATA | PTF_INTKE
e040: 59 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 Y.** PTF
e050: 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 54 46 5f _LEAFDATA | PTF_
e060: 49 4e 54 4b 45 59 20 7c 20 50 54 46 5f 4c 45 41 INTKEY | PTF_LEA
e070: 46 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 F.*/.static int
e080: 64 65 63 6f 64 65 46 6c 61 67 73 28 4d 65 6d 50 decodeFlags(MemP
e090: 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 age *pPage, int
e0a0: 66 6c 61 67 42 79 74 65 29 7b 0a 20 20 42 74 53 flagByte){. BtS
e0b0: 68 61 72 65 64 20 2a 70 42 74 3b 20 20 20 20 20 hared *pBt;
e0c0: 2f 2a 20 41 20 63 6f 70 79 20 6f 66 20 70 50 61 /* A copy of pPa
e0d0: 67 65 2d 3e 70 42 74 20 2a 2f 0a 0a 20 20 61 73 ge->pBt */.. as
e0e0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 68 64 72 sert( pPage->hdr
e0f0: 4f 66 66 73 65 74 3d 3d 28 70 50 61 67 65 2d 3e Offset==(pPage->
e100: 70 67 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 pgno==1 ? 100 :
e110: 30 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 0) );. assert(
e120: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
e130: 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d ld(pPage->pBt->m
e140: 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 67 65 utex) );. pPage
e150: 2d 3e 6c 65 61 66 20 3d 20 28 75 38 29 28 66 6c ->leaf = (u8)(fl
e160: 61 67 42 79 74 65 3e 3e 33 29 3b 20 20 61 73 73 agByte>>3); ass
e170: 65 72 74 28 20 50 54 46 5f 4c 45 41 46 20 3d 3d ert( PTF_LEAF ==
e180: 20 31 3c 3c 33 20 29 3b 0a 20 20 66 6c 61 67 42 1<<3 );. flagB
e190: 79 74 65 20 26 3d 20 7e 50 54 46 5f 4c 45 41 46 yte &= ~PTF_LEAF
e1a0: 3b 0a 20 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 ;. pPage->child
e1b0: 50 74 72 53 69 7a 65 20 3d 20 34 2d 34 2a 70 50 PtrSize = 4-4*pP
e1c0: 61 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 70 50 61 age->leaf;. pPa
e1d0: 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 20 3d 20 ge->xCellSize =
e1e0: 63 65 6c 6c 53 69 7a 65 50 74 72 3b 0a 20 20 70 cellSizePtr;. p
e1f0: 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b Bt = pPage->pBt;
e200: 0a 20 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d . if( flagByte=
e210: 3d 28 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c =(PTF_LEAFDATA |
e220: 20 50 54 46 5f 49 4e 54 4b 45 59 29 20 29 7b 0a PTF_INTKEY) ){.
e230: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
e240: 4f 46 3a 20 52 2d 30 37 32 39 31 2d 33 35 33 32 OF: R-07291-3532
e250: 38 20 41 20 76 61 6c 75 65 20 6f 66 20 35 20 28 8 A value of 5 (
e260: 30 78 30 35 29 20 6d 65 61 6e 73 20 74 68 65 20 0x05) means the
e270: 70 61 67 65 20 69 73 20 61 6e 0a 20 20 20 20 2a page is an. *
e280: 2a 20 69 6e 74 65 72 69 6f 72 20 74 61 62 6c 65 * interior table
e290: 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f b-tree page. */
e2a0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 54 . assert( (PT
e2b0: 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f 49 F_LEAFDATA|PTF_I
e2c0: 4e 54 4b 45 59 29 3d 3d 35 20 29 3b 0a 20 20 20 NTKEY)==5 );.
e2d0: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
e2e0: 20 52 2d 32 36 39 30 30 2d 30 39 31 37 36 20 41 R-26900-09176 A
e2f0: 20 76 61 6c 75 65 20 6f 66 20 31 33 20 28 30 78 value of 13 (0x
e300: 30 64 29 20 6d 65 61 6e 73 20 74 68 65 20 70 61 0d) means the pa
e310: 67 65 20 69 73 20 61 0a 20 20 20 20 2a 2a 20 6c ge is a. ** l
e320: 65 61 66 20 74 61 62 6c 65 20 62 2d 74 72 65 65 eaf table b-tree
e330: 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 page. */. as
e340: 73 65 72 74 28 20 28 50 54 46 5f 4c 45 41 46 44 sert( (PTF_LEAFD
e350: 41 54 41 7c 50 54 46 5f 49 4e 54 4b 45 59 7c 50 ATA|PTF_INTKEY|P
e360: 54 46 5f 4c 45 41 46 29 3d 3d 31 33 20 29 3b 0a TF_LEAF)==13 );.
e370: 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 pPage->intKe
e380: 79 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 70 y = 1;. if( p
e390: 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
e3a0: 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 pPage->intKe
e3b0: 79 4c 65 61 66 20 3d 20 31 3b 0a 20 20 20 20 20 yLeaf = 1;.
e3c0: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
e3d0: 6c 6c 20 3d 20 62 74 72 65 65 50 61 72 73 65 43 ll = btreeParseC
e3e0: 65 6c 6c 50 74 72 3b 0a 20 20 20 20 7d 65 6c 73 ellPtr;. }els
e3f0: 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e e{. pPage->
e400: 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 30 3b 0a intKeyLeaf = 0;.
e410: 20 20 20 20 20 20 70 50 61 67 65 2d 3e 78 43 65 pPage->xCe
e420: 6c 6c 53 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a llSize = cellSiz
e430: 65 50 74 72 4e 6f 50 61 79 6c 6f 61 64 3b 0a 20 ePtrNoPayload;.
e440: 20 20 20 20 20 70 50 61 67 65 2d 3e 78 50 61 72 pPage->xPar
e450: 73 65 43 65 6c 6c 20 3d 20 62 74 72 65 65 50 61 seCell = btreePa
e460: 72 73 65 43 65 6c 6c 50 74 72 4e 6f 50 61 79 6c rseCellPtrNoPayl
e470: 6f 61 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 oad;. }. p
e480: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d Page->maxLocal =
e490: 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 3b 0a 20 pBt->maxLeaf;.
e4a0: 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 pPage->minLoc
e4b0: 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e 4c 65 61 al = pBt->minLea
e4c0: 66 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 f;. }else if( f
e4d0: 6c 61 67 42 79 74 65 3d 3d 50 54 46 5f 5a 45 52 lagByte==PTF_ZER
e4e0: 4f 44 41 54 41 20 29 7b 0a 20 20 20 20 2f 2a 20 ODATA ){. /*
e4f0: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 EVIDENCE-OF: R-4
e500: 33 33 31 36 2d 33 37 33 30 38 20 41 20 76 61 6c 3316-37308 A val
e510: 75 65 20 6f 66 20 32 20 28 30 78 30 32 29 20 6d ue of 2 (0x02) m
e520: 65 61 6e 73 20 74 68 65 20 70 61 67 65 20 69 73 eans the page is
e530: 20 61 6e 0a 20 20 20 20 2a 2a 20 69 6e 74 65 72 an. ** inter
e540: 69 6f 72 20 69 6e 64 65 78 20 62 2d 74 72 65 65 ior index b-tree
e550: 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 page. */. as
e560: 73 65 72 74 28 20 28 50 54 46 5f 5a 45 52 4f 44 sert( (PTF_ZEROD
e570: 41 54 41 29 3d 3d 32 20 29 3b 0a 20 20 20 20 2f ATA)==2 );. /
e580: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
e590: 2d 35 39 36 31 35 2d 34 32 38 32 38 20 41 20 76 -59615-42828 A v
e5a0: 61 6c 75 65 20 6f 66 20 31 30 20 28 30 78 30 61 alue of 10 (0x0a
e5b0: 29 20 6d 65 61 6e 73 20 74 68 65 20 70 61 67 65 ) means the page
e5c0: 20 69 73 20 61 0a 20 20 20 20 2a 2a 20 6c 65 61 is a. ** lea
e5d0: 66 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 70 f index b-tree p
e5e0: 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 age. */. asse
e5f0: 72 74 28 20 28 50 54 46 5f 5a 45 52 4f 44 41 54 rt( (PTF_ZERODAT
e600: 41 7c 50 54 46 5f 4c 45 41 46 29 3d 3d 31 30 20 A|PTF_LEAF)==10
e610: 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e );. pPage->in
e620: 74 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 70 50 tKey = 0;. pP
e630: 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 age->intKeyLeaf
e640: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e = 0;. pPage->
e650: 78 50 61 72 73 65 43 65 6c 6c 20 3d 20 62 74 72 xParseCell = btr
e660: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 49 6e eeParseCellPtrIn
e670: 64 65 78 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e dex;. pPage->
e680: 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e maxLocal = pBt->
e690: 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 20 20 70 50 maxLocal;. pP
e6a0: 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 age->minLocal =
e6b0: 70 42 74 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 pBt->minLocal;.
e6c0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 45 }else{. /* E
e6d0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 37 VIDENCE-OF: R-47
e6e0: 36 30 38 2d 35 36 34 36 39 20 41 6e 79 20 6f 74 608-56469 Any ot
e6f0: 68 65 72 20 76 61 6c 75 65 20 66 6f 72 20 74 68 her value for th
e700: 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 74 79 e b-tree page ty
e710: 70 65 20 69 73 0a 20 20 20 20 2a 2a 20 61 6e 20 pe is. ** an
e720: 65 72 72 6f 72 2e 20 2a 2f 0a 20 20 20 20 72 65 error. */. re
e730: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
e740: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 UPT_BKPT;. }.
e750: 70 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 65 50 pPage->max1byteP
e760: 61 79 6c 6f 61 64 20 3d 20 70 42 74 2d 3e 6d 61 ayload = pBt->ma
e770: 78 31 62 79 74 65 50 61 79 6c 6f 61 64 3b 0a 20 x1bytePayload;.
e780: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
e790: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 K;.}../*.** Init
e7a0: 69 61 6c 69 7a 65 20 74 68 65 20 61 75 78 69 6c ialize the auxil
e7b0: 69 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e iary information
e7c0: 20 66 6f 72 20 61 20 64 69 73 6b 20 62 6c 6f 63 for a disk bloc
e7d0: 6b 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 k..**.** Return
e7e0: 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 SQLITE_OK on suc
e7f0: 63 65 73 73 2e 20 20 49 66 20 77 65 20 73 65 65 cess. If we see
e800: 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 64 that the page d
e810: 6f 65 73 0a 2a 2a 20 6e 6f 74 20 63 6f 6e 74 61 oes.** not conta
e820: 69 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 in a well-formed
e830: 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2c 20 database page,
e840: 74 68 65 6e 20 72 65 74 75 72 6e 20 0a 2a 2a 20 then return .**
e850: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e 20 SQLITE_CORRUPT.
e860: 20 4e 6f 74 65 20 74 68 61 74 20 61 20 72 65 74 Note that a ret
e870: 75 72 6e 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4b urn of SQLITE_OK
e880: 20 64 6f 65 73 20 6e 6f 74 0a 2a 2a 20 67 75 61 does not.** gua
e890: 72 61 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 rantee that the
e8a0: 70 61 67 65 20 69 73 20 77 65 6c 6c 2d 66 6f 72 page is well-for
e8b0: 6d 65 64 2e 20 20 49 74 20 6f 6e 6c 79 20 73 68 med. It only sh
e8c0: 6f 77 73 20 74 68 61 74 0a 2a 2a 20 77 65 20 66 ows that.** we f
e8d0: 61 69 6c 65 64 20 74 6f 20 64 65 74 65 63 74 20 ailed to detect
e8e0: 61 6e 79 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a any corruption..
e8f0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
e900: 72 65 65 49 6e 69 74 50 61 67 65 28 4d 65 6d 50 reeInitPage(MemP
e910: 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 0a 20 20 age *pPage){..
e920: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 assert( pPage->p
e930: 42 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 Bt!=0 );. asser
e940: 74 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 64 t( pPage->pBt->d
e950: 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 b!=0 );. assert
e960: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
e970: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
e980: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
e990: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 67 6e 6f ert( pPage->pgno
e9a0: 3d 3d 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ==sqlite3PagerPa
e9b0: 67 65 6e 75 6d 62 65 72 28 70 50 61 67 65 2d 3e genumber(pPage->
e9c0: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
e9d0: 73 65 72 74 28 20 70 50 61 67 65 20 3d 3d 20 73 sert( pPage == s
e9e0: 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 qlite3PagerGetEx
e9f0: 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 tra(pPage->pDbPa
ea00: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
ea10: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 3d 3d pPage->aData ==
ea20: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
ea30: 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 62 50 Data(pPage->pDbP
ea40: 61 67 65 29 20 29 3b 0a 0a 20 20 69 66 28 20 21 age) );.. if( !
ea50: 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b pPage->isInit ){
ea60: 0a 20 20 20 20 69 6e 74 20 70 63 3b 20 20 20 20 . int pc;
ea70: 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 /* Addre
ea80: 73 73 20 6f 66 20 61 20 66 72 65 65 62 6c 6f 63 ss of a freebloc
ea90: 6b 20 77 69 74 68 69 6e 20 70 50 61 67 65 2d 3e k within pPage->
eaa0: 61 44 61 74 61 5b 5d 20 2a 2f 0a 20 20 20 20 75 aData[] */. u
eab0: 38 20 68 64 72 3b 20 20 20 20 20 20 20 20 20 20 8 hdr;
eac0: 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 62 /* Offset to b
ead0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 70 61 67 65 eginning of page
eae0: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 20 20 75 header */. u
eaf0: 38 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 20 8 *data;
eb00: 20 20 2f 2a 20 45 71 75 61 6c 20 74 6f 20 70 50 /* Equal to pP
eb10: 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 age->aData */.
eb20: 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b BtShared *pBt;
eb30: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d /* The m
eb40: 61 69 6e 20 62 74 72 65 65 20 73 74 72 75 63 74 ain btree struct
eb50: 75 72 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 75 ure */. int u
eb60: 73 61 62 6c 65 53 69 7a 65 3b 20 20 20 20 2f 2a sableSize; /*
eb70: 20 41 6d 6f 75 6e 74 20 6f 66 20 75 73 61 62 6c Amount of usabl
eb80: 65 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 e space on each
eb90: 70 61 67 65 20 2a 2f 0a 20 20 20 20 75 31 36 20 page */. u16
eba0: 63 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f cellOffset; /
ebb0: 2a 20 4f 66 66 73 65 74 20 66 72 6f 6d 20 73 74 * Offset from st
ebc0: 61 72 74 20 6f 66 20 70 61 67 65 20 74 6f 20 66 art of page to f
ebd0: 69 72 73 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 irst cell pointe
ebe0: 72 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72 r */. int nFr
ebf0: 65 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ee; /* N
ec00: 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64 20 umber of unused
ec10: 62 79 74 65 73 20 6f 6e 20 74 68 65 20 70 61 67 bytes on the pag
ec20: 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 74 6f 70 e */. int top
ec30: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 ; /* F
ec40: 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 irst byte of the
ec50: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 cell content ar
ec60: 65 61 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 ea */. int iC
ec70: 65 6c 6c 46 69 72 73 74 3b 20 20 20 20 2f 2a 20 ellFirst; /*
ec80: 46 69 72 73 74 20 61 6c 6c 6f 77 61 62 6c 65 20 First allowable
ec90: 63 65 6c 6c 20 6f 72 20 66 72 65 65 62 6c 6f 63 cell or freebloc
eca0: 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 20 20 20 20 k offset */.
ecb0: 69 6e 74 20 69 43 65 6c 6c 4c 61 73 74 3b 20 20 int iCellLast;
ecc0: 20 20 20 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 /* Last possi
ecd0: 62 6c 65 20 63 65 6c 6c 20 6f 72 20 66 72 65 65 ble cell or free
ece0: 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a block offset */.
ecf0: 0a 20 20 20 20 70 42 74 20 3d 20 70 50 61 67 65 . pBt = pPage
ed00: 2d 3e 70 42 74 3b 0a 0a 20 20 20 20 68 64 72 20 ->pBt;.. hdr
ed10: 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 = pPage->hdrOffs
ed20: 65 74 3b 0a 20 20 20 20 64 61 74 61 20 3d 20 70 et;. data = p
ed30: 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 20 20 Page->aData;.
ed40: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
ed50: 20 52 2d 32 38 35 39 34 2d 30 32 38 39 30 20 54 R-28594-02890 T
ed60: 68 65 20 6f 6e 65 2d 62 79 74 65 20 66 6c 61 67 he one-byte flag
ed70: 20 61 74 20 6f 66 66 73 65 74 20 30 20 69 6e 64 at offset 0 ind
ed80: 69 63 61 74 69 6e 67 0a 20 20 20 20 2a 2a 20 74 icating. ** t
ed90: 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 74 he b-tree page t
eda0: 79 70 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 ype. */. if(
edb0: 64 65 63 6f 64 65 46 6c 61 67 73 28 70 50 61 67 decodeFlags(pPag
edc0: 65 2c 20 64 61 74 61 5b 68 64 72 5d 29 20 29 20 e, data[hdr]) )
edd0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
ede0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
edf0: 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 67 assert( pBt->pag
ee00: 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 42 eSize>=512 && pB
ee10: 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 35 t->pageSize<=655
ee20: 33 36 20 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 36 );. pPage-
ee30: 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 31 36 >maskPage = (u16
ee40: 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 )(pBt->pageSize
ee50: 2d 20 31 29 3b 0a 20 20 20 20 70 50 61 67 65 2d - 1);. pPage-
ee60: 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a >nOverflow = 0;.
ee70: 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 20 3d usableSize =
ee80: 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
ee90: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 63 65 6c ;. pPage->cel
eea0: 6c 4f 66 66 73 65 74 20 3d 20 63 65 6c 6c 4f 66 lOffset = cellOf
eeb0: 66 73 65 74 20 3d 20 68 64 72 20 2b 20 38 20 2b fset = hdr + 8 +
eec0: 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
eed0: 53 69 7a 65 3b 0a 20 20 20 20 70 50 61 67 65 2d Size;. pPage-
eee0: 3e 61 44 61 74 61 45 6e 64 20 3d 20 26 64 61 74 >aDataEnd = &dat
eef0: 61 5b 75 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 a[usableSize];.
ef00: 20 20 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 pPage->aCellI
ef10: 64 78 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f dx = &data[cellO
ef20: 66 66 73 65 74 5d 3b 0a 20 20 20 20 70 50 61 67 ffset];. pPag
ef30: 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 3d 20 26 e->aDataOfst = &
ef40: 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 68 69 6c data[pPage->chil
ef50: 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 20 20 2f dPtrSize];. /
ef60: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
ef70: 2d 35 38 30 31 35 2d 34 38 31 37 35 20 54 68 65 -58015-48175 The
ef80: 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 67 65 two-byte intege
ef90: 72 20 61 74 20 6f 66 66 73 65 74 20 35 20 64 65 r at offset 5 de
efa0: 73 69 67 6e 61 74 65 73 0a 20 20 20 20 2a 2a 20 signates. **
efb0: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
efc0: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 cell content ar
efd0: 65 61 2e 20 41 20 7a 65 72 6f 20 76 61 6c 75 65 ea. A zero value
efe0: 20 66 6f 72 20 74 68 69 73 20 69 6e 74 65 67 65 for this intege
eff0: 72 20 69 73 0a 20 20 20 20 2a 2a 20 69 6e 74 65 r is. ** inte
f000: 72 70 72 65 74 65 64 20 61 73 20 36 35 35 33 36 rpreted as 65536
f010: 2e 20 2a 2f 0a 20 20 20 20 74 6f 70 20 3d 20 67 . */. top = g
f020: 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 et2byteNotZero(&
f030: 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 data[hdr+5]);.
f040: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
f050: 3a 20 52 2d 33 37 30 30 32 2d 33 32 37 37 34 20 : R-37002-32774
f060: 54 68 65 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 The two-byte int
f070: 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 33 eger at offset 3
f080: 20 67 69 76 65 73 20 74 68 65 0a 20 20 20 20 2a gives the. *
f090: 2a 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c * number of cell
f0a0: 73 20 6f 6e 20 74 68 65 20 70 61 67 65 2e 20 2a s on the page. *
f0b0: 2f 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 43 65 /. pPage->nCe
f0c0: 6c 6c 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 ll = get2byte(&d
f0d0: 61 74 61 5b 68 64 72 2b 33 5d 29 3b 0a 20 20 20 ata[hdr+3]);.
f0e0: 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c if( pPage->nCel
f0f0: 6c 3e 4d 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 l>MX_CELL(pBt) )
f100: 7b 0a 20 20 20 20 20 20 2f 2a 20 54 6f 20 6d 61 {. /* To ma
f110: 6e 79 20 63 65 6c 6c 73 20 66 6f 72 20 61 20 73 ny cells for a s
f120: 69 6e 67 6c 65 20 70 61 67 65 2e 20 20 54 68 65 ingle page. The
f130: 20 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 6f page must be co
f140: 72 72 75 70 74 20 2a 2f 0a 20 20 20 20 20 20 72 rrupt */. r
f150: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
f160: 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
f170: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 . testcase( p
f180: 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 4d 58 5f Page->nCell==MX_
f190: 43 45 4c 4c 28 70 42 74 29 20 29 3b 0a 20 20 20 CELL(pBt) );.
f1a0: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
f1b0: 20 52 2d 32 34 30 38 39 2d 35 37 39 37 39 20 49 R-24089-57979 I
f1c0: 66 20 61 20 70 61 67 65 20 63 6f 6e 74 61 69 6e f a page contain
f1d0: 73 20 6e 6f 20 63 65 6c 6c 73 20 28 77 68 69 63 s no cells (whic
f1e0: 68 20 69 73 20 6f 6e 6c 79 0a 20 20 20 20 2a 2a h is only. **
f1f0: 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 20 possible for a
f200: 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 20 74 root page of a t
f210: 61 62 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 able that contai
f220: 6e 73 20 6e 6f 20 72 6f 77 73 29 20 74 68 65 6e ns no rows) then
f230: 20 74 68 65 0a 20 20 20 20 2a 2a 20 6f 66 66 73 the. ** offs
f240: 65 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 et to the cell c
f250: 6f 6e 74 65 6e 74 20 61 72 65 61 20 77 69 6c 6c ontent area will
f260: 20 65 71 75 61 6c 20 74 68 65 20 70 61 67 65 20 equal the page
f270: 73 69 7a 65 20 6d 69 6e 75 73 20 74 68 65 0a 20 size minus the.
f280: 20 20 20 2a 2a 20 62 79 74 65 73 20 6f 66 20 72 ** bytes of r
f290: 65 73 65 72 76 65 64 20 73 70 61 63 65 2e 20 2a eserved space. *
f2a0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 /. assert( pP
f2b0: 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 7c 7c 20 age->nCell>0 ||
f2c0: 74 6f 70 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 top==usableSize
f2d0: 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
f2e0: 0a 0a 20 20 20 20 2f 2a 20 41 20 6d 61 6c 66 6f .. /* A malfo
f2f0: 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 70 61 rmed database pa
f300: 67 65 20 6d 69 67 68 74 20 63 61 75 73 65 20 75 ge might cause u
f310: 73 20 74 6f 20 72 65 61 64 20 70 61 73 74 20 74 s to read past t
f320: 68 65 20 65 6e 64 0a 20 20 20 20 2a 2a 20 6f 66 he end. ** of
f330: 20 70 61 67 65 20 77 68 65 6e 20 70 61 72 73 69 page when parsi
f340: 6e 67 20 61 20 63 65 6c 6c 2e 20 20 0a 20 20 20 ng a cell. .
f350: 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 **. ** The f
f360: 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6f ollowing block o
f370: 66 20 63 6f 64 65 20 63 68 65 63 6b 73 20 65 61 f code checks ea
f380: 72 6c 79 20 74 6f 20 73 65 65 20 69 66 20 61 20 rly to see if a
f390: 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a 20 20 20 cell extends.
f3a0: 20 2a 2a 20 70 61 73 74 20 74 68 65 20 65 6e 64 ** past the end
f3b0: 20 6f 66 20 61 20 70 61 67 65 20 62 6f 75 6e 64 of a page bound
f3c0: 61 72 79 20 61 6e 64 20 63 61 75 73 65 73 20 53 ary and causes S
f3d0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 74 6f QLITE_CORRUPT to
f3e0: 20 62 65 20 0a 20 20 20 20 2a 2a 20 72 65 74 75 be . ** retu
f3f0: 72 6e 65 64 20 69 66 20 69 74 20 64 6f 65 73 2e rned if it does.
f400: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 43 65 6c . */. iCel
f410: 6c 46 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 66 lFirst = cellOff
f420: 73 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e set + 2*pPage->n
f430: 43 65 6c 6c 3b 0a 20 20 20 20 69 43 65 6c 6c 4c Cell;. iCellL
f440: 61 73 74 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 ast = usableSize
f450: 20 2d 20 34 3b 0a 20 20 20 20 69 66 28 20 70 42 - 4;. if( pB
f460: 74 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 t->db->flags & S
f470: 51 4c 49 54 45 5f 43 65 6c 6c 53 69 7a 65 43 6b QLITE_CellSizeCk
f480: 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b ){. int i;
f490: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
f4a0: 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20 63 65 ndex into the ce
f4b0: 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 ll pointer array
f4c0: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 7a */. int sz
f4d0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ; /* S
f4e0: 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a 2f ize of a cell */
f4f0: 0a 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 61 .. if( !pPa
f500: 67 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c ge->leaf ) iCell
f510: 4c 61 73 74 2d 2d 3b 0a 20 20 20 20 20 20 66 6f Last--;. fo
f520: 72 28 69 3d 30 3b 20 69 3c 70 50 61 67 65 2d 3e r(i=0; i<pPage->
f530: 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 nCell; i++){.
f540: 20 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 79 pc = get2by
f550: 74 65 41 6c 69 67 6e 65 64 28 26 64 61 74 61 5b teAligned(&data[
f560: 63 65 6c 6c 4f 66 66 73 65 74 2b 69 2a 32 5d 29 cellOffset+i*2])
f570: 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
f580: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 se( pc==iCellFir
f590: 73 74 20 29 3b 0a 20 20 20 20 20 20 20 20 74 65 st );. te
f5a0: 73 74 63 61 73 65 28 20 70 63 3d 3d 69 43 65 6c stcase( pc==iCel
f5b0: 6c 4c 61 73 74 20 29 3b 0a 20 20 20 20 20 20 20 lLast );.
f5c0: 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 69 72 if( pc<iCellFir
f5d0: 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c 4c 61 st || pc>iCellLa
f5e0: 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 st ){.
f5f0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
f600: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
f610: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 7a }. sz
f620: 20 3d 20 70 50 61 67 65 2d 3e 78 43 65 6c 6c 53 = pPage->xCellS
f630: 69 7a 65 28 70 50 61 67 65 2c 20 26 64 61 74 61 ize(pPage, &data
f640: 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 [pc]);. t
f650: 65 73 74 63 61 73 65 28 20 70 63 2b 73 7a 3d 3d estcase( pc+sz==
f660: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
f670: 20 20 20 20 20 20 69 66 28 20 70 63 2b 73 7a 3e if( pc+sz>
f680: 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 usableSize ){.
f690: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
f6a0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
f6b0: 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 PT;. }.
f6c0: 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
f6d0: 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 20 69 !pPage->leaf ) i
f6e0: 43 65 6c 6c 4c 61 73 74 2b 2b 3b 0a 20 20 20 20 CellLast++;.
f6f0: 7d 20 20 0a 0a 20 20 20 20 2f 2a 20 43 6f 6d 70 } .. /* Comp
f700: 75 74 65 20 74 68 65 20 74 6f 74 61 6c 20 66 72 ute the total fr
f710: 65 65 20 73 70 61 63 65 20 6f 6e 20 74 68 65 20 ee space on the
f720: 70 61 67 65 0a 20 20 20 20 2a 2a 20 45 56 49 44 page. ** EVID
f730: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 33 35 38 38 ENCE-OF: R-23588
f740: 2d 33 34 34 35 30 20 54 68 65 20 74 77 6f 2d 62 -34450 The two-b
f750: 79 74 65 20 69 6e 74 65 67 65 72 20 61 74 20 6f yte integer at o
f760: 66 66 73 65 74 20 31 20 67 69 76 65 73 20 74 68 ffset 1 gives th
f770: 65 0a 20 20 20 20 2a 2a 20 73 74 61 72 74 20 6f e. ** start o
f780: 66 20 74 68 65 20 66 69 72 73 74 20 66 72 65 65 f the first free
f790: 62 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 70 61 67 block on the pag
f7a0: 65 2c 20 6f 72 20 69 73 20 7a 65 72 6f 20 69 66 e, or is zero if
f7b0: 20 74 68 65 72 65 20 61 72 65 20 6e 6f 0a 20 20 there are no.
f7c0: 20 20 2a 2a 20 66 72 65 65 62 6c 6f 63 6b 73 2e ** freeblocks.
f7d0: 20 2a 2f 0a 20 20 20 20 70 63 20 3d 20 67 65 74 */. pc = get
f7e0: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
f7f0: 31 5d 29 3b 0a 20 20 20 20 6e 46 72 65 65 20 3d 1]);. nFree =
f800: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2b 20 74 data[hdr+7] + t
f810: 6f 70 3b 20 20 2f 2a 20 49 6e 69 74 20 6e 46 72 op; /* Init nFr
f820: 65 65 20 74 6f 20 6e 6f 6e 2d 66 72 65 65 62 6c ee to non-freebl
f830: 6f 63 6b 20 66 72 65 65 20 73 70 61 63 65 20 2a ock free space *
f840: 2f 0a 20 20 20 20 69 66 28 20 70 63 3e 30 20 29 /. if( pc>0 )
f850: 7b 0a 20 20 20 20 20 20 75 33 32 20 6e 65 78 74 {. u32 next
f860: 2c 20 73 69 7a 65 3b 0a 20 20 20 20 20 20 69 66 , size;. if
f870: 28 20 70 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 ( pc<iCellFirst
f880: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 ){. /* EV
f890: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 35 35 IDENCE-OF: R-555
f8a0: 33 30 2d 35 32 39 33 30 20 49 6e 20 61 20 77 65 30-52930 In a we
f8b0: 6c 6c 2d 66 6f 72 6d 65 64 20 62 2d 74 72 65 65 ll-formed b-tree
f8c0: 20 70 61 67 65 2c 20 74 68 65 72 65 20 77 69 6c page, there wil
f8d0: 6c 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6c 77 l. ** alw
f8e0: 61 79 73 20 62 65 20 61 74 20 6c 65 61 73 74 20 ays be at least
f8f0: 6f 6e 65 20 63 65 6c 6c 20 62 65 66 6f 72 65 20 one cell before
f900: 74 68 65 20 66 69 72 73 74 20 66 72 65 65 62 6c the first freebl
f910: 6f 63 6b 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ock.. */.
f920: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
f930: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
f940: 50 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20 PT; . }.
f950: 20 20 20 77 68 69 6c 65 28 20 31 20 29 7b 0a 20 while( 1 ){.
f960: 20 20 20 20 20 20 20 69 66 28 20 70 63 3e 69 43 if( pc>iC
f970: 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 ellLast ){.
f980: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
f990: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
f9a0: 20 2f 2a 20 46 72 65 65 62 6c 6f 63 6b 20 6f 66 /* Freeblock of
f9b0: 66 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 f the end of the
f9c0: 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 page */.
f9d0: 20 7d 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 }. next
f9e0: 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
f9f0: 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 20 20 73 [pc]);. s
fa00: 69 7a 65 20 3d 20 67 65 74 32 62 79 74 65 28 26 ize = get2byte(&
fa10: 64 61 74 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 data[pc+2]);.
fa20: 20 20 20 20 20 6e 46 72 65 65 20 3d 20 6e 46 72 nFree = nFr
fa30: 65 65 20 2b 20 73 69 7a 65 3b 0a 20 20 20 20 20 ee + size;.
fa40: 20 20 20 69 66 28 20 6e 65 78 74 3c 3d 70 63 2b if( next<=pc+
fa50: 73 69 7a 65 2b 33 20 29 20 62 72 65 61 6b 3b 0a size+3 ) break;.
fa60: 20 20 20 20 20 20 20 20 70 63 20 3d 20 6e 65 78 pc = nex
fa70: 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 t;. }.
fa80: 20 69 66 28 20 6e 65 78 74 3e 30 20 29 7b 0a 20 if( next>0 ){.
fa90: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
faa0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
fab0: 54 3b 20 20 2f 2a 20 46 72 65 65 62 6c 6f 63 6b T; /* Freeblock
fac0: 20 6e 6f 74 20 69 6e 20 61 73 63 65 6e 64 69 6e not in ascendin
fad0: 67 20 6f 72 64 65 72 20 2a 2f 0a 20 20 20 20 20 g order */.
fae0: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 63 2b }. if( pc+
faf0: 73 69 7a 65 3e 28 75 6e 73 69 67 6e 65 64 20 69 size>(unsigned i
fb00: 6e 74 29 75 73 61 62 6c 65 53 69 7a 65 20 29 7b nt)usableSize ){
fb10: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
fb20: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
fb30: 4b 50 54 3b 20 20 2f 2a 20 4c 61 73 74 20 66 72 KPT; /* Last fr
fb40: 65 65 62 6c 6f 63 6b 20 65 78 74 65 6e 64 73 20 eeblock extends
fb50: 70 61 73 74 20 70 61 67 65 20 65 6e 64 20 2a 2f past page end */
fb60: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a . }. }..
fb70: 20 20 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 /* At this p
fb80: 6f 69 6e 74 2c 20 6e 46 72 65 65 20 63 6f 6e 74 oint, nFree cont
fb90: 61 69 6e 73 20 74 68 65 20 73 75 6d 20 6f 66 20 ains the sum of
fba0: 74 68 65 20 6f 66 66 73 65 74 20 74 6f 20 74 68 the offset to th
fbb0: 65 20 73 74 61 72 74 0a 20 20 20 20 2a 2a 20 6f e start. ** o
fbc0: 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 65 f the cell-conte
fbd0: 6e 74 20 61 72 65 61 20 70 6c 75 73 20 74 68 65 nt area plus the
fbe0: 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 65 65 20 number of free
fbf0: 62 79 74 65 73 20 77 69 74 68 69 6e 0a 20 20 20 bytes within.
fc00: 20 2a 2a 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e ** the cell-con
fc10: 74 65 6e 74 20 61 72 65 61 2e 20 49 66 20 74 68 tent area. If th
fc20: 69 73 20 69 73 20 67 72 65 61 74 65 72 20 74 68 is is greater th
fc30: 61 6e 20 74 68 65 20 75 73 61 62 6c 65 2d 73 69 an the usable-si
fc40: 7a 65 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 ze. ** of the
fc50: 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 page, then the
fc60: 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 6f 72 page must be cor
fc70: 72 75 70 74 65 64 2e 20 54 68 69 73 20 63 68 65 rupted. This che
fc80: 63 6b 20 61 6c 73 6f 0a 20 20 20 20 2a 2a 20 73 ck also. ** s
fc90: 65 72 76 65 73 20 74 6f 20 76 65 72 69 66 79 20 erves to verify
fca0: 74 68 61 74 20 74 68 65 20 6f 66 66 73 65 74 20 that the offset
fcb0: 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 to the start of
fcc0: 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 the cell-content
fcd0: 0a 20 20 20 20 2a 2a 20 61 72 65 61 2c 20 61 63 . ** area, ac
fce0: 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 70 cording to the p
fcf0: 61 67 65 20 68 65 61 64 65 72 2c 20 6c 69 65 73 age header, lies
fd00: 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67 65 within the page
fd10: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
fd20: 20 6e 46 72 65 65 3e 75 73 61 62 6c 65 53 69 7a nFree>usableSiz
fd30: 65 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 e ){. retur
fd40: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
fd50: 5f 42 4b 50 54 3b 20 0a 20 20 20 20 7d 0a 20 20 _BKPT; . }.
fd60: 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d pPage->nFree =
fd70: 20 28 75 31 36 29 28 6e 46 72 65 65 20 2d 20 69 (u16)(nFree - i
fd80: 43 65 6c 6c 46 69 72 73 74 29 3b 0a 20 20 20 20 CellFirst);.
fd90: 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 pPage->isInit =
fda0: 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 1;. }. return
fdb0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
fdc0: 0a 2a 2a 20 53 65 74 20 75 70 20 61 20 72 61 77 .** Set up a raw
fdd0: 20 70 61 67 65 20 73 6f 20 74 68 61 74 20 69 74 page so that it
fde0: 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 61 20 64 61 looks like a da
fdf0: 74 61 62 61 73 65 20 70 61 67 65 20 68 6f 6c 64 tabase page hold
fe00: 69 6e 67 0a 2a 2a 20 6e 6f 20 65 6e 74 72 69 65 ing.** no entrie
fe10: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 s..*/.static voi
fe20: 64 20 7a 65 72 6f 50 61 67 65 28 4d 65 6d 50 61 d zeroPage(MemPa
fe30: 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 ge *pPage, int f
fe40: 6c 61 67 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 lags){. unsigne
fe50: 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d 20 70 d char *data = p
fe60: 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 20 42 Page->aData;. B
fe70: 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
fe80: 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 75 38 20 Page->pBt;. u8
fe90: 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 hdr = pPage->hdr
fea0: 4f 66 66 73 65 74 3b 0a 20 20 75 31 36 20 66 69 Offset;. u16 fi
feb0: 72 73 74 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 rst;.. assert(
fec0: 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 sqlite3PagerPage
fed0: 6e 75 6d 62 65 72 28 70 50 61 67 65 2d 3e 70 44 number(pPage->pD
fee0: 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 70 bPage)==pPage->p
fef0: 67 6e 6f 20 29 3b 0a 20 20 61 73 73 65 72 74 28 gno );. assert(
ff00: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
ff10: 45 78 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 Extra(pPage->pDb
ff20: 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 Page) == (void*)
ff30: 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 pPage );. asser
ff40: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
ff50: 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 etData(pPage->pD
ff60: 62 50 61 67 65 29 20 3d 3d 20 64 61 74 61 20 29 bPage) == data )
ff70: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
ff80: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
ff90: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
ffa0: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
ffb0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
ffc0: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
ffd0: 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 );. if( pBt->bt
ffe0: 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 sFlags & BTS_SEC
fff0: 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 URE_DELETE ){.
10000 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 68 memset(&data[h
10010 64 72 5d 2c 20 30 2c 20 70 42 74 2d 3e 75 73 61 dr], 0, pBt->usa
10020 62 6c 65 53 69 7a 65 20 2d 20 68 64 72 29 3b 0a bleSize - hdr);.
10030 20 20 7d 0a 20 20 64 61 74 61 5b 68 64 72 5d 20 }. data[hdr]
10040 3d 20 28 63 68 61 72 29 66 6c 61 67 73 3b 0a 20 = (char)flags;.
10050 20 66 69 72 73 74 20 3d 20 68 64 72 20 2b 20 28 first = hdr + (
10060 28 66 6c 61 67 73 26 50 54 46 5f 4c 45 41 46 29 (flags&PTF_LEAF)
10070 3d 3d 30 20 3f 20 31 32 20 3a 20 38 29 3b 0a 20 ==0 ? 12 : 8);.
10080 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 68 64 memset(&data[hd
10090 72 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a 20 20 64 r+1], 0, 4);. d
100a0 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b 0a ata[hdr+7] = 0;.
100b0 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
100c0 5b 68 64 72 2b 35 5d 2c 20 70 42 74 2d 3e 75 73 [hdr+5], pBt->us
100d0 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 70 50 61 ableSize);. pPa
100e0 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 75 31 36 ge->nFree = (u16
100f0 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a )(pBt->usableSiz
10100 65 20 2d 20 66 69 72 73 74 29 3b 0a 20 20 64 65 e - first);. de
10110 63 6f 64 65 46 6c 61 67 73 28 70 50 61 67 65 2c codeFlags(pPage,
10120 20 66 6c 61 67 73 29 3b 0a 20 20 70 50 61 67 65 flags);. pPage
10130 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 66 ->cellOffset = f
10140 69 72 73 74 3b 0a 20 20 70 50 61 67 65 2d 3e 61 irst;. pPage->a
10150 44 61 74 61 45 6e 64 20 3d 20 26 64 61 74 61 5b DataEnd = &data[
10160 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 5d pBt->usableSize]
10170 3b 0a 20 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c ;. pPage->aCell
10180 49 64 78 20 3d 20 26 64 61 74 61 5b 66 69 72 73 Idx = &data[firs
10190 74 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 61 44 61 t];. pPage->aDa
101a0 74 61 4f 66 73 74 20 3d 20 26 64 61 74 61 5b 70 taOfst = &data[p
101b0 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 Page->childPtrSi
101c0 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 4f ze];. pPage->nO
101d0 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 61 verflow = 0;. a
101e0 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 67 65 ssert( pBt->page
101f0 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 42 74 Size>=512 && pBt
10200 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 35 33 ->pageSize<=6553
10210 36 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6d 61 6 );. pPage->ma
10220 73 6b 50 61 67 65 20 3d 20 28 75 31 36 29 28 70 skPage = (u16)(p
10230 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 31 Bt->pageSize - 1
10240 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c );. pPage->nCel
10250 6c 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e l = 0;. pPage->
10260 69 73 49 6e 69 74 20 3d 20 31 3b 0a 7d 0a 0a 0a isInit = 1;.}...
10270 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61 20 /*.** Convert a
10280 44 62 50 61 67 65 20 6f 62 74 61 69 6e 65 64 20 DbPage obtained
10290 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 69 from the pager i
102a0 6e 74 6f 20 61 20 4d 65 6d 50 61 67 65 20 75 73 nto a MemPage us
102b0 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 62 74 72 ed by.** the btr
102c0 65 65 20 6c 61 79 65 72 2e 0a 2a 2f 0a 73 74 61 ee layer..*/.sta
102d0 74 69 63 20 4d 65 6d 50 61 67 65 20 2a 62 74 72 tic MemPage *btr
102e0 65 65 50 61 67 65 46 72 6f 6d 44 62 50 61 67 65 eePageFromDbPage
102f0 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 (DbPage *pDbPage
10300 2c 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 42 74 53 , Pgno pgno, BtS
10310 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 4d hared *pBt){. M
10320 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 emPage *pPage =
10330 28 4d 65 6d 50 61 67 65 2a 29 73 71 6c 69 74 65 (MemPage*)sqlite
10340 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 3PagerGetExtra(p
10350 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 70 DbPage);. if( p
10360 67 6e 6f 21 3d 70 50 61 67 65 2d 3e 70 67 6e 6f gno!=pPage->pgno
10370 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 ){. pPage->a
10380 44 61 74 61 20 3d 20 73 71 6c 69 74 65 33 50 61 Data = sqlite3Pa
10390 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 61 gerGetData(pDbPa
103a0 67 65 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e ge);. pPage->
103b0 70 44 62 50 61 67 65 20 3d 20 70 44 62 50 61 67 pDbPage = pDbPag
103c0 65 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 42 e;. pPage->pB
103d0 74 20 3d 20 70 42 74 3b 0a 20 20 20 20 70 50 61 t = pBt;. pPa
103e0 67 65 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b ge->pgno = pgno;
103f0 0a 20 20 20 20 70 50 61 67 65 2d 3e 68 64 72 4f . pPage->hdrO
10400 66 66 73 65 74 20 3d 20 70 67 6e 6f 3d 3d 31 20 ffset = pgno==1
10410 3f 20 31 30 30 20 3a 20 30 3b 0a 20 20 7d 0a 20 ? 100 : 0;. }.
10420 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
10430 61 44 61 74 61 3d 3d 73 71 6c 69 74 65 33 50 61 aData==sqlite3Pa
10440 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 61 gerGetData(pDbPa
10450 67 65 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 ge) );. return
10460 70 50 61 67 65 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a pPage; .}../*.**
10470 20 47 65 74 20 61 20 70 61 67 65 20 66 72 6f 6d Get a page from
10480 20 74 68 65 20 70 61 67 65 72 2e 20 20 49 6e 69 the pager. Ini
10490 74 69 61 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 tialize the MemP
104a0 61 67 65 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d age.pBt and.** M
104b0 65 6d 50 61 67 65 2e 61 44 61 74 61 20 65 6c 65 emPage.aData ele
104c0 6d 65 6e 74 73 20 69 66 20 6e 65 65 64 65 64 2e ments if needed.
104d0 20 20 53 65 65 20 61 6c 73 6f 3a 20 62 74 72 65 See also: btre
104e0 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 29 eGetUnusedPage()
104f0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 50 ..**.** If the P
10500 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 AGER_GET_NOCONTE
10510 4e 54 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 NT flag is set,
10520 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 77 65 it means that we
10530 20 64 6f 20 6e 6f 74 20 63 61 72 65 0a 2a 2a 20 do not care.**
10540 61 62 6f 75 74 20 74 68 65 20 63 6f 6e 74 65 6e about the conten
10550 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 74 t of the page at
10560 20 74 68 69 73 20 74 69 6d 65 2e 20 20 53 6f 20 this time. So
10570 64 6f 20 6e 6f 74 20 67 6f 20 74 6f 20 74 68 65 do not go to the
10580 20 64 69 73 6b 0a 2a 2a 20 74 6f 20 66 65 74 63 disk.** to fetc
10590 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 2e 20 20 h the content.
105a0 4a 75 73 74 20 66 69 6c 6c 20 69 6e 20 74 68 65 Just fill in the
105b0 20 63 6f 6e 74 65 6e 74 20 77 69 74 68 20 7a 65 content with ze
105c0 72 6f 73 20 66 6f 72 20 6e 6f 77 2e 0a 2a 2a 20 ros for now..**
105d0 49 66 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 If in the future
105e0 20 77 65 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 we call sqlite3
105f0 50 61 67 65 72 57 72 69 74 65 28 29 20 6f 6e 20 PagerWrite() on
10600 74 68 69 73 20 70 61 67 65 2c 20 74 68 61 74 0a this page, that.
10610 2a 2a 20 6d 65 61 6e 73 20 77 65 20 68 61 76 65 ** means we have
10620 20 73 74 61 72 74 65 64 20 74 6f 20 62 65 20 63 started to be c
10630 6f 6e 63 65 72 6e 65 64 20 61 62 6f 75 74 20 63 oncerned about c
10640 6f 6e 74 65 6e 74 20 61 6e 64 20 74 68 65 20 64 ontent and the d
10650 69 73 6b 0a 2a 2a 20 72 65 61 64 20 73 68 6f 75 isk.** read shou
10660 6c 64 20 6f 63 63 75 72 20 61 74 20 74 68 61 74 ld occur at that
10670 20 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 point..*/.stati
10680 63 20 69 6e 74 20 62 74 72 65 65 47 65 74 50 61 c int btreeGetPa
10690 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a ge(. BtShared *
106a0 70 42 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 pBt, /* Th
106b0 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e e btree */. Pgn
106c0 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 o pgno,
106d0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 /* Number of t
106e0 68 65 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 he page to fetch
106f0 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a */. MemPage **
10700 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 ppPage, /* Re
10710 74 75 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e turn the page in
10720 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 this parameter
10730 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 */. int flags
10740 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 /* PAG
10750 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 ER_GET_NOCONTENT
10760 20 6f 72 20 50 41 47 45 52 5f 47 45 54 5f 52 45 or PAGER_GET_RE
10770 41 44 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 ADONLY */.){. i
10780 6e 74 20 72 63 3b 0a 20 20 44 62 50 61 67 65 20 nt rc;. DbPage
10790 2a 70 44 62 50 61 67 65 3b 0a 0a 20 20 61 73 73 *pDbPage;.. ass
107a0 65 72 74 28 20 66 6c 61 67 73 3d 3d 30 20 7c 7c ert( flags==0 ||
107b0 20 66 6c 61 67 73 3d 3d 50 41 47 45 52 5f 47 45 flags==PAGER_GE
107c0 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 7c 7c 20 66 T_NOCONTENT || f
107d0 6c 61 67 73 3d 3d 50 41 47 45 52 5f 47 45 54 5f lags==PAGER_GET_
107e0 52 45 41 44 4f 4e 4c 59 20 29 3b 0a 20 20 61 73 READONLY );. as
107f0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
10800 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
10810 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 73 tex) );. rc = s
10820 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
10830 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f Bt->pPager, pgno
10840 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 62 , (DbPage**)&pDb
10850 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
10860 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
10870 72 63 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 rc;. *ppPage =
10880 62 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 50 btreePageFromDbP
10890 61 67 65 28 70 44 62 50 61 67 65 2c 20 70 67 6e age(pDbPage, pgn
108a0 6f 2c 20 70 42 74 29 3b 0a 20 20 72 65 74 75 72 o, pBt);. retur
108b0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
108c0 2f 2a 0a 2a 2a 20 52 65 74 72 69 65 76 65 20 61 /*.** Retrieve a
108d0 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 70 page from the p
108e0 61 67 65 72 20 63 61 63 68 65 2e 20 49 66 20 74 ager cache. If t
108f0 68 65 20 72 65 71 75 65 73 74 65 64 20 70 61 67 he requested pag
10900 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 e is not.** alre
10910 61 64 79 20 69 6e 20 74 68 65 20 70 61 67 65 72 ady in the pager
10920 20 63 61 63 68 65 20 72 65 74 75 72 6e 20 4e 55 cache return NU
10930 4c 4c 2e 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 LL. Initialize t
10940 68 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 he MemPage.pBt a
10950 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 nd.** MemPage.aD
10960 61 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 ata elements if
10970 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 needed..*/.stati
10980 63 20 4d 65 6d 50 61 67 65 20 2a 62 74 72 65 65 c MemPage *btree
10990 50 61 67 65 4c 6f 6f 6b 75 70 28 42 74 53 68 61 PageLookup(BtSha
109a0 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 red *pBt, Pgno p
109b0 67 6e 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 2a gno){. DbPage *
109c0 70 44 62 50 61 67 65 3b 0a 20 20 61 73 73 65 72 pDbPage;. asser
109d0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
109e0 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
109f0 29 20 29 3b 0a 20 20 70 44 62 50 61 67 65 20 3d ) );. pDbPage =
10a00 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f sqlite3PagerLoo
10a10 6b 75 70 28 70 42 74 2d 3e 70 50 61 67 65 72 2c kup(pBt->pPager,
10a20 20 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 70 44 pgno);. if( pD
10a30 62 50 61 67 65 20 29 7b 0a 20 20 20 20 72 65 74 bPage ){. ret
10a40 75 72 6e 20 62 74 72 65 65 50 61 67 65 46 72 6f urn btreePageFro
10a50 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 2c mDbPage(pDbPage,
10a60 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 7d pgno, pBt);. }
10a70 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a . return 0;.}..
10a80 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
10a90 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
10aa0 61 62 61 73 65 20 66 69 6c 65 20 69 6e 20 70 61 abase file in pa
10ab0 67 65 73 2e 20 49 66 20 74 68 65 72 65 20 69 73 ges. If there is
10ac0 20 61 6e 79 20 6b 69 6e 64 20 6f 66 0a 2a 2a 20 any kind of.**
10ad0 65 72 72 6f 72 2c 20 72 65 74 75 72 6e 20 28 28 error, return ((
10ae0 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 2d 31 29 unsigned int)-1)
10af0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f ..*/.static Pgno
10b00 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 btreePagecount(
10b10 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
10b20 20 20 72 65 74 75 72 6e 20 70 42 74 2d 3e 6e 50 return pBt->nP
10b30 61 67 65 3b 0a 7d 0a 75 33 32 20 73 71 6c 69 74 age;.}.u32 sqlit
10b40 65 33 42 74 72 65 65 4c 61 73 74 50 61 67 65 28 e3BtreeLastPage(
10b50 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 61 73 73 Btree *p){. ass
10b60 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 ert( sqlite3Btre
10b70 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 eHoldsMutex(p) )
10b80 3b 0a 20 20 61 73 73 65 72 74 28 20 28 28 70 2d ;. assert( ((p-
10b90 3e 70 42 74 2d 3e 6e 50 61 67 65 29 26 30 78 38 >pBt->nPage)&0x8
10ba0 30 30 30 30 30 30 29 3d 3d 30 20 29 3b 0a 20 20 000000)==0 );.
10bb0 72 65 74 75 72 6e 20 62 74 72 65 65 50 61 67 65 return btreePage
10bc0 63 6f 75 6e 74 28 70 2d 3e 70 42 74 29 3b 0a 7d count(p->pBt);.}
10bd0 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 ../*.** Get a pa
10be0 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ge from the page
10bf0 72 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 r and initialize
10c00 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 43 it..**.** If pC
10c10 75 72 21 3d 30 20 74 68 65 6e 20 74 68 65 20 70 ur!=0 then the p
10c20 61 67 65 20 69 73 20 62 65 69 6e 67 20 66 65 74 age is being fet
10c30 63 68 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 ched as part of
10c40 61 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 0a a moveToChild().
10c50 2a 2a 20 63 61 6c 6c 2e 20 20 44 6f 20 61 64 64 ** call. Do add
10c60 69 74 69 6f 6e 61 6c 20 73 61 6e 69 74 79 20 63 itional sanity c
10c70 68 65 63 6b 69 6e 67 20 6f 6e 20 74 68 65 20 70 hecking on the p
10c80 61 67 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 age in this case
10c90 2e 0a 2a 2a 20 41 6e 64 20 69 66 20 74 68 65 20 ..** And if the
10ca0 66 65 74 63 68 20 66 61 69 6c 73 2c 20 74 68 69 fetch fails, thi
10cb0 73 20 72 6f 75 74 69 6e 65 20 6d 75 73 74 20 64 s routine must d
10cc0 65 63 72 65 6d 65 6e 74 20 70 43 75 72 2d 3e 69 ecrement pCur->i
10cd0 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 Page..**.** The
10ce0 70 61 67 65 20 69 73 20 66 65 74 63 68 65 64 20 page is fetched
10cf0 61 73 20 72 65 61 64 2d 77 72 69 74 65 20 75 6e as read-write un
10d00 6c 65 73 73 20 70 43 75 72 20 69 73 20 6e 6f 74 less pCur is not
10d10 20 4e 55 4c 4c 20 61 6e 64 20 69 73 0a 2a 2a 20 NULL and is.**
10d20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 73 a read-only curs
10d30 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 or..**.** If an
10d40 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
10d50 65 6e 20 2a 70 70 50 61 67 65 20 69 73 20 75 6e en *ppPage is un
10d60 64 65 66 69 6e 65 64 2e 20 49 74 0a 2a 2a 20 6d defined. It.** m
10d70 61 79 20 72 65 6d 61 69 6e 20 75 6e 63 68 61 6e ay remain unchan
10d80 67 65 64 2c 20 6f 72 20 69 74 20 6d 61 79 20 62 ged, or it may b
10d90 65 20 73 65 74 20 74 6f 20 61 6e 20 69 6e 76 61 e set to an inva
10da0 6c 69 64 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 lid value..*/.st
10db0 61 74 69 63 20 69 6e 74 20 67 65 74 41 6e 64 49 atic int getAndI
10dc0 6e 69 74 50 61 67 65 28 0a 20 20 42 74 53 68 61 nitPage(. BtSha
10dd0 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
10de0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
10df0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
10e00 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 */. Pgno pgno,
10e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10e20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
10e30 66 20 74 68 65 20 70 61 67 65 20 74 6f 20 67 65 f the page to ge
10e40 74 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a t */. MemPage *
10e50 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 *ppPage,
10e60 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 /* Write
10e70 74 68 65 20 70 61 67 65 20 70 6f 69 6e 74 65 72 the page pointer
10e80 20 68 65 72 65 20 2a 2f 0a 20 20 42 74 43 75 72 here */. BtCur
10e90 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 sor *pCur,
10ea0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 /* Cu
10eb0 72 73 6f 72 20 74 6f 20 72 65 63 65 69 76 65 20 rsor to receive
10ec0 74 68 65 20 70 61 67 65 2c 20 6f 72 20 4e 55 4c the page, or NUL
10ed0 4c 20 2a 2f 0a 20 20 69 6e 74 20 62 52 65 61 64 L */. int bRead
10ee0 4f 6e 6c 79 20 20 20 20 20 20 20 20 20 20 20 20 Only
10ef0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 /* True f
10f00 6f 72 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 70 or a read-only p
10f10 61 67 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 age */.){. int
10f20 72 63 3b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 rc;. DbPage *pD
10f30 62 50 61 67 65 3b 0a 20 20 61 73 73 65 72 74 28 bPage;. assert(
10f40 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
10f50 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
10f60 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
10f70 72 3d 3d 30 20 7c 7c 20 70 70 50 61 67 65 3d 3d r==0 || ppPage==
10f80 26 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 &pCur->apPage[pC
10f90 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 ur->iPage] );.
10fa0 61 73 73 65 72 74 28 20 70 43 75 72 3d 3d 30 20 assert( pCur==0
10fb0 7c 7c 20 62 52 65 61 64 4f 6e 6c 79 3d 3d 70 43 || bReadOnly==pC
10fc0 75 72 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 ur->curPagerFlag
10fd0 73 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 s );. assert( p
10fe0 43 75 72 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e Cur==0 || pCur->
10ff0 69 50 61 67 65 3e 30 20 29 3b 0a 0a 20 20 69 66 iPage>0 );.. if
11000 28 20 70 67 6e 6f 3e 62 74 72 65 65 50 61 67 65 ( pgno>btreePage
11010 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 count(pBt) ){.
11020 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
11030 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
11040 67 6f 74 6f 20 67 65 74 41 6e 64 49 6e 69 74 50 goto getAndInitP
11050 61 67 65 5f 65 72 72 6f 72 3b 0a 20 20 7d 0a 20 age_error;. }.
11060 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
11070 65 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 erGet(pBt->pPage
11080 72 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 r, pgno, (DbPage
11090 2a 2a 29 26 70 44 62 50 61 67 65 2c 20 62 52 65 **)&pDbPage, bRe
110a0 61 64 4f 6e 6c 79 29 3b 0a 20 20 69 66 28 20 72 adOnly);. if( r
110b0 63 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 67 65 c ){. goto ge
110c0 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 72 tAndInitPage_err
110d0 6f 72 3b 0a 20 20 7d 0a 20 20 2a 70 70 50 61 67 or;. }. *ppPag
110e0 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 73 71 e = (MemPage*)sq
110f0 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
11100 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 69 ra(pDbPage);. i
11110 66 28 20 28 2a 70 70 50 61 67 65 29 2d 3e 69 73 f( (*ppPage)->is
11120 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 62 Init==0 ){. b
11130 74 72 65 65 50 61 67 65 46 72 6f 6d 44 62 50 61 treePageFromDbPa
11140 67 65 28 70 44 62 50 61 67 65 2c 20 70 67 6e 6f ge(pDbPage, pgno
11150 2c 20 70 42 74 29 3b 0a 20 20 20 20 72 63 20 3d , pBt);. rc =
11160 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 2a btreeInitPage(*
11170 70 70 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 ppPage);. if(
11180 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
11190 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 {. releaseP
111a0 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 age(*ppPage);.
111b0 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 49 goto getAndI
111c0 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a 20 nitPage_error;.
111d0 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 }. }. asser
111e0 74 28 20 28 2a 70 70 50 61 67 65 29 2d 3e 70 67 t( (*ppPage)->pg
111f0 6e 6f 3d 3d 70 67 6e 6f 20 29 3b 0a 20 20 61 73 no==pgno );. as
11200 73 65 72 74 28 20 28 2a 70 70 50 61 67 65 29 2d sert( (*ppPage)-
11210 3e 61 44 61 74 61 3d 3d 73 71 6c 69 74 65 33 50 >aData==sqlite3P
11220 61 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 agerGetData(pDbP
11230 61 67 65 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 age) );.. /* If
11240 20 6f 62 74 61 69 6e 69 6e 67 20 61 20 63 68 69 obtaining a chi
11250 6c 64 20 70 61 67 65 20 66 6f 72 20 61 20 63 75 ld page for a cu
11260 72 73 6f 72 2c 20 77 65 20 6d 75 73 74 20 76 65 rsor, we must ve
11270 72 69 66 79 20 74 68 61 74 20 74 68 65 20 70 61 rify that the pa
11280 67 65 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 70 61 ge is. ** compa
11290 74 69 62 6c 65 20 77 69 74 68 20 74 68 65 20 72 tible with the r
112a0 6f 6f 74 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69 oot page. */. i
112b0 66 28 20 70 43 75 72 20 26 26 20 28 28 2a 70 70 f( pCur && ((*pp
112c0 50 61 67 65 29 2d 3e 6e 43 65 6c 6c 3c 31 20 7c Page)->nCell<1 |
112d0 7c 20 28 2a 70 70 50 61 67 65 29 2d 3e 69 6e 74 | (*ppPage)->int
112e0 4b 65 79 21 3d 70 43 75 72 2d 3e 63 75 72 49 6e Key!=pCur->curIn
112f0 74 4b 65 79 29 20 29 7b 0a 20 20 20 20 72 63 20 tKey) ){. rc
11300 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
11310 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 6c 65 61 _BKPT;. relea
11320 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b sePage(*ppPage);
11330 0a 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 . goto getAnd
11340 49 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a InitPage_error;.
11350 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
11360 49 54 45 5f 4f 4b 3b 0a 0a 67 65 74 41 6e 64 49 ITE_OK;..getAndI
11370 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3a 0a 20 nitPage_error:.
11380 20 69 66 28 20 70 43 75 72 20 29 20 70 43 75 72 if( pCur ) pCur
11390 2d 3e 69 50 61 67 65 2d 2d 3b 0a 20 20 74 65 73 ->iPage--;. tes
113a0 74 63 61 73 65 28 20 70 67 6e 6f 3d 3d 30 20 29 tcase( pgno==0 )
113b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f ;. assert( pgno
113c0 21 3d 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 !=0 || rc==SQLIT
113d0 45 5f 43 4f 52 52 55 50 54 20 29 3b 0a 20 20 72 E_CORRUPT );. r
113e0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
113f0 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 4d 65 6d ** Release a Mem
11400 50 61 67 65 2e 20 20 54 68 69 73 20 73 68 6f 75 Page. This shou
11410 6c 64 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e 63 ld be called onc
11420 65 20 66 6f 72 20 65 61 63 68 20 70 72 69 6f 72 e for each prior
11430 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 .** call to btre
11440 65 47 65 74 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 eGetPage..*/.sta
11450 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 tic void release
11460 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 4d 65 6d 50 PageNotNull(MemP
11470 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 61 age *pPage){. a
11480 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
11490 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ata );. assert(
114a0 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 pPage->pBt );.
114b0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
114c0 70 44 62 50 61 67 65 21 3d 30 20 29 3b 0a 20 20 pDbPage!=0 );.
114d0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
114e0 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 agerGetExtra(pPa
114f0 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 ge->pDbPage) ==
11500 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a (void*)pPage );.
11510 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
11520 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 50 3PagerGetData(pP
11530 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 age->pDbPage)==p
11540 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 Page->aData );.
11550 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
11560 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
11570 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
11580 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
11590 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 70 50 61 UnrefNotNull(pPa
115a0 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 7d 0a ge->pDbPage);.}.
115b0 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 static void rele
115c0 61 73 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 asePage(MemPage
115d0 2a 70 50 61 67 65 29 7b 0a 20 20 69 66 28 20 70 *pPage){. if( p
115e0 50 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 61 Page ) releasePa
115f0 67 65 4e 6f 74 4e 75 6c 6c 28 70 50 61 67 65 29 geNotNull(pPage)
11600 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 ;.}../*.** Get a
11610 6e 20 75 6e 75 73 65 64 20 70 61 67 65 2e 0a 2a n unused page..*
11620 2a 0a 2a 2a 20 54 68 69 73 20 77 6f 72 6b 73 20 *.** This works
11630 6a 75 73 74 20 6c 69 6b 65 20 62 74 72 65 65 47 just like btreeG
11640 65 74 50 61 67 65 28 29 20 77 69 74 68 20 74 68 etPage() with th
11650 65 20 61 64 64 69 74 69 6f 6e 3a 0a 2a 2a 0a 2a e addition:.**.*
11660 2a 20 20 20 2a 20 20 49 66 20 74 68 65 20 70 61 * * If the pa
11670 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e ge is already in
11680 20 75 73 65 20 66 6f 72 20 73 6f 6d 65 20 6f 74 use for some ot
11690 68 65 72 20 70 75 72 70 6f 73 65 2c 20 69 6d 6d her purpose, imm
116a0 65 64 69 61 74 65 6c 79 0a 2a 2a 20 20 20 20 20 ediately.**
116b0 20 72 65 6c 65 61 73 65 20 69 74 20 61 6e 64 20 release it and
116c0 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 49 54 45 return an SQLITE
116d0 5f 43 55 52 52 55 50 54 20 65 72 72 6f 72 2e 0a _CURRUPT error..
116e0 2a 2a 20 20 20 2a 20 20 4d 61 6b 65 20 73 75 72 ** * Make sur
116f0 65 20 74 68 65 20 69 73 49 6e 69 74 20 66 6c 61 e the isInit fla
11700 67 20 69 73 20 63 6c 65 61 72 0a 2a 2f 0a 73 74 g is clear.*/.st
11710 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 47 65 atic int btreeGe
11720 74 55 6e 75 73 65 64 50 61 67 65 28 0a 20 20 42 tUnusedPage(. B
11730 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 tShared *pBt,
11740 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 /* The btree
11750 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c */. Pgno pgno,
11760 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
11770 6d 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 mber of the page
11780 20 74 6f 20 66 65 74 63 68 20 2a 2f 0a 20 20 4d to fetch */. M
11790 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c emPage **ppPage,
117a0 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 /* Return th
117b0 65 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 70 e page in this p
117c0 61 72 61 6d 65 74 65 72 20 2a 2f 0a 20 20 69 6e arameter */. in
117d0 74 20 66 6c 61 67 73 20 20 20 20 20 20 20 20 20 t flags
117e0 20 20 20 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f /* PAGER_GET_
117f0 4e 4f 43 4f 4e 54 45 4e 54 20 6f 72 20 50 41 47 NOCONTENT or PAG
11800 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 ER_GET_READONLY
11810 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d */.){. int rc =
11820 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
11830 74 2c 20 70 67 6e 6f 2c 20 70 70 50 61 67 65 2c t, pgno, ppPage,
11840 20 66 6c 61 67 73 29 3b 0a 20 20 69 66 28 20 72 flags);. if( r
11850 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
11860 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 if( sqlite3P
11870 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 agerPageRefcount
11880 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 ((*ppPage)->pDbP
11890 61 67 65 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 age)>1 ){.
118a0 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
118b0 61 67 65 29 3b 0a 20 20 20 20 20 20 2a 70 70 50 age);. *ppP
118c0 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 age = 0;. r
118d0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
118e0 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
118f0 0a 20 20 20 20 28 2a 70 70 50 61 67 65 29 2d 3e . (*ppPage)->
11900 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 65 isInit = 0;. }e
11910 6c 73 65 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 lse{. *ppPage
11920 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 = 0;. }. retu
11930 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a rn rc;.}.../*.**
11940 20 44 75 72 69 6e 67 20 61 20 72 6f 6c 6c 62 61 During a rollba
11950 63 6b 2c 20 77 68 65 6e 20 74 68 65 20 70 61 67 ck, when the pag
11960 65 72 20 72 65 6c 6f 61 64 73 20 69 6e 66 6f 72 er reloads infor
11970 6d 61 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 mation into the
11980 63 61 63 68 65 0a 2a 2a 20 73 6f 20 74 68 61 74 cache.** so that
11990 20 74 68 65 20 63 61 63 68 65 20 69 73 20 72 65 the cache is re
119a0 73 74 6f 72 65 64 20 74 6f 20 69 74 73 20 6f 72 stored to its or
119b0 69 67 69 6e 61 6c 20 73 74 61 74 65 20 61 74 20 iginal state at
119c0 74 68 65 20 73 74 61 72 74 20 6f 66 0a 2a 2a 20 the start of.**
119d0 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c the transaction,
119e0 20 66 6f 72 20 65 61 63 68 20 70 61 67 65 20 72 for each page r
119f0 65 73 74 6f 72 65 64 20 74 68 69 73 20 72 6f 75 estored this rou
11a00 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a tine is called..
11a10 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
11a20 6e 65 20 6e 65 65 64 73 20 74 6f 20 72 65 73 65 ne needs to rese
11a30 74 20 74 68 65 20 65 78 74 72 61 20 64 61 74 61 t the extra data
11a40 20 73 65 63 74 69 6f 6e 20 61 74 20 74 68 65 20 section at the
11a50 65 6e 64 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 end of the.** pa
11a60 67 65 20 74 6f 20 61 67 72 65 65 20 77 69 74 68 ge to agree with
11a70 20 74 68 65 20 72 65 73 74 6f 72 65 64 20 64 61 the restored da
11a80 74 61 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ta..*/.static vo
11a90 69 64 20 70 61 67 65 52 65 69 6e 69 74 28 44 62 id pageReinit(Db
11aa0 50 61 67 65 20 2a 70 44 61 74 61 29 7b 0a 20 20 Page *pData){.
11ab0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a MemPage *pPage;.
11ac0 20 20 70 50 61 67 65 20 3d 20 28 4d 65 6d 50 61 pPage = (MemPa
11ad0 67 65 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 ge *)sqlite3Page
11ae0 72 47 65 74 45 78 74 72 61 28 70 44 61 74 61 29 rGetExtra(pData)
11af0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
11b00 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 63 te3PagerPageRefc
11b10 6f 75 6e 74 28 70 44 61 74 61 29 3e 30 20 29 3b ount(pData)>0 );
11b20 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 73 . if( pPage->is
11b30 49 6e 69 74 20 29 7b 0a 20 20 20 20 61 73 73 65 Init ){. asse
11b40 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
11b50 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
11b60 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 t->mutex) );.
11b70 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d pPage->isInit =
11b80 20 30 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 0;. if( sqli
11b90 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 63 te3PagerPageRefc
11ba0 6f 75 6e 74 28 70 44 61 74 61 29 3e 31 20 29 7b ount(pData)>1 ){
11bb0 0a 20 20 20 20 20 20 2f 2a 20 70 50 61 67 65 20 . /* pPage
11bc0 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 61 20 62 might not be a b
11bd0 74 72 65 65 20 70 61 67 65 3b 20 20 69 74 20 6d tree page; it m
11be0 69 67 68 74 20 62 65 20 61 6e 20 6f 76 65 72 66 ight be an overf
11bf0 6c 6f 77 20 70 61 67 65 0a 20 20 20 20 20 20 2a low page. *
11c00 2a 20 6f 72 20 70 74 72 6d 61 70 20 70 61 67 65 * or ptrmap page
11c10 20 6f 72 20 61 20 66 72 65 65 20 70 61 67 65 2e or a free page.
11c20 20 20 49 6e 20 74 68 6f 73 65 20 63 61 73 65 73 In those cases
11c30 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a , the following.
11c40 20 20 20 20 20 20 2a 2a 20 63 61 6c 6c 20 74 6f ** call to
11c50 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 btreeInitPage()
11c60 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 72 65 74 will likely ret
11c70 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
11c80 50 54 2e 0a 20 20 20 20 20 20 2a 2a 20 42 75 74 PT.. ** But
11c90 20 6e 6f 20 68 61 72 6d 20 69 73 20 64 6f 6e 65 no harm is done
11ca0 20 62 79 20 74 68 69 73 2e 20 20 41 6e 64 20 69 by this. And i
11cb0 74 20 69 73 20 76 65 72 79 20 69 6d 70 6f 72 74 t is very import
11cc0 61 6e 74 20 74 68 61 74 0a 20 20 20 20 20 20 2a ant that. *
11cd0 2a 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 * btreeInitPage(
11ce0 29 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e 20 65 ) be called on e
11cf0 76 65 72 79 20 62 74 72 65 65 20 70 61 67 65 20 very btree page
11d00 73 6f 20 77 65 20 6d 61 6b 65 0a 20 20 20 20 20 so we make.
11d10 20 2a 2a 20 74 68 65 20 63 61 6c 6c 20 66 6f 72 ** the call for
11d20 20 65 76 65 72 79 20 70 61 67 65 20 74 68 61 74 every page that
11d30 20 63 6f 6d 65 73 20 69 6e 20 66 6f 72 20 72 65 comes in for re
11d40 2d 69 6e 69 74 69 6e 67 2e 20 2a 2f 0a 20 20 20 -initing. */.
11d50 20 20 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 btreeInitPage
11d60 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 (pPage);. }.
11d70 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f }.}../*.** Invo
11d80 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 ke the busy hand
11d90 6c 65 72 20 66 6f 72 20 61 20 62 74 72 65 65 2e ler for a btree.
11da0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 .*/.static int b
11db0 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 61 treeInvokeBusyHa
11dc0 6e 64 6c 65 72 28 76 6f 69 64 20 2a 70 41 72 67 ndler(void *pArg
11dd0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
11de0 42 74 20 3d 20 28 42 74 53 68 61 72 65 64 2a 29 Bt = (BtShared*)
11df0 70 41 72 67 3b 0a 20 20 61 73 73 65 72 74 28 20 pArg;. assert(
11e00 70 42 74 2d 3e 64 62 20 29 3b 0a 20 20 61 73 73 pBt->db );. ass
11e10 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
11e20 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 64 62 2d ex_held(pBt->db-
11e30 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 65 74 >mutex) );. ret
11e40 75 72 6e 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b urn sqlite3Invok
11e50 65 42 75 73 79 48 61 6e 64 6c 65 72 28 26 70 42 eBusyHandler(&pB
11e60 74 2d 3e 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c t->db->busyHandl
11e70 65 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 er);.}../*.** Op
11e80 65 6e 20 61 20 64 61 74 61 62 61 73 65 20 66 69 en a database fi
11e90 6c 65 2e 0a 2a 2a 20 0a 2a 2a 20 7a 46 69 6c 65 le..** .** zFile
11ea0 6e 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 name is the name
11eb0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
11ec0 20 66 69 6c 65 2e 20 20 49 66 20 7a 46 69 6c 65 file. If zFile
11ed0 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 0a 2a 2a 20 name is NULL.**
11ee0 74 68 65 6e 20 61 6e 20 65 70 68 65 6d 65 72 61 then an ephemera
11ef0 6c 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 l database is cr
11f00 65 61 74 65 64 2e 20 20 54 68 65 20 65 70 68 65 eated. The ephe
11f10 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 20 6d meral database m
11f20 69 67 68 74 0a 2a 2a 20 62 65 20 65 78 63 6c 75 ight.** be exclu
11f30 73 69 76 65 6c 79 20 69 6e 20 6d 65 6d 6f 72 79 sively in memory
11f40 2c 20 6f 72 20 69 74 20 6d 69 67 68 74 20 75 73 , or it might us
11f50 65 20 61 20 64 69 73 6b 2d 62 61 73 65 64 20 6d e a disk-based m
11f60 65 6d 6f 72 79 20 63 61 63 68 65 2e 0a 2a 2a 20 emory cache..**
11f70 45 69 74 68 65 72 20 77 61 79 2c 20 74 68 65 20 Either way, the
11f80 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 ephemeral databa
11f90 73 65 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d se will be autom
11fa0 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 atically deleted
11fb0 20 0a 2a 2a 20 77 68 65 6e 20 73 71 6c 69 74 65 .** when sqlite
11fc0 33 42 74 72 65 65 43 6c 6f 73 65 28 29 20 69 73 3BtreeClose() is
11fd0 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 called..**.** I
11fe0 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 22 f zFilename is "
11ff0 3a 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e 20 61 :memory:" then a
12000 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 n in-memory data
12010 62 61 73 65 20 69 73 20 63 72 65 61 74 65 64 0a base is created.
12020 2a 2a 20 74 68 61 74 20 69 73 20 61 75 74 6f 6d ** that is autom
12030 61 74 69 63 61 6c 6c 79 20 64 65 73 74 72 6f 79 atically destroy
12040 65 64 20 77 68 65 6e 20 69 74 20 69 73 20 63 6c ed when it is cl
12050 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 osed..**.** The
12060 22 66 6c 61 67 73 22 20 70 61 72 61 6d 65 74 65 "flags" paramete
12070 72 20 69 73 20 61 20 62 69 74 6d 61 73 6b 20 74 r is a bitmask t
12080 68 61 74 20 6d 69 67 68 74 20 63 6f 6e 74 61 69 hat might contai
12090 6e 20 62 69 74 73 20 6c 69 6b 65 0a 2a 2a 20 42 n bits like.** B
120a0 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 TREE_OMIT_JOURNA
120b0 4c 20 61 6e 64 2f 6f 72 20 42 54 52 45 45 5f 4d L and/or BTREE_M
120c0 45 4d 4f 52 59 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 EMORY..**.** If
120d0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
120e0 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20 69 already opened i
120f0 6e 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 n the same datab
12100 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a ase connection.*
12110 2a 20 61 6e 64 20 77 65 20 61 72 65 20 69 6e 20 * and we are in
12120 73 68 61 72 65 64 20 63 61 63 68 65 20 6d 6f 64 shared cache mod
12130 65 2c 20 74 68 65 6e 20 74 68 65 20 6f 70 65 6e e, then the open
12140 20 77 69 6c 6c 20 66 61 69 6c 20 77 69 74 68 20 will fail with
12150 61 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e an.** SQLITE_CON
12160 53 54 52 41 49 4e 54 20 65 72 72 6f 72 2e 20 20 STRAINT error.
12170 57 65 20 63 61 6e 6e 6f 74 20 61 6c 6c 6f 77 20 We cannot allow
12180 74 77 6f 20 6f 72 20 6d 6f 72 65 20 42 74 53 68 two or more BtSh
12190 61 72 65 64 0a 2a 2a 20 6f 62 6a 65 63 74 73 20 ared.** objects
121a0 69 6e 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 in the same data
121b0 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
121c0 73 69 6e 63 65 20 64 6f 69 6e 67 20 73 6f 20 77 since doing so w
121d0 69 6c 6c 20 6c 65 61 64 0a 2a 2a 20 74 6f 20 70 ill lead.** to p
121e0 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 6c 6f 63 roblems with loc
121f0 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c king..*/.int sql
12200 69 74 65 33 42 74 72 65 65 4f 70 65 6e 28 0a 20 ite3BtreeOpen(.
12210 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 sqlite3_vfs *pV
12220 66 73 2c 20 20 20 20 20 20 2f 2a 20 56 46 53 20 fs, /* VFS
12230 74 6f 20 75 73 65 20 66 6f 72 20 74 68 69 73 20 to use for this
12240 62 2d 74 72 65 65 20 2a 2f 0a 20 20 63 6f 6e 73 b-tree */. cons
12250 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d t char *zFilenam
12260 65 2c 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 e, /* Name of t
12270 68 65 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 he file containi
12280 6e 67 20 74 68 65 20 42 54 72 65 65 20 64 61 74 ng the BTree dat
12290 61 62 61 73 65 20 2a 2f 0a 20 20 73 71 6c 69 74 abase */. sqlit
122a0 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 e3 *db,
122b0 20 20 20 2f 2a 20 41 73 73 6f 63 69 61 74 65 64 /* Associated
122c0 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
122d0 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 70 */. Btree **pp
122e0 42 74 72 65 65 2c 20 20 20 20 20 20 20 20 2f 2a Btree, /*
122f0 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 Pointer to new
12300 42 74 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69 Btree object wri
12310 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 69 tten here */. i
12320 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 nt flags,
12330 20 20 20 20 20 20 20 2f 2a 20 4f 70 74 69 6f 6e /* Option
12340 73 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c s */. int vfsFl
12350 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 2f ags /
12360 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
12370 68 72 6f 75 67 68 20 74 6f 20 73 71 6c 69 74 65 hrough to sqlite
12380 33 5f 76 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 3_vfs.xOpen() */
12390 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a .){. BtShared *
123a0 70 42 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20 pBt = 0;
123b0 20 20 20 20 20 2f 2a 20 53 68 61 72 65 64 20 70 /* Shared p
123c0 61 72 74 20 6f 66 20 62 74 72 65 65 20 73 74 72 art of btree str
123d0 75 63 74 75 72 65 20 2a 2f 0a 20 20 42 74 72 65 ucture */. Btre
123e0 65 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 e *p;
123f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 /* Ha
12400 6e 64 6c 65 20 74 6f 20 72 65 74 75 72 6e 20 2a ndle to return *
12410 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 /. sqlite3_mute
12420 78 20 2a 6d 75 74 65 78 4f 70 65 6e 20 3d 20 30 x *mutexOpen = 0
12430 3b 20 20 2f 2a 20 50 72 65 76 65 6e 74 73 20 61 ; /* Prevents a
12440 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 2e race condition.
12450 20 54 69 63 6b 65 74 20 23 33 35 33 37 20 2a 2f Ticket #3537 */
12460 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
12470 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 TE_OK;
12480 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 /* Result code
12490 20 66 72 6f 6d 20 74 68 69 73 20 66 75 6e 63 74 from this funct
124a0 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 6e 52 65 73 ion */. u8 nRes
124b0 65 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 erve;
124c0 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 20 /* Byte
124d0 6f 66 20 75 6e 75 73 65 64 20 73 70 61 63 65 20 of unused space
124e0 6f 6e 20 65 61 63 68 20 70 61 67 65 20 2a 2f 0a on each page */.
124f0 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
12500 7a 44 62 48 65 61 64 65 72 5b 31 30 30 5d 3b 20 zDbHeader[100];
12510 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 65 61 /* Database hea
12520 64 65 72 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 0a der content */..
12530 20 20 2f 2a 20 54 72 75 65 20 69 66 20 6f 70 65 /* True if ope
12540 6e 69 6e 67 20 61 6e 20 65 70 68 65 6d 65 72 61 ning an ephemera
12550 6c 2c 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 l, temporary dat
12560 61 62 61 73 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 abase */. const
12570 20 69 6e 74 20 69 73 54 65 6d 70 44 62 20 3d 20 int isTempDb =
12580 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 zFilename==0 ||
12590 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 30 3b zFilename[0]==0;
125a0 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 76 .. /* Set the v
125b0 61 72 69 61 62 6c 65 20 69 73 4d 65 6d 64 62 20 ariable isMemdb
125c0 74 6f 20 74 72 75 65 20 66 6f 72 20 61 6e 20 69 to true for an i
125d0 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
125e0 65 2c 20 6f 72 20 0a 20 20 2a 2a 20 66 61 6c 73 e, or . ** fals
125f0 65 20 66 6f 72 20 61 20 66 69 6c 65 2d 62 61 73 e for a file-bas
12600 65 64 20 64 61 74 61 62 61 73 65 2e 0a 20 20 2a ed database.. *
12610 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
12620 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 20 20 OMIT_MEMORYDB.
12630 63 6f 6e 73 74 20 69 6e 74 20 69 73 4d 65 6d 64 const int isMemd
12640 62 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 20 20 63 b = 0;.#else. c
12650 6f 6e 73 74 20 69 6e 74 20 69 73 4d 65 6d 64 62 onst int isMemdb
12660 20 3d 20 28 7a 46 69 6c 65 6e 61 6d 65 20 26 26 = (zFilename &&
12670 20 73 74 72 63 6d 70 28 7a 46 69 6c 65 6e 61 6d strcmp(zFilenam
12680 65 2c 20 22 3a 6d 65 6d 6f 72 79 3a 22 29 3d 3d e, ":memory:")==
12690 30 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 0).
126a0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 28 69 73 || (is
126b0 54 65 6d 70 44 62 20 26 26 20 73 71 6c 69 74 65 TempDb && sqlite
126c0 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 64 62 3TempInMemory(db
126d0 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )).
126e0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 28 76 66 || (vf
126f0 73 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f sFlags & SQLITE_
12700 4f 50 45 4e 5f 4d 45 4d 4f 52 59 29 21 3d 30 3b OPEN_MEMORY)!=0;
12710 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
12720 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20 61 73 t( db!=0 );. as
12730 73 65 72 74 28 20 70 56 66 73 21 3d 30 20 29 3b sert( pVfs!=0 );
12740 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
12750 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 e3_mutex_held(db
12760 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
12770 73 65 72 74 28 20 28 66 6c 61 67 73 26 30 78 66 sert( (flags&0xf
12780 66 29 3d 3d 66 6c 61 67 73 20 29 3b 20 20 20 2f f)==flags ); /
12790 2a 20 66 6c 61 67 73 20 66 69 74 20 69 6e 20 38 * flags fit in 8
127a0 20 62 69 74 73 20 2a 2f 0a 0a 20 20 2f 2a 20 4f bits */.. /* O
127b0 6e 6c 79 20 61 20 42 54 52 45 45 5f 53 49 4e 47 nly a BTREE_SING
127c0 4c 45 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 LE database can
127d0 62 65 20 42 54 52 45 45 5f 55 4e 4f 52 44 45 52 be BTREE_UNORDER
127e0 45 44 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 ED */. assert(
127f0 28 66 6c 61 67 73 20 26 20 42 54 52 45 45 5f 55 (flags & BTREE_U
12800 4e 4f 52 44 45 52 45 44 29 3d 3d 30 20 7c 7c 20 NORDERED)==0 ||
12810 28 66 6c 61 67 73 20 26 20 42 54 52 45 45 5f 53 (flags & BTREE_S
12820 49 4e 47 4c 45 29 21 3d 30 20 29 3b 0a 0a 20 20 INGLE)!=0 );..
12830 2f 2a 20 41 20 42 54 52 45 45 5f 53 49 4e 47 4c /* A BTREE_SINGL
12840 45 20 64 61 74 61 62 61 73 65 20 69 73 20 61 6c E database is al
12850 77 61 79 73 20 61 20 74 65 6d 70 6f 72 61 72 79 ways a temporary
12860 20 61 6e 64 2f 6f 72 20 65 70 68 65 6d 65 72 61 and/or ephemera
12870 6c 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 l */. assert( (
12880 66 6c 61 67 73 20 26 20 42 54 52 45 45 5f 53 49 flags & BTREE_SI
12890 4e 47 4c 45 29 3d 3d 30 20 7c 7c 20 69 73 54 65 NGLE)==0 || isTe
128a0 6d 70 44 62 20 29 3b 0a 0a 20 20 69 66 28 20 69 mpDb );.. if( i
128b0 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 66 6c sMemdb ){. fl
128c0 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4d 45 4d ags |= BTREE_MEM
128d0 4f 52 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 28 ORY;. }. if( (
128e0 76 66 73 46 6c 61 67 73 20 26 20 53 51 4c 49 54 vfsFlags & SQLIT
128f0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 21 E_OPEN_MAIN_DB)!
12900 3d 30 20 26 26 20 28 69 73 4d 65 6d 64 62 20 7c =0 && (isMemdb |
12910 7c 20 69 73 54 65 6d 70 44 62 29 20 29 7b 0a 20 | isTempDb) ){.
12920 20 20 20 76 66 73 46 6c 61 67 73 20 3d 20 28 76 vfsFlags = (v
12930 66 73 46 6c 61 67 73 20 26 20 7e 53 51 4c 49 54 fsFlags & ~SQLIT
12940 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 20 E_OPEN_MAIN_DB)
12950 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 | SQLITE_OPEN_TE
12960 4d 50 5f 44 42 3b 0a 20 20 7d 0a 20 20 70 20 3d MP_DB;. }. p =
12970 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 sqlite3MallocZe
12980 72 6f 28 73 69 7a 65 6f 66 28 42 74 72 65 65 29 ro(sizeof(Btree)
12990 29 3b 0a 20 20 69 66 28 20 21 70 20 29 7b 0a 20 );. if( !p ){.
129a0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
129b0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d _NOMEM_BKPT;. }
129c0 0a 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 . p->inTrans =
129d0 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 70 2d TRANS_NONE;. p-
129e0 3e 64 62 20 3d 20 64 62 3b 0a 23 69 66 6e 64 65 >db = db;.#ifnde
129f0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 f SQLITE_OMIT_SH
12a00 41 52 45 44 5f 43 41 43 48 45 0a 20 20 70 2d 3e ARED_CACHE. p->
12a10 6c 6f 63 6b 2e 70 42 74 72 65 65 20 3d 20 70 3b lock.pBtree = p;
12a20 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 62 6c . p->lock.iTabl
12a30 65 20 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 0a 23 e = 1;.#endif..#
12a40 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
12a50 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
12a60 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e 65 ACHE) && !define
12a70 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 d(SQLITE_OMIT_DI
12a80 53 4b 49 4f 29 0a 20 20 2f 2a 0a 20 20 2a 2a 20 SKIO). /*. **
12a90 49 66 20 74 68 69 73 20 42 74 72 65 65 20 69 73 If this Btree is
12aa0 20 61 20 63 61 6e 64 69 64 61 74 65 20 66 6f 72 a candidate for
12ab0 20 73 68 61 72 65 64 20 63 61 63 68 65 2c 20 74 shared cache, t
12ac0 72 79 20 74 6f 20 66 69 6e 64 20 61 6e 0a 20 20 ry to find an.
12ad0 2a 2a 20 65 78 69 73 74 69 6e 67 20 42 74 53 68 ** existing BtSh
12ae0 61 72 65 64 20 6f 62 6a 65 63 74 20 74 68 61 74 ared object that
12af0 20 77 65 20 63 61 6e 20 73 68 61 72 65 20 77 69 we can share wi
12b00 74 68 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 73 th. */. if( is
12b10 54 65 6d 70 44 62 3d 3d 30 20 26 26 20 28 69 73 TempDb==0 && (is
12b20 4d 65 6d 64 62 3d 3d 30 20 7c 7c 20 28 76 66 73 Memdb==0 || (vfs
12b30 46 6c 61 67 73 26 53 51 4c 49 54 45 5f 4f 50 45 Flags&SQLITE_OPE
12b40 4e 5f 55 52 49 29 21 3d 30 29 20 29 7b 0a 20 20 N_URI)!=0) ){.
12b50 20 20 69 66 28 20 76 66 73 46 6c 61 67 73 20 26 if( vfsFlags &
12b60 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 SQLITE_OPEN_SHA
12b70 52 45 44 43 41 43 48 45 20 29 7b 0a 20 20 20 20 REDCACHE ){.
12b80 20 20 69 6e 74 20 6e 46 69 6c 65 6e 61 6d 65 20 int nFilename
12b90 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
12ba0 30 28 7a 46 69 6c 65 6e 61 6d 65 29 2b 31 3b 0a 0(zFilename)+1;.
12bb0 20 20 20 20 20 20 69 6e 74 20 6e 46 75 6c 6c 50 int nFullP
12bc0 61 74 68 6e 61 6d 65 20 3d 20 70 56 66 73 2d 3e athname = pVfs->
12bd0 6d 78 50 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 mxPathname+1;.
12be0 20 20 20 20 63 68 61 72 20 2a 7a 46 75 6c 6c 50 char *zFullP
12bf0 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 athname = sqlite
12c00 33 4d 61 6c 6c 6f 63 28 4d 41 58 28 6e 46 75 6c 3Malloc(MAX(nFul
12c10 6c 50 61 74 68 6e 61 6d 65 2c 6e 46 69 6c 65 6e lPathname,nFilen
12c20 61 6d 65 29 29 3b 0a 20 20 20 20 20 20 4d 55 54 ame));. MUT
12c30 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 EX_LOGIC( sqlite
12c40 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 3_mutex *mutexSh
12c50 61 72 65 64 3b 20 29 0a 0a 20 20 20 20 20 20 70 ared; ).. p
12c60 2d 3e 73 68 61 72 61 62 6c 65 20 3d 20 31 3b 0a ->sharable = 1;.
12c70 20 20 20 20 20 20 69 66 28 20 21 7a 46 75 6c 6c if( !zFull
12c80 50 61 74 68 6e 61 6d 65 20 29 7b 0a 20 20 20 20 Pathname ){.
12c90 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
12ca0 28 70 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 (p);. ret
12cb0 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
12cc0 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 0a 20 _BKPT;. }.
12cd0 20 20 20 20 20 69 66 28 20 69 73 4d 65 6d 64 62 if( isMemdb
12ce0 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 ){. memc
12cf0 70 79 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 py(zFullPathname
12d00 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 6e 46 69 , zFilename, nFi
12d10 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 7d lename);. }
12d20 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 else{. rc
12d30 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c = sqlite3OsFull
12d40 50 61 74 68 6e 61 6d 65 28 70 56 66 73 2c 20 7a Pathname(pVfs, z
12d50 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 Filename,.
12d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12d70 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 46 75 nFu
12d80 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 7a 46 75 6c llPathname, zFul
12d90 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 lPathname);.
12da0 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
12db0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
12dc0 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 free(zFullPathna
12dd0 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 me);. s
12de0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
12df0 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
12e00 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 rc;. }.
12e10 20 20 20 20 20 7d 0a 23 69 66 20 53 51 4c 49 54 }.#if SQLIT
12e20 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 20 E_THREADSAFE.
12e30 20 20 20 6d 75 74 65 78 4f 70 65 6e 20 3d 20 73 mutexOpen = s
12e40 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
12e50 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 (SQLITE_MUTEX_ST
12e60 41 54 49 43 5f 4f 50 45 4e 29 3b 0a 20 20 20 20 ATIC_OPEN);.
12e70 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
12e80 65 6e 74 65 72 28 6d 75 74 65 78 4f 70 65 6e 29 enter(mutexOpen)
12e90 3b 0a 20 20 20 20 20 20 6d 75 74 65 78 53 68 61 ;. mutexSha
12ea0 72 65 64 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 red = sqlite3Mut
12eb0 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
12ec0 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 UTEX_STATIC_MAST
12ed0 45 52 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ER);. sqlit
12ee0 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d e3_mutex_enter(m
12ef0 75 74 65 78 53 68 61 72 65 64 29 3b 0a 23 65 6e utexShared);.#en
12f00 64 69 66 0a 20 20 20 20 20 20 66 6f 72 28 70 42 dif. for(pB
12f10 74 3d 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 t=GLOBAL(BtShare
12f20 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 d*,sqlite3Shared
12f30 43 61 63 68 65 4c 69 73 74 29 3b 20 70 42 74 3b CacheList); pBt;
12f40 20 70 42 74 3d 70 42 74 2d 3e 70 4e 65 78 74 29 pBt=pBt->pNext)
12f50 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
12f60 28 20 70 42 74 2d 3e 6e 52 65 66 3e 30 20 29 3b ( pBt->nRef>0 );
12f70 0a 20 20 20 20 20 20 20 20 69 66 28 20 30 3d 3d . if( 0==
12f80 73 74 72 63 6d 70 28 7a 46 75 6c 6c 50 61 74 68 strcmp(zFullPath
12f90 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33 50 61 67 name, sqlite3Pag
12fa0 65 72 46 69 6c 65 6e 61 6d 65 28 70 42 74 2d 3e erFilename(pBt->
12fb0 70 50 61 67 65 72 2c 20 30 29 29 0a 20 20 20 20 pPager, 0)).
12fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 &&
12fd0 73 71 6c 69 74 65 33 50 61 67 65 72 56 66 73 28 sqlite3PagerVfs(
12fe0 70 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d 70 56 pBt->pPager)==pV
12ff0 66 73 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 fs ){.
13000 69 6e 74 20 69 44 62 3b 0a 20 20 20 20 20 20 20 int iDb;.
13010 20 20 20 66 6f 72 28 69 44 62 3d 64 62 2d 3e 6e for(iDb=db->n
13020 44 62 2d 31 3b 20 69 44 62 3e 3d 30 3b 20 69 44 Db-1; iDb>=0; iD
13030 62 2d 2d 29 7b 0a 20 20 20 20 20 20 20 20 20 20 b--){.
13040 20 20 42 74 72 65 65 20 2a 70 45 78 69 73 74 69 Btree *pExisti
13050 6e 67 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 ng = db->aDb[iDb
13060 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 20 ].pBt;.
13070 20 20 20 69 66 28 20 70 45 78 69 73 74 69 6e 67 if( pExisting
13080 20 26 26 20 70 45 78 69 73 74 69 6e 67 2d 3e 70 && pExisting->p
13090 42 74 3d 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 Bt==pBt ){.
130a0 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
130b0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 _mutex_leave(mut
130c0 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 20 exShared);.
130d0 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
130e0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 _mutex_leave(mut
130f0 65 78 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 20 exOpen);.
13100 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
13110 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d ree(zFullPathnam
13120 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
13130 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
13140 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 );.
13150 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
13160 4f 4e 53 54 52 41 49 4e 54 3b 0a 20 20 20 20 20 ONSTRAINT;.
13170 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
13180 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 }. p
13190 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 20 ->pBt = pBt;.
131a0 20 20 20 20 20 20 20 70 42 74 2d 3e 6e 52 65 66 pBt->nRef
131b0 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 ++;. br
131c0 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 eak;. }.
131d0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
131e0 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
131f0 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 (mutexShared);.
13200 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
13210 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 e(zFullPathname)
13220 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 53 ;. }.#ifdef S
13230 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 QLITE_DEBUG.
13240 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 49 else{. /* I
13250 6e 20 64 65 62 75 67 20 6d 6f 64 65 2c 20 77 65 n debug mode, we
13260 20 6d 61 72 6b 20 61 6c 6c 20 70 65 72 73 69 73 mark all persis
13270 74 65 6e 74 20 64 61 74 61 62 61 73 65 73 20 61 tent databases a
13280 73 20 73 68 61 72 61 62 6c 65 0a 20 20 20 20 20 s sharable.
13290 20 2a 2a 20 65 76 65 6e 20 77 68 65 6e 20 74 68 ** even when th
132a0 65 79 20 61 72 65 20 6e 6f 74 2e 20 20 54 68 69 ey are not. Thi
132b0 73 20 65 78 65 72 63 69 73 65 73 20 74 68 65 20 s exercises the
132c0 6c 6f 63 6b 69 6e 67 20 63 6f 64 65 20 61 6e 64 locking code and
132d0 0a 20 20 20 20 20 20 2a 2a 20 67 69 76 65 73 20 . ** gives
132e0 6d 6f 72 65 20 6f 70 70 6f 72 74 75 6e 69 74 79 more opportunity
132f0 20 66 6f 72 20 61 73 73 65 72 74 73 28 73 71 6c for asserts(sql
13300 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
13310 29 29 0a 20 20 20 20 20 20 2a 2a 20 73 74 61 74 )). ** stat
13320 65 6d 65 6e 74 73 20 74 6f 20 66 69 6e 64 20 6c ements to find l
13330 6f 63 6b 69 6e 67 20 70 72 6f 62 6c 65 6d 73 2e ocking problems.
13340 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
13350 70 2d 3e 73 68 61 72 61 62 6c 65 20 3d 20 31 3b p->sharable = 1;
13360 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
13370 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 }.#endif. if( p
13380 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 0a Bt==0 ){. /*.
13390 20 20 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ** The follo
133a0 77 69 6e 67 20 61 73 73 65 72 74 73 20 6d 61 6b wing asserts mak
133b0 65 20 73 75 72 65 20 74 68 61 74 20 73 74 72 75 e sure that stru
133c0 63 74 75 72 65 73 20 75 73 65 64 20 62 79 20 74 ctures used by t
133d0 68 65 20 62 74 72 65 65 20 61 72 65 0a 20 20 20 he btree are.
133e0 20 2a 2a 20 74 68 65 20 72 69 67 68 74 20 73 69 ** the right si
133f0 7a 65 2e 20 20 54 68 69 73 20 69 73 20 74 6f 20 ze. This is to
13400 67 75 61 72 64 20 61 67 61 69 6e 73 74 20 73 69 guard against si
13410 7a 65 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 ze changes that
13420 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a 20 77 68 result. ** wh
13430 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 6f 6e 20 en compiling on
13440 61 20 64 69 66 66 65 72 65 6e 74 20 61 72 63 68 a different arch
13450 69 74 65 63 74 75 72 65 2e 0a 20 20 20 20 2a 2f itecture.. */
13460 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a . assert( siz
13470 65 6f 66 28 69 36 34 29 3d 3d 38 20 29 3b 0a 20 eof(i64)==8 );.
13480 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f assert( sizeo
13490 66 28 75 36 34 29 3d 3d 38 20 29 3b 0a 20 20 20 f(u64)==8 );.
134a0 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 assert( sizeof(
134b0 75 33 32 29 3d 3d 34 20 29 3b 0a 20 20 20 20 61 u32)==4 );. a
134c0 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 75 31 ssert( sizeof(u1
134d0 36 29 3d 3d 32 20 29 3b 0a 20 20 20 20 61 73 73 6)==2 );. ass
134e0 65 72 74 28 20 73 69 7a 65 6f 66 28 50 67 6e 6f ert( sizeof(Pgno
134f0 29 3d 3d 34 20 29 3b 0a 20 20 0a 20 20 20 20 70 )==4 );. . p
13500 42 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c Bt = sqlite3Mall
13510 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 2a ocZero( sizeof(*
13520 70 42 74 29 20 29 3b 0a 20 20 20 20 69 66 28 20 pBt) );. if(
13530 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 pBt==0 ){.
13540 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
13550 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f M_BKPT;. go
13560 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 to btree_open_ou
13570 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 t;. }. rc
13580 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 = sqlite3PagerOp
13590 65 6e 28 70 56 66 73 2c 20 26 70 42 74 2d 3e 70 en(pVfs, &pBt->p
135a0 50 61 67 65 72 2c 20 7a 46 69 6c 65 6e 61 6d 65 Pager, zFilename
135b0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
135c0 20 20 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 size
135d0 6f 66 28 4d 65 6d 50 61 67 65 29 2c 20 66 6c 61 of(MemPage), fla
135e0 67 73 2c 20 76 66 73 46 6c 61 67 73 2c 20 70 61 gs, vfsFlags, pa
135f0 67 65 52 65 69 6e 69 74 29 3b 0a 20 20 20 20 69 geReinit);. i
13600 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
13610 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
13620 33 50 61 67 65 72 53 65 74 4d 6d 61 70 4c 69 6d 3PagerSetMmapLim
13630 69 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 it(pBt->pPager,
13640 64 62 2d 3e 73 7a 4d 6d 61 70 29 3b 0a 20 20 20 db->szMmap);.
13650 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
13660 61 67 65 72 52 65 61 64 46 69 6c 65 68 65 61 64 agerReadFilehead
13670 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 73 er(pBt->pPager,s
13680 69 7a 65 6f 66 28 7a 44 62 48 65 61 64 65 72 29 izeof(zDbHeader)
13690 2c 7a 44 62 48 65 61 64 65 72 29 3b 0a 20 20 20 ,zDbHeader);.
136a0 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 }. if( rc!=S
136b0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
136c0 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 65 goto btree_ope
136d0 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 n_out;. }.
136e0 20 70 42 74 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 pBt->openFlags
136f0 3d 20 28 75 38 29 66 6c 61 67 73 3b 0a 20 20 20 = (u8)flags;.
13700 20 70 42 74 2d 3e 64 62 20 3d 20 64 62 3b 0a 20 pBt->db = db;.
13710 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
13720 65 74 42 75 73 79 68 61 6e 64 6c 65 72 28 70 42 etBusyhandler(pB
13730 74 2d 3e 70 50 61 67 65 72 2c 20 62 74 72 65 65 t->pPager, btree
13740 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
13750 72 2c 20 70 42 74 29 3b 0a 20 20 20 20 70 2d 3e r, pBt);. p->
13760 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 0a 20 20 pBt = pBt;. .
13770 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 3d pBt->pCursor =
13780 20 30 3b 0a 20 20 20 20 70 42 74 2d 3e 70 50 61 0;. pBt->pPa
13790 67 65 31 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 ge1 = 0;. if(
137a0 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 72 sqlite3PagerIsr
137b0 65 61 64 6f 6e 6c 79 28 70 42 74 2d 3e 70 50 61 eadonly(pBt->pPa
137c0 67 65 72 29 20 29 20 70 42 74 2d 3e 62 74 73 46 ger) ) pBt->btsF
137d0 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 lags |= BTS_READ
137e0 5f 4f 4e 4c 59 3b 0a 23 69 66 64 65 66 20 53 51 _ONLY;.#ifdef SQ
137f0 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45 4c 45 LITE_SECURE_DELE
13800 54 45 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 TE. pBt->btsF
13810 6c 61 67 73 20 7c 3d 20 42 54 53 5f 53 45 43 55 lags |= BTS_SECU
13820 52 45 5f 44 45 4c 45 54 45 3b 0a 23 65 6e 64 69 RE_DELETE;.#endi
13830 66 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 f. /* EVIDENC
13840 45 2d 4f 46 3a 20 52 2d 35 31 38 37 33 2d 33 39 E-OF: R-51873-39
13850 36 31 38 20 54 68 65 20 70 61 67 65 20 73 69 7a 618 The page siz
13860 65 20 66 6f 72 20 61 20 64 61 74 61 62 61 73 65 e for a database
13870 20 66 69 6c 65 20 69 73 0a 20 20 20 20 2a 2a 20 file is. **
13880 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
13890 65 20 32 2d 62 79 74 65 20 69 6e 74 65 67 65 72 e 2-byte integer
138a0 20 6c 6f 63 61 74 65 64 20 61 74 20 61 6e 20 6f located at an o
138b0 66 66 73 65 74 20 6f 66 20 31 36 20 62 79 74 65 ffset of 16 byte
138c0 73 20 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 74 68 s from. ** th
138d0 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 e beginning of t
138e0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
138f0 2e 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 70 61 . */. pBt->pa
13900 67 65 53 69 7a 65 20 3d 20 28 7a 44 62 48 65 61 geSize = (zDbHea
13910 64 65 72 5b 31 36 5d 3c 3c 38 29 20 7c 20 28 7a der[16]<<8) | (z
13920 44 62 48 65 61 64 65 72 5b 31 37 5d 3c 3c 31 36 DbHeader[17]<<16
13930 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e );. if( pBt->
13940 70 61 67 65 53 69 7a 65 3c 35 31 32 20 7c 7c 20 pageSize<512 ||
13950 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 53 51 pBt->pageSize>SQ
13960 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
13970 5a 45 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 28 ZE. || (
13980 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2d 31 (pBt->pageSize-1
13990 29 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 )&pBt->pageSize)
139a0 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 42 74 !=0 ){. pBt
139b0 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 30 3b 0a ->pageSize = 0;.
139c0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
139d0 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
139e0 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6d /* If the m
139f0 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f agic name ":memo
13a00 72 79 3a 22 20 77 69 6c 6c 20 63 72 65 61 74 65 ry:" will create
13a10 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 an in-memory da
13a20 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 20 20 20 tabase, then.
13a30 20 20 20 2a 2a 20 6c 65 61 76 65 20 74 68 65 20 ** leave the
13a40 61 75 74 6f 56 61 63 75 75 6d 20 6d 6f 64 65 20 autoVacuum mode
13a50 61 74 20 30 20 28 64 6f 20 6e 6f 74 20 61 75 74 at 0 (do not aut
13a60 6f 2d 76 61 63 75 75 6d 29 2c 20 65 76 65 6e 20 o-vacuum), even
13a70 69 66 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c 49 if. ** SQLI
13a80 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 TE_DEFAULT_AUTOV
13a90 41 43 55 55 4d 20 69 73 20 74 72 75 65 2e 20 4f ACUUM is true. O
13aa0 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 n the other hand
13ab0 2c 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 53 51 , if. ** SQ
13ac0 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 LITE_OMIT_MEMORY
13ad0 44 42 20 68 61 73 20 62 65 65 6e 20 64 65 66 69 DB has been defi
13ae0 6e 65 64 2c 20 74 68 65 6e 20 22 3a 6d 65 6d 6f ned, then ":memo
13af0 72 79 3a 22 20 69 73 20 6a 75 73 74 20 61 0a 20 ry:" is just a.
13b00 20 20 20 20 20 2a 2a 20 72 65 67 75 6c 61 72 20 ** regular
13b10 66 69 6c 65 2d 6e 61 6d 65 2e 20 49 6e 20 74 68 file-name. In th
13b20 69 73 20 63 61 73 65 20 74 68 65 20 61 75 74 6f is case the auto
13b30 2d 76 61 63 75 75 6d 20 61 70 70 6c 69 65 73 20 -vacuum applies
13b40 61 73 20 70 65 72 20 6e 6f 72 6d 61 6c 2e 0a 20 as per normal..
13b50 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 */. if
13b60 28 20 7a 46 69 6c 65 6e 61 6d 65 20 26 26 20 21 ( zFilename && !
13b70 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 20 isMemdb ){.
13b80 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
13b90 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 45 46 um = (SQLITE_DEF
13ba0 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 AULT_AUTOVACUUM
13bb0 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20 20 20 ? 1 : 0);.
13bc0 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 pBt->incrVacuu
13bd0 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 45 46 41 m = (SQLITE_DEFA
13be0 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d 3d ULT_AUTOVACUUM==
13bf0 32 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20 2 ? 1 : 0);.
13c00 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 }.#endif.
13c10 20 6e 52 65 73 65 72 76 65 20 3d 20 30 3b 0a 20 nReserve = 0;.
13c20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
13c30 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
13c40 52 2d 33 37 34 39 37 2d 34 32 34 31 32 20 54 68 R-37497-42412 Th
13c50 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 72 65 e size of the re
13c60 73 65 72 76 65 64 20 72 65 67 69 6f 6e 20 69 73 served region is
13c70 0a 20 20 20 20 20 20 2a 2a 20 64 65 74 65 72 6d . ** determ
13c80 69 6e 65 64 20 62 79 20 74 68 65 20 6f 6e 65 2d ined by the one-
13c90 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 69 6e byte unsigned in
13ca0 74 65 67 65 72 20 66 6f 75 6e 64 20 61 74 20 61 teger found at a
13cb0 6e 20 6f 66 66 73 65 74 20 6f 66 20 32 30 0a 20 n offset of 20.
13cc0 20 20 20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 ** into the
13cd0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 database file h
13ce0 65 61 64 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 eader. */.
13cf0 6e 52 65 73 65 72 76 65 20 3d 20 7a 44 62 48 65 nReserve = zDbHe
13d00 61 64 65 72 5b 32 30 5d 3b 0a 20 20 20 20 20 20 ader[20];.
13d10 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
13d20 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 BTS_PAGESIZE_FI
13d30 58 45 44 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c XED;.#ifndef SQL
13d40 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
13d50 55 55 4d 0a 20 20 20 20 20 20 70 42 74 2d 3e 61 UUM. pBt->a
13d60 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 65 74 utoVacuum = (get
13d70 34 62 79 74 65 28 26 7a 44 62 48 65 61 64 65 72 4byte(&zDbHeader
13d80 5b 33 36 20 2b 20 34 2a 34 5d 29 3f 31 3a 30 29 [36 + 4*4])?1:0)
13d90 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 63 ;. pBt->inc
13da0 72 56 61 63 75 75 6d 20 3d 20 28 67 65 74 34 62 rVacuum = (get4b
13db0 79 74 65 28 26 7a 44 62 48 65 61 64 65 72 5b 33 yte(&zDbHeader[3
13dc0 36 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 0a 6 + 7*4])?1:0);.
13dd0 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 #endif. }.
13de0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
13df0 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 42 erSetPagesize(pB
13e00 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 74 2d t->pPager, &pBt-
13e10 3e 70 61 67 65 53 69 7a 65 2c 20 6e 52 65 73 65 >pageSize, nRese
13e20 72 76 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 rve);. if( rc
13e30 20 29 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 ) goto btree_op
13e40 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 70 42 74 2d en_out;. pBt-
13e50 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 >usableSize = pB
13e60 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 6e 52 t->pageSize - nR
13e70 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 65 eserve;. asse
13e80 72 74 28 20 28 70 42 74 2d 3e 70 61 67 65 53 69 rt( (pBt->pageSi
13e90 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 20 20 2f ze & 7)==0 ); /
13ea0 2a 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 6d 65 * 8-byte alignme
13eb0 6e 74 20 6f 66 20 70 61 67 65 53 69 7a 65 20 2a nt of pageSize *
13ec0 2f 0a 20 20 20 0a 23 69 66 20 21 64 65 66 69 6e /. .#if !defin
13ed0 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ed(SQLITE_OMIT_S
13ee0 48 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 HARED_CACHE) &&
13ef0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
13f00 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 20 OMIT_DISKIO).
13f10 20 2f 2a 20 41 64 64 20 74 68 65 20 6e 65 77 20 /* Add the new
13f20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 20 BtShared object
13f30 74 6f 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 to the linked li
13f40 73 74 20 73 68 61 72 61 62 6c 65 20 42 74 53 68 st sharable BtSh
13f50 61 72 65 64 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 areds.. */.
13f60 20 20 70 42 74 2d 3e 6e 52 65 66 20 3d 20 31 3b pBt->nRef = 1;
13f70 0a 20 20 20 20 69 66 28 20 70 2d 3e 73 68 61 72 . if( p->shar
13f80 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 4d 55 able ){. MU
13f90 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 TEX_LOGIC( sqlit
13fa0 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 e3_mutex *mutexS
13fb0 68 61 72 65 64 3b 20 29 0a 20 20 20 20 20 20 4d hared; ). M
13fc0 55 54 45 58 5f 4c 4f 47 49 43 28 20 6d 75 74 65 UTEX_LOGIC( mute
13fd0 78 53 68 61 72 65 64 20 3d 20 73 71 6c 69 74 65 xShared = sqlite
13fe0 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 3MutexAlloc(SQLI
13ff0 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f TE_MUTEX_STATIC_
14000 4d 41 53 54 45 52 29 3b 29 0a 20 20 20 20 20 20 MASTER);).
14010 69 66 28 20 53 51 4c 49 54 45 5f 54 48 52 45 41 if( SQLITE_THREA
14020 44 53 41 46 45 20 26 26 20 73 71 6c 69 74 65 33 DSAFE && sqlite3
14030 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f GlobalConfig.bCo
14040 72 65 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 20 reMutex ){.
14050 20 20 20 70 42 74 2d 3e 6d 75 74 65 78 20 3d 20 pBt->mutex =
14060 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
14070 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46 c(SQLITE_MUTEX_F
14080 41 53 54 29 3b 0a 20 20 20 20 20 20 20 20 69 66 AST);. if
14090 28 20 70 42 74 2d 3e 6d 75 74 65 78 3d 3d 30 20 ( pBt->mutex==0
140a0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
140b0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 = SQLITE_NOMEM_B
140c0 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 KPT;. g
140d0 6f 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f oto btree_open_o
140e0 75 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ut;. }.
140f0 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 }. sqli
14100 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
14110 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 mutexShared);.
14120 20 20 20 20 70 42 74 2d 3e 70 4e 65 78 74 20 3d pBt->pNext =
14130 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 GLOBAL(BtShared
14140 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 *,sqlite3SharedC
14150 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 acheList);.
14160 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 GLOBAL(BtShared
14170 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 *,sqlite3SharedC
14180 61 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 3b acheList) = pBt;
14190 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
141a0 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 utex_leave(mutex
141b0 53 68 61 72 65 64 29 3b 0a 20 20 20 20 7d 0a 23 Shared);. }.#
141c0 65 6e 64 69 66 0a 20 20 7d 0a 0a 23 69 66 20 21 endif. }..#if !
141d0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
141e0 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
141f0 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
14200 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f LITE_OMIT_DISKIO
14210 29 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 6e 65 ). /* If the ne
14220 77 20 42 74 72 65 65 20 75 73 65 73 20 61 20 73 w Btree uses a s
14230 68 61 72 61 62 6c 65 20 70 42 74 53 68 61 72 65 harable pBtShare
14240 64 2c 20 74 68 65 6e 20 6c 69 6e 6b 20 74 68 65 d, then link the
14250 20 6e 65 77 0a 20 20 2a 2a 20 42 74 72 65 65 20 new. ** Btree
14260 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 into the list of
14270 20 61 6c 6c 20 73 68 61 72 61 62 6c 65 20 42 74 all sharable Bt
14280 72 65 65 73 20 66 6f 72 20 74 68 65 20 73 61 6d rees for the sam
14290 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 20 20 e connection..
142a0 2a 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 6b ** The list is k
142b0 65 70 74 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 ept in ascending
142c0 20 6f 72 64 65 72 20 62 79 20 70 42 74 20 61 64 order by pBt ad
142d0 64 72 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 dress.. */. if
142e0 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b ( p->sharable ){
142f0 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 . int i;.
14300 42 74 72 65 65 20 2a 70 53 69 62 3b 0a 20 20 20 Btree *pSib;.
14310 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e for(i=0; i<db->
14320 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 nDb; i++){.
14330 20 69 66 28 20 28 70 53 69 62 20 3d 20 64 62 2d if( (pSib = db-
14340 3e 61 44 62 5b 69 5d 2e 70 42 74 29 21 3d 30 20 >aDb[i].pBt)!=0
14350 26 26 20 70 53 69 62 2d 3e 73 68 61 72 61 62 6c && pSib->sharabl
14360 65 20 29 7b 0a 20 20 20 20 20 20 20 20 77 68 69 e ){. whi
14370 6c 65 28 20 70 53 69 62 2d 3e 70 50 72 65 76 20 le( pSib->pPrev
14380 29 7b 20 70 53 69 62 20 3d 20 70 53 69 62 2d 3e ){ pSib = pSib->
14390 70 50 72 65 76 3b 20 7d 0a 20 20 20 20 20 20 20 pPrev; }.
143a0 20 69 66 28 20 28 75 70 74 72 29 70 2d 3e 70 42 if( (uptr)p->pB
143b0 74 3c 28 75 70 74 72 29 70 53 69 62 2d 3e 70 42 t<(uptr)pSib->pB
143c0 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 t ){. p
143d0 2d 3e 70 4e 65 78 74 20 3d 20 70 53 69 62 3b 0a ->pNext = pSib;.
143e0 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 50 72 p->pPr
143f0 65 76 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ev = 0;.
14400 20 20 70 53 69 62 2d 3e 70 50 72 65 76 20 3d 20 pSib->pPrev =
14410 70 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 p;. }else
14420 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c {. whil
14430 65 28 20 70 53 69 62 2d 3e 70 4e 65 78 74 20 26 e( pSib->pNext &
14440 26 20 28 75 70 74 72 29 70 53 69 62 2d 3e 70 4e & (uptr)pSib->pN
14450 65 78 74 2d 3e 70 42 74 3c 28 75 70 74 72 29 70 ext->pBt<(uptr)p
14460 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 ->pBt ){.
14470 20 20 20 20 20 70 53 69 62 20 3d 20 70 53 69 62 pSib = pSib
14480 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 ->pNext;.
14490 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 }. p
144a0 2d 3e 70 4e 65 78 74 20 3d 20 70 53 69 62 2d 3e ->pNext = pSib->
144b0 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 20 pNext;.
144c0 20 70 2d 3e 70 50 72 65 76 20 3d 20 70 53 69 62 p->pPrev = pSib
144d0 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
144e0 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 p->pNext ){.
144f0 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
14500 2d 3e 70 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 ->pPrev = p;.
14510 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
14520 20 20 20 70 53 69 62 2d 3e 70 4e 65 78 74 20 3d pSib->pNext =
14530 20 70 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 p;. }.
14540 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
14550 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 }. }. }.#
14560 65 6e 64 69 66 0a 20 20 2a 70 70 42 74 72 65 65 endif. *ppBtree
14570 20 3d 20 70 3b 0a 0a 62 74 72 65 65 5f 6f 70 65 = p;..btree_ope
14580 6e 5f 6f 75 74 3a 0a 20 20 69 66 28 20 72 63 21 n_out:. if( rc!
14590 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
145a0 20 20 69 66 28 20 70 42 74 20 26 26 20 70 42 74 if( pBt && pBt
145b0 2d 3e 70 50 61 67 65 72 20 29 7b 0a 20 20 20 20 ->pPager ){.
145c0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c sqlite3PagerCl
145d0 6f 73 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ose(pBt->pPager,
145e0 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 0);. }. s
145f0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 42 74 29 qlite3_free(pBt)
14600 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 ;. sqlite3_fr
14610 65 65 28 70 29 3b 0a 20 20 20 20 2a 70 70 42 74 ee(p);. *ppBt
14620 72 65 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 ree = 0;. }else
14630 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 {. sqlite3_fi
14640 6c 65 20 2a 70 46 69 6c 65 3b 0a 0a 20 20 20 20 le *pFile;..
14650 2f 2a 20 49 66 20 74 68 65 20 42 2d 54 72 65 65 /* If the B-Tree
14660 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c was successfull
14670 79 20 6f 70 65 6e 65 64 2c 20 73 65 74 20 74 68 y opened, set th
14680 65 20 70 61 67 65 72 2d 63 61 63 68 65 20 73 69 e pager-cache si
14690 7a 65 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a ze to the. **
146a0 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 default value.
146b0 45 78 63 65 70 74 2c 20 77 68 65 6e 20 6f 70 65 Except, when ope
146c0 6e 69 6e 67 20 6f 6e 20 61 6e 20 65 78 69 73 74 ning on an exist
146d0 69 6e 67 20 73 68 61 72 65 64 20 70 61 67 65 72 ing shared pager
146e0 2d 63 61 63 68 65 2c 0a 20 20 20 20 2a 2a 20 64 -cache,. ** d
146f0 6f 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 68 65 o not change the
14700 20 70 61 67 65 72 2d 63 61 63 68 65 20 73 69 7a pager-cache siz
14710 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 e.. */. if
14720 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 63 ( sqlite3BtreeSc
14730 68 65 6d 61 28 70 2c 20 30 2c 20 30 29 3d 3d 30 hema(p, 0, 0)==0
14740 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
14750 33 50 61 67 65 72 53 65 74 43 61 63 68 65 73 69 3PagerSetCachesi
14760 7a 65 28 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 ze(p->pBt->pPage
14770 72 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c r, SQLITE_DEFAUL
14780 54 5f 43 41 43 48 45 5f 53 49 5a 45 29 3b 0a 20 T_CACHE_SIZE);.
14790 20 20 20 7d 0a 0a 20 20 20 20 70 46 69 6c 65 20 }.. pFile
147a0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 = sqlite3PagerFi
147b0 6c 65 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b le(pBt->pPager);
147c0 0a 20 20 20 20 69 66 28 20 70 46 69 6c 65 2d 3e . if( pFile->
147d0 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 pMethods ){.
147e0 20 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 sqlite3OsFileC
147f0 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 46 69 6c 65 ontrolHint(pFile
14800 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 50 , SQLITE_FCNTL_P
14810 44 42 2c 20 28 76 6f 69 64 2a 29 26 70 42 74 2d DB, (void*)&pBt-
14820 3e 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a >db);. }. }.
14830 20 20 69 66 28 20 6d 75 74 65 78 4f 70 65 6e 20 if( mutexOpen
14840 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 ){. assert( s
14850 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
14860 64 28 6d 75 74 65 78 4f 70 65 6e 29 20 29 3b 0a d(mutexOpen) );.
14870 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
14880 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 4f 70 65 x_leave(mutexOpe
14890 6e 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 n);. }. assert
148a0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
148b0 7c 7c 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 || sqlite3BtreeC
148c0 6f 6e 6e 65 63 74 69 6f 6e 43 6f 75 6e 74 28 2a onnectionCount(*
148d0 70 70 42 74 72 65 65 29 3e 30 20 29 3b 0a 20 20 ppBtree)>0 );.
148e0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
148f0 0a 2a 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 68 .** Decrement th
14900 65 20 42 74 53 68 61 72 65 64 2e 6e 52 65 66 20 e BtShared.nRef
14910 63 6f 75 6e 74 65 72 2e 20 20 57 68 65 6e 20 69 counter. When i
14920 74 20 72 65 61 63 68 65 73 20 7a 65 72 6f 2c 0a t reaches zero,.
14930 2a 2a 20 72 65 6d 6f 76 65 20 74 68 65 20 42 74 ** remove the Bt
14940 53 68 61 72 65 64 20 73 74 72 75 63 74 75 72 65 Shared structure
14950 20 66 72 6f 6d 20 74 68 65 20 73 68 61 72 69 6e from the sharin
14960 67 20 6c 69 73 74 2e 20 20 52 65 74 75 72 6e 0a g list. Return.
14970 2a 2a 20 74 72 75 65 20 69 66 20 74 68 65 20 42 ** true if the B
14980 74 53 68 61 72 65 64 2e 6e 52 65 66 20 63 6f 75 tShared.nRef cou
14990 6e 74 65 72 20 72 65 61 63 68 65 73 20 7a 65 72 nter reaches zer
149a0 6f 20 61 6e 64 20 72 65 74 75 72 6e 0a 2a 2a 20 o and return.**
149b0 66 61 6c 73 65 20 69 66 20 69 74 20 69 73 20 73 false if it is s
149c0 74 69 6c 6c 20 70 6f 73 69 74 69 76 65 2e 0a 2a till positive..*
149d0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 6d /.static int rem
149e0 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c 69 oveFromSharingLi
149f0 73 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 st(BtShared *pBt
14a00 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ){.#ifndef SQLIT
14a10 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
14a20 43 48 45 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 CHE. MUTEX_LOGI
14a30 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 C( sqlite3_mutex
14a40 20 2a 70 4d 61 73 74 65 72 3b 20 29 0a 20 20 42 *pMaster; ). B
14a50 74 53 68 61 72 65 64 20 2a 70 4c 69 73 74 3b 0a tShared *pList;.
14a60 20 20 69 6e 74 20 72 65 6d 6f 76 65 64 20 3d 20 int removed =
14a70 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 0;.. assert( sq
14a80 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 lite3_mutex_noth
14a90 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
14aa0 29 3b 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 );. MUTEX_LOGIC
14ab0 28 20 70 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 ( pMaster = sqli
14ac0 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
14ad0 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
14ae0 43 5f 4d 41 53 54 45 52 29 3b 20 29 0a 20 20 73 C_MASTER); ). s
14af0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
14b00 65 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 70 er(pMaster);. p
14b10 42 74 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 Bt->nRef--;. if
14b20 28 20 70 42 74 2d 3e 6e 52 65 66 3c 3d 30 20 29 ( pBt->nRef<=0 )
14b30 7b 0a 20 20 20 20 69 66 28 20 47 4c 4f 42 41 4c {. if( GLOBAL
14b40 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
14b50 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
14b60 74 29 3d 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 t)==pBt ){.
14b70 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 GLOBAL(BtShared
14b80 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 *,sqlite3SharedC
14b90 61 63 68 65 4c 69 73 74 29 20 3d 20 70 42 74 2d acheList) = pBt-
14ba0 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c 73 >pNext;. }els
14bb0 65 7b 0a 20 20 20 20 20 20 70 4c 69 73 74 20 3d e{. pList =
14bc0 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 GLOBAL(BtShared
14bd0 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 *,sqlite3SharedC
14be0 61 63 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 acheList);.
14bf0 20 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 70 while( ALWAYS(p
14c00 4c 69 73 74 29 20 26 26 20 70 4c 69 73 74 2d 3e List) && pList->
14c10 70 4e 65 78 74 21 3d 70 42 74 20 29 7b 0a 20 20 pNext!=pBt ){.
14c20 20 20 20 20 20 20 70 4c 69 73 74 3d 70 4c 69 73 pList=pLis
14c30 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 t->pNext;.
14c40 7d 0a 20 20 20 20 20 20 69 66 28 20 41 4c 57 41 }. if( ALWA
14c50 59 53 28 70 4c 69 73 74 29 20 29 7b 0a 20 20 20 YS(pList) ){.
14c60 20 20 20 20 20 70 4c 69 73 74 2d 3e 70 4e 65 78 pList->pNex
14c70 74 20 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b 0a t = pBt->pNext;.
14c80 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
14c90 20 20 69 66 28 20 53 51 4c 49 54 45 5f 54 48 52 if( SQLITE_THR
14ca0 45 41 44 53 41 46 45 20 29 7b 0a 20 20 20 20 20 EADSAFE ){.
14cb0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 sqlite3_mutex_f
14cc0 72 65 65 28 70 42 74 2d 3e 6d 75 74 65 78 29 3b ree(pBt->mutex);
14cd0 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 6d 6f 76 . }. remov
14ce0 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71 ed = 1;. }. sq
14cf0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
14d00 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72 65 e(pMaster);. re
14d10 74 75 72 6e 20 72 65 6d 6f 76 65 64 3b 0a 23 65 turn removed;.#e
14d20 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a lse. return 1;.
14d30 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 #endif.}../*.**
14d40 4d 61 6b 65 20 73 75 72 65 20 70 42 74 2d 3e 70 Make sure pBt->p
14d50 54 6d 70 53 70 61 63 65 20 70 6f 69 6e 74 73 20 TmpSpace points
14d60 74 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e to an allocation
14d70 20 6f 66 20 0a 2a 2a 20 4d 58 5f 43 45 4c 4c 5f of .** MX_CELL_
14d80 53 49 5a 45 28 70 42 74 29 20 62 79 74 65 73 20 SIZE(pBt) bytes
14d90 77 69 74 68 20 61 20 34 2d 62 79 74 65 20 70 72 with a 4-byte pr
14da0 65 66 69 78 20 66 6f 72 20 61 20 6c 65 66 74 2d efix for a left-
14db0 63 68 69 6c 64 0a 2a 2a 20 70 6f 69 6e 74 65 72 child.** pointer
14dc0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
14dd0 20 61 6c 6c 6f 63 61 74 65 54 65 6d 70 53 70 61 allocateTempSpa
14de0 63 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 ce(BtShared *pBt
14df0 29 7b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 70 ){. if( !pBt->p
14e00 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 20 TmpSpace ){.
14e10 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d pBt->pTmpSpace =
14e20 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c sqlite3PageMall
14e30 6f 63 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a oc( pBt->pageSiz
14e40 65 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 6e 65 e );.. /* One
14e50 20 6f 66 20 74 68 65 20 75 73 65 73 20 6f 66 20 of the uses of
14e60 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 69 pBt->pTmpSpace i
14e70 73 20 74 6f 20 66 6f 72 6d 61 74 20 63 65 6c 6c s to format cell
14e80 73 20 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a 20 s before. **
14e90 69 6e 73 65 72 74 69 6e 67 20 74 68 65 6d 20 69 inserting them i
14ea0 6e 74 6f 20 61 20 6c 65 61 66 20 70 61 67 65 20 nto a leaf page
14eb0 28 66 75 6e 63 74 69 6f 6e 20 66 69 6c 6c 49 6e (function fillIn
14ec0 43 65 6c 6c 28 29 29 2e 20 49 66 0a 20 20 20 20 Cell()). If.
14ed0 2a 2a 20 61 20 63 65 6c 6c 20 69 73 20 6c 65 73 ** a cell is les
14ee0 73 20 74 68 61 6e 20 34 20 62 79 74 65 73 20 69 s than 4 bytes i
14ef0 6e 20 73 69 7a 65 2c 20 69 74 20 69 73 20 72 6f n size, it is ro
14f00 75 6e 64 65 64 20 75 70 20 74 6f 20 34 20 62 79 unded up to 4 by
14f10 74 65 73 0a 20 20 20 20 2a 2a 20 62 79 20 74 68 tes. ** by th
14f20 65 20 76 61 72 69 6f 75 73 20 72 6f 75 74 69 6e e various routin
14f30 65 73 20 74 68 61 74 20 6d 61 6e 69 70 75 6c 61 es that manipula
14f40 74 65 20 62 69 6e 61 72 79 20 63 65 6c 6c 73 2e te binary cells.
14f50 20 57 68 69 63 68 0a 20 20 20 20 2a 2a 20 63 61 Which. ** ca
14f60 6e 20 6d 65 61 6e 20 74 68 61 74 20 66 69 6c 6c n mean that fill
14f70 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 20 69 6e InCell() only in
14f80 69 74 69 61 6c 69 7a 65 73 20 74 68 65 20 66 69 itializes the fi
14f90 72 73 74 20 32 20 6f 72 20 33 0a 20 20 20 20 2a rst 2 or 3. *
14fa0 2a 20 62 79 74 65 73 20 6f 66 20 70 54 6d 70 53 * bytes of pTmpS
14fb0 70 61 63 65 2c 20 62 75 74 20 74 68 61 74 20 74 pace, but that t
14fc0 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 he first 4 bytes
14fd0 20 61 72 65 20 63 6f 70 69 65 64 20 66 72 6f 6d are copied from
14fe0 0a 20 20 20 20 2a 2a 20 69 74 20 69 6e 74 6f 20 . ** it into
14ff0 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2e a database page.
15000 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 63 74 This is not act
15010 75 61 6c 6c 79 20 61 20 70 72 6f 62 6c 65 6d 2c ually a problem,
15020 20 62 75 74 20 69 74 0a 20 20 20 20 2a 2a 20 64 but it. ** d
15030 6f 65 73 20 63 61 75 73 65 20 61 20 76 61 6c 67 oes cause a valg
15040 72 69 6e 64 20 65 72 72 6f 72 20 77 68 65 6e 20 rind error when
15050 74 68 65 20 31 20 6f 72 20 32 20 62 79 74 65 73 the 1 or 2 bytes
15060 20 6f 66 20 75 6e 69 74 69 61 6c 69 7a 65 64 20 of unitialized
15070 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 69 73 20 . ** data is
15080 70 61 73 73 65 64 20 74 6f 20 73 79 73 74 65 6d passed to system
15090 20 63 61 6c 6c 20 77 72 69 74 65 28 29 2e 20 53 call write(). S
150a0 6f 20 74 6f 20 61 76 6f 69 64 20 74 68 69 73 20 o to avoid this
150b0 65 72 72 6f 72 2c 0a 20 20 20 20 2a 2a 20 7a 65 error,. ** ze
150c0 72 6f 20 74 68 65 20 66 69 72 73 74 20 34 20 62 ro the first 4 b
150d0 79 74 65 73 20 6f 66 20 74 65 6d 70 20 73 70 61 ytes of temp spa
150e0 63 65 20 68 65 72 65 2e 0a 20 20 20 20 2a 2a 0a ce here.. **.
150f0 20 20 20 20 2a 2a 20 41 6c 73 6f 3a 20 20 50 72 ** Also: Pr
15100 6f 76 69 64 65 20 66 6f 75 72 20 62 79 74 65 73 ovide four bytes
15110 20 6f 66 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 of initialized
15120 73 70 61 63 65 20 62 65 66 6f 72 65 20 74 68 65 space before the
15130 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e 6e 69 6e . ** beginnin
15140 67 20 6f 66 20 70 54 6d 70 53 70 61 63 65 20 61 g of pTmpSpace a
15150 73 20 61 6e 20 61 72 65 61 20 61 76 61 69 6c 61 s an area availa
15160 62 6c 65 20 74 6f 20 70 72 65 70 65 6e 64 20 74 ble to prepend t
15170 68 65 0a 20 20 20 20 2a 2a 20 6c 65 66 74 2d 63 he. ** left-c
15180 68 69 6c 64 20 70 6f 69 6e 74 65 72 20 74 6f 20 hild pointer to
15190 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 the beginning of
151a0 20 61 20 63 65 6c 6c 2e 0a 20 20 20 20 2a 2f 0a a cell.. */.
151b0 20 20 20 20 69 66 28 20 70 42 74 2d 3e 70 54 6d if( pBt->pTm
151c0 70 53 70 61 63 65 20 29 7b 0a 20 20 20 20 20 20 pSpace ){.
151d0 6d 65 6d 73 65 74 28 70 42 74 2d 3e 70 54 6d 70 memset(pBt->pTmp
151e0 53 70 61 63 65 2c 20 30 2c 20 38 29 3b 0a 20 20 Space, 0, 8);.
151f0 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 pBt->pTmpSpa
15200 63 65 20 2b 3d 20 34 3b 0a 20 20 20 20 7d 0a 20 ce += 4;. }.
15210 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 }.}../*.** Free
15220 20 74 68 65 20 70 42 74 2d 3e 70 54 6d 70 53 70 the pBt->pTmpSp
15230 61 63 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a ace allocation.*
15240 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72 /.static void fr
15250 65 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 68 eeTempSpace(BtSh
15260 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 66 ared *pBt){. if
15270 28 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 ( pBt->pTmpSpace
15280 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e 70 54 6d ){. pBt->pTm
15290 70 53 70 61 63 65 20 2d 3d 20 34 3b 0a 20 20 20 pSpace -= 4;.
152a0 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 sqlite3PageFree
152b0 28 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 29 (pBt->pTmpSpace)
152c0 3b 0a 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 ;. pBt->pTmpS
152d0 70 61 63 65 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a pace = 0;. }.}.
152e0 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 ./*.** Close an
152f0 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 61 6e open database an
15300 64 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c d invalidate all
15310 20 63 75 72 73 6f 72 73 2e 0a 2a 2f 0a 69 6e 74 cursors..*/.int
15320 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f sqlite3BtreeClo
15330 73 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 se(Btree *p){.
15340 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
15350 70 2d 3e 70 42 74 3b 0a 20 20 42 74 43 75 72 73 p->pBt;. BtCurs
15360 6f 72 20 2a 70 43 75 72 3b 0a 0a 20 20 2f 2a 20 or *pCur;.. /*
15370 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72 73 6f 72 Close all cursor
15380 73 20 6f 70 65 6e 65 64 20 76 69 61 20 74 68 69 s opened via thi
15390 73 20 68 61 6e 64 6c 65 2e 20 20 2a 2f 0a 20 20 s handle. */.
153a0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
153b0 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 mutex_held(p->db
153c0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 ->mutex) );. sq
153d0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
153e0 70 29 3b 0a 20 20 70 43 75 72 20 3d 20 70 42 74 p);. pCur = pBt
153f0 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 20 77 68 69 ->pCursor;. whi
15400 6c 65 28 20 70 43 75 72 20 29 7b 0a 20 20 20 20 le( pCur ){.
15410 42 74 43 75 72 73 6f 72 20 2a 70 54 6d 70 20 3d BtCursor *pTmp =
15420 20 70 43 75 72 3b 0a 20 20 20 20 70 43 75 72 20 pCur;. pCur
15430 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 = pCur->pNext;.
15440 20 20 20 69 66 28 20 70 54 6d 70 2d 3e 70 42 74 if( pTmp->pBt
15450 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 20 ree==p ){.
15460 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
15470 65 43 75 72 73 6f 72 28 70 54 6d 70 29 3b 0a 20 eCursor(pTmp);.
15480 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 }. }.. /* R
15490 6f 6c 6c 62 61 63 6b 20 61 6e 79 20 61 63 74 69 ollback any acti
154a0 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 ve transaction a
154b0 6e 64 20 66 72 65 65 20 74 68 65 20 68 61 6e 64 nd free the hand
154c0 6c 65 20 73 74 72 75 63 74 75 72 65 2e 0a 20 20 le structure..
154d0 2a 2a 20 54 68 65 20 63 61 6c 6c 20 74 6f 20 73 ** The call to s
154e0 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 qlite3BtreeRollb
154f0 61 63 6b 28 29 20 64 72 6f 70 73 20 61 6e 79 20 ack() drops any
15500 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 68 65 6c 64 table-locks held
15510 20 62 79 0a 20 20 2a 2a 20 74 68 69 73 20 68 61 by. ** this ha
15520 6e 64 6c 65 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c ndle.. */. sql
15530 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 ite3BtreeRollbac
15540 6b 28 70 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 k(p, SQLITE_OK,
15550 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 0);. sqlite3Btr
15560 65 65 4c 65 61 76 65 28 70 29 3b 0a 0a 20 20 2f eeLeave(p);.. /
15570 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 73 * If there are s
15580 74 69 6c 6c 20 6f 74 68 65 72 20 6f 75 74 73 74 till other outst
15590 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 anding reference
155a0 73 20 74 6f 20 74 68 65 20 73 68 61 72 65 64 2d s to the shared-
155b0 62 74 72 65 65 0a 20 20 2a 2a 20 73 74 72 75 63 btree. ** struc
155c0 74 75 72 65 2c 20 72 65 74 75 72 6e 20 6e 6f 77 ture, return now
155d0 2e 20 54 68 65 20 72 65 6d 61 69 6e 64 65 72 20 . The remainder
155e0 6f 66 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 of this procedur
155f0 65 20 63 6c 65 61 6e 73 20 0a 20 20 2a 2a 20 75 e cleans . ** u
15600 70 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 72 p the shared-btr
15610 65 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 ee.. */. asser
15620 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 6b t( p->wantToLock
15630 3d 3d 30 20 26 26 20 70 2d 3e 6c 6f 63 6b 65 64 ==0 && p->locked
15640 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 21 70 2d ==0 );. if( !p-
15650 3e 73 68 61 72 61 62 6c 65 20 7c 7c 20 72 65 6d >sharable || rem
15660 6f 76 65 46 72 6f 6d 53 68 61 72 69 6e 67 4c 69 oveFromSharingLi
15670 73 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 2f st(pBt) ){. /
15680 2a 20 54 68 65 20 70 42 74 20 69 73 20 6e 6f 20 * The pBt is no
15690 6c 6f 6e 67 65 72 20 6f 6e 20 74 68 65 20 73 68 longer on the sh
156a0 61 72 69 6e 67 20 6c 69 73 74 2c 20 73 6f 20 77 aring list, so w
156b0 65 20 63 61 6e 20 61 63 63 65 73 73 0a 20 20 20 e can access.
156c0 20 2a 2a 20 69 74 20 77 69 74 68 6f 75 74 20 68 ** it without h
156d0 61 76 69 6e 67 20 74 6f 20 68 6f 6c 64 20 74 68 aving to hold th
156e0 65 20 6d 75 74 65 78 2e 0a 20 20 20 20 2a 2a 0a e mutex.. **.
156f0 20 20 20 20 2a 2a 20 43 6c 65 61 6e 20 6f 75 74 ** Clean out
15700 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 and delete the
15710 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 2e BtShared object.
15720 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 . */. asse
15730 72 74 28 20 21 70 42 74 2d 3e 70 43 75 72 73 6f rt( !pBt->pCurso
15740 72 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 r );. sqlite3
15750 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e PagerClose(pBt->
15760 70 50 61 67 65 72 2c 20 70 2d 3e 64 62 29 3b 0a pPager, p->db);.
15770 20 20 20 20 69 66 28 20 70 42 74 2d 3e 78 46 72 if( pBt->xFr
15780 65 65 53 63 68 65 6d 61 20 26 26 20 70 42 74 2d eeSchema && pBt-
15790 3e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 >pSchema ){.
157a0 20 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 pBt->xFreeSche
157b0 6d 61 28 70 42 74 2d 3e 70 53 63 68 65 6d 61 29 ma(pBt->pSchema)
157c0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
157d0 74 65 33 44 62 46 72 65 65 28 30 2c 20 70 42 74 te3DbFree(0, pBt
157e0 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 ->pSchema);.
157f0 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 freeTempSpace(pB
15800 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f t);. sqlite3_
15810 66 72 65 65 28 70 42 74 29 3b 0a 20 20 7d 0a 0a free(pBt);. }..
15820 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
15830 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
15840 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 . assert( p->wa
15850 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20 ntToLock==0 );.
15860 20 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b assert( p->lock
15870 65 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 ed==0 );. if( p
15880 2d 3e 70 50 72 65 76 20 29 20 70 2d 3e 70 50 72 ->pPrev ) p->pPr
15890 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70 ev->pNext = p->p
158a0 4e 65 78 74 3b 0a 20 20 69 66 28 20 70 2d 3e 70 Next;. if( p->p
158b0 4e 65 78 74 20 29 20 70 2d 3e 70 4e 65 78 74 2d Next ) p->pNext-
158c0 3e 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65 >pPrev = p->pPre
158d0 76 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c v;.#endif.. sql
158e0 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 ite3_free(p);.
158f0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
15900 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
15910 65 20 74 68 65 20 22 73 6f 66 74 22 20 6c 69 6d e the "soft" lim
15920 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 it on the number
15930 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 of pages in the
15940 20 63 61 63 68 65 2e 0a 2a 2a 20 55 6e 75 73 65 cache..** Unuse
15950 64 20 61 6e 64 20 75 6e 6d 6f 64 69 66 69 65 64 d and unmodified
15960 20 70 61 67 65 73 20 77 69 6c 6c 20 62 65 20 72 pages will be r
15970 65 63 79 63 6c 65 64 20 77 68 65 6e 20 74 68 65 ecycled when the
15980 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 70 61 number of.** pa
15990 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 ges in the cache
159a0 20 65 78 63 65 65 64 73 20 74 68 69 73 20 73 6f exceeds this so
159b0 66 74 20 6c 69 6d 69 74 2e 20 20 42 75 74 20 74 ft limit. But t
159c0 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 0a 2a he size of the.*
159d0 2a 20 63 61 63 68 65 20 69 73 20 61 6c 6c 6f 77 * cache is allow
159e0 65 64 20 74 6f 20 67 72 6f 77 20 6c 61 72 67 65 ed to grow large
159f0 72 20 74 68 61 6e 20 74 68 69 73 20 6c 69 6d 69 r than this limi
15a00 74 20 69 66 20 69 74 20 63 6f 6e 74 61 69 6e 73 t if it contains
15a10 0a 2a 2a 20 64 69 72 74 79 20 70 61 67 65 73 20 .** dirty pages
15a20 6f 72 20 70 61 67 65 73 20 73 74 69 6c 6c 20 69 or pages still i
15a30 6e 20 61 63 74 69 76 65 20 75 73 65 2e 0a 2a 2f n active use..*/
15a40 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
15a50 65 53 65 74 43 61 63 68 65 53 69 7a 65 28 42 74 eSetCacheSize(Bt
15a60 72 65 65 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 ree *p, int mxPa
15a70 67 65 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 ge){. BtShared
15a80 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
15a90 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
15aa0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 _mutex_held(p->d
15ab0 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
15ac0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
15ad0 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 (p);. sqlite3Pa
15ae0 67 65 72 53 65 74 43 61 63 68 65 73 69 7a 65 28 gerSetCachesize(
15af0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 pBt->pPager, mxP
15b00 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 age);. sqlite3B
15b10 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
15b20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
15b30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
15b40 65 20 74 68 65 20 22 73 70 69 6c 6c 22 20 6c 69 e the "spill" li
15b50 6d 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 mit on the numbe
15b60 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
15b70 65 20 63 61 63 68 65 2e 0a 2a 2a 20 49 66 20 74 e cache..** If t
15b80 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
15b90 65 73 20 65 78 63 65 65 64 73 20 74 68 69 73 20 es exceeds this
15ba0 6c 69 6d 69 74 20 64 75 72 69 6e 67 20 61 20 77 limit during a w
15bb0 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
15bc0 2c 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 20 6d ,.** the pager m
15bd0 69 67 68 74 20 61 74 74 65 6d 70 74 20 74 6f 20 ight attempt to
15be0 22 73 70 69 6c 6c 22 20 70 61 67 65 73 20 74 6f "spill" pages to
15bf0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 65 61 72 the journal ear
15c00 6c 79 20 69 6e 0a 2a 2a 20 6f 72 64 65 72 20 74 ly in.** order t
15c10 6f 20 66 72 65 65 20 75 70 20 6d 65 6d 6f 72 79 o free up memory
15c20 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 61 6c 75 ..**.** The valu
15c30 65 20 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 e returned is th
15c40 65 20 63 75 72 72 65 6e 74 20 73 70 69 6c 6c 20 e current spill
15c50 73 69 7a 65 2e 20 20 49 66 20 7a 65 72 6f 20 69 size. If zero i
15c60 73 20 70 61 73 73 65 64 0a 2a 2a 20 61 73 20 61 s passed.** as a
15c70 6e 20 61 72 67 75 6d 65 6e 74 2c 20 6e 6f 20 63 n argument, no c
15c80 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 hanges are made
15c90 74 6f 20 74 68 65 20 73 70 69 6c 6c 20 73 69 7a to the spill siz
15ca0 65 20 73 65 74 74 69 6e 67 2c 20 73 6f 0a 2a 2a e setting, so.**
15cb0 20 75 73 69 6e 67 20 6d 78 50 61 67 65 20 6f 66 using mxPage of
15cc0 20 30 20 69 73 20 61 20 77 61 79 20 74 6f 20 71 0 is a way to q
15cd0 75 65 72 79 20 74 68 65 20 63 75 72 72 65 6e 74 uery the current
15ce0 20 73 70 69 6c 6c 20 73 69 7a 65 2e 0a 2a 2f 0a spill size..*/.
15cf0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
15d00 53 65 74 53 70 69 6c 6c 53 69 7a 65 28 42 74 72 SetSpillSize(Btr
15d10 65 65 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 67 ee *p, int mxPag
15d20 65 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a e){. BtShared *
15d30 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
15d40 69 6e 74 20 72 65 73 3b 0a 20 20 61 73 73 65 72 int res;. asser
15d50 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
15d60 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 _held(p->db->mut
15d70 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 ex) );. sqlite3
15d80 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
15d90 20 72 65 73 20 3d 20 73 71 6c 69 74 65 33 50 61 res = sqlite3Pa
15da0 67 65 72 53 65 74 53 70 69 6c 6c 73 69 7a 65 28 gerSetSpillsize(
15db0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 pBt->pPager, mxP
15dc0 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 age);. sqlite3B
15dd0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
15de0 72 65 74 75 72 6e 20 72 65 73 3b 0a 7d 0a 0a 23 return res;.}..#
15df0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d if SQLITE_MAX_MM
15e00 41 50 5f 53 49 5a 45 3e 30 0a 2f 2a 0a 2a 2a 20 AP_SIZE>0./*.**
15e10 43 68 61 6e 67 65 20 74 68 65 20 6c 69 6d 69 74 Change the limit
15e20 20 6f 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f on the amount o
15e30 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
15e40 69 6c 65 20 74 68 61 74 20 6d 61 79 20 62 65 0a ile that may be.
15e50 2a 2a 20 6d 65 6d 6f 72 79 20 6d 61 70 70 65 64 ** memory mapped
15e60 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
15e70 42 74 72 65 65 53 65 74 4d 6d 61 70 4c 69 6d 69 BtreeSetMmapLimi
15e80 74 28 42 74 72 65 65 20 2a 70 2c 20 73 71 6c 69 t(Btree *p, sqli
15e90 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 te3_int64 szMmap
15ea0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
15eb0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 Bt = p->pBt;. a
15ec0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
15ed0 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d utex_held(p->db-
15ee0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
15ef0 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
15f00 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 );. sqlite3Page
15f10 72 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 70 42 rSetMmapLimit(pB
15f20 74 2d 3e 70 50 61 67 65 72 2c 20 73 7a 4d 6d 61 t->pPager, szMma
15f30 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 p);. sqlite3Btr
15f40 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
15f50 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
15f60 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 }.#endif /* SQLI
15f70 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
15f80 3e 30 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 >0 */../*.** Cha
15f90 6e 67 65 20 74 68 65 20 77 61 79 20 64 61 74 61 nge the way data
15fa0 20 69 73 20 73 79 6e 63 65 64 20 74 6f 20 64 69 is synced to di
15fb0 73 6b 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 sk in order to i
15fc0 6e 63 72 65 61 73 65 20 6f 72 20 64 65 63 72 65 ncrease or decre
15fd0 61 73 65 0a 2a 2a 20 68 6f 77 20 77 65 6c 6c 20 ase.** how well
15fe0 74 68 65 20 64 61 74 61 62 61 73 65 20 72 65 73 the database res
15ff0 69 73 74 73 20 64 61 6d 61 67 65 20 64 75 65 20 ists damage due
16000 74 6f 20 4f 53 20 63 72 61 73 68 65 73 20 61 6e to OS crashes an
16010 64 20 70 6f 77 65 72 0a 2a 2a 20 66 61 69 6c 75 d power.** failu
16020 72 65 73 2e 20 20 4c 65 76 65 6c 20 31 20 69 73 res. Level 1 is
16030 20 74 68 65 20 73 61 6d 65 20 61 73 20 61 73 79 the same as asy
16040 6e 63 68 72 6f 6e 6f 75 73 20 28 6e 6f 20 73 79 nchronous (no sy
16050 6e 63 73 28 29 20 6f 63 63 75 72 20 61 6e 64 0a ncs() occur and.
16060 2a 2a 20 74 68 65 72 65 20 69 73 20 61 20 68 69 ** there is a hi
16070 67 68 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f gh probability o
16080 66 20 64 61 6d 61 67 65 29 20 20 4c 65 76 65 6c f damage) Level
16090 20 32 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 2 is the defaul
160a0 74 2e 20 20 54 68 65 72 65 0a 2a 2a 20 69 73 20 t. There.** is
160b0 61 20 76 65 72 79 20 6c 6f 77 20 62 75 74 20 6e a very low but n
160c0 6f 6e 2d 7a 65 72 6f 20 70 72 6f 62 61 62 69 6c on-zero probabil
160d0 69 74 79 20 6f 66 20 64 61 6d 61 67 65 2e 20 20 ity of damage.
160e0 4c 65 76 65 6c 20 33 20 72 65 64 75 63 65 73 20 Level 3 reduces
160f0 74 68 65 0a 2a 2a 20 70 72 6f 62 61 62 69 6c 69 the.** probabili
16100 74 79 20 6f 66 20 64 61 6d 61 67 65 20 74 6f 20 ty of damage to
16110 6e 65 61 72 20 7a 65 72 6f 20 62 75 74 20 77 69 near zero but wi
16120 74 68 20 61 20 77 72 69 74 65 20 70 65 72 66 6f th a write perfo
16130 72 6d 61 6e 63 65 20 72 65 64 75 63 74 69 6f 6e rmance reduction
16140 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
16150 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 ITE_OMIT_PAGER_P
16160 52 41 47 4d 41 53 0a 69 6e 74 20 73 71 6c 69 74 RAGMAS.int sqlit
16170 65 33 42 74 72 65 65 53 65 74 50 61 67 65 72 46 e3BtreeSetPagerF
16180 6c 61 67 73 28 0a 20 20 42 74 72 65 65 20 2a 70 lags(. Btree *p
16190 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
161a0 2a 20 54 68 65 20 62 74 72 65 65 20 74 6f 20 73 * The btree to s
161b0 65 74 20 74 68 65 20 73 61 66 65 74 79 20 6c 65 et the safety le
161c0 76 65 6c 20 6f 6e 20 2a 2f 0a 20 20 75 6e 73 69 vel on */. unsi
161d0 67 6e 65 64 20 70 67 46 6c 61 67 73 20 20 20 20 gned pgFlags
161e0 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 50 41 /* Various PA
161f0 47 45 52 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 29 GER_* flags */.)
16200 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
16210 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 t = p->pBt;. as
16220 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
16230 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e tex_held(p->db->
16240 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
16250 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
16260 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
16270 53 65 74 46 6c 61 67 73 28 70 42 74 2d 3e 70 50 SetFlags(pBt->pP
16280 61 67 65 72 2c 20 70 67 46 6c 61 67 73 29 3b 0a ager, pgFlags);.
16290 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
162a0 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
162b0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
162c0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e ndif../*.** Chan
162d0 67 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 ge the default p
162e0 61 67 65 73 20 73 69 7a 65 20 61 6e 64 20 74 68 ages size and th
162f0 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 e number of rese
16300 72 76 65 64 20 62 79 74 65 73 20 70 65 72 20 70 rved bytes per p
16310 61 67 65 2e 0a 2a 2a 20 4f 72 2c 20 69 66 20 74 age..** Or, if t
16320 68 65 20 70 61 67 65 20 73 69 7a 65 20 68 61 73 he page size has
16330 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 66 69 already been fi
16340 78 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 xed, return SQLI
16350 54 45 5f 52 45 41 44 4f 4e 4c 59 20 0a 2a 2a 20 TE_READONLY .**
16360 77 69 74 68 6f 75 74 20 63 68 61 6e 67 69 6e 67 without changing
16370 20 61 6e 79 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a anything..**.**
16380 20 54 68 65 20 70 61 67 65 20 73 69 7a 65 20 6d The page size m
16390 75 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 6f ust be a power o
163a0 66 20 32 20 62 65 74 77 65 65 6e 20 35 31 32 20 f 2 between 512
163b0 61 6e 64 20 36 35 35 33 36 2e 20 20 49 66 20 74 and 65536. If t
163c0 68 65 20 70 61 67 65 0a 2a 2a 20 73 69 7a 65 20 he page.** size
163d0 73 75 70 70 6c 69 65 64 20 64 6f 65 73 20 6e 6f supplied does no
163e0 74 20 6d 65 65 74 20 74 68 69 73 20 63 6f 6e 73 t meet this cons
163f0 74 72 61 69 6e 74 20 74 68 65 6e 20 74 68 65 20 traint then the
16400 70 61 67 65 20 73 69 7a 65 20 69 73 20 6e 6f 74 page size is not
16410 0a 2a 2a 20 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a .** changed..**.
16420 2a 2a 20 50 61 67 65 20 73 69 7a 65 73 20 61 72 ** Page sizes ar
16430 65 20 63 6f 6e 73 74 72 61 69 6e 65 64 20 74 6f e constrained to
16440 20 62 65 20 61 20 70 6f 77 65 72 20 6f 66 20 74 be a power of t
16450 77 6f 20 73 6f 20 74 68 61 74 20 74 68 65 20 72 wo so that the r
16460 65 67 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 egion.** of the
16470 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 75 73 database file us
16480 65 64 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 20 28 ed for locking (
16490 62 65 67 69 6e 6e 69 6e 67 20 61 74 20 50 45 4e beginning at PEN
164a0 44 49 4e 47 5f 42 59 54 45 2c 0a 2a 2a 20 74 68 DING_BYTE,.** th
164b0 65 20 66 69 72 73 74 20 62 79 74 65 20 70 61 73 e first byte pas
164c0 74 20 74 68 65 20 31 47 42 20 62 6f 75 6e 64 61 t the 1GB bounda
164d0 72 79 2c 20 30 78 34 30 30 30 30 30 30 30 29 20 ry, 0x40000000)
164e0 6e 65 65 64 73 20 74 6f 20 6f 63 63 75 72 0a 2a needs to occur.*
164f0 2a 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 * at the beginni
16500 6e 67 20 6f 66 20 61 20 70 61 67 65 2e 0a 2a 2a ng of a page..**
16510 0a 2a 2a 20 49 66 20 70 61 72 61 6d 65 74 65 72 .** If parameter
16520 20 6e 52 65 73 65 72 76 65 20 69 73 20 6c 65 73 nReserve is les
16530 73 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 s than zero, the
16540 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
16550 72 65 73 65 72 76 65 64 0a 2a 2a 20 62 79 74 65 reserved.** byte
16560 73 20 70 65 72 20 70 61 67 65 20 69 73 20 6c 65 s per page is le
16570 66 74 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a ft unchanged..**
16580 0a 2a 2a 20 49 66 20 74 68 65 20 69 46 69 78 21 .** If the iFix!
16590 3d 30 20 74 68 65 6e 20 74 68 65 20 42 54 53 5f =0 then the BTS_
165a0 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 20 66 PAGESIZE_FIXED f
165b0 6c 61 67 20 69 73 20 73 65 74 20 73 6f 20 74 68 lag is set so th
165c0 61 74 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 at the page size
165d0 0a 2a 2a 20 61 6e 64 20 61 75 74 6f 76 61 63 75 .** and autovacu
165e0 75 6d 20 6d 6f 64 65 20 63 61 6e 20 6e 6f 20 6c um mode can no l
165f0 6f 6e 67 65 72 20 62 65 20 63 68 61 6e 67 65 64 onger be changed
16600 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
16610 42 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 BtreeSetPageSize
16620 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 70 (Btree *p, int p
16630 61 67 65 53 69 7a 65 2c 20 69 6e 74 20 6e 52 65 ageSize, int nRe
16640 73 65 72 76 65 2c 20 69 6e 74 20 69 46 69 78 29 serve, int iFix)
16650 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
16660 49 54 45 5f 4f 4b 3b 0a 20 20 42 74 53 68 61 72 ITE_OK;. BtShar
16670 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
16680 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 ;. assert( nRes
16690 65 72 76 65 3e 3d 2d 31 20 26 26 20 6e 52 65 73 erve>=-1 && nRes
166a0 65 72 76 65 3c 3d 32 35 35 20 29 3b 0a 20 20 73 erve<=255 );. s
166b0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
166c0 28 70 29 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f (p);.#if SQLITE_
166d0 48 41 53 5f 43 4f 44 45 43 0a 20 20 69 66 28 20 HAS_CODEC. if(
166e0 6e 52 65 73 65 72 76 65 3e 70 42 74 2d 3e 6f 70 nReserve>pBt->op
166f0 74 69 6d 61 6c 52 65 73 65 72 76 65 20 29 20 70 timalReserve ) p
16700 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 73 65 72 Bt->optimalReser
16710 76 65 20 3d 20 28 75 38 29 6e 52 65 73 65 72 76 ve = (u8)nReserv
16720 65 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 e;.#endif. if(
16730 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
16740 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 BTS_PAGESIZE_FIX
16750 45 44 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ED ){. sqlite
16760 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
16770 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
16780 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 7d 0a E_READONLY;. }.
16790 20 20 69 66 28 20 6e 52 65 73 65 72 76 65 3c 30 if( nReserve<0
167a0 20 29 7b 0a 20 20 20 20 6e 52 65 73 65 72 76 65 ){. nReserve
167b0 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 = pBt->pageSize
167c0 20 2d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 - pBt->usableSi
167d0 7a 65 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 ze;. }. assert
167e0 28 20 6e 52 65 73 65 72 76 65 3e 3d 30 20 26 26 ( nReserve>=0 &&
167f0 20 6e 52 65 73 65 72 76 65 3c 3d 32 35 35 20 29 nReserve<=255 )
16800 3b 0a 20 20 69 66 28 20 70 61 67 65 53 69 7a 65 ;. if( pageSize
16810 3e 3d 35 31 32 20 26 26 20 70 61 67 65 53 69 7a >=512 && pageSiz
16820 65 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 e<=SQLITE_MAX_PA
16830 47 45 5f 53 49 5a 45 20 26 26 0a 20 20 20 20 20 GE_SIZE &&.
16840 20 20 20 28 28 70 61 67 65 53 69 7a 65 2d 31 29 ((pageSize-1)
16850 26 70 61 67 65 53 69 7a 65 29 3d 3d 30 20 29 7b &pageSize)==0 ){
16860 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 61 . assert( (pa
16870 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 geSize & 7)==0 )
16880 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 ;. assert( !p
16890 42 74 2d 3e 70 43 75 72 73 6f 72 20 29 3b 0a 20 Bt->pCursor );.
168a0 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 pBt->pageSize
168b0 20 3d 20 28 75 33 32 29 70 61 67 65 53 69 7a 65 = (u32)pageSize
168c0 3b 0a 20 20 20 20 66 72 65 65 54 65 6d 70 53 70 ;. freeTempSp
168d0 61 63 65 28 70 42 74 29 3b 0a 20 20 7d 0a 20 20 ace(pBt);. }.
168e0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
168f0 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 42 74 rSetPagesize(pBt
16900 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 74 2d 3e ->pPager, &pBt->
16910 70 61 67 65 53 69 7a 65 2c 20 6e 52 65 73 65 72 pageSize, nReser
16920 76 65 29 3b 0a 20 20 70 42 74 2d 3e 75 73 61 62 ve);. pBt->usab
16930 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 70 61 leSize = pBt->pa
16940 67 65 53 69 7a 65 20 2d 20 28 75 31 36 29 6e 52 geSize - (u16)nR
16950 65 73 65 72 76 65 3b 0a 20 20 69 66 28 20 69 46 eserve;. if( iF
16960 69 78 20 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 ix ) pBt->btsFla
16970 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 gs |= BTS_PAGESI
16980 5a 45 5f 46 49 58 45 44 3b 0a 20 20 73 71 6c 69 ZE_FIXED;. sqli
16990 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
169a0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
169b0 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
169c0 68 65 20 63 75 72 72 65 6e 74 6c 79 20 64 65 66 he currently def
169d0 69 6e 65 64 20 70 61 67 65 20 73 69 7a 65 0a 2a ined page size.*
169e0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
169f0 65 65 47 65 74 50 61 67 65 53 69 7a 65 28 42 74 eeGetPageSize(Bt
16a00 72 65 65 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 ree *p){. retur
16a10 6e 20 70 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 n p->pBt->pageSi
16a20 7a 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 ze;.}../*.** Thi
16a30 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 73 69 s function is si
16a40 6d 69 6c 61 72 20 74 6f 20 73 71 6c 69 74 65 33 milar to sqlite3
16a50 42 74 72 65 65 47 65 74 52 65 73 65 72 76 65 28 BtreeGetReserve(
16a60 29 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 69 ), except that i
16a70 74 0a 2a 2a 20 6d 61 79 20 6f 6e 6c 79 20 62 65 t.** may only be
16a80 20 63 61 6c 6c 65 64 20 69 66 20 69 74 20 69 73 called if it is
16a90 20 67 75 61 72 61 6e 74 65 65 64 20 74 68 61 74 guaranteed that
16aa0 20 74 68 65 20 62 2d 74 72 65 65 20 6d 75 74 65 the b-tree mute
16ab0 78 20 69 73 20 61 6c 72 65 61 64 79 0a 2a 2a 20 x is already.**
16ac0 68 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 held..**.** This
16ad0 20 69 73 20 75 73 65 66 75 6c 20 69 6e 20 6f 6e is useful in on
16ae0 65 20 73 70 65 63 69 61 6c 20 63 61 73 65 20 69 e special case i
16af0 6e 20 74 68 65 20 62 61 63 6b 75 70 20 41 50 49 n the backup API
16b00 20 63 6f 64 65 20 77 68 65 72 65 20 69 74 20 69 code where it i
16b10 73 0a 2a 2a 20 6b 6e 6f 77 6e 20 74 68 61 74 20 s.** known that
16b20 74 68 65 20 73 68 61 72 65 64 20 62 2d 74 72 65 the shared b-tre
16b30 65 20 6d 75 74 65 78 20 69 73 20 68 65 6c 64 2c e mutex is held,
16b40 20 62 75 74 20 74 68 65 20 6d 75 74 65 78 20 6f but the mutex o
16b50 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 n the .** databa
16b60 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 6f se handle that o
16b70 77 6e 73 20 2a 70 20 69 73 20 6e 6f 74 2e 20 49 wns *p is not. I
16b80 6e 20 74 68 69 73 20 63 61 73 65 20 69 66 20 73 n this case if s
16b90 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
16ba0 28 29 0a 2a 2a 20 77 65 72 65 20 74 6f 20 62 65 ().** were to be
16bb0 20 63 61 6c 6c 65 64 2c 20 69 74 20 6d 69 67 68 called, it migh
16bc0 74 20 63 6f 6c 6c 69 64 65 20 77 69 74 68 20 73 t collide with s
16bd0 6f 6d 65 20 6f 74 68 65 72 20 6f 70 65 72 61 74 ome other operat
16be0 69 6f 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 64 61 ion on the.** da
16bf0 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 68 tabase handle th
16c00 61 74 20 6f 77 6e 73 20 2a 70 2c 20 63 61 75 73 at owns *p, caus
16c10 69 6e 67 20 75 6e 64 65 66 69 6e 65 64 20 62 65 ing undefined be
16c20 68 61 76 69 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 havior..*/.int s
16c30 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 52 65 qlite3BtreeGetRe
16c40 73 65 72 76 65 4e 6f 4d 75 74 65 78 28 42 74 72 serveNoMutex(Btr
16c50 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b ee *p){. int n;
16c60 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
16c70 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d e3_mutex_held(p-
16c80 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
16c90 20 20 6e 20 3d 20 70 2d 3e 70 42 74 2d 3e 70 61 n = p->pBt->pa
16ca0 67 65 53 69 7a 65 20 2d 20 70 2d 3e 70 42 74 2d geSize - p->pBt-
16cb0 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 72 >usableSize;. r
16cc0 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn n;.}../*.*
16cd0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
16ce0 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
16cf0 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 space at the end
16d00 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 20 74 of every page t
16d10 68 61 74 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e hat.** are inten
16d20 74 75 61 6c 6c 79 20 6c 65 66 74 20 75 6e 75 73 tually left unus
16d30 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 ed. This is the
16d40 20 22 72 65 73 65 72 76 65 64 22 20 73 70 61 63 "reserved" spac
16d50 65 20 74 68 61 74 20 69 73 0a 2a 2a 20 73 6f 6d e that is.** som
16d60 65 74 69 6d 65 73 20 75 73 65 64 20 62 79 20 65 etimes used by e
16d70 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a xtensions..**.**
16d80 20 49 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 4d If SQLITE_HAS_M
16d90 55 54 45 58 20 69 73 20 64 65 66 69 6e 65 64 20 UTEX is defined
16da0 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 then the number
16db0 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 0a returned is the.
16dc0 2a 2a 20 67 72 65 61 74 65 72 20 6f 66 20 74 68 ** greater of th
16dd0 65 20 63 75 72 72 65 6e 74 20 72 65 73 65 72 76 e current reserv
16de0 65 64 20 73 70 61 63 65 20 61 6e 64 20 74 68 65 ed space and the
16df0 20 6d 61 78 69 6d 75 6d 20 72 65 71 75 65 73 74 maximum request
16e00 65 64 0a 2a 2a 20 72 65 73 65 72 76 65 20 73 70 ed.** reserve sp
16e10 61 63 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ace..*/.int sqli
16e20 74 65 33 42 74 72 65 65 47 65 74 4f 70 74 69 6d te3BtreeGetOptim
16e30 61 6c 52 65 73 65 72 76 65 28 42 74 72 65 65 20 alReserve(Btree
16e40 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 *p){. int n;.
16e50 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
16e60 72 28 70 29 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 r(p);. n = sqli
16e70 74 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 te3BtreeGetReser
16e80 76 65 4e 6f 4d 75 74 65 78 28 70 29 3b 0a 23 69 veNoMutex(p);.#i
16e90 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f fdef SQLITE_HAS_
16ea0 43 4f 44 45 43 0a 20 20 69 66 28 20 6e 3c 70 2d CODEC. if( n<p-
16eb0 3e 70 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 73 >pBt->optimalRes
16ec0 65 72 76 65 20 29 20 6e 20 3d 20 70 2d 3e 70 42 erve ) n = p->pB
16ed0 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 73 65 72 76 t->optimalReserv
16ee0 65 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 e;.#endif. sqli
16ef0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
16f00 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a ;. return n;.}.
16f10 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 ../*.** Set the
16f20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 maximum page cou
16f30 6e 74 20 66 6f 72 20 61 20 64 61 74 61 62 61 73 nt for a databas
16f40 65 20 69 66 20 6d 78 50 61 67 65 20 69 73 20 70 e if mxPage is p
16f50 6f 73 69 74 69 76 65 2e 0a 2a 2a 20 4e 6f 20 63 ositive..** No c
16f60 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 hanges are made
16f70 69 66 20 6d 78 50 61 67 65 20 69 73 20 30 20 6f if mxPage is 0 o
16f80 72 20 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 52 r negative..** R
16f90 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 egardless of the
16fa0 20 76 61 6c 75 65 20 6f 66 20 6d 78 50 61 67 65 value of mxPage
16fb0 2c 20 72 65 74 75 72 6e 20 74 68 65 20 6d 61 78 , return the max
16fc0 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 2e imum page count.
16fd0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
16fe0 74 72 65 65 4d 61 78 50 61 67 65 43 6f 75 6e 74 treeMaxPageCount
16ff0 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6d (Btree *p, int m
17000 78 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 6e 3b xPage){. int n;
17010 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
17020 6e 74 65 72 28 70 29 3b 0a 20 20 6e 20 3d 20 73 nter(p);. n = s
17030 71 6c 69 74 65 33 50 61 67 65 72 4d 61 78 50 61 qlite3PagerMaxPa
17040 67 65 43 6f 75 6e 74 28 70 2d 3e 70 42 74 2d 3e geCount(p->pBt->
17050 70 50 61 67 65 72 2c 20 6d 78 50 61 67 65 29 3b pPager, mxPage);
17060 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
17070 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
17080 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 n n;.}../*.** Se
17090 74 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 45 t the BTS_SECURE
170a0 5f 44 45 4c 45 54 45 20 66 6c 61 67 20 69 66 20 _DELETE flag if
170b0 6e 65 77 46 6c 61 67 20 69 73 20 30 20 6f 72 20 newFlag is 0 or
170c0 31 2e 20 20 49 66 20 6e 65 77 46 6c 61 67 20 69 1. If newFlag i
170d0 73 20 2d 31 2c 0a 2a 2a 20 74 68 65 6e 20 6d 61 s -1,.** then ma
170e0 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 2e 20 20 ke no changes.
170f0 41 6c 77 61 79 73 20 72 65 74 75 72 6e 20 74 68 Always return th
17100 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 42 e value of the B
17110 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 TS_SECURE_DELETE
17120 0a 2a 2a 20 73 65 74 74 69 6e 67 20 61 66 74 65 .** setting afte
17130 72 20 74 68 65 20 63 68 61 6e 67 65 2e 0a 2a 2f r the change..*/
17140 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
17150 65 53 65 63 75 72 65 44 65 6c 65 74 65 28 42 74 eSecureDelete(Bt
17160 72 65 65 20 2a 70 2c 20 69 6e 74 20 6e 65 77 46 ree *p, int newF
17170 6c 61 67 29 7b 0a 20 20 69 6e 74 20 62 3b 0a 20 lag){. int b;.
17180 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 if( p==0 ) retu
17190 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 rn 0;. sqlite3B
171a0 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
171b0 69 66 28 20 6e 65 77 46 6c 61 67 3e 3d 30 20 29 if( newFlag>=0 )
171c0 7b 0a 20 20 20 20 70 2d 3e 70 42 74 2d 3e 62 74 {. p->pBt->bt
171d0 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f 53 sFlags &= ~BTS_S
171e0 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 ECURE_DELETE;.
171f0 20 20 69 66 28 20 6e 65 77 46 6c 61 67 20 29 20 if( newFlag )
17200 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 p->pBt->btsFlags
17210 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 45 5f 44 |= BTS_SECURE_D
17220 45 4c 45 54 45 3b 0a 20 20 7d 20 0a 20 20 62 20 ELETE;. } . b
17230 3d 20 28 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c = (p->pBt->btsFl
17240 61 67 73 20 26 20 42 54 53 5f 53 45 43 55 52 45 ags & BTS_SECURE
17250 5f 44 45 4c 45 54 45 29 21 3d 30 3b 0a 20 20 73 _DELETE)!=0;. s
17260 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
17270 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 3b (p);. return b;
17280 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 .}../*.** Change
17290 20 74 68 65 20 27 61 75 74 6f 2d 76 61 63 75 75 the 'auto-vacuu
172a0 6d 27 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 m' property of t
172b0 68 65 20 64 61 74 61 62 61 73 65 2e 20 49 66 20 he database. If
172c0 74 68 65 20 27 61 75 74 6f 56 61 63 75 75 6d 27 the 'autoVacuum'
172d0 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 73 .** parameter is
172e0 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 non-zero, then
172f0 61 75 74 6f 2d 76 61 63 75 75 6d 20 6d 6f 64 65 auto-vacuum mode
17300 20 69 73 20 65 6e 61 62 6c 65 64 2e 20 49 66 20 is enabled. If
17310 7a 65 72 6f 2c 20 69 74 0a 2a 2a 20 69 73 20 64 zero, it.** is d
17320 69 73 61 62 6c 65 64 2e 20 54 68 65 20 64 65 66 isabled. The def
17330 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 74 ault value for t
17340 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 70 he auto-vacuum p
17350 72 6f 70 65 72 74 79 20 69 73 20 0a 2a 2a 20 64 roperty is .** d
17360 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 etermined by the
17370 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
17380 41 55 54 4f 56 41 43 55 55 4d 20 6d 61 63 72 6f AUTOVACUUM macro
17390 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
173a0 42 74 72 65 65 53 65 74 41 75 74 6f 56 61 63 75 BtreeSetAutoVacu
173b0 75 6d 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 um(Btree *p, int
173c0 20 61 75 74 6f 56 61 63 75 75 6d 29 7b 0a 23 69 autoVacuum){.#i
173d0 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
173e0 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 72 65 _AUTOVACUUM. re
173f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 turn SQLITE_READ
17400 4f 4e 4c 59 3b 0a 23 65 6c 73 65 0a 20 20 42 74 ONLY;.#else. Bt
17410 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
17420 3e 70 42 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d >pBt;. int rc =
17430 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 38 SQLITE_OK;. u8
17440 20 61 76 20 3d 20 28 75 38 29 61 75 74 6f 56 61 av = (u8)autoVa
17450 63 75 75 6d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 cuum;.. sqlite3
17460 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
17470 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 46 6c if( (pBt->btsFl
17480 61 67 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 ags & BTS_PAGESI
17490 5a 45 5f 46 49 58 45 44 29 21 3d 30 20 26 26 20 ZE_FIXED)!=0 &&
174a0 28 61 76 20 3f 31 3a 30 29 21 3d 70 42 74 2d 3e (av ?1:0)!=pBt->
174b0 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 autoVacuum ){.
174c0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 rc = SQLITE_RE
174d0 41 44 4f 4e 4c 59 3b 0a 20 20 7d 65 6c 73 65 7b ADONLY;. }else{
174e0 0a 20 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 . pBt->autoVa
174f0 63 75 75 6d 20 3d 20 61 76 20 3f 31 3a 30 3b 0a cuum = av ?1:0;.
17500 20 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 pBt->incrVac
17510 75 75 6d 20 3d 20 61 76 3d 3d 32 20 3f 31 3a 30 uum = av==2 ?1:0
17520 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 ;. }. sqlite3B
17530 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
17540 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
17550 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 f.}../*.** Retur
17560 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 n the value of t
17570 68 65 20 27 61 75 74 6f 2d 76 61 63 75 75 6d 27 he 'auto-vacuum'
17580 20 70 72 6f 70 65 72 74 79 2e 20 49 66 20 61 75 property. If au
17590 74 6f 2d 76 61 63 75 75 6d 20 69 73 20 0a 2a 2a to-vacuum is .**
175a0 20 65 6e 61 62 6c 65 64 20 31 20 69 73 20 72 65 enabled 1 is re
175b0 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 turned. Otherwis
175c0 65 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 e 0..*/.int sqli
175d0 74 65 33 42 74 72 65 65 47 65 74 41 75 74 6f 56 te3BtreeGetAutoV
175e0 61 63 75 75 6d 28 42 74 72 65 65 20 2a 70 29 7b acuum(Btree *p){
175f0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
17600 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
17610 20 72 65 74 75 72 6e 20 42 54 52 45 45 5f 41 55 return BTREE_AU
17620 54 4f 56 41 43 55 55 4d 5f 4e 4f 4e 45 3b 0a 23 TOVACUUM_NONE;.#
17630 65 6c 73 65 0a 20 20 69 6e 74 20 72 63 3b 0a 20 else. int rc;.
17640 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
17650 65 72 28 70 29 3b 0a 20 20 72 63 20 3d 20 28 0a er(p);. rc = (.
17660 20 20 20 20 28 21 70 2d 3e 70 42 74 2d 3e 61 75 (!p->pBt->au
17670 74 6f 56 61 63 75 75 6d 29 3f 42 54 52 45 45 5f toVacuum)?BTREE_
17680 41 55 54 4f 56 41 43 55 55 4d 5f 4e 4f 4e 45 3a AUTOVACUUM_NONE:
17690 0a 20 20 20 20 28 21 70 2d 3e 70 42 74 2d 3e 69 . (!p->pBt->i
176a0 6e 63 72 56 61 63 75 75 6d 29 3f 42 54 52 45 45 ncrVacuum)?BTREE
176b0 5f 41 55 54 4f 56 41 43 55 55 4d 5f 46 55 4c 4c _AUTOVACUUM_FULL
176c0 3a 0a 20 20 20 20 42 54 52 45 45 5f 41 55 54 4f :. BTREE_AUTO
176d0 56 41 43 55 55 4d 5f 49 4e 43 52 0a 20 20 29 3b VACUUM_INCR. );
176e0 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
176f0 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
17700 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a n rc;.#endif.}..
17710 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 72 65 66 ./*.** Get a ref
17720 65 72 65 6e 63 65 20 74 6f 20 70 50 61 67 65 31 erence to pPage1
17730 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
17740 20 66 69 6c 65 2e 20 20 54 68 69 73 20 77 69 6c file. This wil
17750 6c 0a 2a 2a 20 61 6c 73 6f 20 61 63 71 75 69 72 l.** also acquir
17760 65 20 61 20 72 65 61 64 6c 6f 63 6b 20 6f 6e 20 e a readlock on
17770 74 68 61 74 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a that file..**.**
17780 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
17790 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 turned on succes
177a0 73 2e 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 s. If the file
177b0 69 73 20 6e 6f 74 20 61 0a 2a 2a 20 77 65 6c 6c is not a.** well
177c0 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 -formed database
177d0 20 66 69 6c 65 2c 20 74 68 65 6e 20 53 51 4c 49 file, then SQLI
177e0 54 45 5f 43 4f 52 52 55 50 54 20 69 73 20 72 65 TE_CORRUPT is re
177f0 74 75 72 6e 65 64 2e 0a 2a 2a 20 53 51 4c 49 54 turned..** SQLIT
17800 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e E_BUSY is return
17810 65 64 20 69 66 20 74 68 65 20 64 61 74 61 62 61 ed if the databa
17820 73 65 20 69 73 20 6c 6f 63 6b 65 64 2e 20 20 53 se is locked. S
17830 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a 20 69 QLITE_NOMEM.** i
17840 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 77 65 s returned if we
17850 20 72 75 6e 20 6f 75 74 20 6f 66 20 6d 65 6d 6f run out of memo
17860 72 79 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ry. .*/.static i
17870 6e 74 20 6c 6f 63 6b 42 74 72 65 65 28 42 74 53 nt lockBtree(BtS
17880 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 hared *pBt){. i
17890 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
178a0 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f /* Result co
178b0 64 65 20 66 72 6f 6d 20 73 75 62 66 75 6e 63 74 de from subfunct
178c0 69 6f 6e 73 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 ions */. MemPag
178d0 65 20 2a 70 50 61 67 65 31 3b 20 20 20 20 20 2f e *pPage1; /
178e0 2a 20 50 61 67 65 20 31 20 6f 66 20 74 68 65 20 * Page 1 of the
178f0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f database file */
17900 0a 20 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20 . int nPage;
17910 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
17920 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
17930 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 e database */.
17940 69 6e 74 20 6e 50 61 67 65 46 69 6c 65 20 3d 20 int nPageFile =
17950 30 3b 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 0; /* Number o
17960 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 f pages in the d
17970 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
17980 20 20 69 6e 74 20 6e 50 61 67 65 48 65 61 64 65 int nPageHeade
17990 72 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 r; /* Number
179a0 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 of pages in the
179b0 20 64 61 74 61 62 61 73 65 20 61 63 63 6f 72 64 database accord
179c0 69 6e 67 20 74 6f 20 68 64 72 20 2a 2f 0a 0a 20 ing to hdr */..
179d0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
179e0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
179f0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
17a00 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 ert( pBt->pPage1
17a10 3d 3d 30 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 ==0 );. rc = sq
17a20 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 65 64 lite3PagerShared
17a30 4c 6f 63 6b 28 70 42 74 2d 3e 70 50 61 67 65 72 Lock(pBt->pPager
17a40 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
17a50 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
17a60 72 63 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 rc;. rc = btree
17a70 47 65 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 GetPage(pBt, 1,
17a80 26 70 50 61 67 65 31 2c 20 30 29 3b 0a 20 20 69 &pPage1, 0);. i
17a90 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
17aa0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 ) return rc;..
17ab0 20 2f 2a 20 44 6f 20 73 6f 6d 65 20 63 68 65 63 /* Do some chec
17ac0 6b 69 6e 67 20 74 6f 20 68 65 6c 70 20 69 6e 73 king to help ins
17ad0 75 72 65 20 74 68 65 20 66 69 6c 65 20 77 65 20 ure the file we
17ae0 6f 70 65 6e 65 64 20 72 65 61 6c 6c 79 20 69 73 opened really is
17af0 0a 20 20 2a 2a 20 61 20 76 61 6c 69 64 20 64 61 . ** a valid da
17b00 74 61 62 61 73 65 20 66 69 6c 65 2e 20 0a 20 20 tabase file. .
17b10 2a 2f 0a 20 20 6e 50 61 67 65 20 3d 20 6e 50 61 */. nPage = nPa
17b20 67 65 48 65 61 64 65 72 20 3d 20 67 65 74 34 62 geHeader = get4b
17b30 79 74 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 yte(28+(u8*)pPag
17b40 65 31 2d 3e 61 44 61 74 61 29 3b 0a 20 20 73 71 e1->aData);. sq
17b50 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f lite3PagerPageco
17b60 75 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c unt(pBt->pPager,
17b70 20 26 6e 50 61 67 65 46 69 6c 65 29 3b 0a 20 20 &nPageFile);.
17b80 69 66 28 20 6e 50 61 67 65 3d 3d 30 20 7c 7c 20 if( nPage==0 ||
17b90 6d 65 6d 63 6d 70 28 32 34 2b 28 75 38 2a 29 70 memcmp(24+(u8*)p
17ba0 50 61 67 65 31 2d 3e 61 44 61 74 61 2c 20 39 32 Page1->aData, 92
17bb0 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 +(u8*)pPage1->aD
17bc0 61 74 61 2c 34 29 21 3d 30 20 29 7b 0a 20 20 20 ata,4)!=0 ){.
17bd0 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 46 69 nPage = nPageFi
17be0 6c 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 50 le;. }. if( nP
17bf0 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 75 33 32 age>0 ){. u32
17c00 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 75 pageSize;. u
17c10 33 32 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 32 usableSize;.
17c20 20 20 20 75 38 20 2a 70 61 67 65 31 20 3d 20 70 u8 *page1 = p
17c30 50 61 67 65 31 2d 3e 61 44 61 74 61 3b 0a 20 20 Page1->aData;.
17c40 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
17c50 54 41 44 42 3b 0a 20 20 20 20 2f 2a 20 45 56 49 TADB;. /* EVI
17c60 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 33 37 33 DENCE-OF: R-4373
17c70 37 2d 33 39 39 39 39 20 45 76 65 72 79 20 76 61 7-39999 Every va
17c80 6c 69 64 20 53 51 4c 69 74 65 20 64 61 74 61 62 lid SQLite datab
17c90 61 73 65 20 66 69 6c 65 20 62 65 67 69 6e 73 0a ase file begins.
17ca0 20 20 20 20 2a 2a 20 77 69 74 68 20 74 68 65 20 ** with the
17cb0 66 6f 6c 6c 6f 77 69 6e 67 20 31 36 20 62 79 74 following 16 byt
17cc0 65 73 20 28 69 6e 20 68 65 78 29 3a 20 35 33 20 es (in hex): 53
17cd0 35 31 20 34 63 20 36 39 20 37 34 20 36 35 20 32 51 4c 69 74 65 2
17ce0 30 20 36 36 20 36 66 20 37 32 20 36 64 0a 20 20 0 66 6f 72 6d.
17cf0 20 20 2a 2a 20 36 31 20 37 34 20 32 30 20 33 33 ** 61 74 20 33
17d00 20 30 30 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 00. */. if(
17d10 6d 65 6d 63 6d 70 28 70 61 67 65 31 2c 20 7a 4d memcmp(page1, zM
17d20 61 67 69 63 48 65 61 64 65 72 2c 20 31 36 29 21 agicHeader, 16)!
17d30 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f =0 ){. goto
17d40 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
17d50 65 64 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 ed;. }..#ifde
17d60 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
17d70 4c 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 5b L. if( page1[
17d80 31 38 5d 3e 31 20 29 7b 0a 20 20 20 20 20 20 70 18]>1 ){. p
17d90 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 Bt->btsFlags |=
17da0 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 20 BTS_READ_ONLY;.
17db0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 61 67 }. if( pag
17dc0 65 31 5b 31 39 5d 3e 31 20 29 7b 0a 20 20 20 20 e1[19]>1 ){.
17dd0 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
17de0 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
17df0 23 65 6c 73 65 0a 20 20 20 20 69 66 28 20 70 61 #else. if( pa
17e00 67 65 31 5b 31 38 5d 3e 32 20 29 7b 0a 20 20 20 ge1[18]>2 ){.
17e10 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 pBt->btsFlags
17e20 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c |= BTS_READ_ONL
17e30 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 Y;. }. if(
17e40 20 70 61 67 65 31 5b 31 39 5d 3e 32 20 29 7b 0a page1[19]>2 ){.
17e50 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 goto page1
17e60 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 _init_failed;.
17e70 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 }.. /* If t
17e80 68 65 20 77 72 69 74 65 20 76 65 72 73 69 6f 6e he write version
17e90 20 69 73 20 73 65 74 20 74 6f 20 32 2c 20 74 68 is set to 2, th
17ea0 69 73 20 64 61 74 61 62 61 73 65 20 73 68 6f 75 is database shou
17eb0 6c 64 20 62 65 20 61 63 63 65 73 73 65 64 0a 20 ld be accessed.
17ec0 20 20 20 2a 2a 20 69 6e 20 57 41 4c 20 6d 6f 64 ** in WAL mod
17ed0 65 2e 20 49 66 20 74 68 65 20 6c 6f 67 20 69 73 e. If the log is
17ee0 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 not already ope
17ef0 6e 2c 20 6f 70 65 6e 20 69 74 20 6e 6f 77 2e 20 n, open it now.
17f00 54 68 65 6e 20 0a 20 20 20 20 2a 2a 20 72 65 74 Then . ** ret
17f10 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 61 6e urn SQLITE_OK an
17f20 64 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 74 d return without
17f30 20 70 6f 70 75 6c 61 74 69 6e 67 20 42 74 53 68 populating BtSh
17f40 61 72 65 64 2e 70 50 61 67 65 31 2e 0a 20 20 20 ared.pPage1..
17f50 20 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 64 ** The caller d
17f60 65 74 65 63 74 73 20 74 68 69 73 20 61 6e 64 20 etects this and
17f70 63 61 6c 6c 73 20 74 68 69 73 20 66 75 6e 63 74 calls this funct
17f80 69 6f 6e 20 61 67 61 69 6e 2e 20 54 68 69 73 20 ion again. This
17f90 69 73 0a 20 20 20 20 2a 2a 20 72 65 71 75 69 72 is. ** requir
17fa0 65 64 20 61 73 20 74 68 65 20 76 65 72 73 69 6f ed as the versio
17fb0 6e 20 6f 66 20 70 61 67 65 20 31 20 63 75 72 72 n of page 1 curr
17fc0 65 6e 74 6c 79 20 69 6e 20 74 68 65 20 70 61 67 ently in the pag
17fd0 65 31 20 62 75 66 66 65 72 0a 20 20 20 20 2a 2a e1 buffer. **
17fe0 20 6d 61 79 20 6e 6f 74 20 62 65 20 74 68 65 20 may not be the
17ff0 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e 20 2d latest version -
18000 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 61 20 there may be a
18010 6e 65 77 65 72 20 6f 6e 65 20 69 6e 20 74 68 65 newer one in the
18020 20 6c 6f 67 0a 20 20 20 20 2a 2a 20 66 69 6c 65 log. ** file
18030 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
18040 20 70 61 67 65 31 5b 31 39 5d 3d 3d 32 20 26 26 page1[19]==2 &&
18050 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
18060 26 20 42 54 53 5f 4e 4f 5f 57 41 4c 29 3d 3d 30 & BTS_NO_WAL)==0
18070 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 73 ){. int is
18080 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20 Open = 0;.
18090 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
180a0 72 4f 70 65 6e 57 61 6c 28 70 42 74 2d 3e 70 50 rOpenWal(pBt->pP
180b0 61 67 65 72 2c 20 26 69 73 4f 70 65 6e 29 3b 0a ager, &isOpen);.
180c0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
180d0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
180e0 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e goto page1_in
180f0 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 20 it_failed;.
18100 20 7d 65 6c 73 65 7b 0a 23 69 66 20 53 51 4c 49 }else{.#if SQLI
18110 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 TE_DEFAULT_SYNCH
18120 52 4f 4e 4f 55 53 21 3d 53 51 4c 49 54 45 5f 44 RONOUS!=SQLITE_D
18130 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 48 EFAULT_WAL_SYNCH
18140 52 4f 4e 4f 55 53 0a 20 20 20 20 20 20 20 20 73 RONOUS. s
18150 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 20 20 qlite3 *db;.
18160 20 20 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 20 Db *pDb;.
18170 20 20 20 20 20 69 66 28 20 28 64 62 3d 70 42 74 if( (db=pBt
18180 2d 3e 64 62 29 21 3d 30 20 26 26 20 28 70 44 62 ->db)!=0 && (pDb
18190 3d 64 62 2d 3e 61 44 62 29 21 3d 30 20 29 7b 0a =db->aDb)!=0 ){.
181a0 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 while(
181b0 20 70 44 62 2d 3e 70 42 74 3d 3d 30 20 7c 7c 20 pDb->pBt==0 ||
181c0 70 44 62 2d 3e 70 42 74 2d 3e 70 42 74 21 3d 70 pDb->pBt->pBt!=p
181d0 42 74 20 29 7b 20 70 44 62 2b 2b 3b 20 7d 0a 20 Bt ){ pDb++; }.
181e0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 44 62 if( pDb
181f0 2d 3e 62 53 79 6e 63 53 65 74 3d 3d 30 0a 20 20 ->bSyncSet==0.
18200 20 20 20 20 20 20 20 20 20 26 26 20 70 44 62 2d && pDb-
18210 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 3d 3d 53 >safety_level==S
18220 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 QLITE_DEFAULT_SY
18230 4e 43 48 52 4f 4e 4f 55 53 2b 31 0a 20 20 20 20 NCHRONOUS+1.
18240 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
18250 20 20 20 20 20 70 44 62 2d 3e 73 61 66 65 74 79 pDb->safety
18260 5f 6c 65 76 65 6c 20 3d 20 53 51 4c 49 54 45 5f _level = SQLITE_
18270 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 DEFAULT_WAL_SYNC
18280 48 52 4f 4e 4f 55 53 2b 31 3b 0a 20 20 20 20 20 HRONOUS+1;.
18290 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 sqlite3Pa
182a0 67 65 72 53 65 74 46 6c 61 67 73 28 70 42 74 2d gerSetFlags(pBt-
182b0 3e 70 50 61 67 65 72 2c 0a 20 20 20 20 20 20 20 >pPager,.
182c0 20 20 20 20 20 20 20 20 70 44 62 2d 3e 73 61 66 pDb->saf
182d0 65 74 79 5f 6c 65 76 65 6c 20 7c 20 28 64 62 2d ety_level | (db-
182e0 3e 66 6c 61 67 73 20 26 20 50 41 47 45 52 5f 46 >flags & PAGER_F
182f0 4c 41 47 53 5f 4d 41 53 4b 29 29 3b 0a 20 20 20 LAGS_MASK));.
18300 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
18310 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 }.#endif.
18320 20 20 69 66 28 20 69 73 4f 70 65 6e 3d 3d 30 20 if( isOpen==0
18330 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c ){. rel
18340 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 easePage(pPage1)
18350 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 ;. retu
18360 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
18370 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
18380 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
18390 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 7d 0a E_NOTADB;. }.
183a0 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 45 #endif.. /* E
183b0 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 35 VIDENCE-OF: R-15
183c0 34 36 35 2d 32 30 38 31 33 20 54 68 65 20 6d 61 465-20813 The ma
183d0 78 69 6d 75 6d 20 61 6e 64 20 6d 69 6e 69 6d 75 ximum and minimu
183e0 6d 20 65 6d 62 65 64 64 65 64 20 70 61 79 6c 6f m embedded paylo
183f0 61 64 0a 20 20 20 20 2a 2a 20 66 72 61 63 74 69 ad. ** fracti
18400 6f 6e 73 20 61 6e 64 20 74 68 65 20 6c 65 61 66 ons and the leaf
18410 20 70 61 79 6c 6f 61 64 20 66 72 61 63 74 69 6f payload fractio
18420 6e 20 76 61 6c 75 65 73 20 6d 75 73 74 20 62 65 n values must be
18430 20 36 34 2c 20 33 32 2c 20 61 6e 64 20 33 32 2e 64, 32, and 32.
18440 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
18450 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 65 73 69 he original desi
18460 67 6e 20 61 6c 6c 6f 77 65 64 20 74 68 65 73 65 gn allowed these
18470 20 61 6d 6f 75 6e 74 73 20 74 6f 20 76 61 72 79 amounts to vary
18480 2c 20 62 75 74 20 61 73 20 6f 66 0a 20 20 20 20 , but as of.
18490 2a 2a 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e 30 ** version 3.6.0
184a0 2c 20 77 65 20 72 65 71 75 69 72 65 20 74 68 65 , we require the
184b0 6d 20 74 6f 20 62 65 20 66 69 78 65 64 2e 0a 20 m to be fixed..
184c0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6d 65 */. if( me
184d0 6d 63 6d 70 28 26 70 61 67 65 31 5b 32 31 5d 2c mcmp(&page1[21],
184e0 20 22 5c 31 30 30 5c 30 34 30 5c 30 34 30 22 2c "\100\040\040",
184f0 33 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 3)!=0 ){. g
18500 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 oto page1_init_f
18510 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 ailed;. }.
18520 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
18530 20 52 2d 35 31 38 37 33 2d 33 39 36 31 38 20 54 R-51873-39618 T
18540 68 65 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 he page size for
18550 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 a database file
18560 20 69 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 is. ** deter
18570 6d 69 6e 65 64 20 62 79 20 74 68 65 20 32 2d 62 mined by the 2-b
18580 79 74 65 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 yte integer loca
18590 74 65 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 ted at an offset
185a0 20 6f 66 20 31 36 20 62 79 74 65 73 20 66 72 6f of 16 bytes fro
185b0 6d 0a 20 20 20 20 2a 2a 20 74 68 65 20 62 65 67 m. ** the beg
185c0 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 61 inning of the da
185d0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a tabase file. */.
185e0 20 20 20 20 70 61 67 65 53 69 7a 65 20 3d 20 28 pageSize = (
185f0 70 61 67 65 31 5b 31 36 5d 3c 3c 38 29 20 7c 20 page1[16]<<8) |
18600 28 70 61 67 65 31 5b 31 37 5d 3c 3c 31 36 29 3b (page1[17]<<16);
18610 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
18620 2d 4f 46 3a 20 52 2d 32 35 30 30 38 2d 32 31 36 -OF: R-25008-216
18630 38 38 20 54 68 65 20 73 69 7a 65 20 6f 66 20 61 88 The size of a
18640 20 70 61 67 65 20 69 73 20 61 20 70 6f 77 65 72 page is a power
18650 20 6f 66 20 74 77 6f 0a 20 20 20 20 2a 2a 20 62 of two. ** b
18660 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 etween 512 and 6
18670 35 35 33 36 20 69 6e 63 6c 75 73 69 76 65 2e 20 5536 inclusive.
18680 2a 2f 0a 20 20 20 20 69 66 28 20 28 28 70 61 67 */. if( ((pag
18690 65 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a eSize-1)&pageSiz
186a0 65 29 21 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 e)!=0. || pa
186b0 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 geSize>SQLITE_MA
186c0 58 5f 50 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 X_PAGE_SIZE .
186d0 20 20 7c 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 || pageSize<=2
186e0 35 36 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 56 . ){.
186f0 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
18700 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
18710 20 20 20 61 73 73 65 72 74 28 20 28 70 61 67 65 assert( (page
18720 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a Size & 7)==0 );.
18730 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
18740 4f 46 3a 20 52 2d 35 39 33 31 30 2d 35 31 32 30 OF: R-59310-5120
18750 35 20 54 68 65 20 22 72 65 73 65 72 76 65 64 20 5 The "reserved
18760 73 70 61 63 65 22 20 73 69 7a 65 20 69 6e 20 74 space" size in t
18770 68 65 20 31 2d 62 79 74 65 0a 20 20 20 20 2a 2a he 1-byte. **
18780 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 integer at offs
18790 65 74 20 32 30 20 69 73 20 74 68 65 20 6e 75 6d et 20 is the num
187a0 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
187b0 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 space at the end
187c0 20 6f 66 0a 20 20 20 20 2a 2a 20 65 61 63 68 20 of. ** each
187d0 70 61 67 65 20 74 6f 20 72 65 73 65 72 76 65 20 page to reserve
187e0 66 6f 72 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 for extensions.
187f0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 . **. ** E
18800 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 VIDENCE-OF: R-37
18810 34 39 37 2d 34 32 34 31 32 20 54 68 65 20 73 69 497-42412 The si
18820 7a 65 20 6f 66 20 74 68 65 20 72 65 73 65 72 76 ze of the reserv
18830 65 64 20 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 ed region is.
18840 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 ** determined b
18850 79 20 74 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 y the one-byte u
18860 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 nsigned integer
18870 66 6f 75 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 found at an offs
18880 65 74 20 6f 66 20 32 30 0a 20 20 20 20 2a 2a 20 et of 20. **
18890 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 into the databas
188a0 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 2a e file header. *
188b0 2f 0a 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 /. usableSize
188c0 20 3d 20 70 61 67 65 53 69 7a 65 20 2d 20 70 61 = pageSize - pa
188d0 67 65 31 5b 32 30 5d 3b 0a 20 20 20 20 69 66 28 ge1[20];. if(
188e0 20 28 75 33 32 29 70 61 67 65 53 69 7a 65 21 3d (u32)pageSize!=
188f0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b pBt->pageSize ){
18900 0a 20 20 20 20 20 20 2f 2a 20 41 66 74 65 72 20 . /* After
18910 72 65 61 64 69 6e 67 20 74 68 65 20 66 69 72 73 reading the firs
18920 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 t page of the da
18930 74 61 62 61 73 65 20 61 73 73 75 6d 69 6e 67 20 tabase assuming
18940 61 20 70 61 67 65 20 73 69 7a 65 0a 20 20 20 20 a page size.
18950 20 20 2a 2a 20 6f 66 20 42 74 53 68 61 72 65 64 ** of BtShared
18960 2e 70 61 67 65 53 69 7a 65 2c 20 77 65 20 68 61 .pageSize, we ha
18970 76 65 20 64 69 73 63 6f 76 65 72 65 64 20 74 68 ve discovered th
18980 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 at the page-size
18990 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 is. ** act
189a0 75 61 6c 6c 79 20 70 61 67 65 53 69 7a 65 2e 20 ually pageSize.
189b0 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 Unlock the datab
189c0 61 73 65 2c 20 6c 65 61 76 65 20 70 42 74 2d 3e ase, leave pBt->
189d0 70 50 61 67 65 31 20 61 74 0a 20 20 20 20 20 20 pPage1 at.
189e0 2a 2a 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 ** zero and retu
189f0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 rn SQLITE_OK. Th
18a00 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 63 61 e caller will ca
18a10 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ll this function
18a20 0a 20 20 20 20 20 20 2a 2a 20 61 67 61 69 6e 20 . ** again
18a30 77 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 74 with the correct
18a40 20 70 61 67 65 2d 73 69 7a 65 2e 0a 20 20 20 20 page-size..
18a50 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 6c 65 61 */. relea
18a60 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a sePage(pPage1);.
18a70 20 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c pBt->usabl
18a80 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 eSize = usableSi
18a90 7a 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 ze;. pBt->p
18aa0 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 ageSize = pageSi
18ab0 7a 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 ze;. freeTe
18ac0 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 mpSpace(pBt);.
18ad0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
18ae0 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
18af0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 (pBt->pPager, &p
18b00 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 Bt->pageSize,.
18b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18b30 20 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 pageSize-usable
18b40 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 Size);. ret
18b50 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
18b60 20 20 69 66 28 20 28 70 42 74 2d 3e 64 62 2d 3e if( (pBt->db->
18b70 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 flags & SQLITE_R
18b80 65 63 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 20 ecoveryMode)==0
18b90 26 26 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 69 && nPage>nPageFi
18ba0 6c 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d le ){. rc =
18bb0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
18bc0 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f BKPT;. goto
18bd0 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
18be0 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a ed;. }. /*
18bf0 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
18c00 32 38 33 31 32 2d 36 34 37 30 34 20 48 6f 77 65 28312-64704 Howe
18c10 76 65 72 2c 20 74 68 65 20 75 73 61 62 6c 65 20 ver, the usable
18c20 73 69 7a 65 20 69 73 20 6e 6f 74 20 61 6c 6c 6f size is not allo
18c30 77 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 wed to. ** be
18c40 20 6c 65 73 73 20 74 68 61 6e 20 34 38 30 2e 20 less than 480.
18c50 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words,
18c60 69 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 if the page size
18c70 20 69 73 20 35 31 32 2c 20 74 68 65 6e 20 74 68 is 512, then th
18c80 65 0a 20 20 20 20 2a 2a 20 72 65 73 65 72 76 65 e. ** reserve
18c90 64 20 73 70 61 63 65 20 73 69 7a 65 20 63 61 6e d space size can
18ca0 6e 6f 74 20 65 78 63 65 65 64 20 33 32 2e 20 2a not exceed 32. *
18cb0 2f 0a 20 20 20 20 69 66 28 20 75 73 61 62 6c 65 /. if( usable
18cc0 53 69 7a 65 3c 34 38 30 20 29 7b 0a 20 20 20 20 Size<480 ){.
18cd0 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
18ce0 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
18cf0 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a pBt->pageSiz
18d00 65 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 e = pageSize;.
18d10 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a pBt->usableSiz
18d20 65 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a e = usableSize;.
18d30 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
18d40 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
18d50 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
18d60 75 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 um = (get4byte(&
18d70 70 61 67 65 31 5b 33 36 20 2b 20 34 2a 34 5d 29 page1[36 + 4*4])
18d80 3f 31 3a 30 29 3b 0a 20 20 20 20 70 42 74 2d 3e ?1:0);. pBt->
18d90 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 incrVacuum = (ge
18da0 74 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 t4byte(&page1[36
18db0 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 0a 23 + 7*4])?1:0);.#
18dc0 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 endif. }.. /*
18dd0 6d 61 78 4c 6f 63 61 6c 20 69 73 20 74 68 65 20 maxLocal is the
18de0 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f maximum amount o
18df0 66 20 70 61 79 6c 6f 61 64 20 74 6f 20 73 74 6f f payload to sto
18e00 72 65 20 6c 6f 63 61 6c 6c 79 20 66 6f 72 0a 20 re locally for.
18e10 20 2a 2a 20 61 20 63 65 6c 6c 2e 20 20 4d 61 6b ** a cell. Mak
18e20 65 20 73 75 72 65 20 69 74 20 69 73 20 73 6d 61 e sure it is sma
18e30 6c 6c 20 65 6e 6f 75 67 68 20 73 6f 20 74 68 61 ll enough so tha
18e40 74 20 61 74 20 6c 65 61 73 74 20 6d 69 6e 46 61 t at least minFa
18e50 6e 6f 75 74 0a 20 20 2a 2a 20 63 65 6c 6c 73 20 nout. ** cells
18e60 63 61 6e 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 can will fit on
18e70 6f 6e 65 20 70 61 67 65 2e 20 20 57 65 20 61 73 one page. We as
18e80 73 75 6d 65 20 61 20 31 30 2d 62 79 74 65 20 70 sume a 10-byte p
18e90 61 67 65 20 68 65 61 64 65 72 2e 0a 20 20 2a 2a age header.. **
18ea0 20 42 65 73 69 64 65 73 20 74 68 65 20 70 61 79 Besides the pay
18eb0 6c 6f 61 64 2c 20 74 68 65 20 63 65 6c 6c 20 6d load, the cell m
18ec0 75 73 74 20 73 74 6f 72 65 3a 0a 20 20 2a 2a 20 ust store:. **
18ed0 20 20 20 20 32 2d 62 79 74 65 20 70 6f 69 6e 74 2-byte point
18ee0 65 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 0a 20 er to the cell.
18ef0 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 63 ** 4-byte c
18f00 68 69 6c 64 20 70 6f 69 6e 74 65 72 0a 20 20 2a hild pointer. *
18f10 2a 20 20 20 20 20 39 2d 62 79 74 65 20 6e 4b 65 * 9-byte nKe
18f20 79 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 20 20 y value. **
18f30 20 34 2d 62 79 74 65 20 6e 44 61 74 61 20 76 61 4-byte nData va
18f40 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 lue. ** 4-b
18f50 79 74 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 yte overflow pag
18f60 65 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 53 e pointer. ** S
18f70 6f 20 61 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 o a cell consist
18f80 73 20 6f 66 20 61 20 32 2d 62 79 74 65 20 70 6f s of a 2-byte po
18f90 69 6e 74 65 72 2c 20 61 20 68 65 61 64 65 72 20 inter, a header
18fa0 77 68 69 63 68 20 69 73 20 61 73 20 6d 75 63 68 which is as much
18fb0 20 61 73 0a 20 20 2a 2a 20 31 37 20 62 79 74 65 as. ** 17 byte
18fc0 73 20 6c 6f 6e 67 2c 20 30 20 74 6f 20 4e 20 62 s long, 0 to N b
18fd0 79 74 65 73 20 6f 66 20 70 61 79 6c 6f 61 64 2c ytes of payload,
18fe0 20 61 6e 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c and an optional
18ff0 20 34 20 62 79 74 65 20 6f 76 65 72 66 6c 6f 77 4 byte overflow
19000 0a 20 20 2a 2a 20 70 61 67 65 20 70 6f 69 6e 74 . ** page point
19010 65 72 2e 0a 20 20 2a 2f 0a 20 20 70 42 74 2d 3e er.. */. pBt->
19020 6d 61 78 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 maxLocal = (u16)
19030 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ((pBt->usableSiz
19040 65 2d 31 32 29 2a 36 34 2f 32 35 35 20 2d 20 32 e-12)*64/255 - 2
19050 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 6f 3);. pBt->minLo
19060 63 61 6c 20 3d 20 28 75 31 36 29 28 28 70 42 74 cal = (u16)((pBt
19070 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 ->usableSize-12)
19080 2a 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 *32/255 - 23);.
19090 20 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 3d 20 pBt->maxLeaf =
190a0 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c (u16)(pBt->usabl
190b0 65 53 69 7a 65 20 2d 20 33 35 29 3b 0a 20 20 70 eSize - 35);. p
190c0 42 74 2d 3e 6d 69 6e 4c 65 61 66 20 3d 20 28 75 Bt->minLeaf = (u
190d0 31 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 16)((pBt->usable
190e0 53 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 Size-12)*32/255
190f0 2d 20 32 33 29 3b 0a 20 20 69 66 28 20 70 42 74 - 23);. if( pBt
19100 2d 3e 6d 61 78 4c 6f 63 61 6c 3e 31 32 37 20 29 ->maxLocal>127 )
19110 7b 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 {. pBt->max1b
19120 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 31 32 37 ytePayload = 127
19130 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
19140 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c Bt->max1bytePayl
19150 6f 61 64 20 3d 20 28 75 38 29 70 42 74 2d 3e 6d oad = (u8)pBt->m
19160 61 78 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 61 axLocal;. }. a
19170 73 73 65 72 74 28 20 70 42 74 2d 3e 6d 61 78 4c ssert( pBt->maxL
19180 65 61 66 20 2b 20 32 33 20 3c 3d 20 4d 58 5f 43 eaf + 23 <= MX_C
19190 45 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 29 3b ELL_SIZE(pBt) );
191a0 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d . pBt->pPage1 =
191b0 20 70 50 61 67 65 31 3b 0a 20 20 70 42 74 2d 3e pPage1;. pBt->
191c0 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 nPage = nPage;.
191d0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
191e0 4b 3b 0a 0a 70 61 67 65 31 5f 69 6e 69 74 5f 66 K;..page1_init_f
191f0 61 69 6c 65 64 3a 0a 20 20 72 65 6c 65 61 73 65 ailed:. release
19200 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 Page(pPage1);.
19210 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b pBt->pPage1 = 0;
19220 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
19230 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a .#ifndef NDEBUG.
19240 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
19250 20 6e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f number of curso
19260 72 73 20 6f 70 65 6e 20 6f 6e 20 70 42 74 2e 20 rs open on pBt.
19270 54 68 69 73 20 69 73 20 66 6f 72 20 75 73 65 0a This is for use.
19280 2a 2a 20 69 6e 20 61 73 73 65 72 74 28 29 20 65 ** in assert() e
19290 78 70 72 65 73 73 69 6f 6e 73 2c 20 73 6f 20 69 xpressions, so i
192a0 74 20 69 73 20 6f 6e 6c 79 20 63 6f 6d 70 69 6c t is only compil
192b0 65 64 20 69 66 20 4e 44 45 42 55 47 20 69 73 20 ed if NDEBUG is
192c0 6e 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 64 2e 0a not.** defined..
192d0 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 65 **.** Only write
192e0 20 63 75 72 73 6f 72 73 20 61 72 65 20 63 6f 75 cursors are cou
192f0 6e 74 65 64 20 69 66 20 77 72 4f 6e 6c 79 20 69 nted if wrOnly i
19300 73 20 74 72 75 65 2e 20 20 49 66 20 77 72 4f 6e s true. If wrOn
19310 6c 79 20 69 73 0a 2a 2a 20 66 61 6c 73 65 20 74 ly is.** false t
19320 68 65 6e 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 hen all cursors
19330 61 72 65 20 63 6f 75 6e 74 65 64 2e 0a 2a 2a 0a are counted..**.
19340 2a 2a 20 46 6f 72 20 74 68 65 20 70 75 72 70 6f ** For the purpo
19350 73 65 73 20 6f 66 20 74 68 69 73 20 72 6f 75 74 ses of this rout
19360 69 6e 65 2c 20 61 20 63 75 72 73 6f 72 20 69 73 ine, a cursor is
19370 20 61 6e 79 20 63 75 72 73 6f 72 20 74 68 61 74 any cursor that
19380 0a 2a 2a 20 69 73 20 63 61 70 61 62 6c 65 20 6f .** is capable o
19390 66 20 72 65 61 64 69 6e 67 20 6f 72 20 77 72 69 f reading or wri
193a0 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 ting to the data
193b0 62 61 73 65 2e 20 20 43 75 72 73 6f 72 73 20 74 base. Cursors t
193c0 68 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e hat.** have been
193d0 20 74 72 69 70 70 65 64 20 69 6e 74 6f 20 74 68 tripped into th
193e0 65 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 73 e CURSOR_FAULT s
193f0 74 61 74 65 20 61 72 65 20 6e 6f 74 20 63 6f 75 tate are not cou
19400 6e 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 nted..*/.static
19410 69 6e 74 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 int countValidCu
19420 72 73 6f 72 73 28 42 74 53 68 61 72 65 64 20 2a rsors(BtShared *
19430 70 42 74 2c 20 69 6e 74 20 77 72 4f 6e 6c 79 29 pBt, int wrOnly)
19440 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 {. BtCursor *pC
19450 75 72 3b 0a 20 20 69 6e 74 20 72 20 3d 20 30 3b ur;. int r = 0;
19460 0a 20 20 66 6f 72 28 70 43 75 72 3d 70 42 74 2d . for(pCur=pBt-
19470 3e 70 43 75 72 73 6f 72 3b 20 70 43 75 72 3b 20 >pCursor; pCur;
19480 70 43 75 72 3d 70 43 75 72 2d 3e 70 4e 65 78 74 pCur=pCur->pNext
19490 29 7b 0a 20 20 20 20 69 66 28 20 28 77 72 4f 6e ){. if( (wrOn
194a0 6c 79 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d 3e ly==0 || (pCur->
194b0 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
194c0 57 72 69 74 65 46 6c 61 67 29 21 3d 30 29 0a 20 WriteFlag)!=0).
194d0 20 20 20 20 26 26 20 70 43 75 72 2d 3e 65 53 74 && pCur->eSt
194e0 61 74 65 21 3d 43 55 52 53 4f 52 5f 46 41 55 4c ate!=CURSOR_FAUL
194f0 54 20 29 20 72 2b 2b 3b 20 0a 20 20 7d 0a 20 20 T ) r++; . }.
19500 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 23 65 6e 64 return r;.}.#end
19510 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 if../*.** If the
19520 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 re are no outsta
19530 6e 64 69 6e 67 20 63 75 72 73 6f 72 73 20 61 6e nding cursors an
19540 64 20 77 65 20 61 72 65 20 6e 6f 74 20 69 6e 20 d we are not in
19550 74 68 65 20 6d 69 64 64 6c 65 0a 2a 2a 20 6f 66 the middle.** of
19560 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 a transaction b
19570 75 74 20 74 68 65 72 65 20 69 73 20 61 20 72 65 ut there is a re
19580 61 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 ad lock on the d
19590 61 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 2a 2a atabase, then.**
195a0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 75 6e this routine un
195b0 72 65 66 73 20 74 68 65 20 66 69 72 73 74 20 70 refs the first p
195c0 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 age of the datab
195d0 61 73 65 20 66 69 6c 65 20 77 68 69 63 68 20 0a ase file which .
195e0 2a 2a 20 68 61 73 20 74 68 65 20 65 66 66 65 63 ** has the effec
195f0 74 20 6f 66 20 72 65 6c 65 61 73 69 6e 67 20 74 t of releasing t
19600 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2a he read lock..**
19610 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 .** If there is
19620 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e a transaction in
19630 20 70 72 6f 67 72 65 73 73 2c 20 74 68 69 73 20 progress, this
19640 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d routine is a no-
19650 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f op..*/.static vo
19660 69 64 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 id unlockBtreeIf
19670 55 6e 75 73 65 64 28 42 74 53 68 61 72 65 64 20 Unused(BtShared
19680 2a 70 42 74 29 7b 0a 20 20 61 73 73 65 72 74 28 *pBt){. assert(
19690 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
196a0 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
196b0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 6f 75 );. assert( cou
196c0 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 70 ntValidCursors(p
196d0 42 74 2c 30 29 3d 3d 30 20 7c 7c 20 70 42 74 2d Bt,0)==0 || pBt-
196e0 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3e 54 >inTransaction>T
196f0 52 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 69 RANS_NONE );. i
19700 66 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 f( pBt->inTransa
19710 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e ction==TRANS_NON
19720 45 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 E && pBt->pPage1
19730 21 3d 30 20 29 7b 0a 20 20 20 20 4d 65 6d 50 61 !=0 ){. MemPa
19740 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 ge *pPage1 = pBt
19750 2d 3e 70 50 61 67 65 31 3b 0a 20 20 20 20 61 73 ->pPage1;. as
19760 73 65 72 74 28 20 70 50 61 67 65 31 2d 3e 61 44 sert( pPage1->aD
19770 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ata );. asser
19780 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 t( sqlite3PagerR
19790 65 66 63 6f 75 6e 74 28 70 42 74 2d 3e 70 50 61 efcount(pBt->pPa
197a0 67 65 72 29 3d 3d 31 20 29 3b 0a 20 20 20 20 70 ger)==1 );. p
197b0 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a Bt->pPage1 = 0;.
197c0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 4e releasePageN
197d0 6f 74 4e 75 6c 6c 28 70 50 61 67 65 31 29 3b 0a otNull(pPage1);.
197e0 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 }.}../*.** If
197f0 70 42 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e pBt points to an
19800 20 65 6d 70 74 79 20 66 69 6c 65 20 74 68 65 6e empty file then
19810 20 63 6f 6e 76 65 72 74 20 74 68 61 74 20 65 6d convert that em
19820 70 74 79 20 66 69 6c 65 0a 2a 2a 20 69 6e 74 6f pty file.** into
19830 20 61 20 6e 65 77 20 65 6d 70 74 79 20 64 61 74 a new empty dat
19840 61 62 61 73 65 20 62 79 20 69 6e 69 74 69 61 6c abase by initial
19850 69 7a 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 izing the first
19860 70 61 67 65 20 6f 66 0a 2a 2a 20 74 68 65 20 64 page of.** the d
19870 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 atabase..*/.stat
19880 69 63 20 69 6e 74 20 6e 65 77 44 61 74 61 62 61 ic int newDataba
19890 73 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 se(BtShared *pBt
198a0 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
198b0 31 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 1;. unsigned ch
198c0 61 72 20 2a 64 61 74 61 3b 0a 20 20 69 6e 74 20 ar *data;. int
198d0 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 rc;.. assert( s
198e0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
198f0 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
19900 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 . if( pBt->nPag
19910 65 3e 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 e>0 ){. retur
19920 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
19930 0a 20 20 70 50 31 20 3d 20 70 42 74 2d 3e 70 50 . pP1 = pBt->pP
19940 61 67 65 31 3b 0a 20 20 61 73 73 65 72 74 28 20 age1;. assert(
19950 70 50 31 21 3d 30 20 29 3b 0a 20 20 64 61 74 61 pP1!=0 );. data
19960 20 3d 20 70 50 31 2d 3e 61 44 61 74 61 3b 0a 20 = pP1->aData;.
19970 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
19980 65 72 57 72 69 74 65 28 70 50 31 2d 3e 70 44 62 erWrite(pP1->pDb
19990 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 Page);. if( rc
199a0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 6d ) return rc;. m
199b0 65 6d 63 70 79 28 64 61 74 61 2c 20 7a 4d 61 67 emcpy(data, zMag
199c0 69 63 48 65 61 64 65 72 2c 20 73 69 7a 65 6f 66 icHeader, sizeof
199d0 28 7a 4d 61 67 69 63 48 65 61 64 65 72 29 29 3b (zMagicHeader));
199e0 0a 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f . assert( sizeo
199f0 66 28 7a 4d 61 67 69 63 48 65 61 64 65 72 29 3d f(zMagicHeader)=
19a00 3d 31 36 20 29 3b 0a 20 20 64 61 74 61 5b 31 36 =16 );. data[16
19a10 5d 20 3d 20 28 75 38 29 28 28 70 42 74 2d 3e 70 ] = (u8)((pBt->p
19a20 61 67 65 53 69 7a 65 3e 3e 38 29 26 30 78 66 66 ageSize>>8)&0xff
19a30 29 3b 0a 20 20 64 61 74 61 5b 31 37 5d 20 3d 20 );. data[17] =
19a40 28 75 38 29 28 28 70 42 74 2d 3e 70 61 67 65 53 (u8)((pBt->pageS
19a50 69 7a 65 3e 3e 31 36 29 26 30 78 66 66 29 3b 0a ize>>16)&0xff);.
19a60 20 20 64 61 74 61 5b 31 38 5d 20 3d 20 31 3b 0a data[18] = 1;.
19a70 20 20 64 61 74 61 5b 31 39 5d 20 3d 20 31 3b 0a data[19] = 1;.
19a80 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 assert( pBt->u
19a90 73 61 62 6c 65 53 69 7a 65 3c 3d 70 42 74 2d 3e sableSize<=pBt->
19aa0 70 61 67 65 53 69 7a 65 20 26 26 20 70 42 74 2d pageSize && pBt-
19ab0 3e 75 73 61 62 6c 65 53 69 7a 65 2b 32 35 35 3e >usableSize+255>
19ac0 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b =pBt->pageSize);
19ad0 0a 20 20 64 61 74 61 5b 32 30 5d 20 3d 20 28 75 . data[20] = (u
19ae0 38 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 8)(pBt->pageSize
19af0 20 2d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 - pBt->usableSi
19b00 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 31 5d 20 ze);. data[21]
19b10 3d 20 36 34 3b 0a 20 20 64 61 74 61 5b 32 32 5d = 64;. data[22]
19b20 20 3d 20 33 32 3b 0a 20 20 64 61 74 61 5b 32 33 = 32;. data[23
19b30 5d 20 3d 20 33 32 3b 0a 20 20 6d 65 6d 73 65 74 ] = 32;. memset
19b40 28 26 64 61 74 61 5b 32 34 5d 2c 20 30 2c 20 31 (&data[24], 0, 1
19b50 30 30 2d 32 34 29 3b 0a 20 20 7a 65 72 6f 50 61 00-24);. zeroPa
19b60 67 65 28 70 50 31 2c 20 50 54 46 5f 49 4e 54 4b ge(pP1, PTF_INTK
19b70 45 59 7c 50 54 46 5f 4c 45 41 46 7c 50 54 46 5f EY|PTF_LEAF|PTF_
19b80 4c 45 41 46 44 41 54 41 20 29 3b 0a 20 20 70 42 LEAFDATA );. pB
19b90 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
19ba0 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 TS_PAGESIZE_FIXE
19bb0 44 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 D;.#ifndef SQLIT
19bc0 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
19bd0 4d 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d M. assert( pBt-
19be0 3e 61 75 74 6f 56 61 63 75 75 6d 3d 3d 31 20 7c >autoVacuum==1 |
19bf0 7c 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 | pBt->autoVacuu
19c00 6d 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 m==0 );. assert
19c10 28 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 ( pBt->incrVacuu
19c20 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 69 6e 63 m==1 || pBt->inc
19c30 72 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 rVacuum==0 );.
19c40 70 75 74 34 62 79 74 65 28 26 64 61 74 61 5b 33 put4byte(&data[3
19c50 36 20 2b 20 34 2a 34 5d 2c 20 70 42 74 2d 3e 61 6 + 4*4], pBt->a
19c60 75 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 70 75 utoVacuum);. pu
19c70 74 34 62 79 74 65 28 26 64 61 74 61 5b 33 36 20 t4byte(&data[36
19c80 2b 20 37 2a 34 5d 2c 20 70 42 74 2d 3e 69 6e 63 + 7*4], pBt->inc
19c90 72 56 61 63 75 75 6d 29 3b 0a 23 65 6e 64 69 66 rVacuum);.#endif
19ca0 0a 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 . pBt->nPage =
19cb0 31 3b 0a 20 20 64 61 74 61 5b 33 31 5d 20 3d 20 1;. data[31] =
19cc0 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 1;. return SQLI
19cd0 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
19ce0 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 66 Initialize the f
19cf0 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 irst page of the
19d00 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 database file (
19d10 63 72 65 61 74 69 6e 67 20 61 20 64 61 74 61 62 creating a datab
19d20 61 73 65 0a 2a 2a 20 63 6f 6e 73 69 73 74 69 6e ase.** consistin
19d30 67 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 70 61 g of a single pa
19d40 67 65 20 61 6e 64 20 6e 6f 20 73 63 68 65 6d 61 ge and no schema
19d50 20 6f 62 6a 65 63 74 73 29 2e 20 52 65 74 75 72 objects). Retur
19d60 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 n SQLITE_OK.** i
19d70 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 f successful, or
19d80 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
19d90 20 63 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e code otherwise.
19da0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
19db0 74 72 65 65 4e 65 77 44 62 28 42 74 72 65 65 20 treeNewDb(Btree
19dc0 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 *p){. int rc;.
19dd0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
19de0 65 72 28 70 29 3b 0a 20 20 70 2d 3e 70 42 74 2d er(p);. p->pBt-
19df0 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 72 63 >nPage = 0;. rc
19e00 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 28 70 = newDatabase(p
19e10 2d 3e 70 42 74 29 3b 0a 20 20 73 71 6c 69 74 65 ->pBt);. sqlite
19e20 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
19e30 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
19e40 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f /*.** Attempt to
19e50 20 73 74 61 72 74 20 61 20 6e 65 77 20 74 72 61 start a new tra
19e60 6e 73 61 63 74 69 6f 6e 2e 20 41 20 77 72 69 74 nsaction. A writ
19e70 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a e-transaction.**
19e80 20 69 73 20 73 74 61 72 74 65 64 20 69 66 20 74 is started if t
19e90 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
19ea0 6e 74 20 69 73 20 6e 6f 6e 7a 65 72 6f 2c 20 6f nt is nonzero, o
19eb0 74 68 65 72 77 69 73 65 20 61 20 72 65 61 64 2d therwise a read-
19ec0 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e .** transaction.
19ed0 20 20 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 If the second
19ee0 61 72 67 75 6d 65 6e 74 20 69 73 20 32 20 6f 72 argument is 2 or
19ef0 20 6d 6f 72 65 20 61 6e 64 20 65 78 63 6c 75 73 more and exclus
19f00 69 76 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ive.** transacti
19f10 6f 6e 20 69 73 20 73 74 61 72 74 65 64 2c 20 6d on is started, m
19f20 65 61 6e 69 6e 67 20 74 68 61 74 20 6e 6f 20 6f eaning that no o
19f30 74 68 65 72 20 70 72 6f 63 65 73 73 20 69 73 20 ther process is
19f40 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 6f 20 61 63 allowed.** to ac
19f50 63 65 73 73 20 74 68 65 20 64 61 74 61 62 61 73 cess the databas
19f60 65 2e 20 20 41 20 70 72 65 65 78 69 73 74 69 6e e. A preexistin
19f70 67 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 g transaction ma
19f80 79 20 6e 6f 74 20 62 65 0a 2a 2a 20 75 70 67 72 y not be.** upgr
19f90 61 64 65 64 20 74 6f 20 65 78 63 6c 75 73 69 76 aded to exclusiv
19fa0 65 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 69 e by calling thi
19fb0 73 20 72 6f 75 74 69 6e 65 20 61 20 73 65 63 6f s routine a seco
19fc0 6e 64 20 74 69 6d 65 20 2d 20 74 68 65 0a 2a 2a nd time - the.**
19fd0 20 65 78 63 6c 75 73 69 76 69 74 79 20 66 6c 61 exclusivity fla
19fe0 67 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 6f 72 g only works for
19ff0 20 61 20 6e 65 77 20 74 72 61 6e 73 61 63 74 69 a new transacti
1a000 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 77 72 69 74 on..**.** A writ
1a010 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 e-transaction mu
1a020 73 74 20 62 65 20 73 74 61 72 74 65 64 20 62 65 st be started be
1a030 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 fore attempting
1a040 61 6e 79 20 0a 2a 2a 20 63 68 61 6e 67 65 73 20 any .** changes
1a050 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 2e to the database.
1a060 20 20 4e 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f None of the fo
1a070 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 llowing routines
1a080 20 0a 2a 2a 20 77 69 6c 6c 20 77 6f 72 6b 20 75 .** will work u
1a090 6e 6c 65 73 73 20 61 20 74 72 61 6e 73 61 63 74 nless a transact
1a0a0 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64 20 66 ion is started f
1a0b0 69 72 73 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 irst:.**.**
1a0c0 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 sqlite3BtreeCre
1a0d0 61 74 65 54 61 62 6c 65 28 29 0a 2a 2a 20 20 20 ateTable().**
1a0e0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
1a0f0 72 65 61 74 65 49 6e 64 65 78 28 29 0a 2a 2a 20 reateIndex().**
1a100 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
1a110 65 43 6c 65 61 72 54 61 62 6c 65 28 29 0a 2a 2a eClearTable().**
1a120 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1a130 65 65 44 72 6f 70 54 61 62 6c 65 28 29 0a 2a 2a eeDropTable().**
1a140 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1a150 65 65 49 6e 73 65 72 74 28 29 0a 2a 2a 20 20 20 eeInsert().**
1a160 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 sqlite3BtreeD
1a170 65 6c 65 74 65 28 29 0a 2a 2a 20 20 20 20 20 20 elete().**
1a180 73 71 6c 69 74 65 33 42 74 72 65 65 55 70 64 61 sqlite3BtreeUpda
1a190 74 65 4d 65 74 61 28 29 0a 2a 2a 0a 2a 2a 20 49 teMeta().**.** I
1a1a0 66 20 61 6e 20 69 6e 69 74 69 61 6c 20 61 74 74 f an initial att
1a1b0 65 6d 70 74 20 74 6f 20 61 63 71 75 69 72 65 20 empt to acquire
1a1c0 74 68 65 20 6c 6f 63 6b 20 66 61 69 6c 73 20 62 the lock fails b
1a1d0 65 63 61 75 73 65 20 6f 66 20 6c 6f 63 6b 20 63 ecause of lock c
1a1e0 6f 6e 74 65 6e 74 69 6f 6e 0a 2a 2a 20 61 6e 64 ontention.** and
1a1f0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61 the database wa
1a200 73 20 70 72 65 76 69 6f 75 73 6c 79 20 75 6e 6c s previously unl
1a210 6f 63 6b 65 64 2c 20 74 68 65 6e 20 69 6e 76 6f ocked, then invo
1a220 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 ke the busy hand
1a230 6c 65 72 0a 2a 2a 20 69 66 20 74 68 65 72 65 20 ler.** if there
1a240 69 73 20 6f 6e 65 2e 20 20 42 75 74 20 69 66 20 is one. But if
1a250 74 68 65 72 65 20 77 61 73 20 70 72 65 76 69 6f there was previo
1a260 75 73 6c 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b usly a read-lock
1a270 2c 20 64 6f 20 6e 6f 74 0a 2a 2a 20 69 6e 76 6f , do not.** invo
1a280 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 ke the busy hand
1a290 6c 65 72 20 2d 20 6a 75 73 74 20 72 65 74 75 72 ler - just retur
1a2a0 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 20 n SQLITE_BUSY.
1a2b0 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 0a SQLITE_BUSY is .
1a2c0 2a 2a 20 72 65 74 75 72 6e 65 64 20 77 68 65 6e ** returned when
1a2d0 20 74 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 there is alread
1a2e0 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 69 6e y a read-lock in
1a2f0 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 order to avoid
1a300 61 20 64 65 61 64 6c 6f 63 6b 2e 0a 2a 2a 0a 2a a deadlock..**.*
1a310 2a 20 53 75 70 70 6f 73 65 20 74 68 65 72 65 20 * Suppose there
1a320 61 72 65 20 74 77 6f 20 70 72 6f 63 65 73 73 65 are two processe
1a330 73 20 41 20 61 6e 64 20 42 2e 20 20 41 20 68 61 s A and B. A ha
1a340 73 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 61 6e s a read lock an
1a350 64 20 42 20 68 61 73 0a 2a 2a 20 61 20 72 65 73 d B has.** a res
1a360 65 72 76 65 64 20 6c 6f 63 6b 2e 20 20 42 20 74 erved lock. B t
1a370 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 ries to promote
1a380 74 6f 20 65 78 63 6c 75 73 69 76 65 20 62 75 74 to exclusive but
1a390 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 65 63 61 is blocked beca
1a3a0 75 73 65 0a 2a 2a 20 6f 66 20 41 27 73 20 72 65 use.** of A's re
1a3b0 61 64 20 6c 6f 63 6b 2e 20 20 41 20 74 72 69 65 ad lock. A trie
1a3c0 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 74 6f 20 s to promote to
1a3d0 72 65 73 65 72 76 65 64 20 62 75 74 20 69 73 20 reserved but is
1a3e0 62 6c 6f 63 6b 65 64 20 62 79 20 42 2e 0a 2a 2a blocked by B..**
1a3f0 20 4f 6e 65 20 6f 72 20 74 68 65 20 6f 74 68 65 One or the othe
1a400 72 20 6f 66 20 74 68 65 20 74 77 6f 20 70 72 6f r of the two pro
1a410 63 65 73 73 65 73 20 6d 75 73 74 20 67 69 76 65 cesses must give
1a420 20 77 61 79 20 6f 72 20 74 68 65 72 65 20 63 61 way or there ca
1a430 6e 20 62 65 0a 2a 2a 20 6e 6f 20 70 72 6f 67 72 n be.** no progr
1a440 65 73 73 2e 20 20 42 79 20 72 65 74 75 72 6e 69 ess. By returni
1a450 6e 67 20 53 51 4c 49 54 45 5f 42 55 53 59 20 61 ng SQLITE_BUSY a
1a460 6e 64 20 6e 6f 74 20 69 6e 76 6f 6b 69 6e 67 20 nd not invoking
1a470 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 the busy callbac
1a480 6b 0a 2a 2a 20 77 68 65 6e 20 41 20 61 6c 72 65 k.** when A alre
1a490 61 64 79 20 68 61 73 20 61 20 72 65 61 64 20 6c ady has a read l
1a4a0 6f 63 6b 2c 20 77 65 20 65 6e 63 6f 75 72 61 67 ock, we encourag
1a4b0 65 20 41 20 74 6f 20 67 69 76 65 20 75 70 20 61 e A to give up a
1a4c0 6e 64 20 6c 65 74 20 42 0a 2a 2a 20 70 72 6f 63 nd let B.** proc
1a4d0 65 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 eed..*/.int sqli
1a4e0 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 te3BtreeBeginTra
1a4f0 6e 73 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 ns(Btree *p, int
1a500 20 77 72 66 6c 61 67 29 7b 0a 20 20 42 74 53 68 wrflag){. BtSh
1a510 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
1a520 42 74 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 Bt;. int rc = S
1a530 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c QLITE_OK;.. sql
1a540 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1a550 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 );. btreeIntegr
1a560 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 ity(p);.. /* If
1a570 20 74 68 65 20 62 74 72 65 65 20 69 73 20 61 6c the btree is al
1a580 72 65 61 64 79 20 69 6e 20 61 20 77 72 69 74 65 ready in a write
1a590 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 -transaction, or
1a5a0 20 69 74 0a 20 20 2a 2a 20 69 73 20 61 6c 72 65 it. ** is alre
1a5b0 61 64 79 20 69 6e 20 61 20 72 65 61 64 2d 74 72 ady in a read-tr
1a5c0 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 61 20 ansaction and a
1a5d0 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
1a5e0 0a 20 20 2a 2a 20 69 73 20 72 65 71 75 65 73 74 . ** is request
1a5f0 65 64 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f ed, this is a no
1a600 2d 6f 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 -op.. */. if(
1a610 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
1a620 53 5f 57 52 49 54 45 20 7c 7c 20 28 70 2d 3e 69 S_WRITE || (p->i
1a630 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 nTrans==TRANS_RE
1a640 41 44 20 26 26 20 21 77 72 66 6c 61 67 29 20 29 AD && !wrflag) )
1a650 7b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 {. goto trans
1a660 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 _begun;. }. as
1a670 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 sert( pBt->inTra
1a680 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
1a690 57 52 49 54 45 20 7c 7c 20 49 66 4e 6f 74 4f 6d WRITE || IfNotOm
1a6a0 69 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 75 itAV(pBt->bDoTru
1a6b0 6e 63 61 74 65 29 3d 3d 30 20 29 3b 0a 0a 20 20 ncate)==0 );..
1a6c0 2f 2a 20 57 72 69 74 65 20 74 72 61 6e 73 61 63 /* Write transac
1a6d0 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 70 6f tions are not po
1a6e0 73 73 69 62 6c 65 20 6f 6e 20 61 20 72 65 61 64 ssible on a read
1a6f0 2d 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 20 2a -only database *
1a700 2f 0a 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 /. if( (pBt->bt
1a710 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 sFlags & BTS_REA
1a720 44 5f 4f 4e 4c 59 29 21 3d 30 20 26 26 20 77 72 D_ONLY)!=0 && wr
1a730 66 6c 61 67 20 29 7b 0a 20 20 20 20 72 63 20 3d flag ){. rc =
1a740 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
1a750 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 ;. goto trans
1a760 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 0a 23 69 66 _begun;. }..#if
1a770 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
1a780 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 _SHARED_CACHE.
1a790 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 70 {. sqlite3 *p
1a7a0 42 6c 6f 63 6b 20 3d 20 30 3b 0a 20 20 20 20 2f Block = 0;. /
1a7b0 2a 20 49 66 20 61 6e 6f 74 68 65 72 20 64 61 74 * If another dat
1a7c0 61 62 61 73 65 20 68 61 6e 64 6c 65 20 68 61 73 abase handle has
1a7d0 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20 already opened
1a7e0 61 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 a write transact
1a7f0 69 6f 6e 20 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 ion . ** on t
1a800 68 69 73 20 73 68 61 72 65 64 2d 62 74 72 65 65 his shared-btree
1a810 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 61 structure and a
1a820 20 73 65 63 6f 6e 64 20 77 72 69 74 65 20 74 72 second write tr
1a830 61 6e 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 20 ansaction is.
1a840 20 2a 2a 20 72 65 71 75 65 73 74 65 64 2c 20 72 ** requested, r
1a850 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 eturn SQLITE_LOC
1a860 4b 45 44 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 KED.. */.
1a870 69 66 28 20 28 77 72 66 6c 61 67 20 26 26 20 70 if( (wrflag && p
1a880 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1a890 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 29 0a n==TRANS_WRITE).
1a8a0 20 20 20 20 20 7c 7c 20 28 70 42 74 2d 3e 62 74 || (pBt->bt
1a8b0 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e sFlags & BTS_PEN
1a8c0 44 49 4e 47 29 21 3d 30 0a 20 20 20 20 29 7b 0a DING)!=0. ){.
1a8d0 20 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 pBlock = p
1a8e0 42 74 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 3b Bt->pWriter->db;
1a8f0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 77 . }else if( w
1a900 72 66 6c 61 67 3e 31 20 29 7b 0a 20 20 20 20 20 rflag>1 ){.
1a910 20 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a BtLock *pIter;.
1a920 20 20 20 20 20 20 66 6f 72 28 70 49 74 65 72 3d for(pIter=
1a930 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 pBt->pLock; pIte
1a940 72 3b 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e r; pIter=pIter->
1a950 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 pNext){.
1a960 69 66 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 if( pIter->pBtre
1a970 65 21 3d 70 20 29 7b 0a 20 20 20 20 20 20 20 20 e!=p ){.
1a980 20 20 70 42 6c 6f 63 6b 20 3d 20 70 49 74 65 72 pBlock = pIter
1a990 2d 3e 70 42 74 72 65 65 2d 3e 64 62 3b 0a 20 20 ->pBtree->db;.
1a9a0 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
1a9b0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
1a9c0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
1a9d0 42 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 73 Block ){. s
1a9e0 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e qlite3Connection
1a9f0 42 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 Blocked(p->db, p
1aa00 42 6c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 72 63 Block);. rc
1aa10 20 3d 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 = SQLITE_LOCKED
1aa20 5f 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 _SHAREDCACHE;.
1aa30 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 goto trans_b
1aa40 65 67 75 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a egun;. }. }.
1aa50 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 #endif.. /* Any
1aa60 20 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 read-only or re
1aa70 61 64 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 ad-write transac
1aa80 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 61 20 72 tion implies a r
1aa90 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a ead-lock on . *
1aaa0 2a 20 70 61 67 65 20 31 2e 20 53 6f 20 69 66 20 * page 1. So if
1aab0 73 6f 6d 65 20 6f 74 68 65 72 20 73 68 61 72 65 some other share
1aac0 64 2d 63 61 63 68 65 20 63 6c 69 65 6e 74 20 61 d-cache client a
1aad0 6c 72 65 61 64 79 20 68 61 73 20 61 20 77 72 69 lready has a wri
1aae0 74 65 2d 6c 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e te-lock . ** on
1aaf0 20 70 61 67 65 20 31 2c 20 74 68 65 20 74 72 61 page 1, the tra
1ab00 6e 73 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 nsaction cannot
1ab10 62 65 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 be opened. */.
1ab20 72 63 20 3d 20 71 75 65 72 79 53 68 61 72 65 64 rc = queryShared
1ab30 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 CacheTableLock(p
1ab40 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 52 , MASTER_ROOT, R
1ab50 45 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 EAD_LOCK);. if(
1ab60 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 SQLITE_OK!=rc )
1ab70 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 goto trans_begu
1ab80 6e 3b 0a 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c n;.. pBt->btsFl
1ab90 61 67 73 20 26 3d 20 7e 42 54 53 5f 49 4e 49 54 ags &= ~BTS_INIT
1aba0 49 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 69 IALLY_EMPTY;. i
1abb0 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 f( pBt->nPage==0
1abc0 20 29 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 ) pBt->btsFlags
1abd0 20 7c 3d 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c |= BTS_INITIALL
1abe0 59 5f 45 4d 50 54 59 3b 0a 20 20 64 6f 20 7b 0a Y_EMPTY;. do {.
1abf0 20 20 20 20 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b /* Call lock
1ac00 42 74 72 65 65 28 29 20 75 6e 74 69 6c 20 65 69 Btree() until ei
1ac10 74 68 65 72 20 70 42 74 2d 3e 70 50 61 67 65 31 ther pBt->pPage1
1ac20 20 69 73 20 70 6f 70 75 6c 61 74 65 64 20 6f 72 is populated or
1ac30 0a 20 20 20 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 . ** lockBtre
1ac40 65 28 29 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 e() returns some
1ac50 74 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e thing other than
1ac60 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b SQLITE_OK. lock
1ac70 42 74 72 65 65 28 29 0a 20 20 20 20 2a 2a 20 6d Btree(). ** m
1ac80 61 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ay return SQLITE
1ac90 5f 4f 4b 20 62 75 74 20 6c 65 61 76 65 20 70 42 _OK but leave pB
1aca0 74 2d 3e 70 50 61 67 65 31 20 73 65 74 20 74 6f t->pPage1 set to
1acb0 20 30 20 69 66 20 61 66 74 65 72 0a 20 20 20 20 0 if after.
1acc0 2a 2a 20 72 65 61 64 69 6e 67 20 70 61 67 65 20 ** reading page
1acd0 31 20 69 74 20 64 69 73 63 6f 76 65 72 73 20 74 1 it discovers t
1ace0 68 61 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a hat the page-siz
1acf0 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
1ad00 65 20 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 69 e . ** file i
1ad10 73 20 6e 6f 74 20 70 42 74 2d 3e 70 61 67 65 53 s not pBt->pageS
1ad20 69 7a 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 ize. In this cas
1ad30 65 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 77 69 e lockBtree() wi
1ad40 6c 6c 20 75 70 64 61 74 65 0a 20 20 20 20 2a 2a ll update. **
1ad50 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 74 pBt->pageSize t
1ad60 6f 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 o the page-size
1ad70 6f 66 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 of the file on d
1ad80 69 73 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 isk.. */.
1ad90 77 68 69 6c 65 28 20 70 42 74 2d 3e 70 50 61 67 while( pBt->pPag
1ada0 65 31 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f e1==0 && SQLITE_
1adb0 4f 4b 3d 3d 28 72 63 20 3d 20 6c 6f 63 6b 42 74 OK==(rc = lockBt
1adc0 72 65 65 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 ree(pBt)) );..
1add0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1ade0 5f 4f 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b _OK && wrflag ){
1adf0 0a 20 20 20 20 20 20 69 66 28 20 28 70 42 74 2d . if( (pBt-
1ae00 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
1ae10 52 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b READ_ONLY)!=0 ){
1ae20 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
1ae30 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 LITE_READONLY;.
1ae40 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
1ae50 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1ae60 50 61 67 65 72 42 65 67 69 6e 28 70 42 74 2d 3e PagerBegin(pBt->
1ae70 70 50 61 67 65 72 2c 77 72 66 6c 61 67 3e 31 2c pPager,wrflag>1,
1ae80 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d sqlite3TempInMem
1ae90 6f 72 79 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 ory(p->db));.
1aea0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1aeb0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1aec0 20 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 rc = newData
1aed0 62 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 base(pBt);.
1aee0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
1aef0 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 72 63 }. . if( rc
1af00 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
1af10 20 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 unlockBtree
1af20 49 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 IfUnused(pBt);.
1af30 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 28 }. }while( (
1af40 72 63 26 30 78 46 46 29 3d 3d 53 51 4c 49 54 45 rc&0xFF)==SQLITE
1af50 5f 42 55 53 59 20 26 26 20 70 42 74 2d 3e 69 6e _BUSY && pBt->in
1af60 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 Transaction==TRA
1af70 4e 53 5f 4e 4f 4e 45 20 26 26 0a 20 20 20 20 20 NS_NONE &&.
1af80 20 20 20 20 20 62 74 72 65 65 49 6e 76 6f 6b 65 btreeInvoke
1af90 42 75 73 79 48 61 6e 64 6c 65 72 28 70 42 74 29 BusyHandler(pBt)
1afa0 20 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 );.. if( rc==S
1afb0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1afc0 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d if( p->inTrans==
1afd0 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 TRANS_NONE ){.
1afe0 20 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 pBt->nTransa
1aff0 63 74 69 6f 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 ction++;.#ifndef
1b000 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
1b010 52 45 44 5f 43 41 43 48 45 0a 20 20 20 20 20 20 RED_CACHE.
1b020 69 66 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 if( p->sharable
1b030 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
1b040 74 28 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 t( p->lock.pBtre
1b050 65 3d 3d 70 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e e==p && p->lock.
1b060 69 54 61 62 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 iTable==1 );.
1b070 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f p->lock.eLo
1b080 63 6b 20 3d 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a ck = READ_LOCK;.
1b090 20 20 20 20 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e p->lock.
1b0a0 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c 6f pNext = pBt->pLo
1b0b0 63 6b 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ck;. pBt-
1b0c0 3e 70 4c 6f 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 >pLock = &p->loc
1b0d0 6b 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 k;. }.#endi
1b0e0 66 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 f. }. p->i
1b0f0 6e 54 72 61 6e 73 20 3d 20 28 77 72 66 6c 61 67 nTrans = (wrflag
1b100 3f 54 52 41 4e 53 5f 57 52 49 54 45 3a 54 52 41 ?TRANS_WRITE:TRA
1b110 4e 53 5f 52 45 41 44 29 3b 0a 20 20 20 20 69 66 NS_READ);. if
1b120 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 70 42 74 ( p->inTrans>pBt
1b130 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 ->inTransaction
1b140 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e ){. pBt->in
1b150 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 70 2d Transaction = p-
1b160 3e 69 6e 54 72 61 6e 73 3b 0a 20 20 20 20 7d 0a >inTrans;. }.
1b170 20 20 20 20 69 66 28 20 77 72 66 6c 61 67 20 29 if( wrflag )
1b180 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 {. MemPage
1b190 2a 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 *pPage1 = pBt->p
1b1a0 50 61 67 65 31 3b 0a 23 69 66 6e 64 65 66 20 53 Page1;.#ifndef S
1b1b0 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
1b1c0 44 5f 43 41 43 48 45 0a 20 20 20 20 20 20 61 73 D_CACHE. as
1b1d0 73 65 72 74 28 20 21 70 42 74 2d 3e 70 57 72 69 sert( !pBt->pWri
1b1e0 74 65 72 20 29 3b 0a 20 20 20 20 20 20 70 42 74 ter );. pBt
1b1f0 2d 3e 70 57 72 69 74 65 72 20 3d 20 70 3b 0a 20 ->pWriter = p;.
1b200 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
1b210 67 73 20 26 3d 20 7e 42 54 53 5f 45 58 43 4c 55 gs &= ~BTS_EXCLU
1b220 53 49 56 45 3b 0a 20 20 20 20 20 20 69 66 28 20 SIVE;. if(
1b230 77 72 66 6c 61 67 3e 31 20 29 20 70 42 74 2d 3e wrflag>1 ) pBt->
1b240 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
1b250 45 58 43 4c 55 53 49 56 45 3b 0a 23 65 6e 64 69 EXCLUSIVE;.#endi
1b260 66 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 f.. /* If t
1b270 68 65 20 64 62 2d 73 69 7a 65 20 68 65 61 64 65 he db-size heade
1b280 72 20 66 69 65 6c 64 20 69 73 20 69 6e 63 6f 72 r field is incor
1b290 72 65 63 74 20 28 61 73 20 69 74 20 6d 61 79 20 rect (as it may
1b2a0 62 65 20 69 66 20 61 6e 20 6f 6c 64 0a 20 20 20 be if an old.
1b2b0 20 20 20 2a 2a 20 63 6c 69 65 6e 74 20 68 61 73 ** client has
1b2c0 20 62 65 65 6e 20 77 72 69 74 69 6e 67 20 74 68 been writing th
1b2d0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 e database file)
1b2e0 2c 20 75 70 64 61 74 65 20 69 74 20 6e 6f 77 2e , update it now.
1b2f0 20 44 6f 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 Doing. **
1b300 74 68 69 73 20 73 6f 6f 6e 65 72 20 72 61 74 68 this sooner rath
1b310 65 72 20 74 68 61 6e 20 6c 61 74 65 72 20 6d 65 er than later me
1b320 61 6e 73 20 74 68 65 20 64 61 74 61 62 61 73 65 ans the database
1b330 20 73 69 7a 65 20 63 61 6e 20 73 61 66 65 6c 79 size can safely
1b340 20 0a 20 20 20 20 20 20 2a 2a 20 72 65 2d 72 65 . ** re-re
1b350 61 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ad the database
1b360 73 69 7a 65 20 66 72 6f 6d 20 70 61 67 65 20 31 size from page 1
1b370 20 69 66 20 61 20 73 61 76 65 70 6f 69 6e 74 20 if a savepoint
1b380 6f 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 or transaction.
1b390 20 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b ** rollback
1b3a0 20 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 occurs within t
1b3b0 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a he transaction..
1b3c0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
1b3d0 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 67 f( pBt->nPage!=g
1b3e0 65 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d et4byte(&pPage1-
1b3f0 3e 61 44 61 74 61 5b 32 38 5d 29 20 29 7b 0a 20 >aData[28]) ){.
1b400 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
1b410 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
1b420 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a age1->pDbPage);.
1b430 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d if( rc==
1b440 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1b450 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
1b460 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 &pPage1->aData[2
1b470 38 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 8], pBt->nPage);
1b480 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
1b490 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 }. }. }...t
1b4a0 72 61 6e 73 5f 62 65 67 75 6e 3a 0a 20 20 69 66 rans_begun:. if
1b4b0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1b4c0 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 && wrflag ){.
1b4d0 20 2f 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 61 /* This call ma
1b4e0 6b 65 73 20 73 75 72 65 20 74 68 61 74 20 74 68 kes sure that th
1b4f0 65 20 70 61 67 65 72 20 68 61 73 20 74 68 65 20 e pager has the
1b500 63 6f 72 72 65 63 74 20 6e 75 6d 62 65 72 20 6f correct number o
1b510 66 0a 20 20 20 20 2a 2a 20 6f 70 65 6e 20 73 61 f. ** open sa
1b520 76 65 70 6f 69 6e 74 73 2e 20 49 66 20 74 68 65 vepoints. If the
1b530 20 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 second paramete
1b540 72 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 r is greater tha
1b550 6e 20 30 20 61 6e 64 0a 20 20 20 20 2a 2a 20 74 n 0 and. ** t
1b560 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 he sub-journal i
1b570 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 s not already op
1b580 65 6e 2c 20 74 68 65 6e 20 69 74 20 77 69 6c 6c en, then it will
1b590 20 62 65 20 6f 70 65 6e 65 64 20 68 65 72 65 2e be opened here.
1b5a0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d . */. rc =
1b5b0 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 sqlite3PagerOpe
1b5c0 6e 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e nSavepoint(pBt->
1b5d0 70 50 61 67 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e pPager, p->db->n
1b5e0 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a Savepoint);. }.
1b5f0 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 . btreeIntegrit
1b600 79 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 y(p);. sqlite3B
1b610 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
1b620 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 return rc;.}..#i
1b630 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
1b640 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a T_AUTOVACUUM../*
1b650 0a 2a 2a 20 53 65 74 20 74 68 65 20 70 6f 69 6e .** Set the poin
1b660 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 20 ter-map entries
1b670 66 6f 72 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e for all children
1b680 20 6f 66 20 70 61 67 65 20 70 50 61 67 65 2e 20 of page pPage.
1b690 41 6c 73 6f 2c 20 69 66 0a 2a 2a 20 70 50 61 67 Also, if.** pPag
1b6a0 65 20 63 6f 6e 74 61 69 6e 73 20 63 65 6c 6c 73 e contains cells
1b6b0 20 74 68 61 74 20 70 6f 69 6e 74 20 74 6f 20 6f that point to o
1b6c0 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 73 verflow pages, s
1b6d0 65 74 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a et the pointer.*
1b6e0 2a 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f * map entries fo
1b6f0 72 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 r the overflow p
1b700 61 67 65 73 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f ages as well..*/
1b710 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 43 .static int setC
1b720 68 69 6c 64 50 74 72 6d 61 70 73 28 4d 65 6d 50 hildPtrmaps(MemP
1b730 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 age *pPage){. i
1b740 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 nt i;
1b750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b760 20 20 2f 2a 20 43 6f 75 6e 74 65 72 20 76 61 72 /* Counter var
1b770 69 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e iable */. int n
1b780 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Cell;
1b790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1b7a0 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 Number of cells
1b7b0 20 69 6e 20 70 61 67 65 20 70 50 61 67 65 20 2a in page pPage *
1b7c0 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 /. int rc;
1b7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b7e0 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
1b7f0 20 63 6f 64 65 20 2a 2f 0a 20 20 42 74 53 68 61 code */. BtSha
1b800 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 67 65 red *pBt = pPage
1b810 2d 3e 70 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 ->pBt;. Pgno pg
1b820 6e 6f 20 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f no = pPage->pgno
1b830 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
1b840 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
1b850 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
1b860 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 x) );. rc = btr
1b870 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 eeInitPage(pPage
1b880 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
1b890 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
1b8a0 72 63 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 rc;. nCell = pP
1b8b0 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 66 age->nCell;.. f
1b8c0 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b or(i=0; i<nCell;
1b8d0 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 i++){. u8 *p
1b8e0 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 Cell = findCell(
1b8f0 70 50 61 67 65 2c 20 69 29 3b 0a 0a 20 20 20 20 pPage, i);..
1b900 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 ptrmapPutOvflPtr
1b910 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
1b920 72 63 29 3b 0a 0a 20 20 20 20 69 66 28 20 21 70 rc);.. if( !p
1b930 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
1b940 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 67 Pgno childPg
1b950 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 43 no = get4byte(pC
1b960 65 6c 6c 29 3b 0a 20 20 20 20 20 20 70 74 72 6d ell);. ptrm
1b970 61 70 50 75 74 28 70 42 74 2c 20 63 68 69 6c 64 apPut(pBt, child
1b980 50 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 54 52 Pgno, PTRMAP_BTR
1b990 45 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 3b 0a EE, pgno, &rc);.
1b9a0 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 }. }.. if(
1b9b0 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
1b9c0 0a 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 . Pgno childP
1b9d0 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 gno = get4byte(&
1b9e0 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 pPage->aData[pPa
1b9f0 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ge->hdrOffset+8]
1ba00 29 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 );. ptrmapPut
1ba10 28 70 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c (pBt, childPgno,
1ba20 20 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 PTRMAP_BTREE, p
1ba30 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 7d 0a 0a gno, &rc);. }..
1ba40 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1ba50 2f 2a 0a 2a 2a 20 53 6f 6d 65 77 68 65 72 65 20 /*.** Somewhere
1ba60 6f 6e 20 70 50 61 67 65 20 69 73 20 61 20 70 6f on pPage is a po
1ba70 69 6e 74 65 72 20 74 6f 20 70 61 67 65 20 69 46 inter to page iF
1ba80 72 6f 6d 2e 20 20 4d 6f 64 69 66 79 20 74 68 69 rom. Modify thi
1ba90 73 20 70 6f 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 s pointer so.**
1baa0 74 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 that it points t
1bab0 6f 20 69 54 6f 2e 20 50 61 72 61 6d 65 74 65 72 o iTo. Parameter
1bac0 20 65 54 79 70 65 20 64 65 73 63 72 69 62 65 73 eType describes
1bad0 20 74 68 65 20 74 79 70 65 20 6f 66 20 70 6f 69 the type of poi
1bae0 6e 74 65 72 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f nter to.** be mo
1baf0 64 69 66 69 65 64 2c 20 61 73 20 20 66 6f 6c 6c dified, as foll
1bb00 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 ows:.**.** PTRMA
1bb10 50 5f 42 54 52 45 45 3a 20 20 20 20 20 70 50 61 P_BTREE: pPa
1bb20 67 65 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 ge is a btree-pa
1bb30 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 ge. The pointer
1bb40 70 6f 69 6e 74 73 20 61 74 20 61 20 63 68 69 6c points at a chil
1bb50 64 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 d .**
1bb60 20 20 20 20 20 20 20 20 70 61 67 65 20 6f 66 20 page of
1bb70 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 pPage..**.** PTR
1bb80 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 3a 20 70 MAP_OVERFLOW1: p
1bb90 50 61 67 65 20 69 73 20 61 20 62 74 72 65 65 2d Page is a btree-
1bba0 70 61 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 page. The pointe
1bbb0 72 20 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 6f r points at an o
1bbc0 76 65 72 66 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 verflow.**
1bbd0 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 pag
1bbe0 65 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 e pointed to by
1bbf0 6f 6e 65 20 6f 66 20 74 68 65 20 63 65 6c 6c 73 one of the cells
1bc00 20 6f 6e 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a on pPage..**.**
1bc10 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 PTRMAP_OVERFLOW
1bc20 32 3a 20 70 50 61 67 65 20 69 73 20 61 6e 20 6f 2: pPage is an o
1bc30 76 65 72 66 6c 6f 77 2d 70 61 67 65 2e 20 54 68 verflow-page. Th
1bc40 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 e pointer points
1bc50 20 61 74 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 at the next.**
1bc60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bc70 20 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 overflow page
1bc80 69 6e 20 74 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a in the list..*/.
1bc90 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 64 69 66 static int modif
1bca0 79 50 61 67 65 50 6f 69 6e 74 65 72 28 4d 65 6d yPagePointer(Mem
1bcb0 50 61 67 65 20 2a 70 50 61 67 65 2c 20 50 67 6e Page *pPage, Pgn
1bcc0 6f 20 69 46 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 o iFrom, Pgno iT
1bcd0 6f 2c 20 75 38 20 65 54 79 70 65 29 7b 0a 20 20 o, u8 eType){.
1bce0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
1bcf0 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
1bd00 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
1bd10 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
1bd20 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
1bd30 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
1bd40 65 29 20 29 3b 0a 20 20 69 66 28 20 65 54 79 70 e) );. if( eTyp
1bd50 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c e==PTRMAP_OVERFL
1bd60 4f 57 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 OW2 ){. /* Th
1bd70 65 20 70 6f 69 6e 74 65 72 20 69 73 20 61 6c 77 e pointer is alw
1bd80 61 79 73 20 74 68 65 20 66 69 72 73 74 20 34 20 ays the first 4
1bd90 62 79 74 65 73 20 6f 66 20 74 68 65 20 70 61 67 bytes of the pag
1bda0 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 e in this case.
1bdb0 20 2a 2f 0a 20 20 20 20 69 66 28 20 67 65 74 34 */. if( get4
1bdc0 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 byte(pPage->aDat
1bdd0 61 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 a)!=iFrom ){.
1bde0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
1bdf0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
1be00 20 20 20 7d 0a 20 20 20 20 70 75 74 34 62 79 74 }. put4byt
1be10 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 e(pPage->aData,
1be20 69 54 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 iTo);. }else{.
1be30 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e int i;. in
1be40 74 20 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e 74 t nCell;. int
1be50 20 72 63 3b 0a 0a 20 20 20 20 72 63 20 3d 20 62 rc;.. rc = b
1be60 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 treeInitPage(pPa
1be70 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 ge);. if( rc
1be80 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
1be90 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e nCell = pPage->
1bea0 6e 43 65 6c 6c 3b 0a 0a 20 20 20 20 66 6f 72 28 nCell;.. for(
1beb0 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b i=0; i<nCell; i+
1bec0 2b 29 7b 0a 20 20 20 20 20 20 75 38 20 2a 70 43 +){. u8 *pC
1bed0 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 ell = findCell(p
1bee0 50 61 67 65 2c 20 69 29 3b 0a 20 20 20 20 20 20 Page, i);.
1bef0 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
1bf00 50 5f 4f 56 45 52 46 4c 4f 57 31 20 29 7b 0a 20 P_OVERFLOW1 ){.
1bf10 20 20 20 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 CellInfo
1bf20 69 6e 66 6f 3b 0a 20 20 20 20 20 20 20 20 70 50 info;. pP
1bf30 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 age->xParseCell(
1bf40 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 pPage, pCell, &i
1bf50 6e 66 6f 29 3b 0a 20 20 20 20 20 20 20 20 69 66 nfo);. if
1bf60 28 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 6e ( info.nLocal<in
1bf70 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 fo.nPayload ){.
1bf80 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 65 if( pCe
1bf90 6c 6c 2b 69 6e 66 6f 2e 6e 53 69 7a 65 20 3e 20 ll+info.nSize >
1bfa0 70 50 61 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 pPage->aData+pPa
1bfb0 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
1bfc0 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ize ){.
1bfd0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
1bfe0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
1bff0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
1c000 20 20 20 20 20 69 66 28 20 69 46 72 6f 6d 3d 3d if( iFrom==
1c010 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c 2b 69 get4byte(pCell+i
1c020 6e 66 6f 2e 6e 53 69 7a 65 2d 34 29 20 29 7b 0a nfo.nSize-4) ){.
1c030 20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 put4
1c040 62 79 74 65 28 70 43 65 6c 6c 2b 69 6e 66 6f 2e byte(pCell+info.
1c050 6e 53 69 7a 65 2d 34 2c 20 69 54 6f 29 3b 0a 20 nSize-4, iTo);.
1c060 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
1c070 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
1c080 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 }. }e
1c090 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 69 66 28 lse{. if(
1c0a0 20 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c 29 get4byte(pCell)
1c0b0 3d 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 ==iFrom ){.
1c0c0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 70 43 put4byte(pC
1c0d0 65 6c 6c 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 ell, iTo);.
1c0e0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1c0f0 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
1c100 20 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 69 }. . if( i
1c110 3d 3d 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 ==nCell ){.
1c120 20 69 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d if( eType!=PTRM
1c130 41 50 5f 42 54 52 45 45 20 7c 7c 20 0a 20 20 20 AP_BTREE || .
1c140 20 20 20 20 20 20 20 67 65 74 34 62 79 74 65 28 get4byte(
1c150 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 &pPage->aData[pP
1c160 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 age->hdrOffset+8
1c170 5d 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 ])!=iFrom ){.
1c180 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
1c190 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
1c1a0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 . }. p
1c1b0 75 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e ut4byte(&pPage->
1c1c0 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 aData[pPage->hdr
1c1d0 4f 66 66 73 65 74 2b 38 5d 2c 20 69 54 6f 29 3b Offset+8], iTo);
1c1e0 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
1c1f0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
1c200 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 .../*.** Move th
1c210 65 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 e open database
1c220 70 61 67 65 20 70 44 62 50 61 67 65 20 74 6f 20 page pDbPage to
1c230 6c 6f 63 61 74 69 6f 6e 20 69 46 72 65 65 50 61 location iFreePa
1c240 67 65 20 69 6e 20 74 68 65 20 0a 2a 2a 20 64 61 ge in the .** da
1c250 74 61 62 61 73 65 2e 20 54 68 65 20 70 44 62 50 tabase. The pDbP
1c260 61 67 65 20 72 65 66 65 72 65 6e 63 65 20 72 65 age reference re
1c270 6d 61 69 6e 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a mains valid..**.
1c280 2a 2a 20 54 68 65 20 69 73 43 6f 6d 6d 69 74 20 ** The isCommit
1c290 66 6c 61 67 20 69 6e 64 69 63 61 74 65 73 20 74 flag indicates t
1c2a0 68 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 hat there is no
1c2b0 6e 65 65 64 20 74 6f 20 72 65 6d 65 6d 62 65 72 need to remember
1c2c0 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 that.** the jou
1c2d0 72 6e 61 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 rnal needs to be
1c2e0 20 73 79 6e 63 28 29 65 64 20 62 65 66 6f 72 65 sync()ed before
1c2f0 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 70 database page p
1c300 44 62 50 61 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a DbPage->pgno .**
1c310 20 63 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 can be written
1c320 74 6f 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 68 to. The caller h
1c330 61 73 20 61 6c 72 65 61 64 79 20 70 72 6f 6d 69 as already promi
1c340 73 65 64 20 6e 6f 74 20 74 6f 20 77 72 69 74 65 sed not to write
1c350 20 74 6f 20 74 68 61 74 0a 2a 2a 20 70 61 67 65 to that.** page
1c360 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1c370 72 65 6c 6f 63 61 74 65 50 61 67 65 28 0a 20 20 relocatePage(.
1c380 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 BtShared *pBt,
1c390 20 20 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 /* Btre
1c3a0 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a e */. MemPage *
1c3b0 70 44 62 50 61 67 65 2c 20 20 20 20 20 20 20 20 pDbPage,
1c3c0 2f 2a 20 4f 70 65 6e 20 70 61 67 65 20 74 6f 20 /* Open page to
1c3d0 6d 6f 76 65 20 2a 2f 0a 20 20 75 38 20 65 54 79 move */. u8 eTy
1c3e0 70 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 pe,
1c3f0 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 /* Pointer ma
1c400 70 20 27 74 79 70 65 27 20 65 6e 74 72 79 20 66 p 'type' entry f
1c410 6f 72 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 or pDbPage */.
1c420 50 67 6e 6f 20 69 50 74 72 50 61 67 65 2c 20 20 Pgno iPtrPage,
1c430 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
1c440 74 65 72 20 6d 61 70 20 27 70 61 67 65 2d 6e 6f ter map 'page-no
1c450 27 20 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 ' entry for pDbP
1c460 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 age */. Pgno iF
1c470 72 65 65 50 61 67 65 2c 20 20 20 20 20 20 20 20 reePage,
1c480 20 20 2f 2a 20 54 68 65 20 6c 6f 63 61 74 69 6f /* The locatio
1c490 6e 20 74 6f 20 6d 6f 76 65 20 70 44 62 50 61 67 n to move pDbPag
1c4a0 65 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 73 e to */. int is
1c4b0 43 6f 6d 6d 69 74 20 20 20 20 20 20 20 20 20 20 Commit
1c4c0 20 20 20 2f 2a 20 69 73 43 6f 6d 6d 69 74 20 66 /* isCommit f
1c4d0 6c 61 67 20 70 61 73 73 65 64 20 74 6f 20 73 71 lag passed to sq
1c4e0 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 lite3PagerMovepa
1c4f0 67 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 ge */.){. MemPa
1c500 67 65 20 2a 70 50 74 72 50 61 67 65 3b 20 20 20 ge *pPtrPage;
1c510 2f 2a 20 54 68 65 20 70 61 67 65 20 74 68 61 74 /* The page that
1c520 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e contains a poin
1c530 74 65 72 20 74 6f 20 70 44 62 50 61 67 65 20 2a ter to pDbPage *
1c540 2f 0a 20 20 50 67 6e 6f 20 69 44 62 50 61 67 65 /. Pgno iDbPage
1c550 20 3d 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f = pDbPage->pgno
1c560 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 ;. Pager *pPage
1c570 72 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 72 3b r = pBt->pPager;
1c580 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
1c590 73 65 72 74 28 20 65 54 79 70 65 3d 3d 50 54 52 sert( eType==PTR
1c5a0 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 7c 7c MAP_OVERFLOW2 ||
1c5b0 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f eType==PTRMAP_O
1c5c0 56 45 52 46 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 VERFLOW1 || .
1c5d0 20 20 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 eType==PTRMAP
1c5e0 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d _BTREE || eType=
1c5f0 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 =PTRMAP_ROOTPAGE
1c600 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
1c610 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
1c620 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
1c630 20 20 61 73 73 65 72 74 28 20 70 44 62 50 61 67 assert( pDbPag
1c640 65 2d 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 0a e->pBt==pBt );..
1c650 20 20 2f 2a 20 4d 6f 76 65 20 70 61 67 65 20 69 /* Move page i
1c660 44 62 50 61 67 65 20 66 72 6f 6d 20 69 74 73 20 DbPage from its
1c670 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e current location
1c680 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 to page number
1c690 69 46 72 65 65 50 61 67 65 20 2a 2f 0a 20 20 54 iFreePage */. T
1c6a0 52 41 43 45 28 28 22 41 55 54 4f 56 41 43 55 55 RACE(("AUTOVACUU
1c6b0 4d 3a 20 4d 6f 76 69 6e 67 20 25 64 20 74 6f 20 M: Moving %d to
1c6c0 66 72 65 65 20 70 61 67 65 20 25 64 20 28 70 74 free page %d (pt
1c6d0 72 20 70 61 67 65 20 25 64 20 74 79 70 65 20 25 r page %d type %
1c6e0 64 29 5c 6e 22 2c 20 0a 20 20 20 20 20 20 69 44 d)\n", . iD
1c6f0 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 bPage, iFreePage
1c700 2c 20 69 50 74 72 50 61 67 65 2c 20 65 54 79 70 , iPtrPage, eTyp
1c710 65 29 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 e));. rc = sqli
1c720 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 te3PagerMovepage
1c730 28 70 50 61 67 65 72 2c 20 70 44 62 50 61 67 65 (pPager, pDbPage
1c740 2d 3e 70 44 62 50 61 67 65 2c 20 69 46 72 65 65 ->pDbPage, iFree
1c750 50 61 67 65 2c 20 69 73 43 6f 6d 6d 69 74 29 3b Page, isCommit);
1c760 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
1c770 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 E_OK ){. retu
1c780 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 44 62 rn rc;. }. pDb
1c790 50 61 67 65 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 Page->pgno = iFr
1c7a0 65 65 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 eePage;.. /* If
1c7b0 20 70 44 62 50 61 67 65 20 77 61 73 20 61 20 62 pDbPage was a b
1c7c0 74 72 65 65 2d 70 61 67 65 2c 20 74 68 65 6e 20 tree-page, then
1c7d0 69 74 20 6d 61 79 20 68 61 76 65 20 63 68 69 6c it may have chil
1c7e0 64 20 70 61 67 65 73 20 61 6e 64 2f 6f 72 20 63 d pages and/or c
1c7f0 65 6c 6c 73 0a 20 20 2a 2a 20 74 68 61 74 20 70 ells. ** that p
1c800 6f 69 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 oint to overflow
1c810 20 70 61 67 65 73 2e 20 54 68 65 20 70 6f 69 6e pages. The poin
1c820 74 65 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 ter map entries
1c830 66 6f 72 20 61 6c 6c 20 74 68 65 73 65 0a 20 20 for all these.
1c840 2a 2a 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f ** pages need to
1c850 20 62 65 20 63 68 61 6e 67 65 64 2e 0a 20 20 2a be changed.. *
1c860 2a 0a 20 20 2a 2a 20 49 66 20 70 44 62 50 61 67 *. ** If pDbPag
1c870 65 20 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 e is an overflow
1c880 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 page, then the
1c890 66 69 72 73 74 20 34 20 62 79 74 65 73 20 6d 61 first 4 bytes ma
1c8a0 79 20 73 74 6f 72 65 20 61 0a 20 20 2a 2a 20 70 y store a. ** p
1c8b0 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 75 62 73 ointer to a subs
1c8c0 65 71 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 equent overflow
1c8d0 70 61 67 65 2e 20 49 66 20 74 68 69 73 20 69 73 page. If this is
1c8e0 20 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 0a the case, then.
1c8f0 20 20 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 ** the pointer
1c900 20 6d 61 70 20 6e 65 65 64 73 20 74 6f 20 62 65 map needs to be
1c910 20 75 70 64 61 74 65 64 20 66 6f 72 20 74 68 65 updated for the
1c920 20 73 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 subsequent over
1c930 66 6c 6f 77 20 70 61 67 65 2e 0a 20 20 2a 2f 0a flow page.. */.
1c940 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 if( eType==PTR
1c950 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 MAP_BTREE || eTy
1c960 70 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 pe==PTRMAP_ROOTP
1c970 41 47 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 AGE ){. rc =
1c980 73 65 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 setChildPtrmaps(
1c990 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 pDbPage);. if
1c9a0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1c9b0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1c9c0 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 rc;. }. }els
1c9d0 65 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 e{. Pgno next
1c9e0 4f 76 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 Ovfl = get4byte(
1c9f0 70 44 62 50 61 67 65 2d 3e 61 44 61 74 61 29 3b pDbPage->aData);
1ca00 0a 20 20 20 20 69 66 28 20 6e 65 78 74 4f 76 66 . if( nextOvf
1ca10 6c 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 74 l!=0 ){. pt
1ca20 72 6d 61 70 50 75 74 28 70 42 74 2c 20 6e 65 78 rmapPut(pBt, nex
1ca30 74 4f 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 tOvfl, PTRMAP_OV
1ca40 45 52 46 4c 4f 57 32 2c 20 69 46 72 65 65 50 61 ERFLOW2, iFreePa
1ca50 67 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 ge, &rc);.
1ca60 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1ca70 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 K ){. ret
1ca80 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a urn rc;. }.
1ca90 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
1caa0 46 69 78 20 74 68 65 20 64 61 74 61 62 61 73 65 Fix the database
1cab0 20 70 6f 69 6e 74 65 72 20 6f 6e 20 70 61 67 65 pointer on page
1cac0 20 69 50 74 72 50 61 67 65 20 74 68 61 74 20 70 iPtrPage that p
1cad0 6f 69 6e 74 65 64 20 61 74 20 69 44 62 50 61 67 ointed at iDbPag
1cae0 65 20 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 69 e so. ** that i
1caf0 74 20 70 6f 69 6e 74 73 20 61 74 20 69 46 72 65 t points at iFre
1cb00 65 50 61 67 65 2e 20 41 6c 73 6f 20 66 69 78 20 ePage. Also fix
1cb10 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 the pointer map
1cb20 65 6e 74 72 79 20 66 6f 72 0a 20 20 2a 2a 20 69 entry for. ** i
1cb30 50 74 72 50 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 PtrPage.. */.
1cb40 69 66 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 if( eType!=PTRMA
1cb50 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 P_ROOTPAGE ){.
1cb60 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 rc = btreeGetP
1cb70 61 67 65 28 70 42 74 2c 20 69 50 74 72 50 61 67 age(pBt, iPtrPag
1cb80 65 2c 20 26 70 50 74 72 50 61 67 65 2c 20 30 29 e, &pPtrPage, 0)
1cb90 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
1cba0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1cbb0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
1cbc0 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
1cbd0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 74 e3PagerWrite(pPt
1cbe0 72 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b rPage->pDbPage);
1cbf0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
1cc00 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1cc10 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 releasePage(pPtr
1cc20 50 61 67 65 29 3b 0a 20 20 20 20 20 20 72 65 74 Page);. ret
1cc30 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
1cc40 20 20 72 63 20 3d 20 6d 6f 64 69 66 79 50 61 67 rc = modifyPag
1cc50 65 50 6f 69 6e 74 65 72 28 70 50 74 72 50 61 67 ePointer(pPtrPag
1cc60 65 2c 20 69 44 62 50 61 67 65 2c 20 69 46 72 65 e, iDbPage, iFre
1cc70 65 50 61 67 65 2c 20 65 54 79 70 65 29 3b 0a 20 ePage, eType);.
1cc80 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
1cc90 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 PtrPage);. if
1cca0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1ccb0 29 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 ){. ptrmapP
1ccc0 75 74 28 70 42 74 2c 20 69 46 72 65 65 50 61 67 ut(pBt, iFreePag
1ccd0 65 2c 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 e, eType, iPtrPa
1cce0 67 65 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a ge, &rc);. }.
1ccf0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
1cd00 0a 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 64 .}../* Forward d
1cd10 65 63 6c 61 72 61 74 69 6f 6e 20 72 65 71 75 69 eclaration requi
1cd20 72 65 64 20 62 79 20 69 6e 63 72 56 61 63 75 75 red by incrVacuu
1cd30 6d 53 74 65 70 28 29 2e 20 2a 2f 0a 73 74 61 74 mStep(). */.stat
1cd40 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 ic int allocateB
1cd50 74 72 65 65 50 61 67 65 28 42 74 53 68 61 72 65 treePage(BtShare
1cd60 64 20 2a 2c 20 4d 65 6d 50 61 67 65 20 2a 2a 2c d *, MemPage **,
1cd70 20 50 67 6e 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 Pgno *, Pgno, u
1cd80 38 29 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 8);../*.** Perfo
1cd90 72 6d 20 61 20 73 69 6e 67 6c 65 20 73 74 65 70 rm a single step
1cda0 20 6f 66 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 of an increment
1cdb0 61 6c 2d 76 61 63 75 75 6d 2e 20 49 66 20 73 75 al-vacuum. If su
1cdc0 63 63 65 73 73 66 75 6c 2c 20 72 65 74 75 72 6e ccessful, return
1cdd0 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 .** SQLITE_OK. I
1cde0 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 6f f there is no wo
1cdf0 72 6b 20 74 6f 20 64 6f 20 28 61 6e 64 20 74 68 rk to do (and th
1ce00 65 72 65 66 6f 72 65 20 6e 6f 20 70 6f 69 6e 74 erefore no point
1ce10 20 69 6e 20 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 in .** calling
1ce20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 this function ag
1ce30 61 69 6e 29 2c 20 72 65 74 75 72 6e 20 53 51 4c ain), return SQL
1ce40 49 54 45 5f 44 4f 4e 45 2e 20 4f 72 2c 20 69 66 ITE_DONE. Or, if
1ce50 20 61 6e 20 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 an error .** oc
1ce60 63 75 72 73 2c 20 72 65 74 75 72 6e 20 73 6f 6d curs, return som
1ce70 65 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f e other error co
1ce80 64 65 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 73 de..**.** More s
1ce90 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 pecifically, thi
1cea0 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d s function attem
1ceb0 70 74 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 pts to re-organi
1cec0 7a 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ze the database
1ced0 73 6f 20 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 so .** that the
1cee0 6c 61 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 last page of the
1cef0 20 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 file currently
1cf00 69 6e 20 75 73 65 20 69 73 20 6e 6f 20 6c 6f 6e in use is no lon
1cf10 67 65 72 20 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a ger in use..**.*
1cf20 2a 20 50 61 72 61 6d 65 74 65 72 20 6e 46 69 6e * Parameter nFin
1cf30 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o
1cf40 66 20 70 61 67 65 73 20 74 68 61 74 20 74 68 69 f pages that thi
1cf50 73 20 64 61 74 61 62 61 73 65 20 77 6f 75 6c 64 s database would
1cf60 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 77 65 72 65 contain.** were
1cf70 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 this function c
1cf80 61 6c 6c 65 64 20 75 6e 74 69 6c 20 69 74 20 72 alled until it r
1cf90 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f eturns SQLITE_DO
1cfa0 4e 45 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 NE..**.** If the
1cfb0 20 62 43 6f 6d 6d 69 74 20 70 61 72 61 6d 65 74 bCommit paramet
1cfc0 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 er is non-zero,
1cfd0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 this function as
1cfe0 73 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 0a sumes that the .
1cff0 2a 2a 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6b ** caller will k
1d000 65 65 70 20 63 61 6c 6c 69 6e 67 20 69 6e 63 72 eep calling incr
1d010 56 61 63 75 75 6d 53 74 65 70 28 29 20 75 6e 74 VacuumStep() unt
1d020 69 6c 20 69 74 20 72 65 74 75 72 6e 73 20 53 51 il it returns SQ
1d030 4c 49 54 45 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 LITE_DONE .** or
1d040 20 61 6e 20 65 72 72 6f 72 2e 20 62 43 6f 6d 6d an error. bComm
1d050 69 74 20 69 73 20 70 61 73 73 65 64 20 74 72 75 it is passed tru
1d060 65 20 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 e for an auto-va
1d070 63 75 75 6d 2d 6f 6e 2d 63 6f 6d 6d 69 74 20 0a cuum-on-commit .
1d080 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 2c 20 6f 72 ** operation, or
1d090 20 66 61 6c 73 65 20 66 6f 72 20 61 6e 20 69 6e false for an in
1d0a0 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
1d0b0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1d0c0 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 42 incrVacuumStep(B
1d0d0 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
1d0e0 6e 6f 20 6e 46 69 6e 2c 20 50 67 6e 6f 20 69 4c no nFin, Pgno iL
1d0f0 61 73 74 50 67 2c 20 69 6e 74 20 62 43 6f 6d 6d astPg, int bComm
1d100 69 74 29 7b 0a 20 20 50 67 6e 6f 20 6e 46 72 65 it){. Pgno nFre
1d110 65 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 eList;
1d120 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
1d130 67 65 73 20 73 74 69 6c 6c 20 6f 6e 20 74 68 65 ges still on the
1d140 20 66 72 65 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 free-list */.
1d150 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
1d160 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
1d170 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
1d180 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 ) );. assert( i
1d190 4c 61 73 74 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a LastPg>nFin );..
1d1a0 20 20 69 66 28 20 21 50 54 52 4d 41 50 5f 49 53 if( !PTRMAP_IS
1d1b0 50 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 PAGE(pBt, iLastP
1d1c0 67 29 20 26 26 20 69 4c 61 73 74 50 67 21 3d 50 g) && iLastPg!=P
1d1d0 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
1d1e0 28 70 42 74 29 20 29 7b 0a 20 20 20 20 75 38 20 (pBt) ){. u8
1d1f0 65 54 79 70 65 3b 0a 20 20 20 20 50 67 6e 6f 20 eType;. Pgno
1d200 69 50 74 72 50 61 67 65 3b 0a 0a 20 20 20 20 6e iPtrPage;.. n
1d210 46 72 65 65 4c 69 73 74 20 3d 20 67 65 74 34 62 FreeList = get4b
1d220 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 yte(&pBt->pPage1
1d230 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 ->aData[36]);.
1d240 20 20 69 66 28 20 6e 46 72 65 65 4c 69 73 74 3d if( nFreeList=
1d250 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 =0 ){. retu
1d260 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a rn SQLITE_DONE;.
1d270 20 20 20 20 7d 0a 0a 20 20 20 20 72 63 20 3d 20 }.. rc =
1d280 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 69 ptrmapGet(pBt, i
1d290 4c 61 73 74 50 67 2c 20 26 65 54 79 70 65 2c 20 LastPg, &eType,
1d2a0 26 69 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 &iPtrPage);.
1d2b0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1d2c0 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 K ){. retur
1d2d0 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
1d2e0 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
1d2f0 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 P_ROOTPAGE ){.
1d300 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1d310 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
1d320 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 65 }.. if( e
1d330 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 52 45 Type==PTRMAP_FRE
1d340 45 50 41 47 45 20 29 7b 0a 20 20 20 20 20 20 69 EPAGE ){. i
1d350 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b f( bCommit==0 ){
1d360 0a 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f . /* Remo
1d370 76 65 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d ve the page from
1d380 20 74 68 65 20 66 69 6c 65 73 20 66 72 65 65 2d the files free-
1d390 6c 69 73 74 2e 20 54 68 69 73 20 69 73 20 6e 6f list. This is no
1d3a0 74 20 72 65 71 75 69 72 65 64 0a 20 20 20 20 20 t required.
1d3b0 20 20 20 2a 2a 20 69 66 20 62 43 6f 6d 6d 69 74 ** if bCommit
1d3c0 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e is non-zero. In
1d3d0 20 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 that case, the
1d3e0 66 72 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 free-list will b
1d3f0 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 75 e. ** tru
1d400 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 61 ncated to zero a
1d410 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 fter this functi
1d420 6f 6e 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 69 on returns, so i
1d430 74 20 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 20 t doesn't .
1d440 20 20 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 20 ** matter if
1d450 69 74 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 6e it still contain
1d460 73 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 65 s some garbage e
1d470 6e 74 72 69 65 73 2e 0a 20 20 20 20 20 20 20 20 ntries..
1d480 2a 2f 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 */. Pgno
1d490 69 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 iFreePg;.
1d4a0 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 MemPage *pFreeP
1d4b0 67 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 g;. rc =
1d4c0 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
1d4d0 65 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c e(pBt, &pFreePg,
1d4e0 20 26 69 46 72 65 65 50 67 2c 20 69 4c 61 73 74 &iFreePg, iLast
1d4f0 50 67 2c 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 Pg, BTALLOC_EXAC
1d500 54 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 T);. if(
1d510 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1d520 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
1d530 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
1d540 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
1d550 69 46 72 65 65 50 67 3d 3d 69 4c 61 73 74 50 67 iFreePg==iLastPg
1d560 20 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 );. rele
1d570 61 73 65 50 61 67 65 28 70 46 72 65 65 50 67 29 asePage(pFreePg)
1d580 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 ;. }. }
1d590 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 50 67 6e else {. Pgn
1d5a0 6f 20 69 46 72 65 65 50 67 3b 20 20 20 20 20 20 o iFreePg;
1d5b0 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 /* Index
1d5c0 6f 66 20 66 72 65 65 20 70 61 67 65 20 74 6f 20 of free page to
1d5d0 6d 6f 76 65 20 70 4c 61 73 74 50 67 20 74 6f 20 move pLastPg to
1d5e0 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 */. MemPage
1d5f0 20 2a 70 4c 61 73 74 50 67 3b 0a 20 20 20 20 20 *pLastPg;.
1d600 20 75 38 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c u8 eMode = BTAL
1d610 4c 4f 43 5f 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f LOC_ANY; /* Mo
1d620 64 65 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 de parameter for
1d630 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 allocateBtreePa
1d640 67 65 28 29 20 2a 2f 0a 20 20 20 20 20 20 50 67 ge() */. Pg
1d650 6e 6f 20 69 4e 65 61 72 20 3d 20 30 3b 20 20 20 no iNear = 0;
1d660 20 20 20 20 20 20 20 20 2f 2a 20 6e 65 61 72 62 /* nearb
1d670 79 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 y parameter for
1d680 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
1d690 65 28 29 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 e() */.. rc
1d6a0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
1d6b0 70 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 70 pBt, iLastPg, &p
1d6c0 4c 61 73 74 50 67 2c 20 30 29 3b 0a 20 20 20 20 LastPg, 0);.
1d6d0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1d6e0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 _OK ){. r
1d6f0 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
1d700 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 62 }.. /* If b
1d710 43 6f 6d 6d 69 74 20 69 73 20 7a 65 72 6f 2c 20 Commit is zero,
1d720 74 68 69 73 20 6c 6f 6f 70 20 72 75 6e 73 20 65 this loop runs e
1d730 78 61 63 74 6c 79 20 6f 6e 63 65 20 61 6e 64 20 xactly once and
1d740 70 61 67 65 20 70 4c 61 73 74 50 67 0a 20 20 20 page pLastPg.
1d750 20 20 20 2a 2a 20 69 73 20 73 77 61 70 70 65 64 ** is swapped
1d760 20 77 69 74 68 20 74 68 65 20 66 69 72 73 74 20 with the first
1d770 66 72 65 65 20 70 61 67 65 20 70 75 6c 6c 65 64 free page pulled
1d780 20 6f 66 66 20 74 68 65 20 66 72 65 65 20 6c 69 off the free li
1d790 73 74 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 st.. **.
1d7a0 20 20 20 2a 2a 20 4f 6e 20 74 68 65 20 6f 74 68 ** On the oth
1d7b0 65 72 20 68 61 6e 64 2c 20 69 66 20 62 43 6f 6d er hand, if bCom
1d7c0 6d 69 74 20 69 73 20 67 72 65 61 74 65 72 20 74 mit is greater t
1d7d0 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6b han zero, then k
1d7e0 65 65 70 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 6f eep. ** loo
1d7f0 70 69 6e 67 20 75 6e 74 69 6c 20 61 20 66 72 65 ping until a fre
1d800 65 2d 70 61 67 65 20 6c 6f 63 61 74 65 64 20 77 e-page located w
1d810 69 74 68 69 6e 20 74 68 65 20 66 69 72 73 74 20 ithin the first
1d820 6e 46 69 6e 20 70 61 67 65 73 0a 20 20 20 20 20 nFin pages.
1d830 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 ** of the file
1d840 69 73 20 66 6f 75 6e 64 2e 0a 20 20 20 20 20 20 is found..
1d850 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f */. if( bCo
1d860 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 mmit==0 ){.
1d870 20 20 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c eMode = BTALL
1d880 4f 43 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 69 OC_LE;. i
1d890 4e 65 61 72 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 Near = nFin;.
1d8a0 20 20 20 7d 0a 20 20 20 20 20 20 64 6f 20 7b 0a }. do {.
1d8b0 20 20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 MemPage
1d8c0 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 *pFreePg;.
1d8d0 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 rc = allocateB
1d8e0 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 treePage(pBt, &p
1d8f0 46 72 65 65 50 67 2c 20 26 69 46 72 65 65 50 67 FreePg, &iFreePg
1d900 2c 20 69 4e 65 61 72 2c 20 65 4d 6f 64 65 29 3b , iNear, eMode);
1d910 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 . if( rc!
1d920 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1d930 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
1d940 61 67 65 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 age(pLastPg);.
1d950 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
1d960 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 c;. }.
1d970 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
1d980 28 70 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 (pFreePg);.
1d990 20 7d 77 68 69 6c 65 28 20 62 43 6f 6d 6d 69 74 }while( bCommit
1d9a0 20 26 26 20 69 46 72 65 65 50 67 3e 6e 46 69 6e && iFreePg>nFin
1d9b0 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 );. assert
1d9c0 28 20 69 46 72 65 65 50 67 3c 69 4c 61 73 74 50 ( iFreePg<iLastP
1d9d0 67 20 29 3b 0a 20 20 20 20 20 20 0a 20 20 20 20 g );. .
1d9e0 20 20 72 63 20 3d 20 72 65 6c 6f 63 61 74 65 50 rc = relocateP
1d9f0 61 67 65 28 70 42 74 2c 20 70 4c 61 73 74 50 67 age(pBt, pLastPg
1da00 2c 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 , eType, iPtrPag
1da10 65 2c 20 69 46 72 65 65 50 67 2c 20 62 43 6f 6d e, iFreePg, bCom
1da20 6d 69 74 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 mit);. rele
1da30 61 73 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 asePage(pLastPg)
1da40 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
1da50 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1da60 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
1da70 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1da80 7d 0a 0a 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 }.. if( bCommit
1da90 3d 3d 30 20 29 7b 0a 20 20 20 20 64 6f 20 7b 0a ==0 ){. do {.
1daa0 20 20 20 20 20 20 69 4c 61 73 74 50 67 2d 2d 3b iLastPg--;
1dab0 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 69 4c 61 . }while( iLa
1dac0 73 74 50 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 stPg==PENDING_BY
1dad0 54 45 5f 50 41 47 45 28 70 42 74 29 20 7c 7c 20 TE_PAGE(pBt) ||
1dae0 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 PTRMAP_ISPAGE(pB
1daf0 74 2c 20 69 4c 61 73 74 50 67 29 20 29 3b 0a 20 t, iLastPg) );.
1db00 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 pBt->bDoTrunc
1db10 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 70 42 74 ate = 1;. pBt
1db20 2d 3e 6e 50 61 67 65 20 3d 20 69 4c 61 73 74 50 ->nPage = iLastP
1db30 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 g;. }. return
1db40 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1db50 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 .** The database
1db60 20 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 66 opened by the f
1db70 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 irst argument is
1db80 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 an auto-vacuum
1db90 64 61 74 61 62 61 73 65 0a 2a 2a 20 6e 4f 72 69 database.** nOri
1dba0 67 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 20 g pages in size
1dbb0 63 6f 6e 74 61 69 6e 69 6e 67 20 6e 46 72 65 65 containing nFree
1dbc0 20 66 72 65 65 20 70 61 67 65 73 2e 20 52 65 74 free pages. Ret
1dbd0 75 72 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 urn the expected
1dbe0 20 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 74 68 65 .** size of the
1dbf0 20 64 61 74 61 62 61 73 65 20 69 6e 20 70 61 67 database in pag
1dc00 65 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 20 es following an
1dc10 61 75 74 6f 2d 76 61 63 75 75 6d 20 6f 70 65 72 auto-vacuum oper
1dc20 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ation..*/.static
1dc30 20 50 67 6e 6f 20 66 69 6e 61 6c 44 62 53 69 7a Pgno finalDbSiz
1dc40 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c e(BtShared *pBt,
1dc50 20 50 67 6e 6f 20 6e 4f 72 69 67 2c 20 50 67 6e Pgno nOrig, Pgn
1dc60 6f 20 6e 46 72 65 65 29 7b 0a 20 20 69 6e 74 20 o nFree){. int
1dc70 6e 45 6e 74 72 79 3b 20 20 20 20 20 20 20 20 20 nEntry;
1dc80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1dc90 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 umber of entries
1dca0 20 6f 6e 20 6f 6e 65 20 70 74 72 6d 61 70 20 70 on one ptrmap p
1dcb0 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 50 age */. Pgno nP
1dcc0 74 72 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 trmap;
1dcd0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1dce0 65 72 20 6f 66 20 50 74 72 4d 61 70 20 70 61 67 er of PtrMap pag
1dcf0 65 73 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a es to be freed *
1dd00 2f 0a 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 /. Pgno nFin;
1dd10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dd20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61 /* Return va
1dd30 6c 75 65 20 2a 2f 0a 0a 20 20 6e 45 6e 74 72 79 lue */.. nEntry
1dd40 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 = pBt->usableSi
1dd50 7a 65 2f 35 3b 0a 20 20 6e 50 74 72 6d 61 70 20 ze/5;. nPtrmap
1dd60 3d 20 28 6e 46 72 65 65 2d 6e 4f 72 69 67 2b 50 = (nFree-nOrig+P
1dd70 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 TRMAP_PAGENO(pBt
1dd80 2c 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 72 79 29 , nOrig)+nEntry)
1dd90 2f 6e 45 6e 74 72 79 3b 0a 20 20 6e 46 69 6e 20 /nEntry;. nFin
1dda0 3d 20 6e 4f 72 69 67 20 2d 20 6e 46 72 65 65 20 = nOrig - nFree
1ddb0 2d 20 6e 50 74 72 6d 61 70 3b 0a 20 20 69 66 28 - nPtrmap;. if(
1ddc0 20 6e 4f 72 69 67 3e 50 45 4e 44 49 4e 47 5f 42 nOrig>PENDING_B
1ddd0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 26 26 YTE_PAGE(pBt) &&
1dde0 20 6e 46 69 6e 3c 50 45 4e 44 49 4e 47 5f 42 59 nFin<PENDING_BY
1ddf0 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
1de00 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a nFin--;. }.
1de10 20 20 77 68 69 6c 65 28 20 50 54 52 4d 41 50 5f while( PTRMAP_
1de20 49 53 50 41 47 45 28 70 42 74 2c 20 6e 46 69 6e ISPAGE(pBt, nFin
1de30 29 20 7c 7c 20 6e 46 69 6e 3d 3d 50 45 4e 44 49 ) || nFin==PENDI
1de40 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
1de50 29 20 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b ) ){. nFin--;
1de60 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 6e . }.. return n
1de70 46 69 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 Fin;.}../*.** A
1de80 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f write-transactio
1de90 6e 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 65 64 n must be opened
1dea0 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 before calling
1deb0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a this function..*
1dec0 2a 20 49 74 20 70 65 72 66 6f 72 6d 73 20 61 20 * It performs a
1ded0 73 69 6e 67 6c 65 20 75 6e 69 74 20 6f 66 20 77 single unit of w
1dee0 6f 72 6b 20 74 6f 77 61 72 64 73 20 61 6e 20 69 ork towards an i
1def0 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 ncremental vacuu
1df00 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 m..**.** If the
1df10 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 incremental vacu
1df20 75 6d 20 69 73 20 66 69 6e 69 73 68 65 64 20 61 um is finished a
1df30 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 fter this functi
1df40 6f 6e 20 68 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 on has run,.** S
1df50 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65 QLITE_DONE is re
1df60 74 75 72 6e 65 64 2e 20 49 66 20 69 74 20 69 73 turned. If it is
1df70 20 6e 6f 74 20 66 69 6e 69 73 68 65 64 2c 20 62 not finished, b
1df80 75 74 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 ut no error occu
1df90 72 72 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f rred,.** SQLITE_
1dfa0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 OK is returned.
1dfb0 4f 74 68 65 72 77 69 73 65 20 61 6e 20 53 51 4c Otherwise an SQL
1dfc0 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 ite error code.
1dfd0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
1dfe0 74 72 65 65 49 6e 63 72 56 61 63 75 75 6d 28 42 treeIncrVacuum(B
1dff0 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 tree *p){. int
1e000 72 63 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a rc;. BtShared *
1e010 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 pBt = p->pBt;..
1e020 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1e030 65 72 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 er(p);. assert(
1e040 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
1e050 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ion==TRANS_WRITE
1e060 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d && p->inTrans==
1e070 54 52 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 TRANS_WRITE );.
1e080 20 69 66 28 20 21 70 42 74 2d 3e 61 75 74 6f 56 if( !pBt->autoV
1e090 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 acuum ){. rc
1e0a0 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 = SQLITE_DONE;.
1e0b0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 50 67 6e 6f }else{. Pgno
1e0c0 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 nOrig = btreePa
1e0d0 67 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 gecount(pBt);.
1e0e0 20 20 50 67 6e 6f 20 6e 46 72 65 65 20 3d 20 67 Pgno nFree = g
1e0f0 65 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 et4byte(&pBt->pP
1e100 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 age1->aData[36])
1e110 3b 0a 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 20 ;. Pgno nFin
1e120 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 42 = finalDbSize(pB
1e130 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 29 t, nOrig, nFree)
1e140 3b 0a 0a 20 20 20 20 69 66 28 20 6e 4f 72 69 67 ;.. if( nOrig
1e150 3c 6e 46 69 6e 20 29 7b 0a 20 20 20 20 20 20 72 <nFin ){. r
1e160 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
1e170 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c PT_BKPT;. }el
1e180 73 65 20 69 66 28 20 6e 46 72 65 65 3e 30 20 29 se if( nFree>0 )
1e190 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 {. rc = sav
1e1a0 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c eAllCursors(pBt,
1e1b0 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 0, 0);. if
1e1c0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1e1d0 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 76 61 6c ){. inval
1e1e0 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 idateAllOverflow
1e1f0 43 61 63 68 65 28 70 42 74 29 3b 0a 20 20 20 20 Cache(pBt);.
1e200 20 20 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 rc = incrVac
1e210 75 75 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 uumStep(pBt, nFi
1e220 6e 2c 20 6e 4f 72 69 67 2c 20 30 29 3b 0a 20 20 n, nOrig, 0);.
1e230 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
1e240 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1e250 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
1e260 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
1e270 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 pBt->pPage1->pDb
1e280 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 Page);. p
1e290 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 ut4byte(&pBt->pP
1e2a0 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c age1->aData[28],
1e2b0 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 pBt->nPage);.
1e2c0 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b }. }else{
1e2d0 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
1e2e0 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 TE_DONE;. }.
1e2f0 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 }. sqlite3Btre
1e300 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
1e310 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1e320 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
1e330 20 63 61 6c 6c 65 64 20 70 72 69 6f 72 20 74 6f called prior to
1e340 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d sqlite3PagerCom
1e350 6d 69 74 20 77 68 65 6e 20 61 20 74 72 61 6e 73 mit when a trans
1e360 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 6f 6d action.** is com
1e370 6d 69 74 74 65 64 20 66 6f 72 20 61 6e 20 61 75 mitted for an au
1e380 74 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 to-vacuum databa
1e390 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c se..**.** If SQL
1e3a0 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
1e3b0 65 64 2c 20 74 68 65 6e 20 2a 70 6e 54 72 75 6e ed, then *pnTrun
1e3c0 63 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 c is set to the
1e3d0 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 0a number of pages.
1e3e0 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ** the database
1e3f0 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 74 file should be t
1e400 72 75 6e 63 61 74 65 64 20 74 6f 20 64 75 72 69 runcated to duri
1e410 6e 67 20 74 68 65 20 63 6f 6d 6d 69 74 20 70 72 ng the commit pr
1e420 6f 63 65 73 73 2e 20 0a 2a 2a 20 69 2e 65 2e 20 ocess. .** i.e.
1e430 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 73 the database has
1e440 20 62 65 65 6e 20 72 65 6f 72 67 61 6e 69 7a 65 been reorganize
1e450 64 20 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20 74 d so that only t
1e460 68 65 20 66 69 72 73 74 20 2a 70 6e 54 72 75 6e he first *pnTrun
1e470 63 0a 2a 2a 20 70 61 67 65 73 20 61 72 65 20 69 c.** pages are i
1e480 6e 20 75 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 n use..*/.static
1e490 20 69 6e 74 20 61 75 74 6f 56 61 63 75 75 6d 43 int autoVacuumC
1e4a0 6f 6d 6d 69 74 28 42 74 53 68 61 72 65 64 20 2a ommit(BtShared *
1e4b0 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d pBt){. int rc =
1e4c0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 SQLITE_OK;. Pa
1e4d0 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 42 ger *pPager = pB
1e4e0 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 56 56 41 t->pPager;. VVA
1e4f0 5f 4f 4e 4c 59 28 20 69 6e 74 20 6e 52 65 66 20 _ONLY( int nRef
1e500 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 = sqlite3PagerRe
1e510 66 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 20 fcount(pPager);
1e520 29 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ).. assert( sql
1e530 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
1e540 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
1e550 20 69 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 invalidateAllOv
1e560 65 72 66 6c 6f 77 43 61 63 68 65 28 70 42 74 29 erflowCache(pBt)
1e570 3b 0a 20 20 61 73 73 65 72 74 28 70 42 74 2d 3e ;. assert(pBt->
1e580 61 75 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 69 autoVacuum);. i
1e590 66 28 20 21 70 42 74 2d 3e 69 6e 63 72 56 61 63 f( !pBt->incrVac
1e5a0 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 uum ){. Pgno
1e5b0 6e 46 69 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a nFin; /*
1e5c0 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
1e5d0 20 69 6e 20 64 61 74 61 62 61 73 65 20 61 66 74 in database aft
1e5e0 65 72 20 61 75 74 6f 76 61 63 75 75 6d 69 6e 67 er autovacuuming
1e5f0 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 */. Pgno nFr
1e600 65 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 ee; /* Nu
1e610 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e mber of pages on
1e620 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 6e the freelist in
1e630 69 74 69 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 50 itially */. P
1e640 67 6e 6f 20 69 46 72 65 65 3b 20 20 20 20 20 20 gno iFree;
1e650 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 70 61 /* The next pa
1e660 67 65 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a ge to be freed *
1e670 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 /. Pgno nOrig
1e680 3b 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 ; /* Data
1e690 62 61 73 65 20 73 69 7a 65 20 62 65 66 6f 72 65 base size before
1e6a0 20 66 72 65 65 69 6e 67 20 2a 2f 0a 0a 20 20 20 freeing */..
1e6b0 20 6e 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 nOrig = btreePa
1e6c0 67 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 gecount(pBt);.
1e6d0 20 20 69 66 28 20 50 54 52 4d 41 50 5f 49 53 50 if( PTRMAP_ISP
1e6e0 41 47 45 28 70 42 74 2c 20 6e 4f 72 69 67 29 20 AGE(pBt, nOrig)
1e6f0 7c 7c 20 6e 4f 72 69 67 3d 3d 50 45 4e 44 49 4e || nOrig==PENDIN
1e700 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
1e710 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 74 20 ){. /* It
1e720 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 is not possible
1e730 74 6f 20 63 72 65 61 74 65 20 61 20 64 61 74 61 to create a data
1e740 62 61 73 65 20 66 6f 72 20 77 68 69 63 68 20 74 base for which t
1e750 68 65 20 66 69 6e 61 6c 20 70 61 67 65 0a 20 20 he final page.
1e760 20 20 20 20 2a 2a 20 69 73 20 65 69 74 68 65 72 ** is either
1e770 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 a pointer-map p
1e780 61 67 65 20 6f 72 20 74 68 65 20 70 65 6e 64 69 age or the pendi
1e790 6e 67 2d 62 79 74 65 20 70 61 67 65 2e 20 49 66 ng-byte page. If
1e7a0 20 6f 6e 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 one. ** is
1e7b0 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c 20 74 68 encountered, th
1e7c0 69 73 20 69 6e 64 69 63 61 74 65 73 20 63 6f 72 is indicates cor
1e7d0 72 75 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a ruption.. *
1e7e0 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 /. return S
1e7f0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
1e800 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e PT;. }.. n
1e810 46 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 Free = get4byte(
1e820 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 &pBt->pPage1->aD
1e830 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 6e 46 ata[36]);. nF
1e840 69 6e 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 in = finalDbSize
1e850 28 70 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 (pBt, nOrig, nFr
1e860 65 65 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 ee);. if( nFi
1e870 6e 3e 6e 4f 72 69 67 20 29 20 72 65 74 75 72 6e n>nOrig ) return
1e880 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
1e890 42 4b 50 54 3b 0a 20 20 20 20 69 66 28 20 6e 46 BKPT;. if( nF
1e8a0 69 6e 3c 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 in<nOrig ){.
1e8b0 20 20 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 rc = saveAllCu
1e8c0 72 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 rsors(pBt, 0, 0)
1e8d0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 ;. }. for(
1e8e0 69 46 72 65 65 3d 6e 4f 72 69 67 3b 20 69 46 72 iFree=nOrig; iFr
1e8f0 65 65 3e 6e 46 69 6e 20 26 26 20 72 63 3d 3d 53 ee>nFin && rc==S
1e900 51 4c 49 54 45 5f 4f 4b 3b 20 69 46 72 65 65 2d QLITE_OK; iFree-
1e910 2d 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 69 -){. rc = i
1e920 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 70 42 ncrVacuumStep(pB
1e930 74 2c 20 6e 46 69 6e 2c 20 69 46 72 65 65 2c 20 t, nFin, iFree,
1e940 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 1);. }. if
1e950 28 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f ( (rc==SQLITE_DO
1e960 4e 45 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 NE || rc==SQLITE
1e970 5f 4f 4b 29 20 26 26 20 6e 46 72 65 65 3e 30 20 _OK) && nFree>0
1e980 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
1e990 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
1e9a0 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 pBt->pPage1->pDb
1e9b0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 70 75 74 Page);. put
1e9c0 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 4byte(&pBt->pPag
1e9d0 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 30 e1->aData[32], 0
1e9e0 29 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 );. put4byt
1e9f0 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e e(&pBt->pPage1->
1ea00 61 44 61 74 61 5b 33 36 5d 2c 20 30 29 3b 0a 20 aData[36], 0);.
1ea10 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
1ea20 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 Bt->pPage1->aDat
1ea30 61 5b 32 38 5d 2c 20 6e 46 69 6e 29 3b 0a 20 20 a[28], nFin);.
1ea40 20 20 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e pBt->bDoTrun
1ea50 63 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 cate = 1;.
1ea60 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 46 69 pBt->nPage = nFi
1ea70 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 n;. }. if(
1ea80 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
1ea90 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
1eaa0 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 50 61 agerRollback(pPa
1eab0 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a ger);. }. }.
1eac0 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 66 3e . assert( nRef>
1ead0 3d 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 =sqlite3PagerRef
1eae0 63 6f 75 6e 74 28 70 50 61 67 65 72 29 20 29 3b count(pPager) );
1eaf0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
1eb00 0a 23 65 6c 73 65 20 2f 2a 20 69 66 6e 64 65 66 .#else /* ifndef
1eb10 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
1eb20 4f 56 41 43 55 55 4d 20 2a 2f 0a 23 20 64 65 66 OVACUUM */.# def
1eb30 69 6e 65 20 73 65 74 43 68 69 6c 64 50 74 72 6d ine setChildPtrm
1eb40 61 70 73 28 78 29 20 53 51 4c 49 54 45 5f 4f 4b aps(x) SQLITE_OK
1eb50 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
1eb60 68 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 his routine does
1eb70 20 74 68 65 20 66 69 72 73 74 20 70 68 61 73 65 the first phase
1eb80 20 6f 66 20 61 20 74 77 6f 2d 70 68 61 73 65 20 of a two-phase
1eb90 63 6f 6d 6d 69 74 2e 20 20 54 68 69 73 20 72 6f commit. This ro
1eba0 75 74 69 6e 65 0a 2a 2a 20 63 61 75 73 65 73 20 utine.** causes
1ebb0 61 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e a rollback journ
1ebc0 61 6c 20 74 6f 20 62 65 20 63 72 65 61 74 65 64 al to be created
1ebd0 20 28 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 (if it does not
1ebe0 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 29 0a already exist).
1ebf0 2a 2a 20 61 6e 64 20 70 6f 70 75 6c 61 74 65 64 ** and populated
1ec00 20 77 69 74 68 20 65 6e 6f 75 67 68 20 69 6e 66 with enough inf
1ec10 6f 72 6d 61 74 69 6f 6e 20 73 6f 20 74 68 61 74 ormation so that
1ec20 20 69 66 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 if a power loss
1ec30 20 6f 63 63 75 72 73 0a 2a 2a 20 74 68 65 20 64 occurs.** the d
1ec40 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 20 72 atabase can be r
1ec50 65 73 74 6f 72 65 64 20 74 6f 20 69 74 73 20 6f estored to its o
1ec60 72 69 67 69 6e 61 6c 20 73 74 61 74 65 20 62 79 riginal state by
1ec70 20 70 6c 61 79 69 6e 67 20 62 61 63 6b 0a 2a 2a playing back.**
1ec80 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 the journal. T
1ec90 68 65 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 hen the contents
1eca0 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
1ecb0 61 72 65 20 66 6c 75 73 68 65 64 20 6f 75 74 20 are flushed out
1ecc0 74 6f 0a 2a 2a 20 74 68 65 20 64 69 73 6b 2e 20 to.** the disk.
1ecd0 20 41 66 74 65 72 20 74 68 65 20 6a 6f 75 72 6e After the journ
1ece0 61 6c 20 69 73 20 73 61 66 65 6c 79 20 6f 6e 20 al is safely on
1ecf0 6f 78 69 64 65 2c 20 74 68 65 20 63 68 61 6e 67 oxide, the chang
1ed00 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 es to the.** dat
1ed10 61 62 61 73 65 20 61 72 65 20 77 72 69 74 74 65 abase are writte
1ed20 6e 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 n into the datab
1ed30 61 73 65 20 66 69 6c 65 20 61 6e 64 20 66 6c 75 ase file and flu
1ed40 73 68 65 64 20 74 6f 20 6f 78 69 64 65 2e 0a 2a shed to oxide..*
1ed50 2a 20 41 74 20 74 68 65 20 65 6e 64 20 6f 66 20 * At the end of
1ed60 74 68 69 73 20 63 61 6c 6c 2c 20 74 68 65 20 72 this call, the r
1ed70 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 ollback journal
1ed80 73 74 69 6c 6c 20 65 78 69 73 74 73 20 6f 6e 20 still exists on
1ed90 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 20 the.** disk and
1eda0 77 65 20 61 72 65 20 73 74 69 6c 6c 20 68 6f 6c we are still hol
1edb0 64 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b 73 2c 20 ding all locks,
1edc0 73 6f 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 so the transacti
1edd0 6f 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 63 6f on has not.** co
1ede0 6d 6d 69 74 74 65 64 2e 20 20 53 65 65 20 73 71 mmitted. See sq
1edf0 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1ee00 50 68 61 73 65 54 77 6f 28 29 20 66 6f 72 20 74 PhaseTwo() for t
1ee10 68 65 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 he second phase
1ee20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 6d 6d 69 74 of the.** commit
1ee30 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 process..**.**
1ee40 54 68 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e This call is a n
1ee50 6f 2d 6f 70 20 69 66 20 6e 6f 20 77 72 69 74 65 o-op if no write
1ee60 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 -transaction is
1ee70 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 currently active
1ee80 20 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a 2a 20 4f on pBt..**.** O
1ee90 74 68 65 72 77 69 73 65 2c 20 73 79 6e 63 20 74 therwise, sync t
1eea0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1eeb0 20 66 6f 72 20 74 68 65 20 62 74 72 65 65 20 70 for the btree p
1eec0 42 74 2e 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e Bt. zMaster poin
1eed0 74 73 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 61 6d ts to.** the nam
1eee0 65 20 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f e of a master jo
1eef0 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 61 74 20 urnal file that
1ef00 73 68 6f 75 6c 64 20 62 65 20 77 72 69 74 74 65 should be writte
1ef10 6e 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 69 6e n into the.** in
1ef20 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c dividual journal
1ef30 20 66 69 6c 65 2c 20 6f 72 20 69 73 20 4e 55 4c file, or is NUL
1ef40 4c 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 6e 6f L, indicating no
1ef50 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
1ef60 66 69 6c 65 20 0a 2a 2a 20 28 73 69 6e 67 6c 65 file .** (single
1ef70 20 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 database transa
1ef80 63 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 ction)..**.** Wh
1ef90 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 en this is calle
1efa0 64 2c 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f d, the master jo
1efb0 75 72 6e 61 6c 20 73 68 6f 75 6c 64 20 61 6c 72 urnal should alr
1efc0 65 61 64 79 20 68 61 76 65 20 62 65 65 6e 0a 2a eady have been.*
1efd0 2a 20 63 72 65 61 74 65 64 2c 20 70 6f 70 75 6c * created, popul
1efe0 61 74 65 64 20 77 69 74 68 20 74 68 69 73 20 6a ated with this j
1eff0 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 61 ournal pointer a
1f000 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 nd synced to dis
1f010 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 k..**.** Once th
1f020 69 73 20 69 73 20 72 6f 75 74 69 6e 65 20 68 61 is is routine ha
1f030 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 20 s returned, the
1f040 6f 6e 6c 79 20 74 68 69 6e 67 20 72 65 71 75 69 only thing requi
1f050 72 65 64 20 74 6f 20 63 6f 6d 6d 69 74 0a 2a 2a red to commit.**
1f060 20 74 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 the write-trans
1f070 61 63 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 action for this
1f080 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 database file is
1f090 20 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6a to delete the j
1f0a0 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 ournal..*/.int s
1f0b0 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 qlite3BtreeCommi
1f0c0 74 50 68 61 73 65 4f 6e 65 28 42 74 72 65 65 20 tPhaseOne(Btree
1f0d0 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a *p, const char *
1f0e0 7a 4d 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 zMaster){. int
1f0f0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1f100 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1f110 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b ==TRANS_WRITE ){
1f120 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 . BtShared *p
1f130 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 Bt = p->pBt;.
1f140 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1f150 65 72 28 70 29 3b 0a 23 69 66 6e 64 65 66 20 53 er(p);.#ifndef S
1f160 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
1f170 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 ACUUM. if( pB
1f180 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b t->autoVacuum ){
1f190 0a 20 20 20 20 20 20 72 63 20 3d 20 61 75 74 6f . rc = auto
1f1a0 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 70 42 74 VacuumCommit(pBt
1f1b0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
1f1c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1f1d0 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1f1e0 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 eeLeave(p);.
1f1f0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1f200 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
1f210 20 69 66 28 20 70 42 74 2d 3e 62 44 6f 54 72 75 if( pBt->bDoTru
1f220 6e 63 61 74 65 20 29 7b 0a 20 20 20 20 20 20 73 ncate ){. s
1f230 71 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 qlite3PagerTrunc
1f240 61 74 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 50 ateImage(pBt->pP
1f250 61 67 65 72 2c 20 70 42 74 2d 3e 6e 50 61 67 65 ager, pBt->nPage
1f260 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a );. }.#endif.
1f270 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1f280 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 PagerCommitPhase
1f290 4f 6e 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c One(pBt->pPager,
1f2a0 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 zMaster, 0);.
1f2b0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
1f2c0 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 20 72 65 ave(p);. }. re
1f2d0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
1f2e0 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
1f2f0 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 62 is called from b
1f300 6f 74 68 20 42 74 72 65 65 43 6f 6d 6d 69 74 50 oth BtreeCommitP
1f310 68 61 73 65 54 77 6f 28 29 20 61 6e 64 20 42 74 haseTwo() and Bt
1f320 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 0a 2a 2a reeRollback().**
1f330 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 at the conclusi
1f340 6f 6e 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 on of a transact
1f350 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ion..*/.static v
1f360 6f 69 64 20 62 74 72 65 65 45 6e 64 54 72 61 6e oid btreeEndTran
1f370 73 61 63 74 69 6f 6e 28 42 74 72 65 65 20 2a 70 saction(Btree *p
1f380 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
1f390 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 Bt = p->pBt;. s
1f3a0 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e qlite3 *db = p->
1f3b0 64 62 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 db;. assert( sq
1f3c0 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d lite3BtreeHoldsM
1f3d0 75 74 65 78 28 70 29 20 29 3b 0a 0a 23 69 66 6e utex(p) );..#ifn
1f3e0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1f3f0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 70 42 74 AUTOVACUUM. pBt
1f400 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 ->bDoTruncate =
1f410 30 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 0;.#endif. if(
1f420 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 p->inTrans>TRANS
1f430 5f 4e 4f 4e 45 20 26 26 20 64 62 2d 3e 6e 56 64 _NONE && db->nVd
1f440 62 65 52 65 61 64 3e 31 20 29 7b 0a 20 20 20 20 beRead>1 ){.
1f450 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 /* If there are
1f460 6f 74 68 65 72 20 61 63 74 69 76 65 20 73 74 61 other active sta
1f470 74 65 6d 65 6e 74 73 20 74 68 61 74 20 62 65 6c tements that bel
1f480 6f 6e 67 20 74 6f 20 74 68 69 73 20 64 61 74 61 ong to this data
1f490 62 61 73 65 0a 20 20 20 20 2a 2a 20 68 61 6e 64 base. ** hand
1f4a0 6c 65 2c 20 64 6f 77 6e 67 72 61 64 65 20 74 6f le, downgrade to
1f4b0 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 a read-only tra
1f4c0 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 6f 74 nsaction. The ot
1f4d0 68 65 72 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 her statements.
1f4e0 20 20 20 2a 2a 20 6d 61 79 20 73 74 69 6c 6c 20 ** may still
1f4f0 62 65 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 be reading from
1f500 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 2a the database. *
1f510 2f 0a 20 20 20 20 64 6f 77 6e 67 72 61 64 65 41 /. downgradeA
1f520 6c 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 llSharedCacheTab
1f530 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 leLocks(p);.
1f540 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 p->inTrans = TRA
1f550 4e 53 5f 52 45 41 44 3b 0a 20 20 7d 65 6c 73 65 NS_READ;. }else
1f560 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 {. /* If the
1f570 68 61 6e 64 6c 65 20 68 61 64 20 61 6e 79 20 6b handle had any k
1f580 69 6e 64 20 6f 66 20 74 72 61 6e 73 61 63 74 69 ind of transacti
1f590 6f 6e 20 6f 70 65 6e 2c 20 64 65 63 72 65 6d 65 on open, decreme
1f5a0 6e 74 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 74 nt the . ** t
1f5b0 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 ransaction count
1f5c0 20 6f 66 20 74 68 65 20 73 68 61 72 65 64 20 62 of the shared b
1f5d0 74 72 65 65 2e 20 49 66 20 74 68 65 20 74 72 61 tree. If the tra
1f5e0 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 0a nsaction count .
1f5f0 20 20 20 20 2a 2a 20 72 65 61 63 68 65 73 20 30 ** reaches 0
1f600 2c 20 73 65 74 20 74 68 65 20 73 68 61 72 65 64 , set the shared
1f610 20 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f state to TRANS_
1f620 4e 4f 4e 45 2e 20 54 68 65 20 75 6e 6c 6f 63 6b NONE. The unlock
1f630 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 29 0a BtreeIfUnused().
1f640 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 65 6c 6f ** call belo
1f650 77 20 77 69 6c 6c 20 75 6e 6c 6f 63 6b 20 74 68 w will unlock th
1f660 65 20 70 61 67 65 72 2e 20 20 2a 2f 0a 20 20 20 e pager. */.
1f670 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 21 if( p->inTrans!
1f680 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 =TRANS_NONE ){.
1f690 20 20 20 20 20 63 6c 65 61 72 41 6c 6c 53 68 61 clearAllSha
1f6a0 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
1f6b0 6b 73 28 70 29 3b 0a 20 20 20 20 20 20 70 42 74 ks(p);. pBt
1f6c0 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 2d 2d ->nTransaction--
1f6d0 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 70 ;. if( 0==p
1f6e0 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e Bt->nTransaction
1f6f0 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ){. pBt-
1f700 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d >inTransaction =
1f710 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 TRANS_NONE;.
1f720 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 }. }..
1f730 2f 2a 20 53 65 74 20 74 68 65 20 63 75 72 72 65 /* Set the curre
1f740 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 nt transaction s
1f750 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f tate to TRANS_NO
1f760 4e 45 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 NE and unlock th
1f770 65 20 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 e . ** pager
1f780 69 66 20 74 68 69 73 20 63 61 6c 6c 20 63 6c 6f if this call clo
1f790 73 65 64 20 74 68 65 20 6f 6e 6c 79 20 72 65 61 sed the only rea
1f7a0 64 20 6f 72 20 77 72 69 74 65 20 74 72 61 6e 73 d or write trans
1f7b0 61 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 action. */.
1f7c0 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 p->inTrans = TRA
1f7d0 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 75 6e 6c NS_NONE;. unl
1f7e0 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1f7f0 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 (pBt);. }.. bt
1f800 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b reeIntegrity(p);
1f810 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 .}../*.** Commit
1f820 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
1f830 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 70 72 currently in pr
1f840 6f 67 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 ogress..**.** Th
1f850 69 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 is routine imple
1f860 6d 65 6e 74 73 20 74 68 65 20 73 65 63 6f 6e 64 ments the second
1f870 20 70 68 61 73 65 20 6f 66 20 61 20 32 2d 70 68 phase of a 2-ph
1f880 61 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 65 ase commit. The
1f890 0a 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 .** sqlite3Btree
1f8a0 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 CommitPhaseOne()
1f8b0 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 routine does th
1f8c0 65 20 66 69 72 73 74 20 70 68 61 73 65 20 61 6e e first phase an
1f8d0 64 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 65 20 69 d should.** be i
1f8e0 6e 76 6f 6b 65 64 20 70 72 69 6f 72 20 74 6f 20 nvoked prior to
1f8f0 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 calling this rou
1f900 74 69 6e 65 2e 20 20 54 68 65 20 73 71 6c 69 74 tine. The sqlit
1f910 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 e3BtreeCommitPha
1f920 73 65 4f 6e 65 28 29 0a 2a 2a 20 72 6f 75 74 69 seOne().** routi
1f930 6e 65 20 64 69 64 20 61 6c 6c 20 74 68 65 20 77 ne did all the w
1f940 6f 72 6b 20 6f 66 20 77 72 69 74 69 6e 67 20 69 ork of writing i
1f950 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 74 20 74 nformation out t
1f960 6f 20 64 69 73 6b 20 61 6e 64 20 66 6c 75 73 68 o disk and flush
1f970 69 6e 67 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 ing the.** conte
1f980 6e 74 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 nts so that they
1f990 20 61 72 65 20 77 72 69 74 74 65 6e 20 6f 6e 74 are written ont
1f9a0 6f 20 74 68 65 20 64 69 73 6b 20 70 6c 61 74 74 o the disk platt
1f9b0 65 72 2e 20 20 41 6c 6c 20 74 68 69 73 0a 2a 2a er. All this.**
1f9c0 20 72 6f 75 74 69 6e 65 20 68 61 73 20 74 6f 20 routine has to
1f9d0 64 6f 20 69 73 20 64 65 6c 65 74 65 20 6f 72 20 do is delete or
1f9e0 74 72 75 6e 63 61 74 65 20 6f 72 20 7a 65 72 6f truncate or zero
1f9f0 20 74 68 65 20 68 65 61 64 65 72 20 69 6e 20 74 the header in t
1fa00 68 65 0a 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 61 he.** the rollba
1fa10 63 6b 20 6a 6f 75 72 6e 61 6c 20 28 77 68 69 63 ck journal (whic
1fa20 68 20 63 61 75 73 65 73 20 74 68 65 20 74 72 61 h causes the tra
1fa30 6e 73 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d nsaction to comm
1fa40 69 74 29 20 61 6e 64 0a 2a 2a 20 64 72 6f 70 20 it) and.** drop
1fa50 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 locks..**.** Nor
1fa60 6d 61 6c 6c 79 2c 20 69 66 20 61 6e 20 65 72 72 mally, if an err
1fa70 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 or occurs while
1fa80 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 20 the pager layer
1fa90 69 73 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f is attempting to
1faa0 20 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 20 74 68 .** finalize th
1fab0 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6a 6f 75 e underlying jou
1fac0 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 69 73 20 rnal file, this
1fad0 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
1fae0 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 0a 2a 2a an error and.**
1faf0 20 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 the upper layer
1fb00 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 61 20 will attempt a
1fb10 72 6f 6c 6c 62 61 63 6b 2e 20 48 6f 77 65 76 65 rollback. Howeve
1fb20 72 2c 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 r, if the second
1fb30 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 69 73 20 argument.** is
1fb40 6e 6f 6e 2d 7a 65 72 6f 20 74 68 65 6e 20 74 68 non-zero then th
1fb50 69 73 20 62 2d 74 72 65 65 20 74 72 61 6e 73 61 is b-tree transa
1fb60 63 74 69 6f 6e 20 69 73 20 70 61 72 74 20 6f 66 ction is part of
1fb70 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 0a 2a a multi-file .*
1fb80 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 * transaction. I
1fb90 6e 20 74 68 69 73 20 63 61 73 65 2c 20 74 68 65 n this case, the
1fba0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 transaction has
1fbb0 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 6f already been co
1fbc0 6d 6d 69 74 74 65 64 20 0a 2a 2a 20 28 62 79 20 mmitted .** (by
1fbd0 64 65 6c 65 74 69 6e 67 20 61 20 6d 61 73 74 65 deleting a maste
1fbe0 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 r journal file)
1fbf0 61 6e 64 20 74 68 65 20 63 61 6c 6c 65 72 20 77 and the caller w
1fc00 69 6c 6c 20 69 67 6e 6f 72 65 20 74 68 69 73 20 ill ignore this
1fc10 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 .** functions re
1fc20 74 75 72 6e 20 63 6f 64 65 2e 20 53 6f 2c 20 65 turn code. So, e
1fc30 76 65 6e 20 69 66 20 61 6e 20 65 72 72 6f 72 20 ven if an error
1fc40 6f 63 63 75 72 73 20 69 6e 20 74 68 65 20 70 61 occurs in the pa
1fc50 67 65 72 20 6c 61 79 65 72 2c 0a 2a 2a 20 72 65 ger layer,.** re
1fc60 73 65 74 20 74 68 65 20 62 2d 74 72 65 65 20 6f set the b-tree o
1fc70 62 6a 65 63 74 73 20 69 6e 74 65 72 6e 61 6c 20 bjects internal
1fc80 73 74 61 74 65 20 74 6f 20 69 6e 64 69 63 61 74 state to indicat
1fc90 65 20 74 68 61 74 20 74 68 65 20 77 72 69 74 65 e that the write
1fca0 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 .** transaction
1fcb0 68 61 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 2e has been closed.
1fcc0 20 54 68 69 73 20 69 73 20 71 75 69 74 65 20 73 This is quite s
1fcd0 61 66 65 2c 20 61 73 20 74 68 65 20 70 61 67 65 afe, as the page
1fce0 72 20 77 69 6c 6c 20 68 61 76 65 0a 2a 2a 20 74 r will have.** t
1fcf0 72 61 6e 73 69 74 69 6f 6e 65 64 20 74 6f 20 74 ransitioned to t
1fd00 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 2e 0a he error state..
1fd10 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c 20 **.** This will
1fd20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 74 release the writ
1fd30 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 e lock on the da
1fd40 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
1fd50 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f there.** are no
1fd60 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 2c active cursors,
1fd70 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 65 it also release
1fd80 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e s the read lock.
1fd90 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
1fda0 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 treeCommitPhaseT
1fdb0 77 6f 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 wo(Btree *p, int
1fdc0 20 62 43 6c 65 61 6e 75 70 29 7b 0a 0a 20 20 69 bCleanup){.. i
1fdd0 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
1fde0 52 41 4e 53 5f 4e 4f 4e 45 20 29 20 72 65 74 75 RANS_NONE ) retu
1fdf0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
1fe00 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
1fe10 72 28 70 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 r(p);. btreeInt
1fe20 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a egrity(p);.. /*
1fe30 20 49 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 If the handle h
1fe40 61 73 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 as a write-trans
1fe50 61 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 63 6f 6d action open, com
1fe60 6d 69 74 20 74 68 65 20 73 68 61 72 65 64 2d 62 mit the shared-b
1fe70 74 72 65 65 73 20 0a 20 20 2a 2a 20 74 72 61 6e trees . ** tran
1fe80 73 61 63 74 69 6f 6e 20 61 6e 64 20 73 65 74 20 saction and set
1fe90 74 68 65 20 73 68 61 72 65 64 20 73 74 61 74 65 the shared state
1fea0 20 74 6f 20 54 52 41 4e 53 5f 52 45 41 44 2e 0a to TRANS_READ..
1feb0 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e */. if( p->in
1fec0 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 Trans==TRANS_WRI
1fed0 54 45 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 TE ){. int rc
1fee0 3b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a ;. BtShared *
1fef0 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
1ff00 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 assert( pBt->i
1ff10 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 nTransaction==TR
1ff20 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 20 ANS_WRITE );.
1ff30 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 54 assert( pBt->nT
1ff40 72 61 6e 73 61 63 74 69 6f 6e 3e 30 20 29 3b 0a ransaction>0 );.
1ff50 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1ff60 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 PagerCommitPhase
1ff70 54 77 6f 28 70 42 74 2d 3e 70 50 61 67 65 72 29 Two(pBt->pPager)
1ff80 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
1ff90 4c 49 54 45 5f 4f 4b 20 26 26 20 62 43 6c 65 61 LITE_OK && bClea
1ffa0 6e 75 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 nup==0 ){.
1ffb0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1ffc0 65 28 70 29 3b 0a 20 20 20 20 20 20 72 65 74 75 e(p);. retu
1ffd0 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
1ffe0 20 70 2d 3e 69 44 61 74 61 56 65 72 73 69 6f 6e p->iDataVersion
1fff0 2d 2d 3b 20 20 2f 2a 20 43 6f 6d 70 65 6e 73 61 --; /* Compensa
20000 74 65 20 66 6f 72 20 70 50 61 67 65 72 2d 3e 69 te for pPager->i
20010 44 61 74 61 56 65 72 73 69 6f 6e 2b 2b 3b 20 2a DataVersion++; *
20020 2f 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 /. pBt->inTra
20030 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 nsaction = TRANS
20040 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 _READ;. btree
20050 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
20060 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 pBt);. }.. btr
20070 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e eeEndTransaction
20080 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 (p);. sqlite3Bt
20090 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
200a0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
200b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 6f 74 .}../*.** Do bot
200c0 68 20 70 68 61 73 65 73 20 6f 66 20 61 20 63 6f h phases of a co
200d0 6d 6d 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c mmit..*/.int sql
200e0 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 ite3BtreeCommit(
200f0 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 Btree *p){. int
20100 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 rc;. sqlite3Bt
20110 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 reeEnter(p);. r
20120 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
20130 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 CommitPhaseOne(p
20140 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d , 0);. if( rc==
20150 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
20160 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 rc = sqlite3Btr
20170 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f eeCommitPhaseTwo
20180 28 70 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 (p, 0);. }. sq
20190 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
201a0 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
201b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 .}../*.** This r
201c0 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 outine sets the
201d0 73 74 61 74 65 20 74 6f 20 43 55 52 53 4f 52 5f state to CURSOR_
201e0 46 41 55 4c 54 20 61 6e 64 20 74 68 65 20 65 72 FAULT and the er
201f0 72 6f 72 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 65 ror.** code to e
20200 72 72 43 6f 64 65 20 66 6f 72 20 65 76 65 72 79 rrCode for every
20210 20 63 75 72 73 6f 72 20 6f 6e 20 61 6e 79 20 42 cursor on any B
20220 74 53 68 61 72 65 64 20 74 68 61 74 20 70 42 74 tShared that pBt
20230 72 65 65 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 ree.** reference
20240 73 2e 20 20 4f 72 20 69 66 20 74 68 65 20 77 72 s. Or if the wr
20250 69 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 iteOnly flag is
20260 73 65 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 6f set to 1, then o
20270 6e 6c 79 0a 2a 2a 20 74 72 69 70 20 77 72 69 74 nly.** trip writ
20280 65 20 63 75 72 73 6f 72 73 20 61 6e 64 20 6c 65 e cursors and le
20290 61 76 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 ave read cursors
202a0 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a unchanged..**.*
202b0 2a 20 45 76 65 72 79 20 63 75 72 73 6f 72 20 69 * Every cursor i
202c0 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 74 6f s a candidate to
202d0 20 62 65 20 74 72 69 70 70 65 64 2c 20 69 6e 63 be tripped, inc
202e0 6c 75 64 69 6e 67 20 63 75 72 73 6f 72 73 0a 2a luding cursors.*
202f0 2a 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f * that belong to
20300 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 other database
20310 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 68 61 74 connections that
20320 20 68 61 70 70 65 6e 20 74 6f 20 62 65 0a 2a 2a happen to be.**
20330 20 73 68 61 72 69 6e 67 20 74 68 65 20 63 61 63 sharing the cac
20340 68 65 20 77 69 74 68 20 70 42 74 72 65 65 2e 0a he with pBtree..
20350 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
20360 6e 65 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77 ne gets called w
20370 68 65 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f hen a rollback o
20380 63 63 75 72 73 2e 20 49 66 20 74 68 65 20 77 72 ccurs. If the wr
20390 69 74 65 4f 6e 6c 79 0a 2a 2a 20 66 6c 61 67 20 iteOnly.** flag
203a0 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e is true, then on
203b0 6c 79 20 77 72 69 74 65 2d 63 75 72 73 6f 72 73 ly write-cursors
203c0 20 6e 65 65 64 20 62 65 20 74 72 69 70 70 65 64 need be tripped
203d0 20 2d 20 72 65 61 64 2d 6f 6e 6c 79 0a 2a 2a 20 - read-only.**
203e0 63 75 72 73 6f 72 73 20 73 61 76 65 20 74 68 65 cursors save the
203f0 69 72 20 63 75 72 72 65 6e 74 20 70 6f 73 69 74 ir current posit
20400 69 6f 6e 73 20 73 6f 20 74 68 61 74 20 74 68 65 ions so that the
20410 79 20 6d 61 79 20 63 6f 6e 74 69 6e 75 65 20 0a y may continue .
20420 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 ** following the
20430 20 72 6f 6c 6c 62 61 63 6b 2e 20 4f 72 2c 20 69 rollback. Or, i
20440 66 20 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 66 f writeOnly is f
20450 61 6c 73 65 2c 20 61 6c 6c 20 63 75 72 73 6f 72 alse, all cursor
20460 73 20 61 72 65 20 0a 2a 2a 20 74 72 69 70 70 65 s are .** trippe
20470 64 2e 20 49 6e 20 67 65 6e 65 72 61 6c 2c 20 77 d. In general, w
20480 72 69 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 riteOnly is fals
20490 65 20 69 66 20 74 68 65 20 74 72 61 6e 73 61 63 e if the transac
204a0 74 69 6f 6e 20 62 65 69 6e 67 0a 2a 2a 20 72 6f tion being.** ro
204b0 6c 6c 65 64 20 62 61 63 6b 20 6d 6f 64 69 66 69 lled back modifi
204c0 65 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ed the database
204d0 73 63 68 65 6d 61 2e 20 49 6e 20 74 68 69 73 20 schema. In this
204e0 63 61 73 65 20 62 2d 74 72 65 65 20 72 6f 6f 74 case b-tree root
204f0 0a 2a 2a 20 70 61 67 65 73 20 6d 61 79 20 62 65 .** pages may be
20500 20 6d 6f 76 65 64 20 6f 72 20 64 65 6c 65 74 65 moved or delete
20510 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 d from the datab
20520 61 73 65 20 61 6c 74 6f 67 65 74 68 65 72 2c 20 ase altogether,
20530 6d 61 6b 69 6e 67 0a 2a 2a 20 69 74 20 75 6e 73 making.** it uns
20540 61 66 65 20 66 6f 72 20 72 65 61 64 20 63 75 72 afe for read cur
20550 73 6f 72 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 sors to continue
20560 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 77 ..**.** If the w
20570 72 69 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 riteOnly flag is
20580 20 74 72 75 65 20 61 6e 64 20 61 6e 20 65 72 72 true and an err
20590 6f 72 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 or is encountere
205a0 64 20 77 68 69 6c 65 20 0a 2a 2a 20 73 61 76 69 d while .** savi
205b0 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 ng the current p
205c0 6f 73 69 74 69 6f 6e 20 6f 66 20 61 20 72 65 61 osition of a rea
205d0 64 2d 6f 6e 6c 79 20 63 75 72 73 6f 72 2c 20 61 d-only cursor, a
205e0 6c 6c 20 63 75 72 73 6f 72 73 2c 20 0a 2a 2a 20 ll cursors, .**
205f0 69 6e 63 6c 75 64 69 6e 67 20 61 6c 6c 20 72 65 including all re
20600 61 64 2d 63 75 72 73 6f 72 73 20 61 72 65 20 74 ad-cursors are t
20610 72 69 70 70 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 ripped..**.** SQ
20620 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 LITE_OK is retur
20630 6e 65 64 20 69 66 20 73 75 63 63 65 73 73 66 75 ned if successfu
20640 6c 2c 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f l, or if an erro
20650 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 0a 2a r occurs while.*
20660 2a 20 73 61 76 69 6e 67 20 61 20 63 75 72 73 6f * saving a curso
20670 72 20 70 6f 73 69 74 69 6f 6e 2c 20 61 6e 20 53 r position, an S
20680 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 QLite error code
20690 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
206a0 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 BtreeTripAllCurs
206b0 6f 72 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 ors(Btree *pBtre
206c0 65 2c 20 69 6e 74 20 65 72 72 43 6f 64 65 2c 20 e, int errCode,
206d0 69 6e 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b 0a int writeOnly){.
206e0 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 BtCursor *p;.
206f0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
20700 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 _OK;.. assert(
20710 28 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 7c 7c (writeOnly==0 ||
20720 20 77 72 69 74 65 4f 6e 6c 79 3d 3d 31 29 20 26 writeOnly==1) &
20730 26 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 67 & BTCF_WriteFlag
20740 3d 3d 31 20 29 3b 0a 20 20 69 66 28 20 70 42 74 ==1 );. if( pBt
20750 72 65 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ree ){. sqlit
20760 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 e3BtreeEnter(pBt
20770 72 65 65 29 3b 0a 20 20 20 20 66 6f 72 28 70 3d ree);. for(p=
20780 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 pBtree->pBt->pCu
20790 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e rsor; p; p=p->pN
207a0 65 78 74 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 ext){. int
207b0 69 3b 0a 20 20 20 20 20 20 69 66 28 20 77 72 69 i;. if( wri
207c0 74 65 4f 6e 6c 79 20 26 26 20 28 70 2d 3e 63 75 teOnly && (p->cu
207d0 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 57 72 rFlags & BTCF_Wr
207e0 69 74 65 46 6c 61 67 29 3d 3d 30 20 29 7b 0a 20 iteFlag)==0 ){.
207f0 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 53 if( p->eS
20800 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
20810 49 44 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d ID || p->eState=
20820 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 =CURSOR_SKIPNEXT
20830 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
20840 20 3d 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 = saveCursorPos
20850 69 74 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 20 ition(p);.
20860 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
20870 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
20880 20 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 (void)sqlit
20890 65 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 e3BtreeTripAllCu
208a0 72 73 6f 72 73 28 70 42 74 72 65 65 2c 20 72 63 rsors(pBtree, rc
208b0 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 0);.
208c0 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
208d0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
208e0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
208f0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
20900 43 6c 65 61 72 43 75 72 73 6f 72 28 70 29 3b 0a ClearCursor(p);.
20910 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 p->eStat
20920 65 20 3d 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 e = CURSOR_FAULT
20930 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 73 6b 69 ;. p->ski
20940 70 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b pNext = errCode;
20950 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 . }. f
20960 6f 72 28 69 3d 30 3b 20 69 3c 3d 70 2d 3e 69 50 or(i=0; i<=p->iP
20970 61 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 age; i++){.
20980 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
20990 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 ->apPage[i]);.
209a0 20 20 20 20 20 20 70 2d 3e 61 70 50 61 67 65 5b p->apPage[
209b0 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a i] = 0;. }.
209c0 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
209d0 33 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 3BtreeLeave(pBtr
209e0 65 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ee);. }. retur
209f0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
20a00 6f 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e ollback the tran
20a10 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 saction in progr
20a20 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 72 ess..**.** If tr
20a30 69 70 43 6f 64 65 20 69 73 20 6e 6f 74 20 53 51 ipCode is not SQ
20a40 4c 49 54 45 5f 4f 4b 20 74 68 65 6e 20 63 75 72 LITE_OK then cur
20a50 73 6f 72 73 20 77 69 6c 6c 20 62 65 20 69 6e 76 sors will be inv
20a60 61 6c 69 64 61 74 65 64 20 28 74 72 69 70 70 65 alidated (trippe
20a70 64 29 2e 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 d)..** Only writ
20a80 65 20 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 e cursors are tr
20a90 69 70 70 65 64 20 69 66 20 77 72 69 74 65 4f 6e ipped if writeOn
20aa0 6c 79 20 69 73 20 74 72 75 65 20 62 75 74 20 61 ly is true but a
20ab0 6c 6c 20 63 75 72 73 6f 72 73 20 61 72 65 0a 2a ll cursors are.*
20ac0 2a 20 74 72 69 70 70 65 64 20 69 66 20 77 72 69 * tripped if wri
20ad0 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 2e teOnly is false.
20ae0 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f Any attempt to
20af0 20 75 73 65 0a 2a 2a 20 61 20 74 72 69 70 70 65 use.** a trippe
20b00 64 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 72 65 d cursor will re
20b10 73 75 6c 74 20 69 6e 20 61 6e 20 65 72 72 6f 72 sult in an error
20b20 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c ..**.** This wil
20b30 6c 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 l release the wr
20b40 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ite lock on the
20b50 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
20b60 49 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 If there.** are
20b70 6e 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 no active cursor
20b80 73 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 s, it also relea
20b90 73 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 ses the read loc
20ba0 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 k..*/.int sqlite
20bb0 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 3BtreeRollback(B
20bc0 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 tree *p, int tri
20bd0 70 43 6f 64 65 2c 20 69 6e 74 20 77 72 69 74 65 pCode, int write
20be0 4f 6e 6c 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b Only){. int rc;
20bf0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
20c00 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d = p->pBt;. Mem
20c10 50 61 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 Page *pPage1;..
20c20 20 61 73 73 65 72 74 28 20 77 72 69 74 65 4f 6e assert( writeOn
20c30 6c 79 3d 3d 31 20 7c 7c 20 77 72 69 74 65 4f 6e ly==1 || writeOn
20c40 6c 79 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ly==0 );. asser
20c50 74 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c t( tripCode==SQL
20c60 49 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 ITE_ABORT_ROLLBA
20c70 43 4b 20 7c 7c 20 74 72 69 70 43 6f 64 65 3d 3d CK || tripCode==
20c80 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 73 SQLITE_OK );. s
20c90 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
20ca0 28 70 29 3b 0a 20 20 69 66 28 20 74 72 69 70 43 (p);. if( tripC
20cb0 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 ode==SQLITE_OK )
20cc0 7b 0a 20 20 20 20 72 63 20 3d 20 74 72 69 70 43 {. rc = tripC
20cd0 6f 64 65 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 ode = saveAllCur
20ce0 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b sors(pBt, 0, 0);
20cf0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 77 72 . if( rc ) wr
20d00 69 74 65 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d iteOnly = 0;. }
20d10 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 else{. rc = S
20d20 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 QLITE_OK;. }.
20d30 69 66 28 20 74 72 69 70 43 6f 64 65 20 29 7b 0a if( tripCode ){.
20d40 20 20 20 20 69 6e 74 20 72 63 32 20 3d 20 73 71 int rc2 = sq
20d50 6c 69 74 65 33 42 74 72 65 65 54 72 69 70 41 6c lite3BtreeTripAl
20d60 6c 43 75 72 73 6f 72 73 28 70 2c 20 74 72 69 70 lCursors(p, trip
20d70 43 6f 64 65 2c 20 77 72 69 74 65 4f 6e 6c 79 29 Code, writeOnly)
20d80 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 ;. assert( rc
20d90 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 ==SQLITE_OK || (
20da0 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 26 26 20 writeOnly==0 &&
20db0 72 63 32 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 rc2==SQLITE_OK)
20dc0 29 3b 0a 20 20 20 20 69 66 28 20 72 63 32 21 3d );. if( rc2!=
20dd0 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d SQLITE_OK ) rc =
20de0 20 72 63 32 3b 0a 20 20 7d 0a 20 20 62 74 72 65 rc2;. }. btre
20df0 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a eIntegrity(p);..
20e00 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
20e10 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b ==TRANS_WRITE ){
20e20 0a 20 20 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 . int rc2;..
20e30 20 20 20 61 73 73 65 72 74 28 20 54 52 41 4e 53 assert( TRANS
20e40 5f 57 52 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 _WRITE==pBt->inT
20e50 72 61 6e 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 ransaction );.
20e60 20 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 50 rc2 = sqlite3P
20e70 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 agerRollback(pBt
20e80 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 ->pPager);. i
20e90 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f f( rc2!=SQLITE_O
20ea0 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 K ){. rc =
20eb0 72 63 32 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 rc2;. }..
20ec0 2f 2a 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 /* The rollback
20ed0 6d 61 79 20 68 61 76 65 20 64 65 73 74 72 6f 79 may have destroy
20ee0 65 64 20 74 68 65 20 70 50 61 67 65 31 2d 3e 61 ed the pPage1->a
20ef0 44 61 74 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a Data value. So.
20f00 20 20 20 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 ** call btre
20f10 65 47 65 74 50 61 67 65 28 29 20 6f 6e 20 70 61 eGetPage() on pa
20f20 67 65 20 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 ge 1 again to ma
20f30 6b 65 0a 20 20 20 20 2a 2a 20 73 75 72 65 20 70 ke. ** sure p
20f40 50 61 67 65 31 2d 3e 61 44 61 74 61 20 69 73 20 Page1->aData is
20f50 73 65 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a set correctly. *
20f60 2f 0a 20 20 20 20 69 66 28 20 62 74 72 65 65 47 /. if( btreeG
20f70 65 74 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 etPage(pBt, 1, &
20f80 70 50 61 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 pPage1, 0)==SQLI
20f90 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
20fa0 6e 74 20 6e 50 61 67 65 20 3d 20 67 65 74 34 62 nt nPage = get4b
20fb0 79 74 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 yte(28+(u8*)pPag
20fc0 65 31 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 e1->aData);.
20fd0 20 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 67 testcase( nPag
20fe0 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 e==0 );. if
20ff0 28 20 6e 50 61 67 65 3d 3d 30 20 29 20 73 71 6c ( nPage==0 ) sql
21000 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 ite3PagerPagecou
21010 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 nt(pBt->pPager,
21020 26 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 74 &nPage);. t
21030 65 73 74 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 estcase( pBt->nP
21040 61 67 65 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 age!=nPage );.
21050 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d pBt->nPage =
21060 20 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 72 65 nPage;. re
21070 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 31 leasePage(pPage1
21080 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 );. }. ass
21090 65 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 ert( countValidC
210a0 75 72 73 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d ursors(pBt, 1)==
210b0 30 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 0 );. pBt->in
210c0 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 Transaction = TR
210d0 41 4e 53 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 ANS_READ;. bt
210e0 72 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 reeClearHasConte
210f0 6e 74 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 nt(pBt);. }..
21100 62 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 btreeEndTransact
21110 69 6f 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 ion(p);. sqlite
21120 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
21130 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
21140 2f 2a 0a 2a 2a 20 53 74 61 72 74 20 61 20 73 74 /*.** Start a st
21150 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
21160 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 action. The subt
21170 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 ransaction can b
21180 65 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b e rolled.** back
21190 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f independently o
211a0 66 20 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 f the main trans
211b0 61 63 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 action. You must
211c0 20 73 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 start a transac
211d0 74 69 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 tion .** before
211e0 73 74 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 starting a subtr
211f0 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 ansaction. The s
21200 75 62 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 ubtransaction is
21210 20 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 ended automatic
21220 61 6c 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 ally .** if the
21230 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e main transaction
21240 20 63 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c commits or roll
21250 73 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 s back..**.** St
21260 61 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 atement subtrans
21270 61 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 actions are used
21280 20 61 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 around individu
21290 61 6c 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 al SQL statement
212a0 73 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f s.** that are co
212b0 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 ntained within a
212c0 20 42 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 BEGIN...COMMIT
212d0 62 6c 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e block. If a con
212e0 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 straint.** error
212f0 20 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 occurs within t
21300 68 65 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 he statement, th
21310 65 20 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 e effect of that
21320 20 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a one statement.*
21330 2a 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 * can be rolled
21340 62 61 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 back without hav
21350 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 ing to rollback
21360 74 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 the entire trans
21370 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 action..**.** A
21380 73 74 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 statement sub-tr
21390 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 ansaction is imp
213a0 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 lemented as an a
213b0 6e 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 nonymous savepoi
213c0 6e 74 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 nt. The.** value
213d0 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 passed as the s
213e0 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 econd parameter
213f0 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d is the total num
21400 62 65 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 ber of savepoint
21410 73 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 s,.** including
21420 74 68 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 the new anonymou
21430 73 20 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 s savepoint, ope
21440 6e 20 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e n on the B-Tree.
21450 20 69 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a i.e. if there.*
21460 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 * are no active
21470 73 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e savepoints and n
21480 6f 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e o other statemen
21490 74 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f t-transactions o
214a0 70 65 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 pen,.** iStateme
214b0 6e 74 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e nt is 1. This an
214c0 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e onymous savepoin
214d0 74 20 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 t can be release
214e0 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b d or rolled back
214f0 0a 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 .** using the sq
21500 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
21510 69 6e 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a int() function..
21520 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
21530 72 65 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 reeBeginStmt(Btr
21540 65 65 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 ee *p, int iStat
21550 65 6d 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 ement){. int rc
21560 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
21570 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 t = p->pBt;. sq
21580 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
21590 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d p);. assert( p-
215a0 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
215b0 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 WRITE );. asser
215c0 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 t( (pBt->btsFlag
215d0 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
215e0 59 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 Y)==0 );. asser
215f0 74 28 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 t( iStatement>0
21600 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 );. assert( iSt
21610 61 74 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e atement>p->db->n
21620 53 61 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 Savepoint );. a
21630 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 ssert( pBt->inTr
21640 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
21650 5f 57 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 _WRITE );. /* A
21660 74 20 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 t the pager leve
21670 6c 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 l, a statement t
21680 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 ransaction is a
21690 73 61 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 savepoint with.
216a0 20 2a 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 ** an index gre
216b0 61 74 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 ater than all sa
216c0 76 65 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 vepoints created
216d0 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e explicitly usin
216e0 67 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 g. ** SQL state
216f0 6d 65 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c ments. It is ill
21700 65 67 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 egal to open, re
21710 6c 65 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 lease or rollbac
21720 6b 20 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 k any. ** such
21730 73 61 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 savepoints while
21740 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 the statement t
21750 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 ransaction savep
21760 6f 69 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a oint is active..
21770 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
21780 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 te3PagerOpenSave
21790 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 point(pBt->pPage
217a0 72 2c 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a r, iStatement);.
217b0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
217c0 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
217d0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
217e0 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
217f0 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 t to this functi
21800 6f 6e 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 on, op, is alway
21810 73 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c s SAVEPOINT_ROLL
21820 42 41 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 BACK.** or SAVEP
21830 4f 49 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 OINT_RELEASE. Th
21840 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 is function eith
21850 65 72 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 er releases or r
21860 6f 6c 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a olls back the.**
21870 20 73 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 savepoint ident
21880 69 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 ified by paramet
21890 65 72 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 er iSavepoint, d
218a0 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 epending on the
218b0 76 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e value .** of op.
218c0 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c .**.** Normally,
218d0 20 69 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 iSavepoint is g
218e0 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 reater than or e
218f0 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f qual to zero. Ho
21900 77 65 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a wever, if op is.
21910 2a 2a 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c ** SAVEPOINT_ROL
21920 4c 42 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 LBACK, then iSav
21930 65 70 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 epoint may also
21940 62 65 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 be -1. In this c
21950 61 73 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 ase the .** cont
21960 65 6e 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 ents of the enti
21970 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 re transaction a
21980 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 re rolled back.
21990 54 68 69 73 20 69 73 20 64 69 66 66 65 72 65 6e This is differen
219a0 74 0a 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d t.** from a norm
219b0 61 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 al transaction r
219c0 6f 6c 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c ollback, as no l
219d0 6f 63 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 ocks are release
219e0 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 d and the.** tra
219f0 6e 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 nsaction remains
21a00 20 6f 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 open..*/.int sq
21a10 6c 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f lite3BtreeSavepo
21a20 69 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e int(Btree *p, in
21a30 74 20 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 t op, int iSavep
21a40 6f 69 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 oint){. int rc
21a50 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
21a60 66 28 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 f( p && p->inTra
21a70 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 ns==TRANS_WRITE
21a80 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 ){. BtShared
21a90 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
21aa0 20 20 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 assert( op==S
21ab0 41 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 AVEPOINT_RELEASE
21ac0 20 7c 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e || op==SAVEPOIN
21ad0 54 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 T_ROLLBACK );.
21ae0 20 20 61 73 73 65 72 74 28 20 69 53 61 76 65 70 assert( iSavep
21af0 6f 69 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 oint>=0 || (iSav
21b00 65 70 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 epoint==-1 && op
21b10 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c ==SAVEPOINT_ROLL
21b20 42 41 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c BACK) );. sql
21b30 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
21b40 29 3b 0a 20 20 20 20 69 66 28 20 6f 70 3d 3d 53 );. if( op==S
21b50 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
21b60 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 K ){. rc =
21b70 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 saveAllCursors(p
21b80 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d Bt, 0, 0);. }
21b90 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
21ba0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
21bb0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
21bc0 72 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e rSavepoint(pBt->
21bd0 70 50 61 67 65 72 2c 20 6f 70 2c 20 69 53 61 76 pPager, op, iSav
21be0 65 70 6f 69 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 epoint);. }.
21bf0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
21c00 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 E_OK ){. if
21c10 28 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 ( iSavepoint<0 &
21c20 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 & (pBt->btsFlags
21c30 20 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 & BTS_INITIALLY
21c40 5f 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 _EMPTY)!=0 ){.
21c50 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 pBt->nPage
21c60 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 0;. }.
21c70 20 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 rc = newData
21c80 62 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 base(pBt);.
21c90 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 pBt->nPage = ge
21ca0 74 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 2d t4byte(28 + pBt-
21cb0 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b >pPage1->aData);
21cc0 0a 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 .. /* The d
21cd0 61 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 atabase size was
21ce0 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 written into th
21cf0 65 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 74 e offset 28 of t
21d00 68 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 20 he header.
21d10 2a 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e ** when the tran
21d20 73 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 2c saction started,
21d30 20 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 so we know that
21d40 20 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f 66 the value at of
21d50 66 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 fset. ** 28
21d60 20 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a is nonzero. */.
21d70 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 assert( pB
21d80 74 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 t->nPage>0 );.
21d90 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 }. sqlite3B
21da0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
21db0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
21dc0 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 ../*.** Create a
21dd0 20 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 20 new cursor for
21de0 74 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 20 the BTree whose
21df0 72 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 70 root is on the p
21e00 61 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 age.** iTable. I
21e10 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 f a read-only cu
21e20 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 rsor is requeste
21e30 64 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 64 d, it is assumed
21e40 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c that.** the cal
21e50 6c 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 20 ler already has
21e60 61 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 2d at least a read-
21e70 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e only transaction
21e80 20 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 open.** on the
21e90 64 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 79 database already
21ea0 2e 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 72 . If a write-cur
21eb0 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 sor is requested
21ec0 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 , then.** the ca
21ed0 6c 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 20 ller is assumed
21ee0 74 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 to have an open
21ef0 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
21f00 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 n..**.** If the
21f10 42 54 52 45 45 5f 57 52 43 53 52 20 62 69 74 20 BTREE_WRCSR bit
21f20 6f 66 20 77 72 46 6c 61 67 20 69 73 20 63 6c 65 of wrFlag is cle
21f30 61 72 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 ar, then the cur
21f40 73 6f 72 20 63 61 6e 20 6f 6e 6c 79 0a 2a 2a 20 sor can only.**
21f50 62 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 64 be used for read
21f60 69 6e 67 2e 20 20 49 66 20 74 68 65 20 42 54 52 ing. If the BTR
21f70 45 45 5f 57 52 43 53 52 20 62 69 74 20 69 73 20 EE_WRCSR bit is
21f80 73 65 74 2c 20 74 68 65 6e 20 74 68 65 20 63 75 set, then the cu
21f90 72 73 6f 72 0a 2a 2a 20 63 61 6e 20 62 65 20 75 rsor.** can be u
21fa0 73 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 sed for reading
21fb0 6f 72 20 66 6f 72 20 77 72 69 74 69 6e 67 20 69 or for writing i
21fc0 66 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 69 6f f other conditio
21fd0 6e 73 20 66 6f 72 20 77 72 69 74 69 6e 67 0a 2a ns for writing.*
21fe0 2a 20 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 * are also met.
21ff0 20 54 68 65 73 65 20 61 72 65 20 74 68 65 20 63 These are the c
22000 6f 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 20 6d onditions that m
22010 75 73 74 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 ust be met in or
22020 64 65 72 0a 2a 2a 20 66 6f 72 20 77 72 69 74 69 der.** for writi
22030 6e 67 20 74 6f 20 62 65 20 61 6c 6c 6f 77 65 64 ng to be allowed
22040 3a 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 :.**.** 1: The
22050 63 75 72 73 6f 72 20 6d 75 73 74 20 68 61 76 65 cursor must have
22060 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 been opened wit
22070 68 20 77 72 46 6c 61 67 20 63 6f 6e 74 61 69 6e h wrFlag contain
22080 69 6e 67 20 42 54 52 45 45 5f 57 52 43 53 52 0a ing BTREE_WRCSR.
22090 2a 2a 0a 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 **.** 2: Other
220a0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
220b0 69 6f 6e 73 20 74 68 61 74 20 73 68 61 72 65 20 ions that share
220c0 74 68 65 20 73 61 6d 65 20 70 61 67 65 72 20 63 the same pager c
220d0 61 63 68 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 ache.** but
220e0 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 69 6e which are not in
220f0 20 74 68 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d the READ_UNCOMM
22100 49 54 54 45 44 20 73 74 61 74 65 20 6d 61 79 20 ITTED state may
22110 6e 6f 74 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 not have.**
22120 63 75 72 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 cursors open wit
22130 68 20 77 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 h wrFlag==0 on t
22140 68 65 20 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 he same table.
22150 4f 74 68 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 Otherwise.**
22160 20 74 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 the changes mad
22170 65 20 62 79 20 74 68 69 73 20 77 72 69 74 65 20 e by this write
22180 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 cursor would be
22190 76 69 73 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 visible to.**
221a0 20 20 74 68 65 20 72 65 61 64 20 63 75 72 73 6f the read curso
221b0 72 73 20 69 6e 20 74 68 65 20 6f 74 68 65 72 20 rs in the other
221c0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
221d0 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 ion..**.** 3: T
221e0 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 he database must
221f0 20 62 65 20 77 72 69 74 61 62 6c 65 20 28 6e 6f be writable (no
22200 74 20 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d t on read-only m
22210 65 64 69 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 edia).**.** 4:
22220 54 68 65 72 65 20 6d 75 73 74 20 62 65 20 61 6e There must be an
22230 20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 active transact
22240 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 ion..**.** The B
22250 54 52 45 45 5f 46 4f 52 44 45 4c 45 54 45 20 62 TREE_FORDELETE b
22260 69 74 20 6f 66 20 77 72 46 6c 61 67 20 6d 61 79 it of wrFlag may
22270 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 73 optionally be s
22280 65 74 20 69 66 20 42 54 52 45 45 5f 57 52 43 53 et if BTREE_WRCS
22290 52 0a 2a 2a 20 69 73 20 73 65 74 2e 20 20 49 66 R.** is set. If
222a0 20 46 4f 52 44 45 4c 45 54 45 20 69 73 20 73 65 FORDELETE is se
222b0 74 2c 20 74 68 61 74 20 69 73 20 61 20 68 69 6e t, that is a hin
222c0 74 20 74 6f 20 74 68 65 20 69 6d 70 6c 65 6d 65 t to the impleme
222d0 6e 74 61 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 ntation that.**
222e0 74 68 69 73 20 63 75 72 73 6f 72 20 77 69 6c 6c this cursor will
222f0 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 74 6f only be used to
22300 20 73 65 65 6b 20 74 6f 20 61 6e 64 20 64 65 6c seek to and del
22310 65 74 65 20 65 6e 74 72 69 65 73 20 6f 66 20 61 ete entries of a
22320 6e 20 69 6e 64 65 78 0a 2a 2a 20 61 73 20 70 61 n index.** as pa
22330 72 74 20 6f 66 20 61 20 6c 61 72 67 65 72 20 44 rt of a larger D
22340 45 4c 45 54 45 20 73 74 61 74 65 6d 65 6e 74 2e ELETE statement.
22350 20 20 54 68 65 20 46 4f 52 44 45 4c 45 54 45 20 The FORDELETE
22360 68 69 6e 74 20 69 73 20 6e 6f 74 20 75 73 65 64 hint is not used
22370 20 62 79 0a 2a 2a 20 74 68 69 73 20 69 6d 70 6c by.** this impl
22380 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 42 75 74 ementation. But
22390 20 69 6e 20 61 20 68 79 70 6f 74 68 65 74 69 63 in a hypothetic
223a0 61 6c 20 61 6c 74 65 72 6e 61 74 69 76 65 20 73 al alternative s
223b0 74 6f 72 61 67 65 20 65 6e 67 69 6e 65 20 0a 2a torage engine .*
223c0 2a 20 69 6e 20 77 68 69 63 68 20 69 6e 64 65 78 * in which index
223d0 20 65 6e 74 72 69 65 73 20 61 72 65 20 61 75 74 entries are aut
223e0 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 omatically delet
223f0 65 64 20 77 68 65 6e 20 63 6f 72 72 65 73 70 6f ed when correspo
22400 6e 64 69 6e 67 20 74 61 62 6c 65 0a 2a 2a 20 72 nding table.** r
22410 6f 77 73 20 61 72 65 20 64 65 6c 65 74 65 64 2c ows are deleted,
22420 20 74 68 65 20 46 4f 52 44 45 4c 45 54 45 20 66 the FORDELETE f
22430 6c 61 67 20 69 73 20 61 20 68 69 6e 74 20 74 68 lag is a hint th
22440 61 74 20 61 6c 6c 20 53 45 45 4b 20 61 6e 64 20 at all SEEK and
22450 44 45 4c 45 54 45 0a 2a 2a 20 6f 70 65 72 61 74 DELETE.** operat
22460 69 6f 6e 73 20 6f 6e 20 74 68 69 73 20 63 75 72 ions on this cur
22470 73 6f 72 20 63 61 6e 20 62 65 20 6e 6f 2d 6f 70 sor can be no-op
22480 73 20 61 6e 64 20 61 6c 6c 20 52 45 41 44 20 6f s and all READ o
22490 70 65 72 61 74 69 6f 6e 73 20 63 61 6e 20 0a 2a perations can .*
224a0 2a 20 72 65 74 75 72 6e 20 61 20 6e 75 6c 6c 20 * return a null
224b0 72 6f 77 20 28 32 2d 62 79 74 65 73 3a 20 30 78 row (2-bytes: 0x
224c0 30 31 20 30 78 30 30 29 2e 0a 2a 2a 0a 2a 2a 20 01 0x00)..**.**
224d0 4e 6f 20 63 68 65 63 6b 69 6e 67 20 69 73 20 64 No checking is d
224e0 6f 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 one to make sure
224f0 20 74 68 61 74 20 70 61 67 65 20 69 54 61 62 6c that page iTabl
22500 65 20 72 65 61 6c 6c 79 20 69 73 20 74 68 65 0a e really is the.
22510 2a 2a 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 ** root page of
22520 61 20 62 2d 74 72 65 65 2e 20 20 49 66 20 69 74 a b-tree. If it
22530 20 69 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 is not, then th
22540 65 20 63 75 72 73 6f 72 20 61 63 71 75 69 72 65 e cursor acquire
22550 64 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 77 6f d.** will not wo
22560 72 6b 20 63 6f 72 72 65 63 74 6c 79 2e 0a 2a 2a rk correctly..**
22570 0a 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 .** It is assume
22580 64 20 74 68 61 74 20 74 68 65 20 73 71 6c 69 74 d that the sqlit
22590 65 33 42 74 72 65 65 43 75 72 73 6f 72 5a 65 72 e3BtreeCursorZer
225a0 6f 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c o() has been cal
225b0 6c 65 64 0a 2a 2a 20 6f 6e 20 70 43 75 72 20 74 led.** on pCur t
225c0 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 o initialize the
225d0 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 70 72 memory space pr
225e0 69 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 ior to invoking
225f0 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f this routine..*/
22600 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
22610 65 43 75 72 73 6f 72 28 0a 20 20 42 74 72 65 65 eCursor(. Btree
22620 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 *p,
22630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22640 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a /* The btree *
22650 2f 0a 20 20 69 6e 74 20 69 54 61 62 6c 65 2c 20 /. int iTable,
22660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22670 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f /* Ro
22680 6f 74 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 ot page of table
22690 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e to open */. in
226a0 74 20 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 t wrFlag,
226b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
226c0 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 /* 1 to wri
226d0 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 te. 0 read-only
226e0 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 79 49 */. struct KeyI
226f0 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 nfo *pKeyInfo,
22700 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
22710 69 72 73 74 20 61 72 67 20 74 6f 20 63 6f 6d 70 irst arg to comp
22720 61 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 arison function
22730 2a 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 */. BtCursor *p
22740 43 75 72 20 20 20 20 20 20 20 20 20 20 20 20 20 Cur
22750 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
22760 70 61 63 65 20 66 6f 72 20 6e 65 77 20 63 75 72 pace for new cur
22770 73 6f 72 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 sor */.){. BtSh
22780 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
22790 42 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Bt;
227a0 20 20 20 2f 2a 20 53 68 61 72 65 64 20 62 2d 74 /* Shared b-t
227b0 72 65 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 ree handle */.
227c0 42 74 43 75 72 73 6f 72 20 2a 70 58 3b 20 20 20 BtCursor *pX;
227d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
227e0 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 69 6e /* Loopin
227f0 67 20 6f 76 65 72 20 6f 74 68 65 72 20 61 6c 6c g over other all
22800 20 63 75 72 73 6f 72 73 20 2a 2f 0a 0a 20 20 61 cursors */.. a
22810 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 ssert( sqlite3Bt
22820 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 reeHoldsMutex(p)
22830 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 77 72 );. assert( wr
22840 46 6c 61 67 3d 3d 30 20 0a 20 20 20 20 20 20 20 Flag==0 .
22850 7c 7c 20 77 72 46 6c 61 67 3d 3d 42 54 52 45 45 || wrFlag==BTREE
22860 5f 57 52 43 53 52 20 0a 20 20 20 20 20 20 20 7c _WRCSR . |
22870 7c 20 77 72 46 6c 61 67 3d 3d 28 42 54 52 45 45 | wrFlag==(BTREE
22880 5f 57 52 43 53 52 7c 42 54 52 45 45 5f 46 4f 52 _WRCSR|BTREE_FOR
22890 44 45 4c 45 54 45 29 20 0a 20 20 29 3b 0a 0a 20 DELETE) . );..
228a0 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e /* The followin
228b0 67 20 61 73 73 65 72 74 20 73 74 61 74 65 6d 65 g assert stateme
228c0 6e 74 73 20 76 65 72 69 66 79 20 74 68 61 74 20 nts verify that
228d0 69 66 20 74 68 69 73 20 69 73 20 61 20 73 68 61 if this is a sha
228e0 72 61 62 6c 65 20 0a 20 20 2a 2a 20 62 2d 74 72 rable . ** b-tr
228f0 65 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 ee database, the
22900 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 connection is h
22910 6f 6c 64 69 6e 67 20 74 68 65 20 72 65 71 75 69 olding the requi
22920 72 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 2c red table locks,
22930 20 0a 20 20 2a 2a 20 61 6e 64 20 74 68 61 74 20 . ** and that
22940 6e 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 no other connect
22950 69 6f 6e 20 68 61 73 20 61 6e 79 20 6f 70 65 6e ion has any open
22960 20 63 75 72 73 6f 72 20 74 68 61 74 20 63 6f 6e cursor that con
22970 66 6c 69 63 74 73 20 77 69 74 68 20 0a 20 20 2a flicts with . *
22980 2a 20 74 68 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f * this lock. */
22990 0a 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 . assert( hasSh
229a0 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
229b0 63 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 70 4b ck(p, iTable, pK
229c0 65 79 49 6e 66 6f 21 3d 30 2c 20 28 77 72 46 6c eyInfo!=0, (wrFl
229d0 61 67 3f 32 3a 31 29 29 20 29 3b 0a 20 20 61 73 ag?2:1)) );. as
229e0 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
229f0 7c 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c || !hasReadConfl
22a00 69 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 20 icts(p, iTable)
22a10 29 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 );.. /* Assert
22a20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 that the caller
22a30 68 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 72 has opened the r
22a40 65 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 74 equired transact
22a50 69 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 ion. */. assert
22a60 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 ( p->inTrans>TRA
22a70 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 NS_NONE );. ass
22a80 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
22a90 7c 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 | p->inTrans==TR
22aa0 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 ANS_WRITE );. a
22ab0 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 ssert( pBt->pPag
22ac0 65 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 e1 && pBt->pPage
22ad0 31 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 61 73 1->aData );. as
22ae0 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
22af0 7c 7c 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 || (pBt->btsFlag
22b00 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
22b10 59 29 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 Y)==0 );.. if(
22b20 77 72 46 6c 61 67 20 29 7b 0a 20 20 20 20 61 6c wrFlag ){. al
22b30 6c 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 locateTempSpace(
22b40 70 42 74 29 3b 0a 20 20 20 20 69 66 28 20 70 42 pBt);. if( pB
22b50 74 2d 3e 70 54 6d 70 53 70 61 63 65 3d 3d 30 20 t->pTmpSpace==0
22b60 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
22b70 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a NOMEM_BKPT;. }.
22b80 20 20 69 66 28 20 69 54 61 62 6c 65 3d 3d 31 20 if( iTable==1
22b90 26 26 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e && btreePagecoun
22ba0 74 28 70 42 74 29 3d 3d 30 20 29 7b 0a 20 20 20 t(pBt)==0 ){.
22bb0 20 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d assert( wrFlag=
22bc0 3d 30 20 29 3b 0a 20 20 20 20 69 54 61 62 6c 65 =0 );. iTable
22bd0 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 = 0;. }.. /*
22be0 4e 6f 77 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 Now that no othe
22bf0 72 20 65 72 72 6f 72 73 20 63 61 6e 20 6f 63 63 r errors can occ
22c00 75 72 2c 20 66 69 6e 69 73 68 20 66 69 6c 6c 69 ur, finish filli
22c10 6e 67 20 69 6e 20 74 68 65 20 42 74 43 75 72 73 ng in the BtCurs
22c20 6f 72 0a 20 20 2a 2a 20 76 61 72 69 61 62 6c 65 or. ** variable
22c30 73 20 61 6e 64 20 6c 69 6e 6b 20 74 68 65 20 63 s and link the c
22c40 75 72 73 6f 72 20 69 6e 74 6f 20 74 68 65 20 42 ursor into the B
22c50 74 53 68 61 72 65 64 20 6c 69 73 74 2e 20 20 2a tShared list. *
22c60 2f 0a 20 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f /. pCur->pgnoRo
22c70 6f 74 20 3d 20 28 50 67 6e 6f 29 69 54 61 62 6c ot = (Pgno)iTabl
22c80 65 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 e;. pCur->iPage
22c90 20 3d 20 2d 31 3b 0a 20 20 70 43 75 72 2d 3e 70 = -1;. pCur->p
22ca0 4b 65 79 49 6e 66 6f 20 3d 20 70 4b 65 79 49 6e KeyInfo = pKeyIn
22cb0 66 6f 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 72 fo;. pCur->pBtr
22cc0 65 65 20 3d 20 70 3b 0a 20 20 70 43 75 72 2d 3e ee = p;. pCur->
22cd0 70 42 74 20 3d 20 70 42 74 3b 0a 20 20 70 43 75 pBt = pBt;. pCu
22ce0 72 2d 3e 63 75 72 46 6c 61 67 73 20 3d 20 77 72 r->curFlags = wr
22cf0 46 6c 61 67 20 3f 20 42 54 43 46 5f 57 72 69 74 Flag ? BTCF_Writ
22d00 65 46 6c 61 67 20 3a 20 30 3b 0a 20 20 70 43 75 eFlag : 0;. pCu
22d10 72 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 73 r->curPagerFlags
22d20 20 3d 20 77 72 46 6c 61 67 20 3f 20 30 20 3a 20 = wrFlag ? 0 :
22d30 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e PAGER_GET_READON
22d40 4c 59 3b 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 LY;. /* If ther
22d50 65 20 61 72 65 20 74 77 6f 20 6f 72 20 6d 6f 72 e are two or mor
22d60 65 20 63 75 72 73 6f 72 73 20 6f 6e 20 74 68 65 e cursors on the
22d70 20 73 61 6d 65 20 62 74 72 65 65 2c 20 74 68 65 same btree, the
22d80 6e 20 61 6c 6c 20 73 75 63 68 0a 20 20 2a 2a 20 n all such. **
22d90 63 75 72 73 6f 72 73 20 2a 6d 75 73 74 2a 20 68 cursors *must* h
22da0 61 76 65 20 74 68 65 20 42 54 43 46 5f 4d 75 6c ave the BTCF_Mul
22db0 74 69 70 6c 65 20 66 6c 61 67 20 73 65 74 2e 20 tiple flag set.
22dc0 2a 2f 0a 20 20 66 6f 72 28 70 58 3d 70 42 74 2d */. for(pX=pBt-
22dd0 3e 70 43 75 72 73 6f 72 3b 20 70 58 3b 20 70 58 >pCursor; pX; pX
22de0 3d 70 58 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 =pX->pNext){.
22df0 20 69 66 28 20 70 58 2d 3e 70 67 6e 6f 52 6f 6f if( pX->pgnoRoo
22e00 74 3d 3d 28 50 67 6e 6f 29 69 54 61 62 6c 65 20 t==(Pgno)iTable
22e10 29 7b 0a 20 20 20 20 20 20 70 58 2d 3e 63 75 72 ){. pX->cur
22e20 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 4d 75 Flags |= BTCF_Mu
22e30 6c 74 69 70 6c 65 3b 0a 20 20 20 20 20 20 70 43 ltiple;. pC
22e40 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 ur->curFlags |=
22e50 42 54 43 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a 20 BTCF_Multiple;.
22e60 20 20 20 7d 0a 20 20 7d 0a 20 20 70 43 75 72 2d }. }. pCur-
22e70 3e 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 43 >pNext = pBt->pC
22e80 75 72 73 6f 72 3b 0a 20 20 70 42 74 2d 3e 70 43 ursor;. pBt->pC
22e90 75 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 ursor = pCur;.
22ea0 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
22eb0 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 URSOR_INVALID;.
22ec0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
22ed0 4b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 K;.}.int sqlite3
22ee0 42 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 42 BtreeCursor(. B
22ef0 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 tree *p,
22f00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f10 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
22f20 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 e btree */. int
22f30 20 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 iTable,
22f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f50 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 /* Root
22f60 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 page of table t
22f70 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 o open */. int
22f80 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 wrFlag,
22f90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22fa0 20 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 /* 1 to
22fb0 77 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e write. 0 read-on
22fc0 6c 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b ly */. struct K
22fd0 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f eyInfo *pKeyInfo
22fe0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
22ff0 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
23000 20 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 20 2a to xCompare() *
23010 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 /. BtCursor *pC
23020 75 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ur
23030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23040 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 63 75 72 /* Write new cur
23050 73 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 sor here */.){.
23060 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 69 int rc;. if( i
23070 54 61 62 6c 65 3c 31 20 29 7b 0a 20 20 20 20 72 Table<1 ){. r
23080 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
23090 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 PT_BKPT;. }else
230a0 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 {. sqlite3Btr
230b0 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 20 20 eeEnter(p);.
230c0 72 63 20 3d 20 62 74 72 65 65 43 75 72 73 6f 72 rc = btreeCursor
230d0 28 70 2c 20 69 54 61 62 6c 65 2c 20 77 72 46 6c (p, iTable, wrFl
230e0 61 67 2c 20 70 4b 65 79 49 6e 66 6f 2c 20 70 43 ag, pKeyInfo, pC
230f0 75 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ur);. sqlite3
23100 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
23110 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
23120 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
23130 74 68 65 20 73 69 7a 65 20 6f 66 20 61 20 42 74 the size of a Bt
23140 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e Cursor object in
23150 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 bytes..**.** Th
23160 69 73 20 69 6e 74 65 72 66 61 63 65 73 20 69 73 is interfaces is
23170 20 6e 65 65 64 65 64 20 73 6f 20 74 68 61 74 20 needed so that
23180 75 73 65 72 73 20 6f 66 20 63 75 72 73 6f 72 73 users of cursors
23190 20 63 61 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 can preallocate
231a0 0a 2a 2a 20 73 75 66 66 69 63 69 65 6e 74 20 73 .** sufficient s
231b0 74 6f 72 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 torage to hold a
231c0 20 63 75 72 73 6f 72 2e 20 20 54 68 65 20 42 74 cursor. The Bt
231d0 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 Cursor object is
231e0 20 6f 70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 opaque.** to us
231f0 65 72 73 20 73 6f 20 74 68 65 79 20 63 61 6e 6e ers so they cann
23200 6f 74 20 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 ot do the sizeof
23210 28 29 20 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 () themselves -
23220 74 68 65 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a they must call.*
23230 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a * this routine..
23240 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
23250 72 65 65 43 75 72 73 6f 72 53 69 7a 65 28 76 6f reeCursorSize(vo
23260 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f id){. return RO
23270 55 4e 44 38 28 73 69 7a 65 6f 66 28 42 74 43 75 UND8(sizeof(BtCu
23280 72 73 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a rsor));.}../*.**
23290 20 49 6e 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f Initialize memo
232a0 72 79 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 ry that will be
232b0 63 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 converted into a
232c0 20 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 BtCursor object
232d0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 ..**.** The simp
232e0 6c 65 20 61 70 70 72 6f 61 63 68 20 68 65 72 65 le approach here
232f0 20 77 6f 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d would be to mem
23300 73 65 74 28 29 20 74 68 65 20 65 6e 74 69 72 65 set() the entire
23310 20 6f 62 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 object.** to ze
23320 72 6f 2e 20 20 42 75 74 20 69 74 20 74 75 72 6e ro. But it turn
23330 73 20 6f 75 74 20 74 68 61 74 20 74 68 65 20 61 s out that the a
23340 70 50 61 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 pPage[] and aiId
23350 78 5b 5d 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f x[] arrays.** do
23360 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 not need to be
23370 7a 65 72 6f 65 64 20 61 6e 64 20 74 68 65 79 20 zeroed and they
23380 61 72 65 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 are large, so we
23390 20 63 61 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a can save a lot.
233a0 2a 2a 20 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 ** of run-time b
233b0 79 20 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 y skipping the i
233c0 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 nitialization of
233d0 20 74 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e those elements.
233e0 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
233f0 42 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 BtreeCursorZero(
23400 42 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 BtCursor *p){.
23410 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 memset(p, 0, off
23420 73 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 setof(BtCursor,
23430 69 50 61 67 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a iPage));.}../*.*
23440 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 * Close a cursor
23450 2e 20 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b . The read lock
23460 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
23470 20 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 file is release
23480 64 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 d.** when the la
23490 73 74 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f st cursor is clo
234a0 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 sed..*/.int sqli
234b0 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 te3BtreeCloseCur
234c0 73 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 sor(BtCursor *pC
234d0 75 72 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 ur){. Btree *pB
234e0 74 72 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 tree = pCur->pBt
234f0 72 65 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 ree;. if( pBtre
23500 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a e ){. int i;.
23510 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
23520 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 t = pCur->pBt;.
23530 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 sqlite3BtreeE
23540 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
23550 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
23560 65 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b earCursor(pCur);
23570 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 . assert( pBt
23580 2d 3e 70 43 75 72 73 6f 72 21 3d 30 20 29 3b 0a ->pCursor!=0 );.
23590 20 20 20 20 69 66 28 20 70 42 74 2d 3e 70 43 75 if( pBt->pCu
235a0 72 73 6f 72 3d 3d 70 43 75 72 20 29 7b 0a 20 20 rsor==pCur ){.
235b0 20 20 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 pBt->pCursor
235c0 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a = pCur->pNext;.
235d0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
235e0 20 42 74 43 75 72 73 6f 72 20 2a 70 50 72 65 76 BtCursor *pPrev
235f0 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b = pBt->pCursor;
23600 0a 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 . do{.
23610 20 20 20 69 66 28 20 70 50 72 65 76 2d 3e 70 4e if( pPrev->pN
23620 65 78 74 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 ext==pCur ){.
23630 20 20 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e pPrev->pN
23640 65 78 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 ext = pCur->pNex
23650 74 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 t;. bre
23660 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ak;. }.
23670 20 20 20 20 20 20 70 50 72 65 76 20 3d 20 70 50 pPrev = pP
23680 72 65 76 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 rev->pNext;.
23690 20 20 7d 77 68 69 6c 65 28 20 41 4c 57 41 59 53 }while( ALWAYS
236a0 28 70 50 72 65 76 29 20 29 3b 0a 20 20 20 20 7d (pPrev) );. }
236b0 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c . for(i=0; i<
236c0 3d 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b =pCur->iPage; i+
236d0 2b 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 +){. releas
236e0 65 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 ePage(pCur->apPa
236f0 67 65 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 ge[i]);. }.
23700 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 unlockBtreeIfU
23710 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 20 nused(pBt);.
23720 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 75 sqlite3_free(pCu
23730 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 r->aOverflow);.
23740 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 66 72 /* sqlite3_fr
23750 65 65 28 70 43 75 72 29 3b 20 2a 2f 0a 20 20 20 ee(pCur); */.
23760 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
23770 76 65 28 70 42 74 72 65 65 29 3b 0a 20 20 7d 0a ve(pBtree);. }.
23780 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
23790 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b OK;.}../*.** Mak
237a0 65 20 73 75 72 65 20 74 68 65 20 42 74 43 75 72 e sure the BtCur
237b0 73 6f 72 2a 20 67 69 76 65 6e 20 69 6e 20 74 68 sor* given in th
237c0 65 20 61 72 67 75 6d 65 6e 74 20 68 61 73 20 61 e argument has a
237d0 20 76 61 6c 69 64 0a 2a 2a 20 42 74 43 75 72 73 valid.** BtCurs
237e0 6f 72 2e 69 6e 66 6f 20 73 74 72 75 63 74 75 72 or.info structur
237f0 65 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 e. If it is not
23800 20 61 6c 72 65 61 64 79 20 76 61 6c 69 64 2c 20 already valid,
23810 63 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 61 72 call.** btreePar
23820 73 65 43 65 6c 6c 28 29 20 74 6f 20 66 69 6c 6c seCell() to fill
23830 20 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 it in..**.** Bt
23840 43 75 72 73 6f 72 2e 69 6e 66 6f 20 69 73 20 61 Cursor.info is a
23850 20 63 61 63 68 65 20 6f 66 20 74 68 65 20 69 6e cache of the in
23860 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 formation in the
23870 20 63 75 72 72 65 6e 74 20 63 65 6c 6c 2e 0a 2a current cell..*
23880 2a 20 55 73 69 6e 67 20 74 68 69 73 20 63 61 63 * Using this cac
23890 68 65 20 72 65 64 75 63 65 73 20 74 68 65 20 6e he reduces the n
238a0 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 74 umber of calls t
238b0 6f 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c o btreeParseCell
238c0 28 29 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e ()..*/.#ifndef N
238d0 44 45 42 55 47 0a 20 20 73 74 61 74 69 63 20 76 DEBUG. static v
238e0 6f 69 64 20 61 73 73 65 72 74 43 65 6c 6c 49 6e oid assertCellIn
238f0 66 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 fo(BtCursor *pCu
23900 72 29 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 6f r){. CellInfo
23910 20 69 6e 66 6f 3b 0a 20 20 20 20 69 6e 74 20 69 info;. int i
23920 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 Page = pCur->iPa
23930 67 65 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 ge;. memset(&
23940 69 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 6f 66 28 info, 0, sizeof(
23950 69 6e 66 6f 29 29 3b 0a 20 20 20 20 62 74 72 65 info));. btre
23960 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d eParseCell(pCur-
23970 3e 61 70 50 61 67 65 5b 69 50 61 67 65 5d 2c 20 >apPage[iPage],
23980 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 67 pCur->aiIdx[iPag
23990 65 5d 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 e], &info);.
239a0 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f assert( CORRUPT_
239b0 44 42 20 7c 7c 20 6d 65 6d 63 6d 70 28 26 69 6e DB || memcmp(&in
239c0 66 6f 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 2c fo, &pCur->info,
239d0 20 73 69 7a 65 6f 66 28 69 6e 66 6f 29 29 3d 3d sizeof(info))==
239e0 30 20 29 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 0 );. }.#else.
239f0 20 23 64 65 66 69 6e 65 20 61 73 73 65 72 74 43 #define assertC
23a00 65 6c 6c 49 6e 66 6f 28 78 29 0a 23 65 6e 64 69 ellInfo(x).#endi
23a10 66 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f f.static SQLITE_
23a20 4e 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 20 67 65 NOINLINE void ge
23a30 74 43 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 tCellInfo(BtCurs
23a40 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 66 28 or *pCur){. if(
23a50 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a pCur->info.nSiz
23a60 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 e==0 ){. int
23a70 69 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 iPage = pCur->iP
23a80 61 67 65 3b 0a 20 20 20 20 70 43 75 72 2d 3e 63 age;. pCur->c
23a90 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f urFlags |= BTCF_
23aa0 56 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 20 20 62 ValidNKey;. b
23ab0 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 treeParseCell(pC
23ac0 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 ur->apPage[iPage
23ad0 5d 2c 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 ],pCur->aiIdx[iP
23ae0 61 67 65 5d 2c 26 70 43 75 72 2d 3e 69 6e 66 6f age],&pCur->info
23af0 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
23b00 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 70 assertCellInfo(p
23b10 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 Cur);. }.}..#if
23b20 6e 64 65 66 20 4e 44 45 42 55 47 20 20 2f 2a 20 ndef NDEBUG /*
23b30 54 68 65 20 6e 65 78 74 20 72 6f 75 74 69 6e 65 The next routine
23b40 20 75 73 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 used only withi
23b50 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
23b60 6d 65 6e 74 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 ments */./*.** R
23b70 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 eturn true if th
23b80 65 20 67 69 76 65 6e 20 42 74 43 75 72 73 6f 72 e given BtCursor
23b90 20 69 73 20 76 61 6c 69 64 2e 20 20 41 20 76 61 is valid. A va
23ba0 6c 69 64 20 63 75 72 73 6f 72 20 69 73 20 6f 6e lid cursor is on
23bb0 65 0a 2a 2a 20 74 68 61 74 20 69 73 20 63 75 72 e.** that is cur
23bc0 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 rently pointing
23bd0 74 6f 20 61 20 72 6f 77 20 69 6e 20 61 20 28 6e to a row in a (n
23be0 6f 6e 2d 65 6d 70 74 79 29 20 74 61 62 6c 65 2e on-empty) table.
23bf0 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 76 65 .** This is a ve
23c00 72 69 66 69 63 61 74 69 6f 6e 20 72 6f 75 74 69 rification routi
23c10 6e 65 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 ne is used only
23c20 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20 within assert()
23c30 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 69 statements..*/.i
23c40 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 nt sqlite3BtreeC
23c50 75 72 73 6f 72 49 73 56 61 6c 69 64 28 42 74 43 ursorIsValid(BtC
23c60 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
23c70 72 65 74 75 72 6e 20 70 43 75 72 20 26 26 20 70 return pCur && p
23c80 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
23c90 53 4f 52 5f 56 41 4c 49 44 3b 0a 7d 0a 23 65 6e SOR_VALID;.}.#en
23ca0 64 69 66 20 2f 2a 20 4e 44 45 42 55 47 20 2a 2f dif /* NDEBUG */
23cb0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
23cc0 65 43 75 72 73 6f 72 49 73 56 61 6c 69 64 4e 4e eCursorIsValidNN
23cd0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
23ce0 7b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 {. assert( pCur
23cf0 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 !=0 );. return
23d00 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
23d10 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f RSOR_VALID;.}../
23d20 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
23d30 76 61 6c 75 65 20 6f 66 20 74 68 65 20 69 6e 74 value of the int
23d40 65 67 65 72 20 6b 65 79 20 6f 72 20 22 72 6f 77 eger key or "row
23d50 69 64 22 20 66 6f 72 20 61 20 74 61 62 6c 65 20 id" for a table
23d60 62 74 72 65 65 2e 0a 2a 2a 20 54 68 69 73 20 72 btree..** This r
23d70 6f 75 74 69 6e 65 20 69 73 20 6f 6e 6c 79 20 76 outine is only v
23d80 61 6c 69 64 20 66 6f 72 20 61 20 63 75 72 73 6f alid for a curso
23d90 72 20 74 68 61 74 20 69 73 20 70 6f 69 6e 74 69 r that is pointi
23da0 6e 67 20 69 6e 74 6f 20 61 0a 2a 2a 20 6f 72 64 ng into a.** ord
23db0 69 6e 61 72 79 20 74 61 62 6c 65 20 62 74 72 65 inary table btre
23dc0 65 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 6f e. If the curso
23dd0 72 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 69 r points to an i
23de0 6e 64 65 78 20 62 74 72 65 65 20 6f 72 0a 2a 2a ndex btree or.**
23df0 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 74 68 65 is invalid, the
23e00 20 72 65 73 75 6c 74 20 6f 66 20 74 68 69 73 20 result of this
23e10 72 6f 75 74 69 6e 65 20 69 73 20 75 6e 64 65 66 routine is undef
23e20 69 6e 65 64 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c ined..*/.i64 sql
23e30 69 74 65 33 42 74 72 65 65 49 6e 74 65 67 65 72 ite3BtreeInteger
23e40 4b 65 79 28 42 74 43 75 72 73 6f 72 20 2a 70 43 Key(BtCursor *pC
23e50 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 ur){. assert( c
23e60 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
23e70 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
23e80 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
23e90 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
23ea0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
23eb0 3e 63 75 72 49 6e 74 4b 65 79 20 29 3b 0a 20 20 >curIntKey );.
23ec0 67 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 getCellInfo(pCur
23ed0 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 );. return pCur
23ee0 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3b 0a 7d 0a 0a ->info.nKey;.}..
23ef0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
23f00 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
23f10 20 6f 66 20 70 61 79 6c 6f 61 64 20 66 6f 72 20 of payload for
23f20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 70 the entry that p
23f30 43 75 72 20 69 73 0a 2a 2a 20 63 75 72 72 65 6e Cur is.** curren
23f40 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e tly pointing to.
23f50 20 20 46 6f 72 20 74 61 62 6c 65 20 62 74 72 65 For table btre
23f60 65 73 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 es, this will be
23f70 20 74 68 65 20 61 6d 6f 75 6e 74 0a 2a 2a 20 6f the amount.** o
23f80 66 20 64 61 74 61 2e 20 20 46 6f 72 20 69 6e 64 f data. For ind
23f90 65 78 20 62 74 72 65 65 73 2c 20 74 68 69 73 20 ex btrees, this
23fa0 77 69 6c 6c 20 62 65 20 74 68 65 20 73 69 7a 65 will be the size
23fb0 20 6f 66 20 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a of the key..**.
23fc0 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 ** The caller mu
23fd0 73 74 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 st guarantee tha
23fe0 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 t the cursor is
23ff0 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 6e 6f pointing to a no
24000 6e 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 64 20 n-NULL.** valid
24010 65 6e 74 72 79 2e 20 20 49 6e 20 6f 74 68 65 72 entry. In other
24020 20 77 6f 72 64 73 2c 20 74 68 65 20 63 61 6c 6c words, the call
24030 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 6d 75 ing procedure mu
24040 73 74 20 67 75 61 72 61 6e 74 65 65 0a 2a 2a 20 st guarantee.**
24050 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 that the cursor
24060 68 61 73 20 43 75 72 73 6f 72 2e 65 53 74 61 74 has Cursor.eStat
24070 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e e==CURSOR_VALID.
24080 0a 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 42 .*/.u32 sqlite3B
24090 74 72 65 65 50 61 79 6c 6f 61 64 53 69 7a 65 28 treePayloadSize(
240a0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
240b0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
240c0 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
240d0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
240e0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
240f0 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 67 SOR_VALID );. g
24100 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 etCellInfo(pCur)
24110 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d ;. return pCur-
24120 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a >info.nPayload;.
24130 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 }../*.** Given t
24140 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
24150 66 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 f an overflow pa
24160 67 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 ge in the databa
24170 73 65 20 28 70 61 72 61 6d 65 74 65 72 0a 2a 2a se (parameter.**
24180 20 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 75 6e ovfl), this fun
24190 63 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 65 20 ction finds the
241a0 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 page number of t
241b0 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
241c0 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 6c the .** linked l
241d0 69 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 ist of overflow
241e0 70 61 67 65 73 2e 20 49 66 20 70 6f 73 73 69 62 pages. If possib
241f0 6c 65 2c 20 69 74 20 75 73 65 73 20 74 68 65 20 le, it uses the
24200 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 70 auto-vacuum.** p
24210 6f 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 61 20 ointer-map data
24220 69 6e 73 74 65 61 64 20 6f 66 20 72 65 61 64 69 instead of readi
24230 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f ng the content o
24240 66 20 70 61 67 65 20 6f 76 66 6c 20 74 6f 20 64 f page ovfl to d
24250 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 o so. .**.** If
24260 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 an error occurs
24270 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
24280 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
24290 2e 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a 2a 0a . Otherwise:.**.
242a0 2a 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 ** The page numb
242b0 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 6f er of the next o
242c0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 verflow page in
242d0 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 the linked list
242e0 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 is .** written t
242f0 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 49 66 o *pPgnoNext. If
24300 20 70 61 67 65 20 6f 76 66 6c 20 69 73 20 74 68 page ovfl is th
24310 65 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 69 e last page in i
24320 74 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c 69 ts linked .** li
24330 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 20 69 st, *pPgnoNext i
24340 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 0a s set to zero. .
24350 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 65 20 **.** If ppPage
24360 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e 64 is not NULL, and
24370 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
24380 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 the MemPage obje
24390 63 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 ct corresponding
243a0 0a 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 .** to page numb
243b0 65 72 20 70 4f 76 66 6c 20 77 61 73 20 6f 62 74 er pOvfl was obt
243c0 61 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 70 50 ained, then *ppP
243d0 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 70 6f age is set to po
243e0 69 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a 20 72 int to that.** r
243f0 65 66 65 72 65 6e 63 65 2e 20 49 74 20 69 73 20 eference. It is
24400 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
24410 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 ty of the caller
24420 20 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 73 65 to call release
24430 50 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 70 Page().** on *pp
24440 50 61 67 65 20 74 6f 20 66 72 65 65 20 74 68 65 Page to free the
24450 20 72 65 66 65 72 65 6e 63 65 2e 20 49 6e 20 6e reference. In n
24460 6f 20 72 65 66 65 72 65 6e 63 65 20 77 61 73 20 o reference was
24470 6f 62 74 61 69 6e 65 64 20 28 62 65 63 61 75 73 obtained (becaus
24480 65 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 e.** the pointer
24490 2d 6d 61 70 20 77 61 73 20 75 73 65 64 20 74 6f -map was used to
244a0 20 6f 62 74 61 69 6e 20 74 68 65 20 76 61 6c 75 obtain the valu
244b0 65 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 74 e for *pPgnoNext
244c0 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 61 ), then.** *ppPa
244d0 67 65 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 ge is set to zer
244e0 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 o..*/.static int
244f0 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
24500 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
24510 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
24520 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
24530 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
24540 6f 76 66 6c 2c 20 20 20 20 20 20 20 20 20 20 20 ovfl,
24550 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 /* Curre
24560 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 nt overflow page
24570 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 6d number */. Mem
24580 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 Page **ppPage,
24590 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
245a0 3a 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 6c 65 : MemPage handle
245b0 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a (may be NULL) *
245c0 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 4e /. Pgno *pPgnoN
245d0 65 78 74 20 20 20 20 20 20 20 20 20 20 20 20 20 ext
245e0 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 6f 76 /* OUT: Next ov
245f0 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 erflow page numb
24600 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f 20 er */.){. Pgno
24610 6e 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 next = 0;. MemP
24620 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a age *pPage = 0;.
24630 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
24640 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 E_OK;.. assert(
24650 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
24660 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
24670 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 67 6e );. assert(pPgn
24680 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 65 66 oNext);..#ifndef
24690 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
246a0 4f 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 72 79 OVACUUM. /* Try
246b0 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 65 78 to find the nex
246c0 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 6f 76 t page in the ov
246d0 65 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 69 6e erflow list usin
246e0 67 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 6f 76 g the. ** autov
246f0 61 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 acuum pointer-ma
24700 70 20 70 61 67 65 73 2e 20 47 75 65 73 73 20 74 p pages. Guess t
24710 68 61 74 20 74 68 65 20 6e 65 78 74 20 70 61 67 hat the next pag
24720 65 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 20 6f e in . ** the o
24730 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 73 20 verflow list is
24740 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6f 76 66 page number (ovf
24750 6c 2b 31 29 2e 20 49 66 20 74 68 61 74 20 67 75 l+1). If that gu
24760 65 73 73 20 74 75 72 6e 73 20 0a 20 20 2a 2a 20 ess turns . **
24770 6f 75 74 20 74 6f 20 62 65 20 77 72 6f 6e 67 2c out to be wrong,
24780 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 6c 6f fall back to lo
24790 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 20 6f ading the data o
247a0 66 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e 75 6d f page . ** num
247b0 62 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 74 65 ber ovfl to dete
247c0 72 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 20 70 rmine the next p
247d0 61 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 2a 2f age number.. */
247e0 0a 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f . if( pBt->auto
247f0 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 Vacuum ){. Pg
24800 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 67 6e no pgno;. Pgn
24810 6f 20 69 47 75 65 73 73 20 3d 20 6f 76 66 6c 2b o iGuess = ovfl+
24820 31 3b 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 1;. u8 eType;
24830 0a 0a 20 20 20 20 77 68 69 6c 65 28 20 50 54 52 .. while( PTR
24840 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
24850 69 47 75 65 73 73 29 20 7c 7c 20 69 47 75 65 73 iGuess) || iGues
24860 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f s==PENDING_BYTE_
24870 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
24880 20 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 20 20 iGuess++;.
24890 20 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 75 65 }.. if( iGue
248a0 73 73 3c 3d 62 74 72 65 65 50 61 67 65 63 6f 75 ss<=btreePagecou
248b0 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 nt(pBt) ){.
248c0 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 rc = ptrmapGet(
248d0 70 42 74 2c 20 69 47 75 65 73 73 2c 20 26 65 54 pBt, iGuess, &eT
248e0 79 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 20 ype, &pgno);.
248f0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
24900 45 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d 3d 50 E_OK && eType==P
24910 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 TRMAP_OVERFLOW2
24920 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 7b && pgno==ovfl ){
24930 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 3d 20 . next =
24940 69 47 75 65 73 73 3b 0a 20 20 20 20 20 20 20 20 iGuess;.
24950 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
24960 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
24970 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 }.#endif.. as
24980 73 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 7c 7c sert( next==0 ||
24990 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 rc==SQLITE_DONE
249a0 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );. if( rc==SQ
249b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
249c0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
249d0 28 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 50 61 (pBt, ovfl, &pPa
249e0 67 65 2c 20 28 70 70 50 61 67 65 3d 3d 30 29 20 ge, (ppPage==0)
249f0 3f 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 ? PAGER_GET_READ
24a00 4f 4e 4c 59 20 3a 20 30 29 3b 0a 20 20 20 20 61 ONLY : 0);. a
24a10 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
24a20 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 3d 3d 30 E_OK || pPage==0
24a30 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d );. if( rc==
24a40 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
24a50 20 20 20 6e 65 78 74 20 3d 20 67 65 74 34 62 79 next = get4by
24a60 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 te(pPage->aData)
24a70 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a ;. }. }.. *
24a80 70 50 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 78 74 pPgnoNext = next
24a90 3b 0a 20 20 69 66 28 20 70 70 50 61 67 65 20 29 ;. if( ppPage )
24aa0 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 {. *ppPage =
24ab0 70 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a pPage;. }else{.
24ac0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
24ad0 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 72 65 pPage);. }. re
24ae0 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 turn (rc==SQLITE
24af0 5f 44 4f 4e 45 20 3f 20 53 51 4c 49 54 45 5f 4f _DONE ? SQLITE_O
24b00 4b 20 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a K : rc);.}../*.*
24b10 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d * Copy data from
24b20 20 61 20 62 75 66 66 65 72 20 74 6f 20 61 20 70 a buffer to a p
24b30 61 67 65 2c 20 6f 72 20 66 72 6f 6d 20 61 20 70 age, or from a p
24b40 61 67 65 20 74 6f 20 61 20 62 75 66 66 65 72 2e age to a buffer.
24b50 0a 2a 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 64 20 .**.** pPayload
24b60 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
24b70 64 61 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 64 data stored on d
24b80 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
24b90 50 61 67 65 2e 0a 2a 2a 20 49 66 20 61 72 67 75 Page..** If argu
24ba0 6d 65 6e 74 20 65 4f 70 20 69 73 20 66 61 6c 73 ment eOp is fals
24bb0 65 2c 20 74 68 65 6e 20 6e 42 79 74 65 20 62 79 e, then nByte by
24bc0 74 65 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 tes of data are
24bd0 63 6f 70 69 65 64 0a 2a 2a 20 66 72 6f 6d 20 70 copied.** from p
24be0 50 61 79 6c 6f 61 64 20 74 6f 20 74 68 65 20 62 Payload to the b
24bf0 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 61 74 uffer pointed at
24c00 20 62 79 20 70 42 75 66 2e 20 49 66 20 65 4f 70 by pBuf. If eOp
24c10 20 69 73 20 74 72 75 65 2c 0a 2a 2a 20 74 68 65 is true,.** the
24c20 6e 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 n sqlite3PagerWr
24c30 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 ite() is called
24c40 6f 6e 20 70 44 62 50 61 67 65 20 61 6e 64 20 6e on pDbPage and n
24c50 42 79 74 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 Byte bytes.** of
24c60 20 64 61 74 61 20 61 72 65 20 63 6f 70 69 65 64 data are copied
24c70 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
24c80 20 70 42 75 66 20 74 6f 20 70 50 61 79 6c 6f 61 pBuf to pPayloa
24c90 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f d..**.** SQLITE_
24ca0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f OK is returned o
24cb0 6e 20 73 75 63 63 65 73 73 2c 20 6f 74 68 65 72 n success, other
24cc0 77 69 73 65 20 61 6e 20 65 72 72 6f 72 20 63 6f wise an error co
24cd0 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e de..*/.static in
24ce0 74 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 0a 20 t copyPayload(.
24cf0 20 76 6f 69 64 20 2a 70 50 61 79 6c 6f 61 64 2c void *pPayload,
24d00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
24d10 69 6e 74 65 72 20 74 6f 20 70 61 67 65 20 64 61 inter to page da
24d20 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 ta */. void *pB
24d30 75 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 uf,
24d40 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
24d50 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 buffer */. int
24d60 6e 42 79 74 65 2c 20 20 20 20 20 20 20 20 20 20 nByte,
24d70 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
24d80 6f 66 20 62 79 74 65 73 20 74 6f 20 63 6f 70 79 of bytes to copy
24d90 20 2a 2f 0a 20 20 69 6e 74 20 65 4f 70 2c 20 20 */. int eOp,
24da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24db0 2f 2a 20 30 20 2d 3e 20 63 6f 70 79 20 66 72 6f /* 0 -> copy fro
24dc0 6d 20 70 61 67 65 2c 20 31 20 2d 3e 20 63 6f 70 m page, 1 -> cop
24dd0 79 20 74 6f 20 70 61 67 65 20 2a 2f 0a 20 20 44 y to page */. D
24de0 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 20 20 bPage *pDbPage
24df0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
24e00 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 50 61 79 containing pPay
24e10 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 load */.){. if(
24e20 20 65 4f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 43 eOp ){. /* C
24e30 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 62 75 opy data from bu
24e40 66 66 65 72 20 74 6f 20 70 61 67 65 20 28 61 20 ffer to page (a
24e50 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 29 write operation)
24e60 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d */. int rc =
24e70 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
24e80 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
24e90 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
24ea0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 OK ){. retu
24eb0 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
24ec0 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 memcpy(pPayload
24ed0 2c 20 70 42 75 66 2c 20 6e 42 79 74 65 29 3b 0a , pBuf, nByte);.
24ee0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 }else{. /*
24ef0 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 70 Copy data from p
24f00 61 67 65 20 74 6f 20 62 75 66 66 65 72 20 28 61 age to buffer (a
24f10 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 29 read operation)
24f20 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 */. memcpy(p
24f30 42 75 66 2c 20 70 50 61 79 6c 6f 61 64 2c 20 6e Buf, pPayload, n
24f40 42 79 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 Byte);. }. ret
24f50 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
24f60 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
24f70 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
24f80 20 72 65 61 64 20 6f 72 20 6f 76 65 72 77 72 69 read or overwri
24f90 74 65 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 te payload infor
24fa0 6d 61 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 74 68 mation.** for th
24fb0 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 e entry that the
24fc0 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 20 pCur cursor is
24fd0 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 54 68 65 pointing to. The
24fe0 20 65 4f 70 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 eOp.** argument
24ff0 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 is interpreted
25000 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a as follows:.**.*
25010 2a 20 20 20 30 3a 20 54 68 65 20 6f 70 65 72 61 * 0: The opera
25020 74 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e 20 tion is a read.
25030 50 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 Populate the ove
25040 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 rflow cache..**
25050 20 20 31 3a 20 54 68 65 20 6f 70 65 72 61 74 69 1: The operati
25060 6f 6e 20 69 73 20 61 20 77 72 69 74 65 2e 20 50 on is a write. P
25070 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 opulate the over
25080 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a flow cache..**.*
25090 2a 20 41 20 74 6f 74 61 6c 20 6f 66 20 22 61 6d * A total of "am
250a0 74 22 20 62 79 74 65 73 20 61 72 65 20 72 65 61 t" bytes are rea
250b0 64 20 6f 72 20 77 72 69 74 74 65 6e 20 62 65 67 d or written beg
250c0 69 6e 6e 69 6e 67 20 61 74 20 22 6f 66 66 73 65 inning at "offse
250d0 74 22 2e 0a 2a 2a 20 44 61 74 61 20 69 73 20 72 t"..** Data is r
250e0 65 61 64 20 74 6f 20 6f 72 20 66 72 6f 6d 20 74 ead to or from t
250f0 68 65 20 62 75 66 66 65 72 20 70 42 75 66 2e 0a he buffer pBuf..
25100 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6e 74 65 6e **.** The conten
25110 74 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 20 t being read or
25120 77 72 69 74 74 65 6e 20 6d 69 67 68 74 20 61 70 written might ap
25130 70 65 61 72 20 6f 6e 20 74 68 65 20 6d 61 69 6e pear on the main
25140 20 70 61 67 65 0a 2a 2a 20 6f 72 20 62 65 20 73 page.** or be s
25150 63 61 74 74 65 72 65 64 20 6f 75 74 20 6f 6e 20 cattered out on
25160 6d 75 6c 74 69 70 6c 65 20 6f 76 65 72 66 6c 6f multiple overflo
25170 77 20 70 61 67 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 w pages..**.** I
25180 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 f the current cu
25190 72 73 6f 72 20 65 6e 74 72 79 20 75 73 65 73 20 rsor entry uses
251a0 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 65 72 one or more over
251b0 66 6c 6f 77 20 70 61 67 65 73 0a 2a 2a 20 74 68 flow pages.** th
251c0 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 is function may
251d0 61 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 allocate space f
251e0 6f 72 20 61 6e 64 20 6c 61 7a 69 6c 79 20 70 6f or and lazily po
251f0 70 75 6c 61 74 65 0a 2a 2a 20 74 68 65 20 6f 76 pulate.** the ov
25200 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 erflow page-list
25210 20 63 61 63 68 65 20 61 72 72 61 79 20 28 42 74 cache array (Bt
25220 43 75 72 73 6f 72 2e 61 4f 76 65 72 66 6c 6f 77 Cursor.aOverflow
25230 29 2e 20 0a 2a 2a 20 53 75 62 73 65 71 75 65 6e ). .** Subsequen
25240 74 20 63 61 6c 6c 73 20 75 73 65 20 74 68 69 73 t calls use this
25250 20 63 61 63 68 65 20 74 6f 20 6d 61 6b 65 20 73 cache to make s
25260 65 65 6b 69 6e 67 20 74 6f 20 74 68 65 20 73 75 eeking to the su
25270 70 70 6c 69 65 64 20 6f 66 66 73 65 74 20 0a 2a pplied offset .*
25280 2a 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e 74 * more efficient
25290 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 61 6e 20 ..**.** Once an
252a0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 overflow page-li
252b0 73 74 20 63 61 63 68 65 20 68 61 73 20 62 65 65 st cache has bee
252c0 6e 20 61 6c 6c 6f 63 61 74 65 64 2c 20 69 74 20 n allocated, it
252d0 6d 75 73 74 20 62 65 0a 2a 2a 20 69 6e 76 61 6c must be.** inval
252e0 69 64 61 74 65 64 20 69 66 20 73 6f 6d 65 20 6f idated if some o
252f0 74 68 65 72 20 63 75 72 73 6f 72 20 77 72 69 74 ther cursor writ
25300 65 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20 74 es to the same t
25310 61 62 6c 65 2c 20 6f 72 20 69 66 0a 2a 2a 20 74 able, or if.** t
25320 68 65 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 he cursor is mov
25330 65 64 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e ed to a differen
25340 74 20 72 6f 77 2e 20 41 64 64 69 74 69 6f 6e 61 t row. Additiona
25350 6c 6c 79 2c 20 69 6e 20 61 75 74 6f 2d 76 61 63 lly, in auto-vac
25360 75 75 6d 0a 2a 2a 20 6d 6f 64 65 2c 20 74 68 65 uum.** mode, the
25370 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 76 65 6e 74 following event
25380 73 20 6d 61 79 20 69 6e 76 61 6c 69 64 61 74 65 s may invalidate
25390 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
253a0 65 2d 6c 69 73 74 20 63 61 63 68 65 2e 0a 2a 2a e-list cache..**
253b0 0a 2a 2a 20 20 20 2a 20 41 6e 20 69 6e 63 72 65 .** * An incre
253c0 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2c 0a 2a mental vacuum,.*
253d0 2a 20 20 20 2a 20 41 20 63 6f 6d 6d 69 74 20 69 * * A commit i
253e0 6e 20 61 75 74 6f 5f 76 61 63 75 75 6d 3d 22 66 n auto_vacuum="f
253f0 75 6c 6c 22 20 6d 6f 64 65 2c 0a 2a 2a 20 20 20 ull" mode,.**
25400 2a 20 43 72 65 61 74 69 6e 67 20 61 20 74 61 62 * Creating a tab
25410 6c 65 20 28 6d 61 79 20 72 65 71 75 69 72 65 20 le (may require
25420 6d 6f 76 69 6e 67 20 61 6e 20 6f 76 65 72 66 6c moving an overfl
25430 6f 77 20 70 61 67 65 29 2e 0a 2a 2f 0a 73 74 61 ow page)..*/.sta
25440 74 69 63 20 69 6e 74 20 61 63 63 65 73 73 50 61 tic int accessPa
25450 79 6c 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f yload(. BtCurso
25460 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a r *pCur, /*
25470 20 43 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 Cursor pointing
25480 20 74 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 to entry to rea
25490 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 d from */. u32
254a0 6f 66 66 73 65 74 2c 20 20 20 20 20 20 20 20 20 offset,
254b0 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 64 69 6e /* Begin readin
254c0 67 20 74 68 69 73 20 66 61 72 20 69 6e 74 6f 20 g this far into
254d0 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 75 33 32 payload */. u32
254e0 20 61 6d 74 2c 20 20 20 20 20 20 20 20 20 20 20 amt,
254f0 20 20 2f 2a 20 52 65 61 64 20 74 68 69 73 20 6d /* Read this m
25500 61 6e 79 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 any bytes */. u
25510 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 42 nsigned char *pB
25520 75 66 2c 20 2f 2a 20 57 72 69 74 65 20 74 68 65 uf, /* Write the
25530 20 62 79 74 65 73 20 69 6e 74 6f 20 74 68 69 73 bytes into this
25540 20 62 75 66 66 65 72 20 2a 2f 20 0a 20 20 69 6e buffer */ . in
25550 74 20 65 4f 70 20 20 20 20 20 20 20 20 20 20 20 t eOp
25560 20 20 20 2f 2a 20 7a 65 72 6f 20 74 6f 20 72 65 /* zero to re
25570 61 64 2e 20 6e 6f 6e 2d 7a 65 72 6f 20 74 6f 20 ad. non-zero to
25580 77 72 69 74 65 2e 20 2a 2f 0a 29 7b 0a 20 20 75 write. */.){. u
25590 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 61 50 nsigned char *aP
255a0 61 79 6c 6f 61 64 3b 0a 20 20 69 6e 74 20 72 63 ayload;. int rc
255b0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
255c0 69 6e 74 20 69 49 64 78 20 3d 20 30 3b 0a 20 20 int iIdx = 0;.
255d0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
255e0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
255f0 75 72 2d 3e 69 50 61 67 65 5d 3b 20 2f 2a 20 42 ur->iPage]; /* B
25600 74 72 65 65 20 70 61 67 65 20 6f 66 20 63 75 72 tree page of cur
25610 72 65 6e 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 rent entry */.
25620 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
25630 70 43 75 72 2d 3e 70 42 74 3b 20 20 20 20 20 20 pCur->pBt;
25640 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
25650 74 72 65 65 20 74 68 69 73 20 63 75 72 73 6f 72 tree this cursor
25660 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 23 belongs to */.#
25670 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 ifdef SQLITE_DIR
25680 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 ECT_OVERFLOW_REA
25690 44 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 D. unsigned cha
256a0 72 20 2a 20 63 6f 6e 73 74 20 70 42 75 66 53 74 r * const pBufSt
256b0 61 72 74 20 3d 20 70 42 75 66 3b 20 20 20 20 20 art = pBuf;
256c0 2f 2a 20 53 74 61 72 74 20 6f 66 20 6f 72 69 67 /* Start of orig
256d0 69 6e 61 6c 20 6f 75 74 20 62 75 66 66 65 72 20 inal out buffer
256e0 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 */.#endif.. ass
256f0 65 72 74 28 20 70 50 61 67 65 20 29 3b 0a 20 20 ert( pPage );.
25700 61 73 73 65 72 74 28 20 65 4f 70 3d 3d 30 20 7c assert( eOp==0 |
25710 7c 20 65 4f 70 3d 3d 31 20 29 3b 0a 20 20 61 73 | eOp==1 );. as
25720 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
25730 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
25740 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
25750 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
25760 69 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e 6e 43 iPage]<pPage->nC
25770 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ell );. assert(
25780 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
25790 78 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 67 65 x(pCur) );.. ge
257a0 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
257b0 0a 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 70 43 . aPayload = pC
257c0 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 ur->info.pPayloa
257d0 64 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 d;. assert( off
257e0 73 65 74 2b 61 6d 74 20 3c 3d 20 70 43 75 72 2d set+amt <= pCur-
257f0 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 >info.nPayload )
25800 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 61 50 61 ;.. assert( aPa
25810 79 6c 6f 61 64 20 3e 20 70 50 61 67 65 2d 3e 61 yload > pPage->a
25820 44 61 74 61 20 29 3b 0a 20 20 69 66 28 20 28 75 Data );. if( (u
25830 70 74 72 29 28 61 50 61 79 6c 6f 61 64 20 2d 20 ptr)(aPayload -
25840 70 50 61 67 65 2d 3e 61 44 61 74 61 29 20 3e 20 pPage->aData) >
25850 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 (pBt->usableSize
25860 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c - pCur->info.nL
25870 6f 63 61 6c 29 20 29 7b 0a 20 20 20 20 2f 2a 20 ocal) ){. /*
25880 54 72 79 69 6e 67 20 74 6f 20 72 65 61 64 20 6f Trying to read o
25890 72 20 77 72 69 74 65 20 70 61 73 74 20 74 68 65 r write past the
258a0 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 end of the data
258b0 20 69 73 20 61 6e 20 65 72 72 6f 72 2e 20 20 54 is an error. T
258c0 68 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 64 69 74 he. ** condit
258d0 69 6f 6e 61 6c 20 61 62 6f 76 65 20 69 73 20 72 ional above is r
258e0 65 61 6c 6c 79 3a 0a 20 20 20 20 2a 2a 20 20 20 eally:. **
258f0 20 26 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d &aPayload[pCur-
25900 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 >info.nLocal] >
25910 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
25920 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 5d 0a 20 t->usableSize].
25930 20 20 20 2a 2a 20 62 75 74 20 69 73 20 72 65 63 ** but is rec
25940 61 73 74 20 69 6e 74 6f 20 69 74 73 20 63 75 72 ast into its cur
25950 72 65 6e 74 20 66 6f 72 6d 20 74 6f 20 61 76 6f rent form to avo
25960 69 64 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66 id integer overf
25970 6c 6f 77 20 70 72 6f 62 6c 65 6d 73 0a 20 20 20 low problems.
25980 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 */. return S
25990 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
259a0 50 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 PT;. }.. /* Ch
259b0 65 63 6b 20 69 66 20 64 61 74 61 20 6d 75 73 74 eck if data must
259c0 20 62 65 20 72 65 61 64 2f 77 72 69 74 74 65 6e be read/written
259d0 20 74 6f 2f 66 72 6f 6d 20 74 68 65 20 62 74 72 to/from the btr
259e0 65 65 20 70 61 67 65 20 69 74 73 65 6c 66 2e 20 ee page itself.
259f0 2a 2f 0a 20 20 69 66 28 20 6f 66 66 73 65 74 3c */. if( offset<
25a00 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
25a10 6c 20 29 7b 0a 20 20 20 20 69 6e 74 20 61 20 3d l ){. int a =
25a20 20 61 6d 74 3b 0a 20 20 20 20 69 66 28 20 61 2b amt;. if( a+
25a30 6f 66 66 73 65 74 3e 70 43 75 72 2d 3e 69 6e 66 offset>pCur->inf
25a40 6f 2e 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 o.nLocal ){.
25a50 20 20 61 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f a = pCur->info
25a60 2e 6e 4c 6f 63 61 6c 20 2d 20 6f 66 66 73 65 74 .nLocal - offset
25a70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d ;. }. rc =
25a80 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 50 copyPayload(&aP
25a90 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 5d 2c 20 ayload[offset],
25aa0 70 42 75 66 2c 20 61 2c 20 65 4f 70 2c 20 70 50 pBuf, a, eOp, pP
25ab0 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 age->pDbPage);.
25ac0 20 20 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 offset = 0;.
25ad0 20 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 pBuf += a;.
25ae0 20 20 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 amt -= a;. }e
25af0 6c 73 65 7b 0a 20 20 20 20 6f 66 66 73 65 74 20 lse{. offset
25b00 2d 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c -= pCur->info.nL
25b10 6f 63 61 6c 3b 0a 20 20 7d 0a 0a 0a 20 20 69 66 ocal;. }... if
25b20 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
25b30 26 26 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 && amt>0 ){.
25b40 63 6f 6e 73 74 20 75 33 32 20 6f 76 66 6c 53 69 const u32 ovflSi
25b50 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 ze = pBt->usable
25b60 53 69 7a 65 20 2d 20 34 3b 20 20 2f 2a 20 42 79 Size - 4; /* By
25b70 74 65 73 20 63 6f 6e 74 65 6e 74 20 70 65 72 20 tes content per
25b80 6f 76 66 6c 20 70 61 67 65 20 2a 2f 0a 20 20 20 ovfl page */.
25b90 20 50 67 6e 6f 20 6e 65 78 74 50 61 67 65 3b 0a Pgno nextPage;.
25ba0 0a 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 . nextPage =
25bb0 67 65 74 34 62 79 74 65 28 26 61 50 61 79 6c 6f get4byte(&aPaylo
25bc0 61 64 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c ad[pCur->info.nL
25bd0 6f 63 61 6c 5d 29 3b 0a 0a 20 20 20 20 2f 2a 20 ocal]);.. /*
25be0 49 66 20 74 68 65 20 42 74 43 75 72 73 6f 72 2e If the BtCursor.
25bf0 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 68 61 73 20 aOverflow[] has
25c00 6e 6f 74 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 not been allocat
25c10 65 64 2c 20 61 6c 6c 6f 63 61 74 65 20 69 74 20 ed, allocate it
25c20 6e 6f 77 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 now.. **.
25c30 2a 2a 20 54 68 65 20 61 4f 76 65 72 66 6c 6f 77 ** The aOverflow
25c40 5b 5d 20 61 72 72 61 79 20 69 73 20 73 69 7a 65 [] array is size
25c50 64 20 61 74 20 6f 6e 65 20 65 6e 74 72 79 20 66 d at one entry f
25c60 6f 72 20 65 61 63 68 20 6f 76 65 72 66 6c 6f 77 or each overflow
25c70 20 70 61 67 65 0a 20 20 20 20 2a 2a 20 69 6e 20 page. ** in
25c80 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 the overflow cha
25c90 69 6e 2e 20 54 68 65 20 70 61 67 65 20 6e 75 6d in. The page num
25ca0 62 65 72 20 6f 66 20 74 68 65 20 66 69 72 73 74 ber of the first
25cb0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 overflow page i
25cc0 73 0a 20 20 20 20 2a 2a 20 73 74 6f 72 65 64 20 s. ** stored
25cd0 69 6e 20 61 4f 76 65 72 66 6c 6f 77 5b 30 5d 2c in aOverflow[0],
25ce0 20 65 74 63 2e 20 41 20 76 61 6c 75 65 20 6f 66 etc. A value of
25cf0 20 30 20 69 6e 20 74 68 65 20 61 4f 76 65 72 66 0 in the aOverf
25d00 6c 6f 77 5b 5d 20 61 72 72 61 79 0a 20 20 20 20 low[] array.
25d10 2a 2a 20 6d 65 61 6e 73 20 22 6e 6f 74 20 79 65 ** means "not ye
25d20 74 20 6b 6e 6f 77 6e 22 20 28 74 68 65 20 63 61 t known" (the ca
25d30 63 68 65 20 69 73 20 6c 61 7a 69 6c 79 20 70 6f che is lazily po
25d40 70 75 6c 61 74 65 64 29 2e 0a 20 20 20 20 2a 2f pulated).. */
25d50 0a 20 20 20 20 69 66 28 20 28 70 43 75 72 2d 3e . if( (pCur->
25d60 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f curFlags & BTCF_
25d70 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 29 7b ValidOvfl)==0 ){
25d80 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f 76 66 6c . int nOvfl
25d90 20 3d 20 28 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e = (pCur->info.n
25da0 50 61 79 6c 6f 61 64 2d 70 43 75 72 2d 3e 69 6e Payload-pCur->in
25db0 66 6f 2e 6e 4c 6f 63 61 6c 2b 6f 76 66 6c 53 69 fo.nLocal+ovflSi
25dc0 7a 65 2d 31 29 2f 6f 76 66 6c 53 69 7a 65 3b 0a ze-1)/ovflSize;.
25dd0 20 20 20 20 20 20 69 66 28 20 6e 4f 76 66 6c 3e if( nOvfl>
25de0 70 43 75 72 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 pCur->nOvflAlloc
25df0 20 29 7b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f ){. Pgno
25e00 20 2a 61 4e 65 77 20 3d 20 28 50 67 6e 6f 2a 29 *aNew = (Pgno*)
25e10 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 0a sqlite3Realloc(.
25e20 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 pCur
25e30 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 6e 4f 76 ->aOverflow, nOv
25e40 66 6c 2a 32 2a 73 69 7a 65 6f 66 28 50 67 6e 6f fl*2*sizeof(Pgno
25e50 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 ). );.
25e60 20 20 20 20 20 69 66 28 20 61 4e 65 77 3d 3d 30 if( aNew==0
25e70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
25e80 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
25e90 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 M_BKPT;.
25ea0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
25eb0 20 70 43 75 72 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f pCur->nOvflAllo
25ec0 63 20 3d 20 6e 4f 76 66 6c 2a 32 3b 0a 20 20 20 c = nOvfl*2;.
25ed0 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 pCur->aOv
25ee0 65 72 66 6c 6f 77 20 3d 20 61 4e 65 77 3b 0a 20 erflow = aNew;.
25ef0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
25f00 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 43 . memset(pC
25f10 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 30 ur->aOverflow, 0
25f20 2c 20 6e 4f 76 66 6c 2a 73 69 7a 65 6f 66 28 50 , nOvfl*sizeof(P
25f30 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 70 43 75 gno));. pCu
25f40 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 r->curFlags |= B
25f50 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 3b 0a 20 TCF_ValidOvfl;.
25f60 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
25f70 2f 2a 20 49 66 20 74 68 65 20 6f 76 65 72 66 6c /* If the overfl
25f80 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ow page-list cac
25f90 68 65 20 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f he has been allo
25fa0 63 61 74 65 64 20 61 6e 64 20 74 68 65 0a 20 20 cated and the.
25fb0 20 20 20 20 2a 2a 20 65 6e 74 72 79 20 66 6f 72 ** entry for
25fc0 20 74 68 65 20 66 69 72 73 74 20 72 65 71 75 69 the first requi
25fd0 72 65 64 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 red overflow pag
25fe0 65 20 69 73 20 76 61 6c 69 64 2c 20 73 6b 69 70 e is valid, skip
25ff0 0a 20 20 20 20 20 20 2a 2a 20 64 69 72 65 63 74 . ** direct
26000 6c 79 20 74 6f 20 69 74 2e 0a 20 20 20 20 20 20 ly to it..
26010 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 */. if( pCu
26020 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 6f 66 66 r->aOverflow[off
26030 73 65 74 2f 6f 76 66 6c 53 69 7a 65 5d 20 29 7b set/ovflSize] ){
26040 0a 20 20 20 20 20 20 20 20 69 49 64 78 20 3d 20 . iIdx =
26050 28 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 7a 65 (offset/ovflSize
26060 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 78 74 50 );. nextP
26070 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 65 age = pCur->aOve
26080 72 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a 20 20 20 rflow[iIdx];.
26090 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 28 6f offset = (o
260a0 66 66 73 65 74 25 6f 76 66 6c 53 69 7a 65 29 3b ffset%ovflSize);
260b0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a . }. }..
260c0 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d assert( rc==
260d0 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d 74 SQLITE_OK && amt
260e0 3e 30 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 >0 );. while(
260f0 20 6e 65 78 74 50 61 67 65 20 29 7b 0a 20 20 20 nextPage ){.
26100 20 20 20 2f 2a 20 49 66 20 72 65 71 75 69 72 65 /* If require
26110 64 2c 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20 d, populate the
26120 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 overflow page-li
26130 73 74 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20 20 st cache. */.
26140 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
26150 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d >aOverflow[iIdx]
26160 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 20 ==0.
26170 20 20 7c 7c 20 70 43 75 72 2d 3e 61 4f 76 65 72 || pCur->aOver
26180 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d 6e 65 78 74 flow[iIdx]==next
26190 50 61 67 65 0a 20 20 20 20 20 20 20 20 20 20 20 Page.
261a0 20 20 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 || CORRUPT_DB
261b0 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e );. pCur->
261c0 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 20 aOverflow[iIdx]
261d0 3d 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 20 = nextPage;..
261e0 20 20 20 69 66 28 20 6f 66 66 73 65 74 3e 3d 6f if( offset>=o
261f0 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 vflSize ){.
26200 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c 79 20 72 /* The only r
26210 65 61 73 6f 6e 20 74 6f 20 72 65 61 64 20 74 68 eason to read th
26220 69 73 20 70 61 67 65 20 69 73 20 74 6f 20 6f 62 is page is to ob
26230 74 61 69 6e 20 74 68 65 20 70 61 67 65 0a 20 20 tain the page.
26240 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 ** number
26250 66 6f 72 20 74 68 65 20 6e 65 78 74 20 70 61 67 for the next pag
26260 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f e in the overflo
26270 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 67 w chain. The pag
26280 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 61 74 e. ** dat
26290 61 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 a is not require
262a0 64 2e 20 53 6f 20 66 69 72 73 74 20 74 72 79 20 d. So first try
262b0 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 6f 76 to lookup the ov
262c0 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 2a erflow. *
262d0 2a 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 * page-list cach
262e0 65 2c 20 69 66 20 61 6e 79 2c 20 74 68 65 6e 20 e, if any, then
262f0 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74 68 65 fall back to the
26300 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
26310 28 29 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 75 (). ** fu
26320 6e 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 20 nction..
26330 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 */. asser
26340 74 28 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 t( pCur->curFlag
26350 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 s & BTCF_ValidOv
26360 66 6c 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 fl );. as
26370 73 65 72 74 28 20 70 43 75 72 2d 3e 70 42 74 72 sert( pCur->pBtr
26380 65 65 2d 3e 64 62 3d 3d 70 42 74 2d 3e 64 62 20 ee->db==pBt->db
26390 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
263a0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 Cur->aOverflow[i
263b0 49 64 78 2b 31 5d 20 29 7b 0a 20 20 20 20 20 20 Idx+1] ){.
263c0 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 70 nextPage = p
263d0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 Cur->aOverflow[i
263e0 49 64 78 2b 31 5d 3b 0a 20 20 20 20 20 20 20 20 Idx+1];.
263f0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
26400 20 72 63 20 3d 20 67 65 74 4f 76 65 72 66 6c 6f rc = getOverflo
26410 77 50 61 67 65 28 70 42 74 2c 20 6e 65 78 74 50 wPage(pBt, nextP
26420 61 67 65 2c 20 30 2c 20 26 6e 65 78 74 50 61 67 age, 0, &nextPag
26430 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 e);. }.
26440 20 20 20 20 20 20 6f 66 66 73 65 74 20 2d 3d 20 offset -=
26450 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 20 ovflSize;.
26460 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f }else{. /
26470 2a 20 4e 65 65 64 20 74 6f 20 72 65 61 64 20 74 * Need to read t
26480 68 69 73 20 70 61 67 65 20 70 72 6f 70 65 72 6c his page properl
26490 79 2e 20 49 74 20 63 6f 6e 74 61 69 6e 73 20 73 y. It contains s
264a0 6f 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 ome of the.
264b0 20 20 20 2a 2a 20 72 61 6e 67 65 20 6f 66 20 64 ** range of d
264c0 61 74 61 20 74 68 61 74 20 69 73 20 62 65 69 6e ata that is bein
264d0 67 20 72 65 61 64 20 28 65 4f 70 3d 3d 30 29 20 g read (eOp==0)
264e0 6f 72 20 77 72 69 74 74 65 6e 20 28 65 4f 70 21 or written (eOp!
264f0 3d 30 29 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a =0).. */.
26500 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 #ifdef SQLITE_DI
26510 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 RECT_OVERFLOW_RE
26520 41 44 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 AD. sqlit
26530 65 33 5f 66 69 6c 65 20 2a 66 64 3b 20 20 20 20 e3_file *fd;
26540 20 20 2f 2a 20 46 69 6c 65 20 66 72 6f 6d 20 77 /* File from w
26550 68 69 63 68 20 74 6f 20 64 6f 20 64 69 72 65 63 hich to do direc
26560 74 20 6f 76 65 72 66 6c 6f 77 20 72 65 61 64 20 t overflow read
26570 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 */.#endif.
26580 20 20 69 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 int a = amt;.
26590 20 20 20 20 20 20 20 69 66 28 20 61 20 2b 20 6f if( a + o
265a0 66 66 73 65 74 20 3e 20 6f 76 66 6c 53 69 7a 65 ffset > ovflSize
265b0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 20 ){. a
265c0 3d 20 6f 76 66 6c 53 69 7a 65 20 2d 20 6f 66 66 = ovflSize - off
265d0 73 65 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a set;. }..
265e0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 #ifdef SQLITE_DI
265f0 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 RECT_OVERFLOW_RE
26600 41 44 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 AD. /* If
26610 20 61 6c 6c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 all the followi
26620 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 20 20 20 ng are true:.
26630 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 **.
26640 2a 2a 20 20 20 31 29 20 74 68 69 73 20 69 73 20 ** 1) this is
26650 61 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e a read operation
26660 2c 20 61 6e 64 20 0a 20 20 20 20 20 20 20 20 2a , and . *
26670 2a 20 20 20 32 29 20 64 61 74 61 20 69 73 20 72 * 2) data is r
26680 65 71 75 69 72 65 64 20 66 72 6f 6d 20 74 68 65 equired from the
26690 20 73 74 61 72 74 20 6f 66 20 74 68 69 73 20 6f start of this o
266a0 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 61 6e verflow page, an
266b0 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 33 d. ** 3
266c0 29 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 70 ) there is no op
266d0 65 6e 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 en write-transac
266e0 74 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 20 tion, and.
266f0 20 20 2a 2a 20 20 20 34 29 20 74 68 65 20 64 61 ** 4) the da
26700 74 61 62 61 73 65 20 69 73 20 66 69 6c 65 2d 62 tabase is file-b
26710 61 63 6b 65 64 2c 20 61 6e 64 0a 20 20 20 20 20 acked, and.
26720 20 20 20 2a 2a 20 20 20 35 29 20 74 68 65 20 70 ** 5) the p
26730 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 74 68 age is not in th
26740 65 20 57 41 4c 20 66 69 6c 65 0a 20 20 20 20 20 e WAL file.
26750 20 20 20 2a 2a 20 20 20 36 29 20 61 74 20 6c 65 ** 6) at le
26760 61 73 74 20 34 20 62 79 74 65 73 20 68 61 76 65 ast 4 bytes have
26770 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 72 65 already been re
26780 61 64 20 69 6e 74 6f 20 74 68 65 20 6f 75 74 70 ad into the outp
26790 75 74 20 62 75 66 66 65 72 20 0a 20 20 20 20 20 ut buffer .
267a0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
267b0 20 74 68 65 6e 20 64 61 74 61 20 63 61 6e 20 62 then data can b
267c0 65 20 72 65 61 64 20 64 69 72 65 63 74 6c 79 20 e read directly
267d0 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
267e0 65 20 66 69 6c 65 20 69 6e 74 6f 20 74 68 65 0a e file into the.
267f0 20 20 20 20 20 20 20 20 2a 2a 20 6f 75 74 70 75 ** outpu
26800 74 20 62 75 66 66 65 72 2c 20 62 79 70 61 73 73 t buffer, bypass
26810 69 6e 67 20 74 68 65 20 70 61 67 65 2d 63 61 63 ing the page-cac
26820 68 65 20 61 6c 74 6f 67 65 74 68 65 72 2e 20 54 he altogether. T
26830 68 69 73 20 73 70 65 65 64 73 0a 20 20 20 20 20 his speeds.
26840 20 20 20 2a 2a 20 75 70 20 6c 6f 61 64 69 6e 67 ** up loading
26850 20 6c 61 72 67 65 20 72 65 63 6f 72 64 73 20 74 large records t
26860 68 61 74 20 73 70 61 6e 20 6d 61 6e 79 20 6f 76 hat span many ov
26870 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 20 20 erflow pages..
26880 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
26890 20 69 66 28 20 65 4f 70 3d 3d 30 20 20 20 20 20 if( eOp==0
268a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
268b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
268c0 20 20 20 20 20 20 20 20 2f 2a 20 28 31 29 20 2a /* (1) *
268d0 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 6f 66 /. && of
268e0 66 73 65 74 3d 3d 30 20 20 20 20 20 20 20 20 20 fset==0
268f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26910 20 2f 2a 20 28 32 29 20 2a 2f 0a 20 20 20 20 20 /* (2) */.
26920 20 20 20 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 && pBt->inTr
26930 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
26940 5f 52 45 41 44 20 20 20 20 20 20 20 20 20 20 20 _READ
26950 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 33 29 /* (3)
26960 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 */. &&
26970 28 66 64 20 3d 20 73 71 6c 69 74 65 33 50 61 67 (fd = sqlite3Pag
26980 65 72 46 69 6c 65 28 70 42 74 2d 3e 70 50 61 67 erFile(pBt->pPag
26990 65 72 29 29 2d 3e 70 4d 65 74 68 6f 64 73 20 20 er))->pMethods
269a0 20 20 20 2f 2a 20 28 34 29 20 2a 2f 0a 20 20 20 /* (4) */.
269b0 20 20 20 20 20 20 26 26 20 30 3d 3d 73 71 6c 69 && 0==sqli
269c0 74 65 33 50 61 67 65 72 55 73 65 57 61 6c 28 70 te3PagerUseWal(p
269d0 42 74 2d 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 Bt->pPager, next
269e0 50 61 67 65 29 20 20 20 20 20 20 20 2f 2a 20 28 Page) /* (
269f0 35 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 5) */. &
26a00 26 20 26 70 42 75 66 5b 2d 34 5d 3e 3d 70 42 75 & &pBuf[-4]>=pBu
26a10 66 53 74 61 72 74 20 20 20 20 20 20 20 20 20 20 fStart
26a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26a30 20 20 20 20 20 2f 2a 20 28 36 29 20 2a 2f 0a 20 /* (6) */.
26a40 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 ){.
26a50 20 20 20 20 75 38 20 61 53 61 76 65 5b 34 5d 3b u8 aSave[4];
26a60 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 2a 61 . u8 *a
26a70 57 72 69 74 65 20 3d 20 26 70 42 75 66 5b 2d 34 Write = &pBuf[-4
26a80 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 ];. ass
26a90 65 72 74 28 20 61 57 72 69 74 65 3e 3d 70 42 75 ert( aWrite>=pBu
26aa0 66 53 74 61 72 74 20 29 3b 20 20 20 20 20 20 20 fStart );
26ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26ac0 20 20 2f 2a 20 64 75 65 20 74 6f 20 28 36 29 20 /* due to (6)
26ad0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d */. mem
26ae0 63 70 79 28 61 53 61 76 65 2c 20 61 57 72 69 74 cpy(aSave, aWrit
26af0 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 e, 4);.
26b00 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
26b10 65 61 64 28 66 64 2c 20 61 57 72 69 74 65 2c 20 ead(fd, aWrite,
26b20 61 2b 34 2c 20 28 69 36 34 29 70 42 74 2d 3e 70 a+4, (i64)pBt->p
26b30 61 67 65 53 69 7a 65 2a 28 6e 65 78 74 50 61 67 ageSize*(nextPag
26b40 65 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 e-1));.
26b50 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 nextPage = get4
26b60 62 79 74 65 28 61 57 72 69 74 65 29 3b 0a 20 20 byte(aWrite);.
26b70 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 memcpy(a
26b80 57 72 69 74 65 2c 20 61 53 61 76 65 2c 20 34 29 Write, aSave, 4)
26b90 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 0a ;. }else.
26ba0 23 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 20 20 #endif..
26bb0 7b 0a 20 20 20 20 20 20 20 20 20 20 44 62 50 61 {. DbPa
26bc0 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 20 ge *pDbPage;.
26bd0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
26be0 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d te3PagerGet(pBt-
26bf0 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 50 61 67 >pPager, nextPag
26c00 65 2c 20 26 70 44 62 50 61 67 65 2c 0a 20 20 20 e, &pDbPage,.
26c10 20 20 20 20 20 20 20 20 20 20 20 28 65 4f 70 3d (eOp=
26c20 3d 30 20 3f 20 50 41 47 45 52 5f 47 45 54 5f 52 =0 ? PAGER_GET_R
26c30 45 41 44 4f 4e 4c 59 20 3a 20 30 29 0a 20 20 20 EADONLY : 0).
26c40 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 );.
26c50 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
26c60 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
26c70 20 20 20 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 aPayload =
26c80 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 sqlite3PagerGetD
26c90 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 ata(pDbPage);.
26ca0 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 50 61 nextPa
26cb0 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 61 50 ge = get4byte(aP
26cc0 61 79 6c 6f 61 64 29 3b 0a 20 20 20 20 20 20 20 ayload);.
26cd0 20 20 20 20 20 72 63 20 3d 20 63 6f 70 79 50 61 rc = copyPa
26ce0 79 6c 6f 61 64 28 26 61 50 61 79 6c 6f 61 64 5b yload(&aPayload[
26cf0 6f 66 66 73 65 74 2b 34 5d 2c 20 70 42 75 66 2c offset+4], pBuf,
26d00 20 61 2c 20 65 4f 70 2c 20 70 44 62 50 61 67 65 a, eOp, pDbPage
26d10 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 );. s
26d20 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
26d30 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 (pDbPage);.
26d40 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 offset =
26d50 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 0;. }.
26d60 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
26d70 20 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 20 amt -= a;.
26d80 20 20 20 69 66 28 20 61 6d 74 3d 3d 30 20 29 20 if( amt==0 )
26d90 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
26da0 20 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 pBuf += a;.
26db0 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
26dc0 72 63 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 rc ) break;.
26dd0 20 20 69 49 64 78 2b 2b 3b 0a 20 20 20 20 7d 0a iIdx++;. }.
26de0 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 }.. if( rc==S
26df0 51 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e QLITE_OK && amt>
26e00 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
26e10 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
26e20 4b 50 54 3b 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 KPT; /* Overflow
26e30 20 63 68 61 69 6e 20 65 6e 64 73 20 70 72 65 6d chain ends prem
26e40 61 74 75 72 65 6c 79 20 2a 2f 0a 20 20 7d 0a 20 aturely */. }.
26e50 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
26e60 2a 0a 2a 2a 20 52 65 61 64 20 70 61 72 74 20 6f *.** Read part o
26e70 66 20 74 68 65 20 70 61 79 6c 6f 61 64 20 66 6f f the payload fo
26e80 72 20 74 68 65 20 72 6f 77 20 61 74 20 77 68 69 r the row at whi
26e90 63 68 20 74 68 61 74 20 63 75 72 73 6f 72 20 70 ch that cursor p
26ea0 43 75 72 20 69 73 20 63 75 72 72 65 6e 74 6c 79 Cur is currently
26eb0 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 20 22 .** pointing. "
26ec0 61 6d 74 22 20 62 79 74 65 73 20 77 69 6c 6c 20 amt" bytes will
26ed0 62 65 20 74 72 61 6e 73 66 65 72 72 65 64 20 69 be transferred i
26ee0 6e 74 6f 20 70 42 75 66 5b 5d 2e 20 20 54 68 65 nto pBuf[]. The
26ef0 20 74 72 61 6e 73 66 65 72 0a 2a 2a 20 62 65 67 transfer.** beg
26f00 69 6e 73 20 61 74 20 22 6f 66 66 73 65 74 22 2e ins at "offset".
26f10 0a 2a 2a 0a 2a 2a 20 70 43 75 72 20 63 61 6e 20 .**.** pCur can
26f20 62 65 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 65 be pointing to e
26f30 69 74 68 65 72 20 61 20 74 61 62 6c 65 20 6f 72 ither a table or
26f40 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 an index b-tree
26f50 2e 0a 2a 2a 20 49 66 20 70 6f 69 6e 74 69 6e 67 ..** If pointing
26f60 20 74 6f 20 61 20 74 61 62 6c 65 20 62 74 72 65 to a table btre
26f70 65 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6e 74 e, then the cont
26f80 65 6e 74 20 73 65 63 74 69 6f 6e 20 69 73 20 72 ent section is r
26f90 65 61 64 2e 20 20 49 66 0a 2a 2a 20 70 43 75 72 ead. If.** pCur
26fa0 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 is pointing to
26fb0 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 an index b-tree
26fc0 74 68 65 6e 20 74 68 65 20 6b 65 79 20 73 65 63 then the key sec
26fd0 74 69 6f 6e 20 69 73 20 72 65 61 64 2e 0a 2a 2a tion is read..**
26fe0 0a 2a 2a 20 46 6f 72 20 73 71 6c 69 74 65 33 42 .** For sqlite3B
26ff0 74 72 65 65 50 61 79 6c 6f 61 64 28 29 2c 20 74 treePayload(), t
27000 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 he caller must e
27010 6e 73 75 72 65 20 74 68 61 74 20 70 43 75 72 20 nsure that pCur
27020 69 73 20 70 6f 69 6e 74 69 6e 67 0a 2a 2a 20 74 is pointing.** t
27030 6f 20 61 20 76 61 6c 69 64 20 72 6f 77 20 69 6e o a valid row in
27040 20 74 68 65 20 74 61 62 6c 65 2e 20 20 46 6f 72 the table. For
27050 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 sqlite3BtreePay
27060 6c 6f 61 64 43 68 65 63 6b 65 64 28 29 2c 20 74 loadChecked(), t
27070 68 65 0a 2a 2a 20 63 75 72 73 6f 72 20 6d 69 67 he.** cursor mig
27080 68 74 20 62 65 20 69 6e 76 61 6c 69 64 20 6f 72 ht be invalid or
27090 20 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 62 might need to b
270a0 65 20 72 65 73 74 6f 72 65 64 20 62 65 66 6f 72 e restored befor
270b0 65 20 62 65 69 6e 67 20 72 65 61 64 2e 0a 2a 2a e being read..**
270c0 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 .** Return SQLIT
270d0 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 E_OK on success
270e0 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 or an error code
270f0 20 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 if anything goe
27100 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 s.** wrong. An
27110 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 error is returne
27120 64 20 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 d if "offset+amt
27130 22 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e " is larger than
27140 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c .** the availabl
27150 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e e payload..*/.in
27160 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 t sqlite3BtreePa
27170 79 6c 6f 61 64 28 42 74 43 75 72 73 6f 72 20 2a yload(BtCursor *
27180 70 43 75 72 2c 20 75 33 32 20 6f 66 66 73 65 74 pCur, u32 offset
27190 2c 20 75 33 32 20 61 6d 74 2c 20 76 6f 69 64 20 , u32 amt, void
271a0 2a 70 42 75 66 29 7b 0a 20 20 61 73 73 65 72 74 *pBuf){. assert
271b0 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
271c0 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
271d0 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
271e0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
271f0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27200 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 ur->iPage>=0 &&
27210 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27220 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 r->iPage] );. a
27230 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 ssert( pCur->aiI
27240 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c dx[pCur->iPage]<
27250 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27260 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
27270 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 63 63 );. return acc
27280 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c essPayload(pCur,
27290 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 28 75 offset, amt, (u
272a0 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 29 70 42 nsigned char*)pB
272b0 75 66 2c 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a uf, 0);.}../*.**
272c0 20 54 68 69 73 20 76 61 72 69 61 6e 74 20 6f 66 This variant of
272d0 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 sqlite3BtreePay
272e0 6c 6f 61 64 28 29 20 77 6f 72 6b 73 20 65 76 65 load() works eve
272f0 6e 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 n if the cursor
27300 68 61 73 20 6e 6f 74 0a 2a 2a 20 69 6e 20 74 68 has not.** in th
27310 65 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 73 e CURSOR_VALID s
27320 74 61 74 65 2e 20 20 49 74 20 69 73 20 6f 6e 6c tate. It is onl
27330 79 20 75 73 65 64 20 62 79 20 74 68 65 20 73 71 y used by the sq
27340 6c 69 74 65 33 5f 62 6c 6f 62 5f 72 65 61 64 28 lite3_blob_read(
27350 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2e 0a ).** interface..
27360 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
27370 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a E_OMIT_INCRBLOB.
27380 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f static SQLITE_NO
27390 49 4e 4c 49 4e 45 20 69 6e 74 20 61 63 63 65 73 INLINE int acces
273a0 73 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 sPayloadChecked(
273b0 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
273c0 72 2c 0a 20 20 75 33 32 20 6f 66 66 73 65 74 2c r,. u32 offset,
273d0 0a 20 20 75 33 32 20 61 6d 74 2c 0a 20 20 76 6f . u32 amt,. vo
273e0 69 64 20 2a 70 42 75 66 0a 29 7b 0a 20 20 69 6e id *pBuf.){. in
273f0 74 20 72 63 3b 0a 20 20 69 66 20 28 20 70 43 75 t rc;. if ( pCu
27400 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
27410 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a 20 20 20 R_INVALID ){.
27420 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41 return SQLITE_A
27430 42 4f 52 54 3b 0a 20 20 7d 0a 20 20 61 73 73 65 BORT;. }. asse
27440 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 rt( cursorOwnsBt
27450 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a Shared(pCur) );.
27460 20 20 72 63 20 3d 20 62 74 72 65 65 52 65 73 74 rc = btreeRest
27470 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
27480 6e 28 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 n(pCur);. retur
27490 6e 20 72 63 20 3f 20 72 63 20 3a 20 61 63 63 65 n rc ? rc : acce
274a0 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 ssPayload(pCur,
274b0 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 70 42 75 offset, amt, pBu
274c0 66 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c f, 0);.}.int sql
274d0 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 ite3BtreePayload
274e0 43 68 65 63 6b 65 64 28 42 74 43 75 72 73 6f 72 Checked(BtCursor
274f0 20 2a 70 43 75 72 2c 20 75 33 32 20 6f 66 66 73 *pCur, u32 offs
27500 65 74 2c 20 75 33 32 20 61 6d 74 2c 20 76 6f 69 et, u32 amt, voi
27510 64 20 2a 70 42 75 66 29 7b 0a 20 20 69 66 28 20 d *pBuf){. if(
27520 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
27530 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 RSOR_VALID ){.
27540 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
27550 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
27560 72 29 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e r) );. return
27570 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 accessPayload(p
27580 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 Cur, offset, amt
27590 2c 20 70 42 75 66 2c 20 30 29 3b 0a 20 20 7d 65 , pBuf, 0);. }e
275a0 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 lse{. return
275b0 61 63 63 65 73 73 50 61 79 6c 6f 61 64 43 68 65 accessPayloadChe
275c0 63 6b 65 64 28 70 43 75 72 2c 20 6f 66 66 73 65 cked(pCur, offse
275d0 74 2c 20 61 6d 74 2c 20 70 42 75 66 29 3b 0a 20 t, amt, pBuf);.
275e0 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 }.}.#endif /* S
275f0 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 QLITE_OMIT_INCRB
27600 4c 4f 42 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 LOB */../*.** Re
27610 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 turn a pointer t
27620 6f 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 6d o payload inform
27630 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 65 ation from the e
27640 6e 74 72 79 20 74 68 61 74 20 74 68 65 20 0a 2a ntry that the .*
27650 2a 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 * pCur cursor is
27660 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 20 54 pointing to. T
27670 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 74 6f he pointer is to
27680 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f the beginning o
27690 66 0a 2a 2a 20 74 68 65 20 6b 65 79 20 69 66 20 f.** the key if
276a0 69 6e 64 65 78 20 62 74 72 65 65 73 20 28 70 50 index btrees (pP
276b0 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 30 29 20 age->intKey==0)
276c0 61 6e 64 20 69 73 20 74 68 65 20 64 61 74 61 20 and is the data
276d0 66 6f 72 0a 2a 2a 20 74 61 62 6c 65 20 62 74 72 for.** table btr
276e0 65 65 73 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b ees (pPage->intK
276f0 65 79 3d 3d 31 29 2e 20 54 68 65 20 6e 75 6d 62 ey==1). The numb
27700 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 61 er of bytes of a
27710 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 6b 65 79 2f vailable.** key/
27720 64 61 74 61 20 69 73 20 77 72 69 74 74 65 6e 20 data is written
27730 69 6e 74 6f 20 2a 70 41 6d 74 2e 20 20 49 66 20 into *pAmt. If
27740 2a 70 41 6d 74 3d 3d 30 2c 20 74 68 65 6e 20 74 *pAmt==0, then t
27750 68 65 20 76 61 6c 75 65 0a 2a 2a 20 72 65 74 75 he value.** retu
27760 72 6e 65 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 rned will not be
27770 20 61 20 76 61 6c 69 64 20 70 6f 69 6e 74 65 72 a valid pointer
27780 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
27790 74 69 6e 65 20 69 73 20 61 6e 20 6f 70 74 69 6d tine is an optim
277a0 69 7a 61 74 69 6f 6e 2e 20 20 49 74 20 69 73 20 ization. It is
277b0 63 6f 6d 6d 6f 6e 20 66 6f 72 20 74 68 65 20 65 common for the e
277c0 6e 74 69 72 65 20 6b 65 79 0a 2a 2a 20 61 6e 64 ntire key.** and
277d0 20 64 61 74 61 20 74 6f 20 66 69 74 20 6f 6e 20 data to fit on
277e0 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 20 61 the local page a
277f0 6e 64 20 66 6f 72 20 74 68 65 72 65 20 74 6f 20 nd for there to
27800 62 65 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 0a 2a be no overflow.*
27810 2a 20 70 61 67 65 73 2e 20 20 57 68 65 6e 20 74 * pages. When t
27820 68 61 74 20 69 73 20 73 6f 2c 20 74 68 69 73 20 hat is so, this
27830 72 6f 75 74 69 6e 65 20 63 61 6e 20 62 65 20 75 routine can be u
27840 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 sed to access th
27850 65 0a 2a 2a 20 6b 65 79 20 61 6e 64 20 64 61 74 e.** key and dat
27860 61 20 77 69 74 68 6f 75 74 20 6d 61 6b 69 6e 67 a without making
27870 20 61 20 63 6f 70 79 2e 20 20 49 66 20 74 68 65 a copy. If the
27880 20 6b 65 79 20 61 6e 64 2f 6f 72 20 64 61 74 61 key and/or data
27890 20 73 70 69 6c 6c 73 0a 2a 2a 20 6f 6e 74 6f 20 spills.** onto
278a0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 overflow pages,
278b0 74 68 65 6e 20 61 63 63 65 73 73 50 61 79 6c 6f then accessPaylo
278c0 61 64 28 29 20 6d 75 73 74 20 62 65 20 75 73 65 ad() must be use
278d0 64 20 74 6f 20 72 65 61 73 73 65 6d 62 6c 65 0a d to reassemble.
278e0 2a 2a 20 74 68 65 20 6b 65 79 2f 64 61 74 61 20 ** the key/data
278f0 61 6e 64 20 63 6f 70 79 20 69 74 20 69 6e 74 6f and copy it into
27900 20 61 20 70 72 65 61 6c 6c 6f 63 61 74 65 64 20 a preallocated
27910 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 buffer..**.** Th
27920 65 20 70 6f 69 6e 74 65 72 20 72 65 74 75 72 6e e pointer return
27930 65 64 20 62 79 20 74 68 69 73 20 72 6f 75 74 69 ed by this routi
27940 6e 65 20 6c 6f 6f 6b 73 20 64 69 72 65 63 74 6c ne looks directl
27950 79 20 69 6e 74 6f 20 74 68 65 20 63 61 63 68 65 y into the cache
27960 64 0a 2a 2a 20 70 61 67 65 20 6f 66 20 74 68 65 d.** page of the
27970 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 65 20 database. The
27980 64 61 74 61 20 6d 69 67 68 74 20 63 68 61 6e 67 data might chang
27990 65 20 6f 72 20 6d 6f 76 65 20 74 68 65 20 6e 65 e or move the ne
279a0 78 74 20 74 69 6d 65 0a 2a 2a 20 61 6e 79 20 62 xt time.** any b
279b0 74 72 65 65 20 72 6f 75 74 69 6e 65 20 69 73 20 tree routine is
279c0 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
279d0 63 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 66 65 c const void *fe
279e0 74 63 68 50 61 79 6c 6f 61 64 28 0a 20 20 42 74 tchPayload(. Bt
279f0 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 Cursor *pCur,
27a00 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 70 6f 69 /* Cursor poi
27a10 6e 74 69 6e 67 20 74 6f 20 65 6e 74 72 79 20 74 nting to entry t
27a20 6f 20 72 65 61 64 20 66 72 6f 6d 20 2a 2f 0a 20 o read from */.
27a30 20 75 33 32 20 2a 70 41 6d 74 20 20 20 20 20 20 u32 *pAmt
27a40 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74 /* Write t
27a50 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 76 61 he number of ava
27a60 69 6c 61 62 6c 65 20 62 79 74 65 73 20 68 65 72 ilable bytes her
27a70 65 20 2a 2f 0a 29 7b 0a 20 20 75 33 32 20 61 6d e */.){. u32 am
27a80 74 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 t;. assert( pCu
27a90 72 21 3d 30 20 26 26 20 70 43 75 72 2d 3e 69 50 r!=0 && pCur->iP
27aa0 61 67 65 3e 3d 30 20 26 26 20 70 43 75 72 2d 3e age>=0 && pCur->
27ab0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
27ac0 67 65 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ge]);. assert(
27ad0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
27ae0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
27af0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
27b00 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
27b10 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
27b20 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
27b30 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
27b40 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
27b50 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 ssert( pCur->aiI
27b60 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c dx[pCur->iPage]<
27b70 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
27b80 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
27b90 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27ba0 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3e 30 ur->info.nSize>0
27bb0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27bc0 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 ur->info.pPayloa
27bd0 64 3e 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 d>pCur->apPage[p
27be0 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 61 44 61 Cur->iPage]->aDa
27bf0 74 61 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 ta || CORRUPT_DB
27c00 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27c10 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 ur->info.pPayloa
27c20 64 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 d<pCur->apPage[p
27c30 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 61 44 61 Cur->iPage]->aDa
27c40 74 61 45 6e 64 20 7c 7c 43 4f 52 52 55 50 54 5f taEnd ||CORRUPT_
27c50 44 42 29 3b 0a 20 20 61 6d 74 20 3d 20 28 69 6e DB);. amt = (in
27c60 74 29 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t)(pCur->apPage[
27c70 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 61 44 pCur->iPage]->aD
27c80 61 74 61 45 6e 64 20 2d 20 70 43 75 72 2d 3e 69 ataEnd - pCur->i
27c90 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 29 3b 0a 20 nfo.pPayload);.
27ca0 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e if( pCur->info.
27cb0 6e 4c 6f 63 61 6c 3c 61 6d 74 20 29 20 61 6d 74 nLocal<amt ) amt
27cc0 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c = pCur->info.nL
27cd0 6f 63 61 6c 3b 0a 20 20 2a 70 41 6d 74 20 3d 20 ocal;. *pAmt =
27ce0 61 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 28 76 amt;. return (v
27cf0 6f 69 64 2a 29 70 43 75 72 2d 3e 69 6e 66 6f 2e oid*)pCur->info.
27d00 70 50 61 79 6c 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a pPayload;.}.../*
27d10 0a 2a 2a 20 46 6f 72 20 74 68 65 20 65 6e 74 72 .** For the entr
27d20 79 20 74 68 61 74 20 63 75 72 73 6f 72 20 70 43 y that cursor pC
27d30 75 72 20 69 73 20 70 6f 69 6e 74 20 74 6f 2c 20 ur is point to,
27d40 72 65 74 75 72 6e 20 61 73 0a 2a 2a 20 6d 61 6e return as.** man
27d50 79 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 6b y bytes of the k
27d60 65 79 20 6f 72 20 64 61 74 61 20 61 73 20 61 72 ey or data as ar
27d70 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 74 e available on t
27d80 68 65 20 6c 6f 63 61 6c 0a 2a 2a 20 62 2d 74 72 he local.** b-tr
27d90 65 65 20 70 61 67 65 2e 20 20 57 72 69 74 65 20 ee page. Write
27da0 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 76 the number of av
27db0 61 69 6c 61 62 6c 65 20 62 79 74 65 73 20 69 6e ailable bytes in
27dc0 74 6f 20 2a 70 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 to *pAmt..**.**
27dd0 54 68 65 20 70 6f 69 6e 74 65 72 20 72 65 74 75 The pointer retu
27de0 72 6e 65 64 20 69 73 20 65 70 68 65 6d 65 72 61 rned is ephemera
27df0 6c 2e 20 20 54 68 65 20 6b 65 79 2f 64 61 74 61 l. The key/data
27e00 20 6d 61 79 20 6d 6f 76 65 0a 2a 2a 20 6f 72 20 may move.** or
27e10 62 65 20 64 65 73 74 72 6f 79 65 64 20 6f 6e 20 be destroyed on
27e20 74 68 65 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f the next call to
27e30 20 61 6e 79 20 42 74 72 65 65 20 72 6f 75 74 69 any Btree routi
27e40 6e 65 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 ne,.** including
27e50 20 63 61 6c 6c 73 20 66 72 6f 6d 20 6f 74 68 65 calls from othe
27e60 72 20 74 68 72 65 61 64 73 20 61 67 61 69 6e 73 r threads agains
27e70 74 20 74 68 65 20 73 61 6d 65 20 63 61 63 68 65 t the same cache
27e80 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20 61 20 6d 75 ..** Hence, a mu
27e90 74 65 78 20 6f 6e 20 74 68 65 20 42 74 53 68 61 tex on the BtSha
27ea0 72 65 64 20 73 68 6f 75 6c 64 20 62 65 20 68 65 red should be he
27eb0 6c 64 20 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c ld prior to call
27ec0 69 6e 67 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 ing.** this rout
27ed0 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 ine..**.** These
27ee0 20 72 6f 75 74 69 6e 65 73 20 69 73 20 75 73 65 routines is use
27ef0 64 20 74 6f 20 67 65 74 20 71 75 69 63 6b 20 61 d to get quick a
27f00 63 63 65 73 73 20 74 6f 20 6b 65 79 20 61 6e 64 ccess to key and
27f10 20 64 61 74 61 0a 2a 2a 20 69 6e 20 74 68 65 20 data.** in the
27f20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 common case wher
27f30 65 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 e no overflow pa
27f40 67 65 73 20 61 72 65 20 75 73 65 64 2e 0a 2a 2f ges are used..*/
27f50 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c .const void *sql
27f60 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 ite3BtreePayload
27f70 46 65 74 63 68 28 42 74 43 75 72 73 6f 72 20 2a Fetch(BtCursor *
27f80 70 43 75 72 2c 20 75 33 32 20 2a 70 41 6d 74 29 pCur, u32 *pAmt)
27f90 7b 0a 20 20 72 65 74 75 72 6e 20 66 65 74 63 68 {. return fetch
27fa0 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 Payload(pCur, pA
27fb0 6d 74 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d mt);.}.../*.** M
27fc0 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 64 ove the cursor d
27fd0 6f 77 6e 20 74 6f 20 61 20 6e 65 77 20 63 68 69 own to a new chi
27fe0 6c 64 20 70 61 67 65 2e 20 20 54 68 65 20 6e 65 ld page. The ne
27ff0 77 50 67 6e 6f 20 61 72 67 75 6d 65 6e 74 20 69 wPgno argument i
28000 73 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 6e 75 s the.** page nu
28010 6d 62 65 72 20 6f 66 20 74 68 65 20 63 68 69 6c mber of the chil
28020 64 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 74 d page to move t
28030 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 o..**.** This fu
28040 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 nction returns S
28050 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69 66 QLITE_CORRUPT if
28060 20 74 68 65 20 70 61 67 65 2d 68 65 61 64 65 72 the page-header
28070 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 0a flags field of.
28080 2a 2a 20 74 68 65 20 6e 65 77 20 63 68 69 6c 64 ** the new child
28090 20 70 61 67 65 20 64 6f 65 73 20 6e 6f 74 20 6d page does not m
280a0 61 74 63 68 20 74 68 65 20 66 6c 61 67 73 20 66 atch the flags f
280b0 69 65 6c 64 20 6f 66 20 74 68 65 20 70 61 72 65 ield of the pare
280c0 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 69 66 20 61 nt (i.e..** if a
280d0 6e 20 69 6e 74 6b 65 79 20 70 61 67 65 20 61 70 n intkey page ap
280e0 70 65 61 72 73 20 74 6f 20 62 65 20 74 68 65 20 pears to be the
280f0 70 61 72 65 6e 74 20 6f 66 20 61 20 6e 6f 6e 2d parent of a non-
28100 69 6e 74 6b 65 79 20 70 61 67 65 2c 20 6f 72 0a intkey page, or.
28110 2a 2a 20 76 69 63 65 2d 76 65 72 73 61 29 2e 0a ** vice-versa)..
28120 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f */.static int mo
28130 76 65 54 6f 43 68 69 6c 64 28 42 74 43 75 72 73 veToChild(BtCurs
28140 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6e 65 or *pCur, u32 ne
28150 77 50 67 6e 6f 29 7b 0a 20 20 42 74 53 68 61 72 wPgno){. BtShar
28160 65 64 20 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e ed *pBt = pCur->
28170 70 42 74 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 pBt;.. assert(
28180 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
28190 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
281a0 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
281b0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
281c0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
281d0 75 72 2d 3e 69 50 61 67 65 3c 42 54 43 55 52 53 ur->iPage<BTCURS
281e0 4f 52 5f 4d 41 58 5f 44 45 50 54 48 20 29 3b 0a OR_MAX_DEPTH );.
281f0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
28200 69 50 61 67 65 3e 3d 30 20 29 3b 0a 20 20 69 66 iPage>=0 );. if
28210 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 28 ( pCur->iPage>=(
28220 42 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 45 50 BTCURSOR_MAX_DEP
28230 54 48 2d 31 29 20 29 7b 0a 20 20 20 20 72 65 74 TH-1) ){. ret
28240 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
28250 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 70 PT_BKPT;. }. p
28260 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
28270 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 = 0;. pCur->cur
28280 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f Flags &= ~(BTCF_
28290 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 ValidNKey|BTCF_V
282a0 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 70 43 75 alidOvfl);. pCu
282b0 72 2d 3e 69 50 61 67 65 2b 2b 3b 0a 20 20 70 43 r->iPage++;. pC
282c0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
282d0 69 50 61 67 65 5d 20 3d 20 30 3b 0a 20 20 72 65 iPage] = 0;. re
282e0 74 75 72 6e 20 67 65 74 41 6e 64 49 6e 69 74 50 turn getAndInitP
282f0 61 67 65 28 70 42 74 2c 20 6e 65 77 50 67 6e 6f age(pBt, newPgno
28300 2c 20 26 70 43 75 72 2d 3e 61 70 50 61 67 65 5b , &pCur->apPage[
28310 70 43 75 72 2d 3e 69 50 61 67 65 5d 2c 0a 20 20 pCur->iPage],.
28320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28330 20 20 20 20 20 20 70 43 75 72 2c 20 70 43 75 72 pCur, pCur
28340 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 73 29 ->curPagerFlags)
28350 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ;.}..#ifdef SQLI
28360 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 50 TE_DEBUG./*.** P
28370 61 67 65 20 70 50 61 72 65 6e 74 20 69 73 20 61 age pParent is a
28380 6e 20 69 6e 74 65 72 6e 61 6c 20 28 6e 6f 6e 2d n internal (non-
28390 6c 65 61 66 29 20 74 72 65 65 20 70 61 67 65 2e leaf) tree page.
283a0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 0a This function .
283b0 2a 2a 20 61 73 73 65 72 74 73 20 74 68 61 74 20 ** asserts that
283c0 70 61 67 65 20 6e 75 6d 62 65 72 20 69 43 68 69 page number iChi
283d0 6c 64 20 69 73 20 74 68 65 20 6c 65 66 74 2d 63 ld is the left-c
283e0 68 69 6c 64 20 69 66 20 74 68 65 20 69 49 64 78 hild if the iIdx
283f0 27 74 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 70 'th.** cell in p
28400 61 67 65 20 70 50 61 72 65 6e 74 2e 20 4f 72 2c age pParent. Or,
28410 20 69 66 20 69 49 64 78 20 69 73 20 65 71 75 61 if iIdx is equa
28420 6c 20 74 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e l to the total n
28430 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 65 6c 6c umber of.** cell
28440 73 20 69 6e 20 70 50 61 72 65 6e 74 2c 20 74 68 s in pParent, th
28450 61 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 at page number i
28460 43 68 69 6c 64 20 69 73 20 74 68 65 20 72 69 67 Child is the rig
28470 68 74 2d 63 68 69 6c 64 20 6f 66 0a 2a 2a 20 74 ht-child of.** t
28480 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 he page..*/.stat
28490 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 50 61 ic void assertPa
284a0 72 65 6e 74 49 6e 64 65 78 28 4d 65 6d 50 61 67 rentIndex(MemPag
284b0 65 20 2a 70 50 61 72 65 6e 74 2c 20 69 6e 74 20 e *pParent, int
284c0 69 49 64 78 2c 20 50 67 6e 6f 20 69 43 68 69 6c iIdx, Pgno iChil
284d0 64 29 7b 0a 20 20 69 66 28 20 43 4f 52 52 55 50 d){. if( CORRUP
284e0 54 5f 44 42 20 29 20 72 65 74 75 72 6e 3b 20 20 T_DB ) return;
284f0 2f 2a 20 54 68 65 20 63 6f 6e 64 69 74 69 6f 6e /* The condition
28500 73 20 74 65 73 74 65 64 20 62 65 6c 6f 77 20 6d s tested below m
28510 69 67 68 74 20 6e 6f 74 20 62 65 20 74 72 75 65 ight not be true
28520 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
28530 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 **
28540 69 6e 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 in a corrupt dat
28550 61 62 61 73 65 20 2a 2f 0a 20 20 61 73 73 65 72 abase */. asser
28560 74 28 20 69 49 64 78 3c 3d 70 50 61 72 65 6e 74 t( iIdx<=pParent
28570 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 69 66 28 ->nCell );. if(
28580 20 69 49 64 78 3d 3d 70 50 61 72 65 6e 74 2d 3e iIdx==pParent->
28590 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 61 73 73 nCell ){. ass
285a0 65 72 74 28 20 67 65 74 34 62 79 74 65 28 26 70 ert( get4byte(&p
285b0 50 61 72 65 6e 74 2d 3e 61 44 61 74 61 5b 70 50 Parent->aData[pP
285c0 61 72 65 6e 74 2d 3e 68 64 72 4f 66 66 73 65 74 arent->hdrOffset
285d0 2b 38 5d 29 3d 3d 69 43 68 69 6c 64 20 29 3b 0a +8])==iChild );.
285e0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 }else{. ass
285f0 65 72 74 28 20 67 65 74 34 62 79 74 65 28 66 69 ert( get4byte(fi
28600 6e 64 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 ndCell(pParent,
28610 69 49 64 78 29 29 3d 3d 69 43 68 69 6c 64 20 29 iIdx))==iChild )
28620 3b 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 0a 23 20 ;. }.}.#else.#
28630 20 64 65 66 69 6e 65 20 61 73 73 65 72 74 50 61 define assertPa
28640 72 65 6e 74 49 6e 64 65 78 28 78 2c 79 2c 7a 29 rentIndex(x,y,z)
28650 20 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 .#endif../*.**
28660 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 Move the cursor
28670 75 70 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 up to the parent
28680 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 page..**.** pCu
28690 72 2d 3e 69 64 78 20 69 73 20 73 65 74 20 74 6f r->idx is set to
286a0 20 74 68 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 the cell index
286b0 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
286c0 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 e pointer.** to
286d0 74 68 65 20 70 61 67 65 20 77 65 20 61 72 65 20 the page we are
286e0 63 6f 6d 69 6e 67 20 66 72 6f 6d 2e 20 20 49 66 coming from. If
286f0 20 77 65 20 61 72 65 20 63 6f 6d 69 6e 67 20 66 we are coming f
28700 72 6f 6d 20 74 68 65 0a 2a 2a 20 72 69 67 68 74 rom the.** right
28710 2d 6d 6f 73 74 20 63 68 69 6c 64 20 70 61 67 65 -most child page
28720 20 74 68 65 6e 20 70 43 75 72 2d 3e 69 64 78 20 then pCur->idx
28730 69 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 6d 6f is set to one mo
28740 72 65 20 74 68 61 6e 0a 2a 2a 20 74 68 65 20 6c re than.** the l
28750 61 72 67 65 73 74 20 63 65 6c 6c 20 69 6e 64 65 argest cell inde
28760 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 x..*/.static voi
28770 64 20 6d 6f 76 65 54 6f 50 61 72 65 6e 74 28 42 d moveToParent(B
28780 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
28790 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
287a0 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
287b0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
287c0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
287d0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
287e0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 assert( pCur->iP
287f0 61 67 65 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 age>0 );. asser
28800 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t( pCur->apPage[
28810 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a pCur->iPage] );.
28820 20 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e assertParentIn
28830 64 65 78 28 0a 20 20 20 20 70 43 75 72 2d 3e 61 dex(. pCur->a
28840 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
28850 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d e-1], . pCur-
28860 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
28870 67 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 ge-1], . pCur
28880 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
28890 50 61 67 65 5d 2d 3e 70 67 6e 6f 0a 20 20 29 3b Page]->pgno. );
288a0 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 43 75 . testcase( pCu
288b0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
288c0 50 61 67 65 2d 31 5d 20 3e 20 70 43 75 72 2d 3e Page-1] > pCur->
288d0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
288e0 67 65 2d 31 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a ge-1]->nCell );.
288f0 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 pCur->info.nSi
28900 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ze = 0;. pCur->
28910 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 curFlags &= ~(BT
28920 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 CF_ValidNKey|BTC
28930 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 F_ValidOvfl);.
28940 72 65 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 releasePageNotNu
28950 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b ll(pCur->apPage[
28960 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 5d 29 3b pCur->iPage--]);
28970 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 .}../*.** Move t
28980 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f 69 he cursor to poi
28990 6e 74 20 74 6f 20 74 68 65 20 72 6f 6f 74 20 70 nt to the root p
289a0 61 67 65 20 6f 66 20 69 74 73 20 62 2d 74 72 65 age of its b-tre
289b0 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a e structure..**.
289c0 2a 2a 20 49 66 20 74 68 65 20 74 61 62 6c 65 20 ** If the table
289d0 68 61 73 20 61 20 76 69 72 74 75 61 6c 20 72 6f has a virtual ro
289e0 6f 74 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 ot page, then th
289f0 65 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 65 e cursor is move
28a00 64 20 74 6f 20 70 6f 69 6e 74 0a 2a 2a 20 74 6f d to point.** to
28a10 20 74 68 65 20 76 69 72 74 75 61 6c 20 72 6f 6f the virtual roo
28a20 74 20 70 61 67 65 20 69 6e 73 74 65 61 64 20 6f t page instead o
28a30 66 20 74 68 65 20 61 63 74 75 61 6c 20 72 6f 6f f the actual roo
28a40 74 20 70 61 67 65 2e 20 41 20 74 61 62 6c 65 20 t page. A table
28a50 68 61 73 20 61 0a 2a 2a 20 76 69 72 74 75 61 6c has a.** virtual
28a60 20 72 6f 6f 74 20 70 61 67 65 20 77 68 65 6e 20 root page when
28a70 74 68 65 20 61 63 74 75 61 6c 20 72 6f 6f 74 20 the actual root
28a80 70 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f page contains no
28a90 20 63 65 6c 6c 73 20 61 6e 64 20 61 20 0a 2a 2a cells and a .**
28aa0 20 73 69 6e 67 6c 65 20 63 68 69 6c 64 20 70 61 single child pa
28ab0 67 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c ge. This can onl
28ac0 79 20 68 61 70 70 65 6e 20 77 69 74 68 20 74 68 y happen with th
28ad0 65 20 74 61 62 6c 65 20 72 6f 6f 74 65 64 20 61 e table rooted a
28ae0 74 20 70 61 67 65 20 31 2e 0a 2a 2a 0a 2a 2a 20 t page 1..**.**
28af0 49 66 20 74 68 65 20 62 2d 74 72 65 65 20 73 74 If the b-tree st
28b00 72 75 63 74 75 72 65 20 69 73 20 65 6d 70 74 79 ructure is empty
28b10 2c 20 74 68 65 20 63 75 72 73 6f 72 20 73 74 61 , the cursor sta
28b20 74 65 20 69 73 20 73 65 74 20 74 6f 20 0a 2a 2a te is set to .**
28b30 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 2e CURSOR_INVALID.
28b40 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 Otherwise, the
28b50 63 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 6f cursor is set to
28b60 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 69 point to the fi
28b70 72 73 74 0a 2a 2a 20 63 65 6c 6c 20 6c 6f 63 61 rst.** cell loca
28b80 74 65 64 20 6f 6e 20 74 68 65 20 72 6f 6f 74 20 ted on the root
28b90 28 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 (or virtual root
28ba0 29 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 63 ) page and the c
28bb0 75 72 73 6f 72 20 73 74 61 74 65 0a 2a 2a 20 69 ursor state.** i
28bc0 73 20 73 65 74 20 74 6f 20 43 55 52 53 4f 52 5f s set to CURSOR_
28bd0 56 41 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 VALID..**.** If
28be0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 this function re
28bf0 74 75 72 6e 73 20 73 75 63 63 65 73 73 66 75 6c turns successful
28c00 6c 79 2c 20 69 74 20 6d 61 79 20 62 65 20 61 73 ly, it may be as
28c10 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 0a 2a sumed that the.*
28c20 2a 20 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c * page-header fl
28c30 61 67 73 20 69 6e 64 69 63 61 74 65 20 74 68 61 ags indicate tha
28c40 74 20 74 68 65 20 5b 76 69 72 74 75 61 6c 5d 20 t the [virtual]
28c50 72 6f 6f 74 2d 70 61 67 65 20 69 73 20 74 68 65 root-page is the
28c60 20 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 6b 69 expected .** ki
28c70 6e 64 20 6f 66 20 62 2d 74 72 65 65 20 70 61 67 nd of b-tree pag
28c80 65 20 28 69 2e 65 2e 20 69 66 20 77 68 65 6e 20 e (i.e. if when
28c90 6f 70 65 6e 69 6e 67 20 74 68 65 20 63 75 72 73 opening the curs
28ca0 6f 72 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 or the caller di
28cb0 64 20 6e 6f 74 0a 2a 2a 20 73 70 65 63 69 66 79 d not.** specify
28cc0 20 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 a KeyInfo struc
28cd0 74 75 72 65 20 74 68 65 20 66 6c 61 67 73 20 62 ture the flags b
28ce0 79 74 65 20 69 73 20 73 65 74 20 74 6f 20 30 78 yte is set to 0x
28cf0 30 35 20 6f 72 20 30 78 30 44 2c 0a 2a 2a 20 69 05 or 0x0D,.** i
28d00 6e 64 69 63 61 74 69 6e 67 20 61 20 74 61 62 6c ndicating a tabl
28d10 65 20 62 2d 74 72 65 65 2c 20 6f 72 20 69 66 20 e b-tree, or if
28d20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 73 the caller did s
28d30 70 65 63 69 66 79 20 61 20 4b 65 79 49 6e 66 6f pecify a KeyInfo
28d40 20 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 74 .** structure t
28d50 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 69 73 he flags byte is
28d60 20 73 65 74 20 74 6f 20 30 78 30 32 20 6f 72 20 set to 0x02 or
28d70 30 78 30 41 2c 20 69 6e 64 69 63 61 74 69 6e 67 0x0A, indicating
28d80 20 61 6e 20 69 6e 64 65 78 0a 2a 2a 20 62 2d 74 an index.** b-t
28d90 72 65 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ree)..*/.static
28da0 69 6e 74 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 42 int moveToRoot(B
28db0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
28dc0 20 20 4d 65 6d 50 61 67 65 20 2a 70 52 6f 6f 74 MemPage *pRoot
28dd0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
28de0 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
28df0 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
28e00 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
28e10 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f assert( CURSOR_
28e20 49 4e 56 41 4c 49 44 20 3c 20 43 55 52 53 4f 52 INVALID < CURSOR
28e30 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a _REQUIRESEEK );.
28e40 20 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 assert( CURSOR
28e50 5f 56 41 4c 49 44 20 20 20 3c 20 43 55 52 53 4f _VALID < CURSO
28e60 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b R_REQUIRESEEK );
28e70 0a 20 20 61 73 73 65 72 74 28 20 43 55 52 53 4f . assert( CURSO
28e80 52 5f 46 41 55 4c 54 20 20 20 3e 20 43 55 52 53 R_FAULT > CURS
28e90 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 OR_REQUIRESEEK )
28ea0 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 ;. if( pCur->eS
28eb0 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
28ec0 55 49 52 45 53 45 45 4b 20 29 7b 0a 20 20 20 20 UIRESEEK ){.
28ed0 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
28ee0 3d 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 ==CURSOR_FAULT )
28ef0 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
28f00 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d pCur->skipNext!=
28f10 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 SQLITE_OK );.
28f20 20 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e return pCur->
28f30 73 6b 69 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a skipNext;. }.
28f40 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
28f50 43 6c 65 61 72 43 75 72 73 6f 72 28 70 43 75 72 ClearCursor(pCur
28f60 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 );. }.. if( pC
28f70 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 29 7b 0a ur->iPage>=0 ){.
28f80 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 if( pCur->iP
28f90 61 67 65 20 29 7b 0a 20 20 20 20 20 20 64 6f 7b age ){. do{
28fa0 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
28fb0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
28fc0 75 72 2d 3e 69 50 61 67 65 5d 21 3d 30 20 29 3b ur->iPage]!=0 );
28fd0 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 . release
28fe0 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 43 75 72 PageNotNull(pCur
28ff0 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
29000 50 61 67 65 2d 2d 5d 29 3b 0a 20 20 20 20 20 20 Page--]);.
29010 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 69 50 }while( pCur->iP
29020 61 67 65 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f age);. goto
29030 20 73 6b 69 70 5f 69 6e 69 74 3b 0a 20 20 20 20 skip_init;.
29040 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 }. }else if( pC
29050 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
29060 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
29070 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
29080 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 75 72 6e ALID;. return
29090 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
290a0 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 lse{. assert(
290b0 20 70 43 75 72 2d 3e 69 50 61 67 65 3d 3d 28 2d pCur->iPage==(-
290c0 31 29 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 67 1) );. rc = g
290d0 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 43 etAndInitPage(pC
290e0 75 72 2d 3e 70 42 74 72 65 65 2d 3e 70 42 74 2c ur->pBtree->pBt,
290f0 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 2c pCur->pgnoRoot,
29100 20 26 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 &pCur->apPage[0
29110 5d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ],.
29120 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 70 43 0, pC
29130 75 72 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 ur->curPagerFlag
29140 73 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d s);. if( rc!=
29150 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
29160 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
29170 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
29180 3b 0a 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 ;. return
29190 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 rc;. }. pC
291a0 75 72 2d 3e 69 50 61 67 65 20 3d 20 30 3b 0a 20 ur->iPage = 0;.
291b0 20 20 20 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b pCur->curIntK
291c0 65 79 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ey = pCur->apPag
291d0 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 3b 0a 20 20 e[0]->intKey;.
291e0 7d 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 }. pRoot = pCur
291f0 2d 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 20 61 ->apPage[0];. a
29200 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 70 67 ssert( pRoot->pg
29210 6e 6f 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 6f no==pCur->pgnoRo
29220 6f 74 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 ot );.. /* If p
29230 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 69 73 Cur->pKeyInfo is
29240 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 not NULL, then
29250 74 68 65 20 63 61 6c 6c 65 72 20 74 68 61 74 20 the caller that
29260 6f 70 65 6e 65 64 20 74 68 69 73 20 63 75 72 73 opened this curs
29270 6f 72 0a 20 20 2a 2a 20 65 78 70 65 63 74 65 64 or. ** expected
29280 20 74 6f 20 6f 70 65 6e 20 69 74 20 6f 6e 20 61 to open it on a
29290 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 2e 20 n index b-tree.
292a0 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 4b Otherwise, if pK
292b0 65 79 49 6e 66 6f 20 69 73 0a 20 20 2a 2a 20 4e eyInfo is. ** N
292c0 55 4c 4c 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 ULL, the caller
292d0 65 78 70 65 63 74 73 20 61 20 74 61 62 6c 65 20 expects a table
292e0 62 2d 74 72 65 65 2e 20 49 66 20 74 68 69 73 20 b-tree. If this
292f0 69 73 20 6e 6f 74 20 74 68 65 20 63 61 73 65 2c is not the case,
29300 0a 20 20 2a 2a 20 72 65 74 75 72 6e 20 61 6e 20 . ** return an
29310 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 65 SQLITE_CORRUPT e
29320 72 72 6f 72 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a rror. . **. **
29330 20 45 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e Earlier version
29340 73 20 6f 66 20 53 51 4c 69 74 65 20 61 73 73 75 s of SQLite assu
29350 6d 65 64 20 74 68 61 74 20 74 68 69 73 20 74 65 med that this te
29360 73 74 20 63 6f 75 6c 64 20 6e 6f 74 20 66 61 69 st could not fai
29370 6c 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 72 6f l. ** if the ro
29380 6f 74 20 70 61 67 65 20 77 61 73 20 61 6c 72 65 ot page was alre
29390 61 64 79 20 6c 6f 61 64 65 64 20 77 68 65 6e 20 ady loaded when
293a0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 61 this function wa
293b0 73 20 63 61 6c 6c 65 64 20 28 69 2e 65 2e 0a 20 s called (i.e..
293c0 20 2a 2a 20 69 66 20 70 43 75 72 2d 3e 69 50 61 ** if pCur->iPa
293d0 67 65 3e 3d 30 29 2e 20 42 75 74 20 74 68 69 73 ge>=0). But this
293e0 20 69 73 20 6e 6f 74 20 73 6f 20 69 66 20 74 68 is not so if th
293f0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6f e database is co
29400 72 72 75 70 74 65 64 20 0a 20 20 2a 2a 20 69 6e rrupted . ** in
29410 20 73 75 63 68 20 61 20 77 61 79 20 74 68 61 74 such a way that
29420 20 70 61 67 65 20 70 52 6f 6f 74 20 69 73 20 6c page pRoot is l
29430 69 6e 6b 65 64 20 69 6e 74 6f 20 61 20 73 65 63 inked into a sec
29440 6f 6e 64 20 62 2d 74 72 65 65 20 74 61 62 6c 65 ond b-tree table
29450 20 0a 20 20 2a 2a 20 28 6f 72 20 74 68 65 20 66 . ** (or the f
29460 72 65 65 6c 69 73 74 29 2e 20 20 2a 2f 0a 20 20 reelist). */.
29470 61 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 69 assert( pRoot->i
29480 6e 74 4b 65 79 3d 3d 31 20 7c 7c 20 70 52 6f 6f ntKey==1 || pRoo
29490 74 2d 3e 69 6e 74 4b 65 79 3d 3d 30 20 29 3b 0a t->intKey==0 );.
294a0 20 20 69 66 28 20 70 52 6f 6f 74 2d 3e 69 73 49 if( pRoot->isI
294b0 6e 69 74 3d 3d 30 20 7c 7c 20 28 70 43 75 72 2d nit==0 || (pCur-
294c0 3e 70 4b 65 79 49 6e 66 6f 3d 3d 30 29 21 3d 70 >pKeyInfo==0)!=p
294d0 52 6f 6f 74 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a Root->intKey ){.
294e0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
294f0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
29500 20 20 7d 0a 0a 73 6b 69 70 5f 69 6e 69 74 3a 20 }..skip_init:
29510 20 0a 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b . pCur->aiIdx[
29520 30 5d 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 0] = 0;. pCur->
29530 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
29540 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
29550 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c 61 73 &= ~(BTCF_AtLas
29560 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 t|BTCF_ValidNKey
29570 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 |BTCF_ValidOvfl)
29580 3b 0a 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 ;.. pRoot = pCu
29590 72 2d 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 20 r->apPage[0];.
295a0 69 66 28 20 70 52 6f 6f 74 2d 3e 6e 43 65 6c 6c if( pRoot->nCell
295b0 3e 30 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e >0 ){. pCur->
295c0 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f eState = CURSOR_
295d0 56 41 4c 49 44 3b 0a 20 20 7d 65 6c 73 65 20 69 VALID;. }else i
295e0 66 28 20 21 70 52 6f 6f 74 2d 3e 6c 65 61 66 20 f( !pRoot->leaf
295f0 29 7b 0a 20 20 20 20 50 67 6e 6f 20 73 75 62 70 ){. Pgno subp
29600 61 67 65 3b 0a 20 20 20 20 69 66 28 20 70 52 6f age;. if( pRo
29610 6f 74 2d 3e 70 67 6e 6f 21 3d 31 20 29 20 72 65 ot->pgno!=1 ) re
29620 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
29630 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 73 75 UPT_BKPT;. su
29640 62 70 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 bpage = get4byte
29650 28 26 70 52 6f 6f 74 2d 3e 61 44 61 74 61 5b 70 (&pRoot->aData[p
29660 52 6f 6f 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b Root->hdrOffset+
29670 38 5d 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 8]);. pCur->e
29680 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 State = CURSOR_V
29690 41 4c 49 44 3b 0a 20 20 20 20 72 63 20 3d 20 6d ALID;. rc = m
296a0 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c oveToChild(pCur,
296b0 20 73 75 62 70 61 67 65 29 3b 0a 20 20 7d 65 6c subpage);. }el
296c0 73 65 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 se{. pCur->eS
296d0 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
296e0 56 41 4c 49 44 3b 0a 20 20 7d 0a 20 20 72 65 74 VALID;. }. ret
296f0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
29700 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 Move the cursor
29710 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 6c 65 66 down to the lef
29720 74 2d 6d 6f 73 74 20 6c 65 61 66 20 65 6e 74 72 t-most leaf entr
29730 79 20 62 65 6e 65 61 74 68 20 74 68 65 0a 2a 2a y beneath the.**
29740 20 65 6e 74 72 79 20 74 6f 20 77 68 69 63 68 20 entry to which
29750 69 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 it is currently
29760 70 6f 69 6e 74 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 pointing..**.**
29770 54 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 The left-most le
29780 61 66 20 69 73 20 74 68 65 20 6f 6e 65 20 77 69 af is the one wi
29790 74 68 20 74 68 65 20 73 6d 61 6c 6c 65 73 74 20 th the smallest
297a0 6b 65 79 20 2d 20 74 68 65 20 66 69 72 73 74 0a key - the first.
297b0 2a 2a 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 ** in ascending
297c0 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 order..*/.static
297d0 20 69 6e 74 20 6d 6f 76 65 54 6f 4c 65 66 74 6d int moveToLeftm
297e0 6f 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 ost(BtCursor *pC
297f0 75 72 29 7b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f ur){. Pgno pgno
29800 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
29810 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 6d 50 61 67 ITE_OK;. MemPag
29820 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 61 73 73 e *pPage;.. ass
29830 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 ert( cursorOwnsB
29840 74 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b tShared(pCur) );
29850 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
29860 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
29870 56 41 4c 49 44 20 29 3b 0a 20 20 77 68 69 6c 65 VALID );. while
29880 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
29890 26 26 20 21 28 70 50 61 67 65 20 3d 20 70 43 75 && !(pPage = pCu
298a0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
298b0 69 50 61 67 65 5d 29 2d 3e 6c 65 61 66 20 29 7b iPage])->leaf ){
298c0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
298d0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
298e0 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e 6e 43 65 Page]<pPage->nCe
298f0 6c 6c 20 29 3b 0a 20 20 20 20 70 67 6e 6f 20 3d ll );. pgno =
29900 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 get4byte(findCe
29910 6c 6c 28 70 50 61 67 65 2c 20 70 43 75 72 2d 3e ll(pPage, pCur->
29920 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
29930 65 5d 29 29 3b 0a 20 20 20 20 72 63 20 3d 20 6d e]));. rc = m
29940 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c oveToChild(pCur,
29950 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 pgno);. }. re
29960 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
29970 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f * Move the curso
29980 72 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 72 69 r down to the ri
29990 67 68 74 2d 6d 6f 73 74 20 6c 65 61 66 20 65 6e ght-most leaf en
299a0 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 0a try beneath the.
299b0 2a 2a 20 70 61 67 65 20 74 6f 20 77 68 69 63 68 ** page to which
299c0 20 69 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 it is currently
299d0 20 70 6f 69 6e 74 69 6e 67 2e 20 20 4e 6f 74 69 pointing. Noti
299e0 63 65 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 ce the differenc
299f0 65 0a 2a 2a 20 62 65 74 77 65 65 6e 20 6d 6f 76 e.** between mov
29a00 65 54 6f 4c 65 66 74 6d 6f 73 74 28 29 20 61 6e eToLeftmost() an
29a10 64 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 d moveToRightmos
29a20 74 28 29 2e 20 20 6d 6f 76 65 54 6f 4c 65 66 74 t(). moveToLeft
29a30 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 most().** finds
29a40 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 65 6e the left-most en
29a50 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 20 try beneath the
29a60 2a 65 6e 74 72 79 2a 20 77 68 65 72 65 61 73 20 *entry* whereas
29a70 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 moveToRightmost(
29a80 29 0a 2a 2a 20 66 69 6e 64 73 20 74 68 65 20 72 ).** finds the r
29a90 69 67 68 74 2d 6d 6f 73 74 20 65 6e 74 72 79 20 ight-most entry
29aa0 62 65 6e 65 61 74 68 20 74 68 65 20 2a 70 61 67 beneath the *pag
29ab0 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72 69 e*..**.** The ri
29ac0 67 68 74 2d 6d 6f 73 74 20 65 6e 74 72 79 20 69 ght-most entry i
29ad0 73 20 74 68 65 20 6f 6e 65 20 77 69 74 68 20 74 s the one with t
29ae0 68 65 20 6c 61 72 67 65 73 74 20 6b 65 79 20 2d he largest key -
29af0 20 74 68 65 20 6c 61 73 74 0a 2a 2a 20 6b 65 79 the last.** key
29b00 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 in ascending or
29b10 64 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 der..*/.static i
29b20 6e 74 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f nt moveToRightmo
29b30 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 st(BtCursor *pCu
29b40 72 29 7b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b r){. Pgno pgno;
29b50 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
29b60 54 45 5f 4f 4b 3b 0a 20 20 4d 65 6d 50 61 67 65 TE_OK;. MemPage
29b70 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 *pPage = 0;..
29b80 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f 77 assert( cursorOw
29b90 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 29 nsBtShared(pCur)
29ba0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
29bb0 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
29bc0 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 77 68 OR_VALID );. wh
29bd0 69 6c 65 28 20 21 28 70 50 61 67 65 20 3d 20 70 ile( !(pPage = p
29be0 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
29bf0 2d 3e 69 50 61 67 65 5d 29 2d 3e 6c 65 61 66 20 ->iPage])->leaf
29c00 29 7b 0a 20 20 20 20 70 67 6e 6f 20 3d 20 67 65 ){. pgno = ge
29c10 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 t4byte(&pPage->a
29c20 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f Data[pPage->hdrO
29c30 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 ffset+8]);. p
29c40 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
29c50 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 67 65 2d >iPage] = pPage-
29c60 3e 6e 43 65 6c 6c 3b 0a 20 20 20 20 72 63 20 3d >nCell;. rc =
29c70 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 moveToChild(pCu
29c80 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 69 66 r, pgno);. if
29c90 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
29ca0 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 61 69 ;. }. pCur->ai
29cb0 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
29cc0 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d = pPage->nCell-
29cd0 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 1;. assert( pCu
29ce0 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
29cf0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 );. assert( (p
29d00 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 Cur->curFlags &
29d10 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 3d BTCF_ValidNKey)=
29d20 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 =0 );. return S
29d30 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 QLITE_OK;.}../*
29d40 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 Move the cursor
29d50 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 to the first ent
29d60 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e ry in the table.
29d70 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f Return SQLITE_
29d80 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 73 73 OK.** on success
29d90 2e 20 20 53 65 74 20 2a 70 52 65 73 20 74 6f 20 . Set *pRes to
29da0 30 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 0 if the cursor
29db0 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e 74 73 20 actually points
29dc0 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 to something.**
29dd0 6f 72 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 or set *pRes to
29de0 31 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 1 if the table i
29df0 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 20 s empty..*/.int
29e00 73 71 6c 69 74 65 33 42 74 72 65 65 46 69 72 73 sqlite3BtreeFirs
29e10 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 t(BtCursor *pCur
29e20 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 , int *pRes){.
29e30 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
29e40 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
29e50 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
29e60 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
29e70 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 _mutex_held(pCur
29e80 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 ->pBtree->db->mu
29e90 74 65 78 29 20 29 3b 0a 20 20 72 63 20 3d 20 6d tex) );. rc = m
29ea0 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b oveToRoot(pCur);
29eb0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
29ec0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
29ed0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
29ee0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a RSOR_INVALID ){.
29ef0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 assert( pC
29f00 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
29f10 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b || pCur->apPage[
29f20 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
29f30 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ell==0 );.
29f40 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d *pRes = 1;. }
29f50 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 else{. asse
29f60 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 rt( pCur->apPage
29f70 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
29f80 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 20 20 Cell>0 );.
29f90 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 *pRes = 0;.
29fa0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 74 rc = moveToLeft
29fb0 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 most(pCur);.
29fc0 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
29fd0 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 c;.}../* Move th
29fe0 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 e cursor to the
29ff0 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 last entry in th
2a000 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e e table. Return
2a010 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e SQLITE_OK.** on
2a020 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a success. Set *
2a030 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 pRes to 0 if the
2a040 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 cursor actually
2a050 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 points to somet
2a060 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a hing.** or set *
2a070 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 pRes to 1 if the
2a080 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e table is empty.
2a090 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
2a0a0 74 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 6f treeLast(BtCurso
2a0b0 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
2a0c0 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 es){. int rc;.
2a0d0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
2a0e0 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
2a0f0 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
2a100 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2a110 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 eld(pCur->pBtree
2a120 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
2a130 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 . /* If the cur
2a140 73 6f 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e sor already poin
2a150 74 73 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 ts to the last e
2a160 6e 74 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 ntry, this is a
2a170 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 no-op. */. if(
2a180 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 CURSOR_VALID==pC
2a190 75 72 2d 3e 65 53 74 61 74 65 20 26 26 20 28 70 ur->eState && (p
2a1a0 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 Cur->curFlags &
2a1b0 42 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 BTCF_AtLast)!=0
2a1c0 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
2a1d0 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 _DEBUG. /* Th
2a1e0 69 73 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 is block serves
2a1f0 74 6f 20 61 73 73 65 72 74 28 29 20 74 68 61 74 to assert() that
2a200 20 74 68 65 20 63 75 72 73 6f 72 20 72 65 61 6c the cursor real
2a210 6c 79 20 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 ly does point .
2a220 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 ** to the las
2a230 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 62 t entry in the b
2a240 2d 74 72 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e -tree. */. in
2a250 74 20 69 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 t ii;. for(ii
2a260 3d 30 3b 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 =0; ii<pCur->iPa
2a270 67 65 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 ge; ii++){.
2a280 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
2a290 69 49 64 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e iIdx[ii]==pCur->
2a2a0 61 70 50 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c apPage[ii]->nCel
2a2b0 6c 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 l );. }. a
2a2c0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 ssert( pCur->aiI
2a2d0 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d dx[pCur->iPage]=
2a2e0 3d 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 =pCur->apPage[pC
2a2f0 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c ur->iPage]->nCel
2a300 6c 2d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 l-1 );. asser
2a310 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t( pCur->apPage[
2a320 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 pCur->iPage]->le
2a330 61 66 20 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 af );.#endif.
2a340 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2a350 4b 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d K;. }.. rc = m
2a360 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b oveToRoot(pCur);
2a370 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2a380 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
2a390 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d CURSOR_INVALID==
2a3a0 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a pCur->eState ){.
2a3b0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 assert( pC
2a3c0 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
2a3d0 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b || pCur->apPage[
2a3e0 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 pCur->iPage]->nC
2a3f0 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ell==0 );.
2a400 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 7d *pRes = 1;. }
2a410 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 else{. asse
2a420 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
2a430 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
2a440 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
2a450 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 0;. rc = mo
2a460 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 veToRightmost(pC
2a470 75 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 ur);. if( r
2a480 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
2a490 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 pCur->cu
2a4a0 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 41 rFlags |= BTCF_A
2a4b0 74 4c 61 73 74 3b 0a 20 20 20 20 20 20 7d 65 6c tLast;. }el
2a4c0 73 65 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 se{. pCur
2a4d0 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 ->curFlags &= ~B
2a4e0 54 43 46 5f 41 74 4c 61 73 74 3b 0a 20 20 20 20 TCF_AtLast;.
2a4f0 20 20 7d 0a 20 20 20 0a 20 20 20 20 7d 0a 20 20 }. . }.
2a500 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
2a510 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 ../* Move the cu
2a520 72 73 6f 72 20 73 6f 20 74 68 61 74 20 69 74 20 rsor so that it
2a530 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 6e 74 points to an ent
2a540 72 79 20 6e 65 61 72 20 74 68 65 20 6b 65 79 20 ry near the key
2a550 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 62 79 .** specified by
2a560 20 70 49 64 78 4b 65 79 20 6f 72 20 69 6e 74 4b pIdxKey or intK
2a570 65 79 2e 20 20 20 52 65 74 75 72 6e 20 61 20 73 ey. Return a s
2a580 75 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a 2a 0a uccess code..**.
2a590 2a 2a 20 46 6f 72 20 49 4e 54 4b 45 59 20 74 61 ** For INTKEY ta
2a5a0 62 6c 65 73 2c 20 74 68 65 20 69 6e 74 4b 65 79 bles, the intKey
2a5b0 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 75 73 parameter is us
2a5c0 65 64 2e 20 20 70 49 64 78 4b 65 79 20 0a 2a 2a ed. pIdxKey .**
2a5d0 20 6d 75 73 74 20 62 65 20 4e 55 4c 4c 2e 20 20 must be NULL.
2a5e0 46 6f 72 20 69 6e 64 65 78 20 74 61 62 6c 65 73 For index tables
2a5f0 2c 20 70 49 64 78 4b 65 79 20 69 73 20 75 73 65 , pIdxKey is use
2a600 64 20 61 6e 64 20 69 6e 74 4b 65 79 0a 2a 2a 20 d and intKey.**
2a610 69 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a 0a 2a is ignored..**.*
2a620 2a 20 49 66 20 61 6e 20 65 78 61 63 74 20 6d 61 * If an exact ma
2a630 74 63 68 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 tch is not found
2a640 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
2a650 72 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 6c r is always.** l
2a660 65 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 eft pointing at
2a670 61 20 6c 65 61 66 20 70 61 67 65 20 77 68 69 63 a leaf page whic
2a680 68 20 77 6f 75 6c 64 20 68 6f 6c 64 20 74 68 65 h would hold the
2a690 20 65 6e 74 72 79 20 69 66 20 69 74 0a 2a 2a 20 entry if it.**
2a6a0 77 65 72 65 20 70 72 65 73 65 6e 74 2e 20 20 54 were present. T
2a6b0 68 65 20 63 75 72 73 6f 72 20 6d 69 67 68 74 20 he cursor might
2a6c0 70 6f 69 6e 74 20 74 6f 20 61 6e 20 65 6e 74 72 point to an entr
2a6d0 79 20 74 68 61 74 20 63 6f 6d 65 73 0a 2a 2a 20 y that comes.**
2a6e0 62 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 20 before or after
2a6f0 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 the key..**.** A
2a700 6e 20 69 6e 74 65 67 65 72 20 69 73 20 77 72 69 n integer is wri
2a710 74 74 65 6e 20 69 6e 74 6f 20 2a 70 52 65 73 20 tten into *pRes
2a720 77 68 69 63 68 20 69 73 20 74 68 65 20 72 65 73 which is the res
2a730 75 6c 74 20 6f 66 0a 2a 2a 20 63 6f 6d 70 61 72 ult of.** compar
2a740 69 6e 67 20 74 68 65 20 6b 65 79 20 77 69 74 68 ing the key with
2a750 20 74 68 65 20 65 6e 74 72 79 20 74 6f 20 77 68 the entry to wh
2a760 69 63 68 20 74 68 65 20 63 75 72 73 6f 72 20 69 ich the cursor i
2a770 73 20 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e 20 s .** pointing.
2a780 20 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 The meaning of
2a790 74 68 65 20 69 6e 74 65 67 65 72 20 77 72 69 74 the integer writ
2a7a0 74 65 6e 20 69 6e 74 6f 0a 2a 2a 20 2a 70 52 65 ten into.** *pRe
2a7b0 73 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a s is as follows:
2a7c0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 .**.** *pRes
2a7d0 3c 30 20 20 20 20 20 20 54 68 65 20 63 75 72 73 <0 The curs
2a7e0 6f 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 or is left point
2a7f0 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 ing at an entry
2a800 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 that.**
2a810 20 20 20 20 20 20 20 20 20 69 73 20 73 6d 61 6c is smal
2a820 6c 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f ler than intKey/
2a830 70 49 64 78 4b 65 79 20 6f 72 20 69 66 20 74 68 pIdxKey or if th
2a840 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 e table is empty
2a850 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
2a860 20 20 20 20 20 61 6e 64 20 74 68 65 20 63 75 72 and the cur
2a870 73 6f 72 20 69 73 20 74 68 65 72 65 66 6f 72 65 sor is therefore
2a880 20 6c 65 66 74 20 70 6f 69 6e 74 20 74 6f 20 6e left point to n
2a890 6f 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 othing..**.**
2a8a0 20 20 2a 70 52 65 73 3d 3d 30 20 20 20 20 20 54 *pRes==0 T
2a8b0 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 he cursor is lef
2a8c0 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e t pointing at an
2a8d0 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 entry that.**
2a8e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a8f0 65 78 61 63 74 6c 79 20 6d 61 74 63 68 65 73 20 exactly matches
2a900 69 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a intKey/pIdxKey..
2a910 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3e **.** *pRes>
2a920 30 20 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 0 The curso
2a930 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
2a940 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
2a950 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
2a960 20 20 20 20 20 20 20 20 69 73 20 6c 61 72 67 65 is large
2a970 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f 70 49 r than intKey/pI
2a980 64 78 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 dxKey..**.** For
2a990 20 69 6e 64 65 78 20 74 61 62 6c 65 73 2c 20 74 index tables, t
2a9a0 68 65 20 70 49 64 78 4b 65 79 2d 3e 65 71 53 65 he pIdxKey->eqSe
2a9b0 65 6e 20 66 69 65 6c 64 20 69 73 20 73 65 74 20 en field is set
2a9c0 74 6f 20 31 20 69 66 20 74 68 65 72 65 0a 2a 2a to 1 if there.**
2a9d0 20 65 78 69 73 74 73 20 61 6e 20 65 6e 74 72 79 exists an entry
2a9e0 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 74 68 in the table th
2a9f0 61 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 at exactly match
2aa00 65 73 20 70 49 64 78 4b 65 79 2e 20 20 0a 2a 2f es pIdxKey. .*/
2aa10 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
2aa20 65 4d 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 eMovetoUnpacked(
2aa30 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
2aa40 72 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 r, /* T
2aa50 68 65 20 63 75 72 73 6f 72 20 74 6f 20 62 65 20 he cursor to be
2aa60 6d 6f 76 65 64 20 2a 2f 0a 20 20 55 6e 70 61 63 moved */. Unpac
2aa70 6b 65 64 52 65 63 6f 72 64 20 2a 70 49 64 78 4b kedRecord *pIdxK
2aa80 65 79 2c 20 2f 2a 20 55 6e 70 61 63 6b 65 64 20 ey, /* Unpacked
2aa90 69 6e 64 65 78 20 6b 65 79 20 2a 2f 0a 20 20 69 index key */. i
2aaa0 36 34 20 69 6e 74 4b 65 79 2c 20 20 20 20 20 20 64 intKey,
2aab0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 /* The t
2aac0 61 62 6c 65 20 6b 65 79 20 2a 2f 0a 20 20 69 6e able key */. in
2aad0 74 20 62 69 61 73 52 69 67 68 74 2c 20 20 20 20 t biasRight,
2aae0 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 72 75 /* If tru
2aaf0 65 2c 20 62 69 61 73 20 74 68 65 20 73 65 61 72 e, bias the sear
2ab00 63 68 20 74 6f 20 74 68 65 20 68 69 67 68 20 65 ch to the high e
2ab10 6e 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 nd */. int *pRe
2ab20 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s
2ab30 20 2f 2a 20 57 72 69 74 65 20 73 65 61 72 63 68 /* Write search
2ab40 20 72 65 73 75 6c 74 73 20 68 65 72 65 20 2a 2f results here */
2ab50 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 .){. int rc;.
2ab60 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 20 78 52 RecordCompare xR
2ab70 65 63 6f 72 64 43 6f 6d 70 61 72 65 3b 0a 0a 20 ecordCompare;..
2ab80 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f assert( cursorO
2ab90 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 wnsBtShared(pCur
2aba0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2abb0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2abc0 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e d(pCur->pBtree->
2abd0 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
2abe0 61 73 73 65 72 74 28 20 70 52 65 73 20 29 3b 0a assert( pRes );.
2abf0 20 20 61 73 73 65 72 74 28 20 28 70 49 64 78 4b assert( (pIdxK
2ac00 65 79 3d 3d 30 29 3d 3d 28 70 43 75 72 2d 3e 70 ey==0)==(pCur->p
2ac10 4b 65 79 49 6e 66 6f 3d 3d 30 29 20 29 3b 0a 20 KeyInfo==0) );.
2ac20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
2ac30 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 State!=CURSOR_VA
2ac40 4c 49 44 20 7c 7c 20 28 70 49 64 78 4b 65 79 3d LID || (pIdxKey=
2ac50 3d 30 29 3d 3d 28 70 43 75 72 2d 3e 63 75 72 49 =0)==(pCur->curI
2ac60 6e 74 4b 65 79 21 3d 30 29 20 29 3b 0a 0a 20 20 ntKey!=0) );..
2ac70 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 /* If the cursor
2ac80 20 69 73 20 61 6c 72 65 61 64 79 20 70 6f 73 69 is already posi
2ac90 74 69 6f 6e 65 64 20 61 74 20 74 68 65 20 70 6f tioned at the po
2aca0 69 6e 74 20 77 65 20 61 72 65 20 74 72 79 69 6e int we are tryin
2acb0 67 0a 20 20 2a 2a 20 74 6f 20 6d 6f 76 65 20 74 g. ** to move t
2acc0 6f 2c 20 74 68 65 6e 20 6a 75 73 74 20 72 65 74 o, then just ret
2acd0 75 72 6e 20 77 69 74 68 6f 75 74 20 64 6f 69 6e urn without doin
2ace0 67 20 61 6e 79 20 77 6f 72 6b 20 2a 2f 0a 20 20 g any work */.
2acf0 69 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 0a 20 if( pIdxKey==0.
2ad00 20 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 74 && pCur->eStat
2ad10 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
2ad20 26 26 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 && (pCur->curFla
2ad30 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4e gs & BTCF_ValidN
2ad40 4b 65 79 29 21 3d 30 0a 20 20 29 7b 0a 20 20 20 Key)!=0. ){.
2ad50 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e if( pCur->info.
2ad60 6e 4b 65 79 3d 3d 69 6e 74 4b 65 79 20 29 7b 0a nKey==intKey ){.
2ad70 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b *pRes = 0;
2ad80 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2ad90 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
2ada0 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 if( pCur->inf
2adb0 6f 2e 6e 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b o.nKey<intKey ){
2adc0 0a 20 20 20 20 20 20 69 66 28 20 28 70 43 75 72 . if( (pCur
2add0 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2ade0 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 7b 0a F_AtLast)!=0 ){.
2adf0 20 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 *pRes =
2ae00 2d 31 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 -1;. retu
2ae10 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2ae20 20 20 20 20 7d 0a 20 20 20 20 20 20 2f 2a 20 49 }. /* I
2ae30 66 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 f the requested
2ae40 6b 65 79 20 69 73 20 6f 6e 65 20 6d 6f 72 65 20 key is one more
2ae50 74 68 61 6e 20 74 68 65 20 70 72 65 76 69 6f 75 than the previou
2ae60 73 20 6b 65 79 2c 20 74 68 65 6e 0a 20 20 20 20 s key, then.
2ae70 20 20 2a 2a 20 74 72 79 20 74 6f 20 67 65 74 20 ** try to get
2ae80 74 68 65 72 65 20 75 73 69 6e 67 20 73 71 6c 69 there using sqli
2ae90 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 20 72 te3BtreeNext() r
2aea0 61 74 68 65 72 20 74 68 61 6e 20 61 20 66 75 6c ather than a ful
2aeb0 6c 0a 20 20 20 20 20 20 2a 2a 20 62 69 6e 61 72 l. ** binar
2aec0 79 20 73 65 61 72 63 68 2e 20 20 54 68 69 73 20 y search. This
2aed0 69 73 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 is an optimizati
2aee0 6f 6e 20 6f 6e 6c 79 2e 20 20 54 68 65 20 63 6f on only. The co
2aef0 72 72 65 63 74 20 61 6e 73 77 65 72 0a 20 20 20 rrect answer.
2af00 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c 20 6f ** is still o
2af10 62 74 61 69 6e 65 64 20 77 69 74 68 6f 75 74 20 btained without
2af20 74 68 69 73 20 61 73 65 2c 20 6f 6e 6c 79 20 61 this ase, only a
2af30 20 6c 69 74 74 6c 65 20 6d 6f 72 65 20 73 6c 6f little more slo
2af40 77 65 6c 79 20 2a 2f 0a 20 20 20 20 20 20 69 66 wely */. if
2af50 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 ( pCur->info.nKe
2af60 79 2b 31 3d 3d 69 6e 74 4b 65 79 20 26 26 20 21 y+1==intKey && !
2af70 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 29 pCur->skipNext )
2af80 7b 0a 20 20 20 20 20 20 20 20 2a 70 52 65 73 20 {. *pRes
2af90 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 63 20 = 0;. rc
2afa0 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 = sqlite3BtreeNe
2afb0 78 74 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a xt(pCur, pRes);.
2afc0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 if( rc )
2afd0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2afe0 20 20 20 20 69 66 28 20 2a 70 52 65 73 3d 3d 30 if( *pRes==0
2aff0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 65 ){. ge
2b000 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
2b010 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 . if( p
2b020 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d Cur->info.nKey==
2b030 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 intKey ){.
2b040 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
2b050 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 ITE_OK;.
2b060 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
2b070 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
2b080 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 20 29 . if( pIdxKey )
2b090 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 6f 6d {. xRecordCom
2b0a0 70 61 72 65 20 3d 20 73 71 6c 69 74 65 33 56 64 pare = sqlite3Vd
2b0b0 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 28 70 49 beFindCompare(pI
2b0c0 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 49 64 78 dxKey);. pIdx
2b0d0 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 3d 20 30 Key->errCode = 0
2b0e0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 ;. assert( pI
2b0f0 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c 74 5f 72 dxKey->default_r
2b100 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 20 20 7c c==1 . |
2b110 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 | pIdxKey->defau
2b120 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 20 20 20 lt_rc==0 .
2b130 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 || pIdxKey->d
2b140 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 0a 20 20 efault_rc==-1.
2b150 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
2b160 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 xRecordCompare
2b170 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 6b 65 79 = 0; /* All key
2b180 73 20 61 72 65 20 69 6e 74 65 67 65 72 73 20 2a s are integers *
2b190 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d 6f /. }.. rc = mo
2b1a0 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a veToRoot(pCur);.
2b1b0 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
2b1c0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 return rc;. }.
2b1d0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 assert( pCur->p
2b1e0 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 gnoRoot==0 || pC
2b1f0 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
2b200 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 >iPage] );. ass
2b210 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 ert( pCur->pgnoR
2b220 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e oot==0 || pCur->
2b230 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
2b240 67 65 5d 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 20 ge]->isInit );.
2b250 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
2b260 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e State==CURSOR_IN
2b270 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e 61 VALID || pCur->a
2b280 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2b290 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 e]->nCell>0 );.
2b2a0 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 if( pCur->eStat
2b2b0 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 e==CURSOR_INVALI
2b2c0 44 20 29 7b 0a 20 20 20 20 2a 70 52 65 73 20 3d D ){. *pRes =
2b2d0 20 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 74 28 -1;. assert(
2b2e0 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d pCur->pgnoRoot=
2b2f0 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 =0 || pCur->apPa
2b300 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d ge[pCur->iPage]-
2b310 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 >nCell==0 );.
2b320 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2b330 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 K;. }. assert(
2b340 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d pCur->apPage[0]
2b350 2d 3e 69 6e 74 4b 65 79 3d 3d 70 43 75 72 2d 3e ->intKey==pCur->
2b360 63 75 72 49 6e 74 4b 65 79 20 29 3b 0a 20 20 61 curIntKey );. a
2b370 73 73 65 72 74 28 20 70 43 75 72 2d 3e 63 75 72 ssert( pCur->cur
2b380 49 6e 74 4b 65 79 20 7c 7c 20 70 49 64 78 4b 65 IntKey || pIdxKe
2b390 79 20 29 3b 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a y );. for(;;){.
2b3a0 20 20 20 20 69 6e 74 20 6c 77 72 2c 20 75 70 72 int lwr, upr
2b3b0 2c 20 69 64 78 2c 20 63 3b 0a 20 20 20 20 50 67 , idx, c;. Pg
2b3c0 6e 6f 20 63 68 6c 64 50 67 3b 0a 20 20 20 20 4d no chldPg;. M
2b3d0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 emPage *pPage =
2b3e0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
2b3f0 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 75 r->iPage];. u
2b400 38 20 2a 70 43 65 6c 6c 3b 20 20 20 20 20 20 20 8 *pCell;
2b410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b420 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
2b430 20 63 75 72 72 65 6e 74 20 63 65 6c 6c 20 69 6e current cell in
2b440 20 70 50 61 67 65 20 2a 2f 0a 0a 20 20 20 20 2f pPage */.. /
2b450 2a 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 6d * pPage->nCell m
2b460 75 73 74 20 62 65 20 67 72 65 61 74 65 72 20 74 ust be greater t
2b470 68 61 6e 20 7a 65 72 6f 2e 20 49 66 20 74 68 69 han zero. If thi
2b480 73 20 69 73 20 74 68 65 20 72 6f 6f 74 2d 70 61 s is the root-pa
2b490 67 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 75 ge. ** the cu
2b4a0 72 73 6f 72 20 77 6f 75 6c 64 20 68 61 76 65 20 rsor would have
2b4b0 62 65 65 6e 20 49 4e 56 41 4c 49 44 20 61 62 6f been INVALID abo
2b4c0 76 65 20 61 6e 64 20 74 68 69 73 20 66 6f 72 28 ve and this for(
2b4d0 3b 3b 29 20 6c 6f 6f 70 0a 20 20 20 20 2a 2a 20 ;;) loop. **
2b4e0 6e 6f 74 20 72 75 6e 2e 20 49 66 20 74 68 69 73 not run. If this
2b4f0 20 69 73 20 6e 6f 74 20 74 68 65 20 72 6f 6f 74 is not the root
2b500 2d 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 -page, then the
2b510 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 72 6f moveToChild() ro
2b520 75 74 69 6e 65 0a 20 20 20 20 2a 2a 20 77 6f 75 utine. ** wou
2b530 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 ld have already
2b540 64 65 74 65 63 74 65 64 20 64 62 20 63 6f 72 72 detected db corr
2b550 75 70 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 72 6c uption. Similarl
2b560 79 2c 20 70 50 61 67 65 20 6d 75 73 74 0a 20 20 y, pPage must.
2b570 20 20 2a 2a 20 62 65 20 74 68 65 20 72 69 67 68 ** be the righ
2b580 74 20 6b 69 6e 64 20 28 69 6e 64 65 78 20 6f 72 t kind (index or
2b590 20 74 61 62 6c 65 29 20 6f 66 20 62 2d 74 72 65 table) of b-tre
2b5a0 65 20 70 61 67 65 2e 20 4f 74 68 65 72 77 69 73 e page. Otherwis
2b5b0 65 0a 20 20 20 20 2a 2a 20 61 20 6d 6f 76 65 54 e. ** a moveT
2b5c0 6f 43 68 69 6c 64 28 29 20 6f 72 20 6d 6f 76 65 oChild() or move
2b5d0 54 6f 52 6f 6f 74 28 29 20 63 61 6c 6c 20 77 6f ToRoot() call wo
2b5e0 75 6c 64 20 68 61 76 65 20 64 65 74 65 63 74 65 uld have detecte
2b5f0 64 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 2a d corruption. *
2b600 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 /. assert( pP
2b610 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a age->nCell>0 );.
2b620 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
2b630 65 2d 3e 69 6e 74 4b 65 79 3d 3d 28 70 49 64 78 e->intKey==(pIdx
2b640 4b 65 79 3d 3d 30 29 20 29 3b 0a 20 20 20 20 6c Key==0) );. l
2b650 77 72 20 3d 20 30 3b 0a 20 20 20 20 75 70 72 20 wr = 0;. upr
2b660 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d 31 = pPage->nCell-1
2b670 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 62 69 ;. assert( bi
2b680 61 73 52 69 67 68 74 3d 3d 30 20 7c 7c 20 62 69 asRight==0 || bi
2b690 61 73 52 69 67 68 74 3d 3d 31 20 29 3b 0a 20 20 asRight==1 );.
2b6a0 20 20 69 64 78 20 3d 20 75 70 72 3e 3e 28 31 2d idx = upr>>(1-
2b6b0 62 69 61 73 52 69 67 68 74 29 3b 20 2f 2a 20 69 biasRight); /* i
2b6c0 64 78 20 3d 20 62 69 61 73 52 69 67 68 74 20 3f dx = biasRight ?
2b6d0 20 75 70 72 20 3a 20 28 6c 77 72 2b 75 70 72 29 upr : (lwr+upr)
2b6e0 2f 32 3b 20 2a 2f 0a 20 20 20 20 70 43 75 72 2d /2; */. pCur-
2b6f0 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
2b700 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b 0a ge] = (u16)idx;.
2b710 20 20 20 20 69 66 28 20 78 52 65 63 6f 72 64 43 if( xRecordC
2b720 6f 6d 70 61 72 65 3d 3d 30 20 29 7b 0a 20 20 20 ompare==0 ){.
2b730 20 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 for(;;){.
2b740 20 20 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65 79 i64 nCellKey
2b750 3b 0a 20 20 20 20 20 20 20 20 70 43 65 6c 6c 20 ;. pCell
2b760 3d 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 50 74 = findCellPastPt
2b770 72 28 70 50 61 67 65 2c 20 69 64 78 29 3b 0a 20 r(pPage, idx);.
2b780 20 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 if( pPage
2b790 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 7b 0a ->intKeyLeaf ){.
2b7a0 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 while(
2b7b0 20 30 78 38 30 20 3c 3d 20 2a 28 70 43 65 6c 6c 0x80 <= *(pCell
2b7c0 2b 2b 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ++) ){.
2b7d0 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 3d 70 50 if( pCell>=pP
2b7e0 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 20 age->aDataEnd )
2b7f0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
2b800 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
2b810 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2b820 7d 0a 20 20 20 20 20 20 20 20 67 65 74 56 61 72 }. getVar
2b830 69 6e 74 28 70 43 65 6c 6c 2c 20 28 75 36 34 2a int(pCell, (u64*
2b840 29 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 )&nCellKey);.
2b850 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 if( nCellKe
2b860 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 y<intKey ){.
2b870 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b lwr = idx+
2b880 31 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 1;. if(
2b890 20 6c 77 72 3e 75 70 72 20 29 7b 20 63 20 3d 20 lwr>upr ){ c =
2b8a0 2d 31 3b 20 62 72 65 61 6b 3b 20 7d 0a 20 20 20 -1; break; }.
2b8b0 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6e }else if( n
2b8c0 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b 65 79 20 29 CellKey>intKey )
2b8d0 7b 0a 20 20 20 20 20 20 20 20 20 20 75 70 72 20 {. upr
2b8e0 3d 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 = idx-1;.
2b8f0 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 if( lwr>upr )
2b900 7b 20 63 20 3d 20 2b 31 3b 20 62 72 65 61 6b 3b { c = +1; break;
2b910 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
2b920 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 {. asse
2b930 72 74 28 20 6e 43 65 6c 6c 4b 65 79 3d 3d 69 6e rt( nCellKey==in
2b940 74 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 20 20 tKey );.
2b950 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
2b960 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 ur->iPage] = (u1
2b970 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 6)idx;.
2b980 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
2b990 66 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 f ){.
2b9a0 20 6c 77 72 20 3d 20 69 64 78 3b 0a 20 20 20 20 lwr = idx;.
2b9b0 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
2b9c0 65 74 6f 5f 6e 65 78 74 5f 6c 61 79 65 72 3b 0a eto_next_layer;.
2b9d0 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }else{
2b9e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 . pCu
2b9f0 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 r->curFlags |= B
2ba00 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 3b 0a 20 TCF_ValidNKey;.
2ba10 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d pCur-
2ba20 3e 69 6e 66 6f 2e 6e 4b 65 79 20 3d 20 6e 43 65 >info.nKey = nCe
2ba30 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 llKey;.
2ba40 20 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 pCur->info.nS
2ba50 69 7a 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ize = 0;.
2ba60 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a *pRes = 0;.
2ba70 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2ba80 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2ba90 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2baa0 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 65 }. asse
2bab0 72 74 28 20 6c 77 72 2b 75 70 72 3e 3d 30 20 29 rt( lwr+upr>=0 )
2bac0 3b 0a 20 20 20 20 20 20 20 20 69 64 78 20 3d 20 ;. idx =
2bad0 28 6c 77 72 2b 75 70 72 29 3e 3e 31 3b 20 20 2f (lwr+upr)>>1; /
2bae0 2a 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 * idx = (lwr+upr
2baf0 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 20 20 7d 0a )/2; */. }.
2bb00 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
2bb10 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 20 20 for(;;){.
2bb20 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 2f 2a int nCell; /*
2bb30 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 43 65 Size of the pCe
2bb40 6c 6c 20 63 65 6c 6c 20 69 6e 20 62 79 74 65 73 ll cell in bytes
2bb50 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 43 65 6c */. pCel
2bb60 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 l = findCellPast
2bb70 50 74 72 28 70 50 61 67 65 2c 20 69 64 78 29 3b Ptr(pPage, idx);
2bb80 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 .. /* The
2bb90 20 6d 61 78 69 6d 75 6d 20 73 75 70 70 6f 72 74 maximum support
2bba0 65 64 20 70 61 67 65 2d 73 69 7a 65 20 69 73 20 ed page-size is
2bbb0 36 35 35 33 36 20 62 79 74 65 73 2e 20 54 68 69 65536 bytes. Thi
2bbc0 73 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 20 20 s means that.
2bbd0 20 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 78 69 ** the maxi
2bbe0 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 mum number of re
2bbf0 63 6f 72 64 20 62 79 74 65 73 20 73 74 6f 72 65 cord bytes store
2bc00 64 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 42 2d d on an index B-
2bc10 54 72 65 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 Tree. **
2bc20 70 61 67 65 20 69 73 20 6c 65 73 73 20 74 68 61 page is less tha
2bc30 6e 20 31 36 33 38 34 20 62 79 74 65 73 20 61 6e n 16384 bytes an
2bc40 64 20 6d 61 79 20 62 65 20 73 74 6f 72 65 64 20 d may be stored
2bc50 61 73 20 61 20 32 2d 62 79 74 65 0a 20 20 20 20 as a 2-byte.
2bc60 20 20 20 20 2a 2a 20 76 61 72 69 6e 74 2e 20 54 ** varint. T
2bc70 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 his information
2bc80 69 73 20 75 73 65 64 20 74 6f 20 61 74 74 65 6d is used to attem
2bc90 70 74 20 74 6f 20 61 76 6f 69 64 20 70 61 72 73 pt to avoid pars
2bca0 69 6e 67 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 ing . **
2bcb0 74 68 65 20 65 6e 74 69 72 65 20 63 65 6c 6c 20 the entire cell
2bcc0 62 79 20 63 68 65 63 6b 69 6e 67 20 66 6f 72 20 by checking for
2bcd0 74 68 65 20 63 61 73 65 73 20 77 68 65 72 65 20 the cases where
2bce0 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 0a 20 the record is .
2bcf0 20 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 65 64 ** stored
2bd00 20 65 6e 74 69 72 65 6c 79 20 77 69 74 68 69 6e entirely within
2bd10 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 the b-tree page
2bd20 20 62 79 20 69 6e 73 70 65 63 74 69 6e 67 20 74 by inspecting t
2bd30 68 65 20 66 69 72 73 74 20 0a 20 20 20 20 20 20 he first .
2bd40 20 20 2a 2a 20 32 20 62 79 74 65 73 20 6f 66 20 ** 2 bytes of
2bd50 74 68 65 20 63 65 6c 6c 2e 0a 20 20 20 20 20 20 the cell..
2bd60 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6e 43 65 */. nCe
2bd70 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 5d 3b 0a 20 ll = pCell[0];.
2bd80 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c if( nCell
2bd90 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 <=pPage->max1byt
2bda0 65 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 ePayload ){.
2bdb0 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 /* This br
2bdc0 61 6e 63 68 20 72 75 6e 73 20 69 66 20 74 68 65 anch runs if the
2bdd0 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 69 65 record-size fie
2bde0 6c 64 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 69 ld of the cell i
2bdf0 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 2a 2a s a. **
2be00 20 73 69 6e 67 6c 65 20 62 79 74 65 20 76 61 72 single byte var
2be10 69 6e 74 20 61 6e 64 20 74 68 65 20 72 65 63 6f int and the reco
2be20 72 64 20 66 69 74 73 20 65 6e 74 69 72 65 6c 79 rd fits entirely
2be30 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 20 20 on the main.
2be40 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 65 65 ** b-tree
2be50 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 page. */.
2be60 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 testcase( p
2be70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d 70 50 Cell+nCell+1==pP
2be80 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b age->aDataEnd );
2be90 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 . c = x
2bea0 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 RecordCompare(nC
2beb0 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 ell, (void*)&pCe
2bec0 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b 65 79 29 3b ll[1], pIdxKey);
2bed0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
2bee0 66 28 20 21 28 70 43 65 6c 6c 5b 31 5d 20 26 20 f( !(pCell[1] &
2bef0 30 78 38 30 29 20 0a 20 20 20 20 20 20 20 20 20 0x80) .
2bf00 20 26 26 20 28 6e 43 65 6c 6c 20 3d 20 28 28 6e && (nCell = ((n
2bf10 43 65 6c 6c 26 30 78 37 66 29 3c 3c 37 29 20 2b Cell&0x7f)<<7) +
2bf20 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 70 50 61 67 pCell[1])<=pPag
2bf30 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a 20 20 20 20 e->maxLocal.
2bf40 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ){.
2bf50 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 2d 73 /* The record-s
2bf60 69 7a 65 20 66 69 65 6c 64 20 69 73 20 61 20 32 ize field is a 2
2bf70 20 62 79 74 65 20 76 61 72 69 6e 74 20 61 6e 64 byte varint and
2bf80 20 74 68 65 20 72 65 63 6f 72 64 20 0a 20 20 20 the record .
2bf90 20 20 20 20 20 20 20 2a 2a 20 66 69 74 73 20 65 ** fits e
2bfa0 6e 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d ntirely on the m
2bfb0 61 69 6e 20 62 2d 74 72 65 65 20 70 61 67 65 2e ain b-tree page.
2bfc0 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 */. t
2bfd0 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c 2b 6e estcase( pCell+n
2bfe0 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d 3e 61 Cell+2==pPage->a
2bff0 44 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 20 20 DataEnd );.
2c000 20 20 20 20 20 63 20 3d 20 78 52 65 63 6f 72 64 c = xRecord
2c010 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 28 Compare(nCell, (
2c020 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 32 5d 2c void*)&pCell[2],
2c030 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 pIdxKey);.
2c040 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2c050 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 /* The recor
2c060 64 20 66 6c 6f 77 73 20 6f 76 65 72 20 6f 6e 74 d flows over ont
2c070 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 o one or more ov
2c080 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 49 6e erflow pages. In
2c090 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 . ** th
2c0a0 69 73 20 63 61 73 65 20 74 68 65 20 77 68 6f 6c is case the whol
2c0b0 65 20 63 65 6c 6c 20 6e 65 65 64 73 20 74 6f 20 e cell needs to
2c0c0 62 65 20 70 61 72 73 65 64 2c 20 61 20 62 75 66 be parsed, a buf
2c0d0 66 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 20 20 fer allocated.
2c0e0 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 61 ** and a
2c0f0 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 75 ccessPayload() u
2c100 73 65 64 20 74 6f 20 72 65 74 72 69 65 76 65 20 sed to retrieve
2c110 74 68 65 20 72 65 63 6f 72 64 20 69 6e 74 6f 20 the record into
2c120 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a the. **
2c130 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 20 56 buffer before V
2c140 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 dbeRecordCompare
2c150 28 29 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 () can be called
2c160 2e 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 0a . . **.
2c170 20 20 20 20 20 20 20 20 20 20 2a 2a 20 49 66 20 ** If
2c180 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 63 6f the record is co
2c190 72 72 75 70 74 2c 20 74 68 65 20 78 52 65 63 6f rrupt, the xReco
2c1a0 72 64 43 6f 6d 70 61 72 65 20 72 6f 75 74 69 6e rdCompare routin
2c1b0 65 20 6d 61 79 20 72 65 61 64 0a 20 20 20 20 20 e may read.
2c1c0 20 20 20 20 20 2a 2a 20 75 70 20 74 6f 20 74 77 ** up to tw
2c1d0 6f 20 76 61 72 69 6e 74 73 20 70 61 73 74 20 74 o varints past t
2c1e0 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 62 75 he end of the bu
2c1f0 66 66 65 72 2e 20 41 6e 20 65 78 74 72 61 20 31 ffer. An extra 1
2c200 38 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 8 . **
2c210 62 79 74 65 73 20 6f 66 20 70 61 64 64 69 6e 67 bytes of padding
2c220 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 74 is allocated at
2c230 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
2c240 62 75 66 66 65 72 20 69 6e 0a 20 20 20 20 20 20 buffer in.
2c250 20 20 20 20 2a 2a 20 63 61 73 65 20 74 68 69 73 ** case this
2c260 20 68 61 70 70 65 6e 73 2e 20 20 2a 2f 0a 20 20 happens. */.
2c270 20 20 20 20 20 20 20 20 76 6f 69 64 20 2a 70 43 void *pC
2c280 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 ellKey;.
2c290 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 43 65 u8 * const pCe
2c2a0 6c 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c 20 2d llBody = pCell -
2c2b0 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
2c2c0 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 20 20 Size;.
2c2d0 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c pPage->xParseCel
2c2e0 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 42 6f l(pPage, pCellBo
2c2f0 64 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 dy, &pCur->info)
2c300 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 43 65 6c ;. nCel
2c310 6c 20 3d 20 28 69 6e 74 29 70 43 75 72 2d 3e 69 l = (int)pCur->i
2c320 6e 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 20 20 nfo.nKey;.
2c330 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 testcase( nC
2c340 65 6c 6c 3c 30 20 29 3b 20 20 20 2f 2a 20 54 72 ell<0 ); /* Tr
2c350 75 65 20 69 66 20 6b 65 79 20 73 69 7a 65 20 69 ue if key size i
2c360 73 20 32 5e 33 32 20 6f 72 20 6d 6f 72 65 20 2a s 2^32 or more *
2c370 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 /. test
2c380 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 30 20 29 case( nCell==0 )
2c390 3b 20 20 2f 2a 20 49 6e 76 61 6c 69 64 20 6b 65 ; /* Invalid ke
2c3a0 79 20 73 69 7a 65 3a 20 20 30 78 38 30 20 30 78 y size: 0x80 0x
2c3b0 38 30 20 30 78 30 30 20 2a 2f 0a 20 20 20 20 20 80 0x00 */.
2c3c0 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e testcase( n
2c3d0 43 65 6c 6c 3d 3d 31 20 29 3b 20 20 2f 2a 20 49 Cell==1 ); /* I
2c3e0 6e 76 61 6c 69 64 20 6b 65 79 20 73 69 7a 65 3a nvalid key size:
2c3f0 20 20 30 78 38 30 20 30 78 38 30 20 30 78 30 31 0x80 0x80 0x01
2c400 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 */. te
2c410 73 74 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 32 stcase( nCell==2
2c420 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 ); /* Minimum
2c430 6c 65 67 61 6c 20 69 6e 64 65 78 20 6b 65 79 20 legal index key
2c440 73 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 size */.
2c450 20 20 69 66 28 20 6e 43 65 6c 6c 3c 32 20 29 7b if( nCell<2 ){
2c460 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
2c470 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
2c480 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 _BKPT;.
2c490 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 goto moveto_f
2c4a0 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 inish;.
2c4b0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 43 65 }. pCe
2c4c0 6c 6c 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 4d llKey = sqlite3M
2c4d0 61 6c 6c 6f 63 28 20 6e 43 65 6c 6c 2b 31 38 20 alloc( nCell+18
2c4e0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
2c4f0 20 70 43 65 6c 6c 4b 65 79 3d 3d 30 20 29 7b 0a pCellKey==0 ){.
2c500 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
2c510 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
2c520 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 PT;.
2c530 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 goto moveto_fini
2c540 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a sh;. }.
2c550 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
2c560 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2c570 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 e] = (u16)idx;.
2c580 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 63 rc = ac
2c590 63 65 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 cessPayload(pCur
2c5a0 2c 20 30 2c 20 6e 43 65 6c 6c 2c 20 28 75 6e 73 , 0, nCell, (uns
2c5b0 69 67 6e 65 64 20 63 68 61 72 2a 29 70 43 65 6c igned char*)pCel
2c5c0 6c 4b 65 79 2c 20 30 29 3b 0a 20 20 20 20 20 20 lKey, 0);.
2c5d0 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 pCur->curFla
2c5e0 67 73 20 26 3d 20 7e 42 54 43 46 5f 56 61 6c 69 gs &= ~BTCF_Vali
2c5f0 64 4f 76 66 6c 3b 0a 20 20 20 20 20 20 20 20 20 dOvfl;.
2c600 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 if( rc ){.
2c610 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
2c620 72 65 65 28 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 ree(pCellKey);.
2c630 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 goto
2c640 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 moveto_finish;.
2c650 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2c660 20 20 20 20 20 63 20 3d 20 78 52 65 63 6f 72 64 c = xRecord
2c670 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 70 Compare(nCell, p
2c680 43 65 6c 6c 4b 65 79 2c 20 70 49 64 78 4b 65 79 CellKey, pIdxKey
2c690 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c );. sql
2c6a0 69 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b ite3_free(pCellK
2c6b0 65 79 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ey);. }.
2c6c0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 0a assert( .
2c6d0 20 20 20 20 20 20 20 20 20 20 20 20 28 70 49 64 (pId
2c6e0 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 xKey->errCode!=S
2c6f0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 7c 7c QLITE_CORRUPT ||
2c700 20 63 3d 3d 30 29 0a 20 20 20 20 20 20 20 20 20 c==0).
2c710 26 26 20 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 && (pIdxKey->err
2c720 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 4e 4f 4d Code!=SQLITE_NOM
2c730 45 4d 20 7c 7c 20 70 43 75 72 2d 3e 70 42 74 72 EM || pCur->pBtr
2c740 65 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 ee->db->mallocFa
2c750 69 6c 65 64 29 0a 20 20 20 20 20 20 20 20 29 3b iled). );
2c760 0a 20 20 20 20 20 20 20 20 69 66 28 20 63 3c 30 . if( c<0
2c770 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6c 77 ){. lw
2c780 72 20 3d 20 69 64 78 2b 31 3b 0a 20 20 20 20 20 r = idx+1;.
2c790 20 20 20 7d 65 6c 73 65 20 69 66 28 20 63 3e 30 }else if( c>0
2c7a0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 70 ){. up
2c7b0 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 r = idx-1;.
2c7c0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2c7d0 20 20 20 20 61 73 73 65 72 74 28 20 63 3d 3d 30 assert( c==0
2c7e0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 2a 70 );. *p
2c7f0 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 Res = 0;.
2c800 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
2c810 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 K;. pCu
2c820 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
2c830 50 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 Page] = (u16)idx
2c840 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
2c850 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 pIdxKey->errCode
2c860 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 ) rc = SQLITE_C
2c870 4f 52 52 55 50 54 3b 0a 20 20 20 20 20 20 20 20 ORRUPT;.
2c880 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 goto moveto_fi
2c890 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 7d 0a nish;. }.
2c8a0 20 20 20 20 20 20 20 20 69 66 28 20 6c 77 72 3e if( lwr>
2c8b0 75 70 72 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 upr ) break;.
2c8c0 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 77 72 assert( lwr
2c8d0 2b 75 70 72 3e 3d 30 20 29 3b 0a 20 20 20 20 20 +upr>=0 );.
2c8e0 20 20 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 idx = (lwr+up
2c8f0 72 29 3e 3e 31 3b 20 20 2f 2a 20 69 64 78 20 3d r)>>1; /* idx =
2c900 20 28 6c 77 72 2b 75 70 72 29 2f 32 20 2a 2f 0a (lwr+upr)/2 */.
2c910 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
2c920 20 20 61 73 73 65 72 74 28 20 6c 77 72 3d 3d 75 assert( lwr==u
2c930 70 72 2b 31 20 7c 7c 20 28 70 50 61 67 65 2d 3e pr+1 || (pPage->
2c940 69 6e 74 4b 65 79 20 26 26 20 21 70 50 61 67 65 intKey && !pPage
2c950 2d 3e 6c 65 61 66 29 20 29 3b 0a 20 20 20 20 61 ->leaf) );. a
2c960 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 ssert( pPage->is
2c970 49 6e 69 74 20 29 3b 0a 20 20 20 20 69 66 28 20 Init );. if(
2c980 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 pPage->leaf ){.
2c990 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
2c9a0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
2c9b0 50 61 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 Page]<pCur->apPa
2c9c0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d ge[pCur->iPage]-
2c9d0 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 >nCell );.
2c9e0 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
2c9f0 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 ->iPage] = (u16)
2ca00 69 64 78 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 idx;. *pRes
2ca10 20 3d 20 63 3b 0a 20 20 20 20 20 20 72 63 20 3d = c;. rc =
2ca20 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
2ca30 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 goto moveto_fi
2ca40 6e 69 73 68 3b 0a 20 20 20 20 7d 0a 6d 6f 76 65 nish;. }.move
2ca50 74 6f 5f 6e 65 78 74 5f 6c 61 79 65 72 3a 0a 20 to_next_layer:.
2ca60 20 20 20 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 if( lwr>=pPag
2ca70 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 e->nCell ){.
2ca80 20 20 63 68 6c 64 50 67 20 3d 20 67 65 74 34 62 chldPg = get4b
2ca90 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 yte(&pPage->aDat
2caa0 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
2cab0 65 74 2b 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 et+8]);. }els
2cac0 65 7b 0a 20 20 20 20 20 20 63 68 6c 64 50 67 20 e{. chldPg
2cad0 3d 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 = get4byte(findC
2cae0 65 6c 6c 28 70 50 61 67 65 2c 20 6c 77 72 29 29 ell(pPage, lwr))
2caf0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 ;. }. pCur
2cb00 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2cb10 61 67 65 5d 20 3d 20 28 75 31 36 29 6c 77 72 3b age] = (u16)lwr;
2cb20 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f . rc = moveTo
2cb30 43 68 69 6c 64 28 70 43 75 72 2c 20 63 68 6c 64 Child(pCur, chld
2cb40 50 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 Pg);. if( rc
2cb50 29 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 ) break;. }.mov
2cb60 65 74 6f 5f 66 69 6e 69 73 68 3a 0a 20 20 70 43 eto_finish:. pC
2cb70 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d ur->info.nSize =
2cb80 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 0;. assert( (p
2cb90 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 Cur->curFlags &
2cba0 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d BTCF_ValidOvfl)=
2cbb0 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 =0 );. return r
2cbc0 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 c;.}.../*.** Ret
2cbd0 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 20 urn TRUE if the
2cbe0 63 75 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f cursor is not po
2cbf0 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 inting at an ent
2cc00 72 79 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e ry of the table.
2cc10 0a 2a 2a 0a 2a 2a 20 54 52 55 45 20 77 69 6c 6c .**.** TRUE will
2cc20 20 62 65 20 72 65 74 75 72 6e 65 64 20 61 66 74 be returned aft
2cc30 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c er a call to sql
2cc40 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 20 ite3BtreeNext()
2cc50 6d 6f 76 65 73 0a 2a 2a 20 70 61 73 74 20 74 68 moves.** past th
2cc60 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 e last entry in
2cc70 74 68 65 20 74 61 62 6c 65 20 6f 72 20 73 71 6c the table or sql
2cc80 69 74 65 33 42 74 72 65 65 50 72 65 76 28 29 20 ite3BtreePrev()
2cc90 6d 6f 76 65 73 20 70 61 73 74 0a 2a 2a 20 74 68 moves past.** th
2cca0 65 20 66 69 72 73 74 20 65 6e 74 72 79 2e 20 20 e first entry.
2ccb0 54 52 55 45 20 69 73 20 61 6c 73 6f 20 72 65 74 TRUE is also ret
2ccc0 75 72 6e 65 64 20 69 66 20 74 68 65 20 74 61 62 urned if the tab
2ccd0 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a le is empty..*/.
2cce0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
2ccf0 45 6f 66 28 42 74 43 75 72 73 6f 72 20 2a 70 43 Eof(BtCursor *pC
2cd00 75 72 29 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 ur){. /* TODO:
2cd10 57 68 61 74 20 69 66 20 74 68 65 20 63 75 72 73 What if the curs
2cd20 6f 72 20 69 73 20 69 6e 20 43 55 52 53 4f 52 5f or is in CURSOR_
2cd30 52 45 51 55 49 52 45 53 45 45 4b 20 62 75 74 20 REQUIRESEEK but
2cd40 61 6c 6c 20 74 61 62 6c 65 20 65 6e 74 72 69 65 all table entrie
2cd50 73 0a 20 20 2a 2a 20 68 61 76 65 20 62 65 65 6e s. ** have been
2cd60 20 64 65 6c 65 74 65 64 3f 20 54 68 69 73 20 41 deleted? This A
2cd70 50 49 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 PI will need to
2cd80 63 68 61 6e 67 65 20 74 6f 20 72 65 74 75 72 6e change to return
2cd90 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 an error code.
2cda0 20 2a 2a 20 61 73 20 77 65 6c 6c 20 61 73 20 74 ** as well as t
2cdb0 68 65 20 62 6f 6f 6c 65 61 6e 20 72 65 73 75 6c he boolean resul
2cdc0 74 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 t value.. */.
2cdd0 72 65 74 75 72 6e 20 28 43 55 52 53 4f 52 5f 56 return (CURSOR_V
2cde0 41 4c 49 44 21 3d 70 43 75 72 2d 3e 65 53 74 61 ALID!=pCur->eSta
2cdf0 74 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 te);.}../*.** Re
2ce00 74 75 72 6e 20 61 6e 20 65 73 74 69 6d 61 74 65 turn an estimate
2ce10 20 66 6f 72 20 74 68 65 20 6e 75 6d 62 65 72 20 for the number
2ce20 6f 66 20 72 6f 77 73 20 69 6e 20 74 68 65 20 74 of rows in the t
2ce30 61 62 6c 65 20 74 68 61 74 20 70 43 75 72 20 69 able that pCur i
2ce40 73 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 20 74 6f s.** pointing to
2ce50 2e 20 20 52 65 74 75 72 6e 20 61 20 6e 65 67 61 . Return a nega
2ce60 74 69 76 65 20 6e 75 6d 62 65 72 20 69 66 20 6e tive number if n
2ce70 6f 20 65 73 74 69 6d 61 74 65 20 69 73 20 63 75 o estimate is cu
2ce80 72 72 65 6e 74 6c 79 20 0a 2a 2a 20 61 76 61 69 rrently .** avai
2ce90 6c 61 62 6c 65 2e 0a 2a 2f 0a 69 36 34 20 73 71 lable..*/.i64 sq
2cea0 6c 69 74 65 33 42 74 72 65 65 52 6f 77 43 6f 75 lite3BtreeRowCou
2ceb0 6e 74 45 73 74 28 42 74 43 75 72 73 6f 72 20 2a ntEst(BtCursor *
2cec0 70 43 75 72 29 7b 0a 20 20 69 36 34 20 6e 3b 0a pCur){. i64 n;.
2ced0 20 20 75 38 20 69 3b 0a 0a 20 20 61 73 73 65 72 u8 i;.. asser
2cee0 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
2cef0 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
2cf00 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2cf10 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 _mutex_held(pCur
2cf20 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 ->pBtree->db->mu
2cf30 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 43 tex) );. if( pC
2cf40 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
2cf50 4f 52 5f 56 41 4c 49 44 20 29 20 72 65 74 75 72 OR_VALID ) retur
2cf60 6e 20 2d 31 3b 0a 20 20 69 66 28 20 70 43 75 72 n -1;. if( pCur
2cf70 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
2cf80 50 61 67 65 2d 31 5d 2d 3e 6c 65 61 66 3d 3d 30 Page-1]->leaf==0
2cf90 20 29 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 ) return -1;.
2cfa0 66 6f 72 28 6e 3d 31 2c 20 69 3d 30 3b 20 69 3c for(n=1, i=0; i<
2cfb0 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b pCur->iPage; i++
2cfc0 29 7b 0a 20 20 20 20 6e 20 2a 3d 20 70 43 75 72 ){. n *= pCur
2cfd0 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 6e 43 65 ->apPage[i]->nCe
2cfe0 6c 6c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ll;. }. return
2cff0 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 n;.}../*.** Adv
2d000 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 ance the cursor
2d010 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e 74 72 to the next entr
2d020 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
2d030 65 2e 20 20 49 66 0a 2a 2a 20 73 75 63 63 65 73 e. If.** succes
2d040 73 66 75 6c 20 74 68 65 6e 20 73 65 74 20 2a 70 sful then set *p
2d050 52 65 73 3d 30 2e 20 20 49 66 20 74 68 65 20 63 Res=0. If the c
2d060 75 72 73 6f 72 0a 2a 2a 20 77 61 73 20 61 6c 72 ursor.** was alr
2d070 65 61 64 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f eady pointing to
2d080 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 the last entry
2d090 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
2d0a0 62 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 20 72 before.** this r
2d0b0 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 outine was calle
2d0c0 64 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 d, then set *pRe
2d0d0 73 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d s=1..**.** The m
2d0e0 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 ain entry point
2d0f0 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e is sqlite3BtreeN
2d100 65 78 74 28 29 2e 20 20 54 68 61 74 20 72 6f 75 ext(). That rou
2d110 74 69 6e 65 20 69 73 20 6f 70 74 69 6d 69 7a 65 tine is optimize
2d120 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 63 6f 6d d.** for the com
2d130 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d 65 72 65 mon case of mere
2d140 6c 79 20 69 6e 63 72 65 6d 65 6e 74 69 6e 67 20 ly incrementing
2d150 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 65 72 the cell counter
2d160 20 42 74 43 75 72 73 6f 72 2e 61 69 49 64 78 0a BtCursor.aiIdx.
2d170 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 20 63 ** to the next c
2d180 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 72 65 ell on the curre
2d190 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 28 73 nt page. The (s
2d1a0 6c 6f 77 65 72 29 20 62 74 72 65 65 4e 65 78 74 lower) btreeNext
2d1b0 28 29 20 68 65 6c 70 65 72 0a 2a 2a 20 72 6f 75 () helper.** rou
2d1c0 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 tine is called w
2d1d0 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 73 73 hen it is necess
2d1e0 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f 20 61 ary to move to a
2d1f0 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 65 20 different page
2d200 6f 72 0a 2a 2a 20 74 6f 20 72 65 73 74 6f 72 65 or.** to restore
2d210 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a the cursor..**.
2d220 2a 2a 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 66 ** The calling f
2d230 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 73 65 74 unction will set
2d240 20 2a 70 52 65 73 20 74 6f 20 30 20 6f 72 20 31 *pRes to 0 or 1
2d250 2e 20 20 54 68 65 20 69 6e 69 74 69 61 6c 20 2a . The initial *
2d260 70 52 65 73 20 76 61 6c 75 65 0a 2a 2a 20 77 69 pRes value.** wi
2d270 6c 6c 20 62 65 20 31 20 69 66 20 74 68 65 20 63 ll be 1 if the c
2d280 75 72 73 6f 72 20 62 65 69 6e 67 20 73 74 65 70 ursor being step
2d290 70 65 64 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 ped corresponds
2d2a0 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 78 20 to an SQL index
2d2b0 61 6e 64 0a 2a 2a 20 69 66 20 74 68 69 73 20 72 and.** if this r
2d2c0 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 68 61 76 outine could hav
2d2d0 65 20 62 65 65 6e 20 73 6b 69 70 70 65 64 20 69 e been skipped i
2d2e0 66 20 74 68 61 74 20 53 51 4c 20 69 6e 64 65 78 f that SQL index
2d2f0 20 68 61 64 20 62 65 65 6e 0a 2a 2a 20 61 20 75 had been.** a u
2d300 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 4f 74 nique index. Ot
2d310 68 65 72 77 69 73 65 20 74 68 65 20 63 61 6c 6c herwise the call
2d320 65 72 20 77 69 6c 6c 20 68 61 76 65 20 73 65 74 er will have set
2d330 20 2a 70 52 65 73 20 74 6f 20 7a 65 72 6f 2e 0a *pRes to zero..
2d340 2a 2a 20 5a 65 72 6f 20 69 73 20 74 68 65 20 63 ** Zero is the c
2d350 6f 6d 6d 6f 6e 20 63 61 73 65 2e 20 54 68 65 20 ommon case. The
2d360 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 btree implementa
2d370 74 69 6f 6e 20 69 73 20 66 72 65 65 20 74 6f 20 tion is free to
2d380 75 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 74 69 use the.** initi
2d390 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 20 61 al *pRes value a
2d3a0 73 20 61 20 68 69 6e 74 20 74 6f 20 69 6d 70 72 s a hint to impr
2d3b0 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 2c ove performance,
2d3c0 20 62 75 74 20 74 68 65 20 63 75 72 72 65 6e 74 but the current
2d3d0 0a 2a 2a 20 53 51 4c 69 74 65 20 62 74 72 65 65 .** SQLite btree
2d3e0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
2d3f0 64 6f 65 73 20 6e 6f 74 2e 20 28 4e 6f 74 65 20 does not. (Note
2d400 74 68 61 74 20 74 68 65 20 63 6f 6d 64 62 32 20 that the comdb2
2d410 62 74 72 65 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 btree.** impleme
2d420 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 75 73 65 ntation does use
2d430 20 74 68 69 73 20 68 69 6e 74 2c 20 68 6f 77 65 this hint, howe
2d440 76 65 72 2e 29 0a 2a 2f 0a 73 74 61 74 69 63 20 ver.).*/.static
2d450 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 SQLITE_NOINLINE
2d460 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 42 74 int btreeNext(Bt
2d470 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e Cursor *pCur, in
2d480 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 t *pRes){. int
2d490 72 63 3b 0a 20 20 69 6e 74 20 69 64 78 3b 0a 20 rc;. int idx;.
2d4a0 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
2d4b0 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
2d4c0 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
2d4d0 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
2d4e0 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 ( pCur->skipNext
2d4f0 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 ==0 || pCur->eSt
2d500 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
2d510 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 2a D );. assert( *
2d520 70 52 65 73 3d 3d 30 20 29 3b 0a 20 20 69 66 28 pRes==0 );. if(
2d530 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
2d540 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 URSOR_VALID ){.
2d550 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 assert( (pCur
2d560 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2d570 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 F_ValidOvfl)==0
2d580 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 );. rc = rest
2d590 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
2d5a0 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 n(pCur);. if(
2d5b0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2d5c0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
2d5d0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
2d5e0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d CURSOR_INVALID=
2d5f0 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b =pCur->eState ){
2d600 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 . *pRes = 1
2d610 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
2d620 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
2d630 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b if( pCur->sk
2d640 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 ipNext ){.
2d650 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
2d660 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
2d670 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 ID || pCur->eSta
2d680 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e te==CURSOR_SKIPN
2d690 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 EXT );. pCu
2d6a0 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
2d6b0 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 OR_VALID;.
2d6c0 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 if( pCur->skipNe
2d6d0 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 xt>0 ){.
2d6e0 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d pCur->skipNext =
2d6f0 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 0;. retu
2d700 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2d710 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 }. pCur
2d720 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a ->skipNext = 0;.
2d730 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 }. }.. pPa
2d740 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
2d750 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a e[pCur->iPage];.
2d760 20 20 69 64 78 20 3d 20 2b 2b 70 43 75 72 2d 3e idx = ++pCur->
2d770 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2d780 65 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 e];. assert( pP
2d790 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 0a age->isInit );..
2d7a0 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
2d7b0 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 6f 72 base file is cor
2d7c0 72 75 70 74 2c 20 69 74 20 69 73 20 70 6f 73 73 rupt, it is poss
2d7d0 69 62 6c 65 20 66 6f 72 20 74 68 65 20 76 61 6c ible for the val
2d7e0 75 65 20 6f 66 20 69 64 78 20 0a 20 20 2a 2a 20 ue of idx . **
2d7f0 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 20 68 65 to be invalid he
2d800 72 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c re. This can onl
2d810 79 20 6f 63 63 75 72 20 69 66 20 61 20 73 65 63 y occur if a sec
2d820 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f 64 69 66 ond cursor modif
2d830 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 ies. ** the pag
2d840 65 20 77 68 69 6c 65 20 63 75 72 73 6f 72 20 70 e while cursor p
2d850 43 75 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 Cur is holding a
2d860 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 69 74 reference to it
2d870 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 20 2a 2a . Which can. **
2d880 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 only happen if
2d890 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
2d8a0 63 6f 72 72 75 70 74 20 69 6e 20 73 75 63 68 20 corrupt in such
2d8b0 61 20 77 61 79 20 61 73 20 74 6f 20 6c 69 6e 6b a way as to link
2d8c0 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 the. ** page i
2d8d0 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e nto more than on
2d8e0 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 e b-tree structu
2d8f0 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 re. */. testcas
2d900 65 28 20 69 64 78 3e 70 50 61 67 65 2d 3e 6e 43 e( idx>pPage->nC
2d910 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 20 69 64 ell );.. if( id
2d920 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 x>=pPage->nCell
2d930 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 ){. if( !pPag
2d940 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
2d950 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
2d960 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 74 65 d(pCur, get4byte
2d970 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
2d980 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
2d990 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 8]));. if(
2d9a0 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
2d9b0 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 return mov
2d9c0 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 eToLeftmost(pCur
2d9d0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 6f 7b );. }. do{
2d9e0 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
2d9f0 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 >iPage==0 ){.
2da00 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a *pRes = 1;.
2da10 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 pCur->eS
2da20 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
2da30 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 72 VALID;. r
2da40 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2da50 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d . }. m
2da60 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 oveToParent(pCur
2da70 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d );. pPage =
2da80 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
2da90 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 20 ur->iPage];.
2daa0 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 69 }while( pCur->ai
2dab0 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d Idx[pCur->iPage]
2dac0 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 >=pPage->nCell )
2dad0 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d ;. if( pPage-
2dae0 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 >intKey ){.
2daf0 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 return sqlite3B
2db00 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 70 treeNext(pCur, p
2db10 52 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b Res);. }else{
2db20 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2db30 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
2db40 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e }. if( pPage->
2db50 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 leaf ){. retu
2db60 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2db70 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 }else{. retur
2db80 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
2db90 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 6e (pCur);. }.}.in
2dba0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 t sqlite3BtreeNe
2dbb0 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 xt(BtCursor *pCu
2dbc0 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 r, int *pRes){.
2dbd0 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b MemPage *pPage;
2dbe0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
2dbf0 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
2dc00 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
2dc10 20 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 pRes!=0 );. as
2dc20 73 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 7c sert( *pRes==0 |
2dc30 7c 20 2a 70 52 65 73 3d 3d 31 20 29 3b 0a 20 20 | *pRes==1 );.
2dc40 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
2dc50 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 ipNext==0 || pCu
2dc60 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
2dc70 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 70 43 75 R_VALID );. pCu
2dc80 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 r->info.nSize =
2dc90 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 0;. pCur->curFl
2dca0 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 ags &= ~(BTCF_Va
2dcb0 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c lidNKey|BTCF_Val
2dcc0 69 64 4f 76 66 6c 29 3b 0a 20 20 2a 70 52 65 73 idOvfl);. *pRes
2dcd0 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 43 75 72 = 0;. if( pCur
2dce0 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
2dcf0 5f 56 41 4c 49 44 20 29 20 72 65 74 75 72 6e 20 _VALID ) return
2dd00 62 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 btreeNext(pCur,
2dd10 70 52 65 73 29 3b 0a 20 20 70 50 61 67 65 20 3d pRes);. pPage =
2dd20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
2dd30 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 69 66 ur->iPage];. if
2dd40 28 20 28 2b 2b 70 43 75 72 2d 3e 61 69 49 64 78 ( (++pCur->aiIdx
2dd50 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3e 3d [pCur->iPage])>=
2dd60 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a pPage->nCell ){.
2dd70 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b pCur->aiIdx[
2dd80 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a pCur->iPage]--;.
2dd90 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 return btree
2dda0 4e 65 78 74 28 70 43 75 72 2c 20 70 52 65 73 29 Next(pCur, pRes)
2ddb0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 ;. }. if( pPag
2ddc0 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 e->leaf ){. r
2ddd0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2dde0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 . }else{. re
2ddf0 74 75 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d turn moveToLeftm
2de00 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d ost(pCur);. }.}
2de10 0a 0a 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 ../*.** Step the
2de20 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 cursor to the b
2de30 61 63 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 ack to the previ
2de40 6f 75 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ous entry in the
2de50 20 64 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a database. If.*
2de60 2a 20 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 * successful the
2de70 6e 20 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 n set *pRes=0.
2de80 49 66 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a If the cursor.**
2de90 20 77 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 was already poi
2dea0 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72 nting to the fir
2deb0 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 st entry in the
2dec0 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a database before.
2ded0 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ** this routine
2dee0 77 61 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e was called, then
2def0 20 73 65 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2a set *pRes=1..**
2df00 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 65 6e 74 .** The main ent
2df10 72 79 20 70 6f 69 6e 74 20 69 73 20 73 71 6c 69 ry point is sqli
2df20 74 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 te3BtreePrevious
2df30 28 29 2e 20 20 54 68 61 74 20 72 6f 75 74 69 6e (). That routin
2df40 65 20 69 73 20 6f 70 74 69 6d 69 7a 65 64 0a 2a e is optimized.*
2df50 2a 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e * for the common
2df60 20 63 61 73 65 20 6f 66 20 6d 65 72 65 6c 79 20 case of merely
2df70 64 65 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 decrementing the
2df80 20 63 65 6c 6c 20 63 6f 75 6e 74 65 72 20 42 74 cell counter Bt
2df90 43 75 72 73 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 Cursor.aiIdx.**
2dfa0 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 to the previous
2dfb0 63 65 6c 6c 20 6f 6e 20 74 68 65 20 63 75 72 72 cell on the curr
2dfc0 65 6e 74 20 70 61 67 65 2e 20 20 54 68 65 20 28 ent page. The (
2dfd0 73 6c 6f 77 65 72 29 20 62 74 72 65 65 50 72 65 slower) btreePre
2dfe0 76 69 6f 75 73 28 29 0a 2a 2a 20 68 65 6c 70 65 vious().** helpe
2dff0 72 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c r routine is cal
2e000 6c 65 64 20 77 68 65 6e 20 69 74 20 69 73 20 6e led when it is n
2e010 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 ecessary to move
2e020 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 to a different
2e030 70 61 67 65 0a 2a 2a 20 6f 72 20 74 6f 20 72 65 page.** or to re
2e040 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 6f 72 store the cursor
2e050 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c ..**.** The call
2e060 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c ing function wil
2e070 6c 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 30 l set *pRes to 0
2e080 20 6f 72 20 31 2e 20 20 54 68 65 20 69 6e 69 74 or 1. The init
2e090 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 0a ial *pRes value.
2e0a0 2a 2a 20 77 69 6c 6c 20 62 65 20 31 20 69 66 20 ** will be 1 if
2e0b0 74 68 65 20 63 75 72 73 6f 72 20 62 65 69 6e 67 the cursor being
2e0c0 20 73 74 65 70 70 65 64 20 63 6f 72 72 65 73 70 stepped corresp
2e0d0 6f 6e 64 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 onds to an SQL i
2e0e0 6e 64 65 78 20 61 6e 64 0a 2a 2a 20 69 66 20 74 ndex and.** if t
2e0f0 68 69 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c his routine coul
2e100 64 20 68 61 76 65 20 62 65 65 6e 20 73 6b 69 70 d have been skip
2e110 70 65 64 20 69 66 20 74 68 61 74 20 53 51 4c 20 ped if that SQL
2e120 69 6e 64 65 78 20 68 61 64 20 62 65 65 6e 0a 2a index had been.*
2e130 2a 20 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 * a unique index
2e140 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 . Otherwise the
2e150 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 68 61 76 caller will hav
2e160 65 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 7a e set *pRes to z
2e170 65 72 6f 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 ero..** Zero is
2e180 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 2e the common case.
2e190 20 54 68 65 20 62 74 72 65 65 20 69 6d 70 6c 65 The btree imple
2e1a0 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 66 72 65 mentation is fre
2e1b0 65 20 74 6f 20 75 73 65 20 74 68 65 0a 2a 2a 20 e to use the.**
2e1c0 69 6e 69 74 69 61 6c 20 2a 70 52 65 73 20 76 61 initial *pRes va
2e1d0 6c 75 65 20 61 73 20 61 20 68 69 6e 74 20 74 6f lue as a hint to
2e1e0 20 69 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 6d improve perform
2e1f0 61 6e 63 65 2c 20 62 75 74 20 74 68 65 20 63 75 ance, but the cu
2e200 72 72 65 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 20 rrent.** SQLite
2e210 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 btree implementa
2e220 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 28 tion does not. (
2e230 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 63 6f Note that the co
2e240 6d 64 62 32 20 62 74 72 65 65 0a 2a 2a 20 69 6d mdb2 btree.** im
2e250 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 plementation doe
2e260 73 20 75 73 65 20 74 68 69 73 20 68 69 6e 74 2c s use this hint,
2e270 20 68 6f 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 74 however.).*/.st
2e280 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e atic SQLITE_NOIN
2e290 4c 49 4e 45 20 69 6e 74 20 62 74 72 65 65 50 72 LINE int btreePr
2e2a0 65 76 69 6f 75 73 28 42 74 43 75 72 73 6f 72 20 evious(BtCursor
2e2b0 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 *pCur, int *pRes
2e2c0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 4d ){. int rc;. M
2e2d0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a emPage *pPage;..
2e2e0 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
2e2f0 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
2e300 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
2e310 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 pRes!=0 );. ass
2e320 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 29 3b ert( *pRes==0 );
2e330 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2e340 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 >skipNext==0 ||
2e350 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
2e360 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
2e370 61 73 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 assert( (pCur->c
2e380 75 72 46 6c 61 67 73 20 26 20 28 42 54 43 46 5f urFlags & (BTCF_
2e390 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 AtLast|BTCF_Vali
2e3a0 64 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c 69 64 dOvfl|BTCF_Valid
2e3b0 4e 4b 65 79 29 29 3d 3d 30 20 29 3b 0a 20 20 61 NKey))==0 );. a
2e3c0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 ssert( pCur->inf
2e3d0 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 o.nSize==0 );.
2e3e0 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
2e3f0 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 !=CURSOR_VALID )
2e400 7b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 6f {. rc = resto
2e410 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e reCursorPosition
2e420 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 20 (pCur);. if(
2e430 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2e440 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
2e450 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
2e460 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d CURSOR_INVALID==
2e470 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a pCur->eState ){.
2e480 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b *pRes = 1;
2e490 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2e4a0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
2e4b0 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 if( pCur->ski
2e4c0 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 61 pNext ){. a
2e4d0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
2e4e0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
2e4f0 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 D || pCur->eStat
2e500 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 e==CURSOR_SKIPNE
2e510 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 XT );. pCur
2e520 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f ->eState = CURSO
2e530 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 69 R_VALID;. i
2e540 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 f( pCur->skipNex
2e550 74 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 t<0 ){. p
2e560 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 Cur->skipNext =
2e570 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 0;. retur
2e580 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 n SQLITE_OK;.
2e590 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 2d }. pCur-
2e5a0 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 >skipNext = 0;.
2e5b0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 67 }. }.. pPag
2e5c0 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 e = pCur->apPage
2e5d0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 [pCur->iPage];.
2e5e0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
2e5f0 69 73 49 6e 69 74 20 29 3b 0a 20 20 69 66 28 20 isInit );. if(
2e600 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a !pPage->leaf ){.
2e610 20 20 20 20 69 6e 74 20 69 64 78 20 3d 20 70 43 int idx = pC
2e620 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
2e630 69 50 61 67 65 5d 3b 0a 20 20 20 20 72 63 20 3d iPage];. rc =
2e640 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 moveToChild(pCu
2e650 72 2c 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 r, get4byte(find
2e660 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 64 78 29 Cell(pPage, idx)
2e670 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 ));. if( rc )
2e680 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2e690 72 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 68 74 rc = moveToRight
2e6a0 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 7d 65 most(pCur);. }e
2e6b0 6c 73 65 7b 0a 20 20 20 20 77 68 69 6c 65 28 20 lse{. while(
2e6c0 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
2e6d0 2d 3e 69 50 61 67 65 5d 3d 3d 30 20 29 7b 0a 20 ->iPage]==0 ){.
2e6e0 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 if( pCur->i
2e6f0 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Page==0 ){.
2e700 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
2e710 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
2e720 3b 0a 20 20 20 20 20 20 20 20 2a 70 52 65 73 20 ;. *pRes
2e730 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 65 74 = 1;. ret
2e740 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2e750 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d 6f 76 }. mov
2e760 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 29 3b eToParent(pCur);
2e770 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 . }. asser
2e780 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 t( pCur->info.nS
2e790 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 ize==0 );. as
2e7a0 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 sert( (pCur->cur
2e7b0 46 6c 61 67 73 20 26 20 28 42 54 43 46 5f 56 61 Flags & (BTCF_Va
2e7c0 6c 69 64 4f 76 66 6c 29 29 3d 3d 30 20 29 3b 0a lidOvfl))==0 );.
2e7d0 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 . pCur->aiIdx
2e7e0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b [pCur->iPage]--;
2e7f0 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 43 75 . pPage = pCu
2e800 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
2e810 69 50 61 67 65 5d 3b 0a 20 20 20 20 69 66 28 20 iPage];. if(
2e820 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 pPage->intKey &&
2e830 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
2e840 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
2e850 74 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 te3BtreePrevious
2e860 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 (pCur, pRes);.
2e870 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
2e880 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
2e890 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
2e8a0 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 n rc;.}.int sqli
2e8b0 74 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 te3BtreePrevious
2e8c0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
2e8d0 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 61 int *pRes){. a
2e8e0 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e ssert( cursorOwn
2e8f0 73 42 74 53 68 61 72 65 64 28 70 43 75 72 29 20 sBtShared(pCur)
2e900 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 );. assert( pRe
2e910 73 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 s!=0 );. assert
2e920 28 20 2a 70 52 65 73 3d 3d 30 20 7c 7c 20 2a 70 ( *pRes==0 || *p
2e930 52 65 73 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 Res==1 );. asse
2e940 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 rt( pCur->skipNe
2e950 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 xt==0 || pCur->e
2e960 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 State!=CURSOR_VA
2e970 4c 49 44 20 29 3b 0a 20 20 2a 70 52 65 73 20 3d LID );. *pRes =
2e980 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 0;. pCur->curF
2e990 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 lags &= ~(BTCF_A
2e9a0 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 tLast|BTCF_Valid
2e9b0 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c 69 64 4e Ovfl|BTCF_ValidN
2e9c0 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e 69 6e Key);. pCur->in
2e9d0 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 fo.nSize = 0;.
2e9e0 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
2e9f0 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 0a 20 !=CURSOR_VALID.
2ea00 20 20 7c 7c 20 70 43 75 72 2d 3e 61 69 49 64 78 || pCur->aiIdx
2ea10 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d 30 [pCur->iPage]==0
2ea20 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 . || pCur->apP
2ea30 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
2ea40 2d 3e 6c 65 61 66 3d 3d 30 0a 20 20 29 7b 0a 20 ->leaf==0. ){.
2ea50 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 return btreeP
2ea60 72 65 76 69 6f 75 73 28 70 43 75 72 2c 20 70 52 revious(pCur, pR
2ea70 65 73 29 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d es);. }. pCur-
2ea80 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
2ea90 67 65 5d 2d 2d 3b 0a 20 20 72 65 74 75 72 6e 20 ge]--;. return
2eaa0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
2eab0 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e .** Allocate a n
2eac0 65 77 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 ew page from the
2ead0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a database file..
2eae0 2a 2a 0a 2a 2a 20 54 68 65 20 6e 65 77 20 70 61 **.** The new pa
2eaf0 67 65 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 ge is marked as
2eb00 64 69 72 74 79 2e 20 20 28 49 6e 20 6f 74 68 65 dirty. (In othe
2eb10 72 20 77 6f 72 64 73 2c 20 73 71 6c 69 74 65 33 r words, sqlite3
2eb20 50 61 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 PagerWrite().**
2eb30 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
2eb40 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6e called on the n
2eb50 65 77 20 70 61 67 65 2e 29 20 20 54 68 65 20 6e ew page.) The n
2eb60 65 77 20 70 61 67 65 20 68 61 73 20 61 6c 73 6f ew page has also
2eb70 0a 2a 2a 20 62 65 65 6e 20 72 65 66 65 72 65 6e .** been referen
2eb80 63 65 64 20 61 6e 64 20 74 68 65 20 63 61 6c 6c ced and the call
2eb90 69 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 20 72 ing routine is r
2eba0 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 63 esponsible for c
2ebb0 61 6c 6c 69 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 alling.** sqlite
2ebc0 33 50 61 67 65 72 55 6e 72 65 66 28 29 20 6f 6e 3PagerUnref() on
2ebd0 20 74 68 65 20 6e 65 77 20 70 61 67 65 20 77 68 the new page wh
2ebe0 65 6e 20 69 74 20 69 73 20 64 6f 6e 65 2e 0a 2a en it is done..*
2ebf0 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 *.** SQLITE_OK i
2ec00 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 s returned on su
2ec10 63 63 65 73 73 2e 20 20 41 6e 79 20 6f 74 68 65 ccess. Any othe
2ec20 72 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 r return value i
2ec30 6e 64 69 63 61 74 65 73 0a 2a 2a 20 61 6e 20 65 ndicates.** an e
2ec40 72 72 6f 72 2e 20 20 2a 70 70 50 61 67 65 20 69 rror. *ppPage i
2ec50 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 69 6e s set to NULL in
2ec60 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 6e the event of an
2ec70 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 error..**.** If
2ec80 20 74 68 65 20 22 6e 65 61 72 62 79 22 20 70 61 the "nearby" pa
2ec90 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 30 rameter is not 0
2eca0 2c 20 74 68 65 6e 20 61 6e 20 65 66 66 6f 72 74 , then an effort
2ecb0 20 69 73 20 6d 61 64 65 20 74 6f 20 0a 2a 2a 20 is made to .**
2ecc0 6c 6f 63 61 74 65 20 61 20 70 61 67 65 20 63 6c locate a page cl
2ecd0 6f 73 65 20 74 6f 20 74 68 65 20 70 61 67 65 20 ose to the page
2ece0 6e 75 6d 62 65 72 20 22 6e 65 61 72 62 79 22 2e number "nearby".
2ecf0 20 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 73 This can be us
2ed00 65 64 20 69 6e 20 61 6e 0a 2a 2a 20 61 74 74 65 ed in an.** atte
2ed10 6d 70 74 20 74 6f 20 6b 65 65 70 20 72 65 6c 61 mpt to keep rela
2ed20 74 65 64 20 70 61 67 65 73 20 63 6c 6f 73 65 20 ted pages close
2ed30 74 6f 20 65 61 63 68 20 6f 74 68 65 72 20 69 6e to each other in
2ed40 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
2ed50 6c 65 2c 0a 2a 2a 20 77 68 69 63 68 20 69 6e 20 le,.** which in
2ed60 74 75 72 6e 20 63 61 6e 20 6d 61 6b 65 20 64 61 turn can make da
2ed70 74 61 62 61 73 65 20 61 63 63 65 73 73 20 66 61 tabase access fa
2ed80 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ster..**.** If t
2ed90 68 65 20 65 4d 6f 64 65 20 70 61 72 61 6d 65 74 he eMode paramet
2eda0 65 72 20 69 73 20 42 54 41 4c 4c 4f 43 5f 45 58 er is BTALLOC_EX
2edb0 41 43 54 20 61 6e 64 20 74 68 65 20 6e 65 61 72 ACT and the near
2edc0 62 79 20 70 61 67 65 20 65 78 69 73 74 73 0a 2a by page exists.*
2edd0 2a 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 68 * anywhere on th
2ede0 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 e free-list, the
2edf0 6e 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 n it is guarante
2ee00 65 64 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 ed to be returne
2ee10 64 2e 20 20 49 66 0a 2a 2a 20 65 4d 6f 64 65 20 d. If.** eMode
2ee20 69 73 20 42 54 41 4c 4c 4f 43 5f 4c 54 20 74 68 is BTALLOC_LT th
2ee30 65 6e 20 74 68 65 20 70 61 67 65 20 72 65 74 75 en the page retu
2ee40 72 6e 65 64 20 77 69 6c 6c 20 62 65 20 6c 65 73 rned will be les
2ee50 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 0a s than or equal.
2ee60 2a 2a 20 74 6f 20 6e 65 61 72 62 79 20 69 66 20 ** to nearby if
2ee70 61 6e 79 20 73 75 63 68 20 70 61 67 65 20 65 78 any such page ex
2ee80 69 73 74 73 2e 20 20 49 66 20 65 4d 6f 64 65 20 ists. If eMode
2ee90 69 73 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 74 is BTALLOC_ANY t
2eea0 68 65 6e 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 hen there.** are
2eeb0 20 6e 6f 20 72 65 73 74 72 69 63 74 69 6f 6e 73 no restrictions
2eec0 20 6f 6e 20 77 68 69 63 68 20 70 61 67 65 20 69 on which page i
2eed0 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 s returned..*/.s
2eee0 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 tatic int alloca
2eef0 74 65 42 74 72 65 65 50 61 67 65 28 0a 20 20 42 teBtreePage(. B
2ef00 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 tShared *pBt,
2ef10 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 /* The btr
2ef20 65 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 ee */. MemPage
2ef30 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 2f **ppPage, /
2ef40 2a 20 53 74 6f 72 65 20 70 6f 69 6e 74 65 72 20 * Store pointer
2ef50 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64 to the allocated
2ef60 20 70 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 20 page here */.
2ef70 50 67 6e 6f 20 2a 70 50 67 6e 6f 2c 20 20 20 20 Pgno *pPgno,
2ef80 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 /* Store
2ef90 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
2efa0 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e here */. Pgno n
2efb0 65 61 72 62 79 2c 20 20 20 20 20 20 20 20 20 20 earby,
2efc0 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 20 61 /* Search for a
2efd0 20 70 61 67 65 20 6e 65 61 72 20 74 68 69 73 20 page near this
2efe0 6f 6e 65 20 2a 2f 0a 20 20 75 38 20 65 4d 6f 64 one */. u8 eMod
2eff0 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e
2f000 2f 2a 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 /* BTALLOC_EXACT
2f010 2c 20 42 54 41 4c 4c 4f 43 5f 4c 54 2c 20 6f 72 , BTALLOC_LT, or
2f020 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 2a 2f 0a BTALLOC_ANY */.
2f030 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
2f040 61 67 65 31 3b 0a 20 20 69 6e 74 20 72 63 3b 0a age1;. int rc;.
2f050 20 20 75 33 32 20 6e 3b 20 20 20 20 20 2f 2a 20 u32 n; /*
2f060 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
2f070 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 on the freelist
2f080 2a 2f 0a 20 20 75 33 32 20 6b 3b 20 20 20 20 20 */. u32 k;
2f090 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 65 61 /* Number of lea
2f0a0 76 65 73 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b ves on the trunk
2f0b0 20 6f 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 of the freelist
2f0c0 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 */. MemPage *p
2f0d0 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d Trunk = 0;. Mem
2f0e0 50 61 67 65 20 2a 70 50 72 65 76 54 72 75 6e 6b Page *pPrevTrunk
2f0f0 20 3d 20 30 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 = 0;. Pgno mxP
2f100 61 67 65 3b 20 20 20 20 20 2f 2a 20 54 6f 74 61 age; /* Tota
2f110 6c 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 l size of the da
2f120 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a tabase file */..
2f130 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
2f140 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
2f150 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
2f160 73 65 72 74 28 20 65 4d 6f 64 65 3d 3d 42 54 41 sert( eMode==BTA
2f170 4c 4c 4f 43 5f 41 4e 59 20 7c 7c 20 28 6e 65 61 LLOC_ANY || (nea
2f180 72 62 79 3e 30 20 26 26 20 49 66 4e 6f 74 4f 6d rby>0 && IfNotOm
2f190 69 74 41 56 28 70 42 74 2d 3e 61 75 74 6f 56 61 itAV(pBt->autoVa
2f1a0 63 75 75 6d 29 29 20 29 3b 0a 20 20 70 50 61 67 cuum)) );. pPag
2f1b0 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 e1 = pBt->pPage1
2f1c0 3b 0a 20 20 6d 78 50 61 67 65 20 3d 20 62 74 72 ;. mxPage = btr
2f1d0 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 eePagecount(pBt)
2f1e0 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d ;. /* EVIDENCE-
2f1f0 4f 46 3a 20 52 2d 30 35 31 31 39 2d 30 32 36 33 OF: R-05119-0263
2f200 37 20 54 68 65 20 34 2d 62 79 74 65 20 62 69 67 7 The 4-byte big
2f210 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 -endian integer
2f220 61 74 20 6f 66 66 73 65 74 20 33 36 0a 20 20 2a at offset 36. *
2f230 2a 20 73 74 6f 72 65 73 20 73 74 6f 72 65 73 20 * stores stores
2f240 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 the total number
2f250 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 68 65 of pages on the
2f260 20 66 72 65 65 6c 69 73 74 2e 20 2a 2f 0a 20 20 freelist. */.
2f270 6e 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 n = get4byte(&pP
2f280 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 age1->aData[36])
2f290 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d ;. testcase( n=
2f2a0 3d 6d 78 50 61 67 65 2d 31 20 29 3b 0a 20 20 69 =mxPage-1 );. i
2f2b0 66 28 20 6e 3e 3d 6d 78 50 61 67 65 20 29 7b 0a f( n>=mxPage ){.
2f2c0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2f2d0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
2f2e0 20 20 7d 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b }. if( n>0 ){
2f2f0 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 . /* There ar
2f300 65 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 e pages on the f
2f310 72 65 65 6c 69 73 74 2e 20 20 52 65 75 73 65 20 reelist. Reuse
2f320 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 70 61 67 one of those pag
2f330 65 73 2e 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 es. */. Pgno
2f340 69 54 72 75 6e 6b 3b 0a 20 20 20 20 75 38 20 73 iTrunk;. u8 s
2f350 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 20 2f earchList = 0; /
2f360 2a 20 49 66 20 74 68 65 20 66 72 65 65 2d 6c 69 * If the free-li
2f370 73 74 20 6d 75 73 74 20 62 65 20 73 65 61 72 63 st must be searc
2f380 68 65 64 20 66 6f 72 20 27 6e 65 61 72 62 79 27 hed for 'nearby'
2f390 20 2a 2f 0a 20 20 20 20 75 33 32 20 6e 53 65 61 */. u32 nSea
2f3a0 72 63 68 20 3d 20 30 3b 20 20 20 2f 2a 20 43 6f rch = 0; /* Co
2f3b0 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 unt of the numbe
2f3c0 72 20 6f 66 20 73 65 61 72 63 68 20 61 74 74 65 r of search atte
2f3d0 6d 70 74 73 20 2a 2f 0a 20 20 20 20 0a 20 20 20 mpts */. .
2f3e0 20 2f 2a 20 49 66 20 65 4d 6f 64 65 3d 3d 42 54 /* If eMode==BT
2f3f0 41 4c 4c 4f 43 5f 45 58 41 43 54 20 61 6e 64 20 ALLOC_EXACT and
2f400 61 20 71 75 65 72 79 20 6f 66 20 74 68 65 20 70 a query of the p
2f410 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 2a ointer-map. *
2f420 2a 20 73 68 6f 77 73 20 74 68 61 74 20 74 68 65 * shows that the
2f430 20 70 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 page 'nearby' i
2f440 73 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 74 s somewhere on t
2f450 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 he free-list, th
2f460 65 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 65 6e en. ** the en
2f470 74 69 72 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 tire-list will b
2f480 65 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 74 e searched for t
2f490 68 61 74 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f hat page.. */
2f4a0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2f4b0 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
2f4c0 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 if( eMode==B
2f4d0 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 29 7b 0a TALLOC_EXACT ){.
2f4e0 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 if( nearby
2f4f0 3c 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 <=mxPage ){.
2f500 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a 20 20 u8 eType;.
2f510 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e 65 assert( ne
2f520 61 72 62 79 3e 30 20 29 3b 0a 20 20 20 20 20 20 arby>0 );.
2f530 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 assert( pBt->a
2f540 75 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 20 utoVacuum );.
2f550 20 20 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 rc = ptrmap
2f560 47 65 74 28 70 42 74 2c 20 6e 65 61 72 62 79 2c Get(pBt, nearby,
2f570 20 26 65 54 79 70 65 2c 20 30 29 3b 0a 20 20 20 &eType, 0);.
2f580 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
2f590 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 turn rc;.
2f5a0 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d if( eType==PTRM
2f5b0 41 50 5f 46 52 45 45 50 41 47 45 20 29 7b 0a 20 AP_FREEPAGE ){.
2f5c0 20 20 20 20 20 20 20 20 20 73 65 61 72 63 68 4c searchL
2f5d0 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 ist = 1;.
2f5e0 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
2f5f0 65 6c 73 65 20 69 66 28 20 65 4d 6f 64 65 3d 3d else if( eMode==
2f600 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 BTALLOC_LE ){.
2f610 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d searchList =
2f620 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 1;. }.#endif
2f630 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65 .. /* Decreme
2f640 6e 74 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 nt the free-list
2f650 20 63 6f 75 6e 74 20 62 79 20 31 2e 20 53 65 74 count by 1. Set
2f660 20 69 54 72 75 6e 6b 20 74 6f 20 74 68 65 20 69 iTrunk to the i
2f670 6e 64 65 78 20 6f 66 20 74 68 65 0a 20 20 20 20 ndex of the.
2f680 2a 2a 20 66 69 72 73 74 20 66 72 65 65 2d 6c 69 ** first free-li
2f690 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 69 st trunk page. i
2f6a0 50 72 65 76 54 72 75 6e 6b 20 69 73 20 69 6e 69 PrevTrunk is ini
2f6b0 74 69 61 6c 6c 79 20 31 2e 0a 20 20 20 20 2a 2f tially 1.. */
2f6c0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2f6d0 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 3PagerWrite(pPag
2f6e0 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e1->pDbPage);.
2f6f0 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
2f700 6e 20 72 63 3b 0a 20 20 20 20 70 75 74 34 62 79 n rc;. put4by
2f710 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
2f720 61 5b 33 36 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 20 a[36], n-1);..
2f730 20 20 2f 2a 20 54 68 65 20 63 6f 64 65 20 77 69 /* The code wi
2f740 74 68 69 6e 20 74 68 69 73 20 6c 6f 6f 70 20 69 thin this loop i
2f750 73 20 72 75 6e 20 6f 6e 6c 79 20 6f 6e 63 65 20 s run only once
2f760 69 66 20 74 68 65 20 27 73 65 61 72 63 68 4c 69 if the 'searchLi
2f770 73 74 27 20 76 61 72 69 61 62 6c 65 0a 20 20 20 st' variable.
2f780 20 2a 2a 20 69 73 20 6e 6f 74 20 74 72 75 65 2e ** is not true.
2f790 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 72 Otherwise, it r
2f7a0 75 6e 73 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 uns once for eac
2f7b0 68 20 74 72 75 6e 6b 2d 70 61 67 65 20 6f 6e 20 h trunk-page on
2f7c0 74 68 65 0a 20 20 20 20 2a 2a 20 66 72 65 65 2d the. ** free-
2f7d0 6c 69 73 74 20 75 6e 74 69 6c 20 74 68 65 20 70 list until the p
2f7e0 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 age 'nearby' is
2f7f0 6c 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 3d 3d located (eMode==
2f800 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 0a 20 BTALLOC_EXACT).
2f810 20 20 20 2a 2a 20 6f 72 20 75 6e 74 69 6c 20 61 ** or until a
2f820 20 70 61 67 65 20 6c 65 73 73 20 74 68 61 6e 20 page less than
2f830 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f 63 61 'nearby' is loca
2f840 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 4c ted (eMode==BTAL
2f850 4c 4f 43 5f 4c 54 29 0a 20 20 20 20 2a 2f 0a 20 LOC_LT). */.
2f860 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 70 50 do {. pP
2f870 72 65 76 54 72 75 6e 6b 20 3d 20 70 54 72 75 6e revTrunk = pTrun
2f880 6b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 72 k;. if( pPr
2f890 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 evTrunk ){.
2f8a0 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
2f8b0 46 3a 20 52 2d 30 31 35 30 36 2d 31 31 30 35 33 F: R-01506-11053
2f8c0 20 54 68 65 20 66 69 72 73 74 20 69 6e 74 65 67 The first integ
2f8d0 65 72 20 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 er on a freelist
2f8e0 20 74 72 75 6e 6b 20 70 61 67 65 0a 20 20 20 20 trunk page.
2f8f0 20 20 20 20 2a 2a 20 69 73 20 74 68 65 20 70 61 ** is the pa
2f900 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 ge number of the
2f910 20 6e 65 78 74 20 66 72 65 65 6c 69 73 74 20 74 next freelist t
2f920 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 65 runk page in the
2f930 20 6c 69 73 74 20 6f 72 0a 20 20 20 20 20 20 20 list or.
2f940 20 2a 2a 20 7a 65 72 6f 20 69 66 20 74 68 69 73 ** zero if this
2f950 20 69 73 20 74 68 65 20 6c 61 73 74 20 66 72 65 is the last fre
2f960 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 elist trunk page
2f970 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 54 72 . */. iTr
2f980 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 unk = get4byte(&
2f990 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 pPrevTrunk->aDat
2f9a0 61 5b 30 5d 29 3b 0a 20 20 20 20 20 20 7d 65 6c a[0]);. }el
2f9b0 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 se{. /* E
2f9c0 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 39 VIDENCE-OF: R-59
2f9d0 38 34 31 2d 31 33 37 39 38 20 54 68 65 20 34 2d 841-13798 The 4-
2f9e0 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 byte big-endian
2f9f0 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 integer at offse
2fa00 74 20 33 32 0a 20 20 20 20 20 20 20 20 2a 2a 20 t 32. **
2fa10 73 74 6f 72 65 73 20 74 68 65 20 70 61 67 65 20 stores the page
2fa20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 66 69 number of the fi
2fa30 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 rst page of the
2fa40 66 72 65 65 6c 69 73 74 2c 20 6f 72 20 7a 65 72 freelist, or zer
2fa50 6f 20 69 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 o if. **
2fa60 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 the freelist is
2fa70 65 6d 70 74 79 2e 20 2a 2f 0a 20 20 20 20 20 20 empty. */.
2fa80 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 iTrunk = get4b
2fa90 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
2faa0 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 20 20 7d ta[32]);. }
2fab0 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 . testcase(
2fac0 20 69 54 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 iTrunk==mxPage
2fad0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 54 72 );. if( iTr
2fae0 75 6e 6b 3e 6d 78 50 61 67 65 20 7c 7c 20 6e 53 unk>mxPage || nS
2faf0 65 61 72 63 68 2b 2b 20 3e 20 6e 20 29 7b 0a 20 earch++ > n ){.
2fb00 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
2fb10 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
2fb20 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
2fb30 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 rc = btree
2fb40 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 GetUnusedPage(pB
2fb50 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 t, iTrunk, &pTru
2fb60 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a nk, 0);. }.
2fb70 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
2fb80 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d pTrunk =
2fb90 20 30 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 0;. goto
2fba0 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
2fbb0 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ge;. }.
2fbc0 20 20 61 73 73 65 72 74 28 20 70 54 72 75 6e 6b assert( pTrunk
2fbd0 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 !=0 );. ass
2fbe0 65 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 44 61 ert( pTrunk->aDa
2fbf0 74 61 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 2f ta!=0 );. /
2fc00 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
2fc10 2d 31 33 35 32 33 2d 30 34 33 39 34 20 54 68 65 -13523-04394 The
2fc20 20 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 72 20 second integer
2fc30 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 20 74 72 on a freelist tr
2fc40 75 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 20 2a unk page. *
2fc50 2a 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 * is the number
2fc60 6f 66 20 6c 65 61 66 20 70 61 67 65 20 70 6f 69 of leaf page poi
2fc70 6e 74 65 72 73 20 74 6f 20 66 6f 6c 6c 6f 77 2e nters to follow.
2fc80 20 2a 2f 0a 20 20 20 20 20 20 6b 20 3d 20 67 65 */. k = ge
2fc90 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e t4byte(&pTrunk->
2fca0 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 20 20 aData[4]);.
2fcb0 20 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 73 65 if( k==0 && !se
2fcc0 61 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 20 20 archList ){.
2fcd0 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b /* The trunk
2fce0 20 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 20 61 has no leaves a
2fcf0 6e 64 20 74 68 65 20 6c 69 73 74 20 69 73 20 6e nd the list is n
2fd00 6f 74 20 62 65 69 6e 67 20 73 65 61 72 63 68 65 ot being searche
2fd10 64 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 d. . ** S
2fd20 6f 20 65 78 74 72 61 63 74 20 74 68 65 20 74 72 o extract the tr
2fd30 75 6e 6b 20 70 61 67 65 20 69 74 73 65 6c 66 20 unk page itself
2fd40 61 6e 64 20 75 73 65 20 69 74 20 61 73 20 74 68 and use it as th
2fd50 65 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 20 20 e newly .
2fd60 20 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 ** allocated pa
2fd70 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 ge */. as
2fd80 73 65 72 74 28 20 70 50 72 65 76 54 72 75 6e 6b sert( pPrevTrunk
2fd90 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 ==0 );. r
2fda0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2fdb0 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 Write(pTrunk->pD
2fdc0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
2fdd0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
2fde0 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
2fdf0 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
2fe00 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2a 70 }. *p
2fe10 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 Pgno = iTrunk;.
2fe20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
2fe30 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
2fe40 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
2fe50 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
2fe60 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e *ppPage = pTrun
2fe70 6b 3b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e k;. pTrun
2fe80 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 54 k = 0;. T
2fe90 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a RACE(("ALLOCATE:
2fea0 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 20 66 %d trunk - %d f
2feb0 72 65 65 20 70 61 67 65 73 20 6c 65 66 74 5c 6e ree pages left\n
2fec0 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 29 29 ", *pPgno, n-1))
2fed0 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 ;. }else if
2fee0 28 20 6b 3e 28 75 33 32 29 28 70 42 74 2d 3e 75 ( k>(u32)(pBt->u
2fef0 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 29 sableSize/4 - 2)
2ff00 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 56 ){. /* V
2ff10 61 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f 75 74 alue of k is out
2ff20 20 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 74 61 of range. Data
2ff30 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 base corruption
2ff40 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 */. rc =
2ff50 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
2ff60 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 KPT;. got
2ff70 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
2ff80 61 67 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c age;.#ifndef SQL
2ff90 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
2ffa0 55 55 4d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 UUM. }else
2ffb0 69 66 28 20 73 65 61 72 63 68 4c 69 73 74 20 0a if( searchList .
2ffc0 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 && (
2ffd0 6e 65 61 72 62 79 3d 3d 69 54 72 75 6e 6b 20 7c nearby==iTrunk |
2ffe0 7c 20 28 69 54 72 75 6e 6b 3c 6e 65 61 72 62 79 | (iTrunk<nearby
2fff0 20 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c && eMode==BTALL
30000 4f 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 20 29 OC_LE)) . )
30010 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 {. /* The
30020 20 6c 69 73 74 20 69 73 20 62 65 69 6e 67 20 73 list is being s
30030 65 61 72 63 68 65 64 20 61 6e 64 20 74 68 69 73 earched and this
30040 20 74 72 75 6e 6b 20 70 61 67 65 20 69 73 20 74 trunk page is t
30050 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 he page.
30060 2a 2a 20 74 6f 20 61 6c 6c 6f 63 61 74 65 2c 20 ** to allocate,
30070 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 regardless of wh
30080 65 74 68 65 72 20 69 74 20 68 61 73 20 6c 65 61 ether it has lea
30090 76 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ves.. */.
300a0 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 3d *pPgno =
300b0 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 iTrunk;.
300c0 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e *ppPage = pTrun
300d0 6b 3b 0a 20 20 20 20 20 20 20 20 73 65 61 72 63 k;. searc
300e0 68 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 hList = 0;.
300f0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
30100 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b agerWrite(pTrunk
30110 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
30120 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
30130 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
30140 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
30150 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
30160 20 20 69 66 28 20 6b 3d 3d 30 20 29 7b 0a 20 20 if( k==0 ){.
30170 20 20 20 20 20 20 20 20 69 66 28 20 21 70 50 72 if( !pPr
30180 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 evTrunk ){.
30190 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
301a0 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
301b0 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
301c0 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
301d0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
301e0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
301f0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 72 e3PagerWrite(pPr
30200 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 evTrunk->pDbPage
30210 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
30220 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
30230 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
30240 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
30250 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
30260 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
30270 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 72 65 memcpy(&pPre
30280 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d vTrunk->aData[0]
30290 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 , &pTrunk->aData
302a0 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 [0], 4);.
302b0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c }. }el
302c0 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a se{. /*
302d0 20 54 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 The trunk page
302e0 69 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 is required by t
302f0 68 65 20 63 61 6c 6c 65 72 20 62 75 74 20 69 74 he caller but it
30300 20 63 6f 6e 74 61 69 6e 73 20 0a 20 20 20 20 20 contains .
30310 20 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 73 ** pointers
30320 20 74 6f 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 to free-list le
30330 61 76 65 73 2e 20 54 68 65 20 66 69 72 73 74 20 aves. The first
30340 6c 65 61 66 20 62 65 63 6f 6d 65 73 20 61 20 74 leaf becomes a t
30350 72 75 6e 6b 0a 20 20 20 20 20 20 20 20 20 20 2a runk. *
30360 2a 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 63 * page in this c
30370 61 73 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a ase.. *
30380 2f 0a 20 20 20 20 20 20 20 20 20 20 4d 65 6d 50 /. MemP
30390 61 67 65 20 2a 70 4e 65 77 54 72 75 6e 6b 3b 0a age *pNewTrunk;.
303a0 20 20 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 Pgno i
303b0 4e 65 77 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 NewTrunk = get4b
303c0 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
303d0 74 61 5b 38 5d 29 3b 0a 20 20 20 20 20 20 20 20 ta[8]);.
303e0 20 20 69 66 28 20 69 4e 65 77 54 72 75 6e 6b 3e if( iNewTrunk>
303f0 6d 78 50 61 67 65 20 29 7b 20 0a 20 20 20 20 20 mxPage ){ .
30400 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
30410 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
30420 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 . got
30430 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
30440 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d age;. }
30450 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 . testc
30460 61 73 65 28 20 69 4e 65 77 54 72 75 6e 6b 3d 3d ase( iNewTrunk==
30470 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
30480 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 rc = btreeGe
30490 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 74 2c tUnusedPage(pBt,
304a0 20 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 4e 65 iNewTrunk, &pNe
304b0 77 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 wTrunk, 0);.
304c0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
304d0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
304e0 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
304f0 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
30500 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
30510 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
30520 33 50 61 67 65 72 57 72 69 74 65 28 70 4e 65 77 3PagerWrite(pNew
30530 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
30540 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
30550 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
30560 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 rele
30570 61 73 65 50 61 67 65 28 70 4e 65 77 54 72 75 6e asePage(pNewTrun
30580 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 k);.
30590 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 goto end_allocat
305a0 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 e_page;.
305b0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 6d 65 }. me
305c0 6d 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d mcpy(&pNewTrunk-
305d0 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 >aData[0], &pTru
305e0 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 nk->aData[0], 4)
305f0 3b 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 ;. put4
30600 62 79 74 65 28 26 70 4e 65 77 54 72 75 6e 6b 2d byte(&pNewTrunk-
30610 3e 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b >aData[4], k-1);
30620 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 . memcp
30630 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 y(&pNewTrunk->aD
30640 61 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e 6b 2d ata[8], &pTrunk-
30650 3e 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b 2d 31 >aData[12], (k-1
30660 29 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 )*4);.
30670 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 releasePage(pNew
30680 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 Trunk);.
30690 20 20 69 66 28 20 21 70 50 72 65 76 54 72 75 6e if( !pPrevTrun
306a0 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 k ){.
306b0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
306c0 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
306d0 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 (pPage1->pDbPage
306e0 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ) );.
306f0 20 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 put4byte(&pPage
30700 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 4e 1->aData[32], iN
30710 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
30720 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
30730 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
30740 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
30750 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 revTrunk->pDbPag
30760 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
30770 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
30780 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
30790 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
307a0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
307b0 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 put4by
307c0 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e te(&pPrevTrunk->
307d0 61 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 54 72 aData[0], iNewTr
307e0 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 unk);.
307f0 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
30800 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a pTrunk = 0;.
30810 20 20 20 20 20 20 20 20 54 52 41 43 45 28 28 22 TRACE(("
30820 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 72 75 ALLOCATE: %d tru
30830 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 61 67 nk - %d free pag
30840 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 50 67 es left\n", *pPg
30850 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e 64 69 no, n-1));.#endi
30860 66 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 f. }else if
30870 28 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 ( k>0 ){.
30880 20 2f 2a 20 45 78 74 72 61 63 74 20 61 20 6c 65 /* Extract a le
30890 61 66 20 66 72 6f 6d 20 74 68 65 20 74 72 75 6e af from the trun
308a0 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 32 k */. u32
308b0 20 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 20 20 closest;.
308c0 20 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a 20 20 Pgno iPage;.
308d0 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 unsigned c
308e0 68 61 72 20 2a 61 44 61 74 61 20 3d 20 70 54 72 har *aData = pTr
308f0 75 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 unk->aData;.
30900 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 3e 30 if( nearby>0
30910 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33 ){. u3
30920 32 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 63 2 i;. c
30930 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 losest = 0;.
30940 20 20 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d if( eMode=
30950 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 =BTALLOC_LE ){.
30960 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 for(i
30970 3d 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 =0; i<k; i++){.
30980 20 20 20 20 20 20 20 20 20 20 20 20 20 69 50 61 iPa
30990 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 ge = get4byte(&a
309a0 44 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a 20 20 Data[8+i*4]);.
309b0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
309c0 69 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 29 7b iPage<=nearby ){
309d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
309e0 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 20 closest = i;.
309f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 br
30a00 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 eak;.
30a10 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 }.
30a20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c }. }el
30a30 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 se{.
30a40 69 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 20 20 int dist;.
30a50 20 20 20 20 20 20 64 69 73 74 20 3d 20 73 71 6c dist = sql
30a60 69 74 65 33 41 62 73 49 6e 74 33 32 28 67 65 74 ite3AbsInt32(get
30a70 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 5d 29 4byte(&aData[8])
30a80 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 20 20 - nearby);.
30a90 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 31 3b for(i=1;
30aa0 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 i<k; i++){.
30ab0 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 32 int d2
30ac0 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 = sqlite3AbsInt
30ad0 33 32 28 67 65 74 34 62 79 74 65 28 26 61 44 61 32(get4byte(&aDa
30ae0 74 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e 65 61 ta[8+i*4]) - nea
30af0 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 rby);.
30b00 20 20 20 20 69 66 28 20 64 32 3c 64 69 73 74 20 if( d2<dist
30b10 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
30b20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a closest = i;.
30b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30b40 64 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 20 20 dist = d2;.
30b50 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
30b60 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
30b70 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c }. }el
30b80 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6c se{. cl
30b90 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 osest = 0;.
30ba0 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 50 }.. iP
30bb0 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 age = get4byte(&
30bc0 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a aData[8+closest*
30bd0 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 4]);. tes
30be0 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d 78 tcase( iPage==mx
30bf0 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 20 Page );.
30c00 69 66 28 20 69 50 61 67 65 3e 6d 78 50 61 67 65 if( iPage>mxPage
30c10 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
30c20 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
30c30 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 T_BKPT;.
30c40 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
30c50 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
30c60 20 20 7d 0a 20 20 20 20 20 20 20 20 74 65 73 74 }. test
30c70 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d 78 50 case( iPage==mxP
30c80 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 age );. i
30c90 66 28 20 21 73 65 61 72 63 68 4c 69 73 74 20 0a f( !searchList .
30ca0 20 20 20 20 20 20 20 20 20 7c 7c 20 28 69 50 61 || (iPa
30cb0 67 65 3d 3d 6e 65 61 72 62 79 20 7c 7c 20 28 69 ge==nearby || (i
30cc0 50 61 67 65 3c 6e 65 61 72 62 79 20 26 26 20 65 Page<nearby && e
30cd0 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 Mode==BTALLOC_LE
30ce0 29 29 20 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 )) . ){.
30cf0 20 20 20 20 20 20 20 20 20 69 6e 74 20 6e 6f 43 int noC
30d00 6f 6e 74 65 6e 74 3b 0a 20 20 20 20 20 20 20 20 ontent;.
30d10 20 20 2a 70 50 67 6e 6f 20 3d 20 69 50 61 67 65 *pPgno = iPage
30d20 3b 0a 20 20 20 20 20 20 20 20 20 20 54 52 41 43 ;. TRAC
30d30 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 E(("ALLOCATE: %d
30d40 20 77 61 73 20 6c 65 61 66 20 25 64 20 6f 66 20 was leaf %d of
30d50 25 64 20 6f 6e 20 74 72 75 6e 6b 20 25 64 22 0a %d on trunk %d".
30d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30d70 20 22 3a 20 25 64 20 6d 6f 72 65 20 66 72 65 65 ": %d more free
30d80 20 70 61 67 65 73 5c 6e 22 2c 0a 20 20 20 20 20 pages\n",.
30d90 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 *pPg
30da0 6e 6f 2c 20 63 6c 6f 73 65 73 74 2b 31 2c 20 6b no, closest+1, k
30db0 2c 20 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f 2c 20 , pTrunk->pgno,
30dc0 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 n-1));.
30dd0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
30de0 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e erWrite(pTrunk->
30df0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
30e00 20 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 if( rc ) got
30e10 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
30e20 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 69 age;. i
30e30 66 28 20 63 6c 6f 73 65 73 74 3c 6b 2d 31 20 29 f( closest<k-1 )
30e40 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 {. me
30e50 6d 63 70 79 28 26 61 44 61 74 61 5b 38 2b 63 6c mcpy(&aData[8+cl
30e60 6f 73 65 73 74 2a 34 5d 2c 20 26 61 44 61 74 61 osest*4], &aData
30e70 5b 34 2b 6b 2a 34 5d 2c 20 34 29 3b 0a 20 20 20 [4+k*4], 4);.
30e80 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
30e90 20 20 20 70 75 74 34 62 79 74 65 28 26 61 44 61 put4byte(&aDa
30ea0 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 20 20 ta[4], k-1);.
30eb0 20 20 20 20 20 20 20 6e 6f 43 6f 6e 74 65 6e 74 noContent
30ec0 20 3d 20 21 62 74 72 65 65 47 65 74 48 61 73 43 = !btreeGetHasC
30ed0 6f 6e 74 65 6e 74 28 70 42 74 2c 20 2a 70 50 67 ontent(pBt, *pPg
30ee0 6e 6f 29 3f 20 50 41 47 45 52 5f 47 45 54 5f 4e no)? PAGER_GET_N
30ef0 4f 43 4f 4e 54 45 4e 54 20 3a 20 30 3b 0a 20 20 OCONTENT : 0;.
30f00 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 rc = btr
30f10 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 eeGetUnusedPage(
30f20 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 50 pBt, *pPgno, ppP
30f30 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e 74 29 3b age, noContent);
30f40 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
30f50 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
30f60 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
30f70 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
30f80 74 65 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 te((*ppPage)->pD
30f90 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
30fa0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
30fb0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
30fc0 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 releasePa
30fd0 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 ge(*ppPage);.
30fe0 20 20 20 20 20 20 20 20 20 20 20 2a 70 70 50 61 *ppPa
30ff0 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ge = 0;.
31000 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
31010 7d 0a 20 20 20 20 20 20 20 20 20 20 73 65 61 72 }. sear
31020 63 68 4c 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 chList = 0;.
31030 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
31040 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
31050 70 50 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 20 pPrevTrunk);.
31060 20 20 20 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 pPrevTrunk =
31070 30 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 73 0;. }while( s
31080 65 61 72 63 68 4c 69 73 74 20 29 3b 0a 20 20 7d earchList );. }
31090 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 else{. /* The
310a0 72 65 20 61 72 65 20 6e 6f 20 70 61 67 65 73 20 re are no pages
310b0 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 2c on the freelist,
310c0 20 73 6f 20 61 70 70 65 6e 64 20 61 20 6e 65 77 so append a new
310d0 20 70 61 67 65 20 74 6f 20 74 68 65 0a 20 20 20 page to the.
310e0 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 ** database ima
310f0 67 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a ge.. **. *
31100 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 65 77 20 * Normally, new
31110 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 pages allocated
31120 62 79 20 74 68 69 73 20 62 6c 6f 63 6b 20 63 61 by this block ca
31130 6e 20 62 65 20 72 65 71 75 65 73 74 65 64 20 66 n be requested f
31140 72 6f 6d 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 rom the. ** p
31150 61 67 65 72 20 6c 61 79 65 72 20 77 69 74 68 20 ager layer with
31160 74 68 65 20 27 6e 6f 2d 63 6f 6e 74 65 6e 74 27 the 'no-content'
31170 20 66 6c 61 67 20 73 65 74 2e 20 54 68 69 73 20 flag set. This
31180 70 72 65 76 65 6e 74 73 20 74 68 65 20 70 61 67 prevents the pag
31190 65 72 0a 20 20 20 20 2a 2a 20 66 72 6f 6d 20 74 er. ** from t
311a0 72 79 69 6e 67 20 74 6f 20 72 65 61 64 20 74 68 rying to read th
311b0 65 20 70 61 67 65 73 20 63 6f 6e 74 65 6e 74 20 e pages content
311c0 66 72 6f 6d 20 64 69 73 6b 2e 20 48 6f 77 65 76 from disk. Howev
311d0 65 72 2c 20 69 66 20 74 68 65 0a 20 20 20 20 2a er, if the. *
311e0 2a 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 * current transa
311f0 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 ction has alread
31200 79 20 72 75 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 y run one or mor
31210 65 20 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 e incremental-va
31220 63 75 75 6d 0a 20 20 20 20 2a 2a 20 73 74 65 70 cuum. ** step
31230 73 2c 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 s, then the page
31240 20 77 65 20 61 72 65 20 61 62 6f 75 74 20 74 6f we are about to
31250 20 61 6c 6c 6f 63 61 74 65 20 6d 61 79 20 63 6f allocate may co
31260 6e 74 61 69 6e 20 63 6f 6e 74 65 6e 74 0a 20 20 ntain content.
31270 20 20 2a 2a 20 74 68 61 74 20 69 73 20 72 65 71 ** that is req
31280 75 69 72 65 64 20 69 6e 20 74 68 65 20 65 76 65 uired in the eve
31290 6e 74 20 6f 66 20 61 20 72 6f 6c 6c 62 61 63 6b nt of a rollback
312a0 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 . In this case,
312b0 64 6f 0a 20 20 20 20 2a 2a 20 6e 6f 74 20 73 65 do. ** not se
312c0 74 20 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 t the no-content
312d0 20 66 6c 61 67 2e 20 54 68 69 73 20 63 61 75 73 flag. This caus
312e0 65 73 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 es the pager to
312f0 6c 6f 61 64 20 61 6e 64 20 6a 6f 75 72 6e 61 6c load and journal
31300 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 75 72 72 . ** the curr
31310 65 6e 74 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ent page content
31320 20 62 65 66 6f 72 65 20 6f 76 65 72 77 72 69 74 before overwrit
31330 69 6e 67 20 69 74 2e 0a 20 20 20 20 2a 2a 0a 20 ing it.. **.
31340 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 ** Note that
31350 74 68 65 20 70 61 67 65 72 20 77 69 6c 6c 20 6e the pager will n
31360 6f 74 20 61 63 74 75 61 6c 6c 79 20 61 74 74 65 ot actually atte
31370 6d 70 74 20 74 6f 20 6c 6f 61 64 20 6f 72 20 6a mpt to load or j
31380 6f 75 72 6e 61 6c 20 0a 20 20 20 20 2a 2a 20 63 ournal . ** c
31390 6f 6e 74 65 6e 74 20 66 6f 72 20 61 6e 79 20 70 ontent for any p
313a0 61 67 65 20 74 68 61 74 20 72 65 61 6c 6c 79 20 age that really
313b0 64 6f 65 73 20 6c 69 65 20 70 61 73 74 20 74 68 does lie past th
313c0 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 e end of the dat
313d0 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c abase. ** fil
313e0 65 20 6f 6e 20 64 69 73 6b 2e 20 53 6f 20 74 68 e on disk. So th
313f0 65 20 65 66 66 65 63 74 73 20 6f 66 20 64 69 73 e effects of dis
31400 61 62 6c 69 6e 67 20 74 68 65 20 6e 6f 2d 63 6f abling the no-co
31410 6e 74 65 6e 74 20 6f 70 74 69 6d 69 7a 61 74 69 ntent optimizati
31420 6f 6e 0a 20 20 20 20 2a 2a 20 68 65 72 65 20 61 on. ** here a
31430 72 65 20 63 6f 6e 66 69 6e 65 64 20 74 6f 20 74 re confined to t
31440 68 6f 73 65 20 70 61 67 65 73 20 74 68 61 74 20 hose pages that
31450 6c 69 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 lie between the
31460 65 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 20 2a end of the. *
31470 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 67 65 * database image
31480 20 61 6e 64 20 74 68 65 20 65 6e 64 20 6f 66 20 and the end of
31490 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
314a0 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e e.. */. in
314b0 74 20 62 4e 6f 43 6f 6e 74 65 6e 74 20 3d 20 28 t bNoContent = (
314c0 30 3d 3d 49 66 4e 6f 74 4f 6d 69 74 41 56 28 70 0==IfNotOmitAV(p
314d0 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 29 Bt->bDoTruncate)
314e0 29 3f 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 )? PAGER_GET_NOC
314f0 4f 4e 54 45 4e 54 3a 30 3b 0a 0a 20 20 20 20 72 ONTENT:0;.. r
31500 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
31510 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 67 65 Write(pBt->pPage
31520 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 1->pDbPage);.
31530 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
31540 20 72 63 3b 0a 20 20 20 20 70 42 74 2d 3e 6e 50 rc;. pBt->nP
31550 61 67 65 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 age++;. if( p
31560 42 74 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 Bt->nPage==PENDI
31570 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
31580 29 20 29 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b ) ) pBt->nPage++
31590 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ;..#ifndef SQLIT
315a0 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
315b0 4d 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 M. if( pBt->a
315c0 75 74 6f 56 61 63 75 75 6d 20 26 26 20 50 54 52 utoVacuum && PTR
315d0 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
315e0 70 42 74 2d 3e 6e 50 61 67 65 29 20 29 7b 0a 20 pBt->nPage) ){.
315f0 20 20 20 20 20 2f 2a 20 49 66 20 2a 70 50 67 6e /* If *pPgn
31600 6f 20 72 65 66 65 72 73 20 74 6f 20 61 20 70 6f o refers to a po
31610 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 inter-map page,
31620 61 6c 6c 6f 63 61 74 65 20 74 77 6f 20 6e 65 77 allocate two new
31630 20 70 61 67 65 73 0a 20 20 20 20 20 20 2a 2a 20 pages. **
31640 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 at the end of th
31650 65 20 66 69 6c 65 20 69 6e 73 74 65 61 64 20 6f e file instead o
31660 66 20 6f 6e 65 2e 20 54 68 65 20 66 69 72 73 74 f one. The first
31670 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 0a allocated page.
31680 20 20 20 20 20 20 2a 2a 20 62 65 63 6f 6d 65 73 ** becomes
31690 20 61 20 6e 65 77 20 70 6f 69 6e 74 65 72 2d 6d a new pointer-m
316a0 61 70 20 70 61 67 65 2c 20 74 68 65 20 73 65 63 ap page, the sec
316b0 6f 6e 64 20 69 73 20 75 73 65 64 20 62 79 20 74 ond is used by t
316c0 68 65 20 63 61 6c 6c 65 72 2e 0a 20 20 20 20 20 he caller..
316d0 20 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 */. MemPag
316e0 65 20 2a 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 e *pPg = 0;.
316f0 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 TRACE(("ALLOCA
31700 54 45 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 TE: %d from end
31710 6f 66 20 66 69 6c 65 20 28 70 6f 69 6e 74 65 72 of file (pointer
31720 2d 6d 61 70 20 70 61 67 65 29 5c 6e 22 2c 20 70 -map page)\n", p
31730 42 74 2d 3e 6e 50 61 67 65 29 29 3b 0a 20 20 20 Bt->nPage));.
31740 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e assert( pBt->
31750 6e 50 61 67 65 21 3d 50 45 4e 44 49 4e 47 5f 42 nPage!=PENDING_B
31760 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b YTE_PAGE(pBt) );
31770 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 . rc = btre
31780 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 eGetUnusedPage(p
31790 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 65 2c 20 Bt, pBt->nPage,
317a0 26 70 50 67 2c 20 62 4e 6f 43 6f 6e 74 65 6e 74 &pPg, bNoContent
317b0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
317c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
317d0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
317e0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 67 e3PagerWrite(pPg
317f0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
31800 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
31810 70 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 pPg);. }.
31820 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
31830 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 70 42 urn rc;. pB
31840 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 t->nPage++;.
31850 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 if( pBt->nPage
31860 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 ==PENDING_BYTE_P
31870 41 47 45 28 70 42 74 29 20 29 7b 20 70 42 74 2d AGE(pBt) ){ pBt-
31880 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 20 20 20 >nPage++; }.
31890 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 75 74 }.#endif. put
318a0 34 62 79 74 65 28 32 38 20 2b 20 28 75 38 2a 29 4byte(28 + (u8*)
318b0 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 pBt->pPage1->aDa
318c0 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b ta, pBt->nPage);
318d0 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 70 42 . *pPgno = pB
318e0 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 20 20 61 t->nPage;.. a
318f0 73 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 3d 50 ssert( *pPgno!=P
31900 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
31910 28 70 42 74 29 20 29 3b 0a 20 20 20 20 72 63 20 (pBt) );. rc
31920 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 = btreeGetUnused
31930 50 61 67 65 28 70 42 74 2c 20 2a 70 50 67 6e 6f Page(pBt, *pPgno
31940 2c 20 70 70 50 61 67 65 2c 20 62 4e 6f 43 6f 6e , ppPage, bNoCon
31950 74 65 6e 74 29 3b 0a 20 20 20 20 69 66 28 20 72 tent);. if( r
31960 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
31970 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
31980 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 50 61 agerWrite((*ppPa
31990 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge)->pDbPage);.
319a0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
319b0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
319c0 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 leasePage(*ppPag
319d0 65 29 3b 0a 20 20 20 20 20 20 2a 70 70 50 61 67 e);. *ppPag
319e0 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 e = 0;. }.
319f0 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 TRACE(("ALLOCAT
31a00 45 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 6f E: %d from end o
31a10 66 20 66 69 6c 65 5c 6e 22 2c 20 2a 70 50 67 6e f file\n", *pPgn
31a20 6f 29 29 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 o));. }.. asse
31a30 72 74 28 20 2a 70 50 67 6e 6f 21 3d 50 45 4e 44 rt( *pPgno!=PEND
31a40 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 ING_BYTE_PAGE(pB
31a50 74 29 20 29 3b 0a 0a 65 6e 64 5f 61 6c 6c 6f 63 t) );..end_alloc
31a60 61 74 65 5f 70 61 67 65 3a 0a 20 20 72 65 6c 65 ate_page:. rele
31a70 61 73 65 50 61 67 65 28 70 54 72 75 6e 6b 29 3b asePage(pTrunk);
31a80 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 . releasePage(p
31a90 50 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 61 73 PrevTrunk);. as
31aa0 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
31ab0 5f 4f 4b 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 _OK || sqlite3Pa
31ac0 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 gerPageRefcount(
31ad0 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 61 (*ppPage)->pDbPa
31ae0 67 65 29 3c 3d 31 20 29 3b 0a 20 20 61 73 73 65 ge)<=1 );. asse
31af0 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f rt( rc!=SQLITE_O
31b00 4b 20 7c 7c 20 28 2a 70 70 50 61 67 65 29 2d 3e K || (*ppPage)->
31b10 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 72 isInit==0 );. r
31b20 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
31b30 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
31b40 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 64 20 is used to add
31b50 70 61 67 65 20 69 50 61 67 65 20 74 6f 20 74 68 page iPage to th
31b60 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
31b70 66 72 65 65 2d 6c 69 73 74 2e 20 0a 2a 2a 20 49 free-list. .** I
31b80 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 t is assumed tha
31b90 74 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f t the page is no
31ba0 74 20 61 6c 72 65 61 64 79 20 61 20 70 61 72 74 t already a part
31bb0 20 6f 66 20 74 68 65 20 66 72 65 65 2d 6c 69 73 of the free-lis
31bc0 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 61 6c t..**.** The val
31bd0 75 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65 ue passed as the
31be0 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
31bf0 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f to this functio
31c00 6e 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 0a 2a n is optional..*
31c10 2a 20 49 66 20 74 68 65 20 63 61 6c 6c 65 72 20 * If the caller
31c20 68 61 70 70 65 6e 73 20 74 6f 20 68 61 76 65 20 happens to have
31c30 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
31c40 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 63 74 20 MemPage object
31c50 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e .** correspondin
31c60 67 20 74 6f 20 70 61 67 65 20 69 50 61 67 65 20 g to page iPage
31c70 68 61 6e 64 79 2c 20 69 74 20 6d 61 79 20 70 61 handy, it may pa
31c80 73 73 20 69 74 20 61 73 20 74 68 65 20 73 65 63 ss it as the sec
31c90 6f 6e 64 20 76 61 6c 75 65 2e 20 0a 2a 2a 20 4f ond value. .** O
31ca0 74 68 65 72 77 69 73 65 2c 20 69 74 20 6d 61 79 therwise, it may
31cb0 20 70 61 73 73 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a pass NULL..**.*
31cc0 2a 20 49 66 20 61 20 70 6f 69 6e 74 65 72 20 74 * If a pointer t
31cd0 6f 20 61 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 o a MemPage obje
31ce0 63 74 20 69 73 20 70 61 73 73 65 64 20 61 73 20 ct is passed as
31cf0 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d the second argum
31d00 65 6e 74 2c 0a 2a 2a 20 69 74 73 20 72 65 66 65 ent,.** its refe
31d10 72 65 6e 63 65 20 63 6f 75 6e 74 20 69 73 20 6e rence count is n
31d20 6f 74 20 61 6c 74 65 72 65 64 20 62 79 20 74 68 ot altered by th
31d30 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a is function..*/.
31d40 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 65 50 static int freeP
31d50 61 67 65 32 28 42 74 53 68 61 72 65 64 20 2a 70 age2(BtShared *p
31d60 42 74 2c 20 4d 65 6d 50 61 67 65 20 2a 70 4d 65 Bt, MemPage *pMe
31d70 6d 50 61 67 65 2c 20 50 67 6e 6f 20 69 50 61 67 mPage, Pgno iPag
31d80 65 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 e){. MemPage *p
31d90 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 20 20 Trunk = 0;
31da0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 /* Fre
31db0 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 e-list trunk pag
31dc0 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 54 72 75 e */. Pgno iTru
31dd0 6e 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 nk = 0;
31de0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
31df0 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 65 ge number of fre
31e00 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 e-list trunk pag
31e10 65 20 2a 2f 20 0a 20 20 4d 65 6d 50 61 67 65 20 e */ . MemPage
31e20 2a 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 *pPage1 = pBt->p
31e30 50 61 67 65 31 3b 20 20 20 20 20 20 2f 2a 20 4c Page1; /* L
31e40 6f 63 61 6c 20 72 65 66 65 72 65 6e 63 65 20 74 ocal reference t
31e50 6f 20 70 61 67 65 20 31 20 2a 2f 0a 20 20 4d 65 o page 1 */. Me
31e60 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 20 20 20 mPage *pPage;
31e70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31e80 20 20 2f 2a 20 50 61 67 65 20 62 65 69 6e 67 20 /* Page being
31e90 66 72 65 65 64 2e 20 4d 61 79 20 62 65 20 4e 55 freed. May be NU
31ea0 4c 4c 2e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b LL. */. int rc;
31eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
31ed0 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20 Return Code */.
31ee0 20 69 6e 74 20 6e 46 72 65 65 3b 20 20 20 20 20 int nFree;
31ef0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31f00 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 20 /* Initial
31f10 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
31f20 6f 6e 20 66 72 65 65 2d 6c 69 73 74 20 2a 2f 0a on free-list */.
31f30 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
31f40 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
31f50 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
31f60 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 ssert( CORRUPT_D
31f70 42 20 7c 7c 20 69 50 61 67 65 3e 31 20 29 3b 0a B || iPage>1 );.
31f80 20 20 61 73 73 65 72 74 28 20 21 70 4d 65 6d 50 assert( !pMemP
31f90 61 67 65 20 7c 7c 20 70 4d 65 6d 50 61 67 65 2d age || pMemPage-
31fa0 3e 70 67 6e 6f 3d 3d 69 50 61 67 65 20 29 3b 0a >pgno==iPage );.
31fb0 0a 20 20 69 66 28 20 69 50 61 67 65 3c 32 20 29 . if( iPage<2 )
31fc0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
31fd0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 69 ORRUPT_BKPT;. i
31fe0 66 28 20 70 4d 65 6d 50 61 67 65 20 29 7b 0a 20 f( pMemPage ){.
31ff0 20 20 20 70 50 61 67 65 20 3d 20 70 4d 65 6d 50 pPage = pMemP
32000 61 67 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 age;. sqlite3
32010 50 61 67 65 72 52 65 66 28 70 50 61 67 65 2d 3e PagerRef(pPage->
32020 70 44 62 50 61 67 65 29 3b 0a 20 20 7d 65 6c 73 pDbPage);. }els
32030 65 7b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 62 e{. pPage = b
32040 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 70 treePageLookup(p
32050 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 7d 0a Bt, iPage);. }.
32060 0a 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 20 . /* Increment
32070 74 68 65 20 66 72 65 65 20 70 61 67 65 20 63 6f the free page co
32080 75 6e 74 20 6f 6e 20 70 50 61 67 65 31 20 2a 2f unt on pPage1 */
32090 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
320a0 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 agerWrite(pPage1
320b0 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 ->pDbPage);. if
320c0 28 20 72 63 20 29 20 67 6f 74 6f 20 66 72 65 65 ( rc ) goto free
320d0 70 61 67 65 5f 6f 75 74 3b 0a 20 20 6e 46 72 65 page_out;. nFre
320e0 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 e = get4byte(&pP
320f0 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 age1->aData[36])
32100 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 50 ;. put4byte(&pP
32110 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 2c age1->aData[36],
32120 20 6e 46 72 65 65 2b 31 29 3b 0a 0a 20 20 69 66 nFree+1);.. if
32130 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ( pBt->btsFlags
32140 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c & BTS_SECURE_DEL
32150 45 54 45 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 ETE ){. /* If
32160 20 74 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 the secure_dele
32170 74 65 20 6f 70 74 69 6f 6e 20 69 73 20 65 6e 61 te option is ena
32180 62 6c 65 64 2c 20 74 68 65 6e 0a 20 20 20 20 2a bled, then. *
32190 2a 20 61 6c 77 61 79 73 20 66 75 6c 6c 79 20 6f * always fully o
321a0 76 65 72 77 72 69 74 65 20 64 65 6c 65 74 65 64 verwrite deleted
321b0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 74 information wit
321c0 68 20 7a 65 72 6f 73 2e 0a 20 20 20 20 2a 2f 0a h zeros.. */.
321d0 20 20 20 20 69 66 28 20 28 21 70 50 61 67 65 20 if( (!pPage
321e0 26 26 20 28 28 72 63 20 3d 20 62 74 72 65 65 47 && ((rc = btreeG
321f0 65 74 50 61 67 65 28 70 42 74 2c 20 69 50 61 67 etPage(pBt, iPag
32200 65 2c 20 26 70 50 61 67 65 2c 20 30 29 29 21 3d e, &pPage, 0))!=
32210 30 29 20 29 0a 20 20 20 20 20 7c 7c 20 20 20 20 0) ). ||
32220 20 20 20 20 20 20 20 20 28 28 72 63 20 3d 20 73 ((rc = s
32230 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
32240 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
32250 29 21 3d 30 29 0a 20 20 20 20 29 7b 0a 20 20 20 )!=0). ){.
32260 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 goto freepage
32270 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 _out;. }.
32280 6d 65 6d 73 65 74 28 70 50 61 67 65 2d 3e 61 44 memset(pPage->aD
32290 61 74 61 2c 20 30 2c 20 70 50 61 67 65 2d 3e 70 ata, 0, pPage->p
322a0 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 Bt->pageSize);.
322b0 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 }.. /* If the
322c0 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 database support
322d0 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 20 77 s auto-vacuum, w
322e0 72 69 74 65 20 61 6e 20 65 6e 74 72 79 20 69 6e rite an entry in
322f0 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 the pointer-map
32300 0a 20 20 2a 2a 20 74 6f 20 69 6e 64 69 63 61 74 . ** to indicat
32310 65 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 e that the page
32320 69 73 20 66 72 65 65 2e 0a 20 20 2a 2f 0a 20 20 is free.. */.
32330 69 66 28 20 49 53 41 55 54 4f 56 41 43 55 55 4d if( ISAUTOVACUUM
32340 20 29 7b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 ){. ptrmapPu
32350 74 28 70 42 74 2c 20 69 50 61 67 65 2c 20 50 54 t(pBt, iPage, PT
32360 52 4d 41 50 5f 46 52 45 45 50 41 47 45 2c 20 30 RMAP_FREEPAGE, 0
32370 2c 20 26 72 63 29 3b 0a 20 20 20 20 69 66 28 20 , &rc);. if(
32380 72 63 20 29 20 67 6f 74 6f 20 66 72 65 65 70 61 rc ) goto freepa
32390 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f ge_out;. }.. /
323a0 2a 20 4e 6f 77 20 6d 61 6e 69 70 75 6c 61 74 65 * Now manipulate
323b0 20 74 68 65 20 61 63 74 75 61 6c 20 64 61 74 61 the actual data
323c0 62 61 73 65 20 66 72 65 65 2d 6c 69 73 74 20 73 base free-list s
323d0 74 72 75 63 74 75 72 65 2e 20 54 68 65 72 65 20 tructure. There
323e0 61 72 65 20 74 77 6f 0a 20 20 2a 2a 20 70 6f 73 are two. ** pos
323f0 73 69 62 69 6c 69 74 69 65 73 2e 20 49 66 20 74 sibilities. If t
32400 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 he free-list is
32410 63 75 72 72 65 6e 74 6c 79 20 65 6d 70 74 79 2c currently empty,
32420 20 6f 72 20 69 66 20 74 68 65 20 66 69 72 73 74 or if the first
32430 0a 20 20 2a 2a 20 74 72 75 6e 6b 20 70 61 67 65 . ** trunk page
32440 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 in the free-lis
32450 74 20 69 73 20 66 75 6c 6c 2c 20 74 68 65 6e 20 t is full, then
32460 74 68 69 73 20 70 61 67 65 20 77 69 6c 6c 20 62 this page will b
32470 65 63 6f 6d 65 20 61 0a 20 20 2a 2a 20 6e 65 77 ecome a. ** new
32480 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b free-list trunk
32490 20 70 61 67 65 2e 20 4f 74 68 65 72 77 69 73 65 page. Otherwise
324a0 2c 20 69 74 20 77 69 6c 6c 20 62 65 63 6f 6d 65 , it will become
324b0 20 61 20 6c 65 61 66 20 6f 66 20 74 68 65 0a 20 a leaf of the.
324c0 20 2a 2a 20 66 69 72 73 74 20 74 72 75 6e 6b 20 ** first trunk
324d0 70 61 67 65 20 69 6e 20 74 68 65 20 63 75 72 72 page in the curr
324e0 65 6e 74 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 ent free-list. T
324f0 68 69 73 20 62 6c 6f 63 6b 20 74 65 73 74 73 20 his block tests
32500 69 66 20 69 74 0a 20 20 2a 2a 20 69 73 20 70 6f if it. ** is po
32510 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 74 68 ssible to add th
32520 65 20 70 61 67 65 20 61 73 20 61 20 6e 65 77 20 e page as a new
32530 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 2e 0a free-list leaf..
32540 20 20 2a 2f 0a 20 20 69 66 28 20 6e 46 72 65 65 */. if( nFree
32550 21 3d 30 20 29 7b 0a 20 20 20 20 75 33 32 20 6e !=0 ){. u32 n
32560 4c 65 61 66 3b 20 20 20 20 20 20 20 20 20 20 20 Leaf;
32570 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 20 /* Initial
32580 6e 75 6d 62 65 72 20 6f 66 20 6c 65 61 66 20 63 number of leaf c
32590 65 6c 6c 73 20 6f 6e 20 74 72 75 6e 6b 20 70 61 ells on trunk pa
325a0 67 65 20 2a 2f 0a 0a 20 20 20 20 69 54 72 75 6e ge */.. iTrun
325b0 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 k = get4byte(&pP
325c0 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 29 age1->aData[32])
325d0 3b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 ;. rc = btree
325e0 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 54 72 GetPage(pBt, iTr
325f0 75 6e 6b 2c 20 26 70 54 72 75 6e 6b 2c 20 30 29 unk, &pTrunk, 0)
32600 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
32610 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
32620 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
32630 75 74 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e ut;. }.. n
32640 4c 65 61 66 20 3d 20 67 65 74 34 62 79 74 65 28 Leaf = get4byte(
32650 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 &pTrunk->aData[4
32660 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ]);. assert(
32670 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3e pBt->usableSize>
32680 33 32 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 4c 32 );. if( nL
32690 65 61 66 20 3e 20 28 75 33 32 29 70 42 74 2d 3e eaf > (u32)pBt->
326a0 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 usableSize/4 - 2
326b0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
326c0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
326d0 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 PT;. goto f
326e0 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 reepage_out;.
326f0 20 7d 0a 20 20 20 20 69 66 28 20 6e 4c 65 61 66 }. if( nLeaf
32700 20 3c 20 28 75 33 32 29 70 42 74 2d 3e 75 73 61 < (u32)pBt->usa
32710 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 29 7b bleSize/4 - 8 ){
32720 0a 20 20 20 20 20 20 2f 2a 20 49 6e 20 74 68 69 . /* In thi
32730 73 20 63 61 73 65 20 74 68 65 72 65 20 69 73 20 s case there is
32740 72 6f 6f 6d 20 6f 6e 20 74 68 65 20 74 72 75 6e room on the trun
32750 6b 20 70 61 67 65 20 74 6f 20 69 6e 73 65 72 74 k page to insert
32760 20 74 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 the page.
32770 2a 2a 20 62 65 69 6e 67 20 66 72 65 65 64 20 61 ** being freed a
32780 73 20 61 20 6e 65 77 20 6c 65 61 66 2e 0a 20 20 s a new leaf..
32790 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 **. **
327a0 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 74 72 Note that the tr
327b0 75 6e 6b 20 70 61 67 65 20 69 73 20 6e 6f 74 20 unk page is not
327c0 72 65 61 6c 6c 79 20 66 75 6c 6c 20 75 6e 74 69 really full unti
327d0 6c 20 69 74 20 63 6f 6e 74 61 69 6e 73 0a 20 20 l it contains.
327e0 20 20 20 20 2a 2a 20 75 73 61 62 6c 65 53 69 7a ** usableSiz
327f0 65 2f 34 20 2d 20 32 20 65 6e 74 72 69 65 73 2c e/4 - 2 entries,
32800 20 6e 6f 74 20 75 73 61 62 6c 65 53 69 7a 65 2f not usableSize/
32810 34 20 2d 20 38 20 65 6e 74 72 69 65 73 20 61 73 4 - 8 entries as
32820 20 77 65 20 68 61 76 65 0a 20 20 20 20 20 20 2a we have. *
32830 2a 20 63 6f 64 65 64 2e 20 20 42 75 74 20 64 75 * coded. But du
32840 65 20 74 6f 20 61 20 63 6f 64 69 6e 67 20 65 72 e to a coding er
32850 72 6f 72 20 69 6e 20 76 65 72 73 69 6f 6e 73 20 ror in versions
32860 6f 66 20 53 51 4c 69 74 65 20 70 72 69 6f 72 20 of SQLite prior
32870 74 6f 0a 20 20 20 20 20 20 2a 2a 20 33 2e 36 2e to. ** 3.6.
32880 30 2c 20 64 61 74 61 62 61 73 65 73 20 77 69 74 0, databases wit
32890 68 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b h freelist trunk
328a0 20 70 61 67 65 73 20 68 6f 6c 64 69 6e 67 20 6d pages holding m
328b0 6f 72 65 20 74 68 61 6e 0a 20 20 20 20 20 20 2a ore than. *
328c0 2a 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d * usableSize/4 -
328d0 20 38 20 65 6e 74 72 69 65 73 20 77 69 6c 6c 20 8 entries will
328e0 62 65 20 72 65 70 6f 72 74 65 64 20 61 73 20 63 be reported as c
328f0 6f 72 72 75 70 74 2e 20 20 49 6e 20 6f 72 64 65 orrupt. In orde
32900 72 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 6d 61 r. ** to ma
32910 69 6e 74 61 69 6e 20 62 61 63 6b 77 61 72 64 73 intain backwards
32920 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 compatibility w
32930 69 74 68 20 6f 6c 64 65 72 20 76 65 72 73 69 6f ith older versio
32940 6e 73 20 6f 66 20 53 51 4c 69 74 65 2c 0a 20 20 ns of SQLite,.
32950 20 20 20 20 2a 2a 20 77 65 20 77 69 6c 6c 20 63 ** we will c
32960 6f 6e 74 69 6e 75 65 20 74 6f 20 72 65 73 74 72 ontinue to restr
32970 69 63 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ict the number o
32980 66 20 65 6e 74 72 69 65 73 20 74 6f 20 75 73 61 f entries to usa
32990 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 0a 20 20 bleSize/4 - 8.
329a0 20 20 20 20 2a 2a 20 66 6f 72 20 6e 6f 77 2e 20 ** for now.
329b0 20 41 74 20 73 6f 6d 65 20 70 6f 69 6e 74 20 69 At some point i
329c0 6e 20 74 68 65 20 66 75 74 75 72 65 20 28 6f 6e n the future (on
329d0 63 65 20 65 76 65 72 79 6f 6e 65 20 68 61 73 20 ce everyone has
329e0 75 70 67 72 61 64 65 64 0a 20 20 20 20 20 20 2a upgraded. *
329f0 2a 20 74 6f 20 33 2e 36 2e 30 20 6f 72 20 6c 61 * to 3.6.0 or la
32a00 74 65 72 29 20 77 65 20 73 68 6f 75 6c 64 20 63 ter) we should c
32a10 6f 6e 73 69 64 65 72 20 66 69 78 69 6e 67 20 74 onsider fixing t
32a20 68 65 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 he conditional a
32a30 62 6f 76 65 0a 20 20 20 20 20 20 2a 2a 20 74 6f bove. ** to
32a40 20 72 65 61 64 20 22 75 73 61 62 6c 65 53 69 7a read "usableSiz
32a50 65 2f 34 2d 32 22 20 69 6e 73 74 65 61 64 20 6f e/4-2" instead o
32a60 66 20 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d f "usableSize/4-
32a70 38 22 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 8".. **.
32a80 20 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f ** EVIDENCE-O
32a90 46 3a 20 52 2d 31 39 39 32 30 2d 31 31 35 37 36 F: R-19920-11576
32aa0 20 48 6f 77 65 76 65 72 2c 20 6e 65 77 65 72 20 However, newer
32ab0 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 versions of SQLi
32ac0 74 65 20 73 74 69 6c 6c 0a 20 20 20 20 20 20 2a te still. *
32ad0 2a 20 61 76 6f 69 64 20 75 73 69 6e 67 20 74 68 * avoid using th
32ae0 65 20 6c 61 73 74 20 73 69 78 20 65 6e 74 72 69 e last six entri
32af0 65 73 20 69 6e 20 74 68 65 20 66 72 65 65 6c 69 es in the freeli
32b00 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 61 72 st trunk page ar
32b10 72 61 79 20 69 6e 0a 20 20 20 20 20 20 2a 2a 20 ray in. **
32b20 6f 72 64 65 72 20 74 68 61 74 20 64 61 74 61 62 order that datab
32b30 61 73 65 20 66 69 6c 65 73 20 63 72 65 61 74 65 ase files create
32b40 64 20 62 79 20 6e 65 77 65 72 20 76 65 72 73 69 d by newer versi
32b50 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 63 61 ons of SQLite ca
32b60 6e 20 62 65 0a 20 20 20 20 20 20 2a 2a 20 72 65 n be. ** re
32b70 61 64 20 62 79 20 6f 6c 64 65 72 20 76 65 72 73 ad by older vers
32b80 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a ions of SQLite..
32b90 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 */. r
32ba0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
32bb0 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 Write(pTrunk->pD
32bc0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 69 66 bPage);. if
32bd0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
32be0 29 7b 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 ){. put4b
32bf0 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
32c00 74 61 5b 34 5d 2c 20 6e 4c 65 61 66 2b 31 29 3b ta[4], nLeaf+1);
32c10 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 . put4byt
32c20 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 e(&pTrunk->aData
32c30 5b 38 2b 6e 4c 65 61 66 2a 34 5d 2c 20 69 50 61 [8+nLeaf*4], iPa
32c40 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ge);. if(
32c50 20 70 50 61 67 65 20 26 26 20 28 70 42 74 2d 3e pPage && (pBt->
32c60 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 btsFlags & BTS_S
32c70 45 43 55 52 45 5f 44 45 4c 45 54 45 29 3d 3d 30 ECURE_DELETE)==0
32c80 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
32c90 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 lite3PagerDontWr
32ca0 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ite(pPage->pDbPa
32cb0 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ge);. }.
32cc0 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 rc = btre
32cd0 65 53 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 70 eSetHasContent(p
32ce0 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 20 20 Bt, iPage);.
32cf0 20 20 7d 0a 20 20 20 20 20 20 54 52 41 43 45 28 }. TRACE(
32d00 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 64 20 ("FREE-PAGE: %d
32d10 6c 65 61 66 20 6f 6e 20 74 72 75 6e 6b 20 70 61 leaf on trunk pa
32d20 67 65 20 25 64 5c 6e 22 2c 70 50 61 67 65 2d 3e ge %d\n",pPage->
32d30 70 67 6e 6f 2c 70 54 72 75 6e 6b 2d 3e 70 67 6e pgno,pTrunk->pgn
32d40 6f 29 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 o));. goto
32d50 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 freepage_out;.
32d60 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 }. }.. /* If
32d70 20 63 6f 6e 74 72 6f 6c 20 66 6c 6f 77 73 20 74 control flows t
32d80 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 o this point, th
32d90 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 20 70 6f en it was not po
32da0 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 74 68 ssible to add th
32db0 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 e. ** the page
32dc0 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 20 61 being freed as a
32dd0 20 6c 65 61 66 20 70 61 67 65 20 6f 66 20 74 68 leaf page of th
32de0 65 20 66 69 72 73 74 20 74 72 75 6e 6b 20 69 6e e first trunk in
32df0 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a the free-list..
32e00 20 20 2a 2a 20 50 6f 73 73 69 62 6c 79 20 62 65 ** Possibly be
32e10 63 61 75 73 65 20 74 68 65 20 66 72 65 65 2d 6c cause the free-l
32e20 69 73 74 20 69 73 20 65 6d 70 74 79 2c 20 6f 72 ist is empty, or
32e30 20 70 6f 73 73 69 62 6c 79 20 62 65 63 61 75 73 possibly becaus
32e40 65 20 74 68 65 20 0a 20 20 2a 2a 20 66 69 72 73 e the . ** firs
32e50 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 20 66 t trunk in the f
32e60 72 65 65 2d 6c 69 73 74 20 69 73 20 66 75 6c 6c ree-list is full
32e70 2e 20 45 69 74 68 65 72 20 77 61 79 2c 20 74 68 . Either way, th
32e80 65 20 70 61 67 65 20 62 65 69 6e 67 20 66 72 65 e page being fre
32e90 65 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 63 ed. ** will bec
32ea0 6f 6d 65 20 74 68 65 20 6e 65 77 20 66 69 72 73 ome the new firs
32eb0 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 t trunk page in
32ec0 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 20 the free-list..
32ed0 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 3d */. if( pPage=
32ee0 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b 21 =0 && SQLITE_OK!
32ef0 3d 28 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 =(rc = btreeGetP
32f00 61 67 65 28 70 42 74 2c 20 69 50 61 67 65 2c 20 age(pBt, iPage,
32f10 26 70 50 61 67 65 2c 20 30 29 29 20 29 7b 0a 20 &pPage, 0)) ){.
32f20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 goto freepage
32f30 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 72 63 20 3d _out;. }. rc =
32f40 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
32f50 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 te(pPage->pDbPag
32f60 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 e);. if( rc!=SQ
32f70 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 LITE_OK ){. g
32f80 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
32f90 3b 0a 20 20 7d 0a 20 20 70 75 74 34 62 79 74 65 ;. }. put4byte
32fa0 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 (pPage->aData, i
32fb0 54 72 75 6e 6b 29 3b 0a 20 20 70 75 74 34 62 79 Trunk);. put4by
32fc0 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
32fd0 5b 34 5d 2c 20 30 29 3b 0a 20 20 70 75 74 34 62 [4], 0);. put4b
32fe0 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
32ff0 74 61 5b 33 32 5d 2c 20 69 50 61 67 65 29 3b 0a ta[32], iPage);.
33000 20 20 54 52 41 43 45 28 28 22 46 52 45 45 2d 50 TRACE(("FREE-P
33010 41 47 45 3a 20 25 64 20 6e 65 77 20 74 72 75 6e AGE: %d new trun
33020 6b 20 70 61 67 65 20 72 65 70 6c 61 63 69 6e 67 k page replacing
33030 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 2d 3e 70 %d\n", pPage->p
33040 67 6e 6f 2c 20 69 54 72 75 6e 6b 29 29 3b 0a 0a gno, iTrunk));..
33050 66 72 65 65 70 61 67 65 5f 6f 75 74 3a 0a 20 20 freepage_out:.
33060 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 if( pPage ){.
33070 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d pPage->isInit =
33080 20 30 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 0;. }. releas
33090 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 ePage(pPage);.
330a0 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 72 75 releasePage(pTru
330b0 6e 6b 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 nk);. return rc
330c0 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 ;.}.static void
330d0 66 72 65 65 50 61 67 65 28 4d 65 6d 50 61 67 65 freePage(MemPage
330e0 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 2a 70 52 *pPage, int *pR
330f0 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 29 C){. if( (*pRC)
33100 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
33110 20 20 20 2a 70 52 43 20 3d 20 66 72 65 65 50 61 *pRC = freePa
33120 67 65 32 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 ge2(pPage->pBt,
33130 70 50 61 67 65 2c 20 70 50 61 67 65 2d 3e 70 67 pPage, pPage->pg
33140 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a no);. }.}../*.*
33150 2a 20 46 72 65 65 20 61 6e 79 20 6f 76 65 72 66 * Free any overf
33160 6c 6f 77 20 70 61 67 65 73 20 61 73 73 6f 63 69 low pages associ
33170 61 74 65 64 20 77 69 74 68 20 74 68 65 20 67 69 ated with the gi
33180 76 65 6e 20 43 65 6c 6c 2e 20 20 57 72 69 74 65 ven Cell. Write
33190 20 74 68 65 0a 2a 2a 20 6c 6f 63 61 6c 20 43 65 the.** local Ce
331a0 6c 6c 20 73 69 7a 65 20 28 74 68 65 20 6e 75 6d ll size (the num
331b0 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 6e 20 ber of bytes on
331c0 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 67 the original pag
331d0 65 2c 20 6f 6d 69 74 74 69 6e 67 0a 2a 2a 20 6f e, omitting.** o
331e0 76 65 72 66 6c 6f 77 29 20 69 6e 74 6f 20 2a 70 verflow) into *p
331f0 6e 53 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 nSize..*/.static
33200 20 69 6e 74 20 63 6c 65 61 72 43 65 6c 6c 28 0a int clearCell(.
33210 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
33220 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 , /* Th
33230 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 e page that cont
33240 61 69 6e 73 20 74 68 65 20 43 65 6c 6c 20 2a 2f ains the Cell */
33250 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
33260 20 2a 70 43 65 6c 6c 2c 20 20 20 20 2f 2a 20 46 *pCell, /* F
33270 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 irst byte of the
33280 20 43 65 6c 6c 20 2a 2f 0a 20 20 43 65 6c 6c 49 Cell */. CellI
33290 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 nfo *pInfo
332a0 20 20 20 20 2f 2a 20 53 69 7a 65 20 69 6e 66 6f /* Size info
332b0 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 rmation about th
332c0 65 20 63 65 6c 6c 20 2a 2f 0a 29 7b 0a 20 20 42 e cell */.){. B
332d0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
332e0 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 50 67 6e Page->pBt;. Pgn
332f0 6f 20 6f 76 66 6c 50 67 6e 6f 3b 0a 20 20 69 6e o ovflPgno;. in
33300 74 20 72 63 3b 0a 20 20 69 6e 74 20 6e 4f 76 66 t rc;. int nOvf
33310 6c 3b 0a 20 20 75 33 32 20 6f 76 66 6c 50 61 67 l;. u32 ovflPag
33320 65 53 69 7a 65 3b 0a 0a 20 20 61 73 73 65 72 74 eSize;.. assert
33330 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
33340 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
33350 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 >mutex) );. pPa
33360 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 ge->xParseCell(p
33370 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e Page, pCell, pIn
33380 66 6f 29 3b 0a 20 20 69 66 28 20 70 49 6e 66 6f fo);. if( pInfo
33390 2d 3e 6e 4c 6f 63 61 6c 3d 3d 70 49 6e 66 6f 2d ->nLocal==pInfo-
333a0 3e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 >nPayload ){.
333b0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
333c0 4b 3b 20 20 2f 2a 20 4e 6f 20 6f 76 65 72 66 6c K; /* No overfl
333d0 6f 77 20 70 61 67 65 73 2e 20 52 65 74 75 72 6e ow pages. Return
333e0 20 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 without doing a
333f0 6e 79 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 0a 20 nything */. }.
33400 20 69 66 28 20 70 43 65 6c 6c 2b 70 49 6e 66 6f if( pCell+pInfo
33410 2d 3e 6e 53 69 7a 65 2d 31 20 3e 20 70 50 61 67 ->nSize-1 > pPag
33420 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d 3e e->aData+pPage->
33430 6d 61 73 6b 50 61 67 65 20 29 7b 0a 20 20 20 20 maskPage ){.
33440 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
33450 52 52 55 50 54 5f 42 4b 50 54 3b 20 20 2f 2a 20 RRUPT_BKPT; /*
33460 43 65 6c 6c 20 65 78 74 65 6e 64 73 20 70 61 73 Cell extends pas
33470 74 20 65 6e 64 20 6f 66 20 70 61 67 65 20 2a 2f t end of page */
33480 0a 20 20 7d 0a 20 20 6f 76 66 6c 50 67 6e 6f 20 . }. ovflPgno
33490 3d 20 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c = get4byte(pCell
334a0 20 2b 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 + pInfo->nSize
334b0 2d 20 34 29 3b 0a 20 20 61 73 73 65 72 74 28 20 - 4);. assert(
334c0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
334d0 3e 20 34 20 29 3b 0a 20 20 6f 76 66 6c 50 61 67 > 4 );. ovflPag
334e0 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 eSize = pBt->usa
334f0 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 6e bleSize - 4;. n
33500 4f 76 66 6c 20 3d 20 28 70 49 6e 66 6f 2d 3e 6e Ovfl = (pInfo->n
33510 50 61 79 6c 6f 61 64 20 2d 20 70 49 6e 66 6f 2d Payload - pInfo-
33520 3e 6e 4c 6f 63 61 6c 20 2b 20 6f 76 66 6c 50 61 >nLocal + ovflPa
33530 67 65 53 69 7a 65 20 2d 20 31 29 2f 6f 76 66 6c geSize - 1)/ovfl
33540 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 73 65 PageSize;. asse
33550 72 74 28 20 6e 4f 76 66 6c 3e 30 20 7c 7c 20 0a rt( nOvfl>0 || .
33560 20 20 20 20 28 43 4f 52 52 55 50 54 5f 44 42 20 (CORRUPT_DB
33570 26 26 20 28 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c && (pInfo->nPayl
33580 6f 61 64 20 2b 20 6f 76 66 6c 50 61 67 65 53 69 oad + ovflPageSi
33590 7a 65 29 3c 6f 76 66 6c 50 61 67 65 53 69 7a 65 ze)<ovflPageSize
335a0 29 0a 20 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 ). );. while(
335b0 6e 4f 76 66 6c 2d 2d 20 29 7b 0a 20 20 20 20 50 nOvfl-- ){. P
335c0 67 6e 6f 20 69 4e 65 78 74 20 3d 20 30 3b 0a 20 gno iNext = 0;.
335d0 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 MemPage *pOvf
335e0 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 6f l = 0;. if( o
335f0 76 66 6c 50 67 6e 6f 3c 32 20 7c 7c 20 6f 76 66 vflPgno<2 || ovf
33600 6c 50 67 6e 6f 3e 62 74 72 65 65 50 61 67 65 63 lPgno>btreePagec
33610 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 ount(pBt) ){.
33620 20 20 20 2f 2a 20 30 20 69 73 20 6e 6f 74 20 61 /* 0 is not a
33630 20 6c 65 67 61 6c 20 70 61 67 65 20 6e 75 6d 62 legal page numb
33640 65 72 20 61 6e 64 20 70 61 67 65 20 31 20 63 61 er and page 1 ca
33650 6e 6e 6f 74 20 62 65 20 61 6e 20 0a 20 20 20 20 nnot be an .
33660 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 70 61 ** overflow pa
33670 67 65 2e 20 54 68 65 72 65 66 6f 72 65 20 69 66 ge. Therefore if
33680 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 6f 72 20 70 ovflPgno<2 or p
33690 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ast the end of t
336a0 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c he . ** fil
336b0 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d e the database m
336c0 75 73 74 20 62 65 20 63 6f 72 72 75 70 74 2e 20 ust be corrupt.
336d0 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 */. return
336e0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
336f0 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 KPT;. }. i
33700 66 28 20 6e 4f 76 66 6c 20 29 7b 0a 20 20 20 20 f( nOvfl ){.
33710 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 66 6c rc = getOverfl
33720 6f 77 50 61 67 65 28 70 42 74 2c 20 6f 76 66 6c owPage(pBt, ovfl
33730 50 67 6e 6f 2c 20 26 70 4f 76 66 6c 2c 20 26 69 Pgno, &pOvfl, &i
33740 4e 65 78 74 29 3b 0a 20 20 20 20 20 20 69 66 28 Next);. if(
33750 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
33760 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 . }.. if(
33770 28 20 70 4f 76 66 6c 20 7c 7c 20 28 28 70 4f 76 ( pOvfl || ((pOv
33780 66 6c 20 3d 20 62 74 72 65 65 50 61 67 65 4c 6f fl = btreePageLo
33790 6f 6b 75 70 28 70 42 74 2c 20 6f 76 66 6c 50 67 okup(pBt, ovflPg
337a0 6e 6f 29 29 21 3d 30 29 20 29 0a 20 20 20 20 20 no))!=0) ).
337b0 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 && sqlite3PagerP
337c0 61 67 65 52 65 66 63 6f 75 6e 74 28 70 4f 76 66 ageRefcount(pOvf
337d0 6c 2d 3e 70 44 62 50 61 67 65 29 21 3d 31 0a 20 l->pDbPage)!=1.
337e0 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 ){. /* T
337f0 68 65 72 65 20 69 73 20 6e 6f 20 72 65 61 73 6f here is no reaso
33800 6e 20 61 6e 79 20 63 75 72 73 6f 72 20 73 68 6f n any cursor sho
33810 75 6c 64 20 68 61 76 65 20 61 6e 20 6f 75 74 73 uld have an outs
33820 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 tanding referenc
33830 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 61 e . ** to a
33840 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 n overflow page
33850 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 61 20 63 belonging to a c
33860 65 6c 6c 20 74 68 61 74 20 69 73 20 62 65 69 6e ell that is bein
33870 67 20 64 65 6c 65 74 65 64 2f 75 70 64 61 74 65 g deleted/update
33880 64 2e 0a 20 20 20 20 20 20 2a 2a 20 53 6f 20 69 d.. ** So i
33890 66 20 74 68 65 72 65 20 65 78 69 73 74 73 20 6d f there exists m
338a0 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 65 66 ore than one ref
338b0 65 72 65 6e 63 65 20 74 6f 20 74 68 69 73 20 70 erence to this p
338c0 61 67 65 2c 20 74 68 65 6e 20 69 74 20 0a 20 20 age, then it .
338d0 20 20 20 20 2a 2a 20 6d 75 73 74 20 6e 6f 74 20 ** must not
338e0 72 65 61 6c 6c 79 20 62 65 20 61 6e 20 6f 76 65 really be an ove
338f0 72 66 6c 6f 77 20 70 61 67 65 20 61 6e 64 20 74 rflow page and t
33900 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 he database must
33910 20 62 65 20 63 6f 72 72 75 70 74 2e 20 0a 20 20 be corrupt. .
33920 20 20 20 20 2a 2a 20 49 74 20 69 73 20 68 65 6c ** It is hel
33930 70 66 75 6c 20 74 6f 20 64 65 74 65 63 74 20 74 pful to detect t
33940 68 69 73 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 his before calli
33950 6e 67 20 66 72 65 65 50 61 67 65 32 28 29 2c 20 ng freePage2(),
33960 61 73 20 0a 20 20 20 20 20 20 2a 2a 20 66 72 65 as . ** fre
33970 65 50 61 67 65 32 28 29 20 6d 61 79 20 7a 65 72 ePage2() may zer
33980 6f 20 74 68 65 20 70 61 67 65 20 63 6f 6e 74 65 o the page conte
33990 6e 74 73 20 69 66 20 73 65 63 75 72 65 2d 64 65 nts if secure-de
339a0 6c 65 74 65 20 6d 6f 64 65 20 69 73 0a 20 20 20 lete mode is.
339b0 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e 20 49 ** enabled. I
339c0 66 20 74 68 69 73 20 27 6f 76 65 72 66 6c 6f 77 f this 'overflow
339d0 27 20 70 61 67 65 20 68 61 70 70 65 6e 73 20 74 ' page happens t
339e0 6f 20 62 65 20 61 20 70 61 67 65 20 74 68 61 74 o be a page that
339f0 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 63 61 the. ** ca
33a00 6c 6c 65 72 20 69 73 20 69 74 65 72 61 74 69 6e ller is iteratin
33a10 67 20 74 68 72 6f 75 67 68 20 6f 72 20 75 73 69 g through or usi
33a20 6e 67 20 69 6e 20 73 6f 6d 65 20 6f 74 68 65 72 ng in some other
33a30 20 77 61 79 2c 20 74 68 69 73 0a 20 20 20 20 20 way, this.
33a40 20 2a 2a 20 63 61 6e 20 62 65 20 70 72 6f 62 6c ** can be probl
33a50 65 6d 61 74 69 63 2e 0a 20 20 20 20 20 20 2a 2f ematic.. */
33a60 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
33a70 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
33a80 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
33a90 20 20 72 63 20 3d 20 66 72 65 65 50 61 67 65 32 rc = freePage2
33aa0 28 70 42 74 2c 20 70 4f 76 66 6c 2c 20 6f 76 66 (pBt, pOvfl, ovf
33ab0 6c 50 67 6e 6f 29 3b 0a 20 20 20 20 7d 0a 0a 20 lPgno);. }..
33ac0 20 20 20 69 66 28 20 70 4f 76 66 6c 20 29 7b 0a if( pOvfl ){.
33ad0 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
33ae0 65 72 55 6e 72 65 66 28 70 4f 76 66 6c 2d 3e 70 erUnref(pOvfl->p
33af0 44 62 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 DbPage);. }.
33b00 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
33b10 72 6e 20 72 63 3b 0a 20 20 20 20 6f 76 66 6c 50 rn rc;. ovflP
33b20 67 6e 6f 20 3d 20 69 4e 65 78 74 3b 0a 20 20 7d gno = iNext;. }
33b30 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
33b40 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 _OK;.}../*.** Cr
33b50 65 61 74 65 20 74 68 65 20 62 79 74 65 20 73 65 eate the byte se
33b60 71 75 65 6e 63 65 20 75 73 65 64 20 74 6f 20 72 quence used to r
33b70 65 70 72 65 73 65 6e 74 20 61 20 63 65 6c 6c 20 epresent a cell
33b80 6f 6e 20 70 61 67 65 20 70 50 61 67 65 0a 2a 2a on page pPage.**
33b90 20 61 6e 64 20 77 72 69 74 65 20 74 68 61 74 20 and write that
33ba0 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 69 6e byte sequence in
33bb0 74 6f 20 70 43 65 6c 6c 5b 5d 2e 20 20 4f 76 65 to pCell[]. Ove
33bc0 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 65 0a rflow pages are.
33bd0 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 ** allocated and
33be0 20 66 69 6c 6c 65 64 20 69 6e 20 61 73 20 6e 65 filled in as ne
33bf0 63 65 73 73 61 72 79 2e 20 20 54 68 65 20 63 61 cessary. The ca
33c00 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 65 0a lling procedure.
33c10 2a 2a 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c ** is responsibl
33c20 65 20 66 6f 72 20 6d 61 6b 69 6e 67 20 73 75 72 e for making sur
33c30 65 20 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 e sufficient spa
33c40 63 65 20 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f ce has been allo
33c50 63 61 74 65 64 0a 2a 2a 20 66 6f 72 20 70 43 65 cated.** for pCe
33c60 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 ll[]..**.** Note
33c70 20 74 68 61 74 20 70 43 65 6c 6c 20 64 6f 65 73 that pCell does
33c80 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 6e not necessary n
33c90 65 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 eed to point to
33ca0 74 68 65 20 70 50 61 67 65 2d 3e 61 44 61 74 61 the pPage->aData
33cb0 0a 2a 2a 20 61 72 65 61 2e 20 20 70 43 65 6c 6c .** area. pCell
33cc0 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 might point to
33cd0 73 6f 6d 65 20 74 65 6d 70 6f 72 61 72 79 20 73 some temporary s
33ce0 74 6f 72 61 67 65 2e 20 20 54 68 65 20 63 65 6c torage. The cel
33cf0 6c 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 63 6f 6e l will.** be con
33d00 73 74 72 75 63 74 65 64 20 69 6e 20 74 68 69 73 structed in this
33d10 20 74 65 6d 70 6f 72 61 72 79 20 61 72 65 61 20 temporary area
33d20 74 68 65 6e 20 63 6f 70 69 65 64 20 69 6e 74 6f then copied into
33d30 20 70 50 61 67 65 2d 3e 61 44 61 74 61 0a 2a 2a pPage->aData.**
33d40 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 later..*/.stati
33d50 63 20 69 6e 74 20 66 69 6c 6c 49 6e 43 65 6c 6c c int fillInCell
33d60 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
33d70 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ge,
33d80 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 74 /* The page t
33d90 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 hat contains the
33da0 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 69 67 cell */. unsig
33db0 6e 65 64 20 63 68 61 72 20 2a 70 43 65 6c 6c 2c ned char *pCell,
33dc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6d /* Com
33dd0 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 74 68 plete text of th
33de0 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 63 6f 6e 73 e cell */. cons
33df0 74 20 42 74 72 65 65 50 61 79 6c 6f 61 64 20 2a t BtreePayload *
33e00 70 58 2c 20 20 20 20 20 20 20 20 2f 2a 20 50 61 pX, /* Pa
33e10 79 6c 6f 61 64 20 77 69 74 68 20 77 68 69 63 68 yload with which
33e20 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 74 68 to construct th
33e30 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 e cell */. int
33e40 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 20 20 *pnSize
33e50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 /* Wr
33e60 69 74 65 20 63 65 6c 6c 20 73 69 7a 65 20 68 65 ite cell size he
33e70 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e re */.){. int n
33e80 50 61 79 6c 6f 61 64 3b 0a 20 20 63 6f 6e 73 74 Payload;. const
33e90 20 75 38 20 2a 70 53 72 63 3b 0a 20 20 69 6e 74 u8 *pSrc;. int
33ea0 20 6e 53 72 63 2c 20 6e 2c 20 72 63 3b 0a 20 20 nSrc, n, rc;.
33eb0 69 6e 74 20 73 70 61 63 65 4c 65 66 74 3b 0a 20 int spaceLeft;.
33ec0 20 4d 65 6d 50 61 67 65 20 2a 70 4f 76 66 6c 20 MemPage *pOvfl
33ed0 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a = 0;. MemPage *
33ee0 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 30 3b 0a pToRelease = 0;.
33ef0 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
33f00 2a 70 50 72 69 6f 72 3b 0a 20 20 75 6e 73 69 67 *pPrior;. unsig
33f10 6e 65 64 20 63 68 61 72 20 2a 70 50 61 79 6c 6f ned char *pPaylo
33f20 61 64 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a ad;. BtShared *
33f30 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 pBt = pPage->pBt
33f40 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4f 76 66 ;. Pgno pgnoOvf
33f50 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 48 65 l = 0;. int nHe
33f60 61 64 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 ader;.. assert(
33f70 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
33f80 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
33f90 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 mutex) );.. /*
33fa0 70 50 61 67 65 20 69 73 20 6e 6f 74 20 6e 65 63 pPage is not nec
33fb0 65 73 73 61 72 69 6c 79 20 77 72 69 74 65 61 62 essarily writeab
33fc0 6c 65 20 73 69 6e 63 65 20 70 43 65 6c 6c 20 6d le since pCell m
33fd0 69 67 68 74 20 62 65 20 61 75 78 69 6c 69 61 72 ight be auxiliar
33fe0 79 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 73 70 y. ** buffer sp
33ff0 61 63 65 20 74 68 61 74 20 69 73 20 73 65 70 61 ace that is sepa
34000 72 61 74 65 20 66 72 6f 6d 20 74 68 65 20 70 50 rate from the pP
34010 61 67 65 20 62 75 66 66 65 72 20 61 72 65 61 20 age buffer area
34020 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43 65 */. assert( pCe
34030 6c 6c 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 ll<pPage->aData
34040 7c 7c 20 70 43 65 6c 6c 3e 3d 26 70 50 61 67 65 || pCell>=&pPage
34050 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 ->aData[pBt->pag
34060 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 eSize].
34070 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 || sqlite3Pag
34080 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 erIswriteable(pP
34090 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
340a0 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 .. /* Fill in t
340b0 68 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 20 he header. */.
340c0 6e 48 65 61 64 65 72 20 3d 20 70 50 61 67 65 2d nHeader = pPage-
340d0 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 >childPtrSize;.
340e0 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b if( pPage->intK
340f0 65 79 20 29 7b 0a 20 20 20 20 6e 50 61 79 6c 6f ey ){. nPaylo
34100 61 64 20 3d 20 70 58 2d 3e 6e 44 61 74 61 20 2b ad = pX->nData +
34110 20 70 58 2d 3e 6e 5a 65 72 6f 3b 0a 20 20 20 20 pX->nZero;.
34120 70 53 72 63 20 3d 20 70 58 2d 3e 70 44 61 74 61 pSrc = pX->pData
34130 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 70 58 2d ;. nSrc = pX-
34140 3e 6e 44 61 74 61 3b 0a 20 20 20 20 61 73 73 65 >nData;. asse
34150 72 74 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 rt( pPage->intKe
34160 79 4c 65 61 66 20 29 3b 20 2f 2a 20 66 69 6c 6c yLeaf ); /* fill
34170 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 20 63 61 InCell() only ca
34180 6c 6c 65 64 20 66 6f 72 20 6c 65 61 76 65 73 20 lled for leaves
34190 2a 2f 0a 20 20 20 20 6e 48 65 61 64 65 72 20 2b */. nHeader +
341a0 3d 20 70 75 74 56 61 72 69 6e 74 33 32 28 26 70 = putVarint32(&p
341b0 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 6e Cell[nHeader], n
341c0 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 20 6e 48 Payload);. nH
341d0 65 61 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 eader += putVari
341e0 6e 74 28 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 nt(&pCell[nHeade
341f0 72 5d 2c 20 2a 28 75 36 34 2a 29 26 70 58 2d 3e r], *(u64*)&pX->
34200 6e 4b 65 79 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a nKey);. }else{.
34210 20 20 20 20 61 73 73 65 72 74 28 20 70 58 2d 3e assert( pX->
34220 6e 4b 65 79 3c 3d 30 78 37 66 66 66 66 66 66 66 nKey<=0x7fffffff
34230 20 26 26 20 70 58 2d 3e 70 4b 65 79 21 3d 30 20 && pX->pKey!=0
34240 29 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 6e 50 );. nSrc = nP
34250 61 79 6c 6f 61 64 20 3d 20 28 69 6e 74 29 70 58 ayload = (int)pX
34260 2d 3e 6e 4b 65 79 3b 0a 20 20 20 20 70 53 72 63 ->nKey;. pSrc
34270 20 3d 20 70 58 2d 3e 70 4b 65 79 3b 0a 20 20 20 = pX->pKey;.
34280 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 74 56 nHeader += putV
34290 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c 5b 6e arint32(&pCell[n
342a0 48 65 61 64 65 72 5d 2c 20 6e 50 61 79 6c 6f 61 Header], nPayloa
342b0 64 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 d);. }. . /*
342c0 46 69 6c 6c 20 69 6e 20 74 68 65 20 70 61 79 6c Fill in the payl
342d0 6f 61 64 20 2a 2f 0a 20 20 69 66 28 20 6e 50 61 oad */. if( nPa
342e0 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 yload<=pPage->ma
342f0 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 6e 20 xLocal ){. n
34300 3d 20 6e 48 65 61 64 65 72 20 2b 20 6e 50 61 79 = nHeader + nPay
34310 6c 6f 61 64 3b 0a 20 20 20 20 74 65 73 74 63 61 load;. testca
34320 73 65 28 20 6e 3d 3d 33 20 29 3b 0a 20 20 20 20 se( n==3 );.
34330 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 34 20 29 testcase( n==4 )
34340 3b 0a 20 20 20 20 69 66 28 20 6e 3c 34 20 29 20 ;. if( n<4 )
34350 6e 20 3d 20 34 3b 0a 20 20 20 20 2a 70 6e 53 69 n = 4;. *pnSi
34360 7a 65 20 3d 20 6e 3b 0a 20 20 20 20 73 70 61 63 ze = n;. spac
34370 65 4c 65 66 74 20 3d 20 6e 50 61 79 6c 6f 61 64 eLeft = nPayload
34380 3b 0a 20 20 20 20 70 50 72 69 6f 72 20 3d 20 70 ;. pPrior = p
34390 43 65 6c 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 Cell;. }else{.
343a0 20 20 20 69 6e 74 20 6d 6e 20 3d 20 70 50 61 67 int mn = pPag
343b0 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 e->minLocal;.
343c0 20 6e 20 3d 20 6d 6e 20 2b 20 28 6e 50 61 79 6c n = mn + (nPayl
343d0 6f 61 64 20 2d 20 6d 6e 29 20 25 20 28 70 50 61 oad - mn) % (pPa
343e0 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
343f0 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 74 65 ize - 4);. te
34400 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 61 67 65 stcase( n==pPage
34410 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 ->maxLocal );.
34420 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 testcase( n==p
34430 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 Page->maxLocal+1
34440 20 29 3b 0a 20 20 20 20 69 66 28 20 6e 20 3e 20 );. if( n >
34450 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
34460 29 20 6e 20 3d 20 6d 6e 3b 0a 20 20 20 20 73 70 ) n = mn;. sp
34470 61 63 65 4c 65 66 74 20 3d 20 6e 3b 0a 20 20 20 aceLeft = n;.
34480 20 2a 70 6e 53 69 7a 65 20 3d 20 6e 20 2b 20 6e *pnSize = n + n
34490 48 65 61 64 65 72 20 2b 20 34 3b 0a 20 20 20 20 Header + 4;.
344a0 70 50 72 69 6f 72 20 3d 20 26 70 43 65 6c 6c 5b pPrior = &pCell[
344b0 6e 48 65 61 64 65 72 2b 6e 5d 3b 0a 20 20 7d 0a nHeader+n];. }.
344c0 20 20 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 43 pPayload = &pC
344d0 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 3b 0a 0a 20 ell[nHeader];..
344e0 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e /* At this poin
344f0 74 20 76 61 72 69 61 62 6c 65 73 20 73 68 6f 75 t variables shou
34500 6c 64 20 62 65 20 73 65 74 20 61 73 20 66 6f 6c ld be set as fol
34510 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 lows:. **. **
34520 20 20 6e 50 61 79 6c 6f 61 64 20 20 20 20 20 20 nPayload
34530 20 20 20 20 20 54 6f 74 61 6c 20 70 61 79 6c 6f Total paylo
34540 61 64 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 ad size in bytes
34550 0a 20 20 2a 2a 20 20 20 70 50 61 79 6c 6f 61 64 . ** pPayload
34560 20 20 20 20 20 20 20 20 20 20 20 42 65 67 69 6e Begin
34570 20 77 72 69 74 69 6e 67 20 70 61 79 6c 6f 61 64 writing payload
34580 20 68 65 72 65 0a 20 20 2a 2a 20 20 20 73 70 61 here. ** spa
34590 63 65 4c 65 66 74 20 20 20 20 20 20 20 20 20 20 ceLeft
345a0 53 70 61 63 65 20 61 76 61 69 6c 61 62 6c 65 20 Space available
345b0 61 74 20 70 50 61 79 6c 6f 61 64 2e 20 20 49 66 at pPayload. If
345c0 20 6e 50 61 79 6c 6f 61 64 3e 73 70 61 63 65 4c nPayload>spaceL
345d0 65 66 74 2c 0a 20 20 2a 2a 20 20 20 20 20 20 20 eft,. **
345e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
345f0 68 61 74 20 6d 65 61 6e 73 20 63 6f 6e 74 65 6e hat means conten
34600 74 20 6d 75 73 74 20 73 70 69 6c 6c 20 69 6e 74 t must spill int
34610 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 o overflow pages
34620 2e 0a 20 20 2a 2a 20 20 20 2a 70 6e 53 69 7a 65 .. ** *pnSize
34630 20 20 20 20 20 20 20 20 20 20 20 20 53 69 7a 65 Size
34640 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 63 65 of the local ce
34650 6c 6c 20 28 6e 6f 74 20 63 6f 75 6e 74 69 6e 67 ll (not counting
34660 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 29 overflow pages)
34670 0a 20 20 2a 2a 20 20 20 70 50 72 69 6f 72 20 20 . ** pPrior
34680 20 20 20 20 20 20 20 20 20 20 20 57 68 65 72 65 Where
34690 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 70 67 to write the pg
346a0 6e 6f 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 no of the first
346b0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 overflow page.
346c0 2a 2a 0a 20 20 2a 2a 20 55 73 65 20 61 20 63 61 **. ** Use a ca
346d0 6c 6c 20 74 6f 20 62 74 72 65 65 50 61 72 73 65 ll to btreeParse
346e0 43 65 6c 6c 50 74 72 28 29 20 74 6f 20 76 65 72 CellPtr() to ver
346f0 69 66 79 20 74 68 61 74 20 74 68 65 20 76 61 6c ify that the val
34700 75 65 73 20 61 62 6f 76 65 0a 20 20 2a 2a 20 77 ues above. ** w
34710 65 72 65 20 63 6f 6d 70 75 74 65 64 20 63 6f 72 ere computed cor
34720 72 65 63 74 6c 79 2e 0a 20 20 2a 2f 0a 23 69 66 rectly.. */.#if
34730 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
34740 0a 20 20 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 . {. CellInf
34750 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 70 50 61 67 o info;. pPag
34760 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 e->xParseCell(pP
34770 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 age, pCell, &inf
34780 6f 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 o);. assert(
34790 6e 48 65 61 64 65 72 3d 3d 28 69 6e 74 29 28 69 nHeader==(int)(i
347a0 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 20 2d 20 70 nfo.pPayload - p
347b0 43 65 6c 6c 29 20 29 3b 0a 20 20 20 20 61 73 73 Cell) );. ass
347c0 65 72 74 28 20 69 6e 66 6f 2e 6e 4b 65 79 3d 3d ert( info.nKey==
347d0 70 58 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 20 20 pX->nKey );.
347e0 61 73 73 65 72 74 28 20 2a 70 6e 53 69 7a 65 20 assert( *pnSize
347f0 3d 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 20 29 3b == info.nSize );
34800 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 70 61 . assert( spa
34810 63 65 4c 65 66 74 20 3d 3d 20 69 6e 66 6f 2e 6e ceLeft == info.n
34820 4c 6f 63 61 6c 20 29 3b 0a 20 20 7d 0a 23 65 6e Local );. }.#en
34830 64 69 66 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 dif.. /* Write
34840 74 68 65 20 70 61 79 6c 6f 61 64 20 69 6e 74 6f the payload into
34850 20 74 68 65 20 6c 6f 63 61 6c 20 43 65 6c 6c 20 the local Cell
34860 61 6e 64 20 61 6e 79 20 65 78 74 72 61 20 69 6e and any extra in
34870 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 to overflow page
34880 73 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 6e 50 s */. while( nP
34890 61 79 6c 6f 61 64 3e 30 20 29 7b 0a 20 20 20 20 ayload>0 ){.
348a0 69 66 28 20 73 70 61 63 65 4c 65 66 74 3d 3d 30 if( spaceLeft==0
348b0 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ){.#ifndef SQLI
348c0 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
348d0 55 4d 0a 20 20 20 20 20 20 50 67 6e 6f 20 70 67 UM. Pgno pg
348e0 6e 6f 50 74 72 6d 61 70 20 3d 20 70 67 6e 6f 4f noPtrmap = pgnoO
348f0 76 66 6c 3b 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 vfl; /* Overflow
34900 20 70 61 67 65 20 70 6f 69 6e 74 65 72 2d 6d 61 page pointer-ma
34910 70 20 65 6e 74 72 79 20 70 61 67 65 20 2a 2f 0a p entry page */.
34920 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 if( pBt->a
34930 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 utoVacuum ){.
34940 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 20 do{.
34950 20 20 20 70 67 6e 6f 4f 76 66 6c 2b 2b 3b 0a 20 pgnoOvfl++;.
34960 20 20 20 20 20 20 20 7d 20 77 68 69 6c 65 28 20 } while(
34970 0a 20 20 20 20 20 20 20 20 20 20 50 54 52 4d 41 . PTRMA
34980 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 70 67 P_ISPAGE(pBt, pg
34990 6e 6f 4f 76 66 6c 29 20 7c 7c 20 70 67 6e 6f 4f noOvfl) || pgnoO
349a0 76 66 6c 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 vfl==PENDING_BYT
349b0 45 5f 50 41 47 45 28 70 42 74 29 20 0a 20 20 20 E_PAGE(pBt) .
349c0 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 7d 0a );. }.
349d0 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 #endif. rc
349e0 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 = allocateBtreeP
349f0 61 67 65 28 70 42 74 2c 20 26 70 4f 76 66 6c 2c age(pBt, &pOvfl,
34a00 20 26 70 67 6e 6f 4f 76 66 6c 2c 20 70 67 6e 6f &pgnoOvfl, pgno
34a10 4f 76 66 6c 2c 20 30 29 3b 0a 23 69 66 6e 64 65 Ovfl, 0);.#ifnde
34a20 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
34a30 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f TOVACUUM. /
34a40 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 * If the databas
34a50 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d e supports auto-
34a60 76 61 63 75 75 6d 2c 20 61 6e 64 20 74 68 65 20 vacuum, and the
34a70 73 65 63 6f 6e 64 20 6f 72 20 73 75 62 73 65 71 second or subseq
34a80 75 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 6f 76 uent. ** ov
34a90 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 62 erflow page is b
34aa0 65 69 6e 67 20 61 6c 6c 6f 63 61 74 65 64 2c 20 eing allocated,
34ab0 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 add an entry to
34ac0 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a the pointer-map.
34ad0 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 68 61 ** for tha
34ae0 74 20 70 61 67 65 20 6e 6f 77 2e 20 0a 20 20 20 t page now. .
34af0 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49 **. ** I
34b00 66 20 74 68 69 73 20 69 73 20 74 68 65 20 66 69 f this is the fi
34b10 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 rst overflow pag
34b20 65 2c 20 74 68 65 6e 20 77 72 69 74 65 20 61 20 e, then write a
34b30 70 61 72 74 69 61 6c 20 65 6e 74 72 79 20 0a 20 partial entry .
34b40 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 70 ** to the p
34b50 6f 69 6e 74 65 72 2d 6d 61 70 2e 20 49 66 20 77 ointer-map. If w
34b60 65 20 77 72 69 74 65 20 6e 6f 74 68 69 6e 67 20 e write nothing
34b70 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 65 72 2d to this pointer-
34b80 6d 61 70 20 73 6c 6f 74 2c 0a 20 20 20 20 20 20 map slot,.
34b90 2a 2a 20 74 68 65 6e 20 74 68 65 20 6f 70 74 69 ** then the opti
34ba0 6d 69 73 74 69 63 20 6f 76 65 72 66 6c 6f 77 20 mistic overflow
34bb0 63 68 61 69 6e 20 70 72 6f 63 65 73 73 69 6e 67 chain processing
34bc0 20 69 6e 20 63 6c 65 61 72 43 65 6c 6c 28 29 0a in clearCell().
34bd0 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 6d 69 73 ** may mis
34be0 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 75 6e interpret the un
34bf0 69 6e 69 74 69 61 6c 69 7a 65 64 20 76 61 6c 75 initialized valu
34c00 65 73 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 es and delete th
34c10 65 0a 20 20 20 20 20 20 2a 2a 20 77 72 6f 6e 67 e. ** wrong
34c20 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 65 20 pages from the
34c30 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 database..
34c40 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 */. if( pBt
34c50 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 26 20 ->autoVacuum &&
34c60 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
34c70 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 79 70 . u8 eTyp
34c80 65 20 3d 20 28 70 67 6e 6f 50 74 72 6d 61 70 3f e = (pgnoPtrmap?
34c90 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
34ca0 3a 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 :PTRMAP_OVERFLOW
34cb0 31 29 3b 0a 20 20 20 20 20 20 20 20 70 74 72 6d 1);. ptrm
34cc0 61 70 50 75 74 28 70 42 74 2c 20 70 67 6e 6f 4f apPut(pBt, pgnoO
34cd0 76 66 6c 2c 20 65 54 79 70 65 2c 20 70 67 6e 6f vfl, eType, pgno
34ce0 50 74 72 6d 61 70 2c 20 26 72 63 29 3b 0a 20 20 Ptrmap, &rc);.
34cf0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
34d00 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 releas
34d10 65 50 61 67 65 28 70 4f 76 66 6c 29 3b 0a 20 20 ePage(pOvfl);.
34d20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
34d30 23 65 6e 64 69 66 0a 20 20 20 20 20 20 69 66 28 #endif. if(
34d40 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 72 rc ){. r
34d50 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f 52 65 eleasePage(pToRe
34d60 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 20 20 lease);.
34d70 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
34d80 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
34d90 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 6e 6f pToRelease is no
34da0 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 72 69 t zero than pPri
34db0 6f 72 20 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 or points into t
34dc0 68 65 20 64 61 74 61 20 61 72 65 61 0a 20 20 20 he data area.
34dd0 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 6c 65 ** of pToRele
34de0 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 ase. Make sure
34df0 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 73 74 pToRelease is st
34e00 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e 20 2a ill writeable. *
34e10 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 /. assert(
34e20 70 54 6f 52 65 6c 65 61 73 65 3d 3d 30 20 7c 7c pToRelease==0 ||
34e30 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
34e40 72 69 74 65 61 62 6c 65 28 70 54 6f 52 65 6c 65 riteable(pToRele
34e50 61 73 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b ase->pDbPage) );
34e60 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 50 .. /* If pP
34e70 72 69 6f 72 20 69 73 20 70 61 72 74 20 6f 66 20 rior is part of
34e80 74 68 65 20 64 61 74 61 20 61 72 65 61 20 6f 66 the data area of
34e90 20 70 50 61 67 65 2c 20 74 68 65 6e 20 6d 61 6b pPage, then mak
34ea0 65 20 73 75 72 65 20 70 50 61 67 65 0a 20 20 20 e sure pPage.
34eb0 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c 20 77 ** is still w
34ec0 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 20 20 riteable */.
34ed0 20 20 61 73 73 65 72 74 28 20 70 50 72 69 6f 72 assert( pPrior
34ee0 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c <pPage->aData ||
34ef0 20 70 50 72 69 6f 72 3e 3d 26 70 50 61 67 65 2d pPrior>=&pPage-
34f00 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 >aData[pBt->page
34f10 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 Size].
34f20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 || sqlite3Page
34f30 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
34f40 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
34f50 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 . put4byte(
34f60 70 50 72 69 6f 72 2c 20 70 67 6e 6f 4f 76 66 6c pPrior, pgnoOvfl
34f70 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 );. release
34f80 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 Page(pToRelease)
34f90 3b 0a 20 20 20 20 20 20 70 54 6f 52 65 6c 65 61 ;. pToRelea
34fa0 73 65 20 3d 20 70 4f 76 66 6c 3b 0a 20 20 20 20 se = pOvfl;.
34fb0 20 20 70 50 72 69 6f 72 20 3d 20 70 4f 76 66 6c pPrior = pOvfl
34fc0 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 20 70 ->aData;. p
34fd0 75 74 34 62 79 74 65 28 70 50 72 69 6f 72 2c 20 ut4byte(pPrior,
34fe0 30 29 3b 0a 20 20 20 20 20 20 70 50 61 79 6c 6f 0);. pPaylo
34ff0 61 64 20 3d 20 26 70 4f 76 66 6c 2d 3e 61 44 61 ad = &pOvfl->aDa
35000 74 61 5b 34 5d 3b 0a 20 20 20 20 20 20 73 70 61 ta[4];. spa
35010 63 65 4c 65 66 74 20 3d 20 70 42 74 2d 3e 75 73 ceLeft = pBt->us
35020 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
35030 20 20 7d 0a 20 20 20 20 6e 20 3d 20 6e 50 61 79 }. n = nPay
35040 6c 6f 61 64 3b 0a 20 20 20 20 69 66 28 20 6e 3e load;. if( n>
35050 73 70 61 63 65 4c 65 66 74 20 29 20 6e 20 3d 20 spaceLeft ) n =
35060 73 70 61 63 65 4c 65 66 74 3b 0a 0a 20 20 20 20 spaceLeft;..
35070 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 73 65 /* If pToRelease
35080 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 68 61 is not zero tha
35090 6e 20 70 50 61 79 6c 6f 61 64 20 70 6f 69 6e 74 n pPayload point
350a0 73 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 20 s into the data
350b0 61 72 65 61 0a 20 20 20 20 2a 2a 20 6f 66 20 70 area. ** of p
350c0 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 6b 65 ToRelease. Make
350d0 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 73 65 sure pToRelease
350e0 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 is still writea
350f0 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 ble. */. asse
35100 72 74 28 20 70 54 6f 52 65 6c 65 61 73 65 3d 3d rt( pToRelease==
35110 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 0 || sqlite3Page
35120 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 54 6f rIswriteable(pTo
35130 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 67 65 Release->pDbPage
35140 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 ) );.. /* If
35150 70 50 61 79 6c 6f 61 64 20 69 73 20 70 61 72 74 pPayload is part
35160 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 72 65 of the data are
35170 61 20 6f 66 20 70 50 61 67 65 2c 20 74 68 65 6e a of pPage, then
35180 20 6d 61 6b 65 20 73 75 72 65 20 70 50 61 67 65 make sure pPage
35190 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c . ** is still
351a0 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 writeable */.
351b0 20 20 61 73 73 65 72 74 28 20 70 50 61 79 6c 6f assert( pPaylo
351c0 61 64 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 ad<pPage->aData
351d0 7c 7c 20 70 50 61 79 6c 6f 61 64 3e 3d 26 70 50 || pPayload>=&pP
351e0 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e age->aData[pBt->
351f0 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 pageSize].
35200 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 || sqlite3
35210 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
35220 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
35230 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e 53 72 );.. if( nSr
35240 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 c>0 ){. if(
35250 20 6e 3e 6e 53 72 63 20 29 20 6e 20 3d 20 6e 53 n>nSrc ) n = nS
35260 72 63 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 rc;. assert
35270 28 20 70 53 72 63 20 29 3b 0a 20 20 20 20 20 20 ( pSrc );.
35280 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 2c memcpy(pPayload,
35290 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 20 20 7d pSrc, n);. }
352a0 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 6d 73 else{. mems
352b0 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 30 2c 20 et(pPayload, 0,
352c0 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 50 n);. }. nP
352d0 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a 20 20 20 ayload -= n;.
352e0 20 70 50 61 79 6c 6f 61 64 20 2b 3d 20 6e 3b 0a pPayload += n;.
352f0 20 20 20 20 70 53 72 63 20 2b 3d 20 6e 3b 0a 20 pSrc += n;.
35300 20 20 20 6e 53 72 63 20 2d 3d 20 6e 3b 0a 20 20 nSrc -= n;.
35310 20 20 73 70 61 63 65 4c 65 66 74 20 2d 3d 20 6e spaceLeft -= n
35320 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 50 ;. }. releaseP
35330 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 3b age(pToRelease);
35340 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
35350 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 _OK;.}../*.** Re
35360 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 20 63 65 move the i-th ce
35370 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 20 20 ll from pPage.
35380 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 66 66 This routine eff
35390 65 63 74 73 20 70 50 61 67 65 20 6f 6e 6c 79 2e ects pPage only.
353a0 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 63 6f 6e .** The cell con
353b0 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 72 65 65 tent is not free
353c0 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 74 65 64 d or deallocated
353d0 2e 20 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 . It is assumed
353e0 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 65 6c that.** the cel
353f0 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 62 65 l content has be
35400 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d 65 70 6c en copied somepl
35410 61 63 65 20 65 6c 73 65 2e 20 20 54 68 69 73 20 ace else. This
35420 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a 2a 2a 20 routine just.**
35430 72 65 6d 6f 76 65 73 20 74 68 65 20 72 65 66 65 removes the refe
35440 72 65 6e 63 65 20 74 6f 20 74 68 65 20 63 65 6c rence to the cel
35450 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 0a 2a 2a l from pPage..**
35460 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 20 62 65 .** "sz" must be
35470 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
35480 79 74 65 73 20 69 6e 20 74 68 65 20 63 65 6c 6c ytes in the cell
35490 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
354a0 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d 50 61 67 dropCell(MemPag
354b0 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 64 e *pPage, int id
354c0 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 2a x, int sz, int *
354d0 70 52 43 29 7b 0a 20 20 75 33 32 20 70 63 3b 20 pRC){. u32 pc;
354e0 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
354f0 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 65 6e t to cell conten
35500 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 6e 67 20 t of cell being
35510 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 75 38 20 deleted */. u8
35520 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 *data; /*
35530 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a pPage->aData */.
35540 20 20 75 38 20 2a 70 74 72 3b 20 20 20 20 20 20 u8 *ptr;
35550 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 6d 6f 76 /* Used to mov
35560 65 20 62 79 74 65 73 20 61 72 6f 75 6e 64 20 77 e bytes around w
35570 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a ithin data[] */.
35580 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
35590 20 20 2f 2a 20 54 68 65 20 72 65 74 75 72 6e 20 /* The return
355a0 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68 64 code */. int hd
355b0 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 42 65 67 r; /* Beg
355c0 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 68 65 inning of the he
355d0 61 64 65 72 2e 20 20 30 20 6d 6f 73 74 20 70 61 ader. 0 most pa
355e0 67 65 73 2e 20 20 31 30 30 20 70 61 67 65 20 31 ges. 100 page 1
355f0 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 */.. if( *pRC
35600 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 ) return;. asse
35610 72 74 28 20 69 64 78 3e 3d 30 20 26 26 20 69 64 rt( idx>=0 && id
35620 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 x<pPage->nCell )
35630 3b 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 ;. assert( CORR
35640 55 50 54 5f 44 42 20 7c 7c 20 73 7a 3d 3d 63 65 UPT_DB || sz==ce
35650 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 69 64 llSize(pPage, id
35660 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
35670 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
35680 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
35690 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 DbPage) );. ass
356a0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
356b0 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
356c0 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
356d0 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
356e0 61 74 61 3b 0a 20 20 70 74 72 20 3d 20 26 70 50 ata;. ptr = &pP
356f0 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a age->aCellIdx[2*
35700 69 64 78 5d 3b 0a 20 20 70 63 20 3d 20 67 65 74 idx];. pc = get
35710 32 62 79 74 65 28 70 74 72 29 3b 0a 20 20 68 64 2byte(ptr);. hd
35720 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 r = pPage->hdrOf
35730 66 73 65 74 3b 0a 20 20 74 65 73 74 63 61 73 65 fset;. testcase
35740 28 20 70 63 3d 3d 67 65 74 32 62 79 74 65 28 26 ( pc==get2byte(&
35750 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 3b 0a data[hdr+5]) );.
35760 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
35770 7a 3d 3d 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 z==pPage->pBt->u
35780 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 69 sableSize );. i
35790 66 28 20 70 63 20 3c 20 28 75 33 32 29 67 65 74 f( pc < (u32)get
357a0 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
357b0 35 5d 29 20 7c 7c 20 70 63 2b 73 7a 20 3e 20 70 5]) || pc+sz > p
357c0 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
357d0 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 2a 70 52 eSize ){. *pR
357e0 43 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 C = SQLITE_CORRU
357f0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 PT_BKPT;. ret
35800 75 72 6e 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 urn;. }. rc =
35810 66 72 65 65 53 70 61 63 65 28 70 50 61 67 65 2c freeSpace(pPage,
35820 20 70 63 2c 20 73 7a 29 3b 0a 20 20 69 66 28 20 pc, sz);. if(
35830 72 63 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d rc ){. *pRC =
35840 20 72 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b rc;. return;
35850 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6e 43 . }. pPage->nC
35860 65 6c 6c 2d 2d 3b 0a 20 20 69 66 28 20 70 50 61 ell--;. if( pPa
35870 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 7b 0a ge->nCell==0 ){.
35880 20 20 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 memset(&data
35890 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a [hdr+1], 0, 4);.
358a0 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 data[hdr+7]
358b0 3d 20 30 3b 0a 20 20 20 20 70 75 74 32 62 79 74 = 0;. put2byt
358c0 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 e(&data[hdr+5],
358d0 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
358e0 6c 65 53 69 7a 65 29 3b 0a 20 20 20 20 70 50 61 leSize);. pPa
358f0 67 65 2d 3e 6e 46 72 65 65 20 3d 20 70 50 61 67 ge->nFree = pPag
35900 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
35910 7a 65 20 2d 20 70 50 61 67 65 2d 3e 68 64 72 4f ze - pPage->hdrO
35920 66 66 73 65 74 0a 20 20 20 20 20 20 20 20 20 20 ffset.
35930 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 20 70 - p
35940 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 Page->childPtrSi
35950 7a 65 20 2d 20 38 3b 0a 20 20 7d 65 6c 73 65 7b ze - 8;. }else{
35960 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 74 72 . memmove(ptr
35970 2c 20 70 74 72 2b 32 2c 20 32 2a 28 70 50 61 67 , ptr+2, 2*(pPag
35980 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 64 78 29 29 e->nCell - idx))
35990 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 ;. put2byte(&
359a0 64 61 74 61 5b 68 64 72 2b 33 5d 2c 20 70 50 61 data[hdr+3], pPa
359b0 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 20 20 ge->nCell);.
359c0 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 pPage->nFree +=
359d0 32 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 2;. }.}../*.**
359e0 49 6e 73 65 72 74 20 61 20 6e 65 77 20 63 65 6c Insert a new cel
359f0 6c 20 6f 6e 20 70 50 61 67 65 20 61 74 20 63 65 l on pPage at ce
35a00 6c 6c 20 69 6e 64 65 78 20 22 69 22 2e 20 20 70 ll index "i". p
35a10 43 65 6c 6c 20 70 6f 69 6e 74 73 20 74 6f 20 74 Cell points to t
35a20 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 6f 66 he.** content of
35a30 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2a 0a 2a 2a the cell..**.**
35a40 20 49 66 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e If the cell con
35a50 74 65 6e 74 20 77 69 6c 6c 20 66 69 74 20 6f 6e tent will fit on
35a60 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 6e 20 the page, then
35a70 70 75 74 20 69 74 20 74 68 65 72 65 2e 20 20 49 put it there. I
35a80 66 20 69 74 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 f it.** will not
35a90 20 66 69 74 2c 20 74 68 65 6e 20 6d 61 6b 65 20 fit, then make
35aa0 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 63 65 a copy of the ce
35ab0 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 74 6f 20 ll content into
35ac0 70 54 65 6d 70 20 69 66 0a 2a 2a 20 70 54 65 6d pTemp if.** pTem
35ad0 70 20 69 73 20 6e 6f 74 20 6e 75 6c 6c 2e 20 20 p is not null.
35ae0 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 70 54 Regardless of pT
35af0 65 6d 70 2c 20 61 6c 6c 6f 63 61 74 65 20 61 20 emp, allocate a
35b00 6e 65 77 20 65 6e 74 72 79 0a 2a 2a 20 69 6e 20 new entry.** in
35b10 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 5d 20 pPage->apOvfl[]
35b20 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f 69 6e and make it poin
35b30 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f t to the cell co
35b40 6e 74 65 6e 74 20 28 65 69 74 68 65 72 0a 2a 2a ntent (either.**
35b50 20 69 6e 20 70 54 65 6d 70 20 6f 72 20 74 68 65 in pTemp or the
35b60 20 6f 72 69 67 69 6e 61 6c 20 70 43 65 6c 6c 29 original pCell)
35b70 20 61 6e 64 20 61 6c 73 6f 20 72 65 63 6f 72 64 and also record
35b80 20 69 74 73 20 69 6e 64 65 78 2e 20 0a 2a 2a 20 its index. .**
35b90 41 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 Allocating a new
35ba0 20 65 6e 74 72 79 20 69 6e 20 70 50 61 67 65 2d entry in pPage-
35bb0 3e 61 43 65 6c 6c 5b 5d 20 69 6d 70 6c 69 65 73 >aCell[] implies
35bc0 20 74 68 61 74 20 0a 2a 2a 20 70 50 61 67 65 2d that .** pPage-
35bd0 3e 6e 4f 76 65 72 66 6c 6f 77 20 69 73 20 69 6e >nOverflow is in
35be0 63 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a cremented..**.**
35bf0 20 2a 70 52 43 20 6d 75 73 74 20 62 65 20 53 51 *pRC must be SQ
35c00 4c 49 54 45 5f 4f 4b 20 77 68 65 6e 20 74 68 69 LITE_OK when thi
35c10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
35c20 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 led..*/.static v
35c30 6f 69 64 20 69 6e 73 65 72 74 43 65 6c 6c 28 0a oid insertCell(.
35c40 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
35c50 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 6e 74 6f , /* Page into
35c60 20 77 68 69 63 68 20 77 65 20 61 72 65 20 63 6f which we are co
35c70 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 pying */. int i
35c80 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
35c90 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f 6d 65 73 New cell becomes
35ca0 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 6f the i-th cell o
35cb0 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 f the page */.
35cc0 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 u8 *pCell,
35cd0 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 6f 66 20 /* Content of
35ce0 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 2a 2f 0a the new cell */.
35cf0 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 20 20 20 int sz,
35d00 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 /* Bytes of
35d10 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 65 6c 6c content in pCell
35d20 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 6d 70 2c */. u8 *pTemp,
35d30 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 /* Temp
35d40 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 66 6f storage space fo
35d50 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e 65 65 64 r pCell, if need
35d60 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 43 68 ed */. Pgno iCh
35d70 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 49 66 20 ild, /* If
35d80 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 6c 61 63 non-zero, replac
35d90 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 20 e first 4 bytes
35da0 77 69 74 68 20 74 68 69 73 20 76 61 6c 75 65 20 with this value
35db0 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 20 20 20 */. int *pRC
35dc0 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 61 /* Read a
35dd0 6e 64 20 77 72 69 74 65 20 72 65 74 75 72 6e 20 nd write return
35de0 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 65 20 2a code from here *
35df0 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 78 20 3d /.){. int idx =
35e00 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 68 65 72 0; /* Wher
35e10 65 20 74 6f 20 77 72 69 74 65 20 6e 65 77 20 63 e to write new c
35e20 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 20 64 ell content in d
35e30 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6a ata[] */. int j
35e40 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
35e50 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
35e60 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 20 20 u8 *data;
35e70 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e 74 65 /* The conte
35e80 6e 74 20 6f 66 20 74 68 65 20 77 68 6f 6c 65 20 nt of the whole
35e90 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a 70 49 page */. u8 *pI
35ea0 6e 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 ns; /* T
35eb0 68 65 20 70 6f 69 6e 74 20 69 6e 20 70 50 61 67 he point in pPag
35ec0 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 5d 20 77 68 e->aCellIdx[] wh
35ed0 65 72 65 20 6e 6f 20 63 65 6c 6c 20 69 6e 73 65 ere no cell inse
35ee0 72 74 65 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 rted */.. asser
35ef0 74 28 20 2a 70 52 43 3d 3d 53 51 4c 49 54 45 5f t( *pRC==SQLITE_
35f00 4f 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 OK );. assert(
35f10 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 61 67 65 i>=0 && i<=pPage
35f20 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 2d 3e 6e ->nCell+pPage->n
35f30 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 20 61 73 Overflow );. as
35f40 73 65 72 74 28 20 4d 58 5f 43 45 4c 4c 28 70 50 sert( MX_CELL(pP
35f50 61 67 65 2d 3e 70 42 74 29 3c 3d 31 30 39 32 31 age->pBt)<=10921
35f60 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
35f70 61 67 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d 58 5f 43 age->nCell<=MX_C
35f80 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 20 ELL(pPage->pBt)
35f90 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
35fa0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
35fb0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3c 3d 41 72 72 ->nOverflow<=Arr
35fc0 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 aySize(pPage->ap
35fd0 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 Ovfl) );. asser
35fe0 74 28 20 41 72 72 61 79 53 69 7a 65 28 70 50 61 t( ArraySize(pPa
35ff0 67 65 2d 3e 61 70 4f 76 66 6c 29 3d 3d 41 72 72 ge->apOvfl)==Arr
36000 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 69 aySize(pPage->ai
36010 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 73 65 72 Ovfl) );. asser
36020 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
36030 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 _held(pPage->pBt
36040 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a ->mutex) );. /*
36050 20 54 68 65 20 63 65 6c 6c 20 73 68 6f 75 6c 64 The cell should
36060 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 73 69 7a normally be siz
36070 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 48 ed correctly. H
36080 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 6d 6f 76 owever, when mov
36090 69 6e 67 20 61 0a 20 20 2a 2a 20 6d 61 6c 66 6f ing a. ** malfo
360a0 72 6d 65 64 20 63 65 6c 6c 20 66 72 6f 6d 20 61 rmed cell from a
360b0 20 6c 65 61 66 20 70 61 67 65 20 74 6f 20 61 6e leaf page to an
360c0 20 69 6e 74 65 72 69 6f 72 20 70 61 67 65 2c 20 interior page,
360d0 69 66 20 74 68 65 20 63 65 6c 6c 20 73 69 7a 65 if the cell size
360e0 0a 20 20 2a 2a 20 77 61 6e 74 65 64 20 74 6f 20 . ** wanted to
360f0 62 65 20 6c 65 73 73 20 74 68 61 6e 20 34 20 62 be less than 4 b
36100 75 74 20 67 6f 74 20 72 6f 75 6e 64 65 64 20 75 ut got rounded u
36110 70 20 74 6f 20 34 20 6f 6e 20 74 68 65 20 6c 65 p to 4 on the le
36120 61 66 2c 20 74 68 65 6e 20 73 69 7a 65 0a 20 20 af, then size.
36130 2a 2a 20 6d 69 67 68 74 20 62 65 20 6c 65 73 73 ** might be less
36140 20 74 68 61 6e 20 38 20 28 6c 65 61 66 2d 73 69 than 8 (leaf-si
36150 7a 65 20 2b 20 70 6f 69 6e 74 65 72 29 20 6f 6e ze + pointer) on
36160 20 74 68 65 20 69 6e 74 65 72 69 6f 72 20 6e 6f the interior no
36170 64 65 2e 20 20 48 65 6e 63 65 0a 20 20 2a 2a 20 de. Hence. **
36180 74 68 65 20 74 65 72 6d 20 61 66 74 65 72 20 74 the term after t
36190 68 65 20 7c 7c 20 69 6e 20 74 68 65 20 66 6f 6c he || in the fol
361a0 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 28 29 2e lowing assert().
361b0 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 7a */. assert( sz
361c0 3d 3d 70 50 61 67 65 2d 3e 78 43 65 6c 6c 53 69 ==pPage->xCellSi
361d0 7a 65 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 29 ze(pPage, pCell)
361e0 20 7c 7c 20 28 73 7a 3d 3d 38 20 26 26 20 69 43 || (sz==8 && iC
361f0 68 69 6c 64 3e 30 29 20 29 3b 0a 20 20 69 66 28 hild>0) );. if(
36200 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
36210 77 20 7c 7c 20 73 7a 2b 32 3e 70 50 61 67 65 2d w || sz+2>pPage-
36220 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 20 69 66 >nFree ){. if
36230 28 20 70 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 ( pTemp ){.
36240 20 6d 65 6d 63 70 79 28 70 54 65 6d 70 2c 20 70 memcpy(pTemp, p
36250 43 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 20 20 Cell, sz);.
36260 20 70 43 65 6c 6c 20 3d 20 70 54 65 6d 70 3b 0a pCell = pTemp;.
36270 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 43 }. if( iC
36280 68 69 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 75 hild ){. pu
36290 74 34 62 79 74 65 28 70 43 65 6c 6c 2c 20 69 43 t4byte(pCell, iC
362a0 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 hild);. }.
362b0 20 6a 20 3d 20 70 50 61 67 65 2d 3e 6e 4f 76 65 j = pPage->nOve
362c0 72 66 6c 6f 77 2b 2b 3b 0a 20 20 20 20 2f 2a 20 rflow++;. /*
362d0 43 6f 6d 70 61 72 69 73 6f 6e 20 61 67 61 69 6e Comparison again
362e0 73 74 20 41 72 72 61 79 53 69 7a 65 2d 31 20 73 st ArraySize-1 s
362f0 69 6e 63 65 20 77 65 20 68 6f 6c 64 20 62 61 63 ince we hold bac
36300 6b 20 6f 6e 65 20 65 78 74 72 61 20 73 6c 6f 74 k one extra slot
36310 0a 20 20 20 20 2a 2a 20 61 73 20 61 20 63 6f 6e . ** as a con
36320 74 69 6e 67 65 6e 63 79 2e 20 20 49 6e 20 6f 74 tingency. In ot
36330 68 65 72 20 77 6f 72 64 73 2c 20 6e 65 76 65 72 her words, never
36340 20 6e 65 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 need more than
36350 33 20 6f 76 65 72 66 6c 6f 77 0a 20 20 20 20 2a 3 overflow. *
36360 2a 20 73 6c 6f 74 73 20 62 75 74 20 34 20 61 72 * slots but 4 ar
36370 65 20 61 6c 6c 6f 63 61 74 65 64 2c 20 6a 75 73 e allocated, jus
36380 74 20 74 6f 20 62 65 20 73 61 66 65 2e 20 2a 2f t to be safe. */
36390 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a 20 3c . assert( j <
363a0 20 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 ArraySize(pPage
363b0 2d 3e 61 70 4f 76 66 6c 29 2d 31 20 29 3b 0a 20 ->apOvfl)-1 );.
363c0 20 20 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c pPage->apOvfl
363d0 5b 6a 5d 20 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 [j] = pCell;.
363e0 20 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a pPage->aiOvfl[j
363f0 5d 20 3d 20 28 75 31 36 29 69 3b 0a 0a 20 20 20 ] = (u16)i;..
36400 20 2f 2a 20 57 68 65 6e 20 6d 75 6c 74 69 70 6c /* When multipl
36410 65 20 6f 76 65 72 66 6c 6f 77 73 20 6f 63 63 75 e overflows occu
36420 72 2c 20 74 68 65 79 20 61 72 65 20 61 6c 77 61 r, they are alwa
36430 79 73 20 73 65 71 75 65 6e 74 69 61 6c 20 61 6e ys sequential an
36440 64 20 69 6e 0a 20 20 20 20 2a 2a 20 73 6f 72 74 d in. ** sort
36450 65 64 20 6f 72 64 65 72 2e 20 20 54 68 69 73 20 ed order. This
36460 69 6e 76 61 72 69 61 6e 74 73 20 61 72 69 73 65 invariants arise
36470 20 62 65 63 61 75 73 65 20 6d 75 6c 74 69 70 6c because multipl
36480 65 20 6f 76 65 72 66 6c 6f 77 73 20 63 61 6e 0a e overflows can.
36490 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 6f 63 63 75 ** only occu
364a0 72 20 77 68 65 6e 20 69 6e 73 65 72 74 69 6e 67 r when inserting
364b0 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 20 69 divider cells i
364c0 6e 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 nto the parent p
364d0 61 67 65 20 64 75 72 69 6e 67 0a 20 20 20 20 2a age during. *
364e0 2a 20 62 61 6c 61 6e 63 69 6e 67 2c 20 61 6e 64 * balancing, and
364f0 20 74 68 65 20 64 69 76 69 64 65 72 73 20 61 72 the dividers ar
36500 65 20 61 64 6a 61 63 65 6e 74 20 61 6e 64 20 73 e adjacent and s
36510 6f 72 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 orted.. */.
36520 20 20 61 73 73 65 72 74 28 20 6a 3d 3d 30 20 7c assert( j==0 |
36530 7c 20 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b | pPage->aiOvfl[
36540 6a 2d 31 5d 3c 28 75 31 36 29 69 20 29 3b 20 2f j-1]<(u16)i ); /
36550 2a 20 4f 76 65 72 66 6c 6f 77 73 20 69 6e 20 73 * Overflows in s
36560 6f 72 74 65 64 20 6f 72 64 65 72 20 2a 2f 0a 20 orted order */.
36570 20 20 20 61 73 73 65 72 74 28 20 6a 3d 3d 30 20 assert( j==0
36580 7c 7c 20 69 3d 3d 70 50 61 67 65 2d 3e 61 69 4f || i==pPage->aiO
36590 76 66 6c 5b 6a 2d 31 5d 2b 31 20 29 3b 20 20 20 vfl[j-1]+1 );
365a0 2f 2a 20 4f 76 65 72 66 6c 6f 77 73 20 61 72 65 /* Overflows are
365b0 20 73 65 71 75 65 6e 74 69 61 6c 20 2a 2f 0a 20 sequential */.
365c0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 }else{. int
365d0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
365e0 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 rWrite(pPage->pD
365f0 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 bPage);. if(
36600 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
36610 0a 20 20 20 20 20 20 2a 70 52 43 20 3d 20 72 63 . *pRC = rc
36620 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a ;. return;.
36630 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
36640 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
36650 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
36660 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 20 >pDbPage) );.
36670 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 data = pPage->a
36680 44 61 74 61 3b 0a 20 20 20 20 61 73 73 65 72 74 Data;. assert
36690 28 20 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 ( &data[pPage->c
366a0 65 6c 6c 4f 66 66 73 65 74 5d 3d 3d 70 50 61 67 ellOffset]==pPag
366b0 65 2d 3e 61 43 65 6c 6c 49 64 78 20 29 3b 0a 20 e->aCellIdx );.
366c0 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 rc = allocate
366d0 53 70 61 63 65 28 70 50 61 67 65 2c 20 73 7a 2c Space(pPage, sz,
366e0 20 26 69 64 78 29 3b 0a 20 20 20 20 69 66 28 20 &idx);. if(
366f0 72 63 20 29 7b 20 2a 70 52 43 20 3d 20 72 63 3b rc ){ *pRC = rc;
36700 20 72 65 74 75 72 6e 3b 20 7d 0a 20 20 20 20 2f return; }. /
36710 2a 20 54 68 65 20 61 6c 6c 6f 63 61 74 65 53 70 * The allocateSp
36720 61 63 65 28 29 20 72 6f 75 74 69 6e 65 20 67 75 ace() routine gu
36730 61 72 61 6e 74 65 65 73 20 74 68 65 20 66 6f 6c arantees the fol
36740 6c 6f 77 69 6e 67 20 70 72 6f 70 65 72 74 69 65 lowing propertie
36750 73 0a 20 20 20 20 2a 2a 20 69 66 20 69 74 20 72 s. ** if it r
36760 65 74 75 72 6e 73 20 73 75 63 63 65 73 73 66 75 eturns successfu
36770 6c 6c 79 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 lly */. asser
36780 74 28 20 69 64 78 20 3e 3d 20 30 20 29 3b 0a 20 t( idx >= 0 );.
36790 20 20 20 61 73 73 65 72 74 28 20 69 64 78 20 3e assert( idx >
367a0 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 = pPage->cellOff
367b0 73 65 74 2b 32 2a 70 50 61 67 65 2d 3e 6e 43 65 set+2*pPage->nCe
367c0 6c 6c 2b 32 20 7c 7c 20 43 4f 52 52 55 50 54 5f ll+2 || CORRUPT_
367d0 44 42 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 DB );. assert
367e0 28 20 69 64 78 2b 73 7a 20 3c 3d 20 28 69 6e 74 ( idx+sz <= (int
367f0 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 )pPage->pBt->usa
36800 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 70 bleSize );. p
36810 50 61 67 65 2d 3e 6e 46 72 65 65 20 2d 3d 20 28 Page->nFree -= (
36820 75 31 36 29 28 32 20 2b 20 73 7a 29 3b 0a 20 20 u16)(2 + sz);.
36830 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b 69 memcpy(&data[i
36840 64 78 5d 2c 20 70 43 65 6c 6c 2c 20 73 7a 29 3b dx], pCell, sz);
36850 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 20 . if( iChild
36860 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 ){. put4byt
36870 65 28 26 64 61 74 61 5b 69 64 78 5d 2c 20 69 43 e(&data[idx], iC
36880 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 hild);. }.
36890 20 70 49 6e 73 20 3d 20 70 50 61 67 65 2d 3e 61 pIns = pPage->a
368a0 43 65 6c 6c 49 64 78 20 2b 20 69 2a 32 3b 0a 20 CellIdx + i*2;.
368b0 20 20 20 6d 65 6d 6d 6f 76 65 28 70 49 6e 73 2b memmove(pIns+
368c0 32 2c 20 70 49 6e 73 2c 20 32 2a 28 70 50 61 67 2, pIns, 2*(pPag
368d0 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 29 29 3b 0a e->nCell - i));.
368e0 20 20 20 20 70 75 74 32 62 79 74 65 28 70 49 6e put2byte(pIn
368f0 73 2c 20 69 64 78 29 3b 0a 20 20 20 20 70 50 61 s, idx);. pPa
36900 67 65 2d 3e 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 ge->nCell++;.
36910 20 2f 2a 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 /* increment th
36920 65 20 63 65 6c 6c 20 63 6f 75 6e 74 20 2a 2f 0a e cell count */.
36930 20 20 20 20 69 66 28 20 28 2b 2b 64 61 74 61 5b if( (++data[
36940 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
36950 2b 34 5d 29 3d 3d 30 20 29 20 64 61 74 61 5b 70 +4])==0 ) data[p
36960 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
36970 33 5d 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 74 3]++;. assert
36980 28 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 ( get2byte(&data
36990 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
369a0 74 2b 33 5d 29 3d 3d 70 50 61 67 65 2d 3e 6e 43 t+3])==pPage->nC
369b0 65 6c 6c 20 29 3b 0a 23 69 66 6e 64 65 66 20 53 ell );.#ifndef S
369c0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
369d0 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 70 50 ACUUM. if( pP
369e0 61 67 65 2d 3e 70 42 74 2d 3e 61 75 74 6f 56 61 age->pBt->autoVa
369f0 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 20 2f 2a cuum ){. /*
36a00 20 54 68 65 20 63 65 6c 6c 20 6d 61 79 20 63 6f The cell may co
36a10 6e 74 61 69 6e 20 61 20 70 6f 69 6e 74 65 72 20 ntain a pointer
36a20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 to an overflow p
36a30 61 67 65 2e 20 49 66 20 73 6f 2c 20 77 72 69 74 age. If so, writ
36a40 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 65 e. ** the e
36a50 6e 74 72 79 20 66 6f 72 20 74 68 65 20 6f 76 65 ntry for the ove
36a60 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 74 6f 20 rflow page into
36a70 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 2e the pointer map.
36a80 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
36a90 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 ptrmapPutOvflPtr
36aa0 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 (pPage, pCell, p
36ab0 52 43 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 RC);. }.#endi
36ac0 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 f. }.}../*.** A
36ad0 20 43 65 6c 6c 41 72 72 61 79 20 6f 62 6a 65 63 CellArray objec
36ae0 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 61 63 t contains a cac
36af0 68 65 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 61 he of pointers a
36b00 6e 64 20 73 69 7a 65 73 20 66 6f 72 20 61 0a 2a nd sizes for a.*
36b10 2a 20 63 6f 6e 73 65 63 75 74 69 76 65 20 73 65 * consecutive se
36b20 71 75 65 6e 63 65 20 6f 66 20 63 65 6c 6c 73 20 quence of cells
36b30 74 68 61 74 20 6d 69 67 68 74 20 62 65 20 68 65 that might be he
36b40 6c 64 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 70 ld on multiple p
36b50 61 67 65 73 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 ages..*/.typedef
36b60 20 73 74 72 75 63 74 20 43 65 6c 6c 41 72 72 61 struct CellArra
36b70 79 20 43 65 6c 6c 41 72 72 61 79 3b 0a 73 74 72 y CellArray;.str
36b80 75 63 74 20 43 65 6c 6c 41 72 72 61 79 20 7b 0a uct CellArray {.
36b90 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 int nCell;
36ba0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
36bb0 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 6e 20 ber of cells in
36bc0 61 70 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 20 4d 65 apCell[] */. Me
36bd0 6d 50 61 67 65 20 2a 70 52 65 66 3b 20 20 20 20 mPage *pRef;
36be0 20 20 20 20 20 20 2f 2a 20 52 65 66 65 72 65 6e /* Referen
36bf0 63 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 ce page */. u8
36c00 2a 2a 61 70 43 65 6c 6c 3b 20 20 20 20 20 20 20 **apCell;
36c10 20 20 20 20 20 2f 2a 20 41 6c 6c 20 63 65 6c 6c /* All cell
36c20 73 20 62 65 67 69 6e 20 62 61 6c 61 6e 63 65 64 s begin balanced
36c30 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c */. u16 *szCel
36c40 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a l; /*
36c50 20 4c 6f 63 61 6c 20 73 69 7a 65 20 6f 66 20 61 Local size of a
36c60 6c 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 ll cells in apCe
36c70 6c 6c 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a ll[] */.};../*.*
36c80 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 * Make sure the
36c90 63 65 6c 6c 20 73 69 7a 65 73 20 61 74 20 69 64 cell sizes at id
36ca0 78 2c 20 69 64 78 2b 31 2c 20 2e 2e 2e 2c 20 69 x, idx+1, ..., i
36cb0 64 78 2b 4e 2d 31 20 68 61 76 65 20 62 65 65 6e dx+N-1 have been
36cc0 0a 2a 2a 20 63 6f 6d 70 75 74 65 64 2e 0a 2a 2f .** computed..*/
36cd0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 6f 70 .static void pop
36ce0 75 6c 61 74 65 43 65 6c 6c 43 61 63 68 65 28 43 ulateCellCache(C
36cf0 65 6c 6c 41 72 72 61 79 20 2a 70 2c 20 69 6e 74 ellArray *p, int
36d00 20 69 64 78 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 idx, int N){.
36d10 61 73 73 65 72 74 28 20 69 64 78 3e 3d 30 20 26 assert( idx>=0 &
36d20 26 20 69 64 78 2b 4e 3c 3d 70 2d 3e 6e 43 65 6c & idx+N<=p->nCel
36d30 6c 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 4e 3e l );. while( N>
36d40 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 0 ){. assert(
36d50 20 70 2d 3e 61 70 43 65 6c 6c 5b 69 64 78 5d 21 p->apCell[idx]!
36d60 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 70 2d =0 );. if( p-
36d70 3e 73 7a 43 65 6c 6c 5b 69 64 78 5d 3d 3d 30 20 >szCell[idx]==0
36d80 29 7b 0a 20 20 20 20 20 20 70 2d 3e 73 7a 43 65 ){. p->szCe
36d90 6c 6c 5b 69 64 78 5d 20 3d 20 70 2d 3e 70 52 65 ll[idx] = p->pRe
36da0 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 2d 3e f->xCellSize(p->
36db0 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c 6c 5b pRef, p->apCell[
36dc0 69 64 78 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 idx]);. }else
36dd0 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
36de0 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 0a 20 20 CORRUPT_DB ||.
36df0 20 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 73 p->s
36e00 7a 43 65 6c 6c 5b 69 64 78 5d 3d 3d 70 2d 3e 70 zCell[idx]==p->p
36e10 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 Ref->xCellSize(p
36e20 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c ->pRef, p->apCel
36e30 6c 5b 69 64 78 5d 29 20 29 3b 0a 20 20 20 20 7d l[idx]) );. }
36e40 0a 20 20 20 20 69 64 78 2b 2b 3b 0a 20 20 20 20 . idx++;.
36e50 4e 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a N--;. }.}../*.*
36e60 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a * Return the siz
36e70 65 20 6f 66 20 74 68 65 20 4e 74 68 20 65 6c 65 e of the Nth ele
36e80 6d 65 6e 74 20 6f 66 20 74 68 65 20 63 65 6c 6c ment of the cell
36e90 20 61 72 72 61 79 0a 2a 2f 0a 73 74 61 74 69 63 array.*/.static
36ea0 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 SQLITE_NOINLINE
36eb0 20 75 31 36 20 63 6f 6d 70 75 74 65 43 65 6c 6c u16 computeCell
36ec0 53 69 7a 65 28 43 65 6c 6c 41 72 72 61 79 20 2a Size(CellArray *
36ed0 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 61 73 73 p, int N){. ass
36ee0 65 72 74 28 20 4e 3e 3d 30 20 26 26 20 4e 3c 70 ert( N>=0 && N<p
36ef0 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 ->nCell );. ass
36f00 65 72 74 28 20 70 2d 3e 73 7a 43 65 6c 6c 5b 4e ert( p->szCell[N
36f10 5d 3d 3d 30 20 29 3b 0a 20 20 70 2d 3e 73 7a 43 ]==0 );. p->szC
36f20 65 6c 6c 5b 4e 5d 20 3d 20 70 2d 3e 70 52 65 66 ell[N] = p->pRef
36f30 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 2d 3e 70 ->xCellSize(p->p
36f40 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c 6c 5b 4e Ref, p->apCell[N
36f50 5d 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e ]);. return p->
36f60 73 7a 43 65 6c 6c 5b 4e 5d 3b 0a 7d 0a 73 74 61 szCell[N];.}.sta
36f70 74 69 63 20 75 31 36 20 63 61 63 68 65 64 43 65 tic u16 cachedCe
36f80 6c 6c 53 69 7a 65 28 43 65 6c 6c 41 72 72 61 79 llSize(CellArray
36f90 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 61 *p, int N){. a
36fa0 73 73 65 72 74 28 20 4e 3e 3d 30 20 26 26 20 4e ssert( N>=0 && N
36fb0 3c 70 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 69 <p->nCell );. i
36fc0 66 28 20 70 2d 3e 73 7a 43 65 6c 6c 5b 4e 5d 20 f( p->szCell[N]
36fd0 29 20 72 65 74 75 72 6e 20 70 2d 3e 73 7a 43 65 ) return p->szCe
36fe0 6c 6c 5b 4e 5d 3b 0a 20 20 72 65 74 75 72 6e 20 ll[N];. return
36ff0 63 6f 6d 70 75 74 65 43 65 6c 6c 53 69 7a 65 28 computeCellSize(
37000 70 2c 20 4e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 p, N);.}../*.**
37010 41 72 72 61 79 20 61 70 43 65 6c 6c 5b 5d 20 63 Array apCell[] c
37020 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72 73 ontains pointers
37030 20 74 6f 20 6e 43 65 6c 6c 20 62 2d 74 72 65 65 to nCell b-tree
37040 20 70 61 67 65 20 63 65 6c 6c 73 2e 20 54 68 65 page cells. The
37050 20 0a 2a 2a 20 73 7a 43 65 6c 6c 5b 5d 20 61 72 .** szCell[] ar
37060 72 61 79 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 ray contains the
37070 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f size in bytes o
37080 66 20 65 61 63 68 20 63 65 6c 6c 2e 20 54 68 69 f each cell. Thi
37090 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 72 65 s function.** re
370a0 70 6c 61 63 65 73 20 74 68 65 20 63 75 72 72 65 places the curre
370b0 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 70 nt contents of p
370c0 61 67 65 20 70 50 67 20 77 69 74 68 20 74 68 65 age pPg with the
370d0 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
370e0 20 63 65 6c 6c 0a 2a 2a 20 61 72 72 61 79 2e 0a cell.** array..
370f0 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 6f 66 20 74 68 **.** Some of th
37100 65 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c e cells in apCel
37110 6c 5b 5d 20 6d 61 79 20 63 75 72 72 65 6e 74 6c l[] may currentl
37120 79 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 70 y be stored in p
37130 50 67 2e 20 54 68 69 73 0a 2a 2a 20 66 75 6e 63 Pg. This.** func
37140 74 69 6f 6e 20 77 6f 72 6b 73 20 61 72 6f 75 6e tion works aroun
37150 64 20 70 72 6f 62 6c 65 6d 73 20 63 61 75 73 65 d problems cause
37160 64 20 62 79 20 74 68 69 73 20 62 79 20 6d 61 6b d by this by mak
37170 69 6e 67 20 61 20 63 6f 70 79 20 6f 66 20 61 6e ing a copy of an
37180 79 20 0a 2a 2a 20 73 75 63 68 20 63 65 6c 6c 73 y .** such cells
37190 20 62 65 66 6f 72 65 20 6f 76 65 72 77 72 69 74 before overwrit
371a0 69 6e 67 20 74 68 65 20 70 61 67 65 20 64 61 74 ing the page dat
371b0 61 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4d 65 6d a..**.** The Mem
371c0 50 61 67 65 2e 6e 46 72 65 65 20 66 69 65 6c 64 Page.nFree field
371d0 20 69 73 20 69 6e 76 61 6c 69 64 61 74 65 64 20 is invalidated
371e0 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
371f0 2e 20 49 74 20 69 73 20 74 68 65 20 0a 2a 2a 20 . It is the .**
37200 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f responsibility o
37210 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 f the caller to
37220 73 65 74 20 69 74 20 63 6f 72 72 65 63 74 6c 79 set it correctly
37230 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
37240 72 65 62 75 69 6c 64 50 61 67 65 28 0a 20 20 4d rebuildPage(. M
37250 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 20 20 emPage *pPg,
37260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
37270 2a 20 45 64 69 74 20 74 68 69 73 20 70 61 67 65 * Edit this page
37280 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 2c */. int nCell,
37290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
372a0 20 20 20 20 20 20 2f 2a 20 46 69 6e 61 6c 20 6e /* Final n
372b0 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 6f umber of cells o
372c0 6e 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a n page */. u8 *
372d0 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 *apCell,
372e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
372f0 72 72 61 79 20 6f 66 20 63 65 6c 6c 73 20 2a 2f rray of cells */
37300 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c 6c 20 20 . u16 *szCell
37310 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37320 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 /* Array of c
37330 65 6c 6c 20 73 69 7a 65 73 20 2a 2f 0a 29 7b 0a ell sizes */.){.
37340 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 64 72 20 const int hdr
37350 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 = pPg->hdrOffset
37360 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 ; /* Of
37370 66 73 65 74 20 6f 66 20 68 65 61 64 65 72 20 6f fset of header o
37380 6e 20 70 50 67 20 2a 2f 0a 20 20 75 38 20 2a 20 n pPg */. u8 *
37390 63 6f 6e 73 74 20 61 44 61 74 61 20 3d 20 70 50 const aData = pP
373a0 67 2d 3e 61 44 61 74 61 3b 20 20 20 20 20 20 20 g->aData;
373b0 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
373c0 6f 20 64 61 74 61 20 66 6f 72 20 70 50 67 20 2a o data for pPg *
373d0 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 75 73 /. const int us
373e0 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 67 2d 3e ableSize = pPg->
373f0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3b pBt->usableSize;
37400 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 45 . u8 * const pE
37410 6e 64 20 3d 20 26 61 44 61 74 61 5b 75 73 61 62 nd = &aData[usab
37420 6c 65 53 69 7a 65 5d 3b 0a 20 20 69 6e 74 20 69 leSize];. int i
37430 3b 0a 20 20 75 38 20 2a 70 43 65 6c 6c 70 74 72 ;. u8 *pCellptr
37440 20 3d 20 70 50 67 2d 3e 61 43 65 6c 6c 49 64 78 = pPg->aCellIdx
37450 3b 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d 20 73 ;. u8 *pTmp = s
37460 71 6c 69 74 65 33 50 61 67 65 72 54 65 6d 70 53 qlite3PagerTempS
37470 70 61 63 65 28 70 50 67 2d 3e 70 42 74 2d 3e 70 pace(pPg->pBt->p
37480 50 61 67 65 72 29 3b 0a 20 20 75 38 20 2a 70 44 Pager);. u8 *pD
37490 61 74 61 3b 0a 0a 20 20 69 20 3d 20 67 65 74 32 ata;.. i = get2
374a0 62 79 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b byte(&aData[hdr+
374b0 35 5d 29 3b 0a 20 20 6d 65 6d 63 70 79 28 26 70 5]);. memcpy(&p
374c0 54 6d 70 5b 69 5d 2c 20 26 61 44 61 74 61 5b 69 Tmp[i], &aData[i
374d0 5d 2c 20 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 ], usableSize -
374e0 69 29 3b 0a 0a 20 20 70 44 61 74 61 20 3d 20 70 i);.. pData = p
374f0 45 6e 64 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 End;. for(i=0;
37500 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 i<nCell; i++){.
37510 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 61 u8 *pCell = a
37520 70 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 69 66 pCell[i];. if
37530 28 20 53 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 ( SQLITE_WITHIN(
37540 70 43 65 6c 6c 2c 61 44 61 74 61 2c 70 45 6e 64 pCell,aData,pEnd
37550 29 20 29 7b 0a 20 20 20 20 20 20 70 43 65 6c 6c ) ){. pCell
37560 20 3d 20 26 70 54 6d 70 5b 70 43 65 6c 6c 20 2d = &pTmp[pCell -
37570 20 61 44 61 74 61 5d 3b 0a 20 20 20 20 7d 0a 20 aData];. }.
37580 20 20 20 70 44 61 74 61 20 2d 3d 20 73 7a 43 65 pData -= szCe
37590 6c 6c 5b 69 5d 3b 0a 20 20 20 20 70 75 74 32 62 ll[i];. put2b
375a0 79 74 65 28 70 43 65 6c 6c 70 74 72 2c 20 28 70 yte(pCellptr, (p
375b0 44 61 74 61 20 2d 20 61 44 61 74 61 29 29 3b 0a Data - aData));.
375c0 20 20 20 20 70 43 65 6c 6c 70 74 72 20 2b 3d 20 pCellptr +=
375d0 32 3b 0a 20 20 20 20 69 66 28 20 70 44 61 74 61 2;. if( pData
375e0 20 3c 20 70 43 65 6c 6c 70 74 72 20 29 20 72 65 < pCellptr ) re
375f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
37600 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 6d 65 UPT_BKPT;. me
37610 6d 63 70 79 28 70 44 61 74 61 2c 20 70 43 65 6c mcpy(pData, pCel
37620 6c 2c 20 73 7a 43 65 6c 6c 5b 69 5d 29 3b 0a 20 l, szCell[i]);.
37630 20 20 20 61 73 73 65 72 74 28 20 73 7a 43 65 6c assert( szCel
37640 6c 5b 69 5d 3d 3d 70 50 67 2d 3e 78 43 65 6c 6c l[i]==pPg->xCell
37650 53 69 7a 65 28 70 50 67 2c 20 70 43 65 6c 6c 29 Size(pPg, pCell)
37660 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 || CORRUPT_DB )
37670 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
37680 73 7a 43 65 6c 6c 5b 69 5d 21 3d 70 50 67 2d 3e szCell[i]!=pPg->
37690 78 43 65 6c 6c 53 69 7a 65 28 70 50 67 2c 70 43 xCellSize(pPg,pC
376a0 65 6c 6c 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f ell) );. }.. /
376b0 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 72 65 65 * The pPg->nFree
376c0 20 66 69 65 6c 64 20 69 73 20 6e 6f 77 20 73 65 field is now se
376d0 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 2e 20 54 t incorrectly. T
376e0 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 66 he caller will f
376f0 69 78 20 69 74 2e 20 2a 2f 0a 20 20 70 50 67 2d ix it. */. pPg-
37700 3e 6e 43 65 6c 6c 20 3d 20 6e 43 65 6c 6c 3b 0a >nCell = nCell;.
37710 20 20 70 50 67 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPg->nOverflow
37720 20 3d 20 30 3b 0a 0a 20 20 70 75 74 32 62 79 74 = 0;.. put2byt
37730 65 28 26 61 44 61 74 61 5b 68 64 72 2b 31 5d 2c e(&aData[hdr+1],
37740 20 30 29 3b 0a 20 20 70 75 74 32 62 79 74 65 28 0);. put2byte(
37750 26 61 44 61 74 61 5b 68 64 72 2b 33 5d 2c 20 70 &aData[hdr+3], p
37760 50 67 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 70 75 Pg->nCell);. pu
37770 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 68 64 t2byte(&aData[hd
37780 72 2b 35 5d 2c 20 70 44 61 74 61 20 2d 20 61 44 r+5], pData - aD
37790 61 74 61 29 3b 0a 20 20 61 44 61 74 61 5b 68 64 ata);. aData[hd
377a0 72 2b 37 5d 20 3d 20 30 78 30 30 3b 0a 20 20 72 r+7] = 0x00;. r
377b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
377c0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 20 .}../*.** Array
377d0 61 70 43 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 6e apCell[] contain
377e0 73 20 6e 43 65 6c 6c 20 70 6f 69 6e 74 65 72 73 s nCell pointers
377f0 20 74 6f 20 62 2d 74 72 65 65 20 63 65 6c 6c 73 to b-tree cells
37800 2e 20 41 72 72 61 79 20 73 7a 43 65 6c 6c 0a 2a . Array szCell.*
37810 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 * contains the s
37820 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 ize in bytes of
37830 65 61 63 68 20 73 75 63 68 20 63 65 6c 6c 2e 20 each such cell.
37840 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 This function at
37850 74 65 6d 70 74 73 20 74 6f 20 0a 2a 2a 20 61 64 tempts to .** ad
37860 64 20 74 68 65 20 63 65 6c 6c 73 20 73 74 6f 72 d the cells stor
37870 65 64 20 69 6e 20 74 68 65 20 61 72 72 61 79 20 ed in the array
37880 74 6f 20 70 61 67 65 20 70 50 67 2e 20 49 66 20 to page pPg. If
37890 69 74 20 63 61 6e 6e 6f 74 20 28 62 65 63 61 75 it cannot (becau
378a0 73 65 20 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 se .** the page
378b0 6e 65 65 64 73 20 74 6f 20 62 65 20 64 65 66 72 needs to be defr
378c0 61 67 6d 65 6e 74 65 64 20 62 65 66 6f 72 65 20 agmented before
378d0 74 68 65 20 63 65 6c 6c 73 20 77 69 6c 6c 20 66 the cells will f
378e0 69 74 29 2c 20 6e 6f 6e 2d 7a 65 72 6f 0a 2a 2a it), non-zero.**
378f0 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
37900 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 65 20 herwise, if the
37910 63 65 6c 6c 73 20 61 72 65 20 61 64 64 65 64 20 cells are added
37920 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 7a 65 successfully, ze
37930 72 6f 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 ro is.** returne
37940 64 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e d..**.** Argumen
37950 74 20 70 43 65 6c 6c 70 74 72 20 70 6f 69 6e 74 t pCellptr point
37960 73 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 65 s to the first e
37970 6e 74 72 79 20 69 6e 20 74 68 65 20 63 65 6c 6c ntry in the cell
37980 2d 70 6f 69 6e 74 65 72 20 61 72 72 61 79 0a 2a -pointer array.*
37990 2a 20 28 70 61 72 74 20 6f 66 20 70 61 67 65 20 * (part of page
379a0 70 50 67 29 20 74 6f 20 70 6f 70 75 6c 61 74 65 pPg) to populate
379b0 2e 20 41 66 74 65 72 20 63 65 6c 6c 20 61 70 43 . After cell apC
379c0 65 6c 6c 5b 30 5d 20 69 73 20 77 72 69 74 74 65 ell[0] is writte
379d0 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 70 61 67 65 n to the.** page
379e0 20 62 6f 64 79 2c 20 61 20 31 36 2d 62 69 74 20 body, a 16-bit
379f0 6f 66 66 73 65 74 20 69 73 20 77 72 69 74 74 65 offset is writte
37a00 6e 20 74 6f 20 70 43 65 6c 6c 70 74 72 2e 20 41 n to pCellptr. A
37a10 6e 64 20 73 6f 20 6f 6e 2c 20 66 6f 72 20 65 61 nd so on, for ea
37a20 63 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e 20 74 68 ch.** cell in th
37a30 65 20 61 72 72 61 79 2e 20 49 74 20 69 73 20 74 e array. It is t
37a40 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 he responsibilit
37a50 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
37a60 74 6f 20 65 6e 73 75 72 65 0a 2a 2a 20 74 68 61 to ensure.** tha
37a70 74 20 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 t it is safe to
37a80 6f 76 65 72 77 72 69 74 65 20 74 68 69 73 20 70 overwrite this p
37a90 61 72 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d art of the cell-
37aa0 70 6f 69 6e 74 65 72 20 61 72 72 61 79 2e 0a 2a pointer array..*
37ab0 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 66 *.** When this f
37ac0 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
37ad0 64 2c 20 2a 70 70 44 61 74 61 20 70 6f 69 6e 74 d, *ppData point
37ae0 73 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f s to the start o
37af0 66 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e f the .** conten
37b00 74 20 61 72 65 61 20 6f 6e 20 70 61 67 65 20 70 t area on page p
37b10 50 67 2e 20 49 66 20 74 68 65 20 73 69 7a 65 20 Pg. If the size
37b20 6f 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 61 of the content a
37b30 72 65 61 20 69 73 20 65 78 74 65 6e 64 65 64 2c rea is extended,
37b40 0a 2a 2a 20 2a 70 70 44 61 74 61 20 69 73 20 75 .** *ppData is u
37b50 70 64 61 74 65 64 20 74 6f 20 70 6f 69 6e 74 20 pdated to point
37b60 74 6f 20 74 68 65 20 6e 65 77 20 73 74 61 72 74 to the new start
37b70 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 of the content
37b80 61 72 65 61 0a 2a 2a 20 62 65 66 6f 72 65 20 72 area.** before r
37b90 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 eturning..**.**
37ba0 46 69 6e 61 6c 6c 79 2c 20 61 72 67 75 6d 65 6e Finally, argumen
37bb0 74 20 70 42 65 67 69 6e 20 70 6f 69 6e 74 73 20 t pBegin points
37bc0 74 6f 20 74 68 65 20 62 79 74 65 20 69 6d 6d 65 to the byte imme
37bd0 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e diately followin
37be0 67 20 74 68 65 0a 2a 2a 20 65 6e 64 20 6f 66 20 g the.** end of
37bf0 74 68 65 20 73 70 61 63 65 20 72 65 71 75 69 72 the space requir
37c00 65 64 20 62 79 20 74 68 69 73 20 70 61 67 65 20 ed by this page
37c10 66 6f 72 20 74 68 65 20 63 65 6c 6c 2d 70 6f 69 for the cell-poi
37c20 6e 74 65 72 20 61 72 65 61 20 28 66 6f 72 0a 2a nter area (for.*
37c30 2a 20 61 6c 6c 20 63 65 6c 6c 73 20 2d 20 6e 6f * all cells - no
37c40 74 20 6a 75 73 74 20 74 68 6f 73 65 20 69 6e 73 t just those ins
37c50 65 72 74 65 64 20 62 79 20 74 68 65 20 63 75 72 erted by the cur
37c60 72 65 6e 74 20 63 61 6c 6c 29 2e 20 49 66 20 74 rent call). If t
37c70 68 65 20 63 6f 6e 74 65 6e 74 0a 2a 2a 20 61 72 he content.** ar
37c80 65 61 20 6d 75 73 74 20 62 65 20 65 78 74 65 6e ea must be exten
37c90 64 65 64 20 74 6f 20 62 65 66 6f 72 65 20 74 68 ded to before th
37ca0 69 73 20 70 6f 69 6e 74 20 69 6e 20 6f 72 64 65 is point in orde
37cb0 72 20 74 6f 20 61 63 63 6f 6d 6f 64 61 74 65 20 r to accomodate
37cc0 61 6c 6c 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 all.** cells in
37cd0 61 70 43 65 6c 6c 5b 5d 2c 20 74 68 65 6e 20 74 apCell[], then t
37ce0 68 65 20 63 65 6c 6c 73 20 64 6f 20 6e 6f 74 20 he cells do not
37cf0 66 69 74 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f fit and non-zero
37d00 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
37d10 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 .static int page
37d20 49 6e 73 65 72 74 41 72 72 61 79 28 0a 20 20 4d InsertArray(. M
37d30 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 20 20 emPage *pPg,
37d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
37d50 2a 20 50 61 67 65 20 74 6f 20 61 64 64 20 63 65 * Page to add ce
37d60 6c 6c 73 20 74 6f 20 2a 2f 0a 20 20 75 38 20 2a lls to */. u8 *
37d70 70 42 65 67 69 6e 2c 20 20 20 20 20 20 20 20 20 pBegin,
37d80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
37d90 6e 64 20 6f 66 20 63 65 6c 6c 2d 70 6f 69 6e 74 nd of cell-point
37da0 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 75 38 er array */. u8
37db0 20 2a 2a 70 70 44 61 74 61 2c 20 20 20 20 20 20 **ppData,
37dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
37dd0 20 49 4e 2f 4f 55 54 3a 20 50 61 67 65 20 63 6f IN/OUT: Page co
37de0 6e 74 65 6e 74 20 2d 61 72 65 61 20 70 6f 69 6e ntent -area poin
37df0 74 65 72 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 ter */. u8 *pCe
37e00 6c 6c 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 llptr,
37e10 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
37e20 74 65 72 20 74 6f 20 63 65 6c 6c 2d 70 6f 69 6e ter to cell-poin
37e30 74 65 72 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e ter area */. in
37e40 74 20 69 46 69 72 73 74 2c 20 20 20 20 20 20 20 t iFirst,
37e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
37e60 20 49 6e 64 65 78 20 6f 66 20 66 69 72 73 74 20 Index of first
37e70 63 65 6c 6c 20 74 6f 20 61 64 64 20 2a 2f 0a 20 cell to add */.
37e80 20 69 6e 74 20 6e 43 65 6c 6c 2c 20 20 20 20 20 int nCell,
37e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37ea0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 /* Number of ce
37eb0 6c 6c 73 20 74 6f 20 61 64 64 20 74 6f 20 70 50 lls to add to pP
37ec0 67 20 2a 2f 0a 20 20 43 65 6c 6c 41 72 72 61 79 g */. CellArray
37ed0 20 2a 70 43 41 72 72 61 79 20 20 20 20 20 20 20 *pCArray
37ee0 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 /* Array
37ef0 6f 66 20 63 65 6c 6c 73 20 2a 2f 0a 29 7b 0a 20 of cells */.){.
37f00 20 69 6e 74 20 69 3b 0a 20 20 75 38 20 2a 61 44 int i;. u8 *aD
37f10 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 ata = pPg->aData
37f20 3b 0a 20 20 75 38 20 2a 70 44 61 74 61 20 3d 20 ;. u8 *pData =
37f30 2a 70 70 44 61 74 61 3b 0a 20 20 69 6e 74 20 69 *ppData;. int i
37f40 45 6e 64 20 3d 20 69 46 69 72 73 74 20 2b 20 6e End = iFirst + n
37f50 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 Cell;. assert(
37f60 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 70 50 CORRUPT_DB || pP
37f70 67 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d 30 20 g->hdrOffset==0
37f80 29 3b 20 20 20 20 2f 2a 20 4e 65 76 65 72 20 63 ); /* Never c
37f90 61 6c 6c 65 64 20 6f 6e 20 70 61 67 65 20 31 20 alled on page 1
37fa0 2a 2f 0a 20 20 66 6f 72 28 69 3d 69 46 69 72 73 */. for(i=iFirs
37fb0 74 3b 20 69 3c 69 45 6e 64 3b 20 69 2b 2b 29 7b t; i<iEnd; i++){
37fc0 0a 20 20 20 20 69 6e 74 20 73 7a 2c 20 72 63 3b . int sz, rc;
37fd0 0a 20 20 20 20 75 38 20 2a 70 53 6c 6f 74 3b 0a . u8 *pSlot;.
37fe0 20 20 20 20 73 7a 20 3d 20 63 61 63 68 65 64 43 sz = cachedC
37ff0 65 6c 6c 53 69 7a 65 28 70 43 41 72 72 61 79 2c ellSize(pCArray,
38000 20 69 29 3b 0a 20 20 20 20 69 66 28 20 28 61 44 i);. if( (aD
38010 61 74 61 5b 31 5d 3d 3d 30 20 26 26 20 61 44 61 ata[1]==0 && aDa
38020 74 61 5b 32 5d 3d 3d 30 29 20 7c 7c 20 28 70 53 ta[2]==0) || (pS
38030 6c 6f 74 20 3d 20 70 61 67 65 46 69 6e 64 53 6c lot = pageFindSl
38040 6f 74 28 70 50 67 2c 73 7a 2c 26 72 63 29 29 3d ot(pPg,sz,&rc))=
38050 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 =0 ){. if(
38060 28 70 44 61 74 61 20 2d 20 70 42 65 67 69 6e 29 (pData - pBegin)
38070 3c 73 7a 20 29 20 72 65 74 75 72 6e 20 31 3b 0a <sz ) return 1;.
38080 20 20 20 20 20 20 70 44 61 74 61 20 2d 3d 20 73 pData -= s
38090 7a 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74 20 3d z;. pSlot =
380a0 20 70 44 61 74 61 3b 0a 20 20 20 20 7d 0a 20 20 pData;. }.
380b0 20 20 2f 2a 20 70 53 6c 6f 74 20 61 6e 64 20 70 /* pSlot and p
380c0 43 41 72 72 61 79 2d 3e 61 70 43 65 6c 6c 5b 69 CArray->apCell[i
380d0 5d 20 77 69 6c 6c 20 6e 65 76 65 72 20 6f 76 65 ] will never ove
380e0 72 6c 61 70 20 6f 6e 20 61 20 77 65 6c 6c 2d 66 rlap on a well-f
380f0 6f 72 6d 65 64 0a 20 20 20 20 2a 2a 20 64 61 74 ormed. ** dat
38100 61 62 61 73 65 2e 20 20 42 75 74 20 74 68 65 79 abase. But they
38110 20 6d 69 67 68 74 20 66 6f 72 20 61 20 63 6f 72 might for a cor
38120 72 75 70 74 20 64 61 74 61 62 61 73 65 2e 20 20 rupt database.
38130 48 65 6e 63 65 20 75 73 65 20 6d 65 6d 6d 6f 76 Hence use memmov
38140 65 28 29 0a 20 20 20 20 2a 2a 20 73 69 6e 63 65 e(). ** since
38150 20 6d 65 6d 63 70 79 28 29 20 73 65 6e 64 73 20 memcpy() sends
38160 53 49 47 41 42 4f 52 54 20 77 69 74 68 20 6f 76 SIGABORT with ov
38170 65 72 6c 61 70 70 69 6e 67 20 62 75 66 66 65 72 erlapping buffer
38180 73 20 6f 6e 20 4f 70 65 6e 42 53 44 20 2a 2f 0a s on OpenBSD */.
38190 20 20 20 20 61 73 73 65 72 74 28 20 28 70 53 6c assert( (pSl
381a0 6f 74 2b 73 7a 29 3c 3d 70 43 41 72 72 61 79 2d ot+sz)<=pCArray-
381b0 3e 61 70 43 65 6c 6c 5b 69 5d 0a 20 20 20 20 20 >apCell[i].
381c0 20 20 20 20 7c 7c 20 70 53 6c 6f 74 3e 3d 28 70 || pSlot>=(p
381d0 43 41 72 72 61 79 2d 3e 61 70 43 65 6c 6c 5b 69 CArray->apCell[i
381e0 5d 2b 73 7a 29 0a 20 20 20 20 20 20 20 20 20 7c ]+sz). |
381f0 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a | CORRUPT_DB );.
38200 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 53 6c 6f memmove(pSlo
38210 74 2c 20 70 43 41 72 72 61 79 2d 3e 61 70 43 65 t, pCArray->apCe
38220 6c 6c 5b 69 5d 2c 20 73 7a 29 3b 0a 20 20 20 20 ll[i], sz);.
38230 70 75 74 32 62 79 74 65 28 70 43 65 6c 6c 70 74 put2byte(pCellpt
38240 72 2c 20 28 70 53 6c 6f 74 20 2d 20 61 44 61 74 r, (pSlot - aDat
38250 61 29 29 3b 0a 20 20 20 20 70 43 65 6c 6c 70 74 a));. pCellpt
38260 72 20 2b 3d 20 32 3b 0a 20 20 7d 0a 20 20 2a 70 r += 2;. }. *p
38270 70 44 61 74 61 20 3d 20 70 44 61 74 61 3b 0a 20 pData = pData;.
38280 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a return 0;.}../*
38290 0a 2a 2a 20 41 72 72 61 79 20 61 70 43 65 6c 6c .** Array apCell
382a0 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 6e 43 65 6c [] contains nCel
382b0 6c 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 62 2d l pointers to b-
382c0 74 72 65 65 20 63 65 6c 6c 73 2e 20 41 72 72 61 tree cells. Arra
382d0 79 20 73 7a 43 65 6c 6c 20 0a 2a 2a 20 63 6f 6e y szCell .** con
382e0 74 61 69 6e 73 20 74 68 65 20 73 69 7a 65 20 69 tains the size i
382f0 6e 20 62 79 74 65 73 20 6f 66 20 65 61 63 68 20 n bytes of each
38300 73 75 63 68 20 63 65 6c 6c 2e 20 54 68 69 73 20 such cell. This
38310 66 75 6e 63 74 69 6f 6e 20 61 64 64 73 20 74 68 function adds th
38320 65 0a 2a 2a 20 73 70 61 63 65 20 61 73 73 6f 63 e.** space assoc
38330 69 61 74 65 64 20 77 69 74 68 20 65 61 63 68 20 iated with each
38340 63 65 6c 6c 20 69 6e 20 74 68 65 20 61 72 72 61 cell in the arra
38350 79 20 74 68 61 74 20 69 73 20 63 75 72 72 65 6e y that is curren
38360 74 6c 79 20 73 74 6f 72 65 64 20 0a 2a 2a 20 77 tly stored .** w
38370 69 74 68 69 6e 20 74 68 65 20 62 6f 64 79 20 6f ithin the body o
38380 66 20 70 50 67 20 74 6f 20 74 68 65 20 70 50 67 f pPg to the pPg
38390 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 68 65 20 free-list. The
383a0 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 73 20 61 6e cell-pointers an
383b0 64 20 6f 74 68 65 72 0a 2a 2a 20 66 69 65 6c 64 d other.** field
383c0 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 72 s of the page ar
383d0 65 20 6e 6f 74 20 75 70 64 61 74 65 64 2e 0a 2a e not updated..*
383e0 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
383f0 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 74 on returns the t
38400 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 otal number of c
38410 65 6c 6c 73 20 61 64 64 65 64 20 74 6f 20 74 68 ells added to th
38420 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 2a 2f 0a e free-list..*/.
38430 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 46 static int pageF
38440 72 65 65 41 72 72 61 79 28 0a 20 20 4d 65 6d 50 reeArray(. MemP
38450 61 67 65 20 2a 70 50 67 2c 20 20 20 20 20 20 20 age *pPg,
38460 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
38470 61 67 65 20 74 6f 20 65 64 69 74 20 2a 2f 0a 20 age to edit */.
38480 20 69 6e 74 20 69 46 69 72 73 74 2c 20 20 20 20 int iFirst,
38490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20